instar 0.28.113 → 0.28.115

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

@@ -0,0 +1,47 @@
+/**
+ * Smoke test — exercises the adapter against a real `claude` REPL pool.
+ *
+ * Run with:
+ *   INSTAR_REAL_API=1 npx tsx \
+ *     src/providers/adapters/anthropic-interactive-pool/_smoketest.ts
+ *
+ * Skipped unless INSTAR_REAL_API=1 (avoids burning subscription session
+ * quota on every CI run). Expected to draw from Max subscription billing,
+ * NOT the Agent SDK credit pot.
+ */
+import { createAnthropicInteractivePoolAdapter } from './index.js';
+import { CapabilityFlag } from '../../capabilities.js';
+async function main() {
+    if (process.env['INSTAR_REAL_API'] !== '1') {
+        console.log('SKIPPED — set INSTAR_REAL_API=1 to run');
+        return;
+    }
+    const adapter = createAnthropicInteractivePoolAdapter({ poolSize: 1 });
+    console.log('Starting pool (size 1) ...');
+    const poolStart = Date.now();
+    await adapter.start();
+    console.log(`Pool ready in ${Date.now() - poolStart}ms`);
+    const oneShot = adapter.primitive(CapabilityFlag.OneShotCompletion);
+    console.log('Sending prompt through pool ...');
+    const start = Date.now();
+    try {
+        const result = await oneShot.evaluate('What is 2+2? Reply with just the number, no other text.', { model: 'fast', timeoutMs: 120_000 });
+        const elapsed = Date.now() - start;
+        console.log(`Response (${elapsed}ms): ${JSON.stringify(result.text)}`);
+        const text = result.text.trim();
+        if (!/4/.test(text)) {
+            console.error(`FAIL: expected response to contain "4", got: ${JSON.stringify(text)}`);
+            await adapter.dispose?.();
+            process.exit(1);
+        }
+        console.log('PASS');
+    }
+    finally {
+        await adapter.dispose?.();
+    }
+}
+void main().catch(async (err) => {
+    console.error('FAIL:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=_smoketest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_smoketest.js","sourceRoot":"","sources":["../../../../src/providers/adapters/anthropic-interactive-pool/_smoketest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,qCAAqC,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,GAAG,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,qCAAqC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,iBAAiB,CAAsB,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CACnC,yDAAyD,EACzD,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CACtC,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,QAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,gDAAgD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtF,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Pool stress tests for the anthropic-interactive-pool adapter.
+ *
+ * Run with INSTAR_REAL_API=1 (every scenario spawns real `claude` REPL
+ * sessions and consumes Max subscription quota). Without the env var,
+ * every scenario skips.
+ *
+ * Each scenario reports pass/fail/skip and exits the process with
+ * 0 on all-pass, 1 if any failed. Designed to be run manually pre-merge
+ * rather than on every CI run.
+ */
+export {};
+//# sourceMappingURL=_stresstest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_stresstest.d.ts","sourceRoot":"","sources":["../../../../src/providers/adapters/anthropic-interactive-pool/_stresstest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

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

@@ -0,0 +1,146 @@
+/**
+ * Pool stress tests for the anthropic-interactive-pool adapter.
+ *
+ * Run with INSTAR_REAL_API=1 (every scenario spawns real `claude` REPL
+ * sessions and consumes Max subscription quota). Without the env var,
+ * every scenario skips.
+ *
+ * Each scenario reports pass/fail/skip and exits the process with
+ * 0 on all-pass, 1 if any failed. Designed to be run manually pre-merge
+ * rather than on every CI run.
+ */
+import { createAnthropicInteractivePoolAdapter } from './index.js';
+import { CapabilityFlag } from '../../capabilities.js';
+async function concurrentAllocation() {
+    const name = 'pool/concurrentAllocation';
+    const adapter = createAnthropicInteractivePoolAdapter({ poolSize: 2 });
+    await adapter.start();
+    try {
+        const oneShot = adapter.primitive(CapabilityFlag.OneShotCompletion);
+        const prompts = [
+            'Reply with only the digit 1.',
+            'Reply with only the digit 2.',
+            'Reply with only the digit 3.',
+        ];
+        const start = Date.now();
+        const results = await Promise.all(prompts.map((p) => oneShot.evaluate(p, { timeoutMs: 120_000, model: 'fast' })));
+        const elapsed = Date.now() - start;
+        const texts = results.map((r) => r.text.trim());
+        const expected = ['1', '2', '3'];
+        const allMatch = texts.every((t, i) => new RegExp(expected[i]).test(t));
+        if (!allMatch) {
+            return {
+                name,
+                status: 'fail',
+                reason: `responses did not contain expected digits: ${JSON.stringify(texts)}`,
+                details: { texts, elapsed },
+            };
+        }
+        return { name, status: 'pass', details: { texts, elapsed } };
+    }
+    finally {
+        await adapter.dispose?.();
+    }
+}
+async function retireAndReplace() {
+    const name = 'pool/retireAndReplace';
+    const adapter = createAnthropicInteractivePoolAdapter({ poolSize: 1 });
+    await adapter.start();
+    try {
+        const oneShot = adapter.primitive(CapabilityFlag.OneShotCompletion);
+        // Burn the only pool session, then immediately ask for another prompt.
+        // The pool should replace the killed session and the second prompt
+        // should succeed.
+        const first = await oneShot.evaluate('Reply with only the digit 5.', {
+            timeoutMs: 120_000,
+            model: 'fast',
+        });
+        if (!/5/.test(first.text)) {
+            return { name, status: 'fail', reason: `first prompt gave: ${JSON.stringify(first.text)}` };
+        }
+        // Force the pool to recycle by retiring all sessions; pool should spin
+        // up a replacement before the next allocate resolves.
+        const pool = adapter.pool;
+        for (const s of pool.status().sessions) {
+            const sess = pool.getById(s.id);
+            if (sess)
+                await pool.retire(sess);
+        }
+        const second = await oneShot.evaluate('Reply with only the digit 6.', {
+            timeoutMs: 120_000,
+            model: 'fast',
+        });
+        if (!/6/.test(second.text)) {
+            return {
+                name,
+                status: 'fail',
+                reason: `second prompt after retire gave: ${JSON.stringify(second.text)}`,
+            };
+        }
+        return { name, status: 'pass', details: { first: first.text, second: second.text } };
+    }
+    finally {
+        await adapter.dispose?.();
+    }
+}
+async function poolShutdownReleasesResources() {
+    const name = 'pool/shutdownReleasesResources';
+    const adapter = createAnthropicInteractivePoolAdapter({ poolSize: 2 });
+    await adapter.start();
+    const beforeCount = adapter.pool.status().sessions.length;
+    await adapter.dispose?.();
+    const afterCount = adapter.pool.status().sessions.length;
+    if (afterCount !== 0) {
+        return {
+            name,
+            status: 'fail',
+            reason: `expected 0 sessions after dispose, got ${afterCount}`,
+            details: { before: beforeCount, after: afterCount },
+        };
+    }
+    return { name, status: 'pass', details: { before: beforeCount, after: afterCount } };
+}
+const ALL_SCENARIOS = [
+    { name: 'pool/shutdownReleasesResources', run: poolShutdownReleasesResources },
+    { name: 'pool/concurrentAllocation', run: concurrentAllocation },
+    { name: 'pool/retireAndReplace', run: retireAndReplace },
+];
+async function main() {
+    if (process.env['INSTAR_REAL_API'] !== '1') {
+        // eslint-disable-next-line no-console
+        console.log('SKIPPED — set INSTAR_REAL_API=1 to run pool stress tests');
+        return;
+    }
+    let failures = 0;
+    for (const s of ALL_SCENARIOS) {
+        // eslint-disable-next-line no-console
+        console.log(`Running ${s.name} ...`);
+        try {
+            const r = await s.run();
+            const tag = r.status === 'pass' ? 'PASS' : r.status === 'skip' ? 'SKIP' : 'FAIL';
+            const detail = r.reason ? ` — ${r.reason}` : '';
+            // eslint-disable-next-line no-console
+            console.log(`[${tag}] ${s.name}${detail}`);
+            if (r.details) {
+                // eslint-disable-next-line no-console
+                console.log(`  ${JSON.stringify(r.details)}`);
+            }
+            if (r.status === 'fail')
+                failures += 1;
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(`[FAIL] ${s.name} — threw: ${err.message}`);
+            failures += 1;
+        }
+    }
+    // eslint-disable-next-line no-console
+    console.log(`\n${ALL_SCENARIOS.length} scenarios: ${ALL_SCENARIOS.length - failures} ok, ${failures} fail`);
+    process.exit(failures === 0 ? 0 : 1);
+}
+void main().catch((err) => {
+    // eslint-disable-next-line no-console
+    console.error('stress test crashed:', err);
+    process.exit(2);
+});
+//# sourceMappingURL=_stresstest.js.map

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

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

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

@@ -0,0 +1,95 @@
+/**
+ * Empty-prompt detector canary.
+ *
+ * Per Rule 3 of the path constraints (see specs/provider-portability/
+ * 05-state-detection-robustness.md): every state-detection code path that
+ * parses output from an evolving upstream system ships with a canary
+ * that verifies the detector still reads the upstream correctly, and
+ * self-heals when it doesn't.
+ *
+ * This canary runs at pool spawn (per session) and on a recurring
+ * schedule. It does NOT use the completion detector being tested —
+ * instead it uses a fixed-time wait so it can independently observe
+ * upstream drift. The flow:
+ *
+ *   1. Capture the pane buffer BEFORE sending (baseline).
+ *   2. Send a known short prompt: "reply with only the digit 7".
+ *   3. Wait a fixed window (default 20s — generous for a 1-token reply).
+ *   4. Capture the pane AFTER.
+ *   5. Verify the new content (after \ before) contains "7" — proves the
+ *      response itself completed. If not: hard failure.
+ *   6. Find the empty prompt line in the after-buffer — that's the
+ *      structural signature the detector should look for.
+ *   7. If the current signature would have detected completion on this
+ *      pane: signature is still valid, no action.
+ *   8. If not: re-derive the signature from the structurally-located
+ *      empty prompt line, set it as the new active signature. This is
+ *      the self-heal path.
+ *
+ * On hard failure (step 5: the model itself didn't respond as expected,
+ * suggesting Claude Code is in a fundamentally different state than we
+ * understand), the canary reports a DegradationReporter event. The
+ * pool refuses to bring the session up. Per Rule 3.2 this surfaces to
+ * Echo-only Telegram by default.
+ */
+import type { InteractivePool, PoolSession } from '../pool.js';
+import type { InteractivePoolConfig } from '../config.js';
+import { type EmptyPromptSignature } from './emptyPromptSignature.js';
+export interface CanaryResult {
+    status: 'pass' | 'self-healed' | 'llm-confirmed' | 'fail';
+    /** Human-readable summary for logs / DegradationReporter. */
+    message: string;
+    /** Detail about what happened, for debugging. */
+    details: {
+        /** Did the response itself include the expected token? */
+        responseContainedExpected: boolean;
+        /** Did the existing signature detect completion correctly? */
+        existingSignatureMatched: boolean;
+        /** New signature if we re-derived one. */
+        newSignature?: EmptyPromptSignature;
+        /** First line of the derived empty-prompt for diagnostics. */
+        derivedEmptyPromptLine?: string;
+        /** Captured-pane preview for hard-failure diagnostics. */
+        afterPaneTail?: string;
+        /** Was the LLM fallback consulted? */
+        llmFallbackInvoked?: boolean;
+        /** What the LLM fallback returned (if invoked). */
+        llmFallbackVerdict?: 'complete' | 'not-complete' | 'error';
+    };
+}
+/**
+ * Optional LLM fallback. When deterministic re-derivation fails (the
+ * canary captured a valid response but couldn't extract a structural
+ * empty-prompt signature from it), the canary calls this function to
+ * ask a small LLM whether the captured pane indicates Claude Code is
+ * idle. The intent is to keep the pool operational even when
+ * structural detection has failed entirely — at the cost of
+ * one Haiku-class call per re-derivation failure.
+ *
+ * Returns:
+ *   'complete'      → pane shows a completed prompt; canary marks
+ *                     llm-confirmed (no signature change, defer to
+ *                     LLM for completion detection until the next
+ *                     canary cycle when re-derivation may succeed).
+ *   'not-complete'  → pane does not show a completed prompt; canary
+ *                     hard-fails.
+ *   'error'         → LLM call itself failed; canary treats as
+ *                     not-complete (don't trust an erroring LLM).
+ */
+export type CanaryLlmFallback = (capturedPane: string, context: {
+    canaryPrompt: string;
+    canaryExpected: RegExp;
+}) => Promise<'complete' | 'not-complete' | 'error'>;
+/**
+ * Run the canary against a freshly-spawned (or running) pool session.
+ *
+ * Returns CanaryResult describing the outcome. Pool callers should treat
+ * `fail` as a fatal startup error and refuse to bring the session ready.
+ * `self-healed` and `pass` are both healthy outcomes.
+ */
+export declare function runEmptyPromptCanary(pool: InteractivePool, session: PoolSession, config: InteractivePoolConfig, options?: {
+    waitMs?: number;
+    promptSearchDepth?: number;
+    llmFallback?: CanaryLlmFallback;
+}): Promise<CanaryResult>;
+//# sourceMappingURL=emptyPromptCanary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emptyPromptCanary.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/anthropic-interactive-pool/canary/emptyPromptCanary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAuBlG,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,eAAe,GAAG,MAAM,CAAC;IAC1D,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE;QACP,0DAA0D;QAC1D,yBAAyB,EAAE,OAAO,CAAC;QACnC,8DAA8D;QAC9D,wBAAwB,EAAE,OAAO,CAAC;QAClC,0CAA0C;QAC1C,YAAY,CAAC,EAAE,oBAAoB,CAAC;QACpC,8DAA8D;QAC9D,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,0DAA0D;QAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,sCAAsC;QACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,mDAAmD;QACnD,kBAAkB,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,OAAO,CAAC;KAC5D,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,KACtD,OAAO,CAAC,UAAU,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC,GACA,OAAO,CAAC,YAAY,CAAC,CA+LvB"}

package/dist/providers/adapters/anthropic-interactive-pool/canary/emptyPromptCanary.js

@@ -0,0 +1,233 @@
+/**
+ * Empty-prompt detector canary.
+ *
+ * Per Rule 3 of the path constraints (see specs/provider-portability/
+ * 05-state-detection-robustness.md): every state-detection code path that
+ * parses output from an evolving upstream system ships with a canary
+ * that verifies the detector still reads the upstream correctly, and
+ * self-heals when it doesn't.
+ *
+ * This canary runs at pool spawn (per session) and on a recurring
+ * schedule. It does NOT use the completion detector being tested —
+ * instead it uses a fixed-time wait so it can independently observe
+ * upstream drift. The flow:
+ *
+ *   1. Capture the pane buffer BEFORE sending (baseline).
+ *   2. Send a known short prompt: "reply with only the digit 7".
+ *   3. Wait a fixed window (default 20s — generous for a 1-token reply).
+ *   4. Capture the pane AFTER.
+ *   5. Verify the new content (after \ before) contains "7" — proves the
+ *      response itself completed. If not: hard failure.
+ *   6. Find the empty prompt line in the after-buffer — that's the
+ *      structural signature the detector should look for.
+ *   7. If the current signature would have detected completion on this
+ *      pane: signature is still valid, no action.
+ *   8. If not: re-derive the signature from the structurally-located
+ *      empty prompt line, set it as the new active signature. This is
+ *      the self-heal path.
+ *
+ * On hard failure (step 5: the model itself didn't respond as expected,
+ * suggesting Claude Code is in a fundamentally different state than we
+ * understand), the canary reports a DegradationReporter event. The
+ * pool refuses to bring the session up. Per Rule 3.2 this surfaces to
+ * Echo-only Telegram by default.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { getSignature, setSignature } from './emptyPromptSignature.js';
+const execFileAsync = promisify(execFile);
+/**
+ * The canary prompt — short, deterministic, model-agnostic.
+ *
+ * Token choice rationale: must be a string that's extremely unlikely to
+ * appear in Claude Code's welcome banner or status bar (otherwise the
+ * "after contains token, before doesn't" check false-negatives). The
+ * banner contains "Opus 4.7", "Claude Max", etc. — so plain digits and
+ * common English fail. A made-up uppercase compound with no spaces is
+ * cheap, instructable, and not in any UI chrome.
+ */
+const CANARY_PROMPT = 'Reply with only the literal text PONGXYZ. Do not include any other text, punctuation, quotes, or explanation.';
+const CANARY_EXPECTED = /PONGXYZ/;
+/** Wait window for canary completion (ms). Generous for a 1-token reply. */
+const CANARY_WAIT_MS = 20_000;
+/** Total pane height in lines to inspect for the empty-prompt position. */
+const PROMPT_SEARCH_DEPTH = 30;
+/**
+ * Run the canary against a freshly-spawned (or running) pool session.
+ *
+ * Returns CanaryResult describing the outcome. Pool callers should treat
+ * `fail` as a fatal startup error and refuse to bring the session ready.
+ * `self-healed` and `pass` are both healthy outcomes.
+ */
+export async function runEmptyPromptCanary(pool, session, config, options) {
+    const waitMs = options?.waitMs ?? CANARY_WAIT_MS;
+    const searchDepth = options?.promptSearchDepth ?? PROMPT_SEARCH_DEPTH;
+    // Step 1: baseline
+    const beforeBuf = (await pool.capturePane(session.tmuxName, searchDepth)) ?? '';
+    // Step 2: send canary prompt
+    try {
+        await execFileAsync(config.tmuxPath, ['send-keys', '-t', `=${session.tmuxName}:`, '-l', CANARY_PROMPT], { timeout: 5000 });
+        await new Promise((resolve) => setTimeout(resolve, 300));
+        await execFileAsync(config.tmuxPath, ['send-keys', '-t', `=${session.tmuxName}:`, 'Enter'], { timeout: 5000 });
+    }
+    catch (err) {
+        return {
+            status: 'fail',
+            message: `canary failed at send-keys: ${err.message}`,
+            details: { responseContainedExpected: false, existingSignatureMatched: false },
+        };
+    }
+    // Step 3: fixed-time wait (canary deliberately does NOT use the detector
+    // being tested — it watches from outside).
+    await new Promise((resolve) => setTimeout(resolve, waitMs));
+    // Step 4: capture after
+    const afterBuf = (await pool.capturePane(session.tmuxName, searchDepth)) ?? '';
+    // Step 5: verify the response contains the expected token. The simplest
+    // check that's robust across UI rearrangement: just search the whole
+    // after-buffer for the token. If it's not there, the response itself
+    // didn't happen and we can't trust anything downstream.
+    const responseContainedExpected = CANARY_EXPECTED.test(afterBuf) && !CANARY_EXPECTED.test(beforeBuf);
+    if (!responseContainedExpected) {
+        return {
+            status: 'fail',
+            message: 'canary response did not contain the expected token — upstream may have changed '
+                + 'response format or the model didn\'t reply in the wait window',
+            details: {
+                responseContainedExpected: false,
+                existingSignatureMatched: false,
+                afterPaneTail: afterBuf.split('\n').slice(-15).join('\n'),
+            },
+        };
+    }
+    // Step 6: structurally find the empty-prompt line in the after-buffer.
+    // We walk from the bottom up looking for any line that LOOKS like a
+    // prompt line — heuristically: not blank, not a horizontal rule, and
+    // not the status bar (which contains the static UI strings). The most
+    // recent prompt line after a completed response should be the empty
+    // one (Claude Code's "your turn again" cue).
+    const lines = afterBuf.split('\n');
+    let derivedEmptyPromptLine;
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (trimmed === '')
+            continue;
+        // Skip horizontal rule lines.
+        if (/^[─━=_-]{5,}$/.test(trimmed))
+            continue;
+        // Skip the status bar — recognized by containing one of the legacy idle markers.
+        if (config.idleMarkers.some((m) => line.includes(m)))
+            continue;
+        // First non-blank, non-rule, non-status-bar line from the bottom is
+        // our candidate for the empty-prompt line.
+        derivedEmptyPromptLine = line;
+        break;
+    }
+    // Step 7: does the existing signature detect completion on this pane?
+    const existingSig = getSignature();
+    const existingSignatureMatched = lines.some((l) => existingSig.emptyPromptPattern.test(l));
+    if (existingSignatureMatched) {
+        return {
+            status: 'pass',
+            message: 'canary passed; existing empty-prompt signature is valid',
+            details: { responseContainedExpected: true, existingSignatureMatched: true },
+        };
+    }
+    // Step 8: re-derive. Try to extract a regex from the derived empty-prompt
+    // line. The simplest robust thing: match the first non-whitespace char
+    // as a literal, followed by optional whitespace to end of line.
+    //
+    // If structural re-derivation fails AND an LLM fallback is configured,
+    // ask the small model to tell us whether the pane indicates idle. This
+    // keeps the pool operational on truly novel UI shapes at the cost of
+    // one Haiku-class call per re-derivation failure (rare on stable
+    // upstream).
+    async function maybeLlmFallback(reason) {
+        if (!options?.llmFallback) {
+            return {
+                status: 'fail',
+                message: `${reason} (no LLM fallback configured)`,
+                details: {
+                    responseContainedExpected: true,
+                    existingSignatureMatched: false,
+                    afterPaneTail: lines.slice(-15).join('\n'),
+                    derivedEmptyPromptLine,
+                    llmFallbackInvoked: false,
+                },
+            };
+        }
+        let verdict;
+        try {
+            verdict = await options.llmFallback(afterBuf, {
+                canaryPrompt: CANARY_PROMPT,
+                canaryExpected: CANARY_EXPECTED,
+            });
+        }
+        catch {
+            verdict = 'error';
+        }
+        if (verdict === 'complete') {
+            return {
+                status: 'llm-confirmed',
+                message: `${reason}; LLM fallback confirmed the pane shows a completed prompt — `
+                    + 'pool stays operational, but signature was not auto-derived; rerun canary later',
+                details: {
+                    responseContainedExpected: true,
+                    existingSignatureMatched: false,
+                    derivedEmptyPromptLine,
+                    llmFallbackInvoked: true,
+                    llmFallbackVerdict: 'complete',
+                },
+            };
+        }
+        return {
+            status: 'fail',
+            message: `${reason}; LLM fallback verdict: ${verdict}`,
+            details: {
+                responseContainedExpected: true,
+                existingSignatureMatched: false,
+                afterPaneTail: lines.slice(-15).join('\n'),
+                derivedEmptyPromptLine,
+                llmFallbackInvoked: true,
+                llmFallbackVerdict: verdict,
+            },
+        };
+    }
+    if (!derivedEmptyPromptLine) {
+        return await maybeLlmFallback('response succeeded but no empty-prompt line could be derived from the after-buffer — '
+            + 'upstream may have restructured its UI past recognition');
+    }
+    const firstChar = derivedEmptyPromptLine.trim()[0];
+    if (!firstChar) {
+        return await maybeLlmFallback('derived empty-prompt line was effectively blank — cannot self-heal');
+    }
+    // Build new patterns from the derived char. The "empty" pattern matches
+    // the char followed by only-whitespace; the "any prompt line" pattern
+    // matches the char followed by either whitespace or EOL.
+    const charEsc = firstChar.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const newSig = {
+        emptyPromptPattern: new RegExp(`^${charEsc}\\s*$`),
+        anyPromptLinePattern: new RegExp(`^${charEsc}(\\s|$)`),
+        source: 'canary-derived',
+        derivedAt: new Date().toISOString(),
+    };
+    // Verify the new pattern actually matches the derived line.
+    // Sanity check against deriving a pattern that doesn't even match
+    // its own source; falls through to LLM fallback (if configured)
+    // because we can't safely install a broken pattern.
+    if (!newSig.emptyPromptPattern.test(derivedEmptyPromptLine)) {
+        return await maybeLlmFallback(`derived pattern does not match its own derivation line: ${JSON.stringify(derivedEmptyPromptLine)}`);
+    }
+    setSignature(newSig);
+    return {
+        status: 'self-healed',
+        message: `empty-prompt signature re-derived from canary output; new prompt char detected: ${JSON.stringify(firstChar)}`,
+        details: {
+            responseContainedExpected: true,
+            existingSignatureMatched: false,
+            derivedEmptyPromptLine,
+            newSignature: newSig,
+        },
+    };
+}
+//# sourceMappingURL=emptyPromptCanary.js.map

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * Empty-prompt detector signature store with optional disk persistence.
+ *
+ * The completion-detector in promptRunner.ts reads from here to decide
+ * what to look for in the bottom of the pane buffer when checking
+ * whether Claude Code is at a ready prompt. The default pattern matches
+ * Claude Code's current `❯` glyph; the canary (see {@link emptyPromptCanary})
+ * can re-derive the pattern at startup if the upstream UI evolves and
+ * persist the new signature so future processes inherit it.
+ *
+ * Per Rule 3 of the path constraints (see specs/provider-portability/
+ * 05-state-detection-robustness.md): deterministic state-detection code
+ * against an evolving upstream must self-heal rather than silently fail,
+ * and a self-healed signature should survive process restart so the
+ * recovery cost is paid once, not every boot.
+ */
+export type SignatureSource = 'default' | 'canary-derived';
+export interface EmptyPromptSignature {
+    /** Regex matching an empty (ready-state) prompt line. */
+    emptyPromptPattern: RegExp;
+    /** Regex matching ANY prompt line (empty or with content) — used to find the most recent prompt line. */
+    anyPromptLinePattern: RegExp;
+    /** Where this signature came from. */
+    source: SignatureSource;
+    /** When this signature was derived (ISO timestamp). */
+    derivedAt: string;
+}
+/**
+ * Attempt to load a persisted signature from disk. Idempotent; only
+ * runs the disk read once per process unless `force` is true. Silently
+ * falls back to the default on any error (file absent, parse failure,
+ * regex compile failure, schema mismatch) — persistence is an
+ * optimization, not a correctness path; the canary still runs at
+ * startup and will overwrite anything stale.
+ */
+export declare function loadPersistedSignature(force?: boolean): EmptyPromptSignature;
+/** Read the currently-active signature. The completion detector calls this. */
+export declare function getSignature(): EmptyPromptSignature;
+/**
+ * Replace the active signature. Called by the canary when it derives a
+ * new pattern from a known input/output pair. Writes the new signature
+ * to disk best-effort so future processes inherit it; disk failure is
+ * non-fatal (the in-process store still has the new signature, and the
+ * canary re-runs at next startup).
+ */
+export declare function setSignature(sig: Omit<EmptyPromptSignature, 'derivedAt'>): void;
+/**
+ * Test helper — reset to default AND remove any persisted file in the
+ * current state directory. Tests that exercise persistence should set
+ * `INSTAR_PROVIDER_STATE_DIR` to a tmpdir before invoking.
+ */
+export declare function resetSignatureForTests(): void;
+//# sourceMappingURL=emptyPromptSignature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emptyPromptSignature.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/anthropic-interactive-pool/canary/emptyPromptSignature.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAUH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yGAAyG;IACzG,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sCAAsC;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAsCD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,UAAQ,GAAG,oBAAoB,CAoB1E;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,IAAI,oBAAoB,CAGnD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,GAAG,IAAI,CAmB/E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAQ7C"}