Interface AssistantMemoryApi

Host-owned, userspace-scoped assistant memory. UNLIKE assistant.context / assistant.actions (ungated advisory postMessage), every method here is a gated project RPC: reads require "memory-read" and editFile/deletes require "memory-write" in manifest requests.assistant. The host owns the capped profile files and the episode store under the userspace root; the app receives typed rows only, never a filesystem path. Memory is context for future chats, never authority. This is a DIFFERENT plane from per-project "project memory" (.ispo/spec.md + devlog).

interface AssistantMemoryApi {
    conclusions(
        input?: AssistantMemoryListArgs,
    ): Promise<AssistantMemoryConclusion[]>;
    deleteConclusion(
        input: { id: number },
    ): Promise<AssistantMemoryDeleteResult>;
    deleteEpisode(input: { id: number }): Promise<AssistantMemoryDeleteResult>;
    editFile(
        input: AssistantMemoryEditFileArgs,
    ): Promise<AssistantMemoryEditFileResult>;
    episodes(
        input?: AssistantMemoryListArgs,
    ): Promise<AssistantMemoryEpisode[]>;
    overview(): Promise<AssistantMemoryOverview>;
    recallTrace(
        input: AssistantMemoryRecallTraceArgs,
    ): Promise<AssistantMemoryRecallTrace>;
    search(
        input: AssistantMemorySearchArgs,
    ): Promise<AssistantMemorySearchResult[]>;
}

Index

Methods

conclusions deleteConclusion deleteEpisode editFile episodes overview recallTrace search

Methods

conclusions

conclusions(
input?: AssistantMemoryListArgs,
): Promise<AssistantMemoryConclusion[]>
Derived conclusions, newest first. Empty in v1 (nothing writes them yet).
Parameters
- Optionalinput: AssistantMemoryListArgs
Returns Promise<AssistantMemoryConclusion[]>

Authority for assistant.memory.conclusions

Reviewed request token: assistant.memoryRead. Standing capability: assistant.memoryRead.

Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery.

deleteConclusion

deleteConclusion(input: { id: number }): Promise<AssistantMemoryDeleteResult>
Parameters
- input: { id: number }
Returns Promise<AssistantMemoryDeleteResult>

Authority for assistant.memory.deleteConclusion

Reviewed request token: assistant.memoryWrite. Standing capability: assistant.memoryWrite.

Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery.

deleteEpisode

deleteEpisode(input: { id: number }): Promise<AssistantMemoryDeleteResult>
Parameters
- input: { id: number }
Returns Promise<AssistantMemoryDeleteResult>

Authority for assistant.memory.deleteEpisode

Reviewed request token: assistant.memoryWrite. Standing capability: assistant.memoryWrite.

Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery.

editFile

editFile(
input: AssistantMemoryEditFileArgs,
): Promise<AssistantMemoryEditFileResult>
Add/replace/remove one fact line in USER.md or ASSISTANT.md. An over-cap or no-match outcome resolves { ok: false } DATA — it never throws.
Parameters
- input: AssistantMemoryEditFileArgs
Returns Promise<AssistantMemoryEditFileResult>

Authority for assistant.memory.editFile

Reviewed request token: assistant.memoryWrite. Standing capability: assistant.memoryWrite.

Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery.

episodes

episodes(input?: AssistantMemoryListArgs): Promise<AssistantMemoryEpisode[]>
Recorded session episodes, newest first (default 20, max 200).
Parameters
- Optionalinput: AssistantMemoryListArgs
Returns Promise<AssistantMemoryEpisode[]>

Authority for assistant.memory.episodes

Reviewed request token: assistant.memoryRead. Standing capability: assistant.memoryRead.

Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery.

overview

overview(): Promise<AssistantMemoryOverview>

Both profile files with usage meters, plus store counts and backend.

Returns Promise<AssistantMemoryOverview>

Authority for assistant.memory.overview

Reviewed request token: assistant.memoryRead. Standing capability: assistant.memoryRead.

Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery.

recallTrace

recallTrace(
input: AssistantMemoryRecallTraceArgs,
): Promise<AssistantMemoryRecallTrace>
Debug trace for one session: the memory/brief blocks the host actually injected plus the session's tool calls replayed from its transcript record. Display-only evidence — clamped strings, never authority.
Parameters
- input: AssistantMemoryRecallTraceArgs
Returns Promise<AssistantMemoryRecallTrace>

Authority for assistant.memory.recallTrace

Reviewed request token: assistant.memoryRead. Standing capability: assistant.memoryRead.

Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery.

search

search(input: AssistantMemorySearchArgs): Promise<AssistantMemorySearchResult[]>
Full-text search over episodes and conclusions.
Parameters
- input: AssistantMemorySearchArgs
Returns Promise<AssistantMemorySearchResult[]>

Authority for assistant.memory.search

Reviewed request token: assistant.memoryRead. Standing capability: assistant.memoryRead.

Handle structured ProjectRpcError failures. A timeout does not guarantee cancellation; do not automatically retry effects without a documented idempotency contract. Method authority and recovery.