@bolt-foundry/gambit 0.5.3-dev.1

package/esm/gambit/src/test_bot.d.ts

@@ -0,0 +1,5 @@
+export declare function sanitizeNumber(value: unknown, fallback: number, { min, max }: {
+    min: number;
+    max: number;
+}): number;
+//# sourceMappingURL=test_bot.d.ts.map

package/esm/gambit/src/test_bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_bot.d.ts","sourceRoot":"","sources":["../../../src/gambit/src/test_bot.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACzC,MAAM,CAGR"}

package/esm/gambit/src/test_bot.js

@@ -0,0 +1,5 @@
+export function sanitizeNumber(value, fallback, { min, max }) {
+    if (typeof value !== "number" || Number.isNaN(value))
+        return fallback;
+    return Math.max(min, Math.min(max, value));
+}

package/esm/gambit/src/trace.d.ts

@@ -0,0 +1,4 @@
+import type { TraceEvent } from "@bolt-foundry/gambit-core/internal/types";
+export declare function makeJsonlTracer(filePath: string): (event: TraceEvent) => void;
+export declare function makeConsoleTracer(): (event: TraceEvent) => void;
+//# sourceMappingURL=trace.d.ts.map

package/esm/gambit/src/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/gambit/src/trace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAI3E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAQ7E;AAED,wBAAgB,iBAAiB,IAAI,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAmI/D"}

package/esm/gambit/src/trace.js

@@ -0,0 +1,86 @@
+import * as dntShim from "../../_dnt.shims.js";
+import * as path from "../../deps/jsr.io/@std/path/1.1.4/mod.js";
+const logger = console;
+export function makeJsonlTracer(filePath) {
+    const resolved = path.resolve(filePath);
+    const dir = path.dirname(resolved);
+    dntShim.Deno.mkdirSync(dir, { recursive: true });
+    return (event) => {
+        const line = JSON.stringify(event);
+        dntShim.Deno.writeTextFileSync(resolved, line + "\n", { append: true });
+    };
+}
+export function makeConsoleTracer() {
+    const started = new Map();
+    const now = () => performance.now();
+    const fmtMs = (start) => start !== undefined ? ` elapsed_ms=${Math.round(now() - start)}` : "";
+    return (event) => {
+        switch (event.type) {
+            case "run.start":
+                started.set(event.runId, now());
+                logger.log(`[trace] run.start runId=${event.runId}${event.deckPath ? ` deck=${event.deckPath}` : ""}${event.initialUserMessage !== undefined
+                    ? ` initialUserMessage=${JSON.stringify(event.initialUserMessage)}`
+                    : ""}${event.input !== undefined
+                    ? ` input=${JSON.stringify(event.input)}`
+                    : ""}`);
+                break;
+            case "run.end": {
+                const start = started.get(event.runId);
+                started.delete(event.runId);
+                logger.log(`[trace] run.end runId=${event.runId}${fmtMs(start)}`);
+                break;
+            }
+            case "message.user": {
+                logger.log(`[trace] message.user runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath} content=${JSON.stringify(event.message?.content ?? "")}`);
+                break;
+            }
+            case "deck.start":
+                started.set(event.actionCallId, now());
+                logger.log(`[trace] deck.start runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath}`);
+                break;
+            case "deck.end": {
+                const start = started.get(event.actionCallId);
+                started.delete(event.actionCallId);
+                logger.log(`[trace] deck.end runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath}${fmtMs(start)}`);
+                break;
+            }
+            case "action.start":
+                started.set(event.actionCallId, now());
+                logger.log(`[trace] action.start runId=${event.runId} actionCallId=${event.actionCallId} name=${event.name} path=${event.path}`);
+                break;
+            case "action.end": {
+                const start = started.get(event.actionCallId);
+                started.delete(event.actionCallId);
+                logger.log(`[trace] action.end runId=${event.runId} actionCallId=${event.actionCallId} name=${event.name} path=${event.path}${fmtMs(start)}`);
+                break;
+            }
+            case "tool.call":
+                logger.log(`[trace] tool.call runId=${event.runId} actionCallId=${event.actionCallId} name=${event.name} args=${JSON.stringify(event.args)}`);
+                break;
+            case "tool.result":
+                logger.log(`[trace] tool.result runId=${event.runId} actionCallId=${event.actionCallId} name=${event.name} result=${JSON.stringify(event.result)}`);
+                break;
+            case "model.call":
+                logger.log(`[trace] model.call runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath} model=${event.model ?? "(default)"} messages=${event.messageCount ?? event.messages.length} tools=${event.toolCount ?? event.tools?.length ?? 0} stream=${event.stream ?? false} stateMessages=${event.stateMessages ?? 0}`);
+                break;
+            case "model.result":
+                logger.log(`[trace] model.result runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath} model=${event.model ?? "(default)"} finish=${event.finishReason} toolCalls=${event.toolCalls?.length ?? 0} stateMessages=${event.stateMessages ?? 0}`);
+                break;
+            case "log": {
+                const meta = event.meta !== undefined
+                    ? ` meta=${JSON.stringify(event.meta)}`
+                    : "";
+                const title = event.title ? ` title="${event.title}"` : "";
+                const msg = event.message ? ` msg="${event.message}"` : "";
+                logger.log(`[log] level=${event.level ?? "info"} runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath}${title}${msg}${meta}`);
+                break;
+            }
+            case "monolog": {
+                logger.log(`[monolog] runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath} content=${JSON.stringify(event.content)}`);
+                break;
+            }
+            default:
+                logger.log("[trace]", event);
+        }
+    };
+}

package/esm/gambit-core/mod.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Gambit core exports for authoring and running decks/cards with runtime helpers.
+ *
+ * @module
+ */
+/** Define a reusable card with shared behavior, tools, or guardrails. */
+export { defineCard } from "./src/definitions.js";
+/** Define a deck, the primary unit of execution. */
+export { defineDeck } from "./src/definitions.js";
+/** Action deck definition shape. */
+export type { ActionDeckDefinition } from "@bolt-foundry/gambit-core/internal/types";
+/** Card definition shape. */
+export type { CardDefinition } from "@bolt-foundry/gambit-core/internal/types";
+/** Deck definition shape. */
+export type { DeckDefinition } from "@bolt-foundry/gambit-core/internal/types";
+/** Reference to another deck. */
+export type { DeckReferenceDefinition } from "@bolt-foundry/gambit-core/internal/types";
+/** Execution context passed to decks. */
+export type { ExecutionContext } from "@bolt-foundry/gambit-core/internal/types";
+/** Grader deck definition shape. */
+export type { GraderDeckDefinition } from "@bolt-foundry/gambit-core/internal/types";
+/** Guardrails definition and hooks. */
+export type { Guardrails } from "@bolt-foundry/gambit-core/internal/types";
+/** JSON-serializable value type used throughout Gambit. */
+export type { JSONValue } from "@bolt-foundry/gambit-core/internal/types";
+/** Model provider interface for LLM backends. */
+export type { ModelProvider } from "@bolt-foundry/gambit-core/internal/types";
+/** Test deck definition shape. */
+export type { TestDeckDefinition } from "@bolt-foundry/gambit-core/internal/types";
+/** Check if a value is an explicit end-of-run signal. */
+export { isGambitEndSignal } from "@bolt-foundry/gambit-core/internal/runtime";
+/** Run a deck and return its execution result. */
+export { runDeck } from "@bolt-foundry/gambit-core/internal/runtime";
+/** Signal for explicitly ending a Gambit run. */
+export type { GambitEndSignal } from "@bolt-foundry/gambit-core/internal/runtime";
+/** OpenAI Chat Completions compatibility helper for a deck. */
+export { chatCompletionsWithDeck } from "./src/openai_compat.js";
+/** OpenAI-compatible request payload. */
+export type { ChatCompletionsRequest } from "./src/openai_compat.js";
+/** OpenAI-compatible response payload. */
+export type { ChatCompletionsResponse } from "./src/openai_compat.js";
+/** Render a deck to a human-readable outline or debug view. */
+export { renderDeck } from "./src/render.js";
+/** Options for deck rendering. */
+export type { RenderDeckOptions } from "./src/render.js";
+/** Result data from rendering a deck. */
+export type { RenderDeckResult } from "./src/render.js";
+/** Provider factory for OpenRouter-backed model calls. */
+export { createOpenRouterProvider } from "./src/providers/openrouter.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/gambit-core/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/gambit-core/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yEAAyE;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,oDAAoD;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,oCAAoC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/E,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/E,iCAAiC;AACjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AACjF,oCAAoC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,uCAAuC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,2DAA2D;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAC1E,iDAAiD;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,kCAAkC;AAClC,YAAY,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,yDAAyD;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,kDAAkD;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,4CAA4C,CAAC;AACrE,iDAAiD;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAClF,+DAA+D;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,yCAAyC;AACzC,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,0CAA0C;AAC1C,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,kCAAkC;AAClC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,0DAA0D;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC"}

package/esm/gambit-core/mod.js

@@ -0,0 +1,19 @@
+/**
+ * Gambit core exports for authoring and running decks/cards with runtime helpers.
+ *
+ * @module
+ */
+/** Define a reusable card with shared behavior, tools, or guardrails. */
+export { defineCard } from "./src/definitions.js";
+/** Define a deck, the primary unit of execution. */
+export { defineDeck } from "./src/definitions.js";
+/** Check if a value is an explicit end-of-run signal. */
+export { isGambitEndSignal } from "@bolt-foundry/gambit-core/internal/runtime";
+/** Run a deck and return its execution result. */
+export { runDeck } from "@bolt-foundry/gambit-core/internal/runtime";
+/** OpenAI Chat Completions compatibility helper for a deck. */
+export { chatCompletionsWithDeck } from "./src/openai_compat.js";
+/** Render a deck to a human-readable outline or debug view. */
+export { renderDeck } from "./src/render.js";
+/** Provider factory for OpenRouter-backed model calls. */
+export { createOpenRouterProvider } from "./src/providers/openrouter.js";

package/esm/gambit-core/src/definitions.d.ts

@@ -0,0 +1,11 @@
+import type { CardDefinition, DeckDefinition } from "@bolt-foundry/gambit-core/internal/types";
+import type { z } from "zod";
+export declare function defineDeck<InputSchema extends z.ZodTypeAny, OutputSchema extends z.ZodTypeAny | undefined = undefined>(def: Omit<DeckDefinition<z.infer<InputSchema>>, "kind" | "inputSchema" | "outputSchema"> & {
+    inputSchema: InputSchema;
+    outputSchema?: OutputSchema;
+}): DeckDefinition<z.infer<InputSchema>>;
+export declare function defineDeck(def: Omit<DeckDefinition, "kind">): DeckDefinition;
+export declare function defineCard(def: Omit<CardDefinition, "kind">): CardDefinition;
+export declare function isDeckDefinition(value: unknown): value is DeckDefinition;
+export declare function isCardDefinition(value: unknown): value is CardDefinition;
+//# sourceMappingURL=definitions.d.ts.map

package/esm/gambit-core/src/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/gambit-core/src/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/F,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAgB,UAAU,CACxB,WAAW,SAAS,CAAC,CAAC,UAAU,EAChC,YAAY,SAAS,CAAC,CAAC,UAAU,GAAG,SAAS,GAAG,SAAS,EAEzD,GAAG,EACC,IAAI,CACJ,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EACpC,MAAM,GAAG,aAAa,GAAG,cAAc,CACxC,GACC;IACA,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,GACF,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AACxC,wBAAgB,UAAU,CACxB,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAChC,cAAc,CAAC;AAOlB,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,cAAc,CAE5E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAKxE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAKxE"}

package/esm/gambit-core/src/definitions.js

@@ -0,0 +1,14 @@
+export function defineDeck(def) {
+    return { kind: "gambit.deck", ...def };
+}
+export function defineCard(def) {
+    return { kind: "gambit.card", ...def };
+}
+export function isDeckDefinition(value) {
+    return Boolean(value && typeof value === "object" &&
+        value.kind === "gambit.deck");
+}
+export function isCardDefinition(value) {
+    return Boolean(value && typeof value === "object" &&
+        value.kind === "gambit.card");
+}

package/esm/gambit-core/src/openai_compat.d.ts

@@ -0,0 +1,63 @@
+import type { Guardrails, ModelMessage, ModelProvider, ToolDefinition } from "@bolt-foundry/gambit-core/internal/types";
+export declare const logger: Console;
+export type ChatCompletionsRequest = {
+    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 ChatCompletionsResponse = {
+    id: string;
+    object: "chat.completion";
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: ModelMessage;
+        finish_reason: "stop" | "tool_calls" | "length";
+        logprobs: null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    /**
+     * Non-OpenAI extension field containing the full transcript and metadata.
+     * Most clients will ignore unknown fields.
+     */
+    gambit?: {
+        deckPath: string;
+        messages: Array<ModelMessage>;
+        runId: string;
+    };
+};
+export declare function chatCompletionsWithDeck(args: {
+    deckPath: string;
+    request: ChatCompletionsRequest;
+    modelProvider: ModelProvider;
+    /**
+     * When true (default), Gambit will execute tool calls that match deck actions.
+     * Any other tool calls are returned to the caller as normal OpenAI tool calls.
+     */
+    executeDeckTools?: boolean;
+    guardrails?: Partial<Guardrails>;
+    defaultModel?: string;
+    onStreamText?: (chunk: string) => void;
+}): Promise<ChatCompletionsResponse>;
+//# sourceMappingURL=openai_compat.d.ts.map

package/esm/gambit-core/src/openai_compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai_compat.d.ts","sourceRoot":"","sources":["../../../src/gambit-core/src/openai_compat.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EAEV,YAAY,EACZ,aAAa,EACb,cAAc,EACf,MAAM,0CAA0C,CAAC;AAElD,eAAO,MAAM,MAAM,SAAU,CAAC;AAO9B,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,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,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,YAAY,CAAC;QACtB,aAAa,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;QAChD,QAAQ,EAAE,IAAI,CAAC;KAChB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF;;;OAGG;IACH,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAoKF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,sBAAsB,CAAC;IAChC,aAAa,EAAE,aAAa,CAAC;IAC7B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAsJnC"}

package/esm/gambit-core/src/openai_compat.js

@@ -0,0 +1,272 @@
+import { DEFAULT_GUARDRAILS, RESERVED_TOOL_PREFIX } from "@bolt-foundry/gambit-core/internal/constants";
+import { loadDeck } from "@bolt-foundry/gambit-core/internal/loader";
+import { assertZodSchema, toJsonSchema } from "./schema.js";
+import { runDeck } from "@bolt-foundry/gambit-core/internal/runtime";
+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/gambit-core/src/providers/openrouter.d.ts

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

package/esm/gambit-core/src/providers/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../../../src/gambit-core/src/providers/openrouter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EAEd,MAAM,0CAA0C,CAAC;AAwBlD,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"}