@ai-devkit/agent-manager 0.26.4 → 0.28.0

package/dist/print/PrintAgent.d.ts

@@ -1,57 +0,0 @@
-export type PrintAgentState = 'ready' | 'running' | 'degraded';
-export type PrintSessionHealth = 'uninitialized' | 'healthy' | 'unknown' | 'mismatch';
-export type PrintRunStatus = 'succeeded' | 'failed' | 'interrupted';
-export interface ProcessIdentity {
-    pid: number;
-    startedAt: string;
-}
-export interface PrintActiveRun {
-    token: string;
-    owner: ProcessIdentity;
-    provider: ProcessIdentity | null;
-    startedAt: string;
-}
-export interface PrintLastResult {
-    status: PrintRunStatus;
-    completedAt: string;
-    exitCode: number | null;
-    summary: string;
-}
-export interface PrintAgent {
-    id: string;
-    name: string;
-    provider: 'claude';
-    mode: 'print';
-    cwd: string;
-    providerSessionId: string;
-    state: PrintAgentState;
-    sessionHealth: PrintSessionHealth;
-    createdAt: string;
-    updatedAt: string;
-    lastActiveAt: string | null;
-    lastResult: PrintLastResult | null;
-    activeRun: PrintActiveRun | null;
-}
-export declare class PrintAgentError extends Error {
-    readonly code: string;
-    constructor(message: string, code: string);
-}
-export declare class PrintAgentBusyError extends PrintAgentError {
-    readonly agentId: string;
-    constructor(agentId: string, agentName: string);
-}
-export declare class PrintAgentNotFoundError extends PrintAgentError {
-    readonly reference: string;
-    constructor(reference: string);
-}
-export declare class PrintAgentStoreError extends PrintAgentError {
-    constructor(message: string);
-}
-export declare class PrintAgentNameConflictError extends PrintAgentError {
-    readonly agentName: string;
-    constructor(agentName: string);
-}
-export declare class ClaudePrintError extends PrintAgentError {
-    constructor(message: string, code?: string);
-}
-//# sourceMappingURL=PrintAgent.d.ts.map

package/dist/print/PrintAgent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PrintAgent.d.ts","sourceRoot":"","sources":["../../src/print/PrintAgent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAC/D,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AACtF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,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,eAAe;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,eAAe,CAAC;IACvB,aAAa,EAAE,kBAAkB,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;CACpC;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAGlB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAKnC;AAED,qBAAa,mBAAoB,SAAQ,eAAe;aAEhC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM,EAC/B,SAAS,EAAE,MAAM;CAKxB;AAED,qBAAa,uBAAwB,SAAQ,eAAe;aAC5B,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAIhD;AAED,qBAAa,oBAAqB,SAAQ,eAAe;gBACzC,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,2BAA4B,SAAQ,eAAe;aAChC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAIhD;AAED,qBAAa,gBAAiB,SAAQ,eAAe;gBACrC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAwB;CAI5D"}

package/dist/print/PrintAgent.js

@@ -1,42 +0,0 @@
-export class PrintAgentError extends Error {
-    code;
-    constructor(message, code){
-        super(message), this.code = code;
-        this.name = 'PrintAgentError';
-    }
-}
-export class PrintAgentBusyError extends PrintAgentError {
-    agentId;
-    constructor(agentId, agentName){
-        super(`Print agent "${agentName}" is busy.`, 'PRINT_AGENT_BUSY'), this.agentId = agentId;
-        this.name = 'PrintAgentBusyError';
-    }
-}
-export class PrintAgentNotFoundError extends PrintAgentError {
-    reference;
-    constructor(reference){
-        super(`Print agent "${reference}" was not found.`, 'PRINT_AGENT_NOT_FOUND'), this.reference = reference;
-        this.name = 'PrintAgentNotFoundError';
-    }
-}
-export class PrintAgentStoreError extends PrintAgentError {
-    constructor(message){
-        super(message, 'PRINT_AGENT_STORE');
-        this.name = 'PrintAgentStoreError';
-    }
-}
-export class PrintAgentNameConflictError extends PrintAgentError {
-    agentName;
-    constructor(agentName){
-        super(`Print agent name "${agentName}" is already in use.`, 'PRINT_AGENT_NAME_CONFLICT'), this.agentName = agentName;
-        this.name = 'PrintAgentNameConflictError';
-    }
-}
-export class ClaudePrintError extends PrintAgentError {
-    constructor(message, code = 'CLAUDE_PRINT_FAILED'){
-        super(message, code);
-        this.name = 'ClaudePrintError';
-    }
-}
-
-//# sourceMappingURL=PrintAgent.js.map

package/dist/print/PrintAgent.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/print/PrintAgent.ts"],"sourcesContent":["export type PrintAgentState = 'ready' | 'running' | 'degraded';\nexport type PrintSessionHealth = 'uninitialized' | 'healthy' | 'unknown' | 'mismatch';\nexport type PrintRunStatus = 'succeeded' | 'failed' | 'interrupted';\n\nexport interface ProcessIdentity {\n    pid: number;\n    startedAt: string;\n}\n\nexport interface PrintActiveRun {\n    token: string;\n    owner: ProcessIdentity;\n    provider: ProcessIdentity | null;\n    startedAt: string;\n}\n\nexport interface PrintLastResult {\n    status: PrintRunStatus;\n    completedAt: string;\n    exitCode: number | null;\n    summary: string;\n}\n\nexport interface PrintAgent {\n    id: string;\n    name: string;\n    provider: 'claude';\n    mode: 'print';\n    cwd: string;\n    providerSessionId: string;\n    state: PrintAgentState;\n    sessionHealth: PrintSessionHealth;\n    createdAt: string;\n    updatedAt: string;\n    lastActiveAt: string | null;\n    lastResult: PrintLastResult | null;\n    activeRun: PrintActiveRun | null;\n}\n\nexport class PrintAgentError extends Error {\n    constructor(\n        message: string,\n        public readonly code: string,\n    ) {\n        super(message);\n        this.name = 'PrintAgentError';\n    }\n}\n\nexport class PrintAgentBusyError extends PrintAgentError {\n    constructor(\n        public readonly agentId: string,\n        agentName: string,\n    ) {\n        super(`Print agent \"${agentName}\" is busy.`, 'PRINT_AGENT_BUSY');\n        this.name = 'PrintAgentBusyError';\n    }\n}\n\nexport class PrintAgentNotFoundError extends PrintAgentError {\n    constructor(public readonly reference: string) {\n        super(`Print agent \"${reference}\" was not found.`, 'PRINT_AGENT_NOT_FOUND');\n        this.name = 'PrintAgentNotFoundError';\n    }\n}\n\nexport class PrintAgentStoreError extends PrintAgentError {\n    constructor(message: string) {\n        super(message, 'PRINT_AGENT_STORE');\n        this.name = 'PrintAgentStoreError';\n    }\n}\n\nexport class PrintAgentNameConflictError extends PrintAgentError {\n    constructor(public readonly agentName: string) {\n        super(`Print agent name \"${agentName}\" is already in use.`, 'PRINT_AGENT_NAME_CONFLICT');\n        this.name = 'PrintAgentNameConflictError';\n    }\n}\n\nexport class ClaudePrintError extends PrintAgentError {\n    constructor(message: string, code = 'CLAUDE_PRINT_FAILED') {\n        super(message, code);\n        this.name = 'ClaudePrintError';\n    }\n}\n"],"names":["PrintAgentError","Error","message","code","name","PrintAgentBusyError","agentId","agentName","PrintAgentNotFoundError","reference","PrintAgentStoreError","PrintAgentNameConflictError","ClaudePrintError"],"mappings":"AAuCA,OAAO,MAAMA,wBAAwBC;;IACjC,YACIC,OAAe,EACf,AAAgBC,IAAY,CAC9B;QACE,KAAK,CAACD,eAFUC,OAAAA;QAGhB,IAAI,CAACC,IAAI,GAAG;IAChB;AACJ;AAEA,OAAO,MAAMC,4BAA4BL;;IACrC,YACI,AAAgBM,OAAe,EAC/BC,SAAiB,CACnB;QACE,KAAK,CAAC,CAAC,aAAa,EAAEA,UAAU,UAAU,CAAC,EAAE,0BAH7BD,UAAAA;QAIhB,IAAI,CAACF,IAAI,GAAG;IAChB;AACJ;AAEA,OAAO,MAAMI,gCAAgCR;;IACzC,YAAY,AAAgBS,SAAiB,CAAE;QAC3C,KAAK,CAAC,CAAC,aAAa,EAAEA,UAAU,gBAAgB,CAAC,EAAE,+BAD3BA,YAAAA;QAExB,IAAI,CAACL,IAAI,GAAG;IAChB;AACJ;AAEA,OAAO,MAAMM,6BAA6BV;IACtC,YAAYE,OAAe,CAAE;QACzB,KAAK,CAACA,SAAS;QACf,IAAI,CAACE,IAAI,GAAG;IAChB;AACJ;AAEA,OAAO,MAAMO,oCAAoCX;;IAC7C,YAAY,AAAgBO,SAAiB,CAAE;QAC3C,KAAK,CAAC,CAAC,kBAAkB,EAAEA,UAAU,oBAAoB,CAAC,EAAE,mCADpCA,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/print/PrintAgentStore.d.ts

@@ -1,69 +0,0 @@
-import type { PrintAgent, ProcessIdentity, PrintRunStatus, PrintSessionHealth } from './PrintAgent.js';
-export interface CreatePrintAgentInput {
-    name: string;
-    cwd: string;
-}
-export interface PrintAgentStoreOptions {
-    filePath?: string;
-    lockTimeoutMs?: number;
-    now?: () => Date;
-    processInspector?: ProcessInspector;
-    incompleteLockGraceMs?: number;
-    mutationLockStaleMs?: number;
-}
-export interface ProcessInspector {
-    getIdentity(pid: number): ProcessIdentity | null;
-}
-export interface PrintRunCompletion {
-    status: PrintRunStatus;
-    exitCode: number | null;
-    summary: string;
-    sessionHealth: PrintSessionHealth;
-}
-export declare class PrintAgentStore {
-    readonly filePath: string;
-    private readonly lockPath;
-    private readonly lockTimeoutMs;
-    private readonly now;
-    private readonly processInspector;
-    private readonly runLocksRoot;
-    private readonly incompleteLockGraceMs;
-    private readonly mutationLockStaleMs;
-    constructor(options?: PrintAgentStoreOptions);
-    create(input: CreatePrintAgentInput): Promise<PrintAgent>;
-    list(): Promise<PrintAgent[]>;
-    getById(id: string): Promise<PrintAgent | null>;
-    reconcile(): Promise<void>;
-    resolve(reference: string): Promise<PrintAgent | PrintAgent[] | null>;
-    acquireRun(id: string): Promise<{
-        agent: PrintAgent;
-        token: string;
-    }>;
-    recordProviderProcess(id: string, token: string, identity: ProcessIdentity): Promise<void>;
-    completeRun(id: string, token: string, result: PrintRunCompletion): Promise<PrintAgent>;
-    private canonicalDirectory;
-    private validateBoundCwd;
-    private ensureSafeParent;
-    private ensureRunLocksRoot;
-    private assertNotSymlink;
-    private readFile;
-    private listRaw;
-    private isStoreFile;
-    private writeFile;
-    private withMutationLock;
-    private isYoungMutationLock;
-    private updateAgent;
-    private runLockPath;
-    private readRunLock;
-    private writeRunLock;
-    private requireOwnedRun;
-    private isActive;
-    private sameProcess;
-    private isYoungLock;
-    private removeOwnedRunLock;
-    private removeLockDirectory;
-}
-export declare class LocalProcessInspector implements ProcessInspector {
-    getIdentity(pid: number): ProcessIdentity | null;
-}
-//# sourceMappingURL=PrintAgentStore.d.ts.map

package/dist/print/PrintAgentStore.d.ts.map

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

package/dist/print/PrintAgentStore.js

@@ -1,484 +0,0 @@
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-import { randomUUID } from 'crypto';
-import { execFileSync } from 'child_process';
-import { PrintAgentBusyError, PrintAgentNameConflictError, PrintAgentNotFoundError, PrintAgentStoreError } from './PrintAgent.js';
-const DEFAULT_FILE = path.join(os.homedir(), '.ai-devkit', 'print-agents.json');
-export class PrintAgentStore {
-    filePath;
-    lockPath;
-    lockTimeoutMs;
-    now;
-    processInspector;
-    runLocksRoot;
-    incompleteLockGraceMs;
-    mutationLockStaleMs;
-    constructor(options = {}){
-        this.filePath = options.filePath ?? DEFAULT_FILE;
-        this.lockPath = `${this.filePath}.lock`;
-        this.lockTimeoutMs = options.lockTimeoutMs ?? 2000;
-        this.now = options.now ?? (()=>new Date());
-        this.processInspector = options.processInspector ?? new LocalProcessInspector();
-        this.runLocksRoot = path.join(path.dirname(this.filePath), 'print-agent-locks');
-        this.incompleteLockGraceMs = options.incompleteLockGraceMs ?? 30_000;
-        this.mutationLockStaleMs = options.mutationLockStaleMs ?? 30_000;
-    }
-    async create(input) {
-        const cwd = this.canonicalDirectory(input.cwd);
-        return this.withMutationLock(async ()=>{
-            const data = this.readFile();
-            if (data.agents.some((agent)=>agent.name.toLowerCase() === input.name.toLowerCase())) {
-                throw new PrintAgentNameConflictError(input.name);
-            }
-            const timestamp = this.now().toISOString();
-            let id = randomUUID();
-            let providerSessionId = randomUUID();
-            while(providerSessionId === id)providerSessionId = randomUUID();
-            while(data.agents.some((agent)=>agent.id === id))id = randomUUID();
-            const agent = {
-                id,
-                name: input.name,
-                provider: 'claude',
-                mode: 'print',
-                cwd,
-                providerSessionId,
-                state: 'ready',
-                sessionHealth: 'uninitialized',
-                createdAt: timestamp,
-                updatedAt: timestamp,
-                lastActiveAt: null,
-                lastResult: null,
-                activeRun: null
-            };
-            data.agents.push(agent);
-            this.writeFile(data);
-            return structuredClone(agent);
-        });
-    }
-    async list() {
-        await this.reconcile();
-        return this.listRaw();
-    }
-    async getById(id) {
-        return (await this.list()).find((agent)=>agent.id === id) ?? null;
-    }
-    async reconcile() {
-        const running = this.listRaw().filter((agent)=>agent.state === 'running' && agent.activeRun);
-        for (const snapshot of running){
-            const lockPath = this.runLockPath(snapshot.id);
-            const metadata = this.readRunLock(snapshot.id);
-            if (metadata && this.isActive(metadata)) continue;
-            if (!metadata && this.isYoungLock(lockPath)) continue;
-            if (fs.existsSync(lockPath)) {
-                const quarantine = `${lockPath}.stale-${randomUUID()}`;
-                try {
-                    fs.renameSync(lockPath, quarantine);
-                    this.removeLockDirectory(quarantine);
-                } catch  {
-                    continue;
-                }
-            }
-            const completedAt = this.now().toISOString();
-            await this.updateAgent(snapshot.id, (current)=>{
-                if (current.state !== 'running' || current.activeRun?.token !== snapshot.activeRun?.token) return current;
-                return {
-                    ...current,
-                    state: 'degraded',
-                    sessionHealth: 'unknown',
-                    activeRun: null,
-                    updatedAt: completedAt,
-                    lastActiveAt: completedAt,
-                    lastResult: {
-                        status: 'interrupted',
-                        completedAt,
-                        exitCode: null,
-                        summary: 'Previous print run was interrupted.'
-                    }
-                };
-            });
-        }
-    }
-    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());
-        if (matches.length === 0) return null;
-        return matches.length === 1 ? matches[0] : matches;
-    }
-    async acquireRun(id) {
-        const existing = await this.getById(id);
-        if (!existing) throw new PrintAgentNotFoundError(id);
-        this.validateBoundCwd(existing.cwd);
-        const runLock = this.runLockPath(id);
-        let recoveredStale = false;
-        for(;;){
-            this.ensureRunLocksRoot();
-            this.assertNotSymlink(runLock);
-            try {
-                fs.mkdirSync(runLock, {
-                    mode: 0o700
-                });
-                break;
-            } catch (error) {
-                if (error.code !== 'EEXIST') {
-                    throw new PrintAgentStoreError(`Cannot acquire print-agent run lock: ${error.message}`);
-                }
-                const metadata = this.readRunLock(id);
-                if (!metadata || this.isActive(metadata)) {
-                    throw new PrintAgentBusyError(id, existing.name);
-                }
-                const quarantine = `${runLock}.stale-${randomUUID()}`;
-                try {
-                    fs.renameSync(runLock, quarantine);
-                    this.removeLockDirectory(quarantine);
-                    recoveredStale = true;
-                } catch  {
-                // Another contender changed the lock. Retry and inspect the winner.
-                }
-            }
-        }
-        const owner = this.processInspector.getIdentity(process.pid);
-        if (!owner) {
-            this.removeLockDirectory(runLock);
-            throw new PrintAgentStoreError('Cannot determine the current process identity.');
-        }
-        const token = randomUUID();
-        const startedAt = this.now().toISOString();
-        const activeRun = {
-            token,
-            owner,
-            provider: null,
-            startedAt
-        };
-        this.writeRunLock(id, activeRun);
-        try {
-            const agent = await this.updateAgent(id, (current)=>({
-                    ...current,
-                    state: 'running',
-                    activeRun,
-                    updatedAt: startedAt,
-                    ...recoveredStale ? {
-                        sessionHealth: 'unknown',
-                        lastResult: {
-                            status: 'interrupted',
-                            completedAt: startedAt,
-                            exitCode: null,
-                            summary: 'Previous print run was interrupted.'
-                        }
-                    } : {}
-                }));
-            return {
-                agent,
-                token
-            };
-        } catch (error) {
-            this.removeOwnedRunLock(id, token);
-            throw error;
-        }
-    }
-    async recordProviderProcess(id, token, identity) {
-        const metadata = this.requireOwnedRun(id, token);
-        const next = {
-            ...metadata,
-            provider: identity
-        };
-        this.writeRunLock(id, next);
-        await this.updateAgent(id, (agent)=>{
-            if (agent.activeRun?.token !== token) throw new PrintAgentStoreError('Print run ownership changed.');
-            return {
-                ...agent,
-                activeRun: next,
-                updatedAt: this.now().toISOString()
-            };
-        });
-    }
-    async completeRun(id, token, result) {
-        this.requireOwnedRun(id, token);
-        const completedAt = this.now().toISOString();
-        const agent = await this.updateAgent(id, (current)=>{
-            if (current.activeRun?.token !== token) throw new PrintAgentStoreError('Print run ownership changed.');
-            return {
-                ...current,
-                state: result.status === 'succeeded' ? 'ready' : 'degraded',
-                sessionHealth: result.sessionHealth,
-                activeRun: null,
-                lastActiveAt: completedAt,
-                updatedAt: completedAt,
-                lastResult: {
-                    status: result.status,
-                    completedAt,
-                    exitCode: result.exitCode,
-                    summary: result.summary.slice(0, 4096)
-                }
-            };
-        });
-        this.removeOwnedRunLock(id, token);
-        return agent;
-    }
-    canonicalDirectory(input) {
-        try {
-            const resolved = fs.realpathSync(input);
-            if (!fs.statSync(resolved).isDirectory()) throw new Error('not a directory');
-            return resolved;
-        } catch  {
-            throw new PrintAgentStoreError(`Print 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 PrintAgentStoreError(`Print agent cwd binding is no longer safe: ${bound}`);
-        }
-    }
-    ensureSafeParent() {
-        const parent = path.dirname(this.filePath);
-        fs.mkdirSync(parent, {
-            recursive: true,
-            mode: 0o700
-        });
-        const stat = fs.lstatSync(parent);
-        if (!stat.isDirectory() || stat.isSymbolicLink()) {
-            throw new PrintAgentStoreError(`Unsafe print-agent store directory: ${parent}`);
-        }
-        return parent;
-    }
-    ensureRunLocksRoot() {
-        this.ensureSafeParent();
-        fs.mkdirSync(this.runLocksRoot, {
-            recursive: true,
-            mode: 0o700
-        });
-        const stat = fs.lstatSync(this.runLocksRoot);
-        if (!stat.isDirectory() || stat.isSymbolicLink()) {
-            throw new PrintAgentStoreError(`Unsafe print-agent lock directory: ${this.runLocksRoot}`);
-        }
-    }
-    assertNotSymlink(target) {
-        try {
-            if (fs.lstatSync(target).isSymbolicLink()) {
-                throw new PrintAgentStoreError(`Unsafe symbolic link in print-agent storage: ${target}`);
-            }
-        } catch (error) {
-            if (error instanceof PrintAgentStoreError) throw error;
-            if (error.code !== 'ENOENT') {
-                throw new PrintAgentStoreError(`Cannot inspect print-agent storage: ${target}`);
-            }
-        }
-    }
-    readFile() {
-        this.ensureSafeParent();
-        this.assertNotSymlink(this.filePath);
-        if (!fs.existsSync(this.filePath)) return {
-            version: 1,
-            agents: []
-        };
-        try {
-            const parsed = JSON.parse(fs.readFileSync(this.filePath, 'utf8'));
-            if (!this.isStoreFile(parsed)) throw new Error('invalid schema');
-            return parsed;
-        } catch  {
-            throw new PrintAgentStoreError(`Invalid print-agent store: ${this.filePath}`);
-        }
-    }
-    listRaw() {
-        return this.readFile().agents.map((agent)=>structuredClone(agent));
-    }
-    isStoreFile(value) {
-        if (!value || typeof value !== 'object') return false;
-        const record = value;
-        return record.version === 1 && Array.isArray(record.agents);
-    }
-    writeFile(data) {
-        const parent = this.ensureSafeParent();
-        this.assertNotSymlink(this.filePath);
-        const temp = path.join(parent, `.print-agents-${process.pid}-${randomUUID()}.tmp`);
-        this.assertNotSymlink(temp);
-        let fd;
-        try {
-            fd = fs.openSync(temp, 'wx', 0o600);
-            fs.writeFileSync(fd, JSON.stringify(data, null, 2), 'utf8');
-            fs.fsyncSync(fd);
-            fs.closeSync(fd);
-            fd = undefined;
-            fs.renameSync(temp, this.filePath);
-            fs.chmodSync(this.filePath, 0o600);
-        } catch (error) {
-            if (fd !== undefined) fs.closeSync(fd);
-            try {
-                fs.unlinkSync(temp);
-            } catch  {}
-            if (error instanceof PrintAgentStoreError) throw error;
-            throw new PrintAgentStoreError(`Failed to update print-agent store: ${error.message}`);
-        }
-    }
-    async withMutationLock(operation) {
-        this.ensureSafeParent();
-        const started = Date.now();
-        for(;;){
-            this.assertNotSymlink(this.lockPath);
-            try {
-                fs.mkdirSync(this.lockPath, {
-                    mode: 0o700
-                });
-                break;
-            } catch (error) {
-                if (error.code !== 'EEXIST') {
-                    throw new PrintAgentStoreError(`Cannot acquire print-agent store lock: ${error.message}`);
-                }
-                if (!this.isYoungMutationLock()) {
-                    const quarantine = `${this.lockPath}.stale-${randomUUID()}`;
-                    try {
-                        fs.renameSync(this.lockPath, quarantine);
-                        fs.rmdirSync(quarantine);
-                        continue;
-                    } catch  {
-                    // Another contender changed the lock. Retry until the bounded timeout.
-                    }
-                }
-                if (Date.now() - started >= this.lockTimeoutMs) {
-                    throw new PrintAgentStoreError('Timed out acquiring print-agent store lock.');
-                }
-                await new Promise((resolve)=>setTimeout(resolve, 10));
-            }
-        }
-        try {
-            return await operation();
-        } finally{
-            try {
-                fs.rmdirSync(this.lockPath);
-            } catch  {}
-        }
-    }
-    isYoungMutationLock() {
-        try {
-            this.assertNotSymlink(this.lockPath);
-            const stat = fs.statSync(this.lockPath);
-            return stat.isDirectory() && Date.now() - stat.mtimeMs < this.mutationLockStaleMs;
-        } catch  {
-            return false;
-        }
-    }
-    async updateAgent(id, update) {
-        return this.withMutationLock(async ()=>{
-            const data = this.readFile();
-            const index = data.agents.findIndex((agent)=>agent.id === id);
-            if (index < 0) throw new PrintAgentNotFoundError(id);
-            const next = update(data.agents[index]);
-            data.agents[index] = next;
-            this.writeFile(data);
-            return structuredClone(next);
-        });
-    }
-    runLockPath(id) {
-        if (!/^[0-9a-f-]{36}$/i.test(id)) throw new PrintAgentStoreError('Invalid print-agent id.');
-        return path.join(this.runLocksRoot, `${id}.lock`);
-    }
-    readRunLock(id) {
-        const ownerPath = path.join(this.runLockPath(id), 'owner.json');
-        try {
-            this.assertNotSymlink(ownerPath);
-            const value = JSON.parse(fs.readFileSync(ownerPath, 'utf8'));
-            if (!value || typeof value.token !== 'string' || !value.owner || typeof value.owner.pid !== 'number') return null;
-            return value;
-        } catch  {
-            return null;
-        }
-    }
-    writeRunLock(id, metadata) {
-        const lockPath = this.runLockPath(id);
-        const ownerPath = path.join(lockPath, 'owner.json');
-        const tempPath = path.join(lockPath, `.owner-${randomUUID()}.tmp`);
-        this.assertNotSymlink(lockPath);
-        this.assertNotSymlink(ownerPath);
-        fs.writeFileSync(tempPath, JSON.stringify(metadata), {
-            encoding: 'utf8',
-            mode: 0o600,
-            flag: 'wx'
-        });
-        fs.renameSync(tempPath, ownerPath);
-    }
-    requireOwnedRun(id, token) {
-        const metadata = this.readRunLock(id);
-        if (!metadata || metadata.token !== token) throw new PrintAgentStoreError('Print run ownership changed.');
-        return metadata;
-    }
-    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;
-    }
-    isYoungLock(lockPath) {
-        try {
-            this.assertNotSymlink(lockPath);
-            return Date.now() - fs.statSync(lockPath).mtimeMs < this.incompleteLockGraceMs;
-        } catch  {
-            return false;
-        }
-    }
-    removeOwnedRunLock(id, token) {
-        const metadata = this.readRunLock(id);
-        if (!metadata || metadata.token !== token) return;
-        this.removeLockDirectory(this.runLockPath(id));
-    }
-    removeLockDirectory(lockPath) {
-        this.assertNotSymlink(lockPath);
-        try {
-            for (const name of fs.readdirSync(lockPath)){
-                const entry = path.join(lockPath, name);
-                this.assertNotSymlink(entry);
-                if (!fs.lstatSync(entry).isFile()) throw new PrintAgentStoreError(`Unsafe entry in print-agent lock: ${entry}`);
-                fs.unlinkSync(entry);
-            }
-            fs.rmdirSync(lockPath);
-        } catch (error) {
-            if (error.code !== 'ENOENT') throw error;
-        }
-    }
-}
-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];
-                if (!startTicks) return null;
-                return {
-                    pid,
-                    startedAt: `linux:${startTicks}`
-                };
-            }
-            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=PrintAgentStore.js.map