instar 0.28.113 → 0.28.115

package/dist/providers/adapters/openai-codex/transport/codexSpawn.js.map

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

package/dist/providers/adapters/openai-codex/transport/oneShotCompletion.d.ts

@@ -0,0 +1,11 @@
+/**
+ * OneShotCompletion implementation for the openai-codex adapter.
+ *
+ * Spawns `codex exec PROMPT --skip-git-repo-check --ephemeral -s read-only
+ * --output-last-message <tmpfile>` and reads the final agent message from
+ * the file. Direct analog of `claude -p` for the headless Anthropic adapter.
+ */
+import type { OneShotCompletion } from '../../../primitives/transport/oneShotCompletion.js';
+import type { OpenAiCodexConfig } from '../config.js';
+export declare function createOneShotCompletion(config: OpenAiCodexConfig): OneShotCompletion;
+//# sourceMappingURL=oneShotCompletion.d.ts.map

package/dist/providers/adapters/openai-codex/transport/oneShotCompletion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneShotCompletion.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/transport/oneShotCompletion.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,oDAAoD,CAAC;AAG5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA4FtD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAEpF"}

package/dist/providers/adapters/openai-codex/transport/oneShotCompletion.js

@@ -0,0 +1,93 @@
+/**
+ * OneShotCompletion implementation for the openai-codex adapter.
+ *
+ * Spawns `codex exec PROMPT --skip-git-repo-check --ephemeral -s read-only
+ * --output-last-message <tmpfile>` and reads the final agent message from
+ * the file. Direct analog of `claude -p` for the headless Anthropic adapter.
+ */
+import { promises as fs } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { AbortError } from '../../../errors.js';
+import { OPENAI_CODEX_ID, mapExecError } from '../errors.js';
+import { resolveCliModelFlag } from '../models.js';
+import { buildCodexChildEnv, spawnCodexAndWait } from './codexSpawn.js';
+class OpenAiCodexOneShotCompletion {
+    config;
+    capability = CapabilityFlag.OneShotCompletion;
+    constructor(config) {
+        this.config = config;
+    }
+    async evaluate(prompt, options) {
+        const timeoutMs = options?.timeoutMs ?? this.config.defaultOneShotTimeoutMs ?? 60_000;
+        const model = resolveCliModelFlag(options?.model ?? this.config.defaultModel);
+        const sandbox = this.config.defaultSandboxMode ?? 'read-only';
+        const outFile = path.join(tmpdir(), `codex-oneshot-${randomBytes(8).toString('hex')}.txt`);
+        // NOTE: Codex CLI 0.130.0 + ChatGPT-account auth hangs silently with
+        // `--ephemeral`; without it the call completes in ~5s. Probed
+        // empirically 2026-05-15. The trade-off is that each one-shot call
+        // leaves a session rollout under ~/.codex/sessions/. Cleanup is a
+        // Phase 5 follow-up (we can prune sessions older than N days, or
+        // re-introduce --ephemeral when Codex fixes the underlying bug).
+        const args = [
+            'exec',
+            '--skip-git-repo-check',
+            '-s',
+            sandbox,
+            '-m',
+            model,
+            '--output-last-message',
+            outFile,
+        ];
+        if (options?.system) {
+            args.push('-c', `instructions=${JSON.stringify(options.system)}`);
+        }
+        if (this.config.defaultProfile) {
+            args.push('-p', this.config.defaultProfile);
+        }
+        args.push(prompt);
+        // Rule 1a: env-scrubbing at exec time. See spec
+        // specs/provider-portability/12-openai-path-constraints.md.
+        const childEnv = buildCodexChildEnv({
+            apiKey: this.config.apiKey,
+            codexHome: this.config.codexHome,
+        });
+        const abortSignal = options?.signal;
+        if (abortSignal?.aborted) {
+            throw new AbortError('Aborted before start', OPENAI_CODEX_ID);
+        }
+        try {
+            const result = await spawnCodexAndWait(this.config.codexPath, args, {
+                timeoutMs,
+                env: childEnv,
+                signal: abortSignal,
+            });
+            if (result.exitCode !== 0) {
+                throw mapExecError(new Error(`Codex exited ${result.exitCode}`), result.stderr);
+            }
+            const text = await fs.readFile(outFile, 'utf-8').catch(() => '');
+            return {
+                text: text.trim(),
+                usage: null,
+                providerSpecific: { [OPENAI_CODEX_ID]: { model, sandbox } },
+            };
+        }
+        catch (err) {
+            const error = err;
+            if (error.name === 'AbortError' || abortSignal?.aborted) {
+                throw new AbortError('Aborted during execution', OPENAI_CODEX_ID, err);
+            }
+            const stderr = String(error.stderr ?? '');
+            throw mapExecError(error, stderr);
+        }
+        finally {
+            fs.unlink(outFile).catch(() => undefined);
+        }
+    }
+}
+export function createOneShotCompletion(config) {
+    return new OpenAiCodexOneShotCompletion(config);
+}
+//# sourceMappingURL=oneShotCompletion.js.map

package/dist/providers/adapters/openai-codex/transport/oneShotCompletion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneShotCompletion.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/transport/oneShotCompletion.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM1C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExE,MAAM,4BAA4B;IAGH;IAFpB,UAAU,GAAG,cAAc,CAAC,iBAAiB,CAAC;IAEvD,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ,CACZ,MAAc,EACd,OAAkC;QAElC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,uBAAuB,IAAI,MAAM,CAAC;QACtF,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,WAAW,CAAC;QAE9D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE3F,qEAAqE;QACrE,8DAA8D;QAC9D,mEAAmE;QACnE,kEAAkE;QAClE,iEAAiE;QACjE,iEAAiE;QACjE,MAAM,IAAI,GAAG;YACX,MAAM;YACN,uBAAuB;YACvB,IAAI;YACJ,OAAO;YACP,IAAI;YACJ,KAAK;YACL,uBAAuB;YACvB,OAAO;SACR,CAAC;QAEF,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAElB,gDAAgD;QAChD,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YAClC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;SACjC,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,OAAO,EAAE,MAAM,CAAC;QACpC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,UAAU,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE;gBAClE,SAAS;gBACT,GAAG,EAAE,QAAQ;gBACb,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,YAAY,CAChB,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,QAAQ,EAAE,CAA8B,EACzE,MAAM,CAAC,MAAM,CACd,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACjE,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;gBACjB,KAAK,EAAE,IAAI;gBACX,gBAAgB,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;aAC5D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAA+B,CAAC;YAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;gBACxD,MAAM,IAAI,UAAU,CAAC,0BAA0B,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC;YACzE,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAE,KAA8B,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,YAAY,CAChB,KAAwG,EACxG,MAAM,CACP,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAyB;IAC/D,OAAO,IAAI,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC"}

package/dist/providers/adapters/openai-codex/transport/structuredOneShot.d.ts

@@ -0,0 +1,16 @@
+/**
+ * StructuredOneShot implementation for the openai-codex adapter.
+ *
+ * Codex supports native structured output via `codex exec --output-schema
+ * <file.json>` (per `codex exec --help`). The adapter writes the caller's
+ * JSON schema to a temp file, passes it to the CLI for provider-side
+ * enforcement, and still runs the caller's validator on the returned text
+ * for consistency with adapters that lack provider-side enforcement.
+ *
+ * Retries on validation failure with a corrective follow-up prompt, up to
+ * options.maxRetries times (default 1, matching the Anthropic adapter).
+ */
+import type { StructuredOneShot } from '../../../primitives/transport/structuredOneShot.js';
+import type { OpenAiCodexConfig } from '../config.js';
+export declare function createStructuredOneShot(config: OpenAiCodexConfig): StructuredOneShot;
+//# sourceMappingURL=structuredOneShot.d.ts.map

package/dist/providers/adapters/openai-codex/transport/structuredOneShot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredOneShot.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/openai-codex/transport/structuredOneShot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EACV,iBAAiB,EAIlB,MAAM,oDAAoD,CAAC;AAG5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAoHtD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAEpF"}

package/dist/providers/adapters/openai-codex/transport/structuredOneShot.js

@@ -0,0 +1,115 @@
+/**
+ * StructuredOneShot implementation for the openai-codex adapter.
+ *
+ * Codex supports native structured output via `codex exec --output-schema
+ * <file.json>` (per `codex exec --help`). The adapter writes the caller's
+ * JSON schema to a temp file, passes it to the CLI for provider-side
+ * enforcement, and still runs the caller's validator on the returned text
+ * for consistency with adapters that lack provider-side enforcement.
+ *
+ * Retries on validation failure with a corrective follow-up prompt, up to
+ * options.maxRetries times (default 1, matching the Anthropic adapter).
+ */
+import { promises as fs } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { CapabilityFlag } from '../../../capabilities.js';
+import { AbortError, UnexpectedError } from '../../../errors.js';
+import { OPENAI_CODEX_ID, mapExecError } from '../errors.js';
+import { resolveCliModelFlag } from '../models.js';
+import { buildCodexChildEnv, spawnCodexAndWait } from './codexSpawn.js';
+class OpenAiCodexStructuredOneShot {
+    config;
+    capability = CapabilityFlag.StructuredOneShot;
+    constructor(config) {
+        this.config = config;
+    }
+    async evaluate(prompt, validate, options) {
+        const timeoutMs = options?.timeoutMs ?? this.config.defaultOneShotTimeoutMs ?? 60_000;
+        const model = resolveCliModelFlag(options?.model ?? this.config.defaultModel);
+        const sandbox = this.config.defaultSandboxMode ?? 'read-only';
+        const maxRetries = options?.maxRetries ?? 1;
+        const runId = randomBytes(8).toString('hex');
+        const outFile = path.join(tmpdir(), `codex-structured-${runId}.txt`);
+        const schemaFile = options?.jsonSchema
+            ? path.join(tmpdir(), `codex-schema-${runId}.json`)
+            : null;
+        if (schemaFile && options?.jsonSchema) {
+            await fs.writeFile(schemaFile, JSON.stringify(options.jsonSchema), 'utf-8');
+        }
+        // Rule 1a: env-scrubbing at exec time. See spec
+        // specs/provider-portability/12-openai-path-constraints.md.
+        const childEnv = buildCodexChildEnv({
+            apiKey: this.config.apiKey,
+            codexHome: this.config.codexHome,
+        });
+        let attempts = 0;
+        let lastError = '';
+        let lastRaw = '';
+        // See oneShotCompletion.ts for why --ephemeral is omitted (Codex CLI
+        // 0.130.0 hang under ChatGPT-account auth).
+        const baseArgs = [
+            'exec',
+            '--skip-git-repo-check',
+            '-s',
+            sandbox,
+            '-m',
+            model,
+            '--output-last-message',
+            outFile,
+        ];
+        if (schemaFile)
+            baseArgs.push('--output-schema', schemaFile);
+        if (options?.system)
+            baseArgs.push('-c', `instructions=${JSON.stringify(options.system)}`);
+        try {
+            while (attempts <= maxRetries) {
+                attempts++;
+                const promptForAttempt = attempts === 1
+                    ? prompt
+                    : `${prompt}\n\nYour previous response failed schema validation:\n${lastError}\n\nRespond again with valid output.`;
+                if (options?.signal?.aborted) {
+                    throw new AbortError('Aborted before attempt', OPENAI_CODEX_ID);
+                }
+                try {
+                    const result = await spawnCodexAndWait(this.config.codexPath, [...baseArgs, promptForAttempt], { timeoutMs, env: childEnv, signal: options?.signal });
+                    if (result.exitCode !== 0) {
+                        throw mapExecError(new Error(`Codex exited ${result.exitCode}`), result.stderr);
+                    }
+                }
+                catch (err) {
+                    const error = err;
+                    if (error.name === 'AbortError' || options?.signal?.aborted) {
+                        throw new AbortError('Aborted during execution', OPENAI_CODEX_ID, err);
+                    }
+                    const stderr = String(error.stderr ?? '');
+                    throw mapExecError(error, stderr);
+                }
+                const raw = (await fs.readFile(outFile, 'utf-8').catch(() => '')).trim();
+                lastRaw = raw;
+                const result = validate(raw);
+                if (result.ok) {
+                    return {
+                        value: result.value,
+                        raw,
+                        attempts,
+                        usage: null,
+                        providerSpecific: { [OPENAI_CODEX_ID]: { model, sandbox, schemaEnforced: Boolean(schemaFile) } },
+                    };
+                }
+                lastError = result.error;
+            }
+            throw new UnexpectedError(`Schema validation failed after ${attempts} attempts: ${lastError}. Last raw response: ${lastRaw.slice(0, 200)}`, OPENAI_CODEX_ID);
+        }
+        finally {
+            fs.unlink(outFile).catch(() => undefined);
+            if (schemaFile)
+                fs.unlink(schemaFile).catch(() => undefined);
+        }
+    }
+}
+export function createStructuredOneShot(config) {
+    return new OpenAiCodexStructuredOneShot(config);
+}
+//# sourceMappingURL=structuredOneShot.js.map

package/dist/providers/adapters/openai-codex/transport/structuredOneShot.js.map

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

package/dist/providers/canary/capabilityHonestyCanary.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Capability-honesty marker canary.
+ *
+ * Per Rule 3.2 of the path constraints: every state-detection /
+ * contract-preserving code path needs a paired canary that verifies
+ * the mechanism still works correctly. This canary covers the
+ * STUB_MARKER symbol (`src/providers/markers.ts`, Bug D fix area):
+ * when an adapter's `createStubPrimitive` factory returns a proxy,
+ * the marker must be readable via `isStubPrimitive` without tripping
+ * the proxy's throwing-method branch.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (capability-declaration honesty — missed marker = lying adapter)
+ *   Frequency:   parity test runs (transitively via the parity check)
+ *   Stability:   very stable (internal symbol)
+ *   Fallback:    none required — symbol identity is deterministic
+ *   Verdict:     deterministic + startup canary (startup-only cadence)
+ *
+ * Drift risk: low for the marker itself (Symbol.for is stable). Real
+ * risk is "a future stub factory refactor forgets to attach the
+ * marker." This canary catches that regression at startup loudly.
+ */
+export interface CapabilityHonestyCanaryResult {
+    status: 'pass' | 'fail';
+    message: string;
+    details: {
+        headlessStubDetected: boolean;
+        poolStubDetected: boolean;
+        codexStubDetected: boolean;
+        realPrimitiveCorrectlyNotDetected: boolean;
+        markerReadDidNotThrow: boolean;
+    };
+}
+/**
+ * Verify the STUB_MARKER infrastructure is intact across both
+ * Anthropic stub factories AND that reading the marker on a stub
+ * does NOT trip the proxy's throwing-method branch.
+ *
+ * Runs at startup. Cheap (no I/O, no real upstream). If this canary
+ * ever fails, the parity test's stub-vs-real detection is broken
+ * and adapters can re-acquire the ability to lie about capabilities.
+ */
+export declare function runCapabilityHonestyCanary(): CapabilityHonestyCanaryResult;
+//# sourceMappingURL=capabilityHonestyCanary.d.ts.map

package/dist/providers/canary/capabilityHonestyCanary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityHonestyCanary.d.ts","sourceRoot":"","sources":["../../../src/providers/canary/capabilityHonestyCanary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,oBAAoB,EAAE,OAAO,CAAC;QAC9B,gBAAgB,EAAE,OAAO,CAAC;QAC1B,iBAAiB,EAAE,OAAO,CAAC;QAC3B,iCAAiC,EAAE,OAAO,CAAC;QAC3C,qBAAqB,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,IAAI,6BAA6B,CAmG1E"}

package/dist/providers/canary/capabilityHonestyCanary.js

@@ -0,0 +1,136 @@
+/**
+ * Capability-honesty marker canary.
+ *
+ * Per Rule 3.2 of the path constraints: every state-detection /
+ * contract-preserving code path needs a paired canary that verifies
+ * the mechanism still works correctly. This canary covers the
+ * STUB_MARKER symbol (`src/providers/markers.ts`, Bug D fix area):
+ * when an adapter's `createStubPrimitive` factory returns a proxy,
+ * the marker must be readable via `isStubPrimitive` without tripping
+ * the proxy's throwing-method branch.
+ *
+ * RULE 3.1 RATIONALE
+ *   Criticality: high (capability-declaration honesty — missed marker = lying adapter)
+ *   Frequency:   parity test runs (transitively via the parity check)
+ *   Stability:   very stable (internal symbol)
+ *   Fallback:    none required — symbol identity is deterministic
+ *   Verdict:     deterministic + startup canary (startup-only cadence)
+ *
+ * Drift risk: low for the marker itself (Symbol.for is stable). Real
+ * risk is "a future stub factory refactor forgets to attach the
+ * marker." This canary catches that regression at startup loudly.
+ */
+import { CapabilityFlag } from '../capabilities.js';
+import { isStubPrimitive, STUB_MARKER } from '../markers.js';
+import { createStubPrimitive as headlessStubFactory } from '../adapters/anthropic-headless/stubs.js';
+import { createStubPrimitive as poolStubFactory } from '../adapters/anthropic-interactive-pool/stubs.js';
+import { createStubPrimitive as codexStubFactory } from '../adapters/openai-codex/stubs.js';
+/**
+ * Verify the STUB_MARKER infrastructure is intact across both
+ * Anthropic stub factories AND that reading the marker on a stub
+ * does NOT trip the proxy's throwing-method branch.
+ *
+ * Runs at startup. Cheap (no I/O, no real upstream). If this canary
+ * ever fails, the parity test's stub-vs-real detection is broken
+ * and adapters can re-acquire the ability to lie about capabilities.
+ */
+export function runCapabilityHonestyCanary() {
+    // Check 1: headless stub factory output is detected as a stub.
+    const headlessStub = headlessStubFactory(CapabilityFlag.StructuredOneShot);
+    let headlessStubDetected;
+    let markerReadDidNotThrow = true;
+    try {
+        headlessStubDetected = isStubPrimitive(headlessStub);
+    }
+    catch {
+        headlessStubDetected = false;
+        markerReadDidNotThrow = false;
+    }
+    // Check 2: pool stub factory output is detected as a stub.
+    const poolStub = poolStubFactory(CapabilityFlag.StructuredOneShot);
+    let poolStubDetected;
+    try {
+        poolStubDetected = isStubPrimitive(poolStub);
+    }
+    catch {
+        poolStubDetected = false;
+        markerReadDidNotThrow = false;
+    }
+    // Check 2b: openai-codex stub factory output is detected as a stub.
+    // Per Rule 3.2, every adapter that emits stub primitives for parity
+    // tests must use the canonical STUB_MARKER so isStubPrimitive sees it.
+    // A new adapter forgetting the marker silently re-grants it the ability
+    // to lie about capabilities — this check guards against that regression.
+    const codexStub = codexStubFactory(CapabilityFlag.StructuredOneShot);
+    let codexStubDetected;
+    try {
+        codexStubDetected = isStubPrimitive(codexStub);
+    }
+    catch {
+        codexStubDetected = false;
+        markerReadDidNotThrow = false;
+    }
+    // Check 3: a real primitive shape (plain object with capability)
+    // is NOT detected as a stub.
+    const fakeReal = {
+        capability: CapabilityFlag.OneShotCompletion,
+        evaluate: () => Promise.resolve({ text: '', usage: null }),
+    };
+    const realPrimitiveCorrectlyNotDetected = !isStubPrimitive(fakeReal);
+    // Check 4: the marker Symbol identity is canonical (catches
+    // re-export confusion where two different modules might create
+    // different Symbol.for objects with the same key).
+    const canonicalMarkerOnHeadless = headlessStub[STUB_MARKER] === true;
+    const canonicalMarkerOnPool = poolStub[STUB_MARKER] === true;
+    const canonicalMarkerOnCodex = codexStub[STUB_MARKER] === true;
+    const allChecksPass = headlessStubDetected
+        && poolStubDetected
+        && codexStubDetected
+        && realPrimitiveCorrectlyNotDetected
+        && markerReadDidNotThrow
+        && canonicalMarkerOnHeadless
+        && canonicalMarkerOnPool
+        && canonicalMarkerOnCodex;
+    if (allChecksPass) {
+        return {
+            status: 'pass',
+            message: 'capability-honesty canary: stub markers intact across all 3 adapter factories',
+            details: {
+                headlessStubDetected: true,
+                poolStubDetected: true,
+                codexStubDetected: true,
+                realPrimitiveCorrectlyNotDetected: true,
+                markerReadDidNotThrow: true,
+            },
+        };
+    }
+    const failures = [];
+    if (!headlessStubDetected)
+        failures.push('headless stub not detected');
+    if (!poolStubDetected)
+        failures.push('pool stub not detected');
+    if (!codexStubDetected)
+        failures.push('codex stub not detected');
+    if (!realPrimitiveCorrectlyNotDetected)
+        failures.push('real primitive incorrectly flagged as stub');
+    if (!markerReadDidNotThrow)
+        failures.push('reading the marker threw (proxy trap regression)');
+    if (!canonicalMarkerOnHeadless)
+        failures.push('canonical marker missing on headless stub');
+    if (!canonicalMarkerOnPool)
+        failures.push('canonical marker missing on pool stub');
+    if (!canonicalMarkerOnCodex)
+        failures.push('canonical marker missing on codex stub');
+    return {
+        status: 'fail',
+        message: `capability-honesty canary: ${failures.join('; ')}`,
+        details: {
+            headlessStubDetected,
+            poolStubDetected,
+            codexStubDetected,
+            realPrimitiveCorrectlyNotDetected,
+            markerReadDidNotThrow,
+        },
+    };
+}
+//# sourceMappingURL=capabilityHonestyCanary.js.map

package/dist/providers/canary/capabilityHonestyCanary.js.map

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

package/dist/providers/capabilities.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Capability flags for the provider portability substrate.
+ *
+ * Every primitive has a corresponding CapabilityFlag entry. An adapter
+ * declares which capabilities it implements by exposing a `capabilities`
+ * array. Application code (and routing policy) queries the registry by
+ * required capability set rather than by provider name.
+ *
+ * Universal primitives (36): should be implemented by every "complete"
+ * adapter. An adapter missing a universal capability is incomplete but
+ * still usable for the subset of operations that don't require it.
+ *
+ * Optional primitives (15): provider-specific features. Adapters declare
+ * if they support them; conformance tests skip when absent.
+ */
+export declare const CapabilityFlag: {
+    readonly OneShotCompletion: "one-shot-completion";
+    readonly StructuredOneShot: "structured-one-shot";
+    readonly AgenticSessionHeadless: "agentic-session-headless";
+    readonly AgenticSessionInteractive: "agentic-session-interactive";
+    readonly WarmSessionInbox: "warm-session-inbox";
+    readonly AgenticSessionRpc: "agentic-session-rpc";
+    readonly ToolAccess: "tool-access";
+    readonly ToolAllowlist: "tool-allowlist";
+    readonly FileSystemAccess: "file-system-access";
+    readonly PathAllowlist: "path-allowlist";
+    readonly BashExecution: "bash-execution";
+    readonly WebAccess: "web-access";
+    readonly LiveOutputStream: "live-output-stream";
+    readonly ConversationLogReader: "conversation-log-reader";
+    readonly ConversationLogTailer: "conversation-log-tailer";
+    readonly HookEventReceiver: "hook-event-receiver";
+    readonly SubagentLifecycleObserver: "subagent-lifecycle-observer";
+    readonly SessionId: "session-id";
+    readonly UsageMeterProvider: "usage-meter-provider";
+    readonly ProcessLifecycle: "process-lifecycle";
+    readonly InteractivePromptObserver: "interactive-prompt-observer";
+    readonly InputInjection: "input-injection";
+    readonly HardKill: "hard-kill";
+    readonly Interrupt: "interrupt";
+    readonly StopGateInterceptor: "stop-gate-interceptor";
+    readonly TimeoutBound: "timeout-bound";
+    readonly IdleBound: "idle-bound";
+    readonly AuthCredentialInjection: "auth-credential-injection";
+    readonly CredentialStorageProvider: "credential-storage-provider";
+    readonly ContextScopeControl: "context-scope-control";
+    readonly CompactionLifecycle: "compaction-lifecycle";
+    readonly IntelligenceCallQueue: "intelligence-call-queue";
+    readonly ProviderScaffolder: "provider-scaffolder";
+    readonly McpToolRegistry: "mcp-tool-registry";
+    readonly SessionResumeIndex: "session-resume-index";
+    readonly ConversationLogProvider: "conversation-log-provider";
+    readonly ThreadFork: "thread-fork";
+    readonly ThreadRollback: "thread-rollback";
+    readonly ThreadGoalSlot: "thread-goal-slot";
+    readonly ProfileSwitcher: "profile-switcher";
+    readonly CustomModelProvider: "custom-model-provider";
+    readonly ShellEnvironmentPolicy: "shell-environment-policy";
+    readonly OtelExporter: "otel-exporter";
+    readonly ComplianceApi: "compliance-api";
+    readonly PluginRegistry: "plugin-registry";
+    readonly FilesystemRpc: "filesystem-rpc";
+    readonly ProcessSpawn: "process-spawn";
+    readonly CapabilityNegotiation: "capability-negotiation";
+    readonly NotificationOptOut: "notification-opt-out";
+    readonly CodeReviewPreset: "code-review-preset";
+    readonly CsvBatchMode: "csv-batch-mode";
+    readonly SelfUpdate: "self-update";
+    readonly TrustedProjectGate: "trusted-project-gate";
+    readonly RequirementsToml: "requirements-toml";
+    /** Provider exposes a public usage API (Anthropic). False for Codex (no public endpoint). */
+    readonly PublicUsageApi: "public-usage-api";
+    /** Provider emits a PreCompact hook (Anthropic). False for Codex (silent auto-compact). */
+    readonly PreCompactHook: "pre-compact-hook";
+    /** Provider emits SubagentStart/SubagentStop hooks (Anthropic). Codex emits app-server thread events only. */
+    readonly SubagentLifecycleHooks: "subagent-lifecycle-hooks";
+    /** Provider has native idle-timeout config (neither today; capability-gated by adapter wrapping). */
+    readonly NativeIdleBound: "native-idle-bound";
+    /** Provider emits structured permission/approval events (Codex app-server). Anthropic requires terminal scraping. */
+    readonly StructuredApprovalEvents: "structured-approval-events";
+};
+/** Value type for the CapabilityFlag enum. */
+export type CapabilityFlag = (typeof CapabilityFlag)[keyof typeof CapabilityFlag];
+/** Set of capabilities supported by a specific adapter. */
+export type CapabilitySet = ReadonlySet<CapabilityFlag>;
+/**
+ * Construct a CapabilitySet from a list. Convenience for adapter declarations.
+ */
+export declare function capabilitySet(flags: CapabilityFlag[]): CapabilitySet;
+/**
+ * Check whether a CapabilitySet covers all required capabilities.
+ * Returns the first missing capability, or null if all are present.
+ */
+export declare function missingCapability(available: CapabilitySet, required: CapabilityFlag[]): CapabilityFlag | null;
+/** Quick predicate version. */
+export declare function hasAllCapabilities(available: CapabilitySet, required: CapabilityFlag[]): boolean;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/providers/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/providers/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsEzB,6FAA6F;;IAE7F,2FAA2F;;IAE3F,8GAA8G;;IAE9G,qGAAqG;;IAErG,qHAAqH;;CAE7G,CAAC;AAEX,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AAExD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,aAAa,CAEpE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,cAAc,EAAE,GACzB,cAAc,GAAG,IAAI,CAKvB;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,cAAc,EAAE,GACzB,OAAO,CAET"}