Persist one concise book of context to the local Library. Use for durable decisions, constraints, findings, and user-approved memories—not transient chatter or secrets.

Chunk and persist a larger local text document as multiple books. Set replace_edition to replace prior chunks from the same source.

Search the off-desk Library with hybrid vector, lexical, importance, and recency ranking without changing the reading desk.

Replace a session's bounded reading desk with books relevant to the current subject. Returns the prompt-ready context plus swapped-in, swapped-out, and retained IDs.

Read the latest bounded reading desk snapshot for a session.

Refresh a reading desk immediately and periodically thereafter for a long-running task. A later focus change should call library_desk_refresh or start this tool again.

Stop periodic refresh for a reading-desk session. The current snapshot remains available.

Shelve one conversation message for a virtual-context session. External model gateways should record assistant replies after each response.

Build a complete stateless model-input envelope from bounded recent turns plus a replacement reading desk. Full history remains shelved on disk instead of growing the live prompt.

Durably append a user turn, then return the complete bounded semantic-paging envelope for the next model call. Send only the returned messages to the model.

Durably append the assistant or tool result after a governed model call. The outbox indexes it asynchronously while the recent ring makes it immediately visible.

Persist critical instructions, decisions, active plans, or unresolved state as protected context that remains eligible for every governed prompt until released.

Release one protected event so it can be paged normally. The durable event is retained.

Read context-governor watermarks, queue occupancy, prompt pressure, and worker health for one agent thread.

Wait until this thread's durable outbox has been embedded and indexed through its recorded watermark.

Inspect Library tier health, usage, cache hit/miss counters, and embedding configuration.