instar 0.28.113 → 0.28.115

package/dist/providers/adapters/anthropic-interactive-pool/index.js

@@ -0,0 +1,174 @@
+/**
+ * anthropic-interactive-pool adapter — entry point.
+ *
+ * Sister adapter to `anthropic-headless`. Instead of one `claude -p`
+ * subprocess per call, this adapter maintains a pool of long-lived
+ * `claude` REPL sessions in tmux and routes work through them by
+ * prompt-injection. Post-2026-06-15, this is the path that draws from the
+ * user's Max subscription (rather than the Agent SDK credit pot).
+ *
+ * Usage:
+ *
+ *   import { createAnthropicInteractivePoolAdapter } from
+ *     './providers/adapters/anthropic-interactive-pool/index.js';
+ *   import { registry } from './providers/registry.js';
+ *
+ *   const adapter = createAnthropicInteractivePoolAdapter({ poolSize: 2 });
+ *   await registry.register(adapter);
+ *   // …on shutdown:
+ *   await adapter.dispose?.();
+ */
+import { UnsupportedCapabilityError } from '../../errors.js';
+import { anthropicInteractivePoolCapabilities } from './capabilities.js';
+import { ANTHROPIC_INTERACTIVE_POOL_ID } from './errors.js';
+import { configFromEnv } from './config.js';
+import { InteractivePool } from './pool.js';
+import { createOneShotCompletion } from './transport/oneShotCompletion.js';
+import { createWarmSessionInbox } from './transport/warmSessionInbox.js';
+import { createInputInjection } from './control/inputInjection.js';
+import { createHardKill } from './control/hardKill.js';
+import { createInterrupt } from './control/interrupt.js';
+import { createTimeoutBound, createIdleBound, createStopGateInterceptor, } from './control/simpleControls.js';
+import { createAuthCredentialInjection } from './control/authCredentialInjection.js';
+import { createContextScopeControl } from './control/contextScopeControl.js';
+import { createCompactionLifecycle } from './control/compactionLifecycle.js';
+import { createLiveOutputStream } from './observability/liveOutputStream.js';
+import { createProcessLifecycle } from './observability/processLifecycle.js';
+import { createSessionId } from './observability/sessionId.js';
+import { CapabilityFlag as Cap } from '../../capabilities.js';
+/**
+ * Create the anthropic-interactive-pool adapter with the given config
+ * (or environment defaults if omitted).
+ */
+export function createAnthropicInteractivePoolAdapter(partialConfig = {}) {
+    const config = {
+        ...configFromEnv(),
+        ...partialConfig,
+    };
+    const pool = new InteractivePool(config);
+    // Start the pool lazily on first allocate. Multiple concurrent callers
+    // share a single start promise.
+    let startPromise = null;
+    const ensureStarted = async () => {
+        if (!startPromise) {
+            startPromise = pool.start();
+        }
+        await startPromise;
+    };
+    // Wrap allocate-driven primitives so the pool starts on first use without
+    // requiring callers to remember an explicit setup step. Other primitives
+    // (snapshot/state/etc.) refer to handles that must have come from a prior
+    // allocate, so the pool is guaranteed running by the time they run.
+    const oneShot = createOneShotCompletion(pool, config);
+    const wrappedOneShot = {
+        capability: oneShot.capability,
+        evaluate: async (prompt, options) => {
+            await ensureStarted();
+            return oneShot.evaluate(prompt, options);
+        },
+    };
+    const inbox = createWarmSessionInbox(pool, config);
+    const wrappedInbox = {
+        capability: inbox.capability,
+        start: async (options) => {
+            await ensureStarted();
+            return inbox.start(options);
+        },
+        send: inbox.send.bind(inbox),
+        retire: inbox.retire.bind(inbox),
+    };
+    // Each entry in `impls` matches a real capability declared in
+    // capabilities.ts. The pool no longer wires throwing stubs for
+    // primitives it doesn't actually implement — those primitives are
+    // simply not declared, so the registry resolves them on the headless
+    // adapter instead.
+    const impls = new Map();
+    // Transport
+    impls.set(Cap.OneShotCompletion, wrappedOneShot);
+    impls.set(Cap.WarmSessionInbox, wrappedInbox);
+    // Observability — pool-session-state primitives only.
+    impls.set(Cap.LiveOutputStream, createLiveOutputStream(config));
+    impls.set(Cap.ProcessLifecycle, createProcessLifecycle(config));
+    impls.set(Cap.SessionId, createSessionId(pool));
+    // Control — session-management primitives needed by the pool.
+    impls.set(Cap.InputInjection, createInputInjection(config));
+    impls.set(Cap.HardKill, createHardKill(pool));
+    impls.set(Cap.Interrupt, createInterrupt(config));
+    impls.set(Cap.StopGateInterceptor, createStopGateInterceptor());
+    impls.set(Cap.TimeoutBound, createTimeoutBound());
+    impls.set(Cap.IdleBound, createIdleBound());
+    impls.set(Cap.AuthCredentialInjection, createAuthCredentialInjection());
+    impls.set(Cap.ContextScopeControl, createContextScopeControl());
+    impls.set(Cap.CompactionLifecycle, createCompactionLifecycle());
+    return {
+        id: ANTHROPIC_INTERACTIVE_POOL_ID,
+        capabilities: anthropicInteractivePoolCapabilities,
+        pool,
+        primitive(capability) {
+            const impl = impls.get(capability);
+            if (impl === undefined) {
+                throw new UnsupportedCapabilityError(capability, ANTHROPIC_INTERACTIVE_POOL_ID);
+            }
+            return impl;
+        },
+        async start() {
+            await ensureStarted();
+        },
+        async dispose() {
+            await pool.shutdown();
+        },
+    };
+}
+export { configFromEnv } from './config.js';
+export { ANTHROPIC_INTERACTIVE_POOL_ID } from './errors.js';
+/**
+ * Build a CanaryLlmFallback that delegates to an IntelligenceProvider.
+ *
+ * The pool's recurring empty-prompt canary calls the fallback only when
+ * its deterministic re-derivation has already failed — so this is a
+ * rare, last-line-of-defense path. The prompt is intentionally narrow
+ * ("does this terminal capture show Claude Code at a completed prompt?")
+ * and routes through the fast tier (Haiku-class).
+ *
+ * Wire at the application layer:
+ *
+ *   const adapter = createAnthropicInteractivePoolAdapter({
+ *     ...,
+ *     llmFallback: buildCanaryLlmFallback(intelligence),
+ *   });
+ *
+ * Omitting the fallback leaves the canary deterministic-only — a failed
+ * re-derivation will surface as a hard failure rather than a soft
+ * llm-confirmed pass.
+ */
+export function buildCanaryLlmFallback(intelligence) {
+    return async (capturedPane, context) => {
+        const prompt = 'You are inspecting a terminal capture of a Claude Code session.\n\n'
+            + 'Question: does the bottom of this capture indicate Claude Code is at a '
+            + 'completed prompt and ready for the next user input? Answer with the single '
+            + 'word "complete" or "not-complete" — nothing else.\n\n'
+            + `Canary prompt that was sent (for context): ${JSON.stringify(context.canaryPrompt)}\n`
+            + `Expected response pattern: ${context.canaryExpected.source}\n\n`
+            + 'Terminal capture (bottom 30 lines):\n'
+            + '<<<CAPTURE>>>\n'
+            + capturedPane.split('\n').slice(-30).join('\n')
+            + '\n<<<CAPTURE>>>';
+        try {
+            const raw = await intelligence.evaluate(prompt, {
+                model: 'fast',
+                maxTokens: 16,
+                temperature: 0,
+            });
+            const verdict = raw.trim().toLowerCase();
+            if (verdict.startsWith('complete'))
+                return 'complete';
+            if (verdict.startsWith('not-complete') || verdict.startsWith('not complete'))
+                return 'not-complete';
+            return 'error';
+        }
+        catch {
+            return 'error';
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/adapters/anthropic-interactive-pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/adapters/anthropic-interactive-pool/index.ts"],"names":[],"mappings":"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"}

package/dist/providers/adapters/anthropic-interactive-pool/observability/liveOutputStream.d.ts

@@ -0,0 +1,13 @@
+/**
+ * LiveOutputStream for the interactive pool: snapshot + tail of the
+ * underlying pool session's tmux pane.
+ *
+ * Mirrors the anthropic-headless implementation; the difference is that
+ * this adapter looks up the tmux name via the pool's session registry
+ * (handle → reserved pool session) rather than parsing it from the handle
+ * string directly.
+ */
+import type { LiveOutputStream } from '../../../primitives/observability/liveOutputStream.js';
+import type { InteractivePoolConfig } from '../config.js';
+export declare function createLiveOutputStream(config: InteractivePoolConfig): LiveOutputStream;
+//# sourceMappingURL=liveOutputStream.d.ts.map

package/dist/providers/adapters/anthropic-interactive-pool/observability/liveOutputStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveOutputStream.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/anthropic-interactive-pool/observability/liveOutputStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,uDAAuD,CAAC;AAI/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAsG1D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,gBAAgB,CAEtF"}

package/dist/providers/adapters/anthropic-interactive-pool/observability/liveOutputStream.js

@@ -0,0 +1,95 @@
+/**
+ * LiveOutputStream for the interactive pool: snapshot + tail of the
+ * underlying pool session's tmux pane.
+ *
+ * Mirrors the anthropic-headless implementation; the difference is that
+ * this adapter looks up the tmux name via the pool's session registry
+ * (handle → reserved pool session) rather than parsing it from the handle
+ * string directly.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { UnexpectedError, UnsupportedCapabilityError } from '../../../errors.js';
+import { ANTHROPIC_INTERACTIVE_POOL_ID } from '../errors.js';
+import { poolSessionForHandle } from '../transport/warmSessionInbox.js';
+const execFileAsync = promisify(execFile);
+const ANSI_RE = /\[[0-9;?]*[A-Za-z]/g;
+class InteractivePoolLiveOutputStream {
+    config;
+    capability = CapabilityFlag.LiveOutputStream;
+    constructor(config) {
+        this.config = config;
+    }
+    async snapshot(session, options) {
+        const ps = poolSessionForHandle(session);
+        if (!ps) {
+            throw new UnsupportedCapabilityError(`Unknown handle (not from interactive pool): ${session}`, ANTHROPIC_INTERACTIVE_POOL_ID);
+        }
+        const tmuxName = ps.tmuxName;
+        const lines = options?.maxLines ?? 200;
+        const includeAnsi = options?.includeAnsi === true;
+        try {
+            const { stdout } = await execFileAsync(this.config.tmuxPath, ['capture-pane', '-t', `=${tmuxName}:`, '-p', '-S', `-${lines}`, ...(includeAnsi ? ['-e'] : [])], { timeout: 5000, maxBuffer: 4 * 1024 * 1024 });
+            const text = includeAnsi ? stdout : stdout.replace(ANSI_RE, '');
+            return {
+                text,
+                capturedAt: new Date().toISOString(),
+                truncated: stdout.split('\n').length >= lines,
+            };
+        }
+        catch (err) {
+            throw new UnexpectedError(`Failed to capture pane for ${tmuxName}: ${err.message}`, ANTHROPIC_INTERACTIVE_POOL_ID, err);
+        }
+    }
+    tail(session, options) {
+        const ps = poolSessionForHandle(session);
+        if (!ps) {
+            throw new UnsupportedCapabilityError(`Unknown handle (not from interactive pool): ${session}`, ANTHROPIC_INTERACTIVE_POOL_ID);
+        }
+        const tmuxPath = this.config.tmuxPath;
+        const tmuxName = ps.tmuxName;
+        const intervalMs = options?.flushIntervalMs ?? 250;
+        const signal = options?.signal;
+        return {
+            async *[Symbol.asyncIterator]() {
+                let lastBuffer = '';
+                if (options?.includeBacklog) {
+                    try {
+                        const { stdout } = await execFileAsync(tmuxPath, ['capture-pane', '-t', `=${tmuxName}:`, '-p', '-S', '-500'], { timeout: 5000, maxBuffer: 4 * 1024 * 1024 });
+                        const text = stdout.replace(ANSI_RE, '');
+                        if (text) {
+                            yield { text, emittedAt: new Date().toISOString() };
+                            lastBuffer = stdout;
+                        }
+                    }
+                    catch {
+                        // session may not exist yet
+                    }
+                }
+                while (!signal?.aborted) {
+                    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+                    try {
+                        const { stdout } = await execFileAsync(tmuxPath, ['capture-pane', '-t', `=${tmuxName}:`, '-p', '-S', '-200'], { timeout: 5000, maxBuffer: 4 * 1024 * 1024 });
+                        if (stdout !== lastBuffer) {
+                            const delta = stdout.slice(lastBuffer.length);
+                            const cleaned = delta.replace(ANSI_RE, '');
+                            if (cleaned) {
+                                yield { text: cleaned, emittedAt: new Date().toISOString() };
+                            }
+                            lastBuffer = stdout;
+                        }
+                    }
+                    catch {
+                        // session ended; stop iterating
+                        return;
+                    }
+                }
+            },
+        };
+    }
+}
+export function createLiveOutputStream(config) {
+    return new InteractivePoolLiveOutputStream(config);
+}
+//# sourceMappingURL=liveOutputStream.js.map

package/dist/providers/adapters/anthropic-interactive-pool/observability/liveOutputStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveOutputStream.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/anthropic-interactive-pool/observability/liveOutputStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAStC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC,MAAM,+BAA+B;IAGN;IAFpB,UAAU,GAAG,cAAc,CAAC,gBAAgB,CAAC;IAEtD,YAA6B,MAA6B;QAA7B,WAAM,GAAN,MAAM,CAAuB;IAAG,CAAC;IAE9D,KAAK,CAAC,QAAQ,CAAC,OAAsB,EAAE,OAAyB;QAC9D,MAAM,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,0BAA0B,CAClC,+CAA+C,OAAO,EAAE,EACxD,6BAA6B,CAC9B,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;QACvC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,EACpB,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,QAAQ,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAChG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAC9C,CAAC;YACF,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChE,OAAO;gBACL,IAAI;gBACJ,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK;aAC9C,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,eAAe,CACvB,8BAA8B,QAAQ,KAAM,GAAa,CAAC,OAAO,EAAE,EACnE,6BAA6B,EAC7B,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAsB,EAAE,OAAqB;QAChD,MAAM,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,0BAA0B,CAClC,+CAA+C,OAAO,EAAE,EACxD,6BAA6B,CAC9B,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtC,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;QAC7B,MAAM,UAAU,GAAG,OAAO,EAAE,eAAe,IAAI,GAAG,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC/B,OAAO;YACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;gBAC3B,IAAI,UAAU,GAAG,EAAE,CAAC;gBACpB,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;oBAC5B,IAAI,CAAC;wBACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,QAAQ,EACR,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,QAAQ,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAC3D,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAC9C,CAAC;wBACF,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;wBACzC,IAAI,IAAI,EAAE,CAAC;4BACT,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;4BACpD,UAAU,GAAG,MAAM,CAAC;wBACtB,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,4BAA4B;oBAC9B,CAAC;gBACH,CAAC;gBACD,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;oBACxB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;oBAChE,IAAI,CAAC;wBACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,QAAQ,EACR,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,QAAQ,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAC3D,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAC9C,CAAC;wBACF,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;4BAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;4BAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;4BAC3C,IAAI,OAAO,EAAE,CAAC;gCACZ,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;4BAC/D,CAAC;4BACD,UAAU,GAAG,MAAM,CAAC;wBACtB,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,gCAAgC;wBAChC,OAAO;oBACT,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CAAC,MAA6B;IAClE,OAAO,IAAI,+BAA+B,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC"}

package/dist/providers/adapters/anthropic-interactive-pool/observability/processLifecycle.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ProcessLifecycle for the interactive pool: reports PID/alive/startedAt
+ * for the underlying `claude` REPL process owned by a pool session.
+ *
+ * Liveness comes from two sources:
+ *   1. The pool's in-memory state ('ready' / 'busy' / 'retiring' / 'dead')
+ *   2. tmux list-panes for the underlying tmuxName
+ *
+ * Both must agree before we declare the session alive — a pool session that
+ * the pool thinks is alive but whose tmux pane is gone has crashed.
+ */
+import type { ProcessLifecycle } from '../../../primitives/observability/processLifecycle.js';
+import type { InteractivePoolConfig } from '../config.js';
+export declare function createProcessLifecycle(config: InteractivePoolConfig): ProcessLifecycle;
+//# sourceMappingURL=processLifecycle.d.ts.map

package/dist/providers/adapters/anthropic-interactive-pool/observability/processLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processLifecycle.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/anthropic-interactive-pool/observability/processLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,uDAAuD,CAAC;AAI/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AA0E1D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,gBAAgB,CAEtF"}

package/dist/providers/adapters/anthropic-interactive-pool/observability/processLifecycle.js

@@ -0,0 +1,85 @@
+/**
+ * ProcessLifecycle for the interactive pool: reports PID/alive/startedAt
+ * for the underlying `claude` REPL process owned by a pool session.
+ *
+ * Liveness comes from two sources:
+ *   1. The pool's in-memory state ('ready' / 'busy' / 'retiring' / 'dead')
+ *   2. tmux list-panes for the underlying tmuxName
+ *
+ * Both must agree before we declare the session alive — a pool session that
+ * the pool thinks is alive but whose tmux pane is gone has crashed.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { UnsupportedCapabilityError } from '../../../errors.js';
+import { ANTHROPIC_INTERACTIVE_POOL_ID } from '../errors.js';
+import { poolSessionForHandle } from '../transport/warmSessionInbox.js';
+const execFileAsync = promisify(execFile);
+class InteractivePoolProcessLifecycle {
+    config;
+    capability = CapabilityFlag.ProcessLifecycle;
+    constructor(config) {
+        this.config = config;
+    }
+    async state(session) {
+        const ps = poolSessionForHandle(session);
+        if (!ps) {
+            throw new UnsupportedCapabilityError(`Unknown handle (not from interactive pool): ${session}`, ANTHROPIC_INTERACTIVE_POOL_ID);
+        }
+        // Default to dead — promote to alive only if tmux confirms.
+        let alive = false;
+        let pids = [];
+        let startedAt = new Date(ps.spawnedAt).toISOString();
+        try {
+            const { stdout } = await execFileAsync(this.config.tmuxPath, ['list-panes', '-t', `=${ps.tmuxName}:`, '-F', '#{pane_pid} #{session_created}'], { timeout: 5000 });
+            const lines = stdout.trim().split('\n').filter(Boolean);
+            if (lines.length > 0) {
+                // Only consider alive if the pool also thinks the session is live.
+                alive = ps.state !== 'dead' && ps.state !== 'retiring';
+                pids = lines.map((line) => parseInt(line.split(' ')[0], 10)).filter((p) => !Number.isNaN(p));
+                const created = parseInt(lines[0].split(' ')[1], 10);
+                if (!Number.isNaN(created)) {
+                    startedAt = new Date(created * 1000).toISOString();
+                }
+            }
+        }
+        catch {
+            // tmux says not found — definitively dead, even if pool state lags
+        }
+        return { alive, pids, startedAt };
+    }
+    subscribe(session) {
+        const self = this;
+        return {
+            async *[Symbol.asyncIterator]() {
+                let lastAlive = null;
+                while (true) {
+                    let state;
+                    try {
+                        state = await self.state(session);
+                    }
+                    catch {
+                        return;
+                    }
+                    if (lastAlive !== null && lastAlive !== state.alive) {
+                        yield {
+                            session,
+                            kind: state.alive ? 'restarted' : 'died',
+                            state,
+                            timestamp: new Date().toISOString(),
+                        };
+                    }
+                    lastAlive = state.alive;
+                    if (!state.alive)
+                        return;
+                    await new Promise((resolve) => setTimeout(resolve, 2000));
+                }
+            },
+        };
+    }
+}
+export function createProcessLifecycle(config) {
+    return new InteractivePoolProcessLifecycle(config);
+}
+//# sourceMappingURL=processLifecycle.js.map

package/dist/providers/adapters/anthropic-interactive-pool/observability/processLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processLifecycle.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/anthropic-interactive-pool/observability/processLifecycle.ts"],"names":[],"mappings":"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"}

package/dist/providers/adapters/anthropic-interactive-pool/observability/sessionId.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SessionId: bridge between SessionHandle and the underlying Claude session
+ * UUID for the interactive-pool adapter.
+ *
+ * Unlike anthropic-headless (where the Claude UUID is observed via a hook
+ * event when the per-call subprocess starts), interactive-pool sessions are
+ * long-lived REPLs. The Claude UUID is bound to the pool session itself
+ * (via `bindClaudeSessionId(poolSessionId, uuid)`) — typically by a hook
+ * receiver wired to the pool. We then map a warm-inbox handle to its pool
+ * session and surface the bound UUID.
+ *
+ * Reverse lookup returns the currently-active warm-inbox handle that owns
+ * the pool session bearing that UUID, or null if no live reservation
+ * matches.
+ */
+import type { SessionId } from '../../../primitives/observability/sessionId.js';
+import type { InteractivePool } from '../pool.js';
+/** Bind a Claude session UUID to a pool session id (called by hook receiver). */
+export declare function bindClaudeSessionId(poolSessionId: string, claudeSessionId: string): void;
+/** Clear the binding for a pool session (called on retire). */
+export declare function unbindClaudeSessionId(poolSessionId: string): void;
+export declare function createSessionId(pool: InteractivePool): SessionId;
+//# sourceMappingURL=sessionId.d.ts.map

package/dist/providers/adapters/anthropic-interactive-pool/observability/sessionId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionId.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/anthropic-interactive-pool/observability/sessionId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAGhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAGxF;AAED,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAMjE;AAuBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,CAEhE"}

package/dist/providers/adapters/anthropic-interactive-pool/observability/sessionId.js

@@ -0,0 +1,57 @@
+/**
+ * SessionId: bridge between SessionHandle and the underlying Claude session
+ * UUID for the interactive-pool adapter.
+ *
+ * Unlike anthropic-headless (where the Claude UUID is observed via a hook
+ * event when the per-call subprocess starts), interactive-pool sessions are
+ * long-lived REPLs. The Claude UUID is bound to the pool session itself
+ * (via `bindClaudeSessionId(poolSessionId, uuid)`) — typically by a hook
+ * receiver wired to the pool. We then map a warm-inbox handle to its pool
+ * session and surface the bound UUID.
+ *
+ * Reverse lookup returns the currently-active warm-inbox handle that owns
+ * the pool session bearing that UUID, or null if no live reservation
+ * matches.
+ */
+import { CapabilityFlag } from '../../../capabilities.js';
+import { poolSessionForHandle } from '../transport/warmSessionInbox.js';
+const poolIdToUuid = new Map();
+const uuidToPoolId = new Map();
+/** Bind a Claude session UUID to a pool session id (called by hook receiver). */
+export function bindClaudeSessionId(poolSessionId, claudeSessionId) {
+    poolIdToUuid.set(poolSessionId, claudeSessionId);
+    uuidToPoolId.set(claudeSessionId, poolSessionId);
+}
+/** Clear the binding for a pool session (called on retire). */
+export function unbindClaudeSessionId(poolSessionId) {
+    const uuid = poolIdToUuid.get(poolSessionId);
+    if (uuid) {
+        uuidToPoolId.delete(uuid);
+    }
+    poolIdToUuid.delete(poolSessionId);
+}
+class InteractivePoolSessionId {
+    pool;
+    capability = CapabilityFlag.SessionId;
+    constructor(pool) {
+        this.pool = pool;
+    }
+    async providerIdFor(session) {
+        const ps = poolSessionForHandle(session);
+        if (!ps)
+            return null;
+        // Prefer the binding map; fall back to the pool session's own cached uuid.
+        return poolIdToUuid.get(ps.id) ?? ps.claudeSessionId ?? null;
+    }
+    async handleFor(_providerSessionId) {
+        // Reverse lookup: pool sessions don't track warm-inbox handles directly.
+        // Consumers using this primarily care about the forward direction
+        // (handle → UUID for log/event correlation); reverse lookup returns null
+        // unless a future revision tracks warm-inbox handles by uuid.
+        return null;
+    }
+}
+export function createSessionId(pool) {
+    return new InteractivePoolSessionId(pool);
+}
+//# sourceMappingURL=sessionId.js.map

package/dist/providers/adapters/anthropic-interactive-pool/observability/sessionId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionId.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/anthropic-interactive-pool/observability/sessionId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC/C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE/C,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CAAC,aAAqB,EAAE,eAAuB;IAChF,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACjD,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;AACnD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB,CAAC,aAAqB;IACzD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC7C,IAAI,IAAI,EAAE,CAAC;QACT,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,wBAAwB;IAGC;IAFpB,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC;IAE/C,YAA6B,IAAqB;QAArB,SAAI,GAAJ,IAAI,CAAiB;IAAG,CAAC;IAEtD,KAAK,CAAC,aAAa,CAAC,OAAsB;QACxC,MAAM,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,2EAA2E;QAC3E,OAAO,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,eAAe,IAAI,IAAI,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,kBAA0B;QACxC,yEAAyE;QACzE,kEAAkE;QAClE,yEAAyE;QACzE,8DAA8D;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,IAAqB;IACnD,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/providers/adapters/anthropic-interactive-pool/pool.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Pool core for the anthropic-interactive-pool adapter.
+ *
+ * Manages a fixed-size set of long-lived `claude` REPL sessions in tmux.
+ * Each session can serve many prompts before being retired (auto-retire
+ * defends against context-window overflow).
+ *
+ * Lifecycle:
+ *   spawning → ready ⇄ busy → retiring → dead
+ *
+ * Allocation: LRU (least-recently-used ready session wins).
+ * Recycling: when a session is retired, the pool spawns a fresh one in its
+ * place so the steady-state size is preserved.
+ */
+import { EventEmitter } from 'node:events';
+import type { InteractivePoolConfig } from './config.js';
+export type PoolSessionState = 'spawning' | 'ready' | 'busy' | 'retiring' | 'dead';
+export interface PoolSession {
+    id: string;
+    tmuxName: string;
+    state: PoolSessionState;
+    messageCount: number;
+    spawnedAt: number;
+    lastUsedAt: number;
+    /** Provider-side Claude session UUID once bound (via hook event). */
+    claudeSessionId?: string;
+}
+export interface PoolEvents {
+    'session:spawned': PoolSession;
+    'session:ready': PoolSession;
+    'session:allocated': PoolSession;
+    'session:released': PoolSession;
+    'session:retired': PoolSession;
+    'session:died': PoolSession;
+    /**
+     * Emitted when an attempt to spawn (or re-spawn) a pool session fails.
+     * `attempt` is 0 for the original spawn attempt, 1+ for retry attempts.
+     * The pool will schedule a retry with exponential backoff up to
+     * `MAX_REPLACEMENT_ATTEMPTS` total; after that, `pool:degraded_persistent`
+     * fires once and no more retries are scheduled.
+     */
+    'pool:degraded': {
+        error: Error;
+        attempt: number;
+    };
+    /**
+     * Emitted exactly once when a replacement-retry sequence succeeds. The
+     * pool is back at steady-state size.
+     */
+    'pool:healed': {
+        afterAttempts: number;
+    };
+    /**
+     * Emitted exactly once when all retries have been exhausted without
+     * success. The pool is below steady-state size and will stay there
+     * until something external triggers another replacement (next retire,
+     * manual intervention).
+     */
+    'pool:degraded_persistent': {
+        totalAttempts: number;
+    };
+    'pool:shutdown': void;
+}
+export declare class InteractivePool extends EventEmitter {
+    private readonly config;
+    private readonly sessions;
+    private readonly waiters;
+    /** Pending retry timers for replacement spawns. Cleared on shutdown. */
+    private readonly pendingRetryTimers;
+    /** Has the startup empty-prompt canary already run in this process lifetime? */
+    private canaryHasRunInCurrentLifetime;
+    /** Interval handle for the scheduled recurring canary. Cleared on shutdown. */
+    private scheduledCanaryTimer;
+    /** Lock to prevent overlapping scheduled-canary runs if the previous one is slow. */
+    private scheduledCanaryInFlight;
+    private shuttingDown;
+    constructor(config: InteractivePoolConfig);
+    start(): Promise<void>;
+    /**
+     * Schedule the recurring empty-prompt canary. Each tick allocates a
+     * ready session, runs the canary, releases. Self-healing and
+     * degradation surfacing reuse the same paths as the startup canary.
+     * Re-entrancy is guarded by `scheduledCanaryInFlight` — if the
+     * previous tick is still running when the next interval fires
+     * (shouldn't happen at default 1h cadence but possible under
+     * misconfiguration), the new tick is skipped.
+     */
+    private scheduleRecurringCanary;
+    /**
+     * Run one canary cycle on a borrowed pool session. Handles result
+     * surfacing identically to the startup canary path in spawnOne.
+     */
+    private runScheduledCanary;
+    private spawnOne;
+    private waitForReady;
+    capturePane(tmuxName: string, lines: number): Promise<string | null>;
+    /**
+     * Allocate a ready session. Marks it busy and returns. If no session is
+     * ready, waits up to `allocateTimeoutMs`. If no session becomes ready
+     * in time, throws.
+     */
+    allocate(): Promise<PoolSession>;
+    private findReadyLru;
+    private markBusy;
+    private flushWaiter;
+    /**
+     * Return a session to ready. Increments messageCount and checks retire
+     * thresholds; auto-retires if needed.
+     */
+    release(s: PoolSession): Promise<void>;
+    /**
+     * Gracefully retire a session and spawn a replacement.
+     */
+    retire(s: PoolSession): Promise<void>;
+    private replaceRetired;
+    private scheduleRetryReplacement;
+    /** Force-kill a session without graceful retirement. */
+    hardKill(s: PoolSession): Promise<void>;
+    /** Shutdown the pool. */
+    shutdown(): Promise<void>;
+    /** Snapshot of pool state. */
+    status(): {
+        total: number;
+        ready: number;
+        busy: number;
+        retiring: number;
+        sessions: ReadonlyArray<Readonly<PoolSession>>;
+    };
+    getById(id: string): PoolSession | undefined;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/providers/adapters/anthropic-interactive-pool/pool.d.ts.map

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