@ai-devkit/agent-manager 0.25.0 → 0.26.0

package/dist/print/PrintAgentStore.js

@@ -0,0 +1,484 @@
+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

package/dist/print/PrintAgentStore.js.map

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

package/dist/terminal/TmuxManager.d.ts

@@ -7,7 +7,7 @@ export declare class TmuxManager {
     /**
      * Find the actual agent process PID inside a tmux pane.
      *
-     * Strategy: BFS the process tree, return the deepest descendant whose
+     * Strategy: BFS the process tree, return the deepest process whose
      * `ps` command line is accepted by `matches`. The caller supplies the
      * matcher so this method has no agent-type knowledge.
      *
@@ -17,7 +17,7 @@ export declare class TmuxManager {
      * - Subprocess case: shell → claude (matches) → MCP server child (doesn't match)
      *   → returns claude, not the subprocess
      *
-     * Returns null when no descendant matches yet (agent still starting); the
+     * Returns null when no process matches yet (agent still starting); the
      * caller's poll loop retries.
      */
     findAgentPid(session: string, matches: (psCommand: string) => boolean): Promise<number | null>;

package/dist/terminal/TmuxManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TmuxManager.d.ts","sourceRoot":"","sources":["../../src/terminal/TmuxManager.ts"],"names":[],"mappings":"AAKA,qBAAa,WAAW;IACd,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YA2BtF,UAAU;YAYV,aAAa;YAab,iBAAiB;CASlC"}
+{"version":3,"file":"TmuxManager.d.ts","sourceRoot":"","sources":["../../src/terminal/TmuxManager.ts"],"names":[],"mappings":"AAKA,qBAAa,WAAW;IACd,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAyBtF,UAAU;YAYV,aAAa;YAab,iBAAiB;CASlC"}

package/dist/terminal/TmuxManager.js

@@ -57,7 +57,7 @@ export class TmuxManager {
     /**
      * Find the actual agent process PID inside a tmux pane.
      *
-     * Strategy: BFS the process tree, return the deepest descendant whose
+     * Strategy: BFS the process tree, return the deepest process whose
      * `ps` command line is accepted by `matches`. The caller supplies the
      * matcher so this method has no agent-type knowledge.
      *
@@ -67,7 +67,7 @@ export class TmuxManager {
      * - Subprocess case: shell → claude (matches) → MCP server child (doesn't match)
      *   → returns claude, not the subprocess
      *
-     * Returns null when no descendant matches yet (agent still starting); the
+     * Returns null when no process matches yet (agent still starting); the
      * caller's poll loop retries.
      */ async findAgentPid(session, matches) {
         const panePid = await this.getPanePid(session);
@@ -81,11 +81,9 @@ export class TmuxManager {
             const pid = queue.shift();
             if (visited.has(pid)) continue;
             visited.add(pid);
-            if (pid !== panePid) {
-                const command = await this.getProcessCommand(pid);
-                if (command && matches(command)) {
-                    deepestMatch = pid;
-                }
+            const command = await this.getProcessCommand(pid);
+            if (command && matches(command)) {
+                deepestMatch = pid;
             }
             const children = await this.pgrepChildren(pid);
             queue.push(...children);

package/dist/terminal/TmuxManager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/terminal/TmuxManager.ts"],"sourcesContent":["import { execFile } from 'child_process';\nimport { promisify } from 'util';\n\nconst execFileAsync = promisify(execFile);\n\nexport class TmuxManager {\n    async isAvailable(): Promise<boolean> {\n        try {\n            await execFileAsync('tmux', ['-V']);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    async sessionExists(name: string): Promise<boolean> {\n        try {\n            await execFileAsync('tmux', ['has-session', '-t', name]);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    async createSession(name: string, cwd: string): Promise<void> {\n        await execFileAsync('tmux', ['new-session', '-d', '-s', name, '-c', cwd]);\n    }\n\n    async sendKeys(session: string, keys: string): Promise<void> {\n        await execFileAsync('tmux', ['send-keys', '-t', session, keys, 'Enter']);\n    }\n\n    async killSession(name: string): Promise<void> {\n        try {\n            await execFileAsync('tmux', ['kill-session', '-t', name]);\n        } catch {\n            // Already gone — ignore\n        }\n    }\n\n    /**\n     * Find the actual agent process PID inside a tmux pane.\n     *\n     * Strategy: BFS the process tree, return the deepest descendant whose\n     * `ps` command line is accepted by `matches`. The caller supplies the\n     * matcher so this method has no agent-type knowledge.\n     *\n     * This handles two real-world process shapes:\n     * - Wrapper case: shell → claude-wrapper (matches) → claude (matches, deeper)\n     *   → returns the deeper one\n     * - Subprocess case: shell → claude (matches) → MCP server child (doesn't match)\n     *   → returns claude, not the subprocess\n     *\n     * Returns null when no descendant matches yet (agent still starting); the\n     * caller's poll loop retries.\n     */\n    async findAgentPid(session: string, matches: (psCommand: string) => boolean): Promise<number | null> {\n        const panePid = await this.getPanePid(session);\n        if (panePid === null) return null;\n\n        const visited = new Set<number>();\n        const queue: number[] = [panePid];\n        let deepestMatch: number | null = null;\n\n        while (queue.length > 0) {\n            const pid = queue.shift()!;\n            if (visited.has(pid)) continue;\n            visited.add(pid);\n\n            if (pid !== panePid) {\n                const command = await this.getProcessCommand(pid);\n                if (command && matches(command)) {\n                    deepestMatch = pid;\n                }\n            }\n\n            const children = await this.pgrepChildren(pid);\n            queue.push(...children);\n        }\n\n        return deepestMatch;\n    }\n\n    private async getPanePid(session: string): Promise<number | null> {\n        try {\n            const { stdout } = await execFileAsync('tmux', [\n                'list-panes', '-t', session, '-F', '#{pane_pid}',\n            ]);\n            const panePid = parseInt(stdout.trim().split('\\n')[0], 10);\n            return isNaN(panePid) ? null : panePid;\n        } catch {\n            return null;\n        }\n    }\n\n    private async pgrepChildren(pid: number): Promise<number[]> {\n        try {\n            const { stdout } = await execFileAsync('pgrep', ['-P', String(pid)]);\n            return stdout\n                .trim()\n                .split('\\n')\n                .map((s) => parseInt(s, 10))\n                .filter((n) => !isNaN(n));\n        } catch {\n            return [];\n        }\n    }\n\n    private async getProcessCommand(pid: number): Promise<string | null> {\n        try {\n            const { stdout } = await execFileAsync('ps', ['-p', String(pid), '-o', 'command=']);\n            const trimmed = stdout.trim();\n            return trimmed || null;\n        } catch {\n            return null;\n        }\n    }\n}\n"],"names":["execFile","promisify","execFileAsync","TmuxManager","isAvailable","sessionExists","name","createSession","cwd","sendKeys","session","keys","killSession","findAgentPid","matches","panePid","getPanePid","visited","Set","queue","deepestMatch","length","pid","shift","has","add","command","getProcessCommand","children","pgrepChildren","push","stdout","parseInt","trim","split","isNaN","String","map","s","filter","n","trimmed"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,SAAS,QAAQ,OAAO;AAEjC,MAAMC,gBAAgBD,UAAUD;AAEhC,OAAO,MAAMG;IACT,MAAMC,cAAgC;QAClC,IAAI;YACA,MAAMF,cAAc,QAAQ;gBAAC;aAAK;YAClC,OAAO;QACX,EAAE,OAAM;YACJ,OAAO;QACX;IACJ;IAEA,MAAMG,cAAcC,IAAY,EAAoB;QAChD,IAAI;YACA,MAAMJ,cAAc,QAAQ;gBAAC;gBAAe;gBAAMI;aAAK;YACvD,OAAO;QACX,EAAE,OAAM;YACJ,OAAO;QACX;IACJ;IAEA,MAAMC,cAAcD,IAAY,EAAEE,GAAW,EAAiB;QAC1D,MAAMN,cAAc,QAAQ;YAAC;YAAe;YAAM;YAAMI;YAAM;YAAME;SAAI;IAC5E;IAEA,MAAMC,SAASC,OAAe,EAAEC,IAAY,EAAiB;QACzD,MAAMT,cAAc,QAAQ;YAAC;YAAa;YAAMQ;YAASC;YAAM;SAAQ;IAC3E;IAEA,MAAMC,YAAYN,IAAY,EAAiB;QAC3C,IAAI;YACA,MAAMJ,cAAc,QAAQ;gBAAC;gBAAgB;gBAAMI;aAAK;QAC5D,EAAE,OAAM;QACJ,wBAAwB;QAC5B;IACJ;IAEA;;;;;;;;;;;;;;;KAeC,GACD,MAAMO,aAAaH,OAAe,EAAEI,OAAuC,EAA0B;QACjG,MAAMC,UAAU,MAAM,IAAI,CAACC,UAAU,CAACN;QACtC,IAAIK,YAAY,MAAM,OAAO;QAE7B,MAAME,UAAU,IAAIC;QACpB,MAAMC,QAAkB;YAACJ;SAAQ;QACjC,IAAIK,eAA8B;QAElC,MAAOD,MAAME,MAAM,GAAG,EAAG;YACrB,MAAMC,MAAMH,MAAMI,KAAK;YACvB,IAAIN,QAAQO,GAAG,CAACF,MAAM;YACtBL,QAAQQ,GAAG,CAACH;YAEZ,IAAIA,QAAQP,SAAS;gBACjB,MAAMW,UAAU,MAAM,IAAI,CAACC,iBAAiB,CAACL;gBAC7C,IAAII,WAAWZ,QAAQY,UAAU;oBAC7BN,eAAeE;gBACnB;YACJ;YAEA,MAAMM,WAAW,MAAM,IAAI,CAACC,aAAa,CAACP;YAC1CH,MAAMW,IAAI,IAAIF;QAClB;QAEA,OAAOR;IACX;IAEA,MAAcJ,WAAWN,OAAe,EAA0B;QAC9D,IAAI;YACA,MAAM,EAAEqB,MAAM,EAAE,GAAG,MAAM7B,cAAc,QAAQ;gBAC3C;gBAAc;gBAAMQ;gBAAS;gBAAM;aACtC;YACD,MAAMK,UAAUiB,SAASD,OAAOE,IAAI,GAAGC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE;YACvD,OAAOC,MAAMpB,WAAW,OAAOA;QACnC,EAAE,OAAM;YACJ,OAAO;QACX;IACJ;IAEA,MAAcc,cAAcP,GAAW,EAAqB;QACxD,IAAI;YACA,MAAM,EAAES,MAAM,EAAE,GAAG,MAAM7B,cAAc,SAAS;gBAAC;gBAAMkC,OAAOd;aAAK;YACnE,OAAOS,OACFE,IAAI,GACJC,KAAK,CAAC,MACNG,GAAG,CAAC,CAACC,IAAMN,SAASM,GAAG,KACvBC,MAAM,CAAC,CAACC,IAAM,CAACL,MAAMK;QAC9B,EAAE,OAAM;YACJ,OAAO,EAAE;QACb;IACJ;IAEA,MAAcb,kBAAkBL,GAAW,EAA0B;QACjE,IAAI;YACA,MAAM,EAAES,MAAM,EAAE,GAAG,MAAM7B,cAAc,MAAM;gBAAC;gBAAMkC,OAAOd;gBAAM;gBAAM;aAAW;YAClF,MAAMmB,UAAUV,OAAOE,IAAI;YAC3B,OAAOQ,WAAW;QACtB,EAAE,OAAM;YACJ,OAAO;QACX;IACJ;AACJ"}
+{"version":3,"sources":["../../src/terminal/TmuxManager.ts"],"sourcesContent":["import { execFile } from 'child_process';\nimport { promisify } from 'util';\n\nconst execFileAsync = promisify(execFile);\n\nexport class TmuxManager {\n    async isAvailable(): Promise<boolean> {\n        try {\n            await execFileAsync('tmux', ['-V']);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    async sessionExists(name: string): Promise<boolean> {\n        try {\n            await execFileAsync('tmux', ['has-session', '-t', name]);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    async createSession(name: string, cwd: string): Promise<void> {\n        await execFileAsync('tmux', ['new-session', '-d', '-s', name, '-c', cwd]);\n    }\n\n    async sendKeys(session: string, keys: string): Promise<void> {\n        await execFileAsync('tmux', ['send-keys', '-t', session, keys, 'Enter']);\n    }\n\n    async killSession(name: string): Promise<void> {\n        try {\n            await execFileAsync('tmux', ['kill-session', '-t', name]);\n        } catch {\n            // Already gone — ignore\n        }\n    }\n\n    /**\n     * Find the actual agent process PID inside a tmux pane.\n     *\n     * Strategy: BFS the process tree, return the deepest process whose\n     * `ps` command line is accepted by `matches`. The caller supplies the\n     * matcher so this method has no agent-type knowledge.\n     *\n     * This handles two real-world process shapes:\n     * - Wrapper case: shell → claude-wrapper (matches) → claude (matches, deeper)\n     *   → returns the deeper one\n     * - Subprocess case: shell → claude (matches) → MCP server child (doesn't match)\n     *   → returns claude, not the subprocess\n     *\n     * Returns null when no process matches yet (agent still starting); the\n     * caller's poll loop retries.\n     */\n    async findAgentPid(session: string, matches: (psCommand: string) => boolean): Promise<number | null> {\n        const panePid = await this.getPanePid(session);\n        if (panePid === null) return null;\n\n        const visited = new Set<number>();\n        const queue: number[] = [panePid];\n        let deepestMatch: number | null = null;\n\n        while (queue.length > 0) {\n            const pid = queue.shift()!;\n            if (visited.has(pid)) continue;\n            visited.add(pid);\n\n            const command = await this.getProcessCommand(pid);\n            if (command && matches(command)) {\n                deepestMatch = pid;\n            }\n\n            const children = await this.pgrepChildren(pid);\n            queue.push(...children);\n        }\n\n        return deepestMatch;\n    }\n\n    private async getPanePid(session: string): Promise<number | null> {\n        try {\n            const { stdout } = await execFileAsync('tmux', [\n                'list-panes', '-t', session, '-F', '#{pane_pid}',\n            ]);\n            const panePid = parseInt(stdout.trim().split('\\n')[0], 10);\n            return isNaN(panePid) ? null : panePid;\n        } catch {\n            return null;\n        }\n    }\n\n    private async pgrepChildren(pid: number): Promise<number[]> {\n        try {\n            const { stdout } = await execFileAsync('pgrep', ['-P', String(pid)]);\n            return stdout\n                .trim()\n                .split('\\n')\n                .map((s) => parseInt(s, 10))\n                .filter((n) => !isNaN(n));\n        } catch {\n            return [];\n        }\n    }\n\n    private async getProcessCommand(pid: number): Promise<string | null> {\n        try {\n            const { stdout } = await execFileAsync('ps', ['-p', String(pid), '-o', 'command=']);\n            const trimmed = stdout.trim();\n            return trimmed || null;\n        } catch {\n            return null;\n        }\n    }\n}\n"],"names":["execFile","promisify","execFileAsync","TmuxManager","isAvailable","sessionExists","name","createSession","cwd","sendKeys","session","keys","killSession","findAgentPid","matches","panePid","getPanePid","visited","Set","queue","deepestMatch","length","pid","shift","has","add","command","getProcessCommand","children","pgrepChildren","push","stdout","parseInt","trim","split","isNaN","String","map","s","filter","n","trimmed"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,SAAS,QAAQ,OAAO;AAEjC,MAAMC,gBAAgBD,UAAUD;AAEhC,OAAO,MAAMG;IACT,MAAMC,cAAgC;QAClC,IAAI;YACA,MAAMF,cAAc,QAAQ;gBAAC;aAAK;YAClC,OAAO;QACX,EAAE,OAAM;YACJ,OAAO;QACX;IACJ;IAEA,MAAMG,cAAcC,IAAY,EAAoB;QAChD,IAAI;YACA,MAAMJ,cAAc,QAAQ;gBAAC;gBAAe;gBAAMI;aAAK;YACvD,OAAO;QACX,EAAE,OAAM;YACJ,OAAO;QACX;IACJ;IAEA,MAAMC,cAAcD,IAAY,EAAEE,GAAW,EAAiB;QAC1D,MAAMN,cAAc,QAAQ;YAAC;YAAe;YAAM;YAAMI;YAAM;YAAME;SAAI;IAC5E;IAEA,MAAMC,SAASC,OAAe,EAAEC,IAAY,EAAiB;QACzD,MAAMT,cAAc,QAAQ;YAAC;YAAa;YAAMQ;YAASC;YAAM;SAAQ;IAC3E;IAEA,MAAMC,YAAYN,IAAY,EAAiB;QAC3C,IAAI;YACA,MAAMJ,cAAc,QAAQ;gBAAC;gBAAgB;gBAAMI;aAAK;QAC5D,EAAE,OAAM;QACJ,wBAAwB;QAC5B;IACJ;IAEA;;;;;;;;;;;;;;;KAeC,GACD,MAAMO,aAAaH,OAAe,EAAEI,OAAuC,EAA0B;QACjG,MAAMC,UAAU,MAAM,IAAI,CAACC,UAAU,CAACN;QACtC,IAAIK,YAAY,MAAM,OAAO;QAE7B,MAAME,UAAU,IAAIC;QACpB,MAAMC,QAAkB;YAACJ;SAAQ;QACjC,IAAIK,eAA8B;QAElC,MAAOD,MAAME,MAAM,GAAG,EAAG;YACrB,MAAMC,MAAMH,MAAMI,KAAK;YACvB,IAAIN,QAAQO,GAAG,CAACF,MAAM;YACtBL,QAAQQ,GAAG,CAACH;YAEZ,MAAMI,UAAU,MAAM,IAAI,CAACC,iBAAiB,CAACL;YAC7C,IAAII,WAAWZ,QAAQY,UAAU;gBAC7BN,eAAeE;YACnB;YAEA,MAAMM,WAAW,MAAM,IAAI,CAACC,aAAa,CAACP;YAC1CH,MAAMW,IAAI,IAAIF;QAClB;QAEA,OAAOR;IACX;IAEA,MAAcJ,WAAWN,OAAe,EAA0B;QAC9D,IAAI;YACA,MAAM,EAAEqB,MAAM,EAAE,GAAG,MAAM7B,cAAc,QAAQ;gBAC3C;gBAAc;gBAAMQ;gBAAS;gBAAM;aACtC;YACD,MAAMK,UAAUiB,SAASD,OAAOE,IAAI,GAAGC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE;YACvD,OAAOC,MAAMpB,WAAW,OAAOA;QACnC,EAAE,OAAM;YACJ,OAAO;QACX;IACJ;IAEA,MAAcc,cAAcP,GAAW,EAAqB;QACxD,IAAI;YACA,MAAM,EAAES,MAAM,EAAE,GAAG,MAAM7B,cAAc,SAAS;gBAAC;gBAAMkC,OAAOd;aAAK;YACnE,OAAOS,OACFE,IAAI,GACJC,KAAK,CAAC,MACNG,GAAG,CAAC,CAACC,IAAMN,SAASM,GAAG,KACvBC,MAAM,CAAC,CAACC,IAAM,CAACL,MAAMK;QAC9B,EAAE,OAAM;YACJ,OAAO,EAAE;QACb;IACJ;IAEA,MAAcb,kBAAkBL,GAAW,EAA0B;QACjE,IAAI;YACA,MAAM,EAAES,MAAM,EAAE,GAAG,MAAM7B,cAAc,MAAM;gBAAC;gBAAMkC,OAAOd;gBAAM;gBAAM;aAAW;YAClF,MAAMmB,UAAUV,OAAOE,IAAI;YAC3B,OAAOQ,WAAW;QACtB,EAAE,OAAM;YACJ,OAAO;QACX;IACJ;AACJ"}