XMemo

Marks a TODO/action item completed when the user says a saved task is done, resolved, or no longer needed; its exact memory reference is shown by list_memory_todos.

Creates a TODO/action item in XMemo with an optional due time when the user asks to save a task, follow-up, action item, or reminder-style item to revisit at a later time.

Save active state, recent events, TODOs, and pending decisions for restart. Relevant before handoff or when context may be lost.

Apply one Dream Workspace action the user explicitly asked for; never act on your own initiative.

accept_idea turns an idea into a todo; confirm_principle adopts a principle candidate; mute / unmute hides or restores one idea, principle or goal item; save_feed_card / save_feed_document saves a feed card or a feed edition; exclude_scope / include_scope stops or resumes Dream reading a scope in the owner's personal Dream settings. item_id is a card id from dream_view (for exclude_scope / include_scope, the scope label). Repeating an applied action returns status already_applied without a second write. Every result carries a receipt with a SHA-256 digest. Gates and protected-item checks apply; a run digest card cannot be changed.

Show the caller's Dream Workspace: ideas, goals, principles and saved feed cards, with the ids dream_action takes.

Reads the personal space, or one project's space. Feature, identity and entitlement gates apply; a closed gate returns a refusal view instead of cards. Not strictly read-only: with idea lenses on, the ideas tab first retires ideas whose todo is done or whose evidence was contradicted; with outcome events on, each shown idea, principle or saved card is logged once a day as a view impression. Memories and todos are never changed.

Explains why a memory exists or matched a query whenever the user asks why something was saved there or why it was retrieved.

Delete one memory, TODO, or Ledger transaction by current/latest, an exact memory reference, an exact TODO ID from list_memory_todos, or an exact Ledger transaction ID. The default is a recoverable soft delete that restore_memory can undo; mode='hard' is permanent and unrecoverable; requires explicit user confirmation of permanent deletion. Ambiguous targets are resolved before deleting.

Checks XMemo connection status and the currently connected account/agent when the user asks whether XMemo is connected.

Read one authorized project's bounded context pack: state, TODOs, decisions, timeline, recent memories, and optional durable recall. Requires memory:read; it does not mutate project memories, and access is audit-logged. Use an exact project_id for a whole-project snapshot; otherwise use recall_context. max_items/max_tokens bound the whole pack; recent_hours affects only timeline; durable_query requires include_durable_context.

Read authorized timeline events newest first. Requires memory:read and makes no memory changes. Use it for recent history or session resumption; use recall_context for semantic multi-memory context. limit is clamped to 1-500; session_id and event_type are exact filters.

Create a directed link from one of the caller's personal memories to another in the same space.

edge_kind says how the from memory relates to the to memory. Linking a pair that is already linked with the same kind returns that link with changed=false. Errors: NotFound (a memory is not visible to you), InvalidArgument (the same memory twice, or an unknown kind), Conflict.

List conflicting/inconsistent memories. Relevant when the user/admin asks to review unresolved conflicts.

Lists open or completed TODO/action items as a concise text answer when the user asks how many tasks, follow-ups, or saved action items are currently pending or completed; do not use it to open, browse, filter, or manage the visual TODO workspace.

Show version history for a memory. Relevant when the user asks for previous content or changes over time.

Read explicit personal links for one visible Memory; no automated analysis.

Shows aggregate statistics for all saved XMemo memories — counts by type, source, location, and optional time range when the user asks for counts, breakdowns, or distributions.

Propose a change to one profile field for later review; the active profile is never changed.

Stores value as a new memory in the proposals bucket at path 'profile.{field}' with metadata status 'proposed'.

Propose a todo mutation under the proposals bucket at path 'todos/{action}'.

Propose a write operation (memory, todo, profile etc.) when direct modifications are denied due to tier-gating.

Query audit records within the caller's authorized memory scope. source='events' selects action/time/target events; source='consolidation' selects consolidation/lifecycle/reflection history. This does not grant cross-user or system administration access.

Read one exact authorized XMemo memory or Document in character windows.

Use a bare memory ID (e.g. returned by recall or search) for the initial read (offset 0). The response includes 'revision' (e.g. '<memory_id>@v') and 'version'. To continue reading long content across multiple pages (when 'has_more' is True), callers MUST pass the returned 'revision' as memory_id along with 'next_offset'. This pins continuation pages to that exact snapshot and prevents torn reads if concurrent updates occur between requests. Querying with a bare memory ID always resolves to the latest active version (head), which is unpinned and subject to version tearing across updates. A Document item's reference ('document:') reads the whole Document the same way. For a Document, 'anchor' (a heading path) with 'ordinal' (1 = its first chunk) starts the page at that section; continue with 'next_offset' and no anchor. 'version' pins like a revision; a Document that changed since returns version_changed=true and no content, so restart at offset 0. Embeddings are never returned.

Recall a few relevance-ranked memories before answering, with path/type controls and optional working-memory preference. Unscoped by default: it searches all of your buckets; pass bucket to search only that bucket (never widened by fallback). Use it for a quick best-effort lookup; use recall_context when the answer needs a bounded multi-memory context pack.

Recall reusable Cloud Skills, instructions, or sub-resources saved in XMemo. Supports Level 0 discovery by query, Level 1 root recall, and Level 2 resource recall with pinned revision_id.

Build a read-only, bounded context pack from multiple relevant memories. Use it when an answer needs several memory items or scoped/path-filtered context; use recall for a quick best-effort lookup or get_project_context for a whole-project snapshot. max_items/max_tokens bound output: memories that do not fit are omitted and reported, so raise max_tokens or use recall when you need the records themselves.

Record a significant session event, milestone, decision, or handoff note useful for reconstructing recent work. Not for durable facts/preferences (use remember).

Save durable information for future recall; skip transient chat. Existing Projects paths attach automatically. The create_project compatibility input may create a missing project only when explicitly enabled. Financial records belong in a Ledger capability when this connection offers one; when it does not, tell the user instead of storing them as generic memory. Use create_memory_todo for actionable work.

Remove one explicit link between personal memories; both memories are kept and only the link is marked removed.

Read the link with memory_relationships first and pass its relationship_id and version. A stale expected_version returns Conflict; repeating the same removal returns the removed link instead of an error.

Resolve a listed memory conflict. Intended only for when the user/admin explicitly chooses a resolution strategy.

Restore a previously deleted memory. Intended only for when the user explicitly asks to restore or undo a deletion.

Resume previous work from a saved snapshot. Relevant when the user asks to resume/restart or after context loss. By default it overwrites the current working state with the snapshot's state and writes a restore event to the timeline. To only inspect a snapshot, pass restore_state=false and record_restore_event=false with its snapshot_id; without a snapshot_id, when no saved snapshot matches, a new snapshot of the current working state is saved first.

Save a reusable procedure, rule, or SOP as a Cloud Skill in XMemo for future recall across connected AI agents.

Supports two usage modes (API Evolution Note: additive parameter 'url'):

1. Direct creation: Provide non-empty 'name' and 'instructions'.

2. Remote import: Provide 'url' (ClawHub slug/URL, GitHub repo/tree/raw URL, or direct HTTPS zip/markdown).

Search authorized personal Knowledge Base content over published current revisions, or read one exact item/revision with bounded pagination. Requires knowledge:read.

Updates the content, location, or type of a specific saved memory when the user asks to correct, revise, move, or reclassify it. An exact reference identifies the record.

Edit an explicit personal link kind using the last read version; stale edits conflict.

Transition a project decision. action must be one of: resolve, supersede, reopen. resolution is required for action='resolve'. new_context (and optionally options_json/impact_level/resolution_note) is required for action='supersede'.

Transition a project TODO's status. action must be one of: accept, assign, block, unblock, complete, cancel. assignee_agent_id is required for action='assign'; reason is required for action='block' (optional for cancel); note is optional for action='complete'.

Create or replace one scoped working-state record for resuming a task, next action, or blocker. Requires memory:write; it versions that state slot and refreshes its expiry without deleting other memories. Use remember for durable facts or record_event for history. Provide content or a structured state field; ttl_seconds=0 means no expiry.