condukt 0.25.0 → 0.27.0

package/dist/runtimes/claude/bridge-cache.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pure caching / id-stability predicates ported from the reference proxy.
+ * No I/O, no global state. Downgrade/exclusion sets are managed by the caller.
+ * (Session compaction epochs live in session-epoch.ts; usage notes feed them.)
+ */
+export declare const GLM_EXCLUDE_PATTERN: RegExp;
+export declare function shouldStampRetention(model: string): boolean;
+export declare function cacheKeyFor(session: string): string | null;
+/** Whole-segment exclusion (never substring false positives like "gilmour"). */
+export declare function cacheKeyExcluded(model: string): boolean;
+export declare function synthesizeToolId(name: string, index: number | string, args: unknown): string;
+/** Deterministic JSON with sorted keys (reference `sort_keys` parity). */
+export declare function stableJson(value: unknown): string;
+export declare function normalizeToolCallId(existing: unknown, name: string, index: number | string, args: unknown): string;
+export declare class DowngradeSet {
+    private readonly set;
+    has(model: string): boolean;
+    add(model: string): void;
+    clear(): void;
+    size(): number;
+    list(): string[];
+}
+export declare function isCacheFieldRejection(status: number, body: string): boolean;
+/** Backwards-compatible alias used by older call sites/tests. */
+export declare function isCacheFieldError(status: number, body: string): boolean;
+/** Total output tokens as upstream reports them (inclusive of reasoning). */
+export declare function getOutputTokens(usage: unknown): number;
+/** Cache read tokens from the several upstream field names. */
+export declare function extractCacheReadTokens(usage: unknown): number;
+/** Cache creation (write) tokens from the several upstream field names. */
+export declare function extractCacheCreationTokens(usage: unknown): number;
+/** Token facts one completed upstream request contributes to epoch notes. */
+export interface UpstreamTurnUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheCreationTokens: number;
+    readonly measured: boolean;
+}
+/**
+ * Normalize an OpenAI chat/completions usage object. Returns null when
+ * no upstream usage is present (an observation gap, never a 0-turn).
+ */
+export declare function upstreamUsageFromOpenAI(usage: unknown): UpstreamTurnUsage | null;
+/** Normalize an OpenAI Responses usage object (input_tokens_details shape). */
+export declare function upstreamUsageFromResponses(usage: unknown): UpstreamTurnUsage | null;
+/** Normalize an Anthropic usage object (message_start / message_delta / non-stream). */
+export declare function upstreamUsageFromAnthropic(usage: unknown): UpstreamTurnUsage | null;
+/**
+ * Reasoning-token split from either upstream usage shape
+ * (output_tokens_details / completion_tokens_details). The split is a
+ * SUBSET of the reported total — display it, never add it.
+ */
+export declare function upstreamReasoningTokens(usage: unknown): number;
+export declare function withReasoningSplit(base: Record<string, unknown>, usage: unknown): Record<string, unknown>;
+/** Rough token estimate (chars/3), used for message_start and count_tokens. */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=bridge-cache.d.ts.map

package/dist/runtimes/claude/bridge-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-cache.d.ts","sourceRoot":"","sources":["../../../runtimes/claude/bridge-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,mBAAmB,QAAe,CAAC;AAEhD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D;AAWD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ1D;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMvD;AAWD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAO5F;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMjD;AAcD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAGlH;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAC3B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IACxB,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,MAAM;IACd,IAAI,IAAI,MAAM,EAAE;CACjB;AA0BD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO3E;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvE;AAID,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAItD;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK7D;AAED,2EAA2E;AAC3E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKjE;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAahF;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAkBnF;AAED,wFAAwF;AACxF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAanF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAW9D;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/runtimes/claude/bridge-cache.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * Pure caching / id-stability predicates ported from the reference proxy.
+ * No I/O, no global state. Downgrade/exclusion sets are managed by the caller.
+ * (Session compaction epochs live in session-epoch.ts; usage notes feed them.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DowngradeSet = exports.GLM_EXCLUDE_PATTERN = void 0;
+exports.shouldStampRetention = shouldStampRetention;
+exports.cacheKeyFor = cacheKeyFor;
+exports.cacheKeyExcluded = cacheKeyExcluded;
+exports.synthesizeToolId = synthesizeToolId;
+exports.stableJson = stableJson;
+exports.normalizeToolCallId = normalizeToolCallId;
+exports.isCacheFieldRejection = isCacheFieldRejection;
+exports.isCacheFieldError = isCacheFieldError;
+exports.getOutputTokens = getOutputTokens;
+exports.extractCacheReadTokens = extractCacheReadTokens;
+exports.extractCacheCreationTokens = extractCacheCreationTokens;
+exports.upstreamUsageFromOpenAI = upstreamUsageFromOpenAI;
+exports.upstreamUsageFromResponses = upstreamUsageFromResponses;
+exports.upstreamUsageFromAnthropic = upstreamUsageFromAnthropic;
+exports.upstreamReasoningTokens = upstreamReasoningTokens;
+exports.withReasoningSplit = withReasoningSplit;
+exports.estimateTokens = estimateTokens;
+const node_crypto_1 = require("node:crypto");
+exports.GLM_EXCLUDE_PATTERN = /glm|zhipu/i;
+function shouldStampRetention(model) {
+    return !exports.GLM_EXCLUDE_PATTERN.test(model);
+}
+// ── Upstream prompt-cache key derivation (reference parity) ──────────
+// Clean values (UUIDs and the like) pass verbatim; overlong-but-clean
+// values keep a readable head plus a hash; anything outside the safe
+// charset is hashed wholesale. Deterministic per session.
+const CACHE_KEY_MAXLEN = 64;
+const CACHE_KEY_SAFE = new Set('ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_'.split(''));
+function cacheKeyFor(session) {
+    const s = (session || '').trim();
+    if (!s)
+        return null;
+    if ([...s].every((c) => CACHE_KEY_SAFE.has(c))) {
+        if (s.length <= CACHE_KEY_MAXLEN)
+            return s;
+        return s.slice(0, 32) + (0, node_crypto_1.createHash)('sha256').update(s, 'utf8').digest('hex').slice(0, 32);
+    }
+    return 'ck-' + (0, node_crypto_1.createHash)('sha256').update(s, 'utf8').digest('hex').slice(0, 32);
+}
+/** Whole-segment exclusion (never substring false positives like "gilmour"). */
+function cacheKeyExcluded(model) {
+    const segs = (model || '')
+        .toLowerCase()
+        .replace(/[_/.:]/g, '-')
+        .split('-');
+    return segs.some((seg) => seg === 'glm' || seg === 'zhipu');
+}
+// ── Stable tool-call ids (reference parity) ──────────────────────────
+// Content-derived ids keep identical turns byte-identical across
+// retries/replays, so prefix caches stay warm and tool_use/tool_result
+// pairing survives id-dropping clients.
+function sha1Short(input) {
+    return (0, node_crypto_1.createHash)('sha1').update(input, 'utf8').digest('hex').slice(0, 8);
+}
+function synthesizeToolId(name, index, args) {
+    const argStr = args && typeof args === 'object'
+        ? stableJson(args)
+        : String(args ?? '');
+    const basis = `${name || ''}\u0000${argStr}`;
+    return `toolu_${name}_${index}_${sha1Short(basis)}`;
+}
+/** Deterministic JSON with sorted keys (reference `sort_keys` parity). */
+function stableJson(value) {
+    try {
+        return JSON.stringify(sortValue(value));
+    }
+    catch {
+        return String(value);
+    }
+}
+function sortValue(value) {
+    if (Array.isArray(value))
+        return value.map(sortValue);
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const key of Object.keys(value).sort()) {
+            out[key] = sortValue(value[key]);
+        }
+        return out;
+    }
+    return value;
+}
+function normalizeToolCallId(existing, name, index, args) {
+    if (typeof existing === 'string' && existing.length > 0)
+        return existing;
+    return synthesizeToolId(name, index, args);
+}
+class DowngradeSet {
+    set = new Set();
+    has(model) { return this.set.has(model); }
+    add(model) { this.set.add(model); }
+    clear() { this.set.clear(); }
+    size() { return this.set.size; }
+    list() { return [...this.set]; }
+}
+exports.DowngradeSet = DowngradeSet;
+// ── Cache-field 400 signature (reference parity) ─────────────────────
+// The downgrade must trigger on "extra/unknown/not-permitted" style
+// rejections ANCHORED on a cache field name — a bare "not permitted"
+// phrase ("Tool use not permitted") must not poison the exclusion set.
+const CACHE_KEY_REJECT_SIGNS = [
+    'extra input',
+    'not permitted',
+    'unknown field',
+    'unknown parameter',
+    'unexpected field',
+    'unexpected parameter',
+    'unrecognized field',
+    'unrecognized parameter',
+    'unsupported field',
+    'unsupported parameter',
+];
+const CACHE_KEY_FIELD_HINTS = ['prompt_cache_key', 'prompt_cache_retention', 'promptcache'];
+function normalizeForHint(text) {
+    // Underscores/hyphens/spaces equivalent so "prompt-cache-key" matches.
+    return text.toLowerCase().replace(/[-_\s]/g, '');
+}
+function isCacheFieldRejection(status, body) {
+    if (status !== 400)
+        return false;
+    const b = (body || '').toLowerCase();
+    const hasSign = CACHE_KEY_REJECT_SIGNS.some((s) => b.includes(s));
+    if (!hasSign)
+        return false;
+    const normalized = normalizeForHint(b);
+    return CACHE_KEY_FIELD_HINTS.some((h) => normalized.includes(normalizeForHint(h)));
+}
+/** Backwards-compatible alias used by older call sites/tests. */
+function isCacheFieldError(status, body) {
+    return isCacheFieldRejection(status, body);
+}
+// ── Usage normalization (reference parity) ───────────────────────────
+/** Total output tokens as upstream reports them (inclusive of reasoning). */
+function getOutputTokens(usage) {
+    const u = (usage && typeof usage === 'object' ? usage : {});
+    const n = u['completion_tokens'] ?? u['output_tokens'];
+    return typeof n === 'number' && Number.isFinite(n) ? n : 0;
+}
+/** Cache read tokens from the several upstream field names. */
+function extractCacheReadTokens(usage) {
+    const u = (usage && typeof usage === 'object' ? usage : {});
+    const details = (u['prompt_tokens_details'] ?? {});
+    const read = details['cached_tokens'] ?? u['cached_tokens'] ?? u['cache_read_input_tokens'];
+    return numeric(read) ?? 0;
+}
+/** Cache creation (write) tokens from the several upstream field names. */
+function extractCacheCreationTokens(usage) {
+    const u = (usage && typeof usage === 'object' ? usage : {});
+    const details = (u['prompt_tokens_details'] ?? {});
+    const creation = details['cache_creation'] ?? u['cache_creation_input_tokens'];
+    return numeric(creation) ?? 0;
+}
+function numeric(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && /^\d+$/.test(value.trim()))
+        return parseInt(value.trim(), 10);
+    return null;
+}
+/**
+ * Normalize an OpenAI chat/completions usage object. Returns null when
+ * no upstream usage is present (an observation gap, never a 0-turn).
+ */
+function upstreamUsageFromOpenAI(usage) {
+    if (!usage || typeof usage !== 'object')
+        return null;
+    const u = usage;
+    const inTok = numeric(u['prompt_tokens'] ?? u['input_tokens']);
+    const outTok = numeric(u['completion_tokens'] ?? u['output_tokens']);
+    if (inTok === null && outTok === null)
+        return null;
+    return {
+        inputTokens: inTok ?? 0,
+        outputTokens: outTok ?? 0,
+        cacheReadTokens: extractCacheReadTokens(u),
+        cacheCreationTokens: extractCacheCreationTokens(u),
+        measured: true,
+    };
+}
+/** Normalize an OpenAI Responses usage object (input_tokens_details shape). */
+function upstreamUsageFromResponses(usage) {
+    if (!usage || typeof usage !== 'object')
+        return null;
+    const u = usage;
+    const inTok = numeric(u['input_tokens']);
+    const outTok = numeric(u['output_tokens']);
+    if (inTok === null && outTok === null)
+        return null;
+    const details = u['input_tokens_details'];
+    const detailCache = details && typeof details === 'object' ? numeric(details['cached_tokens']) : null;
+    const cacheRead = detailCache ?? extractCacheReadTokens(u);
+    const cacheCreate = numeric(u['cache_write_tokens']) ?? extractCacheCreationTokens(u);
+    return {
+        inputTokens: inTok ?? 0,
+        outputTokens: outTok ?? 0,
+        cacheReadTokens: cacheRead,
+        cacheCreationTokens: cacheCreate,
+        measured: true,
+    };
+}
+/** Normalize an Anthropic usage object (message_start / message_delta / non-stream). */
+function upstreamUsageFromAnthropic(usage) {
+    if (!usage || typeof usage !== 'object')
+        return null;
+    const u = usage;
+    const inTok = numeric(u['input_tokens']);
+    const outTok = numeric(u['output_tokens']);
+    if (inTok === null && outTok === null)
+        return null;
+    return {
+        inputTokens: inTok ?? 0,
+        outputTokens: outTok ?? 0,
+        cacheReadTokens: numeric(u['cache_read_input_tokens']) ?? 0,
+        cacheCreationTokens: numeric(u['cache_creation_input_tokens']) ?? 0,
+        measured: true,
+    };
+}
+/**
+ * Reasoning-token split from either upstream usage shape
+ * (output_tokens_details / completion_tokens_details). The split is a
+ * SUBSET of the reported total — display it, never add it.
+ */
+function upstreamReasoningTokens(usage) {
+    if (!usage || typeof usage !== 'object')
+        return 0;
+    const u = usage;
+    for (const container of ['output_tokens_details', 'completion_tokens_details']) {
+        const det = u[container];
+        if (!det || typeof det !== 'object')
+            continue;
+        const raw = det['reasoning_tokens'];
+        if (typeof raw === 'number' && Number.isFinite(raw) && raw > 0)
+            return Math.trunc(raw);
+        if (typeof raw === 'string' && /^\d+$/.test(raw.trim()))
+            return parseInt(raw.trim(), 10);
+    }
+    return 0;
+}
+function withReasoningSplit(base, usage) {
+    const n = upstreamReasoningTokens(usage);
+    if (!n)
+        return base;
+    return { ...base, reasoning_tokens: n };
+}
+/** Rough token estimate (chars/3), used for message_start and count_tokens. */
+function estimateTokens(text) {
+    return Math.max(1, Math.floor((text || '').length / 3));
+}
+//# sourceMappingURL=bridge-cache.js.map

package/dist/runtimes/claude/bridge-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-cache.js","sourceRoot":"","sources":["../../../runtimes/claude/bridge-cache.ts"],"names":[],"mappings":"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"}

package/dist/runtimes/claude/claude-runtime.d.ts

@@ -0,0 +1,30 @@
+import type { AgentRuntime, AgentSession, SessionConfig, SessionCreationOptions, RuntimeCapabilities } from '../../src/types';
+import type { BridgeRuntimeConfig } from './protocol-bridge';
+export interface ClaudeRuntimeOptions {
+    /**
+     * Point the Claude CLI at the in-process protocol bridge, translating
+     * its Anthropic traffic to OpenCode Go / Zen upstreams (Anthropic
+     * pass-through, OpenAI chat/completions, or OpenAI Responses — chosen
+     * per model). One bridge is started lazily per session and closed on
+     * abort.
+     */
+    readonly bridge?: BridgeRuntimeConfig;
+}
+export declare class ClaudeAgentRuntime implements AgentRuntime {
+    readonly name = "claude";
+    /**
+     * - `readOnlyPermissions`: read-only is enforced with a positive built-in
+     *   allow-list plus `dontAsk`, not a deny-list.
+     * - `requiredModeVerification`: `init` reads the applied permission mode
+     *   and tool set back, so `requireMode` is a verified contract.
+     * - `sessionRecovery`: bounded same-session resume with the fixed
+     *   continuation prompt (ADR-009; string-prompt mode has no empty turn).
+     */
+    readonly capabilities: RuntimeCapabilities;
+    private readonly options;
+    constructor(options?: ClaudeRuntimeOptions);
+    isAvailable(): Promise<boolean>;
+    createSession(config: SessionConfig, options?: SessionCreationOptions): Promise<AgentSession>;
+}
+export declare function createClaudeRuntime(options?: ClaudeRuntimeOptions): AgentRuntime;
+//# sourceMappingURL=claude-runtime.d.ts.map

package/dist/runtimes/claude/claude-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-runtime.d.ts","sourceRoot":"","sources":["../../../runtimes/claude/claude-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE9H,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,YAAY;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAIxC;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAEnC,OAAO,GAAE,oBAAyB;IAIxC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAqB/B,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;CAGpG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,YAAY,CAEpF"}

package/dist/runtimes/claude/claude-runtime.js

@@ -0,0 +1,88 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeAgentRuntime = void 0;
+exports.createClaudeRuntime = createClaudeRuntime;
+const claude_session_1 = require("./claude-session");
+class ClaudeAgentRuntime {
+    name = 'claude';
+    /**
+     * - `readOnlyPermissions`: read-only is enforced with a positive built-in
+     *   allow-list plus `dontAsk`, not a deny-list.
+     * - `requiredModeVerification`: `init` reads the applied permission mode
+     *   and tool set back, so `requireMode` is a verified contract.
+     * - `sessionRecovery`: bounded same-session resume with the fixed
+     *   continuation prompt (ADR-009; string-prompt mode has no empty turn).
+     */
+    capabilities = {
+        readOnlyPermissions: true,
+        requiredModeVerification: true,
+        sessionRecovery: true,
+    };
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async isAvailable() {
+        try {
+            await Promise.resolve().then(() => __importStar(require('@anthropic-ai/claude-agent-sdk')));
+        }
+        catch {
+            return false;
+        }
+        // Verify the Claude Code CLI is reachable.
+        try {
+            const { execFileSync } = await Promise.resolve().then(() => __importStar(require('node:child_process')));
+            execFileSync(process.env.CLAUDE_CODE_EXECUTABLE ?? 'claude', ['--version'], { timeout: 5000, stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            // Without an explicit path the CLI may be bundled with the SDK, so a
+            // failed probe is not proof of absence. With one, the operator named
+            // the binary: a path that does not run is a misconfiguration, and
+            // answering "available" here defers the failure to the first turn.
+            const explicit = (process.env.CLAUDE_CODE_EXECUTABLE ?? '').trim();
+            return explicit.length === 0;
+        }
+    }
+    async createSession(config, options) {
+        return new claude_session_1.ClaudeAgentSession(config, options, this.options.bridge);
+    }
+}
+exports.ClaudeAgentRuntime = ClaudeAgentRuntime;
+function createClaudeRuntime(options = {}) {
+    return new ClaudeAgentRuntime(options);
+}
+//# sourceMappingURL=claude-runtime.js.map

package/dist/runtimes/claude/claude-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-runtime.js","sourceRoot":"","sources":["../../../runtimes/claude/claude-runtime.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,kDAEC;AA/DD,qDAAsD;AActD,MAAa,kBAAkB;IACpB,IAAI,GAAG,QAAQ,CAAC;IACzB;;;;;;;OAOG;IACM,YAAY,GAAwB;QAC3C,mBAAmB,EAAE,IAAI;QACzB,wBAAwB,EAAE,IAAI;QAC9B,eAAe,EAAE,IAAI;KACtB,CAAC;IACe,OAAO,CAAuB;IAE/C,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,wDAAa,gCAAgC,GAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,2CAA2C;QAC3C,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,GAAG,wDAAa,oBAAoB,GAAC,CAAC;YAC5D,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAChH,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;YACrE,qEAAqE;YACrE,kEAAkE;YAClE,mEAAmE;YACnE,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACnE,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAqB,EAAE,OAAgC;QACzE,OAAO,IAAI,mCAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC;CACF;AA7CD,gDA6CC;AAED,SAAgB,mBAAmB,CAAC,UAAgC,EAAE;IACpE,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/runtimes/claude/claude-session.d.ts

@@ -0,0 +1,154 @@
+import type { ForkSessionOptions, ForkSessionResult, GetSessionMessagesOptions, Options, SDKMessage, SessionMessage } from '@anthropic-ai/claude-agent-sdk';
+import type { AgentSession, AgentSessionHistory, AgentSessionMetadata, AgentSessionUsage, SessionConfig, SessionCreationOptions, ToolUsageData } from '../../src/types';
+import type { SessionRecoveryEvent } from '../../src/types';
+import type { BridgeHandle, BridgeRuntimeConfig } from './protocol-bridge';
+/**
+ * Stored handlers. Each event has its own payload type (see the `on`
+ * overloads below); `emit` is the only place that supplies runtime arguments,
+ * so the erased shape is what the handler list can hold without an `any`.
+ */
+type Handler = (...args: never[]) => void;
+/**
+ * The slice of the SDK `Query` the session uses. Narrower than `Query` so
+ * tests can supply a fake async iterable without reimplementing the control
+ * protocol; the real handle satisfies it structurally.
+ */
+export interface ClaudeQueryHandle extends AsyncIterable<SDKMessage> {
+    close?: () => void;
+    getContextUsage?: (opts?: {
+        readonly detail?: 'summary' | 'full';
+    }) => Promise<{
+        readonly totalTokens?: number;
+        readonly categories?: ReadonlyArray<{
+            readonly kind?: string;
+            readonly id?: string;
+            readonly name?: string;
+            readonly tokens?: number;
+        }>;
+    }>;
+}
+/**
+ * SDK boundaries the session calls. Overridable for tests (`@internal`); the
+ * defaults are the SDK's own functions.
+ */
+export interface ClaudeSessionDeps {
+    readonly queryFn?: (params: {
+        readonly prompt: string;
+        readonly options: Options;
+    }) => ClaudeQueryHandle;
+    readonly getSessionMessagesFn?: (sessionId: string, options?: GetSessionMessagesOptions) => Promise<ReadonlyArray<Pick<SessionMessage, 'uuid' | 'type' | 'message'>>>;
+    readonly forkSessionFn?: (sessionId: string, options?: ForkSessionOptions) => Promise<ForkSessionResult>;
+    readonly sleepFn?: (ms: number) => Promise<void>;
+}
+export declare class ClaudeAgentSession implements AgentSession {
+    readonly pid: number | null;
+    private readonly config;
+    private readonly abortController;
+    private readonly bridgeOptions;
+    private bridgeHandle;
+    private bridgeCreating;
+    private handlers;
+    private sessionId;
+    private lastQuery;
+    private aborted;
+    private turnCount;
+    private sessionStartTime;
+    private lastCallContextTokens;
+    private lastCallInputTokens;
+    private lastCallOutputTokens;
+    private compactionCount;
+    private lastAssistantError;
+    private lastApiRetry;
+    private activeRecovery;
+    private readonly diagnostics;
+    private readonly includePartialMessages;
+    private readonly queryFn;
+    private readonly getSessionMessagesFn;
+    private readonly forkSessionFn;
+    private readonly sleepFn;
+    /**
+     * Usage is cumulative per session. A truncate forks the transcript, so the
+     * running totals restart from the fork point and the old baseline would
+     * suppress real usage until it caught up; the ledger is replaced instead.
+     */
+    private usageLedger;
+    private turnChain;
+    constructor(config: SessionConfig, options?: SessionCreationOptions, bridgeOptions?: BridgeRuntimeConfig, deps?: ClaudeSessionDeps);
+    private emit;
+    private diagnostic;
+    private sleep;
+    private buildEmitter;
+    send(prompt: string): void;
+    continueSession(prompt: string): Promise<void>;
+    /**
+     * Start (once) the in-process protocol bridge for this session.
+     *
+     * The bridge exposes an Anthropic-compatible surface and translates to
+     * the configured upstream protocol (Anthropic pass-through / OpenAI
+     * chat / OpenAI Responses). Returns null when no bridge is configured
+     * (the CLI then talks to its default Anthropic endpoint).
+     */
+    ensureBridge(): Promise<BridgeHandle | null>;
+    /**
+     * Environment that points the Claude CLI at the bridge. Every query the
+     * session issues — turns, recovery resumes, handoff summaries, and the
+     * advisor/stand-in one-shots — must carry it, or the CLI falls back to
+     * `api.anthropic.com` where no credential exists under the bridge.
+     */
+    private bridgeEnv;
+    private runTurn;
+    /**
+     * One query attempt. Returns the terminal outcome, or the error that ended
+     * the stream, instead of throwing so the recovery loop can classify it.
+     */
+    private attemptTurn;
+    private classifyFailure;
+    /**
+     * `requireMode` is a contract, not a hint: read the mode and the built-in
+     * tool set back from `init` before the first prompt and fail the turn when
+     * the CLI applied something else.
+     */
+    private verifyRequiredMode;
+    /**
+     * A resumed session must still have a transcript to resume from. Pending
+     * `tool_use` blocks without results are fine: the CLI re-runs interrupted
+     * turns on resume (`resume_reason` frames).
+     */
+    private auditRecoveryHistory;
+    private waitWithinDeadline;
+    private emitRecovery;
+    /**
+     * Ends recovery. `stage` names the reconnect step whose failure ended it;
+     * the reason alone does not say which step produced it.
+     */
+    private exhaustRecovery;
+    get metadata(): AgentSessionMetadata;
+    get usage(): AgentSessionUsage;
+    get history(): AgentSessionHistory;
+    private truncateNow;
+    on(event: 'text', handler: (text: string, parentToolCallId?: string) => void): void;
+    on(event: 'reasoning', handler: (text: string) => void): void;
+    on(event: 'tool_start', handler: (tool: string, input: string, args: Record<string, unknown>, callId?: string, parentToolCallId?: string) => void): void;
+    on(event: 'tool_complete', handler: (tool: string, output: string, callId?: string, parentToolCallId?: string) => void): void;
+    on(event: 'tool_complete_rich', handler: (tool: string, contents: ReadonlyArray<Record<string, unknown>>, callId?: string) => void): void;
+    on(event: 'tool_output', handler: (tool: string, output: string, parentToolCallId?: string) => void): void;
+    on(event: 'idle', handler: () => void): void;
+    on(event: 'error', handler: (err: Error) => void): void;
+    on(event: 'usage', handler: (data: Record<string, unknown>) => void): void;
+    on(event: 'tool_usage', handler: (data: ToolUsageData) => void): void;
+    on(event: 'compaction', handler: (phase: 'start' | 'complete', summary?: string) => void): void;
+    on(event: 'subagent_start', handler: (name: string, data: Record<string, unknown>) => void): void;
+    on(event: 'subagent_end', handler: (name: string, data: Record<string, unknown>) => void): void;
+    on(event: 'permission', handler: (data: Record<string, unknown>) => void): void;
+    on(event: 'recovery', handler: (event: SessionRecoveryEvent) => void): void;
+    on(event: 'intent', handler: (intent: string) => void): void;
+    /**
+     * Dynamic wiring for callers that forward an event name from configuration
+     * or a test table. Payloads are not checked on this arm; prefer the literal
+     * overloads.
+     */
+    on(event: string, handler: Handler): void;
+    abort(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=claude-session.d.ts.map

package/dist/runtimes/claude/claude-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-session.d.ts","sourceRoot":"","sources":["../../../runtimes/claude/claude-session.ts"],"names":[],"mappings":"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"}