@eir-labs/coltrane 0.24.30 → 0.24.32

package/dist/src/chat_completions_port.js

@@ -0,0 +1,221 @@
+// ── MCP ↔ function-calling, losslessly ───────────────────────────────────────────────────────────
+//
+// A readable name survives unchanged (the model reasons better about `mcp__coltrane__output_query`
+// than about a hex blob), and anything else is escaped reversibly. A name too long for either form
+// is truncated with a digest — legal and collision-resistant, but no longer invertible on its own,
+// which is why the reply is resolved through the offered list rather than by inverting the name.
+const SAFE_NAME = /^[A-Za-z0-9_-]{1,64}$/;
+const ESCAPE = "x0_";
+/** The wire's own bound on a function name. Legality is a SEPARATE property from losslessness — a
+ *  round-trip law proves the second and says nothing about the first, which is how a 68-character
+ *  name came to encode to 139 and pass every test. */
+const NAME_LIMIT = 64;
+const TRUNC = "x1_";
+/** A short deterministic digest, so two distinct long names cannot collapse onto one wire name. */
+function shortDigest(s) {
+    let h1 = 0x811c9dc5;
+    let h2 = 0x01000193;
+    for (let i = 0; i < s.length; i++) {
+        h1 = Math.imul(h1 ^ s.charCodeAt(i), 0x01000193) >>> 0;
+        h2 = Math.imul(h2 + s.charCodeAt(i) + i, 0x85ebca6b) >>> 0;
+    }
+    return h1.toString(36).padStart(7, "0") + h2.toString(36).padStart(7, "0");
+}
+/**
+ * An MCP name → a name the wire will actually accept: `[A-Za-z0-9_-]{1,64}`.
+ *
+ * Three tiers, and the third is the one this needed. A safe short name passes through unchanged,
+ * because a model reasons better about `mcp__coltrane__output_query` than about a hex blob. Anything
+ * else is hex-escaped, which is reversible. And a name too long for EITHER form is truncated with a
+ * digest — legal and collision-resistant, but no longer invertible on its own.
+ *
+ * That last tier is why the caller resolves replies through the tool list it holds rather than by
+ * inverting the name: a long-named tool stays callable instead of being refused for the shape of its
+ * name.
+ */
+export function encodeToolName(name) {
+    if (SAFE_NAME.test(name) && !name.startsWith(ESCAPE) && !name.startsWith(TRUNC))
+        return name;
+    let hex = "";
+    for (const byte of new TextEncoder().encode(name))
+        hex += byte.toString(16).padStart(2, "0");
+    const escaped = ESCAPE + hex;
+    if (escaped.length <= NAME_LIMIT)
+        return escaped;
+    const digest = shortDigest(name);
+    const room = NAME_LIMIT - TRUNC.length - digest.length - 1;
+    return `${TRUNC}${hex.slice(0, Math.max(0, room))}_${digest}`;
+}
+export function fromFunctionName(name) {
+    if (!name.startsWith(ESCAPE))
+        return name;
+    const hex = name.slice(ESCAPE.length);
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++)
+        bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    return new TextDecoder().decode(bytes);
+}
+export function toFunctionDef(tool) {
+    return {
+        type: "function",
+        function: {
+            name: encodeToolName(tool.name),
+            ...(tool.description !== undefined ? { description: tool.description } : {}),
+            parameters: tool.inputSchema,
+        },
+    };
+}
+/** A neutral transcript message → its wire shape. Assistant tool calls are encoded to wire names
+ *  and their args serialized; a tool result carries its id and content. */
+function toWireMessage(m) {
+    if (m.role === "assistant") {
+        const out = { role: "assistant", content: m.content };
+        if (m.tool_calls && m.tool_calls.length > 0) {
+            out["tool_calls"] = m.tool_calls.map((tc) => ({
+                id: tc.id,
+                type: "function",
+                function: { name: encodeToolName(tc.name), arguments: JSON.stringify(tc.args) },
+            }));
+        }
+        return out;
+    }
+    if (m.role === "tool") {
+        return { role: "tool", tool_call_id: m.tool_call_id, content: m.content };
+    }
+    return { role: m.role, content: m.content };
+}
+/** Split the wire's `prompt_tokens` into uncached input and cache reads (law 16). A cached prompt is
+ *  still the full prompt; the split is what makes the cache visible without inventing a class the
+ *  wire did not report. Absent usage stays absent — an unreported round is not a zero-token one.
+ *
+ *  Two wire shapes report the same split. The OpenAI shape folds hits into
+ *  `prompt_tokens_details.cached_tokens` and leaves `prompt_tokens` whole. A provider that reports
+ *  hits and misses SEPARATELY names them `prompt_cache_hit_tokens` / `prompt_cache_miss_tokens`;
+ *  there the cache hits are the hit count and the uncached input is the reported miss count directly.
+ *  Either way the prompt stays whole and only the reported split differs — pricing cache hits as
+ *  uncached input (the pre-cache-hit bug) would overcharge a run priced in cents. */
+function mapUsage(u) {
+    if (!u)
+        return undefined;
+    const cached = typeof u.prompt_cache_hit_tokens === "number"
+        ? u.prompt_cache_hit_tokens
+        : typeof u.prompt_tokens_details?.cached_tokens === "number"
+            ? u.prompt_tokens_details.cached_tokens
+            : 0;
+    const usage = {};
+    if (typeof u.prompt_cache_miss_tokens === "number")
+        usage.input_tokens = u.prompt_cache_miss_tokens;
+    else if (typeof u.prompt_tokens === "number")
+        usage.input_tokens = u.prompt_tokens - cached;
+    if (cached > 0)
+        usage.cache_read_tokens = cached;
+    if (typeof u.completion_tokens === "number")
+        usage.output_tokens = u.completion_tokens;
+    return usage;
+}
+function mapStop(finish) {
+    switch (finish) {
+        case "stop":
+            return "end";
+        case "tool_calls":
+            return "tool_use";
+        case "length":
+            return "max_tokens";
+        case "content_filter":
+            return "refusal";
+        default:
+            return finish ? "other" : undefined;
+    }
+}
+/**
+ * Build a `ModelPort` bound to one chat-completions endpoint. Each call POSTs the request and turns
+ * the reply into a neutral `ModelReply`; a non-2xx response THROWS with its status, so the loop can
+ * type it as `transport_failed` rather than the port swallowing it into a shrug.
+ */
+export function makeChatCompletionsPort(opts) {
+    const doFetch = opts.fetchFn ?? fetch;
+    // Strip trailing '/' in LINEAR time (CodeQL js/polynomial-redos, PR #534). The old `/\/+$/` regex
+    // retries its slash run from every start position, so a long run of INTERIOR slashes backtracks
+    // quadratically (measured 2,707 ms at 40,000 slashes). A backward char-code scan (47 === '/') is
+    // linear by construction and touches only the trailing run — interior slashes and the rest of the
+    // URL are left exactly as given.
+    let end = opts.baseUrl.length;
+    while (end > 0 && opts.baseUrl.charCodeAt(end - 1) === 47)
+        end--;
+    const url = `${opts.baseUrl.slice(0, end)}/chat/completions`;
+    return async (req) => {
+        // contract-tool-wire-name-collision-v1 (O3) — before building the reverse map or fetching, check
+        // that the request's tools INVERT: two tools that encode to one wire name would be sent as two
+        // identical function definitions, and `new Map(entries)` silently keeps only the last, so a reply
+        // naming that wire name resolves to whichever tool won. Fail closed HERE, the reachable layer the
+        // K6 witness named — throw (as this port's other unrecoverable argument faults do), naming both
+        // tools and the wire name they collapsed onto; never build the map from a set it cannot invert.
+        const wireNames = req.tools.map((t) => encodeToolName(t.name));
+        if (new Set(wireNames).size !== wireNames.length) {
+            const byWire = new Map();
+            req.tools.forEach((t, i) => {
+                const w = wireNames[i];
+                const names = byWire.get(w);
+                if (names)
+                    names.push(t.name);
+                else
+                    byWire.set(w, [t.name]);
+            });
+            const detail = [...byWire.entries()]
+                .filter(([, names]) => names.length > 1)
+                .map(([w, names]) => `${names.join(", ")} → ${w}`)
+                .join("; ");
+            throw new Error(`chat-completions tools collide on the wire (indistinguishable to the model): ${detail}. ` +
+                `Refusing rather than resolving a reply to whichever tool won the reverse map.`);
+        }
+        // The offered list is the authority on what a wire name means: build the reverse map from it so
+        // a reply resolves to the MCP name even when that name was too long to invert.
+        const byWireName = new Map(req.tools.map((t) => [encodeToolName(t.name), t.name]));
+        const body = {
+            model: req.model,
+            messages: req.messages.map(toWireMessage),
+            ...(req.tools.length > 0 ? { tools: req.tools.map(toFunctionDef) } : {}),
+            ...(req.max_tokens !== undefined ? { max_tokens: req.max_tokens } : {}),
+        };
+        const res = await doFetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json", authorization: `Bearer ${opts.apiKey}` },
+            body: JSON.stringify(body),
+            signal: req.signal,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`chat completions ${res.status}: ${text.slice(0, 300)}`);
+        }
+        const wire = (await res.json());
+        const choice = wire.choices?.[0];
+        const message = choice?.message ?? {};
+        const toolCalls = (message.tool_calls ?? []).map((tc) => {
+            const wireName = tc.function?.name ?? "";
+            let args = {};
+            try {
+                args = JSON.parse(tc.function?.arguments || "{}");
+            }
+            catch {
+                args = {};
+            }
+            return { id: tc.id ?? "", name: byWireName.get(wireName) ?? fromFunctionName(wireName), args };
+        });
+        const reply = {
+            message: {
+                content: message.content ?? null,
+                ...(toolCalls.length > 0 ? { tool_calls: toolCalls } : {}),
+            },
+        };
+        if (typeof wire.model === "string")
+            reply.model = wire.model;
+        const usage = mapUsage(wire.usage);
+        if (usage !== undefined)
+            reply.usage = usage;
+        const stop = mapStop(choice?.finish_reason);
+        if (stop !== undefined)
+            reply.stop = stop;
+        return reply;
+    };
+}
+//# sourceMappingURL=chat_completions_port.js.map

package/dist/src/chat_completions_port.js.map

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

package/dist/src/claude_invoker.d.ts

@@ -1,6 +1,7 @@
 import { type AgentInvocationContext, type AgentInvoker } from "./runtime.js";
 import type { Registry } from "./registry.js";
 import type { Depth, ModelTier } from "./pricing.js";
+import type { Effort } from "./genome_schema.js";
 import { type ToolProviderRegistry } from "./tool_providers.js";
 export declare const MODEL_TIER_MAP: Record<ModelTier, string>;
 /**
@@ -249,11 +250,28 @@ export declare const PROMPT_ARG_LIMIT_DEFAULT = 16000;
  * to the size test rather than failing a dispatch.
  */
 export declare function promptViaStdin(prompt: string): boolean;
+/**
+ * The `claude` session id a chair's conversation is NAMED by, derived deterministically from
+ * `(gig_id, role)`. The same seat used twice in one gig derives the SAME uuid, so its second reach
+ * can `--resume` the conversation the first opened instead of re-reading cold; two roles in one gig,
+ * or one role across two gigs, never collide (a v5-shaped uuid over a `gig_id\x1frole` string).
+ *
+ * A gig-less invocation (no `gig_id`) returns undefined: with nothing to key the session on there is
+ * nothing to name and nothing to resume, so the spawn carries neither `--session-id` nor `--resume`.
+ * The uuid is a valid RFC 4122 string (version nibble 5, variant 8–b) so the CLI accepts it as a
+ * session id and the spec's UUID shape holds.
+ */
+export declare function sessionUuidFor(gig_id: string | undefined, role: string | undefined): string | undefined;
 export declare function buildInvokerArgs(prompt: string, mcpConfigPath: string, opts: {
     model?: string | undefined;
     allowed_tools?: readonly string[] | undefined;
     disallowed_tools?: readonly string[] | undefined;
     max_tool_calls?: number | undefined;
+    effort?: Effort | undefined;
+    session_id?: string | undefined;
+    resume?: boolean | undefined;
+    fork_from_session?: string | undefined;
+    resume_session_at?: string | undefined;
 }): string[];
 /** Everything except the box's own credentials. Returns a plain object, so the spawn is given an
  *  explicit environment rather than inheriting one — the difference matters when a new secret is