@creativeintelligence/abbie 0.1.0

package/dist/lib/session-manager.test.js

@@ -0,0 +1,310 @@
+import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
+import { mkdtempSync, rmSync, existsSync, readFileSync, lstatSync, readlinkSync, writeFileSync, mkdirSync, } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { generateSlug, getAllSessions, getSession, createSession, } from './session-manager';
+describe('session-manager', () => {
+    describe('generateSlug', () => {
+        it('generates slug with date and title', () => {
+            const slug = generateSlug('Test Session');
+            expect(slug).toMatch(/^\d{4}-\d{2}-\d{2}-test-session$/);
+        });
+        it('handles special characters', () => {
+            const slug = generateSlug('Test & Special! Characters?');
+            expect(slug).toMatch(/^\d{4}-\d{2}-\d{2}-test-special-characters$/);
+        });
+        it('handles multiple spaces', () => {
+            const slug = generateSlug('Multiple    Spaces');
+            expect(slug).toMatch(/^\d{4}-\d{2}-\d{2}-multiple-spaces$/);
+        });
+        it('handles leading/trailing dashes', () => {
+            const slug = generateSlug('--test--');
+            expect(slug).toMatch(/^\d{4}-\d{2}-\d{2}-test$/);
+        });
+        it('converts to lowercase', () => {
+            const slug = generateSlug('UPPERCASE TITLE');
+            expect(slug).toMatch(/^\d{4}-\d{2}-\d{2}-uppercase-title$/);
+        });
+        it('preserves digits in the slug', () => {
+            const slug = generateSlug('Release 2.0 Plan');
+            expect(slug).toMatch(/^\d{4}-\d{2}-\d{2}-release-2-0-plan$/);
+        });
+        it('replaces underscores with dashes', () => {
+            const slug = generateSlug('Feature_Test_Case');
+            expect(slug).toMatch(/^\d{4}-\d{2}-\d{2}-feature-test-case$/);
+        });
+        it('trims punctuation from the ends', () => {
+            const slug = generateSlug('!!!Hello!!!');
+            expect(slug).toMatch(/^\d{4}-\d{2}-\d{2}-hello$/);
+        });
+    });
+    describe('getAllSessions', () => {
+        let tempDir;
+        beforeEach(() => {
+            tempDir = mkdtempSync(join(tmpdir(), 'agents-test-'));
+        });
+        afterEach(() => {
+            if (existsSync(tempDir)) {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+        it('returns empty object if directory does not exist', () => {
+            const nonExistentDir = join(tempDir, 'does-not-exist');
+            const result = getAllSessions(nonExistentDir);
+            expect(result).toEqual({});
+        });
+        it('returns empty object if no projects', () => {
+            const result = getAllSessions(tempDir);
+            expect(result).toEqual({});
+        });
+        it('ignores non-directory entries in the plans directory', () => {
+            const filePath = join(tempDir, 'notes.txt');
+            writeFileSync(filePath, 'hello');
+            const result = getAllSessions(tempDir);
+            expect(result).toEqual({});
+        });
+        it('single project with one session', () => {
+            const session = createSession(tempDir, 'arbor', '2025-12-01-test-session');
+            const result = getAllSessions(tempDir);
+            expect(result).toHaveProperty('arbor');
+            expect(result.arbor).toHaveLength(1);
+            expect(result.arbor[0]).toMatchObject({
+                project: 'arbor',
+                slug: '2025-12-01-test-session',
+                date: '2025-12-01',
+                path: session.path,
+            });
+            expect(result.arbor[0].files).toContain('CLAUDE.md');
+            expect(result.arbor[0].files).toContain('plan.md');
+        });
+        it('single project with multiple sessions sorted by date desc', () => {
+            createSession(tempDir, 'koto', '2025-12-01-newer-session');
+            createSession(tempDir, 'koto', '2025-11-15-older-session');
+            createSession(tempDir, 'koto', '2025-12-05-middle-session');
+            const result = getAllSessions(tempDir);
+            expect(result).toHaveProperty('koto');
+            expect(result.koto).toHaveLength(3);
+            // Sorted by date descending (most recent first)
+            expect(result.koto[0].slug).toBe('2025-12-05-middle-session');
+            expect(result.koto[1].slug).toBe('2025-12-01-newer-session');
+            expect(result.koto[2].slug).toBe('2025-11-15-older-session');
+        });
+        it('multiple projects with sessions', () => {
+            createSession(tempDir, 'arbor', '2025-12-01-arbor-session');
+            createSession(tempDir, 'koto', '2025-12-01-koto-session');
+            createSession(tempDir, 'kumori', '2025-12-01-kumori-session');
+            const result = getAllSessions(tempDir);
+            expect(Object.keys(result).sort()).toEqual(['arbor', 'koto', 'kumori']);
+            expect(result.arbor).toHaveLength(1);
+            expect(result.koto).toHaveLength(1);
+            expect(result.kumori).toHaveLength(1);
+            expect(result.arbor[0].slug).toBe('2025-12-01-arbor-session');
+            expect(result.koto[0].slug).toBe('2025-12-01-koto-session');
+            expect(result.kumori[0].slug).toBe('2025-12-01-kumori-session');
+        });
+        it('extracts date from slug format YYYY-MM-DD', () => {
+            createSession(tempDir, 'test', '2025-03-15-feature-name');
+            const result = getAllSessions(tempDir);
+            expect(result.test[0].date).toBe('2025-03-15');
+        });
+        it('handles slug with many hyphens', () => {
+            createSession(tempDir, 'test', '2025-01-30-this-is-a-long-feature-name');
+            const result = getAllSessions(tempDir);
+            expect(result.test[0].date).toBe('2025-01-30');
+            expect(result.test[0].slug).toBe('2025-01-30-this-is-a-long-feature-name');
+        });
+        it('ignores non-directory entries in a project directory', () => {
+            createSession(tempDir, 'arbor', '2025-12-01-test-session');
+            const filePath = join(tempDir, 'arbor', 'notes.txt');
+            writeFileSync(filePath, 'hello');
+            const result = getAllSessions(tempDir);
+            expect(result.arbor).toHaveLength(1);
+            expect(result.arbor[0].slug).toBe('2025-12-01-test-session');
+        });
+        it('includes extra files found in session directory', () => {
+            const session = createSession(tempDir, 'arbor', '2025-12-01-test-session');
+            const extraPath = join(session.path, 'notes.md');
+            writeFileSync(extraPath, 'extra');
+            const result = getAllSessions(tempDir);
+            expect(result.arbor[0].files).toContain('notes.md');
+        });
+        it('returns empty array for projects with no sessions', () => {
+            const projectDir = join(tempDir, 'empty-project');
+            mkdirSync(projectDir, { recursive: true });
+            const result = getAllSessions(tempDir);
+            expect(result['empty-project']).toEqual([]);
+        });
+        it('handles slugs without date prefixes', () => {
+            const projectDir = join(tempDir, 'misc');
+            const sessionDir = join(projectDir, 'custom-slug');
+            mkdirSync(sessionDir, { recursive: true });
+            const result = getAllSessions(tempDir);
+            expect(result.misc[0].date).toBe('custom-slug');
+            expect(result.misc[0].slug).toBe('custom-slug');
+        });
+    });
+    describe('getSession', () => {
+        let tempDir;
+        beforeEach(() => {
+            tempDir = mkdtempSync(join(tmpdir(), 'agents-test-'));
+        });
+        afterEach(() => {
+            if (existsSync(tempDir)) {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+        it('returns correct SessionMetadata for existing session', () => {
+            const created = createSession(tempDir, 'arbor', '2025-12-01-test-session');
+            const session = getSession(tempDir, 'arbor', '2025-12-01-test-session');
+            expect(session).toBeDefined();
+            expect(session).toMatchObject({
+                project: 'arbor',
+                slug: '2025-12-01-test-session',
+                date: '2025-12-01',
+                path: created.path,
+            });
+            expect(session.files).toContain('CLAUDE.md');
+            expect(session.files).toContain('plan.md');
+        });
+        it('returns undefined for non-existent project', () => {
+            createSession(tempDir, 'arbor', '2025-12-01-test-session');
+            const session = getSession(tempDir, 'koto', '2025-12-01-test-session');
+            expect(session).toBeUndefined();
+        });
+        it('returns undefined when plans directory is missing', () => {
+            const missingDir = join(tempDir, 'missing');
+            const session = getSession(missingDir, 'arbor', '2025-12-01-test-session');
+            expect(session).toBeUndefined();
+        });
+        it('returns undefined for non-existent slug', () => {
+            createSession(tempDir, 'arbor', '2025-12-01-test-session');
+            const session = getSession(tempDir, 'arbor', '2025-12-01-different-session');
+            expect(session).toBeUndefined();
+        });
+        it('case-sensitive matching for project', () => {
+            createSession(tempDir, 'arbor', '2025-12-01-test-session');
+            const session = getSession(tempDir, 'Arbor', '2025-12-01-test-session');
+            expect(session).toBeUndefined();
+        });
+        it('case-sensitive matching for slug', () => {
+            createSession(tempDir, 'arbor', '2025-12-01-test-session');
+            const session = getSession(tempDir, 'arbor', '2025-12-01-Test-Session');
+            expect(session).toBeUndefined();
+        });
+        it('returns session from correct project when multiple projects exist', () => {
+            createSession(tempDir, 'arbor', '2025-12-01-arbor-feature');
+            createSession(tempDir, 'koto', '2025-12-01-koto-feature');
+            const arborSession = getSession(tempDir, 'arbor', '2025-12-01-arbor-feature');
+            const kotoSession = getSession(tempDir, 'koto', '2025-12-01-koto-feature');
+            expect(arborSession?.project).toBe('arbor');
+            expect(kotoSession?.project).toBe('koto');
+        });
+        it('returns session with extra files in metadata', () => {
+            const created = createSession(tempDir, 'arbor', '2025-12-01-test-session');
+            writeFileSync(join(created.path, 'notes.md'), 'extra');
+            const session = getSession(tempDir, 'arbor', '2025-12-01-test-session');
+            expect(session?.files).toContain('notes.md');
+        });
+    });
+    describe('createSession', () => {
+        let tempDir;
+        beforeEach(() => {
+            tempDir = mkdtempSync(join(tmpdir(), 'agents-test-'));
+        });
+        afterEach(() => {
+            if (existsSync(tempDir)) {
+                rmSync(tempDir, { recursive: true, force: true });
+            }
+        });
+        it('creates project directory if needed', () => {
+            const session = createSession(tempDir, 'new-project', '2025-12-01-test');
+            const projectDir = join(tempDir, 'new-project');
+            expect(existsSync(projectDir)).toBe(true);
+            expect(existsSync(session.path)).toBe(true);
+        });
+        it('creates session directory with slug', () => {
+            const session = createSession(tempDir, 'arbor', '2025-12-01-feature-name');
+            const expectedPath = join(tempDir, 'arbor', '2025-12-01-feature-name');
+            expect(session.path).toBe(expectedPath);
+            expect(existsSync(expectedPath)).toBe(true);
+        });
+        it('creates CLAUDE.md with template', () => {
+            const session = createSession(tempDir, 'arbor', '2025-12-01-test');
+            const claudePath = join(session.path, 'CLAUDE.md');
+            expect(existsSync(claudePath)).toBe(true);
+            const content = readFileSync(claudePath, 'utf-8');
+            expect(content).toContain('# arbor - 2025-12-01-test');
+            expect(content).toContain('## Context');
+            expect(content).toContain('## Background');
+            expect(content).toContain('## Goals');
+        });
+        it('creates plan.md with template', () => {
+            const session = createSession(tempDir, 'arbor', '2025-12-01-test');
+            const planPath = join(session.path, 'plan.md');
+            expect(existsSync(planPath)).toBe(true);
+            const content = readFileSync(planPath, 'utf-8');
+            expect(content).toContain('# Implementation Plan');
+            expect(content).toContain('## Overview');
+            expect(content).toContain('## Tasks');
+            expect(content).toContain('## Validation');
+        });
+        it('includes task checklist in plan template', () => {
+            const session = createSession(tempDir, 'arbor', '2025-12-01-test');
+            const planPath = join(session.path, 'plan.md');
+            const content = readFileSync(planPath, 'utf-8');
+            expect(content).toContain('- [ ] Task 1');
+        });
+        it('includes validation checklist in plan template', () => {
+            const session = createSession(tempDir, 'arbor', '2025-12-01-test');
+            const planPath = join(session.path, 'plan.md');
+            const content = readFileSync(planPath, 'utf-8');
+            expect(content).toContain('- [ ] Feature works as expected');
+        });
+        it('creates CLAUDE.md as symlink to AGENTS.md (or copy fallback)', () => {
+            const session = createSession(tempDir, 'arbor', '2025-12-01-test');
+            const agentsPath = join(session.path, 'AGENTS.md');
+            const claudePath = join(session.path, 'CLAUDE.md');
+            expect(existsSync(agentsPath)).toBe(true);
+            expect(existsSync(claudePath)).toBe(true);
+            // AGENTS.md should be the canonical file
+            const agentsStats = lstatSync(agentsPath);
+            expect(agentsStats.isSymbolicLink()).toBe(false);
+            // CLAUDE.md should link to (or match) AGENTS.md
+            const claudeStats = lstatSync(claudePath);
+            if (claudeStats.isSymbolicLink()) {
+                expect(readlinkSync(claudePath)).toBe('AGENTS.md');
+            }
+            expect(readFileSync(claudePath, 'utf-8')).toBe(readFileSync(agentsPath, 'utf-8'));
+        });
+        it('returns SessionMetadata with correct files array', () => {
+            const session = createSession(tempDir, 'arbor', '2025-12-01-test');
+            expect(session.files).toEqual(['CLAUDE.md', 'AGENTS.md', 'plan.md']);
+            expect(session.project).toBe('arbor');
+            expect(session.slug).toBe('2025-12-01-test');
+            expect(session.date).toBe('2025-12-01');
+        });
+        it('throws error if session already exists', () => {
+            createSession(tempDir, 'arbor', '2025-12-01-test');
+            expect(() => {
+                createSession(tempDir, 'arbor', '2025-12-01-test');
+            }).toThrow('Session already exists');
+        });
+        it('can create multiple sessions in same project', () => {
+            const session1 = createSession(tempDir, 'arbor', '2025-12-01-feature-a');
+            const session2 = createSession(tempDir, 'arbor', '2025-12-02-feature-b');
+            expect(existsSync(session1.path)).toBe(true);
+            expect(existsSync(session2.path)).toBe(true);
+            const sessions = getAllSessions(tempDir);
+            expect(sessions.arbor).toHaveLength(2);
+        });
+        it('extracts date from slug in returned metadata', () => {
+            const session = createSession(tempDir, 'test', '2024-01-15-feature');
+            expect(session.date).toBe('2024-01-15');
+        });
+        it('handles nested project names with hyphens', () => {
+            const session = createSession(tempDir, 'my-project-name', '2025-12-01-test');
+            expect(existsSync(session.path)).toBe(true);
+            expect(session.project).toBe('my-project-name');
+        });
+    });
+});

package/dist/lib/session-result.d.ts

@@ -0,0 +1,40 @@
+import type { AgentType } from "./types.js";
+export declare const SESSION_RESULT_MAX_OUTPUT_CHARS = 1000000;
+export type SessionResultStatus = "completed" | "failed" | "stopped";
+export interface SessionResult {
+    agent: AgentType;
+    artifacts: string[];
+    durationMs: number;
+    endedAt: string;
+    exitCode: number | null;
+    output: {
+        raw: string;
+        parsed: unknown;
+        truncated: boolean;
+    };
+    sessionId: string;
+    startedAt: string;
+    status: SessionResultStatus;
+    traceUrl?: string;
+}
+export interface SessionLogPaths {
+    outputPath: string;
+    resultPath: string;
+    stderrPath: string;
+    stdoutPath: string;
+}
+export declare function getSessionLogPaths(sessionId: string, promptsPath?: string): SessionLogPaths;
+export declare function parseSessionOutput(rawOutput: string, maxChars?: number): SessionResult["output"];
+export declare function buildSessionResult(input: {
+    sessionId: string;
+    agent: AgentType;
+    status: SessionResultStatus;
+    exitCode: number | null;
+    startedAt: string;
+    endedAt: string;
+    rawOutput: string;
+    artifacts?: string[];
+    traceUrl?: string;
+}): SessionResult;
+export declare function readSessionResult(path: string): SessionResult | null;
+//# sourceMappingURL=session-result.d.ts.map

package/dist/lib/session-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-result.d.ts","sourceRoot":"","sources":["../../src/lib/session-result.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,+BAA+B,UAAY,CAAC;AAEzD,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,WAAW,SAAuC,GACjD,eAAe,CAOjB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,SAAkC,GACzC,aAAa,CAAC,QAAQ,CAAC,CAQzB;AA0JD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,aAAa,CAoBhB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAmBpE"}

package/dist/lib/session-result.js

@@ -0,0 +1,180 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const SESSION_RESULT_MAX_OUTPUT_CHARS = 1_000_000;
+export function getSessionLogPaths(sessionId, promptsPath = join(homedir(), ".abbie", "prompts")) {
+    return {
+        outputPath: join(promptsPath, `${sessionId}-response.json`),
+        resultPath: join(promptsPath, `${sessionId}-result.json`),
+        stdoutPath: join(promptsPath, `${sessionId}-stdout.log`),
+        stderrPath: join(promptsPath, `${sessionId}-stderr.log`),
+    };
+}
+export function parseSessionOutput(rawOutput, maxChars = SESSION_RESULT_MAX_OUTPUT_CHARS) {
+    const truncated = rawOutput.length > maxChars;
+    const raw = truncated ? rawOutput.slice(0, maxChars) : rawOutput;
+    const trimmed = raw.trim();
+    const parsed = extractParsedJson(trimmed);
+    return { raw, parsed, truncated };
+}
+function extractParsedJson(trimmed) {
+    if (trimmed.length === 0) {
+        return null;
+    }
+    const direct = tryParseJson(trimmed);
+    if (direct !== null) {
+        return direct;
+    }
+    // Recover from noisy logs. Most agents append JSON at the end.
+    const tail = trimmed.slice(-200_000);
+    const candidates = [
+        ...collectFencedJsonCandidates(trimmed),
+        ...collectTailSuffixCandidates(tail, 250),
+        ...collectTailWindowCandidates(tail, 400),
+    ];
+    return pickBestParsed(candidates);
+}
+function isLikelyOutputContract(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.status === "string" &&
+        typeof obj.summary === "string" &&
+        typeof obj.confidence === "number");
+}
+function tryParseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        const repaired = repairBrokenJsonStrings(value);
+        if (repaired === value) {
+            return null;
+        }
+        try {
+            return JSON.parse(repaired);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function repairBrokenJsonStrings(value) {
+    let out = "";
+    let inString = false;
+    let escaped = false;
+    for (const ch of value) {
+        if (escaped) {
+            out += ch;
+            escaped = false;
+            continue;
+        }
+        if (inString && ch === "\\") {
+            out += ch;
+            escaped = true;
+            continue;
+        }
+        if (ch === '"') {
+            out += ch;
+            inString = !inString;
+            continue;
+        }
+        if (inString && (ch === "\n" || ch === "\r")) {
+            out += " ";
+            continue;
+        }
+        out += ch;
+    }
+    return out;
+}
+function collectFencedJsonCandidates(text) {
+    const codeBlockRegex = /```(?:json)?\s*([\s\S]*?)```/gi;
+    const blocks = [];
+    for (const match of text.matchAll(codeBlockRegex)) {
+        const candidate = match[1]?.trim();
+        if (candidate) {
+            blocks.push(candidate);
+        }
+    }
+    return blocks.reverse();
+}
+function collectTailSuffixCandidates(tail, limit) {
+    const candidates = [];
+    let count = 0;
+    let start = tail.lastIndexOf("{");
+    while (start !== -1 && count < limit) {
+        candidates.push(tail.slice(start).trim());
+        start = tail.lastIndexOf("{", start - 1);
+        count++;
+    }
+    return candidates;
+}
+function collectTailWindowCandidates(tail, limit) {
+    const candidates = [];
+    let attempts = 0;
+    let end = tail.lastIndexOf("}");
+    while (end !== -1 && attempts < limit) {
+        let start = tail.lastIndexOf("{", end);
+        while (start !== -1 && attempts < limit) {
+            candidates.push(tail.slice(start, end + 1).trim());
+            start = tail.lastIndexOf("{", start - 1);
+            attempts++;
+        }
+        end = tail.lastIndexOf("}", end - 1);
+    }
+    return candidates;
+}
+function pickBestParsed(candidates) {
+    let fallbackParsed = null;
+    for (const candidate of candidates) {
+        const parsed = tryParseJson(candidate);
+        if (parsed === null) {
+            continue;
+        }
+        if (isLikelyOutputContract(parsed)) {
+            return parsed;
+        }
+        if (fallbackParsed === null) {
+            fallbackParsed = parsed;
+        }
+    }
+    return fallbackParsed;
+}
+export function buildSessionResult(input) {
+    const startedMs = new Date(input.startedAt).getTime();
+    const endedMs = new Date(input.endedAt).getTime();
+    const durationMs = Number.isFinite(startedMs) && Number.isFinite(endedMs) && endedMs >= startedMs
+        ? endedMs - startedMs
+        : 0;
+    return {
+        sessionId: input.sessionId,
+        agent: input.agent,
+        status: input.status,
+        exitCode: input.exitCode,
+        startedAt: input.startedAt,
+        endedAt: input.endedAt,
+        durationMs,
+        output: parseSessionOutput(input.rawOutput),
+        artifacts: input.artifacts ?? [],
+        ...(input.traceUrl ? { traceUrl: input.traceUrl } : {}),
+    };
+}
+export function readSessionResult(path) {
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        if (!parsed ||
+            typeof parsed !== "object" ||
+            typeof parsed.sessionId !== "string" ||
+            typeof parsed.status !== "string") {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/lib/session-state.d.ts

@@ -0,0 +1,77 @@
+import type { AgentType } from "./types.js";
+export type SessionStateStatus = "active" | "completed" | "failed" | "stopped";
+/**
+ * Agent type for session state tracking.
+ * Uses the full AgentType union to support all agents.
+ */
+export type SessionAgentType = AgentType;
+export interface SessionStateRecord {
+    session_id: string;
+    device_id: string;
+    agent: string;
+    project: string | null;
+    cwd: string | null;
+    pid: number | null;
+    started_at: string;
+    updated_at: string;
+    ended_at: string | null;
+    status: SessionStateStatus;
+    metadata: Record<string, unknown>;
+}
+export interface InitSessionStateOptions {
+    sessionId: string;
+    agent?: SessionAgentType;
+    project?: string;
+    cwd?: string;
+    pid?: number | null;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateSessionStateOptions {
+    sessionId: string;
+    set?: Record<string, unknown>;
+    merge?: Record<string, unknown>;
+}
+export interface EndSessionStateOptions {
+    sessionId: string;
+    status?: Exclude<SessionStateStatus, "active">;
+}
+export interface ListSessionStateOptions {
+    status?: SessionStateStatus;
+    project?: string;
+    agent?: SessionAgentType;
+    deviceId?: string;
+    limit?: number;
+}
+export interface CleanupSessionStateOptions {
+    olderThan?: string;
+    dryRun?: boolean;
+}
+export interface CleanupSessionStateResult {
+    device_id: string;
+    older_than: string;
+    dry_run: boolean;
+    zombies: SessionStateRecord[];
+    deleted: Array<{
+        session_id: string;
+        ended_at: string | null;
+    }>;
+}
+export declare class SessionStateManager {
+    private stateDir;
+    private dbPath;
+    private deviceIdPath;
+    constructor(options?: {
+        stateDir?: string;
+    });
+    getDeviceId(): string;
+    private openDb;
+    private ensureSchema;
+    private rowToRecord;
+    get(sessionId: string): SessionStateRecord | null;
+    init(options: InitSessionStateOptions): SessionStateRecord;
+    update(options: UpdateSessionStateOptions): SessionStateRecord | null;
+    end(options: EndSessionStateOptions): SessionStateRecord | null;
+    list(options?: ListSessionStateOptions): SessionStateRecord[];
+    cleanup(options?: CleanupSessionStateOptions): CleanupSessionStateResult;
+}
+//# sourceMappingURL=session-state.d.ts.map

package/dist/lib/session-state.d.ts.map

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