@bolt-foundry/gambit-core 0.5.3-dev

package/esm/src/openai_compat.js

@@ -0,0 +1,272 @@
+import { DEFAULT_GUARDRAILS, RESERVED_TOOL_PREFIX } from "./constants.js";
+import { loadDeck } from "./loader.js";
+import { assertZodSchema, toJsonSchema } from "./schema.js";
+import { runDeck } from "./runtime.js";
+export const logger = console;
+function randomId(prefix) {
+    const suffix = crypto.randomUUID().replace(/-/g, "").slice(0, 24);
+    return `${prefix}-${suffix}`;
+}
+function normalizeContent(content) {
+    if (content === null)
+        return null;
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return String(content);
+    return content
+        .map((c) => (typeof c === "string" ? c : (c.text ?? "")))
+        .join("");
+}
+function normalizeMessages(input) {
+    return input.map((m) => ({
+        role: m.role,
+        content: normalizeContent(m.content),
+        name: m.name,
+        tool_call_id: m.tool_call_id,
+        tool_calls: m.tool_calls && m.tool_calls.length > 0
+            ? m.tool_calls
+            : undefined,
+    }));
+}
+function providerParamsFromRequest(req) {
+    const out = {};
+    if (req.temperature !== undefined)
+        out.temperature = req.temperature;
+    if (req.top_p !== undefined)
+        out.top_p = req.top_p;
+    if (req.frequency_penalty !== undefined) {
+        out.frequency_penalty = req.frequency_penalty;
+    }
+    if (req.presence_penalty !== undefined) {
+        out.presence_penalty = req.presence_penalty;
+    }
+    if (req.max_tokens !== undefined)
+        out.max_tokens = req.max_tokens;
+    return Object.keys(out).length ? out : undefined;
+}
+function mergeToolDefs(gambitTools, externalTools) {
+    if (!externalTools?.length)
+        return gambitTools;
+    return [...gambitTools, ...externalTools];
+}
+function toolName(tool) {
+    return tool.function?.name ?? "";
+}
+function assertNoToolNameCollisions(args) {
+    if (!args.externalTools?.length)
+        return;
+    const gambit = new Set(args.gambitTools.map(toolName));
+    for (const t of args.externalTools) {
+        const name = toolName(t);
+        if (!name)
+            continue;
+        if (name.startsWith(RESERVED_TOOL_PREFIX)) {
+            throw new Error(`External tool name ${name} is reserved (prefix ${RESERVED_TOOL_PREFIX})`);
+        }
+        if (gambit.has(name)) {
+            throw new Error(`Tool name collision for ${name} between Gambit deck actions and external tools`);
+        }
+    }
+}
+async function buildGambitActionTools(deck) {
+    const tools = [];
+    const toolNameSet = new Set();
+    const actionPathByName = new Map();
+    for (const action of deck.actionDecks) {
+        const child = await loadDeck(action.path, deck.path);
+        if (!child.inputSchema || !child.outputSchema) {
+            throw new Error(`Deck ${child.path} must declare inputSchema and outputSchema (non-root)`);
+        }
+        assertZodSchema(child.inputSchema, "inputSchema");
+        assertZodSchema(child.outputSchema, "outputSchema");
+        const params = toJsonSchema(child.inputSchema);
+        tools.push({
+            type: "function",
+            function: {
+                name: action.name,
+                description: action.description,
+                parameters: params,
+            },
+        });
+        toolNameSet.add(action.name);
+        actionPathByName.set(action.name, action.path);
+    }
+    return { tools, toolNameSet, actionPathByName };
+}
+function deckSystemPrompt(deck) {
+    const parts = [];
+    const prompt = deck.body ?? deck.prompt;
+    if (prompt)
+        parts.push(prompt.trim());
+    for (const card of deck.cards) {
+        if (card.body)
+            parts.push(card.body.trim());
+    }
+    return parts.join("\n\n").trim();
+}
+function shouldPrependDeckSystem(messages, systemPrompt) {
+    if (!systemPrompt)
+        return false;
+    if (!messages.length)
+        return true;
+    const hasExact = messages.some((m) => m.role === "system" && m.content === systemPrompt);
+    return !hasExact;
+}
+function warnIfSystemMismatch(args) {
+    if (!args.systemPrompt)
+        return;
+    const existing = args.provided.find((m) => m.role === "system");
+    if (!existing)
+        return;
+    if (existing.content === args.systemPrompt)
+        return;
+    logger.warn(`[gambit] chatCompletionsWithDeck: request includes a system message that does not match the deck prompt (${args.deckPath})`);
+}
+function toolResultContent(result) {
+    if (typeof result === "string")
+        return result;
+    try {
+        return JSON.stringify(result);
+    }
+    catch {
+        return String(result);
+    }
+}
+function normalizeError(err) {
+    return { message: err instanceof Error ? err.message : String(err) };
+}
+export async function chatCompletionsWithDeck(args) {
+    const executeDeckTools = args.executeDeckTools ?? true;
+    const guardrails = { ...DEFAULT_GUARDRAILS, ...args.guardrails };
+    const runId = randomId("run");
+    const deck = await loadDeck(args.deckPath);
+    const systemPrompt = deckSystemPrompt(deck);
+    const providedMessages = normalizeMessages(args.request.messages);
+    const messages = [];
+    warnIfSystemMismatch({
+        provided: providedMessages,
+        systemPrompt,
+        deckPath: deck.path,
+    });
+    if (shouldPrependDeckSystem(providedMessages, systemPrompt)) {
+        messages.push({ role: "system", content: systemPrompt });
+    }
+    messages.push(...providedMessages);
+    const gambit = await buildGambitActionTools(deck);
+    assertNoToolNameCollisions({
+        gambitTools: gambit.tools,
+        externalTools: args.request.tools,
+    });
+    const tools = mergeToolDefs(gambit.tools, args.request.tools);
+    const start = performance.now();
+    let passes = 0;
+    while (passes < guardrails.maxPasses) {
+        passes++;
+        if (performance.now() - start > guardrails.timeoutMs) {
+            throw new Error("Timeout exceeded");
+        }
+        const model = args.request.model ?? args.defaultModel ??
+            (() => {
+                throw new Error("No model provided");
+            })();
+        const result = await args.modelProvider.chat({
+            model,
+            messages,
+            tools: tools.length ? tools : undefined,
+            stream: Boolean(args.request.stream),
+            onStreamText: args.onStreamText,
+            params: providerParamsFromRequest(args.request),
+        });
+        messages.push(result.message);
+        if (result.toolCalls && result.toolCalls.length > 0) {
+            const gambitCalls = result.toolCalls.filter((c) => gambit.toolNameSet.has(c.name));
+            const externalCalls = result.toolCalls.filter((c) => !gambit.toolNameSet.has(c.name));
+            if (!executeDeckTools || externalCalls.length > 0) {
+                return {
+                    id: randomId("chatcmpl"),
+                    object: "chat.completion",
+                    created: Math.floor(Date.now() / 1000),
+                    model,
+                    choices: [{
+                            index: 0,
+                            message: result.message,
+                            finish_reason: "tool_calls",
+                            logprobs: null,
+                        }],
+                    usage: result.usage
+                        ? {
+                            prompt_tokens: result.usage.promptTokens,
+                            completion_tokens: result.usage.completionTokens,
+                            total_tokens: result.usage.totalTokens,
+                        }
+                        : undefined,
+                    gambit: { deckPath: deck.path, messages, runId },
+                };
+            }
+            // Execute only deck-defined tool calls.
+            for (const call of gambitCalls) {
+                const actionPath = gambit.actionPathByName.get(call.name);
+                if (!actionPath)
+                    continue;
+                try {
+                    const childResult = await runDeck({
+                        path: actionPath,
+                        input: call.args,
+                        modelProvider: args.modelProvider,
+                        isRoot: false,
+                        guardrails,
+                        depth: 1,
+                        parentActionCallId: call.id,
+                        runId,
+                        defaultModel: model,
+                        modelOverride: undefined,
+                        trace: undefined,
+                        stream: Boolean(args.request.stream),
+                        onStreamText: args.onStreamText,
+                        inputProvided: true,
+                    });
+                    messages.push({
+                        role: "tool",
+                        name: call.name,
+                        tool_call_id: call.id,
+                        content: toolResultContent(childResult),
+                    });
+                }
+                catch (err) {
+                    messages.push({
+                        role: "tool",
+                        name: call.name,
+                        tool_call_id: call.id,
+                        content: JSON.stringify({ error: normalizeError(err) }),
+                    });
+                }
+            }
+            continue;
+        }
+        if (result.finishReason === "tool_calls") {
+            throw new Error("Model requested tool_calls but provided none");
+        }
+        return {
+            id: randomId("chatcmpl"),
+            object: "chat.completion",
+            created: Math.floor(Date.now() / 1000),
+            model,
+            choices: [{
+                    index: 0,
+                    message: result.message,
+                    finish_reason: result.finishReason,
+                    logprobs: null,
+                }],
+            usage: result.usage
+                ? {
+                    prompt_tokens: result.usage.promptTokens,
+                    completion_tokens: result.usage.completionTokens,
+                    total_tokens: result.usage.totalTokens,
+                }
+                : undefined,
+            gambit: { deckPath: deck.path, messages, runId },
+        };
+    }
+    throw new Error("Max passes exceeded without completing");
+}

package/esm/src/providers/openrouter.d.ts

@@ -0,0 +1,8 @@
+import type { ModelProvider } from "../types.js";
+export declare function createOpenRouterProvider(opts: {
+    apiKey: string;
+    baseURL?: string;
+    referer?: string;
+    title?: string;
+}): ModelProvider;
+//# sourceMappingURL=openrouter.d.ts.map

package/esm/src/providers/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../../src/src/providers/openrouter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EAEd,MAAM,aAAa,CAAC;AAwBrB,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,aAAa,CAqLhB"}

package/esm/src/providers/openrouter.js

@@ -0,0 +1,168 @@
+import * as dntShim from "../../_dnt.shims.js";
+import OpenAI from "openai";
+const logger = console;
+function normalizeMessage(content) {
+    const toolCalls = content.tool_calls ??
+        undefined;
+    return {
+        role: content.role,
+        content: typeof content.content === "string"
+            ? content.content
+            : Array.isArray(content.content)
+                ? content.content
+                    .map((c) => (typeof c === "string" ? c : ""))
+                    .join("")
+                : "",
+        name: content.name,
+        tool_call_id: content.tool_call_id,
+        tool_calls: toolCalls && toolCalls.length > 0 ? toolCalls : undefined,
+    };
+}
+export function createOpenRouterProvider(opts) {
+    const debugStream = dntShim.Deno.env.get("GAMBIT_DEBUG_STREAM") === "1";
+    const client = new OpenAI({
+        apiKey: opts.apiKey,
+        baseURL: opts.baseURL ?? "https://openrouter.ai/api/v1",
+        defaultHeaders: {
+            "HTTP-Referer": opts.referer ?? "https://gambit.local",
+            "X-Title": opts.title ?? "Gambit CLI",
+        },
+    });
+    return {
+        async chat(input) {
+            const params = input.params ?? {};
+            if (input.stream) {
+                if (debugStream) {
+                    logger.log(`[stream-debug] requesting stream model=${input.model} messages=${input.messages.length} tools=${input.tools?.length ?? 0}`);
+                }
+                const stream = await client.chat.completions.create({
+                    model: input.model,
+                    messages: input
+                        .messages,
+                    tools: input
+                        .tools,
+                    tool_choice: "auto",
+                    stream: true,
+                    ...params,
+                });
+                let finishReason = null;
+                const contentParts = [];
+                const toolCallMap = new Map();
+                let chunkCount = 0;
+                let streamedChars = 0;
+                for await (const chunk of stream) {
+                    chunkCount++;
+                    const choice = chunk.choices[0];
+                    const fr = choice.finish_reason;
+                    if (fr === "stop" || fr === "tool_calls" || fr === "length" ||
+                        fr === null) {
+                        finishReason = fr ?? finishReason;
+                    }
+                    const delta = choice.delta;
+                    if (typeof delta.content === "string") {
+                        contentParts.push(delta.content);
+                        input.onStreamText?.(delta.content);
+                        streamedChars += delta.content.length;
+                    }
+                    else if (Array.isArray(delta.content)) {
+                        const chunkStr = delta.content
+                            .map((c) => (typeof c === "string" ? c : ""))
+                            .join("");
+                        if (chunkStr) {
+                            contentParts.push(chunkStr);
+                            input.onStreamText?.(chunkStr);
+                            streamedChars += chunkStr.length;
+                        }
+                    }
+                    for (const tc of delta.tool_calls ?? []) {
+                        const idx = tc.index ?? 0;
+                        const existing = toolCallMap.get(idx) ??
+                            {
+                                id: tc.id,
+                                function: { name: tc.function?.name, arguments: "" },
+                            };
+                        if (tc.id)
+                            existing.id = tc.id;
+                        if (tc.function?.name)
+                            existing.function.name = tc.function.name;
+                        if (tc.function?.arguments) {
+                            existing.function.arguments += tc.function.arguments;
+                        }
+                        toolCallMap.set(idx, existing);
+                    }
+                }
+                if (debugStream) {
+                    logger.log(`[stream-debug] completed stream chunks=${chunkCount} streamedChars=${streamedChars} finishReason=${finishReason}`);
+                }
+                const tool_calls = Array.from(toolCallMap.values()).map((tc) => ({
+                    id: tc.id ?? crypto.randomUUID().replace(/-/g, "").slice(0, 24),
+                    type: "function",
+                    function: {
+                        name: tc.function.name ?? "",
+                        arguments: tc.function.arguments,
+                    },
+                }));
+                const message = normalizeMessage({
+                    role: "assistant",
+                    content: contentParts.length ? contentParts.join("") : null,
+                    tool_calls,
+                });
+                const toolCalls = tool_calls.length > 0
+                    ? tool_calls.map((tc) => ({
+                        id: tc.id,
+                        name: tc.function.name,
+                        args: safeJson(tc.function.arguments),
+                    }))
+                    : undefined;
+                return {
+                    message,
+                    finishReason: finishReason ?? "stop",
+                    toolCalls,
+                };
+            }
+            const response = await client.chat.completions.create({
+                model: input.model,
+                messages: input
+                    .messages,
+                tools: input
+                    .tools,
+                tool_choice: "auto",
+                stream: false,
+                ...params,
+            });
+            const choice = response.choices[0];
+            const message = choice.message;
+            const normalizedMessage = normalizeMessage(message);
+            const toolCalls = message.tool_calls?.map((tc) => ({
+                id: tc.id,
+                name: tc.function.name,
+                args: safeJson(tc.function.arguments),
+            }));
+            return {
+                message: normalizedMessage,
+                finishReason: choice.finish_reason ??
+                    "stop",
+                toolCalls,
+                usage: response.usage
+                    ? {
+                        promptTokens: response.usage.prompt_tokens ?? 0,
+                        completionTokens: response.usage.completion_tokens ?? 0,
+                        totalTokens: response.usage.total_tokens ?? 0,
+                    }
+                    : undefined,
+            };
+        },
+    };
+}
+function safeJson(str) {
+    try {
+        const parsed = JSON.parse(str);
+        if (parsed && typeof parsed === "object") {
+            return parsed;
+        }
+    }
+    catch {
+        // ignore bad tool args
+    }
+    return {};
+}

package/esm/src/render.d.ts

@@ -0,0 +1,51 @@
+import type { ModelMessage, ToolDefinition } from "./types.js";
+export declare const logger: Console;
+export type RenderChatCompletionsRequest = {
+    model?: string;
+    messages: Array<{
+        role: "system" | "user" | "assistant" | "tool";
+        content: string | null | Array<string | {
+            text?: string;
+            type?: string;
+        }>;
+        name?: string;
+        tool_call_id?: string;
+        tool_calls?: ModelMessage["tool_calls"];
+    }>;
+    tools?: Array<ToolDefinition>;
+    stream?: boolean;
+    temperature?: number;
+    top_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    max_tokens?: number;
+    [key: string]: unknown;
+};
+export type RenderDeckOptions = {
+    deckPath: string;
+    request: RenderChatCompletionsRequest;
+    includeDeckSystem?: boolean;
+    includeDeckTools?: boolean;
+    warnOnSystemMismatch?: boolean;
+};
+export type RenderDeckResult = {
+    request: {
+        model: string;
+        messages: Array<ModelMessage>;
+        tools?: Array<ToolDefinition>;
+        stream?: boolean;
+        temperature?: number;
+        top_p?: number;
+        frequency_penalty?: number;
+        presence_penalty?: number;
+        max_tokens?: number;
+        [key: string]: unknown;
+    };
+    gambit: {
+        deckPath: string;
+        systemPrompt: string;
+        actionPathsByName: Record<string, string>;
+    };
+};
+export declare function renderDeck(opts: RenderDeckOptions): Promise<RenderDeckResult>;
+//# sourceMappingURL=render.d.ts.map

package/esm/src/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/src/render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAe,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5E,eAAO,MAAM,MAAM,SAAU,CAAC;AAE9B,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;QAC/C,OAAO,EACH,MAAM,GACN,IAAI,GACJ,KAAK,CAAC,MAAM,GAAG;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACrD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;KACzC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,4BAA4B,CAAC;IACtC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAC9B,KAAK,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC3C,CAAC;CACH,CAAC;AA6JF,wBAAsB,UAAU,CAC9B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA0E3B"}

package/esm/src/render.js

@@ -0,0 +1,188 @@
+import { RESERVED_TOOL_PREFIX } from "./constants.js";
+import { loadDeck } from "./loader.js";
+import { assertZodSchema, toJsonSchema } from "./schema.js";
+export const logger = console;
+function normalizeContent(content) {
+    if (content === null)
+        return null;
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return String(content);
+    return content
+        .map((c) => (typeof c === "string" ? c : (c.text ?? "")))
+        .join("");
+}
+function normalizeMessages(input) {
+    return input.map((m) => ({
+        role: m.role,
+        content: normalizeContent(m.content),
+        name: m.name,
+        tool_call_id: m.tool_call_id,
+        tool_calls: m.tool_calls && m.tool_calls.length > 0
+            ? m.tool_calls
+            : undefined,
+    }));
+}
+function deckSystemPrompt(deck) {
+    const parts = [];
+    const prompt = deck.body ?? deck.prompt;
+    if (prompt)
+        parts.push(prompt.trim());
+    if (!deck.inlineEmbeds) {
+        for (const card of deck.cards) {
+            if (card.body)
+                parts.push(card.body.trim());
+        }
+    }
+    return parts.join("\n\n").trim();
+}
+function shouldPrependDeckSystem(messages, systemPrompt) {
+    if (!systemPrompt)
+        return false;
+    if (!messages.length)
+        return true;
+    const hasExact = messages.some((m) => m.role === "system" && m.content === systemPrompt);
+    return !hasExact;
+}
+function warnIfSystemMismatch(args) {
+    if (!args.systemPrompt)
+        return;
+    const existing = args.provided.find((m) => m.role === "system");
+    if (!existing)
+        return;
+    if (existing.content === args.systemPrompt)
+        return;
+    logger.warn(`[gambit] renderDeck: request includes a system message that does not match the deck prompt (${args.deckPath})`);
+}
+function toolName(tool) {
+    return tool.function?.name ?? "";
+}
+function assertNoToolNameCollisions(args) {
+    if (!args.externalTools?.length)
+        return;
+    const gambit = new Set(args.gambitTools.map(toolName));
+    for (const t of args.externalTools) {
+        const name = toolName(t);
+        if (!name)
+            continue;
+        if (name.startsWith(RESERVED_TOOL_PREFIX)) {
+            throw new Error(`External tool name ${name} is reserved (prefix ${RESERVED_TOOL_PREFIX})`);
+        }
+        if (gambit.has(name)) {
+            throw new Error(`Tool name collision for ${name} between Gambit deck actions and external tools`);
+        }
+    }
+}
+async function buildDeckActionTools(deckPath) {
+    const deck = await loadDeck(deckPath);
+    const tools = [];
+    const actionPathsByName = {};
+    for (const action of deck.actionDecks) {
+        const child = await loadDeck(action.path, deck.path);
+        if (!child.inputSchema || !child.outputSchema) {
+            throw new Error(`Deck ${child.path} must declare inputSchema and outputSchema (non-root)`);
+        }
+        assertZodSchema(child.inputSchema, "inputSchema");
+        assertZodSchema(child.outputSchema, "outputSchema");
+        const params = toJsonSchema(child.inputSchema);
+        tools.push({
+            type: "function",
+            function: {
+                name: action.name,
+                description: action.description,
+                parameters: params,
+            },
+        });
+        actionPathsByName[action.name] = action.path;
+    }
+    return { tools, actionPathsByName };
+}
+function mergeModelParams(req, deckParams) {
+    const out = { ...req };
+    if (!deckParams)
+        return out;
+    if (out.model === undefined && deckParams.model)
+        out.model = deckParams.model;
+    if (out.temperature === undefined && deckParams.temperature !== undefined) {
+        out.temperature = deckParams.temperature;
+    }
+    if (out.top_p === undefined && deckParams.top_p !== undefined) {
+        out.top_p = deckParams.top_p;
+    }
+    if (out.frequency_penalty === undefined &&
+        deckParams.frequency_penalty !== undefined) {
+        out.frequency_penalty = deckParams.frequency_penalty;
+    }
+    if (out.presence_penalty === undefined &&
+        deckParams.presence_penalty !== undefined) {
+        out.presence_penalty = deckParams.presence_penalty;
+    }
+    if (out.max_tokens === undefined && deckParams.max_tokens !== undefined) {
+        out.max_tokens = deckParams.max_tokens;
+    }
+    return out;
+}
+export async function renderDeck(opts) {
+    const includeDeckSystem = opts.includeDeckSystem ?? true;
+    const includeDeckTools = opts.includeDeckTools ?? true;
+    const warnOnSystemMismatch = opts.warnOnSystemMismatch ?? true;
+    const deck = await loadDeck(opts.deckPath);
+    const systemPrompt = deckSystemPrompt(deck);
+    const mergedReq = mergeModelParams(opts.request, deck.modelParams);
+    const providedMessages = normalizeMessages(mergedReq.messages);
+    const messages = [];
+    if (includeDeckSystem) {
+        if (warnOnSystemMismatch) {
+            warnIfSystemMismatch({
+                provided: providedMessages,
+                systemPrompt,
+                deckPath: deck.path,
+            });
+        }
+        if (shouldPrependDeckSystem(providedMessages, systemPrompt)) {
+            messages.push({ role: "system", content: systemPrompt });
+        }
+    }
+    messages.push(...providedMessages);
+    let tools = undefined;
+    let actionPathsByName = {};
+    if (includeDeckTools) {
+        const built = await buildDeckActionTools(deck.path);
+        actionPathsByName = built.actionPathsByName;
+        assertNoToolNameCollisions({
+            gambitTools: built.tools,
+            externalTools: mergedReq.tools,
+        });
+        tools = mergedReq.tools?.length
+            ? [...built.tools, ...mergedReq.tools]
+            : built.tools;
+    }
+    else if (mergedReq.tools?.length) {
+        for (const t of mergedReq.tools) {
+            const name = toolName(t);
+            if (name.startsWith(RESERVED_TOOL_PREFIX)) {
+                throw new Error(`External tool name ${name} is reserved (prefix ${RESERVED_TOOL_PREFIX})`);
+            }
+        }
+        tools = mergedReq.tools;
+    }
+    const model = String(mergedReq.model ?? "").trim();
+    if (!model) {
+        throw new Error(`renderDeck requires request.model (or deck.modelParams.model): ${deck.path}`);
+    }
+    const { messages: _m, tools: _t, ...rest } = mergedReq;
+    return {
+        request: {
+            ...rest,
+            model,
+            messages,
+            tools: tools && tools.length ? tools : undefined,
+        },
+        gambit: {
+            deckPath: deck.path,
+            systemPrompt,
+            actionPathsByName,
+        },
+    };
+}