aismemory 0.7.4 → 0.8.0

package/dist/__tests__/mcp-tools.test.js

@@ -0,0 +1,189 @@
+/**
+ * Direct tests for the extracted model context protocol tool dispatch
+ * (CORBOT-B8D6C9BA). These import `src/mcp/tools.ts` rather than spawning
+ * dist/index.js, so the dispatch, the unknown-tool sentinel, and the
+ * invalidate-and-retry-once path are covered without a live AIS.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createOAuthCallToolHandler } from '../mcp/tools.js';
+const aisGet = vi.hoisted(() => vi.fn());
+const aisPost = vi.hoisted(() => vi.fn());
+const aisPatch = vi.hoisted(() => vi.fn());
+const hydrateIdentity = vi.hoisted(() => vi.fn());
+vi.mock('../ais-http.js', () => ({ aisGet, aisPost, aisPatch }));
+vi.mock('../hydration.js', () => ({ hydrateIdentity }));
+const CREDS = {
+    token: 'token-1',
+    agentId: 'agent-1',
+    tenantId: 'tenant-1',
+    expiresAt: new Date(Date.now() + 3_600_000).toISOString(),
+};
+function call(name, args = {}) {
+    return { method: 'tools/call', params: { name, arguments: args } };
+}
+function makeHarness(overrides = {}) {
+    let creds = { ...CREDS };
+    let invalidateCalls = 0;
+    let ensureCalls = 0;
+    const stderrLines = [];
+    // The handler only ever calls notification() on the server; a stub keeps
+    // the test off a real stdio transport.
+    const serverStub = {
+        notification: async () => undefined,
+    };
+    const ctx = {
+        aisUrl: 'https://ais.test',
+        server: serverStub,
+        activityTracker: { recordToolUse: () => undefined, recordMemoryStored: () => undefined },
+        getSessionIdentity: () => null,
+        setSessionIdentity: () => { },
+        getCredentials: () => creds,
+        setCredentials: (next) => { creds = next; },
+        setSessionAgentOverride: () => undefined,
+        getAgentContext: () => null,
+        setAgentContext: () => undefined,
+        ensureCredentials: async () => { ensureCalls += 1; creds = creds ?? { ...CREDS }; return creds; },
+        invalidateToken: () => { invalidateCalls += 1; },
+        applyMemoryRefresh: () => undefined,
+        resolveAgentForLoad: async () => ({ id: 'agent-2', name: 'Two', status: 'active' }),
+        persistClaudeSessionAgentName: () => undefined,
+        isBondPendingError: () => false,
+        stderr: (msg) => { stderrLines.push(msg); },
+        ...overrides,
+    };
+    return {
+        handler: createOAuthCallToolHandler(ctx),
+        invalidateCalls: () => invalidateCalls,
+        ensureCalls: () => ensureCalls,
+        creds: () => creds,
+        stderrLines: () => stderrLines,
+    };
+}
+describe('createOAuthCallToolHandler', () => {
+    beforeEach(() => {
+        aisGet.mockReset();
+        aisPost.mockReset();
+        aisPatch.mockReset();
+        hydrateIdentity.mockReset();
+        hydrateIdentity.mockResolvedValue(null);
+    });
+    it('routes whoami to GET /v1/agents/<id> and returns the payload as JSON text', async () => {
+        aisGet.mockResolvedValue({ success: true, data: { id: 'agent-1' } });
+        const h = makeHarness();
+        const res = await h.handler(call('whoami'));
+        expect(aisGet).toHaveBeenCalledWith('/v1/agents/agent-1', 'token-1');
+        expect(res.isError).toBeUndefined();
+        expect(JSON.parse(res.content[0].text)).toEqual({ success: true, data: { id: 'agent-1' } });
+    });
+    it('routes remember to POST /v1/agents/<id>/memory with the parsed defaults', async () => {
+        aisPost.mockResolvedValue({ success: true });
+        const h = makeHarness();
+        await h.handler(call('remember', { content: 'a fact' }));
+        expect(aisPost).toHaveBeenCalledWith('/v1/agents/agent-1/memory', { content: 'a fact', type: 'context', importance: 0.5 }, 'token-1');
+    });
+    // CORBOT-E3541A7F: the handoff tool schema declares docPath and docPrUrl, so
+    // this path forwards them when present and sends neither when absent.
+    it('routes handoff with docPath and docPrUrl when the caller supplies them', async () => {
+        aisPost.mockResolvedValue({ success: true });
+        const h = makeHarness();
+        await h.handler(call('handoff', {
+            summary: 'session summary',
+            docPath: 'docs/handoffs/2026-09-15.md',
+            docPrUrl: 'https://github.com/rudedoggg/Corbot/pull/5806',
+        }));
+        expect(aisPost).toHaveBeenCalledWith('/v1/agents/agent-1/handoff', {
+            summary: 'session summary',
+            keyLearnings: [],
+            docPath: 'docs/handoffs/2026-09-15.md',
+            docPrUrl: 'https://github.com/rudedoggg/Corbot/pull/5806',
+        }, 'token-1');
+    });
+    it('routes handoff without the document fields when the caller omits them', async () => {
+        aisPost.mockResolvedValue({ success: true });
+        const h = makeHarness();
+        await h.handler(call('handoff', { summary: 'no document this session' }));
+        expect(aisPost).toHaveBeenCalledWith('/v1/agents/agent-1/handoff', { summary: 'no document this session', keyLearnings: [] }, 'token-1');
+    });
+    it('returns an isError result naming an unknown tool', async () => {
+        const h = makeHarness();
+        const res = await h.handler(call('not_a_tool'));
+        expect(res.isError).toBe(true);
+        expect(JSON.parse(res.content[0].text)).toEqual({ error: 'Unknown tool: not_a_tool' });
+    });
+    it('returns an isError result carrying the thrown message', async () => {
+        aisGet.mockRejectedValue(new Error('AIS said no'));
+        const h = makeHarness();
+        const res = await h.handler(call('whoami'));
+        expect(res.isError).toBe(true);
+        expect(JSON.parse(res.content[0].text)).toEqual({ error: 'AIS said no' });
+    });
+    it('returns a bond-pending message verbatim instead of JSON', async () => {
+        aisGet.mockRejectedValue(new Error('Memory bond required — ask your human.'));
+        const h = makeHarness({ isBondPendingError: () => true });
+        const res = await h.handler(call('whoami'));
+        expect(res.isError).toBe(true);
+        expect(res.content[0].text).toBe('Memory bond required — ask your human.');
+    });
+    it('clears creds, invalidates the token, and retries exactly once on a rejected token', async () => {
+        aisGet
+            .mockResolvedValueOnce({ success: false, error: { code: 'INVALID_TOKEN' } })
+            .mockResolvedValueOnce({ success: true, data: { id: 'agent-1' } });
+        const h = makeHarness();
+        const res = await h.handler(call('whoami'));
+        expect(h.invalidateCalls()).toBe(1);
+        expect(h.ensureCalls()).toBe(2);
+        expect(aisGet).toHaveBeenCalledTimes(2);
+        expect(res.isError).toBeUndefined();
+        expect(JSON.parse(res.content[0].text)).toEqual({ success: true, data: { id: 'agent-1' } });
+        expect(h.stderrLines()).toContain('AIS rejected the cached token; re-authenticating and retrying once...');
+    });
+    it('does not retry a second time when the retry is also rejected', async () => {
+        aisGet.mockResolvedValue({ success: false, error: { code: 'TOKEN_EXPIRED' } });
+        const h = makeHarness();
+        const res = await h.handler(call('whoami'));
+        expect(aisGet).toHaveBeenCalledTimes(2);
+        expect(h.invalidateCalls()).toBe(1);
+        expect(JSON.parse(res.content[0].text)).toEqual({ success: false, error: { code: 'TOKEN_EXPIRED' } });
+    });
+    it('agent_load switches the agent id used by the next call', async () => {
+        aisGet.mockResolvedValue({ success: true, data: { id: 'agent-2' } });
+        const h = makeHarness();
+        const res = await h.handler(call('agent_load', { query: 'Two' }));
+        expect(JSON.parse(res.content[0].text)).toMatchObject({ success: true, agentId: 'agent-2', name: 'Two' });
+        expect(h.creds()?.agentId).toBe('agent-2');
+    });
+    // CORBOT-95B9ABB6: a session may switch its own identity through agent_load,
+    // but only to an agent AIS resolves AND authorizes for this session's token.
+    // An unconfirmed target must leave the session exactly where it was.
+    it('does not switch the session identity when AIS does not confirm the agent_load target', async () => {
+        let identity = { version: 1, source: 'env', agentId: 'agent-1' };
+        aisGet.mockImplementation(async (path) => (path === '/v1/agents/agent-2'
+            ? { success: false, error: { code: 'FORBIDDEN' } }
+            : { success: true, data: { id: 'agent-1' } }));
+        const h = makeHarness({
+            getSessionIdentity: () => identity,
+            setSessionIdentity: (next) => { identity = next; },
+        });
+        const refused = await h.handler(call('agent_load', { query: 'Two' }));
+        expect(refused.isError).toBe(true);
+        expect(JSON.parse(refused.content[0].text).error).toContain('whoami did not confirm agent-2');
+        expect(identity?.agentId).toBe('agent-1');
+        expect(h.creds()?.agentId).toBe('agent-1');
+        // The next write still goes out as the agent this session actually holds.
+        aisPost.mockResolvedValue({ success: true, data: { id: 'memory-1' } });
+        const write = await h.handler(call('remember', { content: 'written after the refused switch' }));
+        expect(write.isError).toBeUndefined();
+        expect(aisPost).toHaveBeenCalledWith('/v1/agents/agent-1/memory', expect.anything(), 'token-1');
+    });
+    it('refuses a write when the live agent differs from the session identity', async () => {
+        const identity = { version: 1, source: 'agent_load', agentId: 'agent-2' };
+        // The token now answers as someone else: the gate must stop the write.
+        aisGet.mockResolvedValue({ success: true, data: { id: 'agent-9' } });
+        const h = makeHarness({ getSessionIdentity: () => identity });
+        const write = await h.handler(call('remember', { content: 'must not be stored' }));
+        expect(write.isError).toBe(true);
+        expect(JSON.parse(write.content[0].text).error).toContain('whoami did not confirm agent-2');
+        expect(aisPost).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=mcp-tools.test.js.map

package/dist/__tests__/mcp-tools.test.js.map

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

package/dist/__tests__/memory-pull.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/memory-pull.test.js

@@ -0,0 +1,380 @@
+/**
+ * Tests for the memory pull capability (CORBOT-31C43CBD).
+ *
+ * Covers the three things the backup has to get right:
+ *   - pagination walks the whole corpus and terminates,
+ *   - the JSON Lines file is written correctly and atomically,
+ *   - the walk can only ever read the calling agent's own memories.
+ */
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, readFileSync, writeFileSync, existsSync, readdirSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pullMemories, parseBrowsePage, clampPageSize, toJsonLines, describePullFailure, MAX_PAGE_SIZE, DEFAULT_PAGE_SIZE, } from '../memory-pull.js';
+import { parseArgs, defaultBackupPath, writeBackupFile } from '../cli/pull-memory.js';
+import { AisHttpError } from '../ais-http-error.js';
+const AIS_URL = 'https://ais.test';
+const AGENT = 'agent-self';
+const KEY = 'ais_ak_test';
+/** A corpus of `n` memories, newest first, as the browse path orders them. */
+function makeCorpus(n) {
+    return Array.from({ length: n }, (_, i) => ({
+        id: `mem-${String(i).padStart(3, '0')}`,
+        content: `memory ${i}`,
+        type: 'fact',
+        createdAt: new Date(Date.UTC(2026, 0, 1) - i * 1000).toISOString(),
+    }));
+}
+/**
+ * A fake service that serves `corpus` over limit/offset, recording every
+ * request so the tests can assert on the URLs and headers actually sent.
+ */
+function makeFetch(corpus, recorded, options = {}) {
+    return (async (input, init) => {
+        const url = typeof input === 'string' ? input : input.toString();
+        recorded.push({ url, headers: (init?.headers ?? {}) });
+        const parsed = new URL(url);
+        const limit = Number(parsed.searchParams.get('limit'));
+        const offset = Number(parsed.searchParams.get('offset') ?? '0');
+        const page = corpus.slice(offset, offset + limit);
+        return new Response(JSON.stringify({
+            success: true,
+            data: {
+                memories: page,
+                totalCount: options.totalCount ?? corpus.length,
+            },
+        }), { status: 200, headers: { 'content-type': 'application/json' } });
+    });
+}
+function tempDir() {
+    return mkdtempSync(join(tmpdir(), 'aismemory-pull-test-'));
+}
+afterEach(() => {
+    vi.unstubAllGlobals();
+});
+// ---------------------------------------------------------------------------
+// Pagination
+// ---------------------------------------------------------------------------
+describe('pullMemories pagination', () => {
+    it('walks every page of a corpus larger than one page', async () => {
+        const corpus = makeCorpus(250);
+        const recorded = [];
+        const result = await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            pageSize: 100,
+            fetchImpl: makeFetch(corpus, recorded),
+        });
+        expect(result.memories).toHaveLength(250);
+        expect(result.memories.map((m) => m.id)).toEqual(corpus.map((m) => m.id));
+        // 100 + 100 + 50: the short third page ends the walk, no wasted request.
+        expect(result.pagesFetched).toBe(3);
+        expect(result.truncated).toBe(false);
+        expect(result.totalCount).toBe(250);
+    });
+    it('advances the offset by a full page each time', async () => {
+        const recorded = [];
+        await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            pageSize: 10,
+            fetchImpl: makeFetch(makeCorpus(25), recorded),
+        });
+        const offsets = recorded.map((r) => new URL(r.url).searchParams.get('offset'));
+        expect(offsets).toEqual(['0', '10', '20']);
+    });
+    it('stops after a single request when the corpus fits on one page', async () => {
+        const recorded = [];
+        const result = await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            pageSize: 100,
+            fetchImpl: makeFetch(makeCorpus(7), recorded),
+        });
+        expect(result.pagesFetched).toBe(1);
+        expect(result.memories).toHaveLength(7);
+    });
+    it('handles an empty corpus without writing anything odd', async () => {
+        const recorded = [];
+        const result = await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            fetchImpl: makeFetch([], recorded),
+        });
+        expect(result.memories).toEqual([]);
+        expect(result.pagesFetched).toBe(1);
+        expect(toJsonLines(result.memories)).toBe('');
+    });
+    it('exactly-full final page costs one extra request and still terminates', async () => {
+        const recorded = [];
+        const result = await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            pageSize: 10,
+            fetchImpl: makeFetch(makeCorpus(20), recorded),
+        });
+        // Pages of 10, 10, then an empty page proves exhaustion.
+        expect(result.pagesFetched).toBe(3);
+        expect(result.memories).toHaveLength(20);
+    });
+    it('deduplicates by id when a concurrent write shifts the window', async () => {
+        // The browse path orders newest first, so a memory written mid-walk lands
+        // at offset 0 and pushes every later row down one. Without dedupe the row
+        // at the page boundary would be captured twice.
+        const corpus = makeCorpus(20);
+        const recorded = [];
+        let served = 0;
+        const shiftingFetch = (async (input) => {
+            const url = typeof input === 'string' ? input : input.toString();
+            recorded.push({ url, headers: {} });
+            const parsed = new URL(url);
+            const limit = Number(parsed.searchParams.get('limit'));
+            const offset = Number(parsed.searchParams.get('offset') ?? '0');
+            // After the first page is served, a new memory appears at the head.
+            const live = served === 0 ? corpus : [{ id: 'mem-new', content: 'written mid-walk' }, ...corpus];
+            served += 1;
+            const page = live.slice(offset, offset + limit);
+            return new Response(JSON.stringify({ success: true, data: { memories: page, totalCount: live.length } }), { status: 200 });
+        });
+        const result = await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            pageSize: 10,
+            fetchImpl: shiftingFetch,
+        });
+        const ids = result.memories.map((m) => m.id);
+        expect(new Set(ids).size).toBe(ids.length);
+        // Every original memory is still captured despite the shift.
+        for (const original of corpus) {
+            expect(ids).toContain(original.id);
+        }
+    });
+    it('reports progress per page', async () => {
+        const progress = [];
+        await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            pageSize: 10,
+            fetchImpl: makeFetch(makeCorpus(25), []),
+            onProgress: (p) => progress.push(p.total),
+        });
+        expect(progress).toEqual([10, 20, 25]);
+    });
+    it('clamps the page size to what the server accepts', () => {
+        expect(clampPageSize(undefined)).toBe(DEFAULT_PAGE_SIZE);
+        expect(clampPageSize(5_000)).toBe(MAX_PAGE_SIZE);
+        expect(clampPageSize(0)).toBe(1);
+        expect(clampPageSize(-3)).toBe(1);
+        expect(clampPageSize(42)).toBe(42);
+    });
+    it('never asks the server for a limit above the cap', async () => {
+        const recorded = [];
+        await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            pageSize: 10_000,
+            fetchImpl: makeFetch(makeCorpus(3), recorded),
+        });
+        const limit = new URL(recorded[0].url).searchParams.get('limit');
+        expect(limit).toBe(String(MAX_PAGE_SIZE));
+    });
+});
+// ---------------------------------------------------------------------------
+// Own-agent-only
+// ---------------------------------------------------------------------------
+describe('pullMemories reads only its own agent', () => {
+    it('requests only the configured agent path and sends the key header', async () => {
+        const recorded = [];
+        await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            pageSize: 10,
+            fetchImpl: makeFetch(makeCorpus(25), recorded),
+        });
+        expect(recorded).toHaveLength(3);
+        for (const request of recorded) {
+            expect(request.url.startsWith(`${AIS_URL}/v1/agents/${AGENT}/memory?`)).toBe(true);
+            expect(request.headers['x-agent-api-key']).toBe(KEY);
+            // No bearer token: a scoped key must never be paired with owner auth.
+            expect(request.headers['Authorization']).toBeUndefined();
+        }
+    });
+    it('never sends principalAgentId, the delegated cross-agent read parameter', async () => {
+        const recorded = [];
+        await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: AGENT,
+            apiKey: KEY,
+            pageSize: 10,
+            fetchImpl: makeFetch(makeCorpus(25), recorded),
+        });
+        for (const request of recorded) {
+            expect(new URL(request.url).searchParams.has('principalAgentId')).toBe(false);
+        }
+    });
+    it('encodes the agent id into the path rather than letting it alter the route', async () => {
+        const recorded = [];
+        await pullMemories({
+            aisUrl: AIS_URL,
+            agentId: '../other-agent',
+            apiKey: KEY,
+            fetchImpl: makeFetch([], recorded),
+        });
+        const path = new URL(recorded[0].url).pathname;
+        expect(path).toBe('/v1/agents/..%2Fother-agent/memory');
+        expect(path).not.toContain('/other-agent/');
+    });
+});
+// ---------------------------------------------------------------------------
+// Response handling
+// ---------------------------------------------------------------------------
+describe('parseBrowsePage', () => {
+    it('reads memories and totalCount out of the documented shape', () => {
+        const page = parseBrowsePage({ success: true, data: { memories: [{ id: 'a' }], totalCount: 9 } });
+        expect(page.memories).toEqual([{ id: 'a' }]);
+        expect(page.totalCount).toBe(9);
+    });
+    it('omits totalCount when the server does not send one', () => {
+        const page = parseBrowsePage({ data: { memories: [] } });
+        expect(page.totalCount).toBeUndefined();
+    });
+    it('throws rather than silently returning nothing when data is missing', () => {
+        // An empty parse here would be indistinguishable from "no memories" and
+        // would overwrite a good backup with an empty file.
+        expect(() => parseBrowsePage({ success: false, error: { code: 'FORBIDDEN' } })).toThrow(/no .data. object/);
+        expect(() => parseBrowsePage('<html>gateway error</html>')).toThrow(/no .data. object/);
+    });
+    it('throws when memories is not an array or a memory has no id', () => {
+        expect(() => parseBrowsePage({ data: { memories: 'nope' } })).toThrow(/not an array/);
+        expect(() => parseBrowsePage({ data: { memories: [{ content: 'no id' }] } })).toThrow(/string .id./);
+    });
+    it('propagates a rejected read instead of writing an empty backup', async () => {
+        const failing = (async () => new Response(JSON.stringify({ success: false, error: { code: 'FORBIDDEN', message: 'nope' } }), {
+            status: 403,
+        }));
+        await expect(pullMemories({ aisUrl: AIS_URL, agentId: AGENT, apiKey: KEY, fetchImpl: failing })).rejects.toBeInstanceOf(AisHttpError);
+    });
+});
+describe('describePullFailure', () => {
+    it('names the cause for the statuses an operator actually hits', () => {
+        expect(describePullFailure(new AisHttpError(401, '/p', null))).toMatch(/AIS_API_KEY/);
+        expect(describePullFailure(new AisHttpError(403, '/p', null))).toMatch(/own memories/);
+        expect(describePullFailure(new AisHttpError(404, '/p', null))).toMatch(/AIS_AGENT_ID/);
+        expect(describePullFailure(new AisHttpError(500, '/p', null))).toMatch(/HTTP 500/);
+        expect(describePullFailure(new Error('socket hang up'))).toBe('socket hang up');
+    });
+});
+// ---------------------------------------------------------------------------
+// File output
+// ---------------------------------------------------------------------------
+describe('JSON Lines backup file', () => {
+    it('writes one complete JSON object per line, newest first', () => {
+        const memories = makeCorpus(3);
+        const text = toJsonLines(memories);
+        const lines = text.trimEnd().split('\n');
+        expect(lines).toHaveLength(3);
+        expect(text.endsWith('\n')).toBe(true);
+        for (const [i, line] of lines.entries()) {
+            expect(JSON.parse(line)).toEqual(memories[i]);
+        }
+    });
+    it('keeps content with newlines on a single line', () => {
+        const text = toJsonLines([{ id: 'a', content: 'line one\nline two' }]);
+        expect(text.trimEnd().split('\n')).toHaveLength(1);
+        expect(JSON.parse(text.trimEnd())).toEqual({ id: 'a', content: 'line one\nline two' });
+    });
+    it('writes the file and creates missing parent directories', () => {
+        const dir = tempDir();
+        try {
+            const target = join(dir, 'nested', 'deeper', 'backup.jsonl');
+            writeBackupFile(target, toJsonLines(makeCorpus(2)));
+            expect(existsSync(target)).toBe(true);
+            expect(readFileSync(target, 'utf8').trimEnd().split('\n')).toHaveLength(2);
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+    it('replaces an existing backup and leaves no temporary file behind', () => {
+        const dir = tempDir();
+        try {
+            const target = join(dir, 'backup.jsonl');
+            writeFileSync(target, 'stale contents\n');
+            writeBackupFile(target, toJsonLines(makeCorpus(1)));
+            expect(readFileSync(target, 'utf8')).not.toContain('stale');
+            expect(readdirSync(dir)).toEqual(['backup.jsonl']);
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+    it('round-trips a pull to a file that parses back to the same memories', async () => {
+        const dir = tempDir();
+        try {
+            const corpus = makeCorpus(25);
+            const result = await pullMemories({
+                aisUrl: AIS_URL,
+                agentId: AGENT,
+                apiKey: KEY,
+                pageSize: 10,
+                fetchImpl: makeFetch(corpus, []),
+            });
+            const target = join(dir, 'backup.jsonl');
+            writeBackupFile(target, toJsonLines(result.memories));
+            const parsed = readFileSync(target, 'utf8')
+                .trimEnd()
+                .split('\n')
+                .map((line) => JSON.parse(line));
+            expect(parsed).toEqual(corpus);
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    });
+    it('defaults to a per-agent path that is NOT the LocalMirror cache file', () => {
+        const path = defaultBackupPath(AGENT, '/home/someone');
+        expect(path).toBe(`/home/someone/.aismemory/backups/${AGENT}.jsonl`);
+        // LocalMirror owns ~/.aismemory/cache/<agentId>.jsonl, stores a different
+        // shape, and prunes it on a retention window — a backup written there
+        // would be silently deleted.
+        expect(path).not.toContain(`${'.aismemory'}/cache/`);
+    });
+});
+// ---------------------------------------------------------------------------
+// Argument parsing
+// ---------------------------------------------------------------------------
+describe('parseArgs', () => {
+    it('defaults to a quiet-off, full-page pull', () => {
+        expect(parseArgs([])).toEqual({ quiet: false, help: false });
+    });
+    it('reads --out, --page-size and --quiet', () => {
+        expect(parseArgs(['--out', './b.jsonl', '--page-size', '25', '--quiet'])).toEqual({
+            out: './b.jsonl',
+            pageSize: 25,
+            quiet: true,
+            help: false,
+        });
+    });
+    it('accepts --help and -h', () => {
+        expect(parseArgs(['--help']).help).toBe(true);
+        expect(parseArgs(['-h']).help).toBe(true);
+    });
+    it('rejects a page size the server would reject', () => {
+        expect(() => parseArgs(['--page-size', '0'])).toThrow(/between 1 and/);
+        expect(() => parseArgs(['--page-size', '101'])).toThrow(/between 1 and/);
+        expect(() => parseArgs(['--page-size', 'lots'])).toThrow(/between 1 and/);
+    });
+    it('rejects an unknown option rather than ignoring it', () => {
+        expect(() => parseArgs(['--all-agents'])).toThrow(/Unknown option/);
+    });
+});
+//# sourceMappingURL=memory-pull.test.js.map

package/dist/__tests__/memory-pull.test.js.map

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