aismemory 0.7.3 → 0.7.5

package/dist/mcp/tools.js

@@ -0,0 +1,433 @@
+/**
+ * Model context protocol `tools/call` dispatch for the aismemory server.
+ *
+ * Moved verbatim out of `src/index.ts` (CORBOT-B8D6C9BA) so the entrypoint
+ * keeps only process wiring. Each factory below returns the exact handler the
+ * matching auth mode used to register inline; behaviour, error text, telemetry
+ * and tool ordering are unchanged. State that lives on the entrypoint (the
+ * active credentials, the session agent override, the hydrated agent context)
+ * is reached through the context objects rather than a closure.
+ */
+import { aisGet, aisPost, aisPatch } from '../ais-http.js';
+import { isAuthErrorResult } from '../auth-staleness.js';
+import { saveAgentPreference } from '../agent-preference.js';
+import { hydrateIdentity } from '../hydration.js';
+import { emitTelemetry, hashAgentId } from '../telemetry.js';
+import { duplicateMemoryResult } from '../ais-http-error.js';
+import { parseAgentLoadArgs, parseEmptyToolArgs, parseHandoffArgs, parseRecallArgs, parseFullContextArgs, parseRememberArgs, parseInboxSendArgs, parseInboxReadArgs, parseInboxAckArgs, parseGoalCreateArgs, parseGoalListArgs, parseGoalUpdateProgressArgs, parseGoalCompleteArgs, } from '../tool-args.js';
+import { assertPinnedAgent, requiresIdentityGate, verifyPinnedIdentity } from '../harness-identity.js';
+import { readInboxAndMaybeAck } from '../inbox-client.js';
+import { dispatchToolKeyMode, UNKNOWN_TOOL_KEY_MODE } from '../agent-key-mode.js';
+import { getUpdateNotice } from '../version-check.js';
+import { dispatchToolWorkspaceKeyMode, UNKNOWN_TOOL_WORKSPACE_KEY_MODE, } from '../workspace-key-mode.js';
+/**
+ * Tools whose result carries the "a newer aismemory has been published" notice
+ * (CORBOT-7B8A1D16). whoami and full_context are the two orientation calls an
+ * agent makes at the start of a session, so the notice lands where a person
+ * reading the transcript sees it — unlike a stderr line, which no model
+ * context protocol client shows. The check runs in the background at startup;
+ * when it has not settled yet, or the version is current, nothing is added.
+ */
+const UPDATE_NOTICE_TOOLS = new Set(['whoami', 'full_context']);
+function withUpdateNotice(toolName, result) {
+    if (!UPDATE_NOTICE_TOOLS.has(toolName))
+        return result;
+    const notice = getUpdateNotice();
+    if (notice === null)
+        return result;
+    if (typeof result !== 'object' || result === null || Array.isArray(result))
+        return result;
+    return { ...result, aismemoryUpdateAvailable: notice };
+}
+/**
+ * `tools/call` handler for workspace-key auth mode (CORBOT-3103ED88).
+ *
+ * Like agent-API-key mode but supports agent_load: when agent_load succeeds,
+ * the active agentId is updated for subsequent calls.
+ */
+export function createWorkspaceKeyCallToolHandler(ctx) {
+    return async (request) => {
+        const { name, arguments: args } = request.params;
+        const rawArgs = args ?? {};
+        ctx.activityTracker.recordToolUse(name);
+        const toolStartedAt = Date.now();
+        try {
+            const callConfig = ctx.getActiveConfig();
+            if (requiresIdentityGate(name, rawArgs)) {
+                await verifyPinnedIdentity(ctx.getHarnessIdentity(), callConfig.agentId, () => dispatchToolWorkspaceKeyMode(ctx.aisUrl, callConfig, 'whoami', {}));
+            }
+            const result = await dispatchToolWorkspaceKeyMode(ctx.aisUrl, callConfig, name, rawArgs);
+            if (result === UNKNOWN_TOOL_WORKSPACE_KEY_MODE) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: `Unknown tool: ${name}` }) }],
+                    isError: true,
+                };
+            }
+            // agent_load: update the active agentId for subsequent calls.
+            if (name === 'agent_load' &&
+                typeof result === 'object' &&
+                result !== null &&
+                'switched' in result &&
+                result.switched) {
+                const switchResult = result;
+                if (ctx.getHarnessIdentity()) {
+                    await verifyPinnedIdentity(ctx.getHarnessIdentity(), switchResult.agentId, () => dispatchToolWorkspaceKeyMode(ctx.aisUrl, { ...callConfig, agentId: switchResult.agentId }, 'whoami', {}));
+                }
+                ctx.setActiveConfig({ ...ctx.getActiveConfig(), agentId: switchResult.agentId });
+                ctx.stderr(`Switched active agent to ${switchResult.agentId}`);
+            }
+            emitTelemetry({
+                event: 'tool.call',
+                tool: name,
+                agentIdHash: hashAgentId(ctx.getActiveConfig().agentId),
+                latencyMs: Date.now() - toolStartedAt,
+                status: 'ok',
+            });
+            return { content: [{ type: 'text', text: JSON.stringify(withUpdateNotice(name, result), null, 2) }] };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            emitTelemetry({
+                event: 'tool.call',
+                tool: name,
+                agentIdHash: hashAgentId(ctx.getActiveConfig().agentId),
+                latencyMs: Date.now() - toolStartedAt,
+                status: 'error',
+                error: message,
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+                isError: true,
+            };
+        }
+    };
+}
+/** `tools/call` handler for agent-API-key auth mode (CORBOT-B1D3244C). */
+export function createAgentKeyCallToolHandler(ctx) {
+    const { config } = ctx;
+    return async (request) => {
+        const { name, arguments: args } = request.params;
+        const rawArgs = args ?? {};
+        ctx.activityTracker.recordToolUse(name);
+        const toolStartedAt = Date.now();
+        try {
+            if (requiresIdentityGate(name, rawArgs)) {
+                await verifyPinnedIdentity(ctx.getHarnessIdentity(), config.agentId, () => dispatchToolKeyMode(ctx.aisUrl, config, 'whoami', {}));
+            }
+            const result = await dispatchToolKeyMode(ctx.aisUrl, config, name, rawArgs);
+            if (result === UNKNOWN_TOOL_KEY_MODE) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: `Unknown tool: ${name}` }) }],
+                    isError: true,
+                };
+            }
+            emitTelemetry({
+                event: 'tool.call',
+                tool: name,
+                agentIdHash: hashAgentId(config.agentId),
+                latencyMs: Date.now() - toolStartedAt,
+                status: 'ok',
+            });
+            return { content: [{ type: 'text', text: JSON.stringify(withUpdateNotice(name, result), null, 2) }] };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            emitTelemetry({
+                event: 'tool.call',
+                tool: name,
+                agentIdHash: hashAgentId(config.agentId),
+                latencyMs: Date.now() - toolStartedAt,
+                status: 'error',
+                error: message,
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+                isError: true,
+            };
+        }
+    };
+}
+/**
+ * `tools/call` handler for the bearer / device-flow mode — the full tool
+ * surface, including the invalidate-and-retry-once path for a token the
+ * server rejected mid-session (CORBOT-A5BBD580).
+ */
+export function createOAuthCallToolHandler(ctx) {
+    return async (request) => {
+        const { name, arguments: args } = request.params;
+        const rawArgs = args ?? {};
+        ctx.activityTracker.recordToolUse(name);
+        const toolStartedAt = Date.now();
+        try {
+            if (requiresIdentityGate(name, rawArgs)) {
+                assertPinnedAgent(ctx.getHarnessIdentity(), ctx.getHarnessIdentity()?.agentId ?? 'unselected');
+            }
+            const UNKNOWN_TOOL = Symbol('unknown-tool');
+            const dispatchTool = async (c) => {
+                const token = c.token;
+                // agentId is mutable across `agent_load` calls within this session.
+                let agentId = ctx.getHarnessIdentity()?.agentId ?? c.agentId;
+                if (requiresIdentityGate(name, rawArgs)) {
+                    await verifyPinnedIdentity(ctx.getHarnessIdentity(), agentId, () => aisGet(`/v1/agents/${agentId}`, token));
+                }
+                let result;
+                switch (name) {
+                    case 'remember': {
+                        const rememberArgs = parseRememberArgs(rawArgs);
+                        try {
+                            result = await aisPost(`/v1/agents/${agentId}/memory`, {
+                                content: rememberArgs.content,
+                                type: rememberArgs.type,
+                                importance: rememberArgs.importance,
+                            }, token);
+                            ctx.activityTracker.recordMemoryStored(rememberArgs.content);
+                        }
+                        catch (err) {
+                            // CORBOT-F21668B5: the server deduplicated this write. The content
+                            // is stored (from the earlier identical write), so answer with the
+                            // truth rather than an error. No recordMemoryStored: this call
+                            // added nothing to the session's stored set.
+                            const duplicate = duplicateMemoryResult(err);
+                            if (!duplicate)
+                                throw err;
+                            result = duplicate;
+                        }
+                        break;
+                    }
+                    case 'recall': {
+                        const recallArgs = parseRecallArgs(rawArgs);
+                        const params = new URLSearchParams();
+                        params.set('query', recallArgs.query);
+                        if (recallArgs.limit !== undefined)
+                            params.set('limit', String(recallArgs.limit));
+                        if (recallArgs.type !== undefined)
+                            params.set('types', recallArgs.type);
+                        if (recallArgs.principalAgentId !== undefined) {
+                            params.set('principalAgentId', recallArgs.principalAgentId);
+                        }
+                        result = await aisGet(`/v1/agents/${agentId}/memory?${params}`, token);
+                        break;
+                    }
+                    case 'whoami':
+                        parseEmptyToolArgs(rawArgs);
+                        result = await aisGet(`/v1/agents/${agentId}`, token);
+                        break;
+                    case 'full_context': {
+                        const fcArgs = parseFullContextArgs(rawArgs);
+                        const fcParams = new URLSearchParams();
+                        if (fcArgs.principalAgentId !== undefined)
+                            fcParams.set('principalAgentId', fcArgs.principalAgentId);
+                        if (fcArgs.memoriesLimit !== undefined)
+                            fcParams.set('memoriesLimit', String(fcArgs.memoriesLimit));
+                        if (fcArgs.view !== undefined)
+                            fcParams.set('view', fcArgs.view);
+                        const fcQs = fcParams.toString();
+                        const fcPath = `/v1/agents/${agentId}/full-context${fcQs ? `?${fcQs}` : ''}`;
+                        result = await aisGet(fcPath, token);
+                        break;
+                    }
+                    case 'dream':
+                        parseEmptyToolArgs(rawArgs);
+                        result = await aisPost(`/v1/agents/${agentId}/dream`, {}, token);
+                        break;
+                    case 'handoff': {
+                        const handoffArgs = parseHandoffArgs(rawArgs);
+                        result = await aisPost(`/v1/agents/${agentId}/handoff`, {
+                            summary: handoffArgs.summary ?? 'Session ended',
+                            keyLearnings: handoffArgs.keyLearnings ?? [],
+                            // CORBOT-E3541A7F: the handoff tool schema declares these two, so
+                            // the token path forwards them too — otherwise a field the schema
+                            // advertises would be silently dropped in this mode alone.
+                            ...(handoffArgs.docPath !== undefined ? { docPath: handoffArgs.docPath } : {}),
+                            ...(handoffArgs.docPrUrl !== undefined ? { docPrUrl: handoffArgs.docPrUrl } : {}),
+                        }, token);
+                        break;
+                    }
+                    case 'agent_load': {
+                        const { query, memoriesLimit } = parseAgentLoadArgs(rawArgs);
+                        const target = await ctx.resolveAgentForLoad(token, query);
+                        const harnessIdentity = ctx.getHarnessIdentity();
+                        if (harnessIdentity)
+                            assertPinnedAgent(harnessIdentity, target.id);
+                        ctx.persistClaudeSessionAgentName(process.env.CLAUDE_SESSION_ID, target.name);
+                        agentId = target.id;
+                        // Persist the switch so subsequent tool calls use the new agent.
+                        // saveAgentPreference() MUST be called here so that a process
+                        // restart (silent MCP reconnect) restores the switched agent from
+                        // disk instead of silently reverting to the default
+                        // (CORBOT-497C7FA3). Ids only — no token is ever written to disk.
+                        // sessionAgentOverride MUST also be set so that a key-enrolled
+                        // TokenManager doesn't clobber this switch on the very next
+                        // ensureCredentials() call (the manager resolves identity once
+                        // and never re-resolves it).
+                        const currentCreds = ctx.getCredentials();
+                        if (currentCreds) {
+                            const switchedCreds = { ...currentCreds, agentId };
+                            ctx.setCredentials(switchedCreds);
+                            ctx.setSessionAgentOverride({ agentId, tenantId: switchedCreds.tenantId });
+                            if (!harnessIdentity)
+                                saveAgentPreference({ agentId, tenantId: switchedCreds.tenantId });
+                        }
+                        const loaded = await hydrateIdentity(ctx.aisUrl, agentId, token, memoriesLimit);
+                        ctx.setAgentContext(loaded);
+                        ctx.applyMemoryRefresh(agentId, token);
+                        ctx.server.notification({ method: 'notifications/prompts/list_changed' });
+                        ctx.stderr(`agent_load: switched to "${target.name}" (${target.id})`);
+                        result = {
+                            success: true,
+                            agentId: target.id,
+                            name: target.name,
+                            did: loaded?.identity.did ?? null,
+                            status: target.status,
+                            memoriesLoaded: loaded?.recentMemories.length ?? 0,
+                            goalsLoaded: loaded?.goals.length ?? 0,
+                        };
+                        break;
+                    }
+                    case 'inbox_send': {
+                        const inboxSendArgs = parseInboxSendArgs(rawArgs);
+                        result = await aisPost(`/v1/agents/${agentId}/inbox`, {
+                            recipientAgentId: inboxSendArgs.recipientAgentId,
+                            kind: inboxSendArgs.kind,
+                            body: inboxSendArgs.body,
+                            ...(inboxSendArgs.threadId !== undefined ? { threadId: inboxSendArgs.threadId } : {}),
+                            ...(inboxSendArgs.taskId !== undefined ? { taskId: inboxSendArgs.taskId } : {}),
+                            ...(inboxSendArgs.inReplyTo !== undefined ? { inReplyTo: inboxSendArgs.inReplyTo } : {}),
+                            ...(inboxSendArgs.messageId !== undefined ? { messageId: inboxSendArgs.messageId } : {}),
+                            ...(inboxSendArgs.ttlSeconds !== undefined ? { ttlSeconds: inboxSendArgs.ttlSeconds } : {}),
+                        }, token);
+                        break;
+                    }
+                    case 'inbox_read': {
+                        const inboxReadArgs = parseInboxReadArgs(rawArgs);
+                        const inboxParams = new URLSearchParams();
+                        if (inboxReadArgs.cursor !== undefined)
+                            inboxParams.set('cursor', inboxReadArgs.cursor);
+                        inboxParams.set('limit', String(inboxReadArgs.limit));
+                        inboxParams.set('unreadOnly', String(inboxReadArgs.unreadOnly));
+                        result = await readInboxAndMaybeAck(inboxReadArgs, () => aisGet(`/v1/agents/${agentId}/inbox?${inboxParams}`, token), (messageIds) => aisPost(`/v1/agents/${agentId}/inbox/ack`, { messageIds }, token));
+                        break;
+                    }
+                    case 'inbox_ack': {
+                        const inboxAckArgs = parseInboxAckArgs(rawArgs);
+                        result = await aisPost(`/v1/agents/${agentId}/inbox/ack`, { messageIds: inboxAckArgs.messageIds }, token);
+                        break;
+                    }
+                    case 'goal_create': {
+                        const goalCreateArgs = parseGoalCreateArgs(rawArgs);
+                        result = await aisPost(`/v1/agents/${agentId}/goals`, {
+                            title: goalCreateArgs.title,
+                            description: goalCreateArgs.description,
+                            ...(goalCreateArgs.successCriteria !== undefined ? { successCriteria: goalCreateArgs.successCriteria } : {}),
+                            ...(goalCreateArgs.parentGoalId !== undefined ? { parentGoalId: goalCreateArgs.parentGoalId } : {}),
+                        }, token);
+                        break;
+                    }
+                    case 'goal_list': {
+                        const goalListArgs = parseGoalListArgs(rawArgs);
+                        const goalParams = new URLSearchParams();
+                        if (goalListArgs.status !== undefined)
+                            goalParams.set('status', goalListArgs.status);
+                        if (goalListArgs.page !== undefined)
+                            goalParams.set('page', String(goalListArgs.page));
+                        goalParams.set('limit', String(goalListArgs.limit));
+                        if (goalListArgs.parentGoalId !== undefined)
+                            goalParams.set('parentGoalId', goalListArgs.parentGoalId);
+                        result = await aisGet(`/v1/agents/${agentId}/goals?${goalParams}`, token);
+                        break;
+                    }
+                    case 'goal_update_progress': {
+                        const goalProgressArgs = parseGoalUpdateProgressArgs(rawArgs);
+                        result = await aisPatch(`/v1/agents/${agentId}/goals/${goalProgressArgs.goalId}`, {
+                            progress: goalProgressArgs.progress,
+                        }, token);
+                        break;
+                    }
+                    case 'goal_complete': {
+                        const goalCompleteArgs = parseGoalCompleteArgs(rawArgs);
+                        result = await aisPost(`/v1/agents/${agentId}/goals/${goalCompleteArgs.goalId}/complete`, {
+                            success: goalCompleteArgs.success,
+                            ...(goalCompleteArgs.notes !== undefined ? { notes: goalCompleteArgs.notes } : {}),
+                            ...(goalCompleteArgs.lessonsLearned !== undefined ? { lessonsLearned: goalCompleteArgs.lessonsLearned } : {}),
+                        }, token);
+                        break;
+                    }
+                    default:
+                        emitTelemetry({
+                            event: 'tool.call',
+                            tool: name,
+                            agentIdHash: hashAgentId(agentId),
+                            latencyMs: Date.now() - toolStartedAt,
+                            status: 'error',
+                            error: `Unknown tool: ${name}`,
+                        });
+                        return UNKNOWN_TOOL;
+                }
+                return result;
+            };
+            let result = await dispatchTool(await ctx.ensureCredentials());
+            if (isAuthErrorResult(result)) {
+                // CORBOT-A5BBD580: the server rejected our token mid-session
+                // (expired or secret rotated). Clear the cached creds, silently
+                // re-auth (key auth when a key file exists), and retry once.
+                ctx.stderr('AIS rejected the cached token; re-authenticating and retrying once...');
+                ctx.setCredentials(null);
+                // Drop the TokenManager's cached token too — without this, the
+                // key-enrolled path's ensureCredentials() would just re-serve the
+                // same still-time-valid-but-server-rejected token from `current`
+                // instead of re-running challenge/prove (CORBOT-A5BBD580: a JWT
+                // rejection mid-session, e.g. AIS rotating JWT_SECRET, must force a
+                // real re-auth, not a no-op retry with the same token). Also reset
+                // any escalated backoff window (CORBOT-4F7CAA8E / F2b): the server
+                // just responded with a 401, so it is reachable right now — a stale
+                // backoff window computed from unrelated prior renewal failures must
+                // not hold this re-prove behind the getCredentials() gate.
+                ctx.invalidateToken();
+                result = await dispatchTool(await ctx.ensureCredentials());
+            }
+            if (result === UNKNOWN_TOOL) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: `Unknown tool: ${name}` }) }],
+                    isError: true,
+                };
+            }
+            const okCreds = ctx.getCredentials();
+            emitTelemetry({
+                event: 'tool.call',
+                tool: name,
+                agentIdHash: okCreds ? hashAgentId(okCreds.agentId) : undefined,
+                latencyMs: Date.now() - toolStartedAt,
+                status: 'ok',
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(withUpdateNotice(name, result), null, 2) }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            const errorCreds = ctx.getCredentials();
+            const agentHash = errorCreds ? hashAgentId(errorCreds.agentId) : undefined;
+            emitTelemetry({
+                event: 'tool.call',
+                tool: name,
+                agentIdHash: agentHash,
+                latencyMs: Date.now() - toolStartedAt,
+                status: 'error',
+                error: message,
+            });
+            // BondPendingError carries human-readable text that the agent should
+            // render verbatim — return as plain text rather than JSON.
+            if (ctx.isBondPendingError(error)) {
+                return {
+                    content: [{ type: 'text', text: message }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+                isError: true,
+            };
+        }
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}

package/dist/memory-pull.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Memory pull — read an agent's own memories back out of the Agent Identity
+ * Service and into a local JSON Lines backup (CORBOT-31C43CBD).
+ *
+ * WHY THIS EXISTS
+ * The package could only ever push local -> Agent Identity Service
+ * (LocalMirror, aismemory-sync). Nothing an agent API key can call brought
+ * memories back down, so memories written from the Claude app or from Codex
+ * never reached the local copy. The two export routes do not help a key-only
+ * caller:
+ *   * POST /v1/agents/:agentId/export          -> 403, `export` is not in the
+ *     agent-API-key allowlist (agentApiKeyAuth.ts ALLOWED_AGENT_SUBRESOURCES).
+ *   * POST /v1/agents/:agentId/memory/export    -> 400 "platform is required";
+ *     it pushes to a third-party platform adapter and refuses file paths over
+ *     HTTP, so it cannot produce a local file.
+ *
+ * WHAT THIS DOES INSTEAD
+ * Pages the browse path of GET /v1/agents/:agentId/memory, which IS already on
+ * the allowlist and already supports `limit` + `offset` pagination. No server
+ * change and no access scope change: this is a client that uses a route the
+ * key can call today.
+ *
+ * SCOPE SAFETY
+ * The agent id is taken from the caller's own configuration and interpolated
+ * into the path; the server additionally rejects any request whose path agent
+ * does not equal the agent the key encodes. `principalAgentId` (the delegated
+ * cross-agent read parameter) is never sent, so a pull can only ever read the
+ * caller's own memories.
+ */
+/**
+ * Server-side cap on `limit` for GET /v1/agents/:agentId/memory
+ * (agent-identity-service `env.benchQueryLimitCap`; a larger value is a 400).
+ */
+export declare const MAX_PAGE_SIZE = 100;
+/** Page size used when the caller does not choose one. */
+export declare const DEFAULT_PAGE_SIZE = 100;
+/**
+ * Hard stop on pages fetched, so a server that never reports exhaustion cannot
+ * spin forever. At the maximum page size this covers 500,000 memories, an order
+ * of magnitude above the 50,000 the `.aismem` export format itself allows.
+ */
+export declare const MAX_PAGES = 5000;
+/** One memory as the browse path returns it. Fields beyond `id` are passed through untouched. */
+export interface PulledMemory {
+    id: string;
+    [key: string]: unknown;
+}
+export interface PullProgress {
+    /** 1-based index of the page just fetched. */
+    page: number;
+    /** Memories on that page that had not been seen before. */
+    added: number;
+    /** Distinct memories accumulated so far. */
+    total: number;
+    /** Server's reported corpus size, when it sent one. */
+    totalCount?: number;
+}
+export interface PullMemoriesOptions {
+    /** Base Agent Identity Service URL, no trailing slash. */
+    aisUrl: string;
+    /** The caller's own agent id — the only agent a scoped key may read. */
+    agentId: string;
+    /** Scoped `ais_ak_` agent API key. */
+    apiKey: string;
+    /** Memories per request. Clamped to 1..MAX_PAGE_SIZE. */
+    pageSize?: number;
+    /** Injected for tests. */
+    fetchImpl?: typeof globalThis.fetch;
+    /** Called after each page. */
+    onProgress?: (progress: PullProgress) => void;
+}
+export interface PullMemoriesResult {
+    memories: PulledMemory[];
+    /** Pages actually requested. */
+    pagesFetched: number;
+    /** Server's reported corpus size from the last page that carried one. */
+    totalCount?: number;
+    /** True when MAX_PAGES stopped the walk before the corpus was exhausted. */
+    truncated: boolean;
+}
+interface BrowsePage {
+    memories: PulledMemory[];
+    totalCount?: number;
+}
+/**
+ * Pull `data.memories` and `data.totalCount` out of a browse response, rejecting
+ * anything that does not have the documented shape. A silently-empty parse would
+ * be indistinguishable from "this agent has no memories" and would write an
+ * empty backup over a good one.
+ */
+export declare function parseBrowsePage(payload: unknown): BrowsePage;
+/** Clamp a requested page size into the range the server accepts. */
+export declare function clampPageSize(requested: number | undefined): number;
+/**
+ * Page the whole corpus for one agent, newest first.
+ *
+ * Deduplicates by memory id. This is load-bearing rather than defensive: the
+ * browse path orders by `createdAt` descending, so a memory written while the
+ * walk is in progress lands at offset 0 and shifts every later row down one,
+ * which would otherwise re-read a row that has already been captured.
+ */
+export declare function pullMemories(options: PullMemoriesOptions): Promise<PullMemoriesResult>;
+/**
+ * Render memories as JSON Lines: one memory object per line, in the order they
+ * were pulled (newest first). Always ends with a newline so the file can be
+ * appended to or concatenated cleanly.
+ */
+export declare function toJsonLines(memories: readonly PulledMemory[]): string;
+/**
+ * Turn an out-of-scope or rejected pull into a message that names the cause,
+ * rather than leaving a bare HTTP status for the operator to decode.
+ */
+export declare function describePullFailure(error: unknown): string;
+export {};