@namzu/sdk 0.1.8 → 0.2.0

package/dist/session/migration/marker.js

@@ -0,0 +1,111 @@
+/**
+ * Migration marker file I/O — ensures the boot-time v0.2.0 re-layout is
+ * idempotent and race-safe.
+ *
+ * Layout:
+ *   {rootDir}/.migration/v0.2.0       — completion marker (JSON body)
+ *   {rootDir}/.migration/v0.2.0.tmp   — in-flight lock (O_EXCL / `wx` flag)
+ *
+ * Atomicity contract (Convention #8):
+ *  - `writeMarker` goes through write-tmp-rename so readers never see a
+ *    partially serialized body.
+ *  - `acquireMigrationLock` uses the `wx` flag (O_CREAT | O_EXCL) so
+ *    concurrent boots detect each other rather than overwriting. Loser
+ *    cooperates (see filesystem.ts — waits and re-checks the main marker).
+ *  - `readMarker` tolerates missing / corrupt files: missing → null,
+ *    corrupt JSON → null (not throw). The migrator treats either as "run
+ *    again"; a corrupt marker is safer to retry than to honor as valid.
+ */
+import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+/**
+ * Read a marker file. Returns `null` when the file is absent OR when the
+ * contents fail JSON.parse — corruption is treated as "migration did not
+ * complete cleanly", so the caller re-runs rather than honoring stale data.
+ */
+export async function readMarker(path) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf-8');
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT')
+            return null;
+        throw err;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' ||
+        parsed === null ||
+        typeof parsed.version !== 'string' ||
+        typeof parsed.at !== 'string' ||
+        !Array.isArray(parsed.migratedThreads)) {
+        return null;
+    }
+    return {
+        version: parsed.version,
+        at: new Date(parsed.at),
+        migratedThreads: parsed.migratedThreads.map((m) => ({
+            legacyThreadId: m.legacyThreadId,
+            newProjectId: m.newProjectId,
+        })),
+    };
+}
+/**
+ * Write a marker atomically via write-tmp-rename. Parent directory is
+ * created on demand so callers do not have to mkdir separately.
+ */
+export async function writeMarker(path, marker) {
+    await mkdir(dirname(path), { recursive: true });
+    const serialized = {
+        version: marker.version,
+        at: marker.at.toISOString(),
+        migratedThreads: marker.migratedThreads.map((m) => ({
+            legacyThreadId: m.legacyThreadId,
+            newProjectId: m.newProjectId,
+        })),
+    };
+    const tmp = `${path}.write.tmp`;
+    try {
+        await writeFile(tmp, JSON.stringify(serialized, null, 2), 'utf-8');
+        await rename(tmp, path);
+    }
+    catch (err) {
+        await unlink(tmp).catch(() => undefined);
+        throw err;
+    }
+}
+/**
+ * Acquire an exclusive lock by creating `tmpPath` with the `wx` flag.
+ * EEXIST means another process is mid-migration — callers must treat that
+ * as "wait and re-check the main marker" rather than overwriting.
+ *
+ * Returns on success; throws the raw `NodeJS.ErrnoException` on EEXIST or
+ * any other FS failure so the caller can branch on `code`.
+ */
+export async function acquireMigrationLock(tmpPath) {
+    await mkdir(dirname(tmpPath), { recursive: true });
+    await writeFile(tmpPath, JSON.stringify({ at: new Date().toISOString() }), { flag: 'wx' });
+}
+/**
+ * Release the lock. Missing file is tolerated — lock release is idempotent
+ * by design so crashed mid-migrations do not wedge subsequent boots.
+ */
+export async function releaseMigrationLock(tmpPath) {
+    try {
+        await unlink(tmpPath);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT')
+            return;
+        throw err;
+    }
+}
+//# sourceMappingURL=marker.js.map

package/dist/session/migration/marker.js.map

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

package/dist/session/retention/__tests__/archive.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=archive.test.d.ts.map

package/dist/session/retention/__tests__/archive.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.test.d.ts","sourceRoot":"","sources":["../../../../src/session/retention/__tests__/archive.test.ts"],"names":[],"mappings":""}

package/dist/session/retention/__tests__/archive.test.js

@@ -0,0 +1,252 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { GitWorktreeDriver } from '../../../session/workspace/git-worktree.js';
+import { WorkspaceBackendRegistry } from '../../../session/workspace/registry.js';
+import { InMemorySessionStore } from '../../../store/session/memory.js';
+import { createUserMessage } from '../../../types/message/index.js';
+import { ArchivalManager, ArchiveNotConfiguredError, SubSessionNotArchivableError, } from '../archive.js';
+import { DiskArchiveBackend } from '../disk-backend.js';
+const tenantA = 'tnt_alpha';
+function stubLogger() {
+    return {
+        debug: vi.fn(),
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        child() {
+            return stubLogger();
+        },
+    };
+}
+function userActor(tenantId) {
+    return { kind: 'user', userId: 'usr_a', tenantId };
+}
+function agentActor(tenantId) {
+    return { kind: 'agent', agentId: 'agt_a', tenantId };
+}
+async function seedIdleSubSession(store) {
+    const project = await store.createProject({ tenantId: tenantA, name: 'p' }, tenantA);
+    const parent = await store.createSession({ projectId: project.id, currentActor: userActor(tenantA) }, tenantA);
+    const child = await store.createSession({ projectId: project.id, currentActor: agentActor(tenantA) }, tenantA);
+    const sub = await store.createSubSession({
+        parentSessionId: parent.id,
+        childSessionId: child.id,
+        kind: 'agent_spawn',
+        spawnedBy: userActor(tenantA),
+    }, tenantA);
+    // Flip the newly-created sub-session from 'pending' → 'idle' so it's
+    // eligible for archival.
+    await store.updateSubSession({ ...sub, status: 'idle' }, tenantA);
+    return { project, parent, child, sub };
+}
+function buildRegistry() {
+    const exec = async () => ({ stdout: '', stderr: '' });
+    const driver = new GitWorktreeDriver({
+        repoRoot: '/repo',
+        logger: stubLogger(),
+        execFile: exec,
+    });
+    const registry = new WorkspaceBackendRegistry();
+    registry.register(driver);
+    return registry;
+}
+describe('ArchivalManager', () => {
+    let rootDir;
+    let store;
+    let backend;
+    beforeEach(() => {
+        rootDir = mkdtempSync(join(tmpdir(), 'namzu-retention-archive-'));
+        store = new InMemorySessionStore();
+        backend = new DiskArchiveBackend({ rootDir });
+    });
+    afterEach(() => {
+        rmSync(rootDir, { recursive: true, force: true });
+    });
+    it('archive happy path: idle sub-session → tombstone attached, backend called once', async () => {
+        const { sub, child } = await seedIdleSubSession(store);
+        await store.appendMessage(child.id, createUserMessage('hi'), tenantA);
+        const storeSpy = vi.spyOn(backend, 'store');
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: buildRegistry(),
+            archiveBackend: backend,
+        });
+        const tombstone = await manager.archive(sub.id, tenantA);
+        expect(tombstone.subSessionId).toBe(sub.id);
+        expect(tombstone.archiveRef).toMatch(/^arc_/);
+        expect(tombstone.archivedAt).toBeInstanceOf(Date);
+        expect(storeSpy).toHaveBeenCalledTimes(1);
+        const after = await store.getSubSession(sub.id, tenantA);
+        expect(after?.status).toBe('archived');
+        expect(after?.archiveRef).toBe(tombstone.archiveRef);
+        expect(after?.archivedAt).toBeInstanceOf(Date);
+    });
+    it('rejects non-archivable statuses (running/active → not_idle)', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        await store.updateSubSession({ ...sub, status: 'active' }, tenantA);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: buildRegistry(),
+            archiveBackend: backend,
+        });
+        await expect(manager.archive(sub.id, tenantA)).rejects.toBeInstanceOf(SubSessionNotArchivableError);
+    });
+    it('rejects already-archived sub-sessions', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: buildRegistry(),
+            archiveBackend: backend,
+        });
+        await manager.archive(sub.id, tenantA);
+        await expect(manager.archive(sub.id, tenantA)).rejects.toMatchObject({
+            name: 'SubSessionNotArchivableError',
+            details: { reason: 'already_archived' },
+        });
+    });
+    it('rejects missing sub-sessions', async () => {
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: buildRegistry(),
+            archiveBackend: backend,
+        });
+        await expect(manager.archive('sub_missing', tenantA)).rejects.toMatchObject({ name: 'SubSessionNotArchivableError', details: { reason: 'missing' } });
+    });
+    it('deny-by-default: backend absent → ArchiveNotConfiguredError', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: buildRegistry(),
+            // archiveBackend intentionally omitted.
+        });
+        await expect(manager.archive(sub.id, tenantA)).rejects.toBeInstanceOf(ArchiveNotConfiguredError);
+    });
+    it('restore reads tombstone, invokes backend.restore, flips status back to idle', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: buildRegistry(),
+            archiveBackend: backend,
+        });
+        await manager.archive(sub.id, tenantA);
+        const restoreSpy = vi.spyOn(backend, 'restore');
+        await manager.restore(sub.id, tenantA);
+        expect(restoreSpy).toHaveBeenCalledTimes(1);
+        const after = await store.getSubSession(sub.id, tenantA);
+        expect(after?.status).toBe('idle');
+        expect(after?.archiveRef).toBeUndefined();
+        expect(after?.archivedAt).toBeUndefined();
+    });
+    it('tombstone is navigable via drill post-archive with status=archived + archiveRef', async () => {
+        const { parent, sub } = await seedIdleSubSession(store);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: buildRegistry(),
+            archiveBackend: backend,
+        });
+        const tombstone = await manager.archive(sub.id, tenantA);
+        const view = await store.drill(parent.id, tenantA);
+        expect(view).not.toBeNull();
+        expect(view?.children).toHaveLength(1);
+        const child = view?.children[0];
+        expect(child?.id).toBe(sub.id);
+        expect(child?.status).toBe('archived');
+        expect(child?.archiveRef).toBe(tombstone.archiveRef);
+        expect(child?.archivedAt).toBeInstanceOf(Date);
+    });
+    it('workspace disposal failures do not unwind the committed archive', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        // Registry with a driver whose `dispose` always throws.
+        const registry = new WorkspaceBackendRegistry();
+        registry.register({
+            kind: 'git-worktree',
+            async create() {
+                return {
+                    id: 'wsp_x',
+                    meta: {
+                        backend: 'git-worktree',
+                        repoRoot: '/r',
+                        branch: 'main',
+                        worktreePath: '/r/x',
+                    },
+                    createdAt: new Date(),
+                };
+            },
+            async branch(ref) {
+                return ref;
+            },
+            async dispose() {
+                throw new Error('dispose boom');
+            },
+            async inspect() {
+                return { exists: true, currentRef: 'HEAD', isDirty: false };
+            },
+        });
+        const workspaceRef = {
+            id: 'wsp_y',
+            meta: { backend: 'git-worktree', repoRoot: '/r', branch: 'main', worktreePath: '/r/y' },
+            createdAt: new Date(),
+        };
+        // Seed the sub-session with a workspaceId and a resolver that returns
+        // the live ref.
+        await store.updateSubSession({ ...sub, status: 'idle', workspaceId: workspaceRef.id }, tenantA);
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: registry,
+            archiveBackend: backend,
+            workspaceResolver: async () => workspaceRef,
+        });
+        // Archive must complete even though dispose throws internally.
+        const tombstone = await manager.archive(sub.id, tenantA);
+        expect(tombstone.archiveRef).toMatch(/^arc_/);
+        const after = await store.getSubSession(sub.id, tenantA);
+        expect(after?.status).toBe('archived');
+    });
+    it('SessionMessage round-trip: archive preserves original MessageId + timestamps', async () => {
+        // Phase 9 Known Delta #7: ArchivalManager now uses
+        // SessionStore.loadSessionMessages for full-fidelity archival (no more
+        // synthetic `msg_restored_N` IDs).
+        const { sub, child } = await seedIdleSubSession(store);
+        const id1 = await store.appendMessage(child.id, createUserMessage('m1'), tenantA);
+        const id2 = await store.appendMessage(child.id, createUserMessage('m2'), tenantA);
+        const captured = [];
+        const capturingBackend = Object.assign(new DiskArchiveBackend({ rootDir }), {
+            store: vi.fn(async (bundle) => {
+                captured.push(bundle);
+                return {
+                    archiveRef: 'arc_test_ref',
+                    archivedAt: new Date(),
+                };
+            }),
+        });
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: buildRegistry(),
+            archiveBackend: capturingBackend,
+        });
+        await manager.archive(sub.id, tenantA);
+        expect(captured).toHaveLength(1);
+        const bundle = captured[0];
+        expect(bundle.messages).toHaveLength(2);
+        expect(bundle.messages[0]?.id).toBe(id1);
+        expect(bundle.messages[1]?.id).toBe(id2);
+        expect(bundle.messages[0]?.id).not.toMatch(/^msg_restored_/);
+        expect(bundle.messages[0]?.at).toBeInstanceOf(Date);
+    });
+    it('onArchived callback fires exactly once on success with the tombstone', async () => {
+        const { sub } = await seedIdleSubSession(store);
+        const onArchived = vi.fn();
+        const manager = new ArchivalManager({
+            sessionStore: store,
+            workspaceRegistry: buildRegistry(),
+            archiveBackend: backend,
+            onArchived,
+        });
+        const tombstone = await manager.archive(sub.id, tenantA);
+        expect(onArchived).toHaveBeenCalledTimes(1);
+        expect(onArchived).toHaveBeenCalledWith(tombstone);
+    });
+});
+//# sourceMappingURL=archive.test.js.map

package/dist/session/retention/__tests__/archive.test.js.map

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

package/dist/session/retention/__tests__/disk-backend.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=disk-backend.test.d.ts.map

package/dist/session/retention/__tests__/disk-backend.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-backend.test.d.ts","sourceRoot":"","sources":["../../../../src/session/retention/__tests__/disk-backend.test.ts"],"names":[],"mappings":""}

package/dist/session/retention/__tests__/disk-backend.test.js

@@ -0,0 +1,154 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { readFile, readdir } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { createUserMessage } from '../../../types/message/index.js';
+import { DiskArchiveBackend } from '../disk-backend.js';
+const tenantA = 'tnt_alpha';
+function fakeSessionId() {
+    return 'ses_fake_1';
+}
+function fakeSubSessionId() {
+    return 'sub_fake_1';
+}
+function buildMessages(sessionId) {
+    return [
+        {
+            id: 'msg_1',
+            sessionId,
+            tenantId: tenantA,
+            message: createUserMessage('hello'),
+            at: new Date('2026-04-01T00:00:00Z'),
+        },
+        {
+            id: 'msg_2',
+            sessionId,
+            tenantId: tenantA,
+            message: createUserMessage('world'),
+            at: new Date('2026-04-01T00:01:00Z'),
+        },
+    ];
+}
+function buildSummary(sessionId) {
+    return {
+        id: 'sum_disk_archive_1',
+        sessionRef: sessionId,
+        tenantId: tenantA,
+        outcome: { status: 'succeeded' },
+        deliverables: [],
+        agentSummary: 'done',
+        keyDecisions: [{ at: new Date('2026-04-01T00:00:30Z'), summary: 'decided x' }],
+        at: new Date('2026-04-01T00:02:00Z'),
+        materializedBy: 'kernel',
+    };
+}
+function buildWorkspace() {
+    return {
+        id: 'wsp_archive_1',
+        meta: {
+            backend: 'git-worktree',
+            repoRoot: '/repo',
+            branch: 'feature/x',
+            worktreePath: '/repo/worktrees/x',
+        },
+        createdAt: new Date('2026-04-01T00:00:00Z'),
+    };
+}
+describe('DiskArchiveBackend', () => {
+    let rootDir;
+    let backend;
+    beforeEach(() => {
+        rootDir = mkdtempSync(join(tmpdir(), 'namzu-archive-disk-'));
+        backend = new DiskArchiveBackend({ rootDir });
+    });
+    afterEach(() => {
+        rmSync(rootDir, { recursive: true, force: true });
+    });
+    it('store + restore round-trip preserves summary, messages, and subsession metadata', async () => {
+        const sessionId = fakeSessionId();
+        const subSessionId = fakeSubSessionId();
+        const messages = buildMessages(sessionId);
+        const summaryRef = buildSummary(sessionId);
+        const workspace = buildWorkspace();
+        const out = await backend.store({
+            subSessionId,
+            sessionId,
+            tenantId: tenantA,
+            workspace,
+            summaryRef,
+            messages,
+        });
+        expect(out.archiveRef).toMatch(/^arc_/);
+        expect(out.archivedAt).toBeInstanceOf(Date);
+        const restored = await backend.restore(out.archiveRef);
+        expect(restored.subSessionId).toBe(subSessionId);
+        expect(restored.sessionId).toBe(sessionId);
+        expect(restored.tenantId).toBe(tenantA);
+        expect(restored.workspace?.id).toBe(workspace.id);
+        expect(restored.summaryRef?.id).toBe(summaryRef.id);
+        expect(restored.summaryRef?.at).toBeInstanceOf(Date);
+        expect(restored.messages).toHaveLength(2);
+        expect(restored.messages[0]?.at).toBeInstanceOf(Date);
+    });
+    it('archive location is under {rootDir}/archive/{arc_*}/', async () => {
+        const out = await backend.store({
+            subSessionId: fakeSubSessionId(),
+            sessionId: fakeSessionId(),
+            tenantId: tenantA,
+            messages: [],
+        });
+        const archivesRoot = join(rootDir, 'archive');
+        const entries = await readdir(archivesRoot);
+        expect(entries).toContain(out.archiveRef);
+    });
+    it('writes the archive.json marker last (atomic via tmp-rename; no stray .tmp after)', async () => {
+        const out = await backend.store({
+            subSessionId: fakeSubSessionId(),
+            sessionId: fakeSessionId(),
+            tenantId: tenantA,
+            messages: buildMessages(fakeSessionId()),
+        });
+        const dir = join(rootDir, 'archive', out.archiveRef);
+        const entries = await readdir(dir);
+        expect(entries).toContain('archive.json');
+        expect(entries).toContain('subsession.json');
+        expect(entries).toContain('messages.jsonl');
+        // No lingering .tmp files from the write-tmp-rename sequence.
+        expect(entries.some((e) => e.endsWith('.tmp'))).toBe(false);
+        const marker = JSON.parse(await readFile(join(dir, 'archive.json'), 'utf-8'));
+        expect(marker.archiveRef).toBe(out.archiveRef);
+    });
+    it('restore on missing archive throws ArchiveNotFoundError (reason: missing)', async () => {
+        await expect(backend.restore('arc_nonexistent')).rejects.toMatchObject({
+            name: 'ArchiveNotFoundError',
+            details: { reason: 'missing' },
+        });
+    });
+    it('multiple archives receive unique refs (no collisions)', async () => {
+        const refs = new Set();
+        for (let i = 0; i < 5; i++) {
+            const out = await backend.store({
+                subSessionId: fakeSubSessionId(),
+                sessionId: fakeSessionId(),
+                tenantId: tenantA,
+                messages: [],
+            });
+            refs.add(out.archiveRef);
+        }
+        expect(refs.size).toBe(5);
+    });
+    it('store without optional fields (no workspace, no summary, no messages) still round-trips', async () => {
+        const out = await backend.store({
+            subSessionId: fakeSubSessionId(),
+            sessionId: fakeSessionId(),
+            tenantId: tenantA,
+            messages: [],
+        });
+        const restored = await backend.restore(out.archiveRef);
+        expect(restored.workspace).toBeUndefined();
+        expect(restored.summaryRef).toBeUndefined();
+        expect(restored.messages).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=disk-backend.test.js.map

package/dist/session/retention/__tests__/disk-backend.test.js.map

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

package/dist/session/retention/archive-backend-ref.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Branded lookup identifier for an archived sub-session in a pluggable
+ * {@link ArchiveBackend}. Produced by
+ * {@link ArchiveBackend.store} on a successful archival write and consumed by
+ * {@link ArchiveBackend.restore} to re-hydrate the bundle.
+ *
+ * Follows Convention #2 (`<prefix>_<opaque>` template literal brand). Prefix
+ * chosen as `arc_` to match the `archive` domain — short, unambiguous, and
+ * distinct from every existing prefix (`prj_`, `ses_`, `sub_`, `sum_`, …).
+ *
+ * The string after the prefix is opaque — backend-specific. A disk backend
+ * embeds it in a directory path; an object-store backend may encode a key;
+ * callers MUST NOT parse or pattern-match beyond the brand check.
+ *
+ * See session-hierarchy.md §12.3 Retention and Archival.
+ */
+export type ArchiveBackendRef = `arc_${string}`;
+//# sourceMappingURL=archive-backend-ref.d.ts.map

package/dist/session/retention/archive-backend-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-backend-ref.d.ts","sourceRoot":"","sources":["../../../src/session/retention/archive-backend-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,MAAM,EAAE,CAAA"}

package/dist/session/retention/archive-backend-ref.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=archive-backend-ref.js.map

package/dist/session/retention/archive-backend-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-backend-ref.js","sourceRoot":"","sources":["../../../src/session/retention/archive-backend-ref.ts"],"names":[],"mappings":""}