@namzu/sdk 0.1.8 → 0.3.0

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

@@ -0,0 +1,236 @@
+/**
+ * DiskArchiveBackend — reference filesystem-backed {@link ArchiveBackend}.
+ *
+ * Convention #8 (atomic writes): every file lands via write-tmp-rename; the
+ * final `archive.json` marker is written LAST so a crash mid-bundle leaves
+ * the directory visible but UN-marked, and `restore` treats such a bundle
+ * as missing. This mirrors the Phase 5 materializer's "marker-last"
+ * invariant.
+ *
+ * Layout:
+ *
+ *   {rootDir}/archive/{arc_<opaque>}/
+ *     subsession.json        # Identity + metadata
+ *     summary.json            # SessionSummaryRef (optional — present iff input.summaryRef)
+ *     messages.jsonl          # One SessionMessage per line (append-style, serialized once)
+ *     workspace.json          # WorkspaceRef (optional — present iff input.workspace)
+ *     archive.json            # Marker — final write; presence = bundle committed
+ *
+ * Workspace directory contents are NOT archived — we persist the
+ * {@link WorkspaceRef} only. The pattern doc §12.3 explicitly allows this:
+ * the ref is the re-hydration handle; the worktree itself is disposed at
+ * archive time via the caller's {@link WorkspaceBackendDriver}, not copied
+ * into the archive bundle. This is a Phase 8 interpretation — see the
+ * roadmap deliverable report for rationale (tar bundling deferred).
+ *
+ * See session-hierarchy.md §12.3.
+ */
+import { randomBytes } from 'node:crypto';
+import { mkdir, readFile, readdir, rename, unlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Raised when {@link DiskArchiveBackend.restore} cannot resolve the supplied
+ * ref — either the directory is missing, or the `archive.json` marker is
+ * absent (crash-mid-write signal).
+ */
+export class ArchiveNotFoundError extends Error {
+    details;
+    constructor(details) {
+        super(`Archive ${details.archiveRef} could not be resolved: ${details.reason}`);
+        this.name = 'ArchiveNotFoundError';
+        this.details = details;
+    }
+}
+export class DiskArchiveBackend {
+    kind = 'disk';
+    rootDir;
+    constructor(config) {
+        this.rootDir = config.rootDir;
+    }
+    async store(input) {
+        const archiveRef = generateArchiveBackendRef();
+        const archivedAt = new Date();
+        const dir = join(this.rootDir, 'archive', archiveRef);
+        await mkdir(dir, { recursive: true });
+        // 1. Sub-session identity.
+        const subEntry = {
+            subSessionId: input.subSessionId,
+            sessionId: input.sessionId,
+            tenantId: input.tenantId,
+        };
+        await atomicWriteJson(join(dir, 'subsession.json'), subEntry);
+        // 2. Summary (optional).
+        if (input.summaryRef) {
+            const entry = { summary: serializeSummaryFields(input.summaryRef) };
+            await atomicWriteJson(join(dir, 'summary.json'), entry);
+        }
+        // 3. Workspace ref (optional).
+        if (input.workspace) {
+            const entry = {
+                workspace: serializeWorkspaceFields(input.workspace),
+            };
+            await atomicWriteJson(join(dir, 'workspace.json'), entry);
+        }
+        // 4. Messages — one JSON per line, serialized once with an atomic
+        //    tmp-rename. No append I/O: we have the full bundle upfront, and
+        //    single-write is atomic at the file level.
+        const lines = input.messages.map((m) => {
+            const line = {
+                id: m.id,
+                sessionId: m.sessionId,
+                tenantId: m.tenantId,
+                message: m.message,
+                at: m.at.toISOString(),
+            };
+            return JSON.stringify(line);
+        });
+        const body = lines.length > 0 ? `${lines.join('\n')}\n` : '';
+        await atomicWriteText(join(dir, 'messages.jsonl'), body);
+        // 5. Marker — ALWAYS last. Presence = bundle committed.
+        const marker = {
+            archiveRef,
+            archivedAt: archivedAt.toISOString(),
+        };
+        await atomicWriteJson(join(dir, 'archive.json'), marker);
+        return { archiveRef, archivedAt };
+    }
+    async restore(archiveRef) {
+        const dir = join(this.rootDir, 'archive', archiveRef);
+        // Directory must exist.
+        try {
+            await readdir(dir);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'ENOENT') {
+                throw new ArchiveNotFoundError({ archiveRef, reason: 'missing' });
+            }
+            throw err;
+        }
+        // Marker must exist — absence = crash-mid-write.
+        const marker = await readJson(join(dir, 'archive.json'));
+        if (!marker) {
+            throw new ArchiveNotFoundError({ archiveRef, reason: 'incomplete' });
+        }
+        const subEntry = await readJson(join(dir, 'subsession.json'));
+        if (!subEntry) {
+            throw new ArchiveNotFoundError({ archiveRef, reason: 'incomplete' });
+        }
+        const summaryEntry = await readJson(join(dir, 'summary.json'));
+        const summaryRef = summaryEntry ? deserializeSummaryFields(summaryEntry.summary) : undefined;
+        const workspaceEntry = await readJson(join(dir, 'workspace.json'));
+        const workspace = workspaceEntry
+            ? deserializeWorkspaceFields(workspaceEntry.workspace)
+            : undefined;
+        const messagesRaw = await readText(join(dir, 'messages.jsonl'));
+        const messages = messagesRaw === null
+            ? []
+            : messagesRaw
+                .split('\n')
+                .filter((l) => l.length > 0)
+                .map((l) => {
+                const raw = JSON.parse(l);
+                return {
+                    id: raw.id,
+                    sessionId: raw.sessionId,
+                    tenantId: raw.tenantId,
+                    message: raw.message,
+                    at: new Date(raw.at),
+                };
+            });
+        return {
+            subSessionId: subEntry.subSessionId,
+            sessionId: subEntry.sessionId,
+            tenantId: subEntry.tenantId,
+            ...(workspace !== undefined && { workspace }),
+            ...(summaryRef !== undefined && { summaryRef }),
+            messages,
+        };
+    }
+}
+// Serialization helpers ------------------------------------------------------
+function serializeSummaryFields(s) {
+    // Dates survive JSON round-trip as strings; we let JSON.stringify handle
+    // the normal `toJSON` path but store them as ISO strings on the wire.
+    // On deserialize we coerce back. The in-memory record stays immutable.
+    return s;
+}
+function deserializeSummaryFields(s) {
+    // JSON revives Dates as strings — resurrect them.
+    const at = s.at instanceof Date ? s.at : new Date(s.at);
+    const keyDecisions = s.keyDecisions.map((k) => ({
+        at: k.at instanceof Date ? k.at : new Date(k.at),
+        summary: k.summary,
+    }));
+    return { ...s, at, keyDecisions };
+}
+function serializeWorkspaceFields(w) {
+    return w;
+}
+function deserializeWorkspaceFields(w) {
+    const createdAt = w.createdAt instanceof Date ? w.createdAt : new Date(w.createdAt);
+    return { ...w, createdAt };
+}
+// ID generation --------------------------------------------------------------
+const ALPHABET = '0123456789abcdefghijklmnopqrstuvwxyz';
+const MAX_UNIFORM_BYTE = Math.floor(256 / ALPHABET.length) * ALPHABET.length;
+/**
+ * Mints an {@link ArchiveBackendRef}. Local helper rather than a `utils/id`
+ * export because the ref's uniqueness + prefix is an archive-backend concern
+ * — other backends may mint refs very differently (e.g. S3 keys).
+ */
+function generateArchiveBackendRef(length = 12) {
+    let suffix = '';
+    let remaining = length;
+    while (remaining > 0) {
+        const bytes = randomBytes(remaining + 8);
+        for (const byte of bytes) {
+            if (remaining <= 0)
+                break;
+            if (byte < MAX_UNIFORM_BYTE) {
+                suffix += ALPHABET[byte % ALPHABET.length];
+                remaining--;
+            }
+        }
+    }
+    return `arc_${suffix}`;
+}
+// FS helpers -----------------------------------------------------------------
+async function atomicWriteJson(filePath, value) {
+    await atomicWriteText(filePath, JSON.stringify(value, null, 2));
+}
+async function atomicWriteText(filePath, body) {
+    const tempPath = `${filePath}.tmp`;
+    try {
+        await writeFile(tempPath, body, 'utf-8');
+        await rename(tempPath, filePath);
+    }
+    catch (err) {
+        await unlink(tempPath).catch(() => undefined);
+        throw err;
+    }
+}
+async function readJson(path) {
+    try {
+        const raw = await readFile(path, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+async function readText(path) {
+    try {
+        return await readFile(path, 'utf-8');
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+//# sourceMappingURL=disk-backend.js.map

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

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

package/dist/session/retention/index.d.ts

@@ -0,0 +1,9 @@
+export type { ArchiveBackendRef } from './archive-backend-ref.js';
+export type { RetentionPolicy } from './policy.js';
+export { RETENTION_POLICY_DISABLED } from './policy.js';
+export type { ArchiveBackend, ArchiveInput, ArchiveOutput, SubSessionTombstone } from './backend.js';
+export { ArchivalManager, ArchiveNotConfiguredError, SubSessionNotArchivableError, SubSessionNotArchivedError, } from './archive.js';
+export type { ArchivalManagerDeps, WorkspaceResolver } from './archive.js';
+export { ArchiveNotFoundError, DiskArchiveBackend } from './disk-backend.js';
+export type { DiskArchiveBackendConfig } from './disk-backend.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/session/retention/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/session/retention/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACvD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACpG,OAAO,EACN,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,GAC1B,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC5E,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/session/retention/index.js

@@ -0,0 +1,6 @@
+// Sub-barrel for the retention/archival module (Convention #4).
+// Concrete types + manager live in sibling files.
+export { RETENTION_POLICY_DISABLED } from './policy.js';
+export { ArchivalManager, ArchiveNotConfiguredError, SubSessionNotArchivableError, SubSessionNotArchivedError, } from './archive.js';
+export { ArchiveNotFoundError, DiskArchiveBackend } from './disk-backend.js';
+//# sourceMappingURL=index.js.map

package/dist/session/retention/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/session/retention/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,kDAAkD;AAIlD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,EACN,eAAe,EACf,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,GAC1B,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/session/retention/policy.d.ts

@@ -0,0 +1,49 @@
+/**
+ * RetentionPolicy — per-project configuration for sub-session retention and
+ * archival. See session-hierarchy.md §12.3.
+ *
+ * Deny-by-default (Convention #5): the absence of any field means "no
+ * automatic archival." A policy without an `archiveBackend` cannot drive
+ * archival at all — {@link ArchivalManager.archive} rejects with
+ * {@link ArchiveNotConfiguredError}. The primitive Phase 8 ships is
+ * on-demand `archive(subSessionId)`; a scheduler that invokes the primitive
+ * is platform-layer (out of SDK scope per the roadmap "What's OUT" list).
+ *
+ * Phase 8 replaces the Phase 1 `RetentionPolicyRef = unknown` placeholder at
+ * `session/hierarchy/project.ts` with this real type.
+ */
+import type { ArchiveBackendRef } from './archive-backend-ref.js';
+/**
+ * Retention policy. Every field is optional (deny-by-default): no policy, no
+ * archival. See pattern doc §12.3 for rationale.
+ */
+export interface RetentionPolicy {
+    /**
+     * Idle sub-sessions older than this are eligible for archival. Expressed in
+     * milliseconds to stay dependency-free — no `Duration` type in the kernel
+     * today. Absent field = no TTL (eligibility never triggers on age alone).
+     */
+    readonly idleSubSessionTTL?: number;
+    /**
+     * Hard cap on sub-sessions per project. When exceeded, the oldest-idle
+     * sub-sessions become archival-eligible. Absent = no cap.
+     *
+     * Note: enforcement of this cap is platform-layer (scheduler territory).
+     * The SDK primitive `archive()` takes an explicit {@link SubSessionId} —
+     * it does not walk the project tree.
+     */
+    readonly maxSubSessionsPerProject?: number;
+    /**
+     * Ref for the backing {@link ArchiveBackend}. Absent = archival disabled
+     * even if TTL/cap are set — {@link ArchivalManager.archive} rejects with
+     * {@link ArchiveNotConfiguredError}. This is the deny-by-default gate.
+     */
+    readonly archiveBackend?: ArchiveBackendRef;
+}
+/**
+ * The empty retention policy — archival fully disabled. Exported as a named
+ * constant so call sites declare their deny-by-default posture explicitly
+ * rather than relying on `{}` literals (Convention #0, #5).
+ */
+export declare const RETENTION_POLICY_DISABLED: RetentionPolicy;
+//# sourceMappingURL=policy.d.ts.map

package/dist/session/retention/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/session/retention/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAEjE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAEnC;;;;;;;OAOG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,iBAAiB,CAAA;CAC3C;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,eAAmC,CAAA"}

package/dist/session/retention/policy.js

@@ -0,0 +1,21 @@
+/**
+ * RetentionPolicy — per-project configuration for sub-session retention and
+ * archival. See session-hierarchy.md §12.3.
+ *
+ * Deny-by-default (Convention #5): the absence of any field means "no
+ * automatic archival." A policy without an `archiveBackend` cannot drive
+ * archival at all — {@link ArchivalManager.archive} rejects with
+ * {@link ArchiveNotConfiguredError}. The primitive Phase 8 ships is
+ * on-demand `archive(subSessionId)`; a scheduler that invokes the primitive
+ * is platform-layer (out of SDK scope per the roadmap "What's OUT" list).
+ *
+ * Phase 8 replaces the Phase 1 `RetentionPolicyRef = unknown` placeholder at
+ * `session/hierarchy/project.ts` with this real type.
+ */
+/**
+ * The empty retention policy — archival fully disabled. Exported as a named
+ * constant so call sites declare their deny-by-default posture explicitly
+ * rather than relying on `{}` literals (Convention #0, #5).
+ */
+export const RETENTION_POLICY_DISABLED = Object.freeze({});
+//# sourceMappingURL=policy.js.map

package/dist/session/retention/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/session/retention/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAkCH;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA"}

package/dist/session/summary/__tests__/materialize.test.d.ts

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

package/dist/session/summary/__tests__/materialize.test.d.ts.map

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

package/dist/session/summary/__tests__/materialize.test.js

@@ -0,0 +1,270 @@
+import { describe, expect, it } from 'vitest';
+import { TenantIsolationError } from '../../../session/errors.js';
+import { InMemorySessionStore } from '../../../store/session/memory.js';
+import { SessionSummaryMaterializer } from '../materialize.js';
+import { AGENT_SUMMARY_MAX_CHARS, AgentSummaryTooLongError, SessionAlreadySummarizedError, } from '../ref.js';
+const TEST_THREAD_ID = 'thd_test';
+const tenantA = 'tnt_alpha';
+const tenantB = 'tnt_beta';
+function userActor(tenantId) {
+    return { kind: 'user', userId: 'usr_a', tenantId };
+}
+function agentActor(tenantId) {
+    return { kind: 'agent', agentId: 'agt_a', tenantId };
+}
+function makeSummaryIdGenerator() {
+    let n = 0;
+    return () => `sum_test_${++n}`;
+}
+async function seedActiveSession(store, tenantId) {
+    const project = await store.createProject({ tenantId, name: 'p1' }, tenantId);
+    const session = await store.createSession({ threadId: TEST_THREAD_ID, projectId: project.id, currentActor: agentActor(tenantId) }, tenantId);
+    // Put the session into `active` so the materializer's status-flip behavior
+    // is observable.
+    await store.updateSession({ ...session, status: 'active' }, tenantId);
+    return { project, session: { ...session, status: 'active' } };
+}
+function buildMaterializer(store) {
+    return new SessionSummaryMaterializer({
+        store,
+        generateSummaryId: makeSummaryIdGenerator(),
+        now: () => new Date('2026-04-17T00:00:00Z'),
+    });
+}
+describe('SessionSummaryMaterializer.materialize', () => {
+    it('materializes on an active session and flips status to idle', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const materializer = buildMaterializer(store);
+        const summary = await materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded', verdict: 'done' },
+            agentSummary: 'Completed task X.',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        });
+        expect(summary.id).toBe('sum_test_1');
+        expect(summary.sessionRef).toBe(session.id);
+        expect(summary.materializedBy).toBe('kernel');
+        const stored = await store.getSummary(session.id, tenantA);
+        expect(stored?.id).toBe(summary.id);
+        const reloaded = await store.getSession(session.id, tenantA);
+        expect(reloaded?.status).toBe('idle');
+    });
+    it('rejects an agentSummary exceeding AGENT_SUMMARY_MAX_CHARS', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const materializer = buildMaterializer(store);
+        await expect(materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: 'x'.repeat(AGENT_SUMMARY_MAX_CHARS + 1),
+            declaredDeliverables: [],
+            keyDecisions: [],
+        })).rejects.toBeInstanceOf(AgentSummaryTooLongError);
+    });
+    it('rejects re-materialization when a summary already exists', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const materializer = buildMaterializer(store);
+        await materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: 'first',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        });
+        await expect(materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: 'second',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        })).rejects.toBeInstanceOf(SessionAlreadySummarizedError);
+    });
+    it('rejects cross-tenant materialize with TenantIsolationError', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const materializer = buildMaterializer(store);
+        await expect(materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantB,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: 'x',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        })).rejects.toBeInstanceOf(TenantIsolationError);
+    });
+    it('preserves declaredDeliverables verbatim in the emitted ref', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const materializer = buildMaterializer(store);
+        const deliverables = [
+            {
+                id: 'del_a',
+                kind: 'file',
+                path: 'src/foo.ts',
+                contentHash: 'abc123',
+                sizeBytes: 42,
+            },
+            {
+                id: 'del_b',
+                kind: 'artifact_blob',
+                storageRef: 'blob://x',
+                mediaType: 'application/json',
+            },
+        ];
+        const summary = await materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'partial' },
+            agentSummary: '',
+            declaredDeliverables: deliverables,
+            keyDecisions: [],
+        });
+        expect(summary.deliverables).toEqual(deliverables);
+    });
+    it('preserves keyDecisions verbatim in the emitted ref', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const materializer = buildMaterializer(store);
+        const decisions = [
+            { at: new Date('2026-04-17T01:00:00Z'), summary: 'plan approved' },
+            { at: new Date('2026-04-17T02:00:00Z'), summary: 'hitl granted' },
+        ];
+        const summary = await materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: '',
+            declaredDeliverables: [],
+            keyDecisions: decisions,
+        });
+        expect(summary.keyDecisions).toEqual(decisions);
+    });
+    it('constructs SummaryId via the injected generator', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const gen = makeSummaryIdGenerator();
+        const materializer = new SessionSummaryMaterializer({
+            store,
+            generateSummaryId: gen,
+        });
+        const summary = await materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: '',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        });
+        expect(summary.id).toBe('sum_test_1');
+    });
+    it('always sets materializedBy to "kernel"', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const materializer = buildMaterializer(store);
+        const summary = await materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: '',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        });
+        expect(summary.materializedBy).toBe('kernel');
+    });
+    it('leaves already-idle sessions in idle (no spurious flip)', async () => {
+        const store = new InMemorySessionStore();
+        const project = await store.createProject({ tenantId: tenantA, name: 'p1' }, tenantA);
+        const session = await store.createSession({ threadId: TEST_THREAD_ID, projectId: project.id, currentActor: userActor(tenantA) }, tenantA);
+        // session.status defaults to 'idle'
+        const materializer = buildMaterializer(store);
+        await materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: '',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        });
+        const reloaded = await store.getSession(session.id, tenantA);
+        expect(reloaded?.status).toBe('idle');
+    });
+    it('leaves failed sessions in failed (materialize does not resurrect)', async () => {
+        const store = new InMemorySessionStore();
+        const project = await store.createProject({ tenantId: tenantA, name: 'p1' }, tenantA);
+        const session = await store.createSession({ threadId: TEST_THREAD_ID, projectId: project.id, currentActor: agentActor(tenantA) }, tenantA);
+        await store.updateSession({ ...session, status: 'failed' }, tenantA);
+        const materializer = buildMaterializer(store);
+        await materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'failed', verdict: 'gave up' },
+            agentSummary: '',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        });
+        const reloaded = await store.getSession(session.id, tenantA);
+        expect(reloaded?.status).toBe('failed');
+    });
+});
+describe('SessionSummaryMaterializer.recover', () => {
+    it('returns null when no summary file exists (no side effect)', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const materializer = buildMaterializer(store);
+        const recovered = await materializer.recover(session.id, tenantA);
+        expect(recovered).toBeNull();
+        const reloaded = await store.getSession(session.id, tenantA);
+        // No side effect — still active.
+        expect(reloaded?.status).toBe('active');
+    });
+    it('flips dangling session status idempotently when summary is present', async () => {
+        const store = new InMemorySessionStore();
+        const { session } = await seedActiveSession(store, tenantA);
+        const materializer = buildMaterializer(store);
+        // Simulate mid-crash: write summary directly, then force session back to
+        // active (mimicking a process death between the two atomic writes).
+        await materializer.materialize({
+            sessionId: session.id,
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: '',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        });
+        const mid = await store.getSession(session.id, tenantA);
+        if (!mid)
+            throw new Error('seed mid session missing');
+        await store.updateSession({ ...mid, status: 'active' }, tenantA);
+        const recovered = await materializer.recover(session.id, tenantA);
+        expect(recovered).not.toBeNull();
+        const reloaded = await store.getSession(session.id, tenantA);
+        expect(reloaded?.status).toBe('idle');
+        // Idempotent: calling recover again with session already idle is a no-op.
+        const recovered2 = await materializer.recover(session.id, tenantA);
+        expect(recovered2?.id).toBe(recovered?.id);
+        const reloaded2 = await store.getSession(session.id, tenantA);
+        expect(reloaded2?.status).toBe('idle');
+    });
+});
+describe('SessionSummaryMaterializer missing session', () => {
+    it('throws when the session does not exist', async () => {
+        const store = new InMemorySessionStore();
+        const materializer = buildMaterializer(store);
+        await expect(materializer.materialize({
+            sessionId: 'ses_missing',
+            tenantId: tenantA,
+            finalOutcome: { status: 'succeeded' },
+            agentSummary: '',
+            declaredDeliverables: [],
+            keyDecisions: [],
+        })).rejects.toThrow(/not found/);
+    });
+});
+//# sourceMappingURL=materialize.test.js.map

package/dist/session/summary/__tests__/materialize.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.test.js","sourceRoot":"","sources":["../../../../src/session/summary/__tests__/materialize.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAIvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EACN,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,GAC7B,MAAM,WAAW,CAAA;AAElB,MAAM,cAAc,GAAG,UAAsB,CAAA;AAE7C,MAAM,OAAO,GAAG,WAAuB,CAAA;AACvC,MAAM,OAAO,GAAG,UAAsB,CAAA;AAEtC,SAAS,SAAS,CAAC,QAAkB;IACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAiB,EAAE,QAAQ,EAAE,CAAA;AAC7D,CAAC;AAED,SAAS,UAAU,CAAC,QAAkB;IACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAkB,EAAE,QAAQ,EAAE,CAAA;AAChE,CAAC;AAED,SAAS,sBAAsB;IAC9B,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,GAAc,EAAE,CAAC,YAAY,EAAE,CAAC,EAAe,CAAA;AACvD,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,KAA2B,EAAE,QAAkB;IAC/E,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAA;IAC7E,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CACxC,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,EACvF,QAAQ,CACR,CAAA;IACD,2EAA2E;IAC3E,iBAAiB;IACjB,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAA;IACrE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,QAAiB,EAAE,EAAE,CAAA;AACvE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA2B;IACrD,OAAO,IAAI,0BAA0B,CAAC;QACrC,KAAK;QACL,iBAAiB,EAAE,sBAAsB,EAAE;QAC3C,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,sBAAsB,CAAC;KAC3C,CAAC,CAAA;AACH,CAAC;AAED,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;YAC9C,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE;YACtD,YAAY,EAAE,mBAAmB;YACjC,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC3C,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAE7C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC1D,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAEnC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC5D,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,MAAM,CACX,YAAY,CAAC,WAAW,CAAC;YACxB,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,uBAAuB,GAAG,CAAC,CAAC;YACrD,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CACF,CAAC,OAAO,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,YAAY,CAAC,WAAW,CAAC;YAC9B,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,OAAO;YACrB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,MAAM,CACX,YAAY,CAAC,WAAW,CAAC;YACxB,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,QAAQ;YACtB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CACF,CAAC,OAAO,CAAC,cAAc,CAAC,6BAA6B,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,MAAM,CACX,YAAY,CAAC,WAAW,CAAC;YACxB,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,GAAG;YACjB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CACF,CAAC,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,YAAY,GAAqB;YACtC;gBACC,EAAE,EAAE,OAA+B;gBACnC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,QAAQ;gBACrB,SAAS,EAAE,EAAE;aACb;YACD;gBACC,EAAE,EAAE,OAA+B;gBACnC,IAAI,EAAE,eAAe;gBACrB,UAAU,EAAE,UAAU;gBACtB,SAAS,EAAE,kBAAkB;aAC7B;SACD,CAAA;QAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;YAC9C,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;YACnC,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,YAAY;YAClC,YAAY,EAAE,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,SAAS,GAAG;YACjB,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE;YAClE,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,sBAAsB,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE;SACjE,CAAA;QAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;YAC9C,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,SAAS;SACvB,CAAC,CAAA;QAEF,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAE3D,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAA;QACpC,MAAM,YAAY,GAAG,IAAI,0BAA0B,CAAC;YACnD,KAAK;YACL,iBAAiB,EAAE,GAAG;SACtB,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;YAC9C,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;YAC9C,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;QACrF,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CACxC,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,EACrF,OAAO,CACP,CAAA;QACD,oCAAoC;QACpC,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,YAAY,CAAC,WAAW,CAAC;YAC9B,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC5D,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;QACrF,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CACxC,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,EACtF,OAAO,CACP,CAAA;QACD,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAA;QACpE,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,YAAY,CAAC,WAAW,CAAC;YAC9B,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;YACtD,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC5D,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACjE,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAA;QAE5B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC5D,iCAAiC;QACjC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,yEAAyE;QACzE,oEAAoE;QACpE,MAAM,YAAY,CAAC,WAAW,CAAC;YAC9B,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CAAA;QACF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACvD,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QACrD,MAAM,KAAK,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAA;QAEhE,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACjE,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAEhC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC5D,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAErC,0EAA0E;QAC1E,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAClE,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QAC1C,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC7D,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC3D,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,KAAK,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACxC,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QAE7C,MAAM,MAAM,CACX,YAAY,CAAC,WAAW,CAAC;YACxB,SAAS,EAAE,aAA0B;YACrC,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACrC,YAAY,EAAE,EAAE;YAChB,oBAAoB,EAAE,EAAE;YACxB,YAAY,EAAE,EAAE;SAChB,CAAC,CACF,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}