@ai-devkit/agent-manager 0.26.4 → 0.28.0

package/dist/{print → durable}/ClaudePrintAgentService.js

@@ -1,38 +1,38 @@
-import { ClaudePrintError, PrintAgentNotFoundError } from './PrintAgent.js';
+import { ClaudePrintError, DurableAgentNotFoundError } from './DurableAgent.js';
 import { ClaudeCliProbe } from './ClaudeCliProbe.js';
 import { ClaudePrintRunner } from './ClaudePrintRunner.js';
-import { PrintAgentStore } from './PrintAgentStore.js';
+import { DurableAgentRepository } from './DurableAgentRepository.js';
 export class ClaudePrintAgentService {
-    store;
+    repository;
     probe;
     runner;
     executable;
     constructor(options = {}){
-        this.store = options.store ?? new PrintAgentStore();
+        this.repository = options.repository ?? new DurableAgentRepository();
         this.probe = options.probe ?? new ClaudeCliProbe();
         this.runner = options.runner ?? new ClaudePrintRunner();
         this.executable = options.executable;
     }
     async create(input) {
         await this.probe.validate();
-        return this.store.create(input);
+        return this.repository.create(input);
     }
     async send(reference, prompt) {
-        const resolved = await this.store.resolve(reference);
-        if (!resolved) throw new PrintAgentNotFoundError(reference);
+        const resolved = await this.repository.resolve(reference);
+        if (!resolved) throw new DurableAgentNotFoundError(reference);
         if (Array.isArray(resolved)) {
-            throw new ClaudePrintError(`Multiple print agents match "${reference}".`, 'PRINT_AGENT_AMBIGUOUS');
+            throw new ClaudePrintError(`Multiple durable agents match "${reference}".`, 'DURABLE_AGENT_AMBIGUOUS');
         }
-        const acquired = await this.store.acquireRun(resolved.id);
+        const acquired = await this.repository.acquireRun(resolved.id);
         try {
             const result = await this.runner.run({
                 agent: acquired.agent,
                 prompt,
                 executable: this.executable,
                 firstRun: acquired.agent.sessionHealth === 'uninitialized',
-                onSpawn: (identity)=>this.store.recordProviderProcess(resolved.id, acquired.token, identity)
+                onSpawn: (identity)=>this.repository.recordProviderProcess(resolved.id, acquired.token, identity)
             });
-            await this.store.completeRun(resolved.id, acquired.token, {
+            await this.repository.completeRun(resolved.id, acquired.token, {
                 status: 'succeeded',
                 exitCode: result.exitCode,
                 summary: sanitize(result.result, 4096),
@@ -46,7 +46,7 @@ export class ClaudePrintAgentService {
         } catch (error) {
             const failure = error instanceof Error ? error : new Error(String(error));
             const sessionHealth = error instanceof ClaudePrintError && error.code === 'CLAUDE_SESSION_MISMATCH' ? 'mismatch' : 'unknown';
-            await this.store.completeRun(resolved.id, acquired.token, {
+            await this.repository.completeRun(resolved.id, acquired.token, {
                 status: 'failed',
                 exitCode: null,
                 summary: sanitize(failure.message, 4096),

package/dist/durable/ClaudePrintAgentService.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/durable/ClaudePrintAgentService.ts"],"sourcesContent":["import type { DurableAgent, ProcessIdentity } from './DurableAgent.js';\nimport { ClaudePrintError, DurableAgentNotFoundError } from './DurableAgent.js';\nimport { ClaudeCliProbe } from './ClaudeCliProbe.js';\nimport { ClaudePrintRunner, type ClaudePrintRunResult } from './ClaudePrintRunner.js';\nimport { DurableAgentRepository, type CreateDurableAgentInput, type DurableRunCompletion } from './DurableAgentRepository.js';\n\ninterface RepositoryLike {\n    create(input: CreateDurableAgentInput): Promise<DurableAgent>;\n    list(): Promise<DurableAgent[]>;\n    resolve(reference: string): Promise<DurableAgent | DurableAgent[] | null>;\n    acquireRun(id: string): Promise<{ agent: DurableAgent; token: string }>;\n    recordProviderProcess(id: string, token: string, identity: ProcessIdentity): Promise<void>;\n    completeRun(id: string, token: string, result: DurableRunCompletion): Promise<DurableAgent>;\n}\n\ninterface ProbeLike { validate(): Promise<{ executable: string; version: string }> }\ninterface RunnerLike { run(request: Parameters<ClaudePrintRunner['run']>[0]): Promise<ClaudePrintRunResult> }\n\nexport interface ClaudePrintAgentServiceOptions {\n    repository?: RepositoryLike;\n    probe?: ProbeLike;\n    runner?: RunnerLike;\n    executable?: string;\n}\n\nexport interface ClaudePrintSendResult extends ClaudePrintRunResult {\n    agentId: string;\n    agentName: string;\n}\n\nexport class ClaudePrintAgentService {\n    readonly repository: RepositoryLike;\n    private readonly probe: ProbeLike;\n    private readonly runner: RunnerLike;\n    private readonly executable?: string;\n\n    constructor(options: ClaudePrintAgentServiceOptions = {}) {\n        this.repository = options.repository ?? new DurableAgentRepository();\n        this.probe = options.probe ?? new ClaudeCliProbe();\n        this.runner = options.runner ?? new ClaudePrintRunner();\n        this.executable = options.executable;\n    }\n\n    async create(input: CreateDurableAgentInput): Promise<DurableAgent> {\n        await this.probe.validate();\n        return this.repository.create(input);\n    }\n\n    async send(reference: string, prompt: string): Promise<ClaudePrintSendResult> {\n        const resolved = await this.repository.resolve(reference);\n        if (!resolved) throw new DurableAgentNotFoundError(reference);\n        if (Array.isArray(resolved)) {\n            throw new ClaudePrintError(`Multiple durable agents match \"${reference}\".`, 'DURABLE_AGENT_AMBIGUOUS');\n        }\n        const acquired = await this.repository.acquireRun(resolved.id);\n        try {\n            const result = await this.runner.run({\n                agent: acquired.agent,\n                prompt,\n                executable: this.executable,\n                firstRun: acquired.agent.sessionHealth === 'uninitialized',\n                onSpawn: (identity) => this.repository.recordProviderProcess(resolved.id, acquired.token, identity),\n            });\n            await this.repository.completeRun(resolved.id, acquired.token, {\n                status: 'succeeded',\n                exitCode: result.exitCode,\n                summary: sanitize(result.result, 4096),\n                sessionHealth: 'healthy',\n            });\n            return { ...result, agentId: resolved.id, agentName: resolved.name };\n        } catch (error) {\n            const failure = error instanceof Error ? error : new Error(String(error));\n            const sessionHealth = error instanceof ClaudePrintError && error.code === 'CLAUDE_SESSION_MISMATCH'\n                ? 'mismatch' as const\n                : 'unknown' as const;\n            await this.repository.completeRun(resolved.id, acquired.token, {\n                status: 'failed',\n                exitCode: null,\n                summary: sanitize(failure.message, 4096),\n                sessionHealth,\n            });\n            throw error;\n        }\n    }\n}\n\nfunction sanitize(value: string, max: number): string {\n    return Array.from(value, (character) => {\n        const code = character.charCodeAt(0);\n        return (code <= 8 || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127)\n            ? ' '\n            : character;\n    }).join('').trim().slice(0, max);\n}\n"],"names":["ClaudePrintError","DurableAgentNotFoundError","ClaudeCliProbe","ClaudePrintRunner","DurableAgentRepository","ClaudePrintAgentService","repository","probe","runner","executable","options","create","input","validate","send","reference","prompt","resolved","resolve","Array","isArray","acquired","acquireRun","id","result","run","agent","firstRun","sessionHealth","onSpawn","identity","recordProviderProcess","token","completeRun","status","exitCode","summary","sanitize","agentId","agentName","name","error","failure","Error","String","code","message","value","max","from","character","charCodeAt","join","trim","slice"],"mappings":"AACA,SAASA,gBAAgB,EAAEC,yBAAyB,QAAQ,oBAAoB;AAChF,SAASC,cAAc,QAAQ,sBAAsB;AACrD,SAASC,iBAAiB,QAAmC,yBAAyB;AACtF,SAASC,sBAAsB,QAAiE,8BAA8B;AA0B9H,OAAO,MAAMC;IACAC,WAA2B;IACnBC,MAAiB;IACjBC,OAAmB;IACnBC,WAAoB;IAErC,YAAYC,UAA0C,CAAC,CAAC,CAAE;QACtD,IAAI,CAACJ,UAAU,GAAGI,QAAQJ,UAAU,IAAI,IAAIF;QAC5C,IAAI,CAACG,KAAK,GAAGG,QAAQH,KAAK,IAAI,IAAIL;QAClC,IAAI,CAACM,MAAM,GAAGE,QAAQF,MAAM,IAAI,IAAIL;QACpC,IAAI,CAACM,UAAU,GAAGC,QAAQD,UAAU;IACxC;IAEA,MAAME,OAAOC,KAA8B,EAAyB;QAChE,MAAM,IAAI,CAACL,KAAK,CAACM,QAAQ;QACzB,OAAO,IAAI,CAACP,UAAU,CAACK,MAAM,CAACC;IAClC;IAEA,MAAME,KAAKC,SAAiB,EAAEC,MAAc,EAAkC;QAC1E,MAAMC,WAAW,MAAM,IAAI,CAACX,UAAU,CAACY,OAAO,CAACH;QAC/C,IAAI,CAACE,UAAU,MAAM,IAAIhB,0BAA0Bc;QACnD,IAAII,MAAMC,OAAO,CAACH,WAAW;YACzB,MAAM,IAAIjB,iBAAiB,CAAC,+BAA+B,EAAEe,UAAU,EAAE,CAAC,EAAE;QAChF;QACA,MAAMM,WAAW,MAAM,IAAI,CAACf,UAAU,CAACgB,UAAU,CAACL,SAASM,EAAE;QAC7D,IAAI;YACA,MAAMC,SAAS,MAAM,IAAI,CAAChB,MAAM,CAACiB,GAAG,CAAC;gBACjCC,OAAOL,SAASK,KAAK;gBACrBV;gBACAP,YAAY,IAAI,CAACA,UAAU;gBAC3BkB,UAAUN,SAASK,KAAK,CAACE,aAAa,KAAK;gBAC3CC,SAAS,CAACC,WAAa,IAAI,CAACxB,UAAU,CAACyB,qBAAqB,CAACd,SAASM,EAAE,EAAEF,SAASW,KAAK,EAAEF;YAC9F;YACA,MAAM,IAAI,CAACxB,UAAU,CAAC2B,WAAW,CAAChB,SAASM,EAAE,EAAEF,SAASW,KAAK,EAAE;gBAC3DE,QAAQ;gBACRC,UAAUX,OAAOW,QAAQ;gBACzBC,SAASC,SAASb,OAAOA,MAAM,EAAE;gBACjCI,eAAe;YACnB;YACA,OAAO;gBAAE,GAAGJ,MAAM;gBAAEc,SAASrB,SAASM,EAAE;gBAAEgB,WAAWtB,SAASuB,IAAI;YAAC;QACvE,EAAE,OAAOC,OAAO;YACZ,MAAMC,UAAUD,iBAAiBE,QAAQF,QAAQ,IAAIE,MAAMC,OAAOH;YAClE,MAAMb,gBAAgBa,iBAAiBzC,oBAAoByC,MAAMI,IAAI,KAAK,4BACpE,aACA;YACN,MAAM,IAAI,CAACvC,UAAU,CAAC2B,WAAW,CAAChB,SAASM,EAAE,EAAEF,SAASW,KAAK,EAAE;gBAC3DE,QAAQ;gBACRC,UAAU;gBACVC,SAASC,SAASK,QAAQI,OAAO,EAAE;gBACnClB;YACJ;YACA,MAAMa;QACV;IACJ;AACJ;AAEA,SAASJ,SAASU,KAAa,EAAEC,GAAW;IACxC,OAAO7B,MAAM8B,IAAI,CAACF,OAAO,CAACG;QACtB,MAAML,OAAOK,UAAUC,UAAU,CAAC;QAClC,OAAO,AAACN,QAAQ,KAAKA,SAAS,MAAMA,SAAS,MAAOA,QAAQ,MAAMA,QAAQ,MAAOA,SAAS,MACpF,MACAK;IACV,GAAGE,IAAI,CAAC,IAAIC,IAAI,GAAGC,KAAK,CAAC,GAAGN;AAChC"}

package/dist/{print → durable}/ClaudePrintRunner.d.ts

@@ -1,11 +1,11 @@
 import { type ChildProcessWithoutNullStreams, type SpawnOptionsWithoutStdio } from 'child_process';
-import type { PrintAgent, ProcessIdentity } from './PrintAgent.js';
-import { type ProcessInspector } from './PrintAgentStore.js';
+import type { DurableAgent, ProcessIdentity } from './DurableAgent.js';
+import { type ProcessInspector } from './DurableAgentRepository.js';
 type Spawn = (command: string, args: readonly string[], options: SpawnOptionsWithoutStdio & {
     stdio: ['pipe', 'pipe', 'pipe'];
 }) => ChildProcessWithoutNullStreams;
 export interface ClaudePrintRunRequest {
-    agent: PrintAgent;
+    agent: DurableAgent;
     prompt: string;
     executable?: string;
     firstRun: boolean;

package/dist/durable/ClaudePrintRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudePrintRunner.d.ts","sourceRoot":"","sources":["../../src/durable/ClaudePrintRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,8BAA8B,EAAE,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACvH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEvE,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE3F,KAAK,KAAK,GAAG,CACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,wBAAwB,GAAG;IAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KACtE,8BAA8B,CAAC;AAEpC,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACrC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,GAAE,wBAA6B;IAM5C,GAAG,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAgG3E"}

package/dist/{print → durable}/ClaudePrintRunner.js

@@ -1,6 +1,6 @@
 import { spawn as nodeSpawn } from 'child_process';
-import { ClaudePrintError } from './PrintAgent.js';
-import { LocalProcessInspector } from './PrintAgentStore.js';
+import { ClaudePrintError } from './DurableAgent.js';
+import { LocalProcessInspector } from './DurableAgentRepository.js';
 export class ClaudePrintRunner {
     spawn;
     processInspector;

package/dist/durable/ClaudePrintRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/durable/ClaudePrintRunner.ts"],"sourcesContent":["import { spawn as nodeSpawn, type ChildProcessWithoutNullStreams, type SpawnOptionsWithoutStdio } from 'child_process';\nimport type { DurableAgent, ProcessIdentity } from './DurableAgent.js';\nimport { ClaudePrintError } from './DurableAgent.js';\nimport { LocalProcessInspector, type ProcessInspector } from './DurableAgentRepository.js';\n\ntype Spawn = (\n    command: string,\n    args: readonly string[],\n    options: SpawnOptionsWithoutStdio & { stdio: ['pipe', 'pipe', 'pipe'] },\n) => ChildProcessWithoutNullStreams;\n\nexport interface ClaudePrintRunRequest {\n    agent: DurableAgent;\n    prompt: string;\n    executable?: string;\n    firstRun: boolean;\n    onSpawn(identity: ProcessIdentity): Promise<void>;\n}\n\nexport interface ClaudePrintRunResult {\n    sessionId: string;\n    result: string;\n    exitCode: number;\n}\n\nexport interface ClaudePrintRunnerOptions {\n    spawn?: Spawn;\n    processInspector?: ProcessInspector;\n    maxLineBytes?: number;\n}\n\nexport class ClaudePrintRunner {\n    private readonly spawn: Spawn;\n    private readonly processInspector: ProcessInspector;\n    private readonly maxLineBytes: number;\n\n    constructor(options: ClaudePrintRunnerOptions = {}) {\n        this.spawn = options.spawn ?? (nodeSpawn as Spawn);\n        this.processInspector = options.processInspector ?? new LocalProcessInspector();\n        this.maxLineBytes = options.maxLineBytes ?? 1024 * 1024;\n    }\n\n    async run(request: ClaudePrintRunRequest): Promise<ClaudePrintRunResult> {\n        const sessionArgs = request.firstRun\n            ? ['--session-id', request.agent.providerSessionId]\n            : ['--resume', request.agent.providerSessionId];\n        const args = ['-p', ...sessionArgs, '--output-format', 'stream-json', '--verbose'];\n        const child = this.spawn(request.executable ?? 'claude', args, {\n            cwd: request.agent.cwd,\n            shell: false,\n            stdio: ['pipe', 'pipe', 'pipe'],\n        });\n        if (!child.pid) {\n            child.kill();\n            throw new ClaudePrintError('Claude process did not provide a PID.', 'CLAUDE_PROCESS_IDENTITY');\n        }\n        const identity = this.processInspector.getIdentity(child.pid);\n        if (!identity) {\n            child.kill();\n            throw new ClaudePrintError('Cannot verify Claude process identity.', 'CLAUDE_PROCESS_IDENTITY');\n        }\n\n        let buffer = Buffer.alloc(0);\n        let terminal: ClaudePrintRunResult | null = null;\n        let protocolError: ClaudePrintError | null = null;\n\n        child.stdout.on('data', (chunk: Buffer | string) => {\n            if (protocolError) return;\n            buffer = Buffer.concat([buffer, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)]);\n            if (buffer.length > this.maxLineBytes && buffer.indexOf(0x0a) < 0) {\n                protocolError = new ClaudePrintError('Claude stream line exceeded the safety limit.', 'CLAUDE_STREAM_OVERSIZED');\n                return;\n            }\n            let newline: number;\n            while ((newline = buffer.indexOf(0x0a)) >= 0) {\n                const line = buffer.subarray(0, newline);\n                buffer = buffer.subarray(newline + 1);\n                if (line.length === 0) continue;\n                if (line.length > this.maxLineBytes) {\n                    protocolError = new ClaudePrintError('Claude stream line exceeded the safety limit.', 'CLAUDE_STREAM_OVERSIZED');\n                    return;\n                }\n                try {\n                    const value = JSON.parse(line.toString('utf8')) as unknown;\n                    if (!value || typeof value !== 'object' || Array.isArray(value)) {\n                        throw new ClaudePrintError('Claude emitted a non-object stream message.', 'CLAUDE_STREAM_INVALID');\n                    }\n                    const event = value as Record<string, unknown>;\n                    if (typeof event.session_id === 'string' && event.session_id !== request.agent.providerSessionId) {\n                        throw new ClaudePrintError('Claude returned a different session identity.', 'CLAUDE_SESSION_MISMATCH');\n                    }\n                    if (event.type === 'result') {\n                        if (terminal) throw new ClaudePrintError('Claude emitted more than one terminal result.', 'CLAUDE_STREAM_INVALID');\n                        if (typeof event.session_id !== 'string' || typeof event.result !== 'string') {\n                            throw new ClaudePrintError('Claude emitted an invalid terminal result.', 'CLAUDE_STREAM_INVALID');\n                        }\n                        terminal = { sessionId: event.session_id, result: event.result, exitCode: 0 };\n                    }\n                } catch (error) {\n                    protocolError = error instanceof ClaudePrintError\n                        ? error\n                        : new ClaudePrintError('Claude emitted malformed stream JSON.', 'CLAUDE_STREAM_INVALID');\n                    return;\n                }\n            }\n        });\n        // Drain provider diagnostics without reflecting potentially sensitive prompt/tool data.\n        child.stderr.resume();\n\n        const closed = new Promise<{ code: number | null; signal: NodeJS.Signals | null }>((resolve, reject) => {\n            child.once('error', reject);\n            child.once('close', (code, signal) => resolve({ code, signal }));\n        });\n\n        try {\n            await request.onSpawn(identity);\n        } catch (error) {\n            child.kill();\n            throw error;\n        }\n\n        child.stdin.end(request.prompt);\n        const { code, signal } = await closed;\n\n        if (protocolError) throw protocolError;\n        if (buffer.length > 0) {\n            throw new ClaudePrintError('Claude stream ended with incomplete JSON.', 'CLAUDE_STREAM_INVALID');\n        }\n        if (code !== 0) {\n            throw new ClaudePrintError(\n                `Claude print run failed${signal ? ` (${signal})` : '.'}`,\n                'CLAUDE_PROCESS_FAILED',\n            );\n        }\n        if (!terminal) throw new ClaudePrintError('Claude stream ended without a terminal result.', 'CLAUDE_RESULT_MISSING');\n        const finalResult = terminal as ClaudePrintRunResult;\n        return { sessionId: finalResult.sessionId, result: finalResult.result, exitCode: code };\n    }\n}\n"],"names":["spawn","nodeSpawn","ClaudePrintError","LocalProcessInspector","ClaudePrintRunner","processInspector","maxLineBytes","options","run","request","sessionArgs","firstRun","agent","providerSessionId","args","child","executable","cwd","shell","stdio","pid","kill","identity","getIdentity","buffer","Buffer","alloc","terminal","protocolError","stdout","on","chunk","concat","isBuffer","from","length","indexOf","newline","line","subarray","value","JSON","parse","toString","Array","isArray","event","session_id","type","result","sessionId","exitCode","error","stderr","resume","closed","Promise","resolve","reject","once","code","signal","onSpawn","stdin","end","prompt","finalResult"],"mappings":"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"}

package/dist/durable/DurableAgent.d.ts

@@ -0,0 +1,61 @@
+export type DurableAgentState = 'ready' | 'running' | 'degraded';
+export type DurableSessionHealth = 'uninitialized' | 'healthy' | 'unknown' | 'mismatch';
+export type DurableRunStatus = 'succeeded' | 'failed' | 'interrupted';
+export declare const AGENT_MODES: {
+    readonly INTERACTIVE: "interactive";
+    readonly DURABLE: "durable";
+};
+export interface ProcessIdentity {
+    pid: number;
+    startedAt: string;
+}
+export interface DurableActiveRun {
+    token: string;
+    owner: ProcessIdentity;
+    provider: ProcessIdentity | null;
+    startedAt: string;
+}
+export interface DurableLastResult {
+    status: DurableRunStatus;
+    completedAt: string;
+    exitCode: number | null;
+    summary: string;
+}
+export interface DurableAgent {
+    id: string;
+    name: string;
+    provider: 'claude';
+    mode: typeof AGENT_MODES.DURABLE;
+    cwd: string;
+    providerSessionId: string;
+    state: DurableAgentState;
+    sessionHealth: DurableSessionHealth;
+    createdAt: string;
+    updatedAt: string;
+    lastActiveAt: string | null;
+    lastResult: DurableLastResult | null;
+    activeRun: DurableActiveRun | null;
+}
+export declare class DurableAgentError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class DurableAgentBusyError extends DurableAgentError {
+    readonly agentId: string;
+    constructor(agentId: string, agentName: string);
+}
+export declare class DurableAgentNotFoundError extends DurableAgentError {
+    readonly reference: string;
+    constructor(reference: string);
+}
+export declare class DurableAgentRepositoryError extends DurableAgentError {
+    constructor(message: string);
+}
+export declare class DurableAgentNameConflictError extends DurableAgentError {
+    readonly agentName: string;
+    constructor(agentName: string);
+}
+export declare class ClaudePrintError extends DurableAgentError {
+    constructor(message: string, code?: string);
+}
+//# sourceMappingURL=DurableAgent.d.ts.map

package/dist/durable/DurableAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DurableAgent.d.ts","sourceRoot":"","sources":["../../src/durable/DurableAgent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AACjE,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AACxF,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEtE,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX,MAAM,WAAW,eAAe;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,OAAO,WAAW,CAAC,OAAO,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,iBAAiB,CAAC;IACzB,aAAa,EAAE,oBAAoB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACtC;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAKnC;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;aAEpC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM,EAC/B,SAAS,EAAE,MAAM;CAKxB;AAED,qBAAa,yBAA0B,SAAQ,iBAAiB;aAChC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAIhD;AAED,qBAAa,2BAA4B,SAAQ,iBAAiB;gBAClD,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,6BAA8B,SAAQ,iBAAiB;aACpC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAIhD;AAED,qBAAa,gBAAiB,SAAQ,iBAAiB;gBACvC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAwB;CAI5D"}

package/dist/durable/DurableAgent.js

@@ -0,0 +1,46 @@
+export const AGENT_MODES = {
+    INTERACTIVE: 'interactive',
+    DURABLE: 'durable'
+};
+export class DurableAgentError extends Error {
+    code;
+    constructor(message, code){
+        super(message), this.code = code;
+        this.name = 'DurableAgentError';
+    }
+}
+export class DurableAgentBusyError extends DurableAgentError {
+    agentId;
+    constructor(agentId, agentName){
+        super(`Durable agent "${agentName}" is busy.`, 'DURABLE_AGENT_BUSY'), this.agentId = agentId;
+        this.name = 'DurableAgentBusyError';
+    }
+}
+export class DurableAgentNotFoundError extends DurableAgentError {
+    reference;
+    constructor(reference){
+        super(`Durable agent "${reference}" was not found.`, 'DURABLE_AGENT_NOT_FOUND'), this.reference = reference;
+        this.name = 'DurableAgentNotFoundError';
+    }
+}
+export class DurableAgentRepositoryError extends DurableAgentError {
+    constructor(message){
+        super(message, 'DURABLE_AGENT_REPOSITORY');
+        this.name = 'DurableAgentRepositoryError';
+    }
+}
+export class DurableAgentNameConflictError extends DurableAgentError {
+    agentName;
+    constructor(agentName){
+        super(`Durable agent name "${agentName}" is already in use.`, 'DURABLE_AGENT_NAME_CONFLICT'), this.agentName = agentName;
+        this.name = 'DurableAgentNameConflictError';
+    }
+}
+export class ClaudePrintError extends DurableAgentError {
+    constructor(message, code = 'CLAUDE_PRINT_FAILED'){
+        super(message, code);
+        this.name = 'ClaudePrintError';
+    }
+}
+
+//# sourceMappingURL=DurableAgent.js.map

package/dist/durable/DurableAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/durable/DurableAgent.ts"],"sourcesContent":["export type DurableAgentState = 'ready' | 'running' | 'degraded';\nexport type DurableSessionHealth = 'uninitialized' | 'healthy' | 'unknown' | 'mismatch';\nexport type DurableRunStatus = 'succeeded' | 'failed' | 'interrupted';\n\nexport const AGENT_MODES = {\n    INTERACTIVE: 'interactive',\n    DURABLE: 'durable',\n} as const;\n\nexport interface ProcessIdentity {\n    pid: number;\n    startedAt: string;\n}\n\nexport interface DurableActiveRun {\n    token: string;\n    owner: ProcessIdentity;\n    provider: ProcessIdentity | null;\n    startedAt: string;\n}\n\nexport interface DurableLastResult {\n    status: DurableRunStatus;\n    completedAt: string;\n    exitCode: number | null;\n    summary: string;\n}\n\nexport interface DurableAgent {\n    id: string;\n    name: string;\n    provider: 'claude';\n    mode: typeof AGENT_MODES.DURABLE;\n    cwd: string;\n    providerSessionId: string;\n    state: DurableAgentState;\n    sessionHealth: DurableSessionHealth;\n    createdAt: string;\n    updatedAt: string;\n    lastActiveAt: string | null;\n    lastResult: DurableLastResult | null;\n    activeRun: DurableActiveRun | null;\n}\n\nexport class DurableAgentError extends Error {\n    constructor(\n        message: string,\n        public readonly code: string,\n    ) {\n        super(message);\n        this.name = 'DurableAgentError';\n    }\n}\n\nexport class DurableAgentBusyError extends DurableAgentError {\n    constructor(\n        public readonly agentId: string,\n        agentName: string,\n    ) {\n        super(`Durable agent \"${agentName}\" is busy.`, 'DURABLE_AGENT_BUSY');\n        this.name = 'DurableAgentBusyError';\n    }\n}\n\nexport class DurableAgentNotFoundError extends DurableAgentError {\n    constructor(public readonly reference: string) {\n        super(`Durable agent \"${reference}\" was not found.`, 'DURABLE_AGENT_NOT_FOUND');\n        this.name = 'DurableAgentNotFoundError';\n    }\n}\n\nexport class DurableAgentRepositoryError extends DurableAgentError {\n    constructor(message: string) {\n        super(message, 'DURABLE_AGENT_REPOSITORY');\n        this.name = 'DurableAgentRepositoryError';\n    }\n}\n\nexport class DurableAgentNameConflictError extends DurableAgentError {\n    constructor(public readonly agentName: string) {\n        super(`Durable agent name \"${agentName}\" is already in use.`, 'DURABLE_AGENT_NAME_CONFLICT');\n        this.name = 'DurableAgentNameConflictError';\n    }\n}\n\nexport class ClaudePrintError extends DurableAgentError {\n    constructor(message: string, code = 'CLAUDE_PRINT_FAILED') {\n        super(message, code);\n        this.name = 'ClaudePrintError';\n    }\n}\n"],"names":["AGENT_MODES","INTERACTIVE","DURABLE","DurableAgentError","Error","message","code","name","DurableAgentBusyError","agentId","agentName","DurableAgentNotFoundError","reference","DurableAgentRepositoryError","DurableAgentNameConflictError","ClaudePrintError"],"mappings":"AAIA,OAAO,MAAMA,cAAc;IACvBC,aAAa;IACbC,SAAS;AACb,EAAW;AAqCX,OAAO,MAAMC,0BAA0BC;;IACnC,YACIC,OAAe,EACf,AAAgBC,IAAY,CAC9B;QACE,KAAK,CAACD,eAFUC,OAAAA;QAGhB,IAAI,CAACC,IAAI,GAAG;IAChB;AACJ;AAEA,OAAO,MAAMC,8BAA8BL;;IACvC,YACI,AAAgBM,OAAe,EAC/BC,SAAiB,CACnB;QACE,KAAK,CAAC,CAAC,eAAe,EAAEA,UAAU,UAAU,CAAC,EAAE,4BAH/BD,UAAAA;QAIhB,IAAI,CAACF,IAAI,GAAG;IAChB;AACJ;AAEA,OAAO,MAAMI,kCAAkCR;;IAC3C,YAAY,AAAgBS,SAAiB,CAAE;QAC3C,KAAK,CAAC,CAAC,eAAe,EAAEA,UAAU,gBAAgB,CAAC,EAAE,iCAD7BA,YAAAA;QAExB,IAAI,CAACL,IAAI,GAAG;IAChB;AACJ;AAEA,OAAO,MAAMM,oCAAoCV;IAC7C,YAAYE,OAAe,CAAE;QACzB,KAAK,CAACA,SAAS;QACf,IAAI,CAACE,IAAI,GAAG;IAChB;AACJ;AAEA,OAAO,MAAMO,sCAAsCX;;IAC/C,YAAY,AAAgBO,SAAiB,CAAE;QAC3C,KAAK,CAAC,CAAC,oBAAoB,EAAEA,UAAU,oBAAoB,CAAC,EAAE,qCADtCA,YAAAA;QAExB,IAAI,CAACH,IAAI,GAAG;IAChB;AACJ;AAEA,OAAO,MAAMQ,yBAAyBZ;IAClC,YAAYE,OAAe,EAAEC,OAAO,qBAAqB,CAAE;QACvD,KAAK,CAACD,SAASC;QACf,IAAI,CAACC,IAAI,GAAG;IAChB;AACJ"}

package/dist/durable/DurableAgentRepository.d.ts

@@ -0,0 +1,60 @@
+import { type DurableAgent, type ProcessIdentity, type DurableRunStatus, type DurableSessionHealth } from './DurableAgent.js';
+export interface CreateDurableAgentInput {
+    name: string;
+    cwd: string;
+}
+export interface DurableAgentRepositoryOptions {
+    dbPath?: string;
+    readonly?: boolean;
+    /** @deprecated SQLite busy_timeout replaces filesystem lock polling. */
+    lockTimeoutMs?: number;
+    now?: () => Date;
+    processInspector?: ProcessInspector;
+    /** @deprecated Active ownership is committed atomically. */
+    incompleteLockGraceMs?: number;
+    /** @deprecated SQLite transactions replace mutation lock directories. */
+    mutationLockStaleMs?: number;
+}
+export interface ProcessInspector {
+    getIdentity(pid: number): ProcessIdentity | null;
+}
+export interface DurableRunCompletion {
+    status: DurableRunStatus;
+    exitCode: number | null;
+    summary: string;
+    sessionHealth: DurableSessionHealth;
+}
+export declare class DurableAgentRepository {
+    readonly dbPath: string;
+    private readonly now;
+    private readonly processInspector;
+    private readonly readonly;
+    private readonly db;
+    constructor(options?: DurableAgentRepositoryOptions);
+    create(input: CreateDurableAgentInput): Promise<DurableAgent>;
+    list(): Promise<DurableAgent[]>;
+    getById(id: string): Promise<DurableAgent | null>;
+    resolve(reference: string): Promise<DurableAgent | DurableAgent[] | null>;
+    acquireRun(id: string): Promise<{
+        agent: DurableAgent;
+        token: string;
+    }>;
+    recordProviderProcess(id: string, token: string, identity: ProcessIdentity): Promise<void>;
+    completeRun(id: string, token: string, result: DurableRunCompletion): Promise<DurableAgent>;
+    reconcile(): Promise<void>;
+    private immediate;
+    private listRaw;
+    private findById;
+    private requireById;
+    private fromRow;
+    private canonicalDirectory;
+    private validateBoundCwd;
+    private isActive;
+    private sameProcess;
+    private assertWritable;
+    private storageError;
+}
+export declare class LocalProcessInspector implements ProcessInspector {
+    getIdentity(pid: number): ProcessIdentity | null;
+}
+//# sourceMappingURL=DurableAgentRepository.d.ts.map

package/dist/durable/DurableAgentRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DurableAgentRepository.d.ts","sourceRoot":"","sources":["../../src/durable/DurableAgentRepository.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsC,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAiBlK,MAAM,WAAW,uBAAuB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAEtE,MAAM,WAAW,6BAA6B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,4DAA4D;IAC5D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAAG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAA;CAAE;AACtF,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,oBAAoB,CAAC;CAC3G;AAED,qBAAa,sBAAsB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqB;gBAE5B,OAAO,GAAE,6BAAkC;IAajD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAqB7D,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK/B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAKjD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC;IAQzE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAkDvE,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1F,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;IAgB3F,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBhC,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;CAIvB;AAED,qBAAa,qBAAsB,YAAW,gBAAgB;IAC1D,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;CAkBnD"}

package/dist/durable/DurableAgentRepository.js

@@ -0,0 +1,325 @@
+import fs from 'fs';
+import { randomUUID } from 'crypto';
+import { execFileSync } from 'child_process';
+import { DatabaseConnection, DEFAULT_AGENT_REGISTRY_DB_PATH } from '../database/index.js';
+import { AGENT_MODES } from './DurableAgent.js';
+import { DurableAgentBusyError, DurableAgentNameConflictError, DurableAgentNotFoundError, DurableAgentRepositoryError } from './DurableAgent.js';
+export class DurableAgentRepository {
+    dbPath;
+    now;
+    processInspector;
+    readonly;
+    db;
+    constructor(options = {}){
+        this.dbPath = options.dbPath ?? DEFAULT_AGENT_REGISTRY_DB_PATH;
+        this.now = options.now ?? (()=>new Date());
+        this.processInspector = options.processInspector ?? new LocalProcessInspector();
+        this.readonly = options.readonly ?? false;
+        try {
+            this.db = new DatabaseConnection({
+                dbPath: this.dbPath,
+                readonly: this.readonly
+            });
+        } catch (error) {
+            if (error instanceof DurableAgentRepositoryError) throw error;
+            throw new DurableAgentRepositoryError(`Cannot open durable-agent database: ${error.message}`);
+        }
+    }
+    async create(input) {
+        this.assertWritable();
+        const cwd = this.canonicalDirectory(input.cwd);
+        const timestamp = this.now().toISOString();
+        const id = randomUUID();
+        let providerSessionId = randomUUID();
+        while(providerSessionId === id)providerSessionId = randomUUID();
+        try {
+            this.db.execute(`INSERT INTO durable_agents (
+                id, name, provider, mode, cwd, provider_session_id, state, session_health, created_at, updated_at
+            ) VALUES (?, ?, 'claude', ?, ?, ?, 'ready', 'uninitialized', ?, ?)`, [
+                id,
+                input.name,
+                AGENT_MODES.DURABLE,
+                cwd,
+                providerSessionId,
+                timestamp,
+                timestamp
+            ]);
+        } catch (error) {
+            if (/UNIQUE constraint failed: durable_agents\.name/i.test(error.message)) {
+                throw new DurableAgentNameConflictError(input.name);
+            }
+            throw this.storageError('Failed to create durable agent', error);
+        }
+        return this.requireById(id);
+    }
+    async list() {
+        if (!this.readonly) await this.reconcile();
+        return this.listRaw();
+    }
+    async getById(id) {
+        if (!this.readonly) await this.reconcile();
+        return this.findById(id);
+    }
+    async resolve(reference) {
+        const agents = await this.list();
+        const byId = agents.find((agent)=>agent.id === reference);
+        if (byId) return byId;
+        const matches = agents.filter((agent)=>agent.name.toLowerCase() === reference.toLowerCase());
+        return matches.length === 0 ? null : matches.length === 1 ? matches[0] : matches;
+    }
+    async acquireRun(id) {
+        this.assertWritable();
+        const snapshot = this.findById(id);
+        if (!snapshot) throw new DurableAgentNotFoundError(id);
+        this.validateBoundCwd(snapshot.cwd);
+        const observed = snapshot.activeRun;
+        const observedLive = observed ? this.isActive(observed) : false;
+        if (observedLive) throw new DurableAgentBusyError(id, snapshot.name);
+        const owner = this.processInspector.getIdentity(process.pid);
+        if (!owner) throw new DurableAgentRepositoryError('Cannot determine the current process identity.');
+        const token = randomUUID();
+        const startedAt = this.now().toISOString();
+        let recovered = false;
+        try {
+            this.immediate(()=>{
+                const current = this.findById(id);
+                if (!current) throw new DurableAgentNotFoundError(id);
+                if (current.state === 'running') {
+                    if (!observed || current.activeRun?.token !== observed.token || observedLive) {
+                        throw new DurableAgentBusyError(id, current.name);
+                    }
+                    recovered = true;
+                }
+                const changed = this.db.execute(`UPDATE durable_agents SET
+                    state = 'running', active_run_token = ?, active_owner_pid = ?, active_owner_started_at = ?,
+                    active_provider_pid = NULL, active_provider_started_at = NULL, active_run_started_at = ?, updated_at = ?,
+                    session_health = CASE WHEN state = 'running' THEN 'unknown' ELSE session_health END,
+                    last_result_status = CASE WHEN state = 'running' THEN 'interrupted' ELSE last_result_status END,
+                    last_result_completed_at = CASE WHEN state = 'running' THEN ? ELSE last_result_completed_at END,
+                    last_result_exit_code = CASE WHEN state = 'running' THEN NULL ELSE last_result_exit_code END,
+                    last_result_summary = CASE WHEN state = 'running' THEN 'Previous print run was interrupted.' ELSE last_result_summary END
+                    WHERE id = ? AND (state <> 'running' OR (
+                        active_run_token = ? AND active_owner_started_at = ? AND active_run_started_at = ?
+                    ))
+                `, [
+                    token,
+                    owner.pid,
+                    owner.startedAt,
+                    startedAt,
+                    startedAt,
+                    startedAt,
+                    id,
+                    observed?.token ?? null,
+                    observed?.owner.startedAt ?? null,
+                    observed?.startedAt ?? null
+                ]);
+                if (changed.changes !== 1) throw new DurableAgentBusyError(id, current.name);
+            });
+        } catch (error) {
+            if (error instanceof DurableAgentBusyError || error instanceof DurableAgentNotFoundError) throw error;
+            if (/busy|locked/i.test(error.message)) throw new DurableAgentBusyError(id, snapshot.name);
+            throw this.storageError('Failed to acquire durable-agent run', error);
+        }
+        const agent = this.requireById(id);
+        if (recovered && agent.lastResult?.status !== 'interrupted') {
+            throw new DurableAgentRepositoryError('Failed to record interrupted print run.');
+        }
+        return {
+            agent,
+            token
+        };
+    }
+    async recordProviderProcess(id, token, identity) {
+        this.assertWritable();
+        const changed = this.db.execute(`UPDATE durable_agents SET
+            active_provider_pid = ?, active_provider_started_at = ?, updated_at = ?
+            WHERE id = ? AND state = 'running' AND active_run_token = ?`, [
+            identity.pid,
+            identity.startedAt,
+            this.now().toISOString(),
+            id,
+            token
+        ]);
+        if (changed.changes !== 1) throw new DurableAgentRepositoryError('Print run ownership changed.');
+    }
+    async completeRun(id, token, result) {
+        this.assertWritable();
+        const completedAt = this.now().toISOString();
+        const changed = this.db.execute(`UPDATE durable_agents SET
+            state = ?, session_health = ?, active_run_token = NULL, active_owner_pid = NULL,
+            active_owner_started_at = NULL, active_provider_pid = NULL, active_provider_started_at = NULL,
+            active_run_started_at = NULL, last_active_at = ?, updated_at = ?, last_result_status = ?,
+            last_result_completed_at = ?, last_result_exit_code = ?, last_result_summary = ?
+            WHERE id = ? AND state = 'running' AND active_run_token = ?`, [
+            result.status === 'succeeded' ? 'ready' : 'degraded',
+            result.sessionHealth,
+            completedAt,
+            completedAt,
+            result.status,
+            completedAt,
+            result.exitCode,
+            result.summary.slice(0, 4096),
+            id,
+            token
+        ]);
+        if (changed.changes !== 1) throw new DurableAgentRepositoryError('Print run ownership changed.');
+        return this.requireById(id);
+    }
+    async reconcile() {
+        this.assertWritable();
+        const running = this.listRaw().filter((agent)=>agent.state === 'running' && agent.activeRun);
+        for (const snapshot of running){
+            if (this.isActive(snapshot.activeRun)) continue;
+            const completedAt = this.now().toISOString();
+            this.db.execute(`UPDATE durable_agents SET
+                state = 'degraded', session_health = 'unknown', active_run_token = NULL,
+                active_owner_pid = NULL, active_owner_started_at = NULL, active_provider_pid = NULL,
+                active_provider_started_at = NULL, active_run_started_at = NULL, updated_at = ?, last_active_at = ?,
+                last_result_status = 'interrupted', last_result_completed_at = ?, last_result_exit_code = NULL,
+                last_result_summary = 'Previous print run was interrupted.'
+                WHERE id = ? AND state = 'running' AND active_run_token = ?
+                    AND active_owner_started_at = ? AND active_run_started_at = ?`, [
+                completedAt,
+                completedAt,
+                completedAt,
+                snapshot.id,
+                snapshot.activeRun.token,
+                snapshot.activeRun.owner.startedAt,
+                snapshot.activeRun.startedAt
+            ]);
+        }
+    }
+    immediate(operation) {
+        this.db.instance.exec('BEGIN IMMEDIATE');
+        try {
+            const result = operation();
+            this.db.instance.exec('COMMIT');
+            return result;
+        } catch (error) {
+            try {
+                this.db.instance.exec('ROLLBACK');
+            } catch  {}
+            throw error;
+        }
+    }
+    listRaw() {
+        try {
+            return this.db.query('SELECT * FROM durable_agents ORDER BY updated_at DESC, name COLLATE NOCASE').map((row)=>this.fromRow(row));
+        } catch (error) {
+            throw this.storageError('Failed to read durable-agent database', error);
+        }
+    }
+    findById(id) {
+        const row = this.db.queryOne('SELECT * FROM durable_agents WHERE id = ?', [
+            id
+        ]);
+        return row ? this.fromRow(row) : null;
+    }
+    requireById(id) {
+        const agent = this.findById(id);
+        if (!agent) throw new DurableAgentNotFoundError(id);
+        return agent;
+    }
+    fromRow(row) {
+        const activeRun = row.active_run_token === null ? null : {
+            token: row.active_run_token,
+            owner: {
+                pid: row.active_owner_pid,
+                startedAt: row.active_owner_started_at
+            },
+            provider: row.active_provider_pid === null ? null : {
+                pid: row.active_provider_pid,
+                startedAt: row.active_provider_started_at
+            },
+            startedAt: row.active_run_started_at
+        };
+        return {
+            id: row.id,
+            name: row.name,
+            provider: row.provider,
+            mode: row.mode,
+            cwd: row.cwd,
+            providerSessionId: row.provider_session_id,
+            state: row.state,
+            sessionHealth: row.session_health,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            lastActiveAt: row.last_active_at,
+            lastResult: row.last_result_status === null ? null : {
+                status: row.last_result_status,
+                completedAt: row.last_result_completed_at,
+                exitCode: row.last_result_exit_code,
+                summary: row.last_result_summary ?? ''
+            },
+            activeRun
+        };
+    }
+    canonicalDirectory(input) {
+        try {
+            const resolved = fs.realpathSync(input);
+            if (!fs.statSync(resolved).isDirectory()) throw new Error('not a directory');
+            return resolved;
+        } catch  {
+            throw new DurableAgentRepositoryError(`Durable agent cwd is not an existing directory: ${input}`);
+        }
+    }
+    validateBoundCwd(bound) {
+        try {
+            const stat = fs.lstatSync(bound);
+            if (!stat.isDirectory() || stat.isSymbolicLink() || fs.realpathSync(bound) !== bound) throw new Error('binding changed');
+        } catch  {
+            throw new DurableAgentRepositoryError(`Durable agent cwd binding is no longer safe: ${bound}`);
+        }
+    }
+    isActive(metadata) {
+        return this.sameProcess(metadata.owner) || metadata.provider !== null && this.sameProcess(metadata.provider);
+    }
+    sameProcess(expected) {
+        const actual = this.processInspector.getIdentity(expected.pid);
+        return actual !== null && actual.startedAt === expected.startedAt;
+    }
+    assertWritable() {
+        if (this.readonly) throw new DurableAgentRepositoryError('Durable-agent repository is readonly.');
+    }
+    storageError(prefix, error) {
+        return error instanceof DurableAgentRepositoryError ? error : new DurableAgentRepositoryError(`${prefix}: ${error.message}`);
+    }
+}
+export class LocalProcessInspector {
+    getIdentity(pid) {
+        if (!Number.isInteger(pid) || pid <= 0) return null;
+        try {
+            if (process.platform === 'linux') {
+                const stat = fs.readFileSync(`/proc/${pid}/stat`, 'utf8');
+                const close = stat.lastIndexOf(')');
+                const fields = stat.slice(close + 2).split(' ');
+                const startTicks = fields[19];
+                return startTicks ? {
+                    pid,
+                    startedAt: `linux:${startTicks}`
+                } : null;
+            }
+            const startedAt = execFileSync('ps', [
+                '-o',
+                'lstart=',
+                '-p',
+                String(pid)
+            ], {
+                encoding: 'utf8',
+                stdio: [
+                    'ignore',
+                    'pipe',
+                    'ignore'
+                ]
+            }).trim();
+            return startedAt ? {
+                pid,
+                startedAt
+            } : null;
+        } catch  {
+            return null;
+        }
+    }
+}
+
+//# sourceMappingURL=DurableAgentRepository.js.map