aismemory 0.7.4 → 0.8.0

package/dist/__tests__/version-check.test.js

@@ -0,0 +1,349 @@
+/**
+ * Published-version check (CORBOT-7B8A1D16).
+ *
+ * Covers the five states the lane names: behind, current, ahead,
+ * offline/timeout, and switched off — plus the daily cache and the two places
+ * a customer reads the notice (the doctor line and the whoami / full_context
+ * tool results).
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { checkForUpdate, classifyVersion, clearUpdateNotice, compareVersions, formatUpdateNotice, getUpdateNotice, isUpdateStatus, isVersionCheckEnabled, startVersionCheck, versionCacheFilePath, REGISTRY_LATEST_URL, } from '../version-check.js';
+import { checkPackageVersion } from '../cli/doctor.js';
+import { createAgentKeyCallToolHandler } from '../mcp/tools.js';
+import { ActivityTracker } from '../auto-handoff.js';
+let home;
+function registryFetch(version, calls) {
+    return (async (input) => {
+        calls?.push(String(input));
+        return Response.json({ name: 'aismemory', version });
+    });
+}
+function offlineFetch(message = 'The operation was aborted due to timeout') {
+    return (async () => {
+        throw new Error(message);
+    });
+}
+function asStatus(result) {
+    if (!isUpdateStatus(result))
+        throw new Error(`expected a version status, got skip: ${result.skipped}`);
+    return result;
+}
+beforeEach(() => {
+    home = mkdtempSync(join(tmpdir(), 'aismemory-version-check-'));
+    clearUpdateNotice();
+});
+afterEach(() => {
+    rmSync(home, { recursive: true, force: true });
+    clearUpdateNotice();
+});
+describe('compareVersions', () => {
+    it('orders release versions by each numeric part', () => {
+        expect(compareVersions('0.6.0', '0.7.4')).toBe(-1);
+        expect(compareVersions('0.7.4', '0.6.0')).toBe(1);
+        expect(compareVersions('0.7.4', '0.7.4')).toBe(0);
+        expect(compareVersions('0.10.0', '0.9.9')).toBe(1);
+        expect(compareVersions('1.0.0', '0.99.99')).toBe(1);
+    });
+    it('treats a pre-release as older than the release it leads to', () => {
+        expect(compareVersions('1.0.0-rc.1', '1.0.0')).toBe(-1);
+        expect(compareVersions('1.0.0', '1.0.0-rc.1')).toBe(1);
+        expect(compareVersions('1.0.0-rc.1', '1.0.0-rc.2')).toBe(-1);
+        expect(compareVersions('1.0.0-alpha', '1.0.0-beta')).toBe(-1);
+    });
+    it('ignores a leading v and build metadata', () => {
+        expect(compareVersions('v0.7.4', '0.7.4+build.9')).toBe(0);
+    });
+});
+describe('classifyVersion', () => {
+    it('names the three states', () => {
+        expect(classifyVersion('0.6.0', '0.7.4')).toBe('behind');
+        expect(classifyVersion('0.7.4', '0.7.4')).toBe('current');
+        expect(classifyVersion('0.8.0', '0.7.4')).toBe('ahead');
+    });
+});
+describe('checkForUpdate', () => {
+    it('reports behind, with a notice naming both versions and both commands', async () => {
+        const result = asStatus(await checkForUpdate({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+        }));
+        expect(result.comparison).toBe('behind');
+        expect(result.currentVersion).toBe('0.6.0');
+        expect(result.latestVersion).toBe('0.7.4');
+        expect(result.notice).toContain('you are running version 0.6.0');
+        expect(result.notice).toContain('the latest published version is 0.7.4');
+        expect(result.notice).toContain('npm install -g aismemory@latest');
+        expect(result.notice).toContain('npx -y aismemory@latest');
+    });
+    it('reports current with no notice', async () => {
+        const result = asStatus(await checkForUpdate({
+            currentVersion: '0.7.4',
+            env: {},
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+        }));
+        expect(result.comparison).toBe('current');
+        expect(result.notice).toBeUndefined();
+    });
+    it('reports ahead with no notice when running an unpublished build', async () => {
+        const result = asStatus(await checkForUpdate({
+            currentVersion: '0.8.0',
+            env: {},
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+        }));
+        expect(result.comparison).toBe('ahead');
+        expect(result.notice).toBeUndefined();
+    });
+    it('skips without throwing when the registry is unreachable or times out', async () => {
+        const result = await checkForUpdate({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            fetchImpl: offlineFetch(),
+        });
+        expect(isUpdateStatus(result)).toBe(false);
+        expect(result).toMatchObject({ skipped: 'unreachable' });
+    });
+    it('skips a registry response that carries no version', async () => {
+        const result = await checkForUpdate({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            fetchImpl: (async () => Response.json({ name: 'aismemory' })),
+        });
+        expect(result).toMatchObject({ skipped: 'unreachable' });
+    });
+    it('skips a registry error status', async () => {
+        const result = await checkForUpdate({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            fetchImpl: (async () => new Response('nope', { status: 503 })),
+        });
+        expect(result).toMatchObject({ skipped: 'unreachable' });
+    });
+    it.each(['off', '0', 'false', 'no', 'OFF'])('does not call the registry when AISMEMORY_VERSION_CHECK=%s', async (value) => {
+        const calls = [];
+        const result = await checkForUpdate({
+            currentVersion: '0.6.0',
+            env: { AISMEMORY_VERSION_CHECK: value },
+            home,
+            fetchImpl: registryFetch('0.7.4', calls),
+        });
+        expect(result).toMatchObject({ skipped: 'disabled' });
+        expect(calls).toEqual([]);
+    });
+    it('stays enabled for any other value of the switch', () => {
+        expect(isVersionCheckEnabled({})).toBe(true);
+        expect(isVersionCheckEnabled({ AISMEMORY_VERSION_CHECK: 'on' })).toBe(true);
+        expect(isVersionCheckEnabled({ AISMEMORY_VERSION_CHECK: '' })).toBe(true);
+        expect(isVersionCheckEnabled({ AISMEMORY_VERSION_CHECK: 'off' })).toBe(false);
+    });
+    it('asks the registry once a day and serves the cache in between', async () => {
+        const calls = [];
+        const day = 24 * 60 * 60 * 1000;
+        const first = await checkForUpdate({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            now: () => 1_000_000,
+            fetchImpl: registryFetch('0.7.4', calls),
+        });
+        expect(asStatus(first).latestVersion).toBe('0.7.4');
+        expect(calls).toEqual([REGISTRY_LATEST_URL]);
+        expect(JSON.parse(readFileSync(versionCacheFilePath(home), 'utf-8'))).toEqual({
+            latestVersion: '0.7.4',
+            checkedAt: 1_000_000,
+        });
+        // One hour later: served from cache, no second registry call.
+        const cached = await checkForUpdate({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            now: () => 1_000_000 + 3_600_000,
+            fetchImpl: registryFetch('9.9.9', calls),
+        });
+        expect(asStatus(cached).latestVersion).toBe('0.7.4');
+        expect(calls).toHaveLength(1);
+        // A day later: the cache has expired and the registry is asked again.
+        const refreshed = await checkForUpdate({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            now: () => 1_000_000 + day + 1,
+            fetchImpl: registryFetch('0.8.0', calls),
+        });
+        expect(asStatus(refreshed).latestVersion).toBe('0.8.0');
+        expect(calls).toHaveLength(2);
+    });
+    it('ignores a corrupt cache file rather than failing', async () => {
+        mkdirSync(join(home, '.aismemory'), { recursive: true });
+        writeFileSync(versionCacheFilePath(home), 'not json at all');
+        const result = asStatus(await checkForUpdate({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+        }));
+        expect(result.latestVersion).toBe('0.7.4');
+    });
+});
+describe('startVersionCheck', () => {
+    it('publishes the notice and announces it once when behind', async () => {
+        const announced = [];
+        await startVersionCheck({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+            onUpdateAvailable: (notice) => { announced.push(notice); },
+        });
+        expect(announced).toEqual([formatUpdateNotice('0.6.0', '0.7.4')]);
+        expect(getUpdateNotice()).toBe(formatUpdateNotice('0.6.0', '0.7.4'));
+    });
+    it.each([
+        ['current', '0.7.4', registryFetch('0.7.4')],
+        ['ahead', '0.8.0', registryFetch('0.7.4')],
+        ['offline', '0.6.0', offlineFetch()],
+    ])('publishes no notice when %s', async (_label, currentVersion, fetchImpl) => {
+        await startVersionCheck({ currentVersion, env: {}, home, fetchImpl });
+        expect(getUpdateNotice()).toBeNull();
+    });
+    it('publishes no notice when the check is switched off', async () => {
+        await startVersionCheck({
+            currentVersion: '0.6.0',
+            env: { AISMEMORY_VERSION_CHECK: 'off' },
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+        });
+        expect(getUpdateNotice()).toBeNull();
+    });
+});
+describe('doctor package-version check', () => {
+    const behind = async () => ({
+        currentVersion: '0.6.0',
+        latestVersion: '0.7.4',
+        comparison: 'behind',
+        notice: formatUpdateNotice('0.6.0', '0.7.4'),
+    });
+    it('WARNs with the upgrade command when behind', async () => {
+        const check = await checkPackageVersion({ packageVersion: '0.6.0', versionCheck: behind });
+        expect(check).toMatchObject({ name: 'Package version', status: 'WARN' });
+        expect(check.message).toContain('0.6.0');
+        expect(check.message).toContain('0.7.4');
+        expect(check.hint).toContain('npm install -g aismemory@latest');
+    });
+    it('PASSes when current', async () => {
+        const check = await checkPackageVersion({
+            packageVersion: '0.7.4',
+            versionCheck: async () => ({
+                currentVersion: '0.7.4', latestVersion: '0.7.4', comparison: 'current',
+            }),
+        });
+        expect(check.status).toBe('PASS');
+        expect(check.message).toContain('the latest published version');
+    });
+    it('PASSes when ahead of the published version', async () => {
+        const check = await checkPackageVersion({
+            packageVersion: '0.8.0',
+            versionCheck: async () => ({
+                currentVersion: '0.8.0', latestVersion: '0.7.4', comparison: 'ahead',
+            }),
+        });
+        expect(check.status).toBe('PASS');
+        expect(check.message).toContain('ahead of the latest published version');
+    });
+    it('PASSes and says so when the registry could not be reached', async () => {
+        const check = await checkPackageVersion({
+            packageVersion: '0.6.0',
+            versionCheck: async () => ({ skipped: 'unreachable', detail: 'timed out' }),
+        });
+        expect(check.status).toBe('PASS');
+        expect(check.message).toContain('could not reach the npm registry');
+        expect(check.hint).toBeUndefined();
+    });
+    it('PASSes and says so when the check is switched off', async () => {
+        const check = await checkPackageVersion({
+            packageVersion: '0.6.0',
+            versionCheck: async () => ({ skipped: 'disabled' }),
+        });
+        expect(check.status).toBe('PASS');
+        expect(check.message).toContain('AISMEMORY_VERSION_CHECK');
+    });
+    it('runs the real check end to end against an injected registry', async () => {
+        const check = await checkPackageVersion({
+            packageVersion: '0.6.0',
+            env: {},
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+        });
+        expect(check.status).toBe('WARN');
+        expect(check.message).toContain('aismemory update available');
+    });
+});
+describe('model context protocol tool results', () => {
+    const config = {
+        agentId: '11111111-2222-3333-4444-555555555555',
+        apiKey: 'synthetic-key',
+        tenantId: 'tenant-a',
+    };
+    function handlerWithFetch(payload) {
+        globalThis.fetch = (async () => Response.json(payload));
+        return createAgentKeyCallToolHandler({
+            aisUrl: 'https://ais.example',
+            activityTracker: new ActivityTracker(),
+            config,
+            getSessionIdentity: () => null,
+        });
+    }
+    const originalFetch = globalThis.fetch;
+    afterEach(() => { globalThis.fetch = originalFetch; });
+    async function callTool(name) {
+        const handler = handlerWithFetch({ success: true, data: { id: config.agentId, name: 'Jaire' } });
+        const response = await handler({
+            method: 'tools/call',
+            params: { name, arguments: {} },
+        });
+        const first = response.content?.[0];
+        if (!first || first.type !== 'text')
+            throw new Error('tool returned no text content');
+        return JSON.parse(first.text);
+    }
+    it.each(['whoami', 'full_context'])('carries the notice in the %s result when behind', async (tool) => {
+        await startVersionCheck({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+        });
+        const result = await callTool(tool);
+        expect(result['aismemoryUpdateAvailable']).toBe(formatUpdateNotice('0.6.0', '0.7.4'));
+    });
+    it('carries nothing in the whoami result when the version is current', async () => {
+        await startVersionCheck({
+            currentVersion: '0.7.4',
+            env: {},
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+        });
+        const result = await callTool('whoami');
+        expect(result['aismemoryUpdateAvailable']).toBeUndefined();
+    });
+    it('leaves other tool results untouched when behind', async () => {
+        await startVersionCheck({
+            currentVersion: '0.6.0',
+            env: {},
+            home,
+            fetchImpl: registryFetch('0.7.4'),
+        });
+        const result = await callTool('recall');
+        expect(result['aismemoryUpdateAvailable']).toBeUndefined();
+    });
+});
+//# sourceMappingURL=version-check.test.js.map

package/dist/__tests__/version-check.test.js.map

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

package/dist/agent-archive.d.ts

@@ -0,0 +1,36 @@
+export declare const AGENT_ARCHIVE_TOOL = "agent_archive";
+export declare const AGENT_DELETE_ALIAS_TOOL = "agent_delete";
+export type AgentArchiveToolName = typeof AGENT_ARCHIVE_TOOL | typeof AGENT_DELETE_ALIAS_TOOL;
+export declare const AGENT_DELETE_ALIAS_NOTE = "agent_delete is a compatibility alias for agent_archive: it archived the agent and deleted nothing.";
+/** Why the key-based modes refuse both tool names. */
+export declare const AGENT_ARCHIVE_KEY_MODE_DETAIL: string;
+export declare const AGENT_ARCHIVE_DESCRIPTION: string;
+export declare const AGENT_DELETE_ALIAS_DESCRIPTION: string;
+export declare const AGENT_ARCHIVE_INPUT_SCHEMA: {
+    type: "object";
+    properties: {
+        agentId: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+};
+export interface AgentArchiveResult {
+    success: true;
+    archived: true;
+    agentId: string;
+    status: 'archived';
+    message: string;
+    aliasOf?: typeof AGENT_ARCHIVE_TOOL;
+    note?: string;
+}
+/** Sends one PATCH with the session bearer; the entrypoint passes `aisPatch`. */
+export type ArchivePatch = (path: string, body: {
+    status: 'archived';
+}) => Promise<unknown>;
+/**
+ * Archive `agentId` through the owner's own bearer. A token-rejection body is
+ * returned untouched so the caller's re-auth-and-retry path still sees it.
+ */
+export declare function archiveAgent(toolName: AgentArchiveToolName, rawArgs: unknown, patch: ArchivePatch): Promise<unknown>;

package/dist/agent-archive.js

@@ -0,0 +1,69 @@
+/**
+ * `agent_archive` and its `agent_delete` compatibility alias (CORBOT-BA5AADB0).
+ *
+ * An owner archives their own agent without the console: the tool sends
+ * `PATCH /v1/agents/<id> {"status":"archived"}` with the session's own bearer.
+ * The server decides who may do that — its bond check lets an owner token
+ * reach only agents that owner holds — so this module adds no permission.
+ *
+ * Archive is not delete: the agent and its memories stay, and the owner can
+ * restore it. `agent_delete` used to be the name for this action, so it is
+ * kept as an alias that archives and says so, in its description and in its
+ * response. Hard delete is not offered here.
+ */
+import { z } from 'zod';
+import { isAuthErrorResult } from './auth-staleness.js';
+export const AGENT_ARCHIVE_TOOL = 'agent_archive';
+export const AGENT_DELETE_ALIAS_TOOL = 'agent_delete';
+export const AGENT_DELETE_ALIAS_NOTE = 'agent_delete is a compatibility alias for agent_archive: it archived the agent and deleted nothing.';
+/** Why the key-based modes refuse both tool names. */
+export const AGENT_ARCHIVE_KEY_MODE_DETAIL = 'archiving an agent needs the owner sign-in (run aismemory without AIS_API_KEY or AIS_WORKSPACE_KEY and ' +
+    'approve the sign-in link). A key cannot archive any agent, its own included.';
+export const AGENT_ARCHIVE_DESCRIPTION = 'Archive one of your own agents: its status becomes "archived", it stops appearing as a live agent, ' +
+    'and its memories are kept. Nothing is deleted, and the owner can restore it. ' +
+    'Needs the owner sign-in; the service refuses an agent that belongs to someone else.';
+export const AGENT_DELETE_ALIAS_DESCRIPTION = 'Compatibility alias for agent_archive. It ARCHIVES the agent; it does not delete it. Use agent_archive. ' +
+    AGENT_ARCHIVE_DESCRIPTION;
+export const AGENT_ARCHIVE_INPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        agentId: {
+            type: 'string',
+            description: 'The id (uuid) of the agent to archive. Required: the tool never guesses which agent you mean.',
+        },
+    },
+    required: ['agentId'],
+};
+const agentArchiveArgsSchema = z
+    .object({
+    agentId: z
+        .string({ message: 'agentId is required' })
+        .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, 'agentId must be a valid agent UUID'),
+})
+    .strict();
+/**
+ * Archive `agentId` through the owner's own bearer. A token-rejection body is
+ * returned untouched so the caller's re-auth-and-retry path still sees it.
+ */
+export async function archiveAgent(toolName, rawArgs, patch) {
+    const parsed = agentArchiveArgsSchema.safeParse(rawArgs);
+    if (!parsed.success) {
+        throw new Error(`Invalid arguments: ${parsed.error.issues.map((i) => i.message).join('; ')}`);
+    }
+    const { agentId } = parsed.data;
+    const response = await patch(`/v1/agents/${agentId}`, { status: 'archived' });
+    if (isAuthErrorResult(response))
+        return response;
+    const result = {
+        success: true,
+        archived: true,
+        agentId,
+        status: 'archived',
+        message: `Agent ${agentId} archived. Nothing was deleted: its memories are kept and the owner can restore it.`,
+    };
+    if (toolName === AGENT_DELETE_ALIAS_TOOL) {
+        return { ...result, aliasOf: AGENT_ARCHIVE_TOOL, note: AGENT_DELETE_ALIAS_NOTE };
+    }
+    return result;
+}
+//# sourceMappingURL=agent-archive.js.map

package/dist/agent-archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-archive.js","sourceRoot":"","sources":["../src/agent-archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAClD,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC;AAItD,MAAM,CAAC,MAAM,uBAAuB,GAClC,qGAAqG,CAAC;AAExG,sDAAsD;AACtD,MAAM,CAAC,MAAM,6BAA6B,GACxC,yGAAyG;IACzG,8EAA8E,CAAC;AAEjF,MAAM,CAAC,MAAM,yBAAyB,GACpC,qGAAqG;IACrG,+EAA+E;IAC/E,qFAAqF,CAAC;AAExF,MAAM,CAAC,MAAM,8BAA8B,GACzC,0GAA0G;IAC1G,yBAAyB,CAAC;AAE5B,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+FAA+F;SAC7G;KACF;IACD,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;SAC1C,KAAK,CAAC,iEAAiE,EAAE,oCAAoC,CAAC;CAClH,CAAC;KACD,MAAM,EAAE,CAAC;AAeZ;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAA8B,EAC9B,OAAgB,EAChB,KAAmB;IAEnB,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAChC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAC9E,IAAI,iBAAiB,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAEjD,MAAM,MAAM,GAAuB;QACjC,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,OAAO;QACP,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,SAAS,OAAO,qFAAqF;KAC/G,CAAC;IACF,IAAI,QAAQ,KAAK,uBAAuB,EAAE,CAAC;QACzC,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/agent-key-mode.d.ts

@@ -26,7 +26,7 @@ export declare function aisKeyPatch(aisUrl: string, path: string, apiKey: string
 export declare const UNKNOWN_TOOL_KEY_MODE: unique symbol;
 /**
  * Error for a tool whose server route falls outside the agent-API-key
- * allowlist (memory, goals, dream, full-context). Thrown instead of ever
+ * allowlist (memory, goals, dream, full-context, handoff). Thrown instead of ever
  * making the doomed request — the server would 403 it anyway, but failing
  * fast client-side keeps the error message focused on SCOPE rather than a
  * generic 403, and avoids burning a round trip on a request known to fail.

package/dist/agent-key-mode.js

@@ -19,10 +19,12 @@
  * out-of-scope route return an honest error instead of making a request the
  * server would reject anyway.
  */
-import { AisHttpError } from './ais-http-error.js';
+import { AisHttpError, duplicateMemoryResult } from './ais-http-error.js';
 import { emitTelemetry } from './telemetry.js';
-import { parseEmptyToolArgs, parseRecallArgs, parseFullContextArgs, parseRememberArgs, parseInboxSendArgs, parseInboxReadArgs, parseGoalCreateArgs, parseGoalListArgs, parseGoalUpdateProgressArgs, parseGoalCompleteArgs, parseInboxAckArgs, } from './tool-args.js';
+import { retryAfterOf, shouldHonourRetryAfter, sleepSeconds } from './retry-after.js';
+import { parseEmptyToolArgs, parseRecallArgs, parseFullContextArgs, parseRememberArgs, parseInboxSendArgs, parseInboxReadArgs, parseGoalCreateArgs, parseGoalListArgs, parseGoalUpdateProgressArgs, parseGoalCompleteArgs, parseInboxAckArgs, parseHandoffArgs, } from './tool-args.js';
 import { readInboxAndMaybeAck } from './inbox-client.js';
+import { AGENT_ARCHIVE_KEY_MODE_DETAIL } from './agent-archive.js';
 /** Thrown by loadAgentApiKeyConfig when AIS_AGENT_API_KEY is set without AIS_AGENT_ID. */
 export class AgentApiKeyConfigError extends Error {
     constructor(message) {
@@ -94,23 +96,32 @@ export async function aisKeyPost(aisUrl, path, apiKey, body, fetchImpl = globalT
     const data = await readJson(res);
     if (!res.ok) {
         emitTelemetry({ event: 'ais.http.failure', path, httpStatus: res.status, error: `HTTP ${res.status}` });
-        throw new AisHttpError(res.status, path, data);
+        throw new AisHttpError(res.status, path, data, retryAfterOf(res));
     }
     return data;
 }
 export async function aisKeyGet(aisUrl, path, apiKey, fetchImpl = globalThis.fetch) {
     let res;
-    try {
-        res = await fetchImpl(`${aisUrl}${path}`, { headers: { 'x-agent-api-key': apiKey } });
-    }
-    catch (err) {
-        emitTelemetry({ event: 'ais.http.failure', path, error: err instanceof Error ? err.message : String(err) });
-        throw err;
+    for (let attempt = 0;; attempt++) {
+        try {
+            res = await fetchImpl(`${aisUrl}${path}`, { headers: { 'x-agent-api-key': apiKey } });
+        }
+        catch (err) {
+            emitTelemetry({ event: 'ais.http.failure', path, error: err instanceof Error ? err.message : String(err) });
+            throw err;
+        }
+        // Jaire C9: a read told to wait a few seconds (429/503 Retry-After)
+        // waits and tries once more; writes are never retried.
+        const retryAfter = retryAfterOf(res);
+        if (attempt > 0 || !shouldHonourRetryAfter(retryAfter))
+            break;
+        emitTelemetry({ event: 'ais.http.retry', path, httpStatus: res.status });
+        await sleepSeconds(retryAfter);
     }
     const data = await readJson(res);
     if (!res.ok) {
         emitTelemetry({ event: 'ais.http.failure', path, httpStatus: res.status, error: `HTTP ${res.status}` });
-        throw new AisHttpError(res.status, path, data);
+        throw new AisHttpError(res.status, path, data, retryAfterOf(res));
     }
     return data;
 }
@@ -130,7 +141,7 @@ export async function aisKeyPatch(aisUrl, path, apiKey, body, fetchImpl = global
     const data = await readJson(res);
     if (!res.ok) {
         emitTelemetry({ event: 'ais.http.failure', path, httpStatus: res.status, error: `HTTP ${res.status}` });
-        throw new AisHttpError(res.status, path, data);
+        throw new AisHttpError(res.status, path, data, retryAfterOf(res));
     }
     return data;
 }
@@ -139,7 +150,7 @@ export async function aisKeyPatch(aisUrl, path, apiKey, body, fetchImpl = global
 export const UNKNOWN_TOOL_KEY_MODE = Symbol('unknown-tool-key-mode');
 /**
  * Error for a tool whose server route falls outside the agent-API-key
- * allowlist (memory, goals, dream, full-context). Thrown instead of ever
+ * allowlist (memory, goals, dream, full-context, handoff). Thrown instead of ever
  * making the doomed request — the server would 403 it anyway, but failing
  * fast client-side keeps the error message focused on SCOPE rather than a
  * generic 403, and avoids burning a round trip on a request known to fail.
@@ -155,11 +166,22 @@ export async function dispatchToolKeyMode(aisUrl, config, name, rawArgs, fetchIm
     switch (name) {
         case 'remember': {
             const args = parseRememberArgs(rawArgs);
-            return aisKeyPost(aisUrl, `/v1/agents/${agentId}/memory`, apiKey, {
-                content: args.content,
-                type: args.type,
-                importance: args.importance,
-            }, fetchImpl);
+            try {
+                return await aisKeyPost(aisUrl, `/v1/agents/${agentId}/memory`, apiKey, {
+                    content: args.content,
+                    type: args.type,
+                    importance: args.importance,
+                    ...(args.tags !== undefined && { tags: args.tags }),
+                }, fetchImpl);
+            }
+            catch (err) {
+                // CORBOT-F21668B5: a deduplicated write is not a lost write — report
+                // what is true instead of an error the agent would retry forever.
+                const duplicate = duplicateMemoryResult(err);
+                if (duplicate)
+                    return duplicate;
+                throw err;
+            }
         }
         case 'recall': {
             const args = parseRecallArgs(rawArgs);
@@ -169,6 +191,8 @@ export async function dispatchToolKeyMode(aisUrl, config, name, rawArgs, fetchIm
                 params.set('limit', String(args.limit));
             if (args.type !== undefined)
                 params.set('types', args.type);
+            if (args.tags !== undefined && args.tags.length > 0)
+                params.set('tags', args.tags.join(','));
             if (args.principalAgentId !== undefined) {
                 params.set('principalAgentId', args.principalAgentId);
             }
@@ -266,11 +290,24 @@ export async function dispatchToolKeyMode(aisUrl, config, name, rawArgs, fetchIm
                 ...(args.lessonsLearned !== undefined ? { lessonsLearned: args.lessonsLearned } : {}),
             }, fetchImpl);
         }
-        case 'handoff':
-            throw new OutOfScopeToolError('handoff', "the handoff route is outside the key's allowed scope (memory, goals, dream, full-context).");
+        case 'handoff': {
+            // CORBOT-E3541A7F: handoff is in the agent key's scope. The route is
+            // own-agent only — the service pins the path agent to the key's agent —
+            // so the agent id comes from the key, never from the caller's arguments.
+            const args = parseHandoffArgs(rawArgs);
+            return aisKeyPost(aisUrl, `/v1/agents/${agentId}/handoff`, apiKey, {
+                ...(args.summary !== undefined ? { summary: args.summary } : {}),
+                ...(args.keyLearnings !== undefined ? { keyLearnings: args.keyLearnings } : {}),
+                ...(args.docPath !== undefined ? { docPath: args.docPath } : {}),
+                ...(args.docPrUrl !== undefined ? { docPrUrl: args.docPrUrl } : {}),
+            }, fetchImpl);
+        }
         case 'agent_load':
             throw new OutOfScopeToolError('agent_load', 'switching agents requires a tenant-wide agent-listing route, which is outside the ' +
                 "key's allowed scope. The active agent is fixed to AIS_AGENT_ID for the life of this process.");
+        case 'agent_archive':
+        case 'agent_delete':
+            throw new OutOfScopeToolError(name, AGENT_ARCHIVE_KEY_MODE_DETAIL);
         default:
             return UNKNOWN_TOOL_KEY_MODE;
     }