Cognition & Introspection

Intra-Agent Memo Scheduling

Let an agent drop a note for its own future self at a specified time so present decisions can hand off context to a later run without external infrastructure.

Problem

Without some way to drop a note for its own future self, the agent has only two unsatisfying options. It can act on the thought right now — pinging the user at 9am about something that should have waited until 4pm — or it can hope to remember on its own, which it will not. External scheduling systems like cron or a queue can fire on time but live outside the agent's working memory, so when they do fire the agent has no idea why the reminder is showing up or what its past-self intended.

Solution

Provide a tool `schedule_future_thought(when, content, intent)` that appends to a persistent scheduled-thoughts queue. At each tick or turn, drain due entries and prepend them into the next prompt as `[SYSTEM: scheduled note from past-self (set <ts>, fires <when>): <content>]`. Mark fired so they only run once. Accept ISO timestamps and relative offsets (`+1h`, `+2d`).

When to use

  • The agent runs across many ticks or sessions and present-self has context the future-self will need.
  • External schedulers (cron, queues, durable workflows) are unavailable or overkill.
  • Future-fire memos are a small enough volume to keep in the agent's own store.

Open the full interactive page

Diagram, neighbourhood map, code examples, related patterns and full provenance.

Related