hot.dev/hot-ai-agent / ::ai::agent::memory

Functions

Command alias

Alias of ::command/Command

MemoryExport alias

Alias of ::ai::memory/MemoryExport

common-memory-commands

fn (): Vec<::ai::agent::command/Command>

Command declarations for common memory lifecycle controls.

inspect-export

fn (bundle: ::ai::memory/MemoryExport, opts: Map?): MemoryInspection

Build a MemoryInspection from an exported memory bundle plus optional capsule/graph counts.

ns alias

Alias of ::ai::agent::memory/

Reusable memory lifecycle command declarations and response shapes.

Sibling to ::ai::memory, not a replacement: ::ai::memory is the memory engine (AgentMemory, remember, recall, the three-store backing). This namespace is the command-surface counterpart that concrete agents wire into /forget, /compact, /export, /memory, and /why slash commands — declarations, parsed argument shapes, response types, and neutral formatting.

Files that need both typically alias ::memory ::ai::memory and ::agent-memory ::ai::agent::memory.

Concrete agents own policy, authorization, and execution hooks. This namespace keeps the common command surface and neutral formatting in one place.

parse-forget-request

fn (arg: Str): ForgetRequest

Parse /forget arguments into {scope, selector, raw}.

render-export-summary

fn (bundle: ::ai::memory/MemoryExport): Str

Render a concise summary of a memory export bundle.

render-inspection

fn (inspection: MemoryInspection): Str

Render MemoryInspection as concise user-facing text.

select-policy

fn (policies: Vec, name: Str?): RetentionPolicy

Select a retention policy by name, defaulting to the first policy or DEFAULT_RETENTION.

Types

ForgetRequest

ForgetRequest type {
    scope: Str,
    selector: Str,
    raw: Str
}

Parsed forget request from a command argument.

MemoryInspection

MemoryInspection type {
    session-count: Int,
    user-count: Int,
    kb-count: Int,
    capsule-count: Int,
    graph-node-count: Int,
    graph-edge-count: Int,
    metadata: Map?
}

Neutral memory-inspection response shape for agents.

RetentionPolicy

RetentionPolicy type {
    name: Str,
    raw-retention-secs: Int?,
    capsule-retention-secs: Int?,
    compact-after-secs: Int?,
    export-allowed: Bool?,
    forget-allowed: Bool?,
    metadata: Map?
}

Reusable retention policy shape for agent memory lifecycle jobs.