condukt 0.25.0 → 0.27.0

package/dist/runtimes/claude/one-shot.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INTERNAL_MCP_TOOL_NAMES = exports.CONDUKT_MCP_SERVER_NAME = void 0;
+exports.runOneShot = runOneShot;
+exports.buildAdvisorStandInServer = buildAdvisorStandInServer;
+const claude_agent_sdk_1 = require("@anthropic-ai/claude-agent-sdk");
+const zod_1 = require("zod");
+const config_mapper_1 = require("./config-mapper");
+/**
+ * A single, isolated query: advisor, stand-in voter, or handoff summary.
+ *
+ * Isolation is deliberate and mirrors the Copilot one-shot session: no
+ * built-in tools, no MCP servers, no host settings discovery (`settingSources:
+ * []`), and `dontAsk` so nothing can prompt. `env` carries the protocol
+ * bridge's `ANTHROPIC_BASE_URL`/credentials; without it the CLI would call
+ * `api.anthropic.com` directly.
+ */
+async function runOneShot(opts) {
+    if (opts.signal?.aborted === true) {
+        return { text: '', usages: [], model: opts.model };
+    }
+    const abortController = new AbortController();
+    if (opts.signal !== undefined) {
+        opts.signal.addEventListener('abort', () => abortController.abort(), { once: true });
+    }
+    const config = {
+        model: opts.model,
+        cwd: opts.cwd,
+        addDirs: [],
+        timeout: 0,
+        heartbeatTimeout: 0,
+        ...(opts.system !== undefined ? { systemMessage: opts.system } : {}),
+    };
+    const mapped = (0, config_mapper_1.mapConfig)(config, {
+        oneShot: true,
+        ...(opts.env !== undefined ? { env: opts.env } : {}),
+    });
+    const options = {
+        ...mapped.options,
+        permissionMode: 'dontAsk',
+        allowDangerouslySkipPermissions: false,
+        abortController,
+    };
+    let text = '';
+    let usages = [];
+    const q = (0, claude_agent_sdk_1.query)({ prompt: opts.prompt, options });
+    try {
+        for await (const msg of q) {
+            if (msg.type === 'assistant') {
+                for (const block of msg.message.content) {
+                    if (block.type === 'text')
+                        text += block.text;
+                }
+            }
+            else if (msg.type === 'result') {
+                // A one-shot session is fresh, so its cumulative snapshot is this
+                // call's usage.
+                usages = usageRecords(msg.modelUsage, msg.duration_ms);
+                if (msg.subtype === 'success' && text.length === 0 && msg.result.length > 0) {
+                    text = msg.result;
+                }
+            }
+        }
+    }
+    finally {
+        try {
+            q.close();
+        }
+        catch { /* already closed */ }
+    }
+    return { text, usages, model: opts.model };
+}
+function count(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : 0;
+}
+function usageRecords(modelUsage, durationMs) {
+    const records = [];
+    for (const [model, usage] of Object.entries(modelUsage ?? {})) {
+        const cacheReadTokens = count(usage.cacheReadInputTokens);
+        const cacheWriteTokens = count(usage.cacheCreationInputTokens);
+        const inputTokens = count(usage.inputTokens) + cacheReadTokens + cacheWriteTokens;
+        const outputTokens = count(usage.outputTokens);
+        if (inputTokens === 0 && outputTokens === 0)
+            continue;
+        records.push({
+            inputTokens,
+            outputTokens,
+            totalTokens: inputTokens + outputTokens,
+            cacheReadTokens,
+            cacheWriteTokens,
+            model,
+            ...(durationMs !== undefined ? { duration: durationMs } : {}),
+        });
+    }
+    return records;
+}
+const CONSULT_SCHEMA = { question: zod_1.z.string(), transcript: zod_1.z.string().optional() };
+/** Name the session registers the internal advisor/stand-in server under. */
+exports.CONDUKT_MCP_SERVER_NAME = 'condukt';
+/**
+ * Qualified names of the internal tools. Under `dontAsk` only tools listed in
+ * `allowedTools` may run, and this server is added after `mapConfig`, so the
+ * session must add these itself or the model is denied its own advisor.
+ */
+exports.INTERNAL_MCP_TOOL_NAMES = [
+    `mcp__${exports.CONDUKT_MCP_SERVER_NAME}__advisor`,
+    `mcp__${exports.CONDUKT_MCP_SERVER_NAME}__stand_in`,
+];
+function buildAdvisorStandInServer(opts) {
+    const advisorModel = opts.config.advisor?.model;
+    const standInCfg = opts.config.standIn;
+    const tools = [];
+    const env = {
+        ...(opts.env !== undefined ? { env: opts.env } : {}),
+        ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+    };
+    if (advisorModel) {
+        tools.push((0, claude_agent_sdk_1.tool)('advisor', opts.config.advisor?.description ?? 'Consult a stronger reviewer model.', CONSULT_SCHEMA, async (args) => {
+            const prompt = [
+                opts.config.advisor?.system ?? '',
+                'Question: ' + args.question,
+                args.transcript ? 'Transcript:\n' + args.transcript : '',
+            ].filter(Boolean).join('\n\n');
+            const res = await runOneShot({ model: advisorModel, prompt, cwd: opts.cwd, ...env });
+            opts.onToolUsage({
+                tool: 'advisor',
+                model: res.model,
+                usages: res.usages,
+                sectionSizes: {
+                    focusChars: (opts.config.advisor?.system ?? '').length,
+                    contextChars: 0,
+                    transcriptChars: (args.transcript ?? '').length,
+                    promptChars: prompt.length,
+                },
+            });
+            return { content: [{ type: 'text', text: res.text }] };
+        }));
+    }
+    if (standInCfg) {
+        // StandInConfig shape: `members` (explicit models) and/or `memberCount`.
+        // Claude cannot auto-select from the copilot model catalogue, so a bare
+        // memberCount (without members) disables stand_in here.
+        const hasMembers = Array.isArray(standInCfg.members) && standInCfg.members.length > 0;
+        const hasBoth = hasMembers && standInCfg.memberCount !== undefined;
+        if (hasBoth) {
+            // eslint-disable-next-line no-console
+            console.warn('[condukt] standIn: configure members or memberCount, not both; disabling stand_in');
+        }
+        else if (hasMembers) {
+            const models = [...(standInCfg.members ?? [])];
+            const memberCount = standInCfg.memberCount ?? models.length;
+            if (models.length > 0) {
+                tools.push((0, claude_agent_sdk_1.tool)('stand_in', standInCfg.description ?? 'Consult multiple reviewer models for a cross-lab verdict.', CONSULT_SCHEMA, async (args) => {
+                    const prompt = ['Question: ' + args.question, args.transcript ? 'Transcript:\n' + args.transcript : ''].filter(Boolean).join('\n\n');
+                    const voters = models.slice(0, memberCount);
+                    const results = await Promise.all(voters.map((m) => runOneShot({ model: m, prompt, cwd: opts.cwd, ...env })));
+                    const ballots = results.map((r) => r.text).join('\n---\n');
+                    opts.onToolUsage({
+                        tool: 'stand_in',
+                        model: voters.join(','),
+                        usages: results.flatMap((r) => r.usages),
+                        sectionSizes: {
+                            focusChars: 0,
+                            contextChars: 0,
+                            transcriptChars: (args.transcript ?? '').length,
+                            promptChars: prompt.length,
+                        },
+                    });
+                    return { content: [{ type: 'text', text: ballots }] };
+                }));
+            }
+        }
+    }
+    if (tools.length === 0)
+        return null;
+    // `SdkMcpToolDefinition`'s handler parameter is contravariant, so the
+    // erased `SdkMcpToolDefinition<any>[]` element type rejects a concretely
+    // typed definition even though the runtime shapes are identical. Assert at
+    // this one boundary; every handler below is schema-checked by `tool()`.
+    return (0, claude_agent_sdk_1.createSdkMcpServer)({
+        name: exports.CONDUKT_MCP_SERVER_NAME,
+        version: '1.0.0',
+        tools: tools,
+    });
+}
+//# sourceMappingURL=one-shot.js.map

package/dist/runtimes/claude/one-shot.js.map

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

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

@@ -0,0 +1,138 @@
+/**
+ * Self-contained in-process protocol bridge.
+ *
+ * Exposes an Anthropic-compatible HTTP surface (for Claude SDK via
+ * ANTHROPIC_BASE_URL) and translates to any of the three OpenCode Go /
+ * Zen upstream protocols, applying cache instrumentation:
+ *
+ *   - anthropic  → raw pass-through (cache_control preserved)
+ *   - openai     → chat/completions translation (request + SSE)
+ *   - responses  → OpenAI Responses translation (request + SSE)
+ *
+ * Routing is model-driven (see protocol-router.ts), session-stickiness
+ * uses the `x-opencode-session` header, and prompt-cache keys are stamped
+ * on chat/completions with a 400-downgrade fallback. Requests to OpenCode
+ * hosts present the OpenCode client identity the Console expects (client
+ * User-Agent, `x-opencode-client`, client-shaped session id). Binds 127.0.0.1.
+ */
+import { type SessionEpochConstants } from './session-epoch';
+import { type ProtocolId } from './protocol-router';
+export interface BridgeConfig {
+    readonly port: number;
+    /** Upstream base URL (opencode base, /v1 base, or host base). */
+    readonly upstreamBaseUrl: string;
+    readonly upstreamApiKey?: string;
+    readonly sessionId: string;
+    readonly modelAliasMap?: Readonly<Record<string, string>>;
+    /** Force a single upstream protocol for every model. */
+    readonly protocol?: ProtocolId;
+    /** Explicit per-model protocol overrides (win over docs tables). */
+    readonly protocolMap?: Readonly<Record<string, ProtocolId>>;
+    /** Explicit per-protocol endpoint overrides (win over derivation). */
+    readonly endpoints?: Partial<Record<ProtocolId, string>>;
+    /** Optional Console (Zen) base URL for gap-fill of Zen-only models. */
+    readonly zenBaseUrl?: string;
+    /** Explicit per-protocol Zen endpoint overrides (win over derivation). */
+    readonly zenEndpoints?: Partial<Record<ProtocolId, string>>;
+    readonly bridgeSecret?: string;
+    readonly stateFile?: string;
+    readonly maxBodyBytes?: number;
+    readonly userAgent?: string;
+    readonly maxAttempts?: number;
+    readonly requestTimeoutMs?: number;
+    readonly keepAliveMs?: number;
+    readonly idleTimeoutMs?: number;
+    /** Kill-switch for prompt-cache stamping (default on). */
+    readonly cacheKeyEnabled?: boolean;
+    /** Kill-switch for session compaction epochs (-eN / -rM, default on). */
+    readonly epochEnabled?: boolean;
+    /** Kill-switch for stagnation rotation (-rM, requires epochs, default on). */
+    readonly epochRotateEnabled?: boolean;
+    /** Epoch sidecar path, or false to disable persistence. */
+    readonly epochStateFile?: string | false;
+    /** Threshold overrides for the epoch/rotation triggers (tests). */
+    readonly epochConstants?: Partial<SessionEpochConstants>;
+}
+export interface BridgeMetrics {
+    readonly requestCount: number;
+    readonly downgradeCount: number;
+    readonly cacheStampedCount: number;
+    readonly errorCount: number;
+    /** Exact/heuristic compaction bumps observed (eras advanced). */
+    readonly epochBumps: number;
+    /** Stagnation rotations observed (-rM advances). */
+    readonly epochRotations: number;
+    /** Prompt-cache read tokens summed over measured turns. */
+    readonly cacheReadTokens: number;
+    /** Prompt-cache creation tokens summed over measured turns. */
+    readonly cacheWriteTokens: number;
+    readonly protocolCounts: Readonly<Record<ProtocolId, number>>;
+}
+export interface BridgeHandle {
+    readonly port: number;
+    readonly baseUrl: string;
+    readonly endpoints: Readonly<Record<ProtocolId, string>>;
+    readonly zenEndpoints: Readonly<Record<ProtocolId, string>>;
+    readonly metrics: BridgeMetrics;
+    /**
+     * Exact compaction notification (the Claude SDK emits a compact
+     * boundary): advances the session era immediately so the first
+     * post-compaction request already carries the fresh identity.
+     */
+    notifyCompaction(): void;
+    close(): Promise<void>;
+}
+/**
+ * Per-session bridge configuration: everything from BridgeConfig except
+ * the port (0 = ephemeral) and session id (fresh per session by default,
+ * so prompt-cache keys stay isolated between sessions).
+ */
+export interface BridgeRuntimeConfig extends Omit<BridgeConfig, 'port' | 'sessionId'> {
+    readonly port?: number;
+    /** Force a fixed session id (tests / deliberate cache clustering). */
+    readonly sessionId?: string;
+}
+/**
+ * Environment for pointing the Claude CLI at the in-process bridge.
+ * The reference deployments use a fake key on both variables; the bridge
+ * itself authenticates upstream with `upstreamApiKey`.
+ */
+export declare function buildBridgeEnv(handle: BridgeHandle, opts?: {
+    readonly bridgeSecret?: string;
+    readonly apiKey?: string;
+}): Record<string, string>;
+/**
+ * OpenCode 2.x client User-Agent shape (`opencode/<channel>/<version>/<name>`,
+ * packages/core/src/app.ts). The Console reads it to recognise the client, so
+ * bridge requests to OpenCode hosts present it by default; `config.userAgent`
+ * still overrides.
+ */
+export declare const OPENCODE_CLIENT_USER_AGENT = "opencode/latest/2.0.32/cli";
+/**
+ * Abort signal that fires after `ms`, optionally chained to a parent
+ * signal. `clear()` releases the timer so long fetches do not leak.
+ */
+export declare function timeoutSignal(ms: number, parent?: AbortSignal): {
+    signal: AbortSignal;
+    clear: () => void;
+};
+/** Anthropic error type names an SDK client may branch on. */
+type AnthropicErrorType = 'invalid_request_error' | 'authentication_error' | 'permission_error' | 'not_found_error' | 'request_too_large' | 'rate_limit_error' | 'api_error' | 'overloaded_error';
+/**
+ * The Anthropic client branches on `error.type`, not on the HTTP status.
+ * Collapsing every 4xx into `invalid_request_error` makes a 401 look like a
+ * malformed request, and a client that would re-authenticate instead keeps
+ * resending the same rejected credential.
+ */
+export declare function anthropicErrorTypeForStatus(status: number): AnthropicErrorType;
+/**
+ * Epoch sidecar resolution: explicit config → `CONDUKT_EPOCH_PATH` →
+ * sibling of `stateFile` → default user path. `false` disables
+ * persistence. The home default is skipped under test runners
+ * (NODE_ENV=test / VITEST) so unit tests never write to a developer's
+ * home directory.
+ */
+export declare function resolveEpochStateFile(config: BridgeConfig): string | null;
+export declare function createBridge(config: BridgeConfig): Promise<BridgeHandle>;
+export {};
+//# sourceMappingURL=protocol-bridge.d.ts.map

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

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