@llm4ts/core 2.42.0 → 2.43.0

package/dist/providers/GeminiModelBridge.d.ts

@@ -0,0 +1,108 @@
+import { type JsonRecord, type JsonValue } from "./CliSupport.ts";
+/**
+ * Gemini CLI as a plain model for pi (ADR 0037): the pure half of the
+ * bridge's `/v1/chat/completions` route. pi's OpenAI-shaped request becomes
+ * a system file (pi's own system prompt, a text tool-call protocol and pi's
+ * tool schemas) plus a transcript for one `gemini` call; Gemini's reply
+ * becomes an OpenAI completion carrying either text or one tool call. The
+ * runner owns the process and the HTTP; nothing here does I/O.
+ */
+export interface BridgeTool {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: JsonValue;
+}
+/** One message of pi's request, as the transcript needs it. */
+export type BridgeMessage = {
+    readonly role: "user";
+    readonly text: string;
+} | {
+    readonly role: "assistant";
+    readonly text: string;
+    readonly toolCalls: ReadonlyArray<{
+        readonly id: string;
+        readonly name: string;
+        readonly arguments: string;
+    }>;
+} | {
+    readonly role: "tool";
+    readonly callId: string;
+    readonly text: string;
+};
+export type ChatRequest = {
+    readonly _tag: "Request";
+    readonly model: string;
+    readonly stream: boolean;
+    readonly system: string;
+    readonly tools: ReadonlyArray<BridgeTool>;
+    readonly messages: ReadonlyArray<BridgeMessage>;
+} | {
+    readonly _tag: "Invalid";
+    readonly reason: string;
+};
+/** pi's OpenAI chat-completions body, read once at the boundary. */
+export declare const chatRequestFrom: (body: JsonValue) => ChatRequest;
+/** The protocol the model answers in: one `<tool_call>` block, or plain text. */
+export declare const toolCallProtocol: string;
+/**
+ * The file `GEMINI_SYSTEM_MD` points at: pi's system prompt, the protocol,
+ * every tool with its schema, and how the conversation is laid out. It
+ * replaces Gemini CLI's own system prompt entirely.
+ */
+export declare const systemFileFor: (request: Extract<ChatRequest, {
+    _tag: "Request";
+}>) => string;
+/** The conversation as the prompt of one `gemini` call. */
+export declare const transcriptFor: (messages: ReadonlyArray<BridgeMessage>) => string;
+export type ModelReply = {
+    readonly _tag: "Text";
+    readonly text: string;
+} | {
+    readonly _tag: "ToolCall";
+    /** Whatever the model wrote before the block. */
+    readonly text: string;
+    readonly name: string;
+    readonly arguments: JsonRecord;
+} | {
+    readonly _tag: "Malformed";
+    readonly text: string;
+    readonly error: string;
+};
+/** Gemini's reply as text, one tool call, or a block that is not a valid call. */
+export declare const parseModelReply: (reply: string, toolNames: ReadonlyArray<string>) => ModelReply;
+/** The one retry after a malformed call: the model sees its reply and why it failed. */
+export declare const correctionTranscript: (transcript: string, reply: string, error: string) => string;
+/** Gemini CLI's stats as llm4ts reads them: input is the uncached prompt. */
+export interface GeminiTokens {
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly cached?: number;
+}
+export interface OpenAiUsage {
+    readonly prompt_tokens: number;
+    readonly completion_tokens: number;
+    readonly total_tokens: number;
+    readonly prompt_tokens_details: {
+        readonly cached_tokens: number;
+    };
+}
+/** OpenAI's usage: the prompt includes cached tokens, which are also reported apart. */
+export declare const openAiUsage: (tokens: GeminiTokens | undefined) => OpenAiUsage;
+/** A non-streaming completion. A malformed reply that survived the retry goes back as text. */
+export declare const completionJson: (id: string, model: string, reply: ModelReply, usage: OpenAiUsage, created: number, callId: string) => JsonRecord;
+/**
+ * The same completion as stream chunks: the role, the text, the tool call,
+ * the finish reason, then the usage (`stream_options.include_usage`'s
+ * shape). The reply is whole before the first chunk: Gemini CLI runs to
+ * its end before the bridge parses it.
+ */
+export declare const completionChunks: (id: string, model: string, reply: ModelReply, usage: OpenAiUsage, created: number, callId: string) => ReadonlyArray<JsonRecord>;
+/**
+ * The admin policy that takes every tool out of the model's view: a deny
+ * rule without an argument pattern excludes the tool entirely, and `*`
+ * matches every tool, sub-agents included (probe runs 2–4, ADR 0037).
+ */
+export declare const denyAllToolsPolicyToml: string;
+/** Gemini CLI's system settings for a model-mode call: no sub-agents. */
+export declare const modelModeSettingsJson: string;
+//# sourceMappingURL=GeminiModelBridge.d.ts.map

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

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

package/dist/providers/GeminiModelBridge.js

@@ -0,0 +1,256 @@
+import { isJsonRecord, jsonArray, jsonField, jsonStringField, jsonText, parseJsonLine } from "./CliSupport.js";
+/** A message's text: a string, or the text parts of a content list (images are named, not sent). */
+const contentText = (content) => {
+    if (typeof content === "string") {
+        return content;
+    }
+    return jsonArray(content)
+        .map((part) => jsonStringField(part, "type") === "text"
+        ? (jsonStringField(part, "text") ?? "")
+        : `[${jsonStringField(part, "type") ?? "part"} omitted]`)
+        .join("\n");
+};
+/** pi's OpenAI chat-completions body, read once at the boundary. */
+export const chatRequestFrom = (body) => {
+    const model = jsonStringField(body, "model");
+    const raw = jsonField(body, "messages");
+    if (model === undefined || !Array.isArray(raw)) {
+        return { _tag: "Invalid", reason: "a chat request needs a model and a messages array" };
+    }
+    const system = [];
+    const messages = [];
+    for (const message of jsonArray(raw)) {
+        const role = jsonStringField(message, "role");
+        const text = contentText(jsonField(message, "content"));
+        if (role === "system" || role === "developer") {
+            system.push(text);
+        }
+        else if (role === "user") {
+            messages.push({ role: "user", text });
+        }
+        else if (role === "assistant") {
+            messages.push({
+                role: "assistant",
+                text,
+                toolCalls: jsonArray(jsonField(message, "tool_calls")).map((call) => ({
+                    id: jsonStringField(call, "id") ?? "",
+                    name: jsonStringField(jsonField(call, "function"), "name") ?? "",
+                    arguments: jsonStringField(jsonField(call, "function"), "arguments") ?? "{}"
+                }))
+            });
+        }
+        else if (role === "tool") {
+            messages.push({ role: "tool", callId: jsonStringField(message, "tool_call_id") ?? "", text });
+        }
+    }
+    const tools = jsonArray(jsonField(body, "tools")).flatMap((tool) => {
+        const fn = jsonField(tool, "function");
+        const name = jsonStringField(fn, "name");
+        return name === undefined
+            ? []
+            : [
+                {
+                    name,
+                    description: jsonStringField(fn, "description") ?? "",
+                    parameters: jsonField(fn, "parameters") ?? {}
+                }
+            ];
+    });
+    return {
+        _tag: "Request",
+        model,
+        stream: jsonField(body, "stream") === true,
+        system: system.filter((part) => part.trim().length > 0).join("\n\n"),
+        tools,
+        messages
+    };
+};
+/** The protocol the model answers in: one `<tool_call>` block, or plain text. */
+export const toolCallProtocol = [
+    "## Tools",
+    "",
+    "You cannot act yourself: you ask the caller to run a tool, and its result comes back as",
+    "the next message. To call a tool, reply with exactly one block and nothing after it:",
+    "",
+    '<tool_call>{"name": "<tool>", "arguments": {...}}</tool_call>',
+    "",
+    "The arguments are a JSON object matching the tool's parameters. Call one tool at a time.",
+    "When no tool is needed, reply in plain text without any <tool_call> block."
+].join("\n");
+/**
+ * The file `GEMINI_SYSTEM_MD` points at: pi's system prompt, the protocol,
+ * every tool with its schema, and how the conversation is laid out. It
+ * replaces Gemini CLI's own system prompt entirely.
+ */
+export const systemFileFor = (request) => [
+    request.system,
+    toolCallProtocol,
+    "",
+    "Available tools:",
+    ...request.tools.map((tool) => `- ${tool.name}: ${tool.description.trim()}\n  parameters (JSON Schema): ${jsonText(tool.parameters)}`),
+    "",
+    "## The conversation",
+    "",
+    "The conversation so far is given as a transcript of [user], [assistant] and [tool result]",
+    "sections, oldest first. Reply with your next assistant message only, without a section label."
+]
+    .filter((part) => part !== undefined)
+    .join("\n")
+    .trim();
+/** Normalised JSON of a call's arguments, so past calls read like the protocol asks. */
+const argumentsJson = (raw) => {
+    try {
+        const parsed = JSON.parse(raw);
+        return JSON.stringify(parsed);
+    }
+    catch {
+        return raw;
+    }
+};
+/** The conversation as the prompt of one `gemini` call. */
+export const transcriptFor = (messages) => {
+    const names = new Map();
+    const sections = messages.map((message) => {
+        switch (message.role) {
+            case "user":
+                return `[user]\n${message.text}`;
+            case "assistant": {
+                const calls = message.toolCalls.map((call) => {
+                    names.set(call.id, call.name);
+                    return `<tool_call>{"name":${JSON.stringify(call.name)},"arguments":${argumentsJson(call.arguments)}}</tool_call>`;
+                });
+                return `[assistant]\n${[message.text, ...calls].filter((part) => part.trim().length > 0).join("\n")}`;
+            }
+            case "tool":
+                return `[tool result for ${names.get(message.callId) ?? "a tool"} (${message.callId})]\n${message.text}`;
+        }
+    });
+    return `${sections.join("\n\n")}\n`;
+};
+/** Gemini's reply as text, one tool call, or a block that is not a valid call. */
+export const parseModelReply = (reply, toolNames) => {
+    const opened = reply.indexOf("<tool_call>");
+    if (opened < 0) {
+        return { _tag: "Text", text: reply.trim() };
+    }
+    const before = reply.slice(0, opened).trim();
+    const closed = reply.indexOf("</tool_call>", opened);
+    if (closed < 0) {
+        return { _tag: "Malformed", text: reply, error: "the <tool_call> block is not closed" };
+    }
+    const json = parseJsonLine(reply.slice(opened + "<tool_call>".length, closed).trim());
+    if (json === undefined || !isJsonRecord(json)) {
+        return { _tag: "Malformed", text: reply, error: "the block is not a valid JSON object" };
+    }
+    const name = jsonStringField(json, "name");
+    if (name === undefined || !toolNames.includes(name)) {
+        return {
+            _tag: "Malformed",
+            text: reply,
+            error: `"${name ?? "(no name)"}" is not one of the available tools (${toolNames.join(", ")})`
+        };
+    }
+    const args = jsonField(json, "arguments") ?? {};
+    return isJsonRecord(args)
+        ? { _tag: "ToolCall", text: before, name, arguments: args }
+        : { _tag: "Malformed", text: reply, error: "arguments is not a JSON object" };
+};
+/** The one retry after a malformed call: the model sees its reply and why it failed. */
+export const correctionTranscript = (transcript, reply, error) => [
+    transcript.trimEnd(),
+    "",
+    `[assistant]\n${reply.trim()}`,
+    "",
+    `[user]\nYour last reply could not be used: ${error}. Reply again with exactly one valid <tool_call> block, or with plain text if no tool is needed.`,
+    ""
+].join("\n");
+/** OpenAI's usage: the prompt includes cached tokens, which are also reported apart. */
+export const openAiUsage = (tokens) => {
+    const cached = tokens?.cached ?? 0;
+    const prompt = (tokens?.inputTokens ?? 0) + cached;
+    const completion = tokens?.outputTokens ?? 0;
+    return {
+        prompt_tokens: prompt,
+        completion_tokens: completion,
+        total_tokens: prompt + completion,
+        prompt_tokens_details: { cached_tokens: cached }
+    };
+};
+const usageJson = (usage) => ({
+    prompt_tokens: usage.prompt_tokens,
+    completion_tokens: usage.completion_tokens,
+    total_tokens: usage.total_tokens,
+    prompt_tokens_details: { cached_tokens: usage.prompt_tokens_details.cached_tokens }
+});
+const replyText = (reply) => reply.text;
+const toolCallJson = (reply, callId) => reply._tag === "ToolCall"
+    ? [
+        {
+            id: callId,
+            type: "function",
+            function: { name: reply.name, arguments: JSON.stringify(reply.arguments) }
+        }
+    ]
+    : [];
+/** A non-streaming completion. A malformed reply that survived the retry goes back as text. */
+export const completionJson = (id, model, reply, usage, created, callId) => {
+    const calls = toolCallJson(reply, callId);
+    const text = replyText(reply);
+    return {
+        id,
+        object: "chat.completion",
+        created,
+        model,
+        choices: [
+            {
+                index: 0,
+                message: {
+                    role: "assistant",
+                    content: text.length === 0 ? null : text,
+                    ...(calls.length === 0 ? {} : { tool_calls: calls })
+                },
+                finish_reason: calls.length === 0 ? "stop" : "tool_calls"
+            }
+        ],
+        usage: usageJson(usage)
+    };
+};
+/**
+ * The same completion as stream chunks: the role, the text, the tool call,
+ * the finish reason, then the usage (`stream_options.include_usage`'s
+ * shape). The reply is whole before the first chunk: Gemini CLI runs to
+ * its end before the bridge parses it.
+ */
+export const completionChunks = (id, model, reply, usage, created, callId) => {
+    const chunk = (delta, finish) => ({
+        id,
+        object: "chat.completion.chunk",
+        created,
+        model,
+        choices: [{ index: 0, delta, finish_reason: finish }]
+    });
+    const text = replyText(reply);
+    const calls = toolCallJson(reply, callId);
+    return [
+        chunk({ role: "assistant", content: "" }, null),
+        ...(text.length === 0 ? [] : [chunk({ content: text }, null)]),
+        ...calls.map((call, index) => chunk({ tool_calls: [{ index, ...call }] }, null)),
+        chunk({}, calls.length === 0 ? "stop" : "tool_calls"),
+        { id, object: "chat.completion.chunk", created, model, choices: [], usage: usageJson(usage) }
+    ];
+};
+/**
+ * The admin policy that takes every tool out of the model's view: a deny
+ * rule without an argument pattern excludes the tool entirely, and `*`
+ * matches every tool, sub-agents included (probe runs 2–4, ADR 0037).
+ */
+export const denyAllToolsPolicyToml = [
+    "[[rule]]",
+    'toolName = "*"',
+    'decision = "deny"',
+    "priority = 999",
+    ""
+].join("\n");
+/** Gemini CLI's system settings for a model-mode call: no sub-agents. */
+export const modelModeSettingsJson = JSON.stringify({ experimental: { enableAgents: false } });
+//# sourceMappingURL=GeminiModelBridge.js.map

package/dist/providers/GeminiModelBridge.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llm4ts/core",
-  "version": "2.42.0",
+  "version": "2.43.0",
   "description": "Effect-native LLM contracts, providers, tools, evaluation, and observability",
   "license": "MIT",
   "type": "module",
@@ -59,6 +59,7 @@
     "./providers/GeminiAcpSession": "./dist/providers/GeminiAcpSession.js",
     "./providers/GeminiApiProvider": "./dist/providers/GeminiApiProvider.js",
     "./providers/GeminiCliProvider": "./dist/providers/GeminiCliProvider.js",
+    "./providers/GeminiModelBridge": "./dist/providers/GeminiModelBridge.js",
     "./providers/GeminiModels": "./dist/providers/GeminiModels.js",
     "./providers/LmStudioModels": "./dist/providers/LmStudioModels.js",
     "./providers/LmStudioProvider": "./dist/providers/LmStudioProvider.js",

package/src/providers/GeminiModelBridge.ts

@@ -0,0 +1,363 @@
+import {
+  isJsonRecord,
+  jsonArray,
+  jsonField,
+  jsonStringField,
+  jsonText,
+  parseJsonLine,
+  type JsonRecord,
+  type JsonValue
+} from "./CliSupport.ts"
+
+/**
+ * Gemini CLI as a plain model for pi (ADR 0037): the pure half of the
+ * bridge's `/v1/chat/completions` route. pi's OpenAI-shaped request becomes
+ * a system file (pi's own system prompt, a text tool-call protocol and pi's
+ * tool schemas) plus a transcript for one `gemini` call; Gemini's reply
+ * becomes an OpenAI completion carrying either text or one tool call. The
+ * runner owns the process and the HTTP; nothing here does I/O.
+ */
+
+export interface BridgeTool {
+  readonly name: string
+  readonly description: string
+  readonly parameters: JsonValue
+}
+
+/** One message of pi's request, as the transcript needs it. */
+export type BridgeMessage =
+  | { readonly role: "user"; readonly text: string }
+  | {
+      readonly role: "assistant"
+      readonly text: string
+      readonly toolCalls: ReadonlyArray<{
+        readonly id: string
+        readonly name: string
+        readonly arguments: string
+      }>
+    }
+  | { readonly role: "tool"; readonly callId: string; readonly text: string }
+
+export type ChatRequest =
+  | {
+      readonly _tag: "Request"
+      readonly model: string
+      readonly stream: boolean
+      readonly system: string
+      readonly tools: ReadonlyArray<BridgeTool>
+      readonly messages: ReadonlyArray<BridgeMessage>
+    }
+  | { readonly _tag: "Invalid"; readonly reason: string }
+
+/** A message's text: a string, or the text parts of a content list (images are named, not sent). */
+const contentText = (content: JsonValue | undefined): string => {
+  if (typeof content === "string") {
+    return content
+  }
+  return jsonArray(content)
+    .map((part) =>
+      jsonStringField(part, "type") === "text"
+        ? (jsonStringField(part, "text") ?? "")
+        : `[${jsonStringField(part, "type") ?? "part"} omitted]`
+    )
+    .join("\n")
+}
+
+/** pi's OpenAI chat-completions body, read once at the boundary. */
+export const chatRequestFrom = (body: JsonValue): ChatRequest => {
+  const model = jsonStringField(body, "model")
+  const raw = jsonField(body, "messages")
+  if (model === undefined || !Array.isArray(raw)) {
+    return { _tag: "Invalid", reason: "a chat request needs a model and a messages array" }
+  }
+  const system: Array<string> = []
+  const messages: Array<BridgeMessage> = []
+  for (const message of jsonArray(raw)) {
+    const role = jsonStringField(message, "role")
+    const text = contentText(jsonField(message, "content"))
+    if (role === "system" || role === "developer") {
+      system.push(text)
+    } else if (role === "user") {
+      messages.push({ role: "user", text })
+    } else if (role === "assistant") {
+      messages.push({
+        role: "assistant",
+        text,
+        toolCalls: jsonArray(jsonField(message, "tool_calls")).map((call) => ({
+          id: jsonStringField(call, "id") ?? "",
+          name: jsonStringField(jsonField(call, "function"), "name") ?? "",
+          arguments: jsonStringField(jsonField(call, "function"), "arguments") ?? "{}"
+        }))
+      })
+    } else if (role === "tool") {
+      messages.push({ role: "tool", callId: jsonStringField(message, "tool_call_id") ?? "", text })
+    }
+  }
+  const tools = jsonArray(jsonField(body, "tools")).flatMap((tool): ReadonlyArray<BridgeTool> => {
+    const fn = jsonField(tool, "function")
+    const name = jsonStringField(fn, "name")
+    return name === undefined
+      ? []
+      : [
+          {
+            name,
+            description: jsonStringField(fn, "description") ?? "",
+            parameters: jsonField(fn, "parameters") ?? {}
+          }
+        ]
+  })
+  return {
+    _tag: "Request",
+    model,
+    stream: jsonField(body, "stream") === true,
+    system: system.filter((part) => part.trim().length > 0).join("\n\n"),
+    tools,
+    messages
+  }
+}
+
+/** The protocol the model answers in: one `<tool_call>` block, or plain text. */
+export const toolCallProtocol = [
+  "## Tools",
+  "",
+  "You cannot act yourself: you ask the caller to run a tool, and its result comes back as",
+  "the next message. To call a tool, reply with exactly one block and nothing after it:",
+  "",
+  '<tool_call>{"name": "<tool>", "arguments": {...}}</tool_call>',
+  "",
+  "The arguments are a JSON object matching the tool's parameters. Call one tool at a time.",
+  "When no tool is needed, reply in plain text without any <tool_call> block."
+].join("\n")
+
+/**
+ * The file `GEMINI_SYSTEM_MD` points at: pi's system prompt, the protocol,
+ * every tool with its schema, and how the conversation is laid out. It
+ * replaces Gemini CLI's own system prompt entirely.
+ */
+export const systemFileFor = (request: Extract<ChatRequest, { _tag: "Request" }>): string =>
+  [
+    request.system,
+    toolCallProtocol,
+    "",
+    "Available tools:",
+    ...request.tools.map(
+      (tool) =>
+        `- ${tool.name}: ${tool.description.trim()}\n  parameters (JSON Schema): ${jsonText(tool.parameters)}`
+    ),
+    "",
+    "## The conversation",
+    "",
+    "The conversation so far is given as a transcript of [user], [assistant] and [tool result]",
+    "sections, oldest first. Reply with your next assistant message only, without a section label."
+  ]
+    .filter((part) => part !== undefined)
+    .join("\n")
+    .trim()
+
+/** Normalised JSON of a call's arguments, so past calls read like the protocol asks. */
+const argumentsJson = (raw: string): string => {
+  try {
+    const parsed: unknown = JSON.parse(raw)
+    return JSON.stringify(parsed)
+  } catch {
+    return raw
+  }
+}
+
+/** The conversation as the prompt of one `gemini` call. */
+export const transcriptFor = (messages: ReadonlyArray<BridgeMessage>): string => {
+  const names = new Map<string, string>()
+  const sections = messages.map((message) => {
+    switch (message.role) {
+      case "user":
+        return `[user]\n${message.text}`
+      case "assistant": {
+        const calls = message.toolCalls.map((call) => {
+          names.set(call.id, call.name)
+          return `<tool_call>{"name":${JSON.stringify(call.name)},"arguments":${argumentsJson(call.arguments)}}</tool_call>`
+        })
+        return `[assistant]\n${[message.text, ...calls].filter((part) => part.trim().length > 0).join("\n")}`
+      }
+      case "tool":
+        return `[tool result for ${names.get(message.callId) ?? "a tool"} (${message.callId})]\n${message.text}`
+    }
+  })
+  return `${sections.join("\n\n")}\n`
+}
+
+export type ModelReply =
+  | { readonly _tag: "Text"; readonly text: string }
+  | {
+      readonly _tag: "ToolCall"
+      /** Whatever the model wrote before the block. */
+      readonly text: string
+      readonly name: string
+      readonly arguments: JsonRecord
+    }
+  | { readonly _tag: "Malformed"; readonly text: string; readonly error: string }
+
+/** Gemini's reply as text, one tool call, or a block that is not a valid call. */
+export const parseModelReply = (reply: string, toolNames: ReadonlyArray<string>): ModelReply => {
+  const opened = reply.indexOf("<tool_call>")
+  if (opened < 0) {
+    return { _tag: "Text", text: reply.trim() }
+  }
+  const before = reply.slice(0, opened).trim()
+  const closed = reply.indexOf("</tool_call>", opened)
+  if (closed < 0) {
+    return { _tag: "Malformed", text: reply, error: "the <tool_call> block is not closed" }
+  }
+  const json = parseJsonLine(reply.slice(opened + "<tool_call>".length, closed).trim())
+  if (json === undefined || !isJsonRecord(json)) {
+    return { _tag: "Malformed", text: reply, error: "the block is not a valid JSON object" }
+  }
+  const name = jsonStringField(json, "name")
+  if (name === undefined || !toolNames.includes(name)) {
+    return {
+      _tag: "Malformed",
+      text: reply,
+      error: `"${name ?? "(no name)"}" is not one of the available tools (${toolNames.join(", ")})`
+    }
+  }
+  const args = jsonField(json, "arguments") ?? {}
+  return isJsonRecord(args)
+    ? { _tag: "ToolCall", text: before, name, arguments: args }
+    : { _tag: "Malformed", text: reply, error: "arguments is not a JSON object" }
+}
+
+/** The one retry after a malformed call: the model sees its reply and why it failed. */
+export const correctionTranscript = (transcript: string, reply: string, error: string): string =>
+  [
+    transcript.trimEnd(),
+    "",
+    `[assistant]\n${reply.trim()}`,
+    "",
+    `[user]\nYour last reply could not be used: ${error}. Reply again with exactly one valid <tool_call> block, or with plain text if no tool is needed.`,
+    ""
+  ].join("\n")
+
+/** Gemini CLI's stats as llm4ts reads them: input is the uncached prompt. */
+export interface GeminiTokens {
+  readonly inputTokens?: number
+  readonly outputTokens?: number
+  readonly cached?: number
+}
+
+export interface OpenAiUsage {
+  readonly prompt_tokens: number
+  readonly completion_tokens: number
+  readonly total_tokens: number
+  readonly prompt_tokens_details: { readonly cached_tokens: number }
+}
+
+/** OpenAI's usage: the prompt includes cached tokens, which are also reported apart. */
+export const openAiUsage = (tokens: GeminiTokens | undefined): OpenAiUsage => {
+  const cached = tokens?.cached ?? 0
+  const prompt = (tokens?.inputTokens ?? 0) + cached
+  const completion = tokens?.outputTokens ?? 0
+  return {
+    prompt_tokens: prompt,
+    completion_tokens: completion,
+    total_tokens: prompt + completion,
+    prompt_tokens_details: { cached_tokens: cached }
+  }
+}
+
+const usageJson = (usage: OpenAiUsage): JsonRecord => ({
+  prompt_tokens: usage.prompt_tokens,
+  completion_tokens: usage.completion_tokens,
+  total_tokens: usage.total_tokens,
+  prompt_tokens_details: { cached_tokens: usage.prompt_tokens_details.cached_tokens }
+})
+
+const replyText = (reply: ModelReply): string => reply.text
+
+const toolCallJson = (reply: ModelReply, callId: string): ReadonlyArray<JsonRecord> =>
+  reply._tag === "ToolCall"
+    ? [
+        {
+          id: callId,
+          type: "function",
+          function: { name: reply.name, arguments: JSON.stringify(reply.arguments) }
+        }
+      ]
+    : []
+
+/** A non-streaming completion. A malformed reply that survived the retry goes back as text. */
+export const completionJson = (
+  id: string,
+  model: string,
+  reply: ModelReply,
+  usage: OpenAiUsage,
+  created: number,
+  callId: string
+): JsonRecord => {
+  const calls = toolCallJson(reply, callId)
+  const text = replyText(reply)
+  return {
+    id,
+    object: "chat.completion",
+    created,
+    model,
+    choices: [
+      {
+        index: 0,
+        message: {
+          role: "assistant",
+          content: text.length === 0 ? null : text,
+          ...(calls.length === 0 ? {} : { tool_calls: calls })
+        },
+        finish_reason: calls.length === 0 ? "stop" : "tool_calls"
+      }
+    ],
+    usage: usageJson(usage)
+  }
+}
+
+/**
+ * The same completion as stream chunks: the role, the text, the tool call,
+ * the finish reason, then the usage (`stream_options.include_usage`'s
+ * shape). The reply is whole before the first chunk: Gemini CLI runs to
+ * its end before the bridge parses it.
+ */
+export const completionChunks = (
+  id: string,
+  model: string,
+  reply: ModelReply,
+  usage: OpenAiUsage,
+  created: number,
+  callId: string
+): ReadonlyArray<JsonRecord> => {
+  const chunk = (delta: JsonRecord, finish: string | null): JsonRecord => ({
+    id,
+    object: "chat.completion.chunk",
+    created,
+    model,
+    choices: [{ index: 0, delta, finish_reason: finish }]
+  })
+  const text = replyText(reply)
+  const calls = toolCallJson(reply, callId)
+  return [
+    chunk({ role: "assistant", content: "" }, null),
+    ...(text.length === 0 ? [] : [chunk({ content: text }, null)]),
+    ...calls.map((call, index) => chunk({ tool_calls: [{ index, ...call }] }, null)),
+    chunk({}, calls.length === 0 ? "stop" : "tool_calls"),
+    { id, object: "chat.completion.chunk", created, model, choices: [], usage: usageJson(usage) }
+  ]
+}
+
+/**
+ * The admin policy that takes every tool out of the model's view: a deny
+ * rule without an argument pattern excludes the tool entirely, and `*`
+ * matches every tool, sub-agents included (probe runs 2–4, ADR 0037).
+ */
+export const denyAllToolsPolicyToml = [
+  "[[rule]]",
+  'toolName = "*"',
+  'decision = "deny"',
+  "priority = 999",
+  ""
+].join("\n")
+
+/** Gemini CLI's system settings for a model-mode call: no sub-agents. */
+export const modelModeSettingsJson = JSON.stringify({ experimental: { enableAgents: false } })