instar 0.28.113 → 0.28.115

package/dist/providers/parity/runner.js

@@ -0,0 +1,96 @@
+/**
+ * Behavior-parity test runner.
+ *
+ * Phase 2 conformance suites verify a single adapter's contract shape.
+ * Phase 3c parity scenarios go one level deeper: given TWO adapters that
+ * claim the same capability, send identical inputs to both and assert
+ * observable equivalence.
+ *
+ * This catches drift between sibling adapters (e.g. anthropic-headless vs
+ * anthropic-interactive-pool) where each correctly implements the
+ * primitive contract in isolation but their externally-observable behavior
+ * disagrees on edge cases — empty prompts, control characters, very long
+ * outputs, error shapes, cancellation semantics.
+ *
+ * Design notes:
+ *   - Scenarios are async functions that receive a ParityHarness and
+ *     return a ParityResult describing what they observed.
+ *   - The runner orchestrates lifecycle (start / dispose) for both
+ *     adapters and aggregates results.
+ *   - "Equivalent" is scenario-defined — scenarios assert structural
+ *     equivalence (same error class, same response length bucket) rather
+ *     than literal string equality, because LLM outputs aren't
+ *     deterministic.
+ *   - Real-API scenarios are gated by ctx.realApi; structural-only
+ *     scenarios (capability-flag presence, primitive instantiation)
+ *     always run.
+ */
+/**
+ * Run every scenario against the pair of adapters and aggregate results.
+ *
+ * Adapter lifecycle: start() called once before scenarios (if defined),
+ * dispose() called once after (if defined). Scenarios run sequentially —
+ * concurrent execution against pool-backed adapters can cause queueing
+ * effects that confound parity comparisons.
+ */
+export async function runParitySuite(harness, scenarios) {
+    const { left, right, ctx } = harness;
+    try {
+        await left.start?.();
+        await right.start?.();
+    }
+    catch (err) {
+        return [
+            {
+                scenario: '_startup',
+                status: 'fail',
+                reason: `adapter start() failed: ${err.message}`,
+            },
+        ];
+    }
+    const results = [];
+    for (const { name, run } of scenarios) {
+        if (ctx.skipPatterns?.some((p) => p.test(name))) {
+            results.push({ scenario: name, status: 'skip', reason: 'skip-pattern match' });
+            continue;
+        }
+        try {
+            const r = await run(harness);
+            results.push({ ...r, scenario: name });
+        }
+        catch (err) {
+            results.push({
+                scenario: name,
+                status: 'fail',
+                reason: `scenario threw: ${err.message}`,
+            });
+        }
+    }
+    try {
+        await left.dispose?.();
+        await right.dispose?.();
+    }
+    catch {
+        // Dispose errors don't invalidate scenario results.
+    }
+    return results;
+}
+/**
+ * Pretty-print a parity result set to stdout. Returns process exit code
+ * (0 if all pass-or-skip, 1 if any fail).
+ */
+export function reportParityResults(results) {
+    let failures = 0;
+    for (const r of results) {
+        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}] ${r.scenario}${detail}`);
+        if (r.status === 'fail')
+            failures += 1;
+    }
+    // eslint-disable-next-line no-console
+    console.log(`\n${results.length} scenario(s): ${results.length - failures} ok, ${failures} fail`);
+    return failures === 0 ? 0 : 1;
+}
+//# sourceMappingURL=runner.js.map

package/dist/providers/parity/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/providers/parity/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAkCH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAsB,EACtB,SAA+D;IAE/D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL;gBACE,QAAQ,EAAE,UAAU;gBACpB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,2BAA4B,GAAa,CAAC,OAAO,EAAE;aAC5D;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,SAAS,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;YAC/E,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,mBAAoB,GAAa,CAAC,OAAO,EAAE;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACvB,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAoC;IACtE,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACjF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,QAAQ,GAAG,MAAM,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;YAAE,QAAQ,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,iBAAiB,OAAO,CAAC,MAAM,GAAG,QAAQ,QAAQ,QAAQ,OAAO,CAAC,CAAC;IAClG,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/providers/parity/scenarios/capabilityOverlap.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Parity scenarios for the capability-declaration surface.
+ *
+ * Never hits a provider — always runs. Verifies that both adapters
+ * declare overlapping capabilities consistently:
+ *   - Same CapabilityFlag set claimed by both (excepting deliberate
+ *     STUB-only on one side and real on the other)
+ *   - Both adapters' `id` strings are distinct (so the registry can
+ *     differentiate them)
+ *   - Calling .primitive() with a claimed capability returns a
+ *     non-undefined value (real or throwing stub)
+ */
+import type { ParityScenario } from '../runner.js';
+export declare const distinctIds: ParityScenario;
+export declare const sharedCapabilitiesInstantiate: ParityScenario;
+export declare const capabilityOverlapScenarios: readonly [{
+    readonly name: "capability/distinctIds";
+    readonly run: ParityScenario;
+}, {
+    readonly name: "capability/sharedCapabilitiesInstantiate";
+    readonly run: ParityScenario;
+}];
+//# sourceMappingURL=capabilityOverlap.d.ts.map

package/dist/providers/parity/scenarios/capabilityOverlap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityOverlap.d.ts","sourceRoot":"","sources":["../../../../src/providers/parity/scenarios/capabilityOverlap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAgBnD,eAAO,MAAM,WAAW,EAAE,cAKzB,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,cA4D3C,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;EAG7B,CAAC"}

package/dist/providers/parity/scenarios/capabilityOverlap.js

@@ -0,0 +1,100 @@
+/**
+ * Parity scenarios for the capability-declaration surface.
+ *
+ * Never hits a provider — always runs. Verifies that both adapters
+ * declare overlapping capabilities consistently:
+ *   - Same CapabilityFlag set claimed by both (excepting deliberate
+ *     STUB-only on one side and real on the other)
+ *   - Both adapters' `id` strings are distinct (so the registry can
+ *     differentiate them)
+ *   - Calling .primitive() with a claimed capability returns a
+ *     non-undefined value (real or throwing stub)
+ */
+import { CapabilityFlag } from '../../capabilities.js';
+import { isStubPrimitive } from '../../markers.js';
+/**
+ * Sub-capability flags are declarative markers (asymmetric features
+ * provider X has and Y doesn't). They are NOT retrievable as primitives
+ * via adapter.primitive(); they modify the behavior of OTHER primitives.
+ * The instantiation parity check must exclude these.
+ */
+const SUB_CAPABILITY_FLAGS = new Set([
+    CapabilityFlag.PublicUsageApi,
+    CapabilityFlag.PreCompactHook,
+    CapabilityFlag.SubagentLifecycleHooks,
+    CapabilityFlag.NativeIdleBound,
+    CapabilityFlag.StructuredApprovalEvents,
+]);
+export const distinctIds = async ({ left, right }) => {
+    if (left.id === right.id) {
+        return { scenario: '', status: 'fail', reason: `both adapters share id "${left.id}"` };
+    }
+    return { scenario: '', status: 'pass', observations: { left: left.id, right: right.id } };
+};
+export const sharedCapabilitiesInstantiate = async ({ left, right }) => {
+    const sharedCaps = [];
+    for (const cap of left.capabilities) {
+        if (right.capabilities.has(cap) && !SUB_CAPABILITY_FLAGS.has(cap)) {
+            sharedCaps.push(cap);
+        }
+    }
+    if (sharedCaps.length === 0) {
+        return { scenario: '', status: 'fail', reason: 'no capabilities shared between adapters' };
+    }
+    const failures = [];
+    let bothReal = 0;
+    let bothStub = 0;
+    for (const cap of sharedCaps) {
+        let lp;
+        let rp;
+        try {
+            lp = left.primitive(cap);
+            rp = right.primitive(cap);
+        }
+        catch (err) {
+            failures.push(`${String(cap)} threw on primitive(): ${err.message}`);
+            continue;
+        }
+        if (lp == null) {
+            failures.push(`left.${String(cap)} returned nullish`);
+            continue;
+        }
+        if (rp == null) {
+            failures.push(`right.${String(cap)} returned nullish`);
+            continue;
+        }
+        // Bug D: mixed real/stub on a shared capability is a lie — the
+        // adapter that stubbed it is claiming a capability it doesn't
+        // actually implement. Catch this here rather than at first-use.
+        const lIsStub = isStubPrimitive(lp);
+        const rIsStub = isStubPrimitive(rp);
+        if (lIsStub && rIsStub) {
+            bothStub += 1;
+        }
+        else if (lIsStub !== rIsStub) {
+            failures.push(`${String(cap)} declared shared but mixed real/stub: `
+                + `${left.id}=${lIsStub ? 'stub' : 'real'}, ${right.id}=${rIsStub ? 'stub' : 'real'}`);
+        }
+        else {
+            bothReal += 1;
+        }
+    }
+    if (failures.length > 0) {
+        return {
+            scenario: '',
+            status: 'fail',
+            reason: failures.join('; '),
+            observations: { sharedCount: sharedCaps.length, bothReal, bothStub, failures: failures.length },
+        };
+    }
+    return {
+        scenario: '',
+        status: 'pass',
+        observations: { sharedCount: sharedCaps.length, bothReal, bothStub },
+    };
+};
+export const capabilityOverlapScenarios = [
+    { name: 'capability/distinctIds', run: distinctIds },
+    { name: 'capability/sharedCapabilitiesInstantiate', run: sharedCapabilitiesInstantiate },
+];
+//# sourceMappingURL=capabilityOverlap.js.map

package/dist/providers/parity/scenarios/capabilityOverlap.js.map

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

package/dist/providers/parity/scenarios/oneShotCompletion.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Parity scenarios for OneShotCompletion.
+ *
+ * Both adapters claim CapabilityFlag.OneShotCompletion. These scenarios
+ * exercise structural equivalence and (when realApi=1) behavioral
+ * equivalence on a small fixed-cost prompt set.
+ */
+import type { ParityScenario } from '../runner.js';
+/**
+ * Both adapters expose a callable OneShotCompletion primitive.
+ *
+ * Always runs (no real API). Catches catastrophic misregistration where
+ * one adapter forgot to wire the primitive into its impls map.
+ */
+export declare const primitiveShape: ParityScenario;
+/**
+ * Both adapters return a structurally-equivalent OneShotCompletionResult
+ * for an arithmetic prompt. Equivalence means: both responses contain
+ * "4", both have a `usage` field (possibly null), both have `text` as
+ * non-empty trimmed string.
+ *
+ * Gated by realApi. Cost: 2 prompts (one per adapter) of ~20 tokens each.
+ */
+export declare const arithmeticParity: ParityScenario;
+/**
+ * Both adapters honor an AbortSignal and surface the cancellation as a
+ * thrown error rather than resolving with a partial response.
+ *
+ * Gated by realApi. Cost: 2 short prompts that get aborted immediately.
+ */
+export declare const abortSignalParity: ParityScenario;
+/**
+ * Full OneShotCompletion parity scenario set. Adapter packages import
+ * this and pass to runParitySuite.
+ */
+export declare const oneShotCompletionScenarios: readonly [{
+    readonly name: "oneShot/primitiveShape";
+    readonly run: ParityScenario;
+}, {
+    readonly name: "oneShot/arithmeticParity";
+    readonly run: ParityScenario;
+}, {
+    readonly name: "oneShot/abortSignalParity";
+    readonly run: ParityScenario;
+}];
+//# sourceMappingURL=oneShotCompletion.d.ts.map

package/dist/providers/parity/scenarios/oneShotCompletion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneShotCompletion.d.ts","sourceRoot":"","sources":["../../../../src/providers/parity/scenarios/oneShotCompletion.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,cAa5B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAwC9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAgC/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;EAI7B,CAAC"}

package/dist/providers/parity/scenarios/oneShotCompletion.js

@@ -0,0 +1,127 @@
+/**
+ * Parity scenarios for OneShotCompletion.
+ *
+ * Both adapters claim CapabilityFlag.OneShotCompletion. These scenarios
+ * exercise structural equivalence and (when realApi=1) behavioral
+ * equivalence on a small fixed-cost prompt set.
+ */
+import { CapabilityFlag } from '../../capabilities.js';
+const ARITHMETIC_PROMPT = 'What is 2+2? Reply with only the number, no other text.';
+function getOneShot(adapter) {
+    return adapter.primitive(CapabilityFlag.OneShotCompletion);
+}
+/**
+ * Both adapters expose a callable OneShotCompletion primitive.
+ *
+ * Always runs (no real API). Catches catastrophic misregistration where
+ * one adapter forgot to wire the primitive into its impls map.
+ */
+export const primitiveShape = async ({ left, right }) => {
+    const l = getOneShot(left);
+    const r = getOneShot(right);
+    if (l.capability !== CapabilityFlag.OneShotCompletion) {
+        return { scenario: '', status: 'fail', reason: `left capability flag wrong: ${String(l.capability)}` };
+    }
+    if (r.capability !== CapabilityFlag.OneShotCompletion) {
+        return { scenario: '', status: 'fail', reason: `right capability flag wrong: ${String(r.capability)}` };
+    }
+    if (typeof l.evaluate !== 'function' || typeof r.evaluate !== 'function') {
+        return { scenario: '', status: 'fail', reason: 'evaluate method missing on one side' };
+    }
+    return { scenario: '', status: 'pass' };
+};
+/**
+ * Both adapters return a structurally-equivalent OneShotCompletionResult
+ * for an arithmetic prompt. Equivalence means: both responses contain
+ * "4", both have a `usage` field (possibly null), both have `text` as
+ * non-empty trimmed string.
+ *
+ * Gated by realApi. Cost: 2 prompts (one per adapter) of ~20 tokens each.
+ */
+export const arithmeticParity = async ({ left, right, ctx }) => {
+    if (!ctx.realApi) {
+        return { scenario: '', status: 'skip', reason: 'realApi disabled' };
+    }
+    const l = getOneShot(left);
+    const r = getOneShot(right);
+    const timeoutMs = ctx.timeoutMs ?? 120_000;
+    let leftRes;
+    let rightRes;
+    try {
+        leftRes = await l.evaluate(ARITHMETIC_PROMPT, { timeoutMs, model: 'fast' });
+    }
+    catch (err) {
+        return { scenario: '', status: 'fail', reason: `left evaluate threw: ${err.message}` };
+    }
+    try {
+        rightRes = await r.evaluate(ARITHMETIC_PROMPT, { timeoutMs, model: 'fast' });
+    }
+    catch (err) {
+        return { scenario: '', status: 'fail', reason: `right evaluate threw: ${err.message}` };
+    }
+    const observations = {
+        left: { text: leftRes.text, hasUsage: leftRes.usage !== null },
+        right: { text: rightRes.text, hasUsage: rightRes.usage !== null },
+    };
+    if (typeof leftRes.text !== 'string' || leftRes.text.length === 0) {
+        return { scenario: '', status: 'fail', reason: 'left text empty', observations };
+    }
+    if (typeof rightRes.text !== 'string' || rightRes.text.length === 0) {
+        return { scenario: '', status: 'fail', reason: 'right text empty', observations };
+    }
+    if (!/4/.test(leftRes.text) || !/4/.test(rightRes.text)) {
+        return { scenario: '', status: 'fail', reason: 'response missing "4"', observations };
+    }
+    // usage field SHOULD be present-or-null on both (structural equivalence)
+    if (!('usage' in leftRes) || !('usage' in rightRes)) {
+        return { scenario: '', status: 'fail', reason: 'usage field missing on result', observations };
+    }
+    return { scenario: '', status: 'pass', observations };
+};
+/**
+ * Both adapters honor an AbortSignal and surface the cancellation as a
+ * thrown error rather than resolving with a partial response.
+ *
+ * Gated by realApi. Cost: 2 short prompts that get aborted immediately.
+ */
+export const abortSignalParity = async ({ left, right, ctx }) => {
+    if (!ctx.realApi) {
+        return { scenario: '', status: 'skip', reason: 'realApi disabled' };
+    }
+    const l = getOneShot(left);
+    const r = getOneShot(right);
+    async function abortImmediately(p) {
+        const controller = new AbortController();
+        // Abort before evaluate runs — should surface as an error or never resolve.
+        controller.abort();
+        try {
+            const result = await Promise.race([
+                p.evaluate(ARITHMETIC_PROMPT, { signal: controller.signal, timeoutMs: 5_000 }),
+                new Promise((_, rej) => setTimeout(() => rej(new Error('did-not-abort')), 5_000)),
+            ]);
+            return `resolved:${result.text.slice(0, 20)}`;
+        }
+        catch (err) {
+            return `threw:${err.name}`;
+        }
+    }
+    const leftOutcome = await abortImmediately(l);
+    const rightOutcome = await abortImmediately(r);
+    const observations = { left: leftOutcome, right: rightOutcome };
+    // Both should throw, not resolve. Specific error class may differ across
+    // adapters but neither should return a fabricated successful response.
+    if (leftOutcome.startsWith('resolved:') || rightOutcome.startsWith('resolved:')) {
+        return { scenario: '', status: 'fail', reason: 'one side ignored abort and resolved', observations };
+    }
+    return { scenario: '', status: 'pass', observations };
+};
+/**
+ * Full OneShotCompletion parity scenario set. Adapter packages import
+ * this and pass to runParitySuite.
+ */
+export const oneShotCompletionScenarios = [
+    { name: 'oneShot/primitiveShape', run: primitiveShape },
+    { name: 'oneShot/arithmeticParity', run: arithmeticParity },
+    { name: 'oneShot/abortSignalParity', run: abortSignalParity },
+];
+//# sourceMappingURL=oneShotCompletion.js.map

package/dist/providers/parity/scenarios/oneShotCompletion.js.map

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

package/dist/providers/parity/scenarios/sessionId.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Parity scenarios for SessionId.
+ *
+ * Both adapters expose CapabilityFlag.SessionId. The handle format is
+ * adapter-specific (anthropic-headless uses `anthropic-headless/<tmux>`;
+ * the pool uses `anthropic-interactive-pool/<poolId>`), but the
+ * resolution contract is the same: given a handle the adapter issued,
+ * return a non-empty provider UUID string or null.
+ *
+ * Structural-only — does not hit the provider.
+ */
+import type { ParityScenario } from '../runner.js';
+export declare const sessionIdShape: ParityScenario;
+/**
+ * An invalid handle resolves to null on both adapters rather than throwing.
+ * Adapters MAY throw on cross-adapter handle leakage; here we use a
+ * syntactically-invalid handle to assert the "unknown handle → null"
+ * branch rather than the validation branch.
+ */
+export declare const sessionIdUnknownHandle: ParityScenario;
+export declare const sessionIdScenarios: readonly [{
+    readonly name: "sessionId/shape";
+    readonly run: ParityScenario;
+}, {
+    readonly name: "sessionId/unknownHandle";
+    readonly run: ParityScenario;
+}];
+//# sourceMappingURL=sessionId.d.ts.map

package/dist/providers/parity/scenarios/sessionId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionId.d.ts","sourceRoot":"","sources":["../../../../src/providers/parity/scenarios/sessionId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnD,eAAO,MAAM,cAAc,EAAE,cAe5B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,cA4BpC,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;EAGrB,CAAC"}

package/dist/providers/parity/scenarios/sessionId.js

@@ -0,0 +1,71 @@
+/**
+ * Parity scenarios for SessionId.
+ *
+ * Both adapters expose CapabilityFlag.SessionId. The handle format is
+ * adapter-specific (anthropic-headless uses `anthropic-headless/<tmux>`;
+ * the pool uses `anthropic-interactive-pool/<poolId>`), but the
+ * resolution contract is the same: given a handle the adapter issued,
+ * return a non-empty provider UUID string or null.
+ *
+ * Structural-only — does not hit the provider.
+ */
+import { CapabilityFlag } from '../../capabilities.js';
+function getSessionId(adapter) {
+    return adapter.primitive(CapabilityFlag.SessionId);
+}
+export const sessionIdShape = async ({ left, right }) => {
+    const l = getSessionId(left);
+    const r = getSessionId(right);
+    if (l.capability !== CapabilityFlag.SessionId || r.capability !== CapabilityFlag.SessionId) {
+        return { scenario: '', status: 'fail', reason: 'wrong capability flag on SessionId primitive' };
+    }
+    if (typeof l.providerIdFor !== 'function' ||
+        typeof r.providerIdFor !== 'function' ||
+        typeof l.handleFor !== 'function' ||
+        typeof r.handleFor !== 'function') {
+        return { scenario: '', status: 'fail', reason: 'providerIdFor or handleFor method missing' };
+    }
+    return { scenario: '', status: 'pass' };
+};
+/**
+ * An invalid handle resolves to null on both adapters rather than throwing.
+ * Adapters MAY throw on cross-adapter handle leakage; here we use a
+ * syntactically-invalid handle to assert the "unknown handle → null"
+ * branch rather than the validation branch.
+ */
+export const sessionIdUnknownHandle = async ({ left, right }) => {
+    const l = getSessionId(left);
+    const r = getSessionId(right);
+    // Use a handle that's syntactically plausible for neither adapter
+    // (no `/` prefix that matches either adapter id).
+    const bogus = '__parity_bogus_handle__';
+    let leftOutcome;
+    let rightOutcome;
+    try {
+        const out = await l.providerIdFor(bogus);
+        leftOutcome = out === null ? 'null' : `value:${out}`;
+    }
+    catch (err) {
+        leftOutcome = `threw:${err.name}`;
+    }
+    try {
+        const out = await r.providerIdFor(bogus);
+        rightOutcome = out === null ? 'null' : `value:${out}`;
+    }
+    catch (err) {
+        rightOutcome = `threw:${err.name}`;
+    }
+    const observations = { left: leftOutcome, right: rightOutcome };
+    // Adapters may either return null OR throw. Both are valid responses
+    // to a bogus handle. The parity assertion is just "don't fabricate a
+    // UUID for nothing."
+    if (leftOutcome.startsWith('value:') || rightOutcome.startsWith('value:')) {
+        return { scenario: '', status: 'fail', reason: 'fabricated UUID for unknown handle', observations };
+    }
+    return { scenario: '', status: 'pass', observations };
+};
+export const sessionIdScenarios = [
+    { name: 'sessionId/shape', run: sessionIdShape },
+    { name: 'sessionId/unknownHandle', run: sessionIdUnknownHandle },
+];
+//# sourceMappingURL=sessionId.js.map

package/dist/providers/parity/scenarios/sessionId.js.map

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

package/dist/providers/primitives/capability/bashExecution.d.ts

@@ -0,0 +1,53 @@
+/**
+ * BashExecution — agent's ability to invoke shell commands.
+ *
+ * Maps to:
+ *   - Claude: built-in `Bash` tool (governed by ToolAllowlist + permissions)
+ *   - Codex: built-in `Bash` / `apply_patch` (sandboxed via command/exec);
+ *     unsandboxed via experimental `process/spawn`
+ *
+ * Distinct from `ToolAccess.kind === 'bash'` because shell access is
+ * elevated-risk: even if a session has shell capability, the caller
+ * typically wants to gate WHICH commands are runnable, optionally restrict
+ * env vars, and require approval for destructive operations.
+ */
+import { CapabilityFlag } from '../../capabilities.js';
+export interface BashExecution {
+    readonly capability: typeof CapabilityFlag.BashExecution;
+    /** Build a portable bash-execution spec for session establishment. */
+    buildSpec(rules: BashExecutionRules): BashExecutionSpec;
+    /**
+     * Whether the provider distinguishes sandboxed from unsandboxed shell.
+     * If true, `BashExecutionRules.allowUnsandboxed` is honored; if false,
+     * the field is ignored and the session uses the provider's only mode.
+     */
+    supportsSandboxModes(): boolean;
+}
+export interface BashExecutionRules {
+    /**
+     * Allowed commands by name or glob. Adapter matches against the leading
+     * token of each `Bash` invocation. Empty array = no commands allowed
+     * (i.e., disable shell entirely). Omitted = all commands allowed.
+     */
+    allowedCommands?: ReadonlyArray<string>;
+    /** Commands always denied even if in allowedCommands. Deny wins. */
+    deniedCommands?: ReadonlyArray<string>;
+    /**
+     * Whether commands run in the sandbox or have unfettered host access.
+     * Applies only when provider supports both modes (see supportsSandboxModes).
+     */
+    allowUnsandboxed?: boolean;
+    /**
+     * Environment-variable policy. 'clean' = empty env. 'trimmed' = only
+     * the variables the adapter deems safe. 'pass-through' = inherit from
+     * parent process. Default: 'trimmed'.
+     */
+    envPolicy?: 'clean' | 'trimmed' | 'pass-through';
+    /** Per-command timeout in milliseconds. */
+    perCommandTimeoutMs?: number;
+}
+export type BashExecutionSpec = Readonly<{
+    readonly __brand: 'BashExecutionSpec';
+    readonly rules: BashExecutionRules;
+}>;
+//# sourceMappingURL=bashExecution.d.ts.map

package/dist/providers/primitives/capability/bashExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashExecution.d.ts","sourceRoot":"","sources":["../../../../src/providers/primitives/capability/bashExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,cAAc,CAAC,aAAa,CAAC;IAEzD,sEAAsE;IACtE,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,CAAC;IAExD;;;;OAIG;IACH,oBAAoB,IAAI,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,oEAAoE;IACpE,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,cAAc,CAAC;IACjD,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;CACpC,CAAC,CAAC"}

package/dist/providers/primitives/capability/bashExecution.js

@@ -0,0 +1,15 @@
+/**
+ * BashExecution — agent's ability to invoke shell commands.
+ *
+ * Maps to:
+ *   - Claude: built-in `Bash` tool (governed by ToolAllowlist + permissions)
+ *   - Codex: built-in `Bash` / `apply_patch` (sandboxed via command/exec);
+ *     unsandboxed via experimental `process/spawn`
+ *
+ * Distinct from `ToolAccess.kind === 'bash'` because shell access is
+ * elevated-risk: even if a session has shell capability, the caller
+ * typically wants to gate WHICH commands are runnable, optionally restrict
+ * env vars, and require approval for destructive operations.
+ */
+export {};
+//# sourceMappingURL=bashExecution.js.map

package/dist/providers/primitives/capability/bashExecution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashExecution.js","sourceRoot":"","sources":["../../../../src/providers/primitives/capability/bashExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}