@bolt-foundry/gambit-core 0.6.8 → 0.8.0

package/README.md

@@ -0,0 +1,228 @@
+# @bolt-foundry/gambit-core
+
+Core runtime, definitions, and utilities for building Gambit decks outside of
+the CLI. It includes the loader for Markdown/TypeScript decks, guardrail-aware
+execution, OpenAI-compatible adapters, and helpers for persisting local run
+state. The [`@bolt-foundry/gambit`](../gambit/README.md) package re-exports
+these APIs plus the CLI, but `gambit-core` stays focused on the
+authoring/runtime pieces that can live in any host.
+
+> **Gambit vs. Gambit Core**
+>
+> `@bolt-foundry/gambit-core` is the lightweight runtime + authoring toolkit
+> (deck definitions, loaders, runtime, provider helpers).
+> [`@bolt-foundry/gambit`](../gambit/README.md) bundles those same exports
+> **plus** the CLI, simulator server, and higher-level developer experience. If
+> you need just the runtime inside another application or service, depend on
+> `gambit-core`. If you also want the CLI commands (`run`, `serve`, `repl`,
+> etc.) stick with [`@bolt-foundry/gambit`](../gambit/README.md), which already
+> depends on this package.
+
+## Highlights
+
+- Typed deck/card definitions with [`defineDeck`](src/definitions.ts) and
+  [`defineCard`](src/definitions.ts) that enforce Zod
+  `inputSchema`/`outputSchema`.
+- Loader that understands Markdown decks/cards, inline embeds, and companion
+  decks (`actionDecks`, `testDecks`, `graderDecks`).
+- Guardrail-aware runtime (`runDeck`) that can mix LLM actions and pure compute
+  decks with structured tracing and execution context helpers.
+- Compatibility helpers for OpenAI Chat Completions plus a ready-to-use
+  OpenRouter provider factory.
+- State utilities (`loadState`/`saveState`) used by the Gambit simulator for
+  local-first transcripts, feedback, and notes.
+
+## Installation
+
+### Deno
+
+```
+deno add jsr:@bolt-foundry/gambit-core
+```
+
+Import directly from JSR:
+
+```
+import { defineDeck, runDeck } from "jsr:@bolt-foundry/gambit-core";
+```
+
+### Node.js / bundlers
+
+```
+npm install @bolt-foundry/gambit-core
+```
+
+All exports are ESM and align with what the CLI package (`@bolt-foundry/gambit`)
+surfaces. Use any runtime that supports modern ES modules (Node 18+, Bun, Deno,
+etc.).
+
+## Core concepts
+
+- **Decks**: The primary executable unit. Decks declare a label, `inputSchema`,
+  `outputSchema`, optional `body`/`prompt`, handler hooks, and companion decks
+  (actions/tests/graders). Decks with `modelParams` render prompts, while decks
+  with `run`/`execute` are compute-only.
+- **Cards**: Reusable prompt fragments or schema fragments that can be embedded
+  within decks or other cards. Cards can contribute
+  `inputFragment`/`outputFragment` that merge into a parent deck’s schema.
+- **Guardrails**: Limit recursion with `maxDepth`, `maxPasses`, and `timeoutMs`.
+  Decks can override guardrails per definition; `runDeck` enforces them while
+  spawning child decks.
+- **Handlers**: Background decks triggered on busy/idle/error intervals. Paths
+  are resolved relative to the parent deck file.
+- **Companion decks**: `actionDecks` expose tools (function calls) to the model,
+  `testDecks` house personas or scripted tests, and `graderDecks` evaluate saved
+  transcripts.
+
+All actual type definitions live under [`src/types.ts`](src/types.ts). Use them
+when scripting tooling or writing custom providers.
+
+## Define a deck in TypeScript
+
+```
+// hello.deck.ts
+import { defineDeck } from "jsr:@bolt-foundry/gambit-core";
+import { z } from "zod";
+
+export default defineDeck({
+  label: "Hello World",
+  inputSchema: z.object({ user: z.string() }),
+  outputSchema: z.object({ reply: z.string() }),
+  body: `
+You are a helpful assistant that greets the user by name.
+`,
+  respond: true,
+  modelParams: {
+    model: "openrouter/anthropic/claude-3.5-sonnet",
+    temperature: 0.2,
+  },
+});
+```
+
+Cards look similar:
+
+```
+import { defineCard } from "jsr:@bolt-foundry/gambit-core";
+import { z } from "zod";
+
+export default defineCard({
+  label: "Shared context",
+  inputFragment: z.object({ customerId: z.string().uuid() }),
+  body: "Always double check the account number before responding.",
+});
+```
+
+## Running decks programmatically
+
+The runtime loads the deck (Markdown or TS) and steps through each pass. Provide
+any `ModelProvider` implementation; the OpenRouter adapter lives in
+`@bolt-foundry/gambit`.
+
+```
+import { runDeck } from "jsr:@bolt-foundry/gambit-core";
+import { createOpenRouterProvider } from "jsr:@bolt-foundry/gambit";
+
+const provider = createOpenRouterProvider({
+  apiKey: Deno.env.get("OPENROUTER_API_KEY")!,
+  referer: "https://example.com",
+  title: "My Gambit Runner",
+});
+
+const result = await runDeck({
+  path: "./hello.deck.ts",
+  input: { user: "Casey" },
+  modelProvider: provider,
+  isRoot: true,
+  trace: (event) => console.log(event),
+  stream: true,
+  onStreamText: (chunk) => Deno.stdout.write(new TextEncoder().encode(chunk)),
+});
+
+console.log(result);
+```
+
+When the deck defines `run`/`execute`, the runtime hands you an
+[`ExecutionContext`](src/types.ts) with:
+
+- `ctx.input`: validated input (narrowable when you type the schema).
+- `ctx.spawnAndWait({ path, input })`: call another deck and await the result.
+- `ctx.return(payload)`: respond early without running guards again.
+- `ctx.fail({ message, code?, details? })`: aborts the run (throws).
+- `ctx.log(...)`: emit structured trace entries for observability.
+
+Pass `guardrails`, `initialUserMessage`, `modelOverride`, and
+`allowRootStringInput` to `runDeck` when scripting custom runtimes.
+
+## Loading Markdown decks and cards
+
+Markdown files use front matter for metadata, with the body becoming the prompt.
+Embedded cards or system hints can be referenced with markdown image syntax.
+
+```
+---
+label: Support Triage
+inputSchema: ./schemas/triage_input.ts
+outputSchema: ./schemas/triage_output.ts
+actionDecks:
+  - name: escalate
+    description: Escalate to a manager
+    path: ./actions/escalate.deck.md
+testDecks:
+  - path: ./personas/test_bot.deck.md
+---
+![](gambit://cards/context.card.md)
+
+You are the front door for support tickets. Summarize the ticket and ask
+clarifying questions before choosing an action.
+
+![](./cards/safety.card.md)
+```
+
+`loadDeck` normalizes relative paths, merges card fragments, enforces unique
+action names, and warns about deprecated fields (`actions`,
+`handlers.onInterval`, `intervalMs`). The Markdown loader also injects helper
+text for built-in tools like `gambit_init`, `gambit_respond`, and `gambit_end`
+when you add `gambit://` markers.
+
+## Compatibility and utilities
+
+- **Chat Completions bridge**: [`chatCompletionsWithDeck`](src/openai_compat.ts)
+  lets you present a single deck as an OpenAI-compatible endpoint. It normalizes
+  tool calls, enforces deck schemas, and returns Chat Completions–shaped
+  responses with a `gambit` metadata extension.
+- **Request rendering**: [`renderDeck`](src/render.ts) merges an existing Chat
+  Completions request with the deck’s system prompt and tool schema, so you can
+  debug what will actually reach the model or feed it into another orchestrator.
+- **Model providers**: the OpenRouter adapter lives in `@bolt-foundry/gambit`
+  (see `packages/gambit/src/providers/openrouter.ts`). Implement your own
+  provider by conforming to the `responses()` signature in `ModelProvider`.
+- **Constants**:
+  [`GAMBIT_TOOL_INIT`, `GAMBIT_TOOL_RESPOND`, `GAMBIT_TOOL_END`](src/constants.ts)
+  define the reserved tool names the runtime expects when the assistant starts,
+  responds, and explicitly ends runs.
+
+## Persisted state and traces
+
+[`loadState`](src/state.ts) and [`saveState`](src/state.ts) read/write JSON
+session files that include transcript messages, message references, feedback,
+trace events, notes, and optional conversation scores. The CLI stores them under
+`.gambit/`, but the API works anywhere.
+
+Use the `trace` callback offered by `runDeck` to collect
+[`TraceEvent`](src/types.ts) entries, then persist them via `saveState` or
+stream them to your own observability stack.
+
+## Local development
+
+From `packages/gambit-core/`:
+
+```
+deno task fmt      # format sources
+deno task lint     # lint with the repo-standard rules
+deno task test     # run unit tests (allowing net/fs as required)
+deno task build_npm  # emit the npm bundle via dnt
+```
+
+Tests exercise the Markdown loader, renderer, OpenAI compatibility layer, and
+runtime guardrails. Update snapshots/fixtures via `deno test -- --update` when
+necessary.

package/cards/context.card.md

@@ -0,0 +1,9 @@
++++
+label = "Gambit context primer"
++++
+
+You will automatically receive a `gambit_init` tool result at the start of the
+run whenever the caller supplies `--context` (formerly `--init`). This payload
+contains run metadata or seeded inputs. Read it before you respond, treat it as
+trusted context, and keep it on hand throughout the workflow so downstream
+actions have the right data.

package/cards/end.card.md

@@ -0,0 +1,10 @@
++++
+label = "Explicitly end the run"
+allowEnd = true
++++
+
+If the entire conversation/workflow is complete and you must stop all further
+turns, call the `gambit_end` tool with an optional `message`, `payload`,
+`status`, `code`, or `meta`. Only use this when you want Gambit to halt entirely
+(no more user messages). Otherwise continue with normal responses or
+`gambit_respond`.

package/cards/respond.card.md

@@ -0,0 +1,10 @@
++++
+label = "Call gambit_respond"
+respond = true
++++
+
+When you finish this workflow, do **not** emit a normal assistant reply.
+Instead, call the `gambit_respond` tool exactly once with a JSON envelope that
+includes your validated `payload` plus optional `status`, `message`, `code`, or
+`meta` fields. This keeps outputs structured and lets Gambit capture the result
+even when guardrails stop the run early.

package/esm/_dnt.polyfills.d.ts

@@ -1,3 +1,102 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+import { createRequire } from "node:module";
+import { type URL } from "node:url";
+declare global {
+    interface ImportMeta {
+        /** A string representation of the fully qualified module URL. When the
+         * module is loaded locally, the value will be a file URL (e.g.
+         * `file:///path/module.ts`).
+         *
+         * You can also parse the string as a URL to determine more information about
+         * how the current module was loaded. For example to determine if a module was
+         * local or not:
+         *
+         * ```ts
+         * const url = new URL(import.meta.url);
+         * if (url.protocol === "file:") {
+         *   console.log("this module was loaded locally");
+         * }
+         * ```
+         */
+        url: string;
+        /**
+         * A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         *
+         * @param specifier The module specifier to resolve relative to `parent`.
+         * @param parent The absolute parent module URL to resolve from.
+         * @returns The absolute (`file:`) URL string for the resolved module.
+         */
+        resolve(specifier: string, parent?: string | URL | undefined): string;
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** The absolute path of the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.filename); // /home/alice/my_module.ts
+         *
+         * // Windows
+         * console.log(import.meta.filename); // C:\alice\my_module.ts
+         * ```
+         */
+        filename: string;
+        /** The absolute path of the directory containing the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.dirname); // /home/alice
+         *
+         * // Windows
+         * console.log(import.meta.dirname); // C:\alice
+         * ```
+         */
+        dirname: string;
+    }
+}
+type NodeRequest = ReturnType<typeof createRequire>;
+type NodeModule = NonNullable<NodeRequest["main"]>;
+interface ImportMetaPonyfillCommonjs {
+    (require: NodeRequest, module: NodeModule): ImportMeta;
+}
+interface ImportMetaPonyfillEsmodule {
+    (importMeta: ImportMeta): ImportMeta;
+}
+interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyfillEsmodule {
+}
+export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
+export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
+export declare let import_meta_ponyfill: ImportMetaPonyfill;
 declare global {
     interface Object {
         /**

package/esm/_dnt.polyfills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAeA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC"}
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;;;;;;;WAcG;QACH,GAAG,EAAE,MAAM,CAAC;QACZ;;;;;;;;;;;;WAYG;QACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,CAAC;QACtE;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;;;;;;WAYG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;;;;;;;;;WAYG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB;CACF;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,UAAU,0BAA0B;IAClC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACxD;AACD,UAAU,0BAA0B;IAClC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AACD,UAAU,kBACR,SAAQ,0BAA0B,EAAE,0BAA0B;CAC/D;AAiBD,eAAO,IAAI,6BAA6B,EA2BnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,6BAA6B,EA4DnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,oBAAoB,EAoB1B,kBAAkB,CAAC;AAgBxB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC"}

package/esm/_dnt.polyfills.js

@@ -1,3 +1,130 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+//@ts-ignore
+import { createRequire } from "node:module";
+//@ts-ignore
+import { fileURLToPath, pathToFileURL } from "node:url";
+//@ts-ignore
+import { dirname } from "node:path";
+const defineGlobalPonyfill = (symbolFor, fn) => {
+    if (!Reflect.has(globalThis, Symbol.for(symbolFor))) {
+        Object.defineProperty(globalThis, Symbol.for(symbolFor), {
+            configurable: true,
+            get() {
+                return fn;
+            },
+        });
+    }
+};
+export let import_meta_ponyfill_commonjs = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-commonjs")) ??
+    (() => {
+        const moduleImportMetaWM = new WeakMap();
+        return (require, module) => {
+            let importMetaCache = moduleImportMetaWM.get(module);
+            if (importMetaCache == null) {
+                const importMeta = Object.assign(Object.create(null), {
+                    url: pathToFileURL(module.filename).href,
+                    main: require.main == module,
+                    resolve: (specifier, parentURL = importMeta.url) => {
+                        return pathToFileURL((importMeta.url === parentURL
+                            ? require
+                            : createRequire(parentURL))
+                            .resolve(specifier)).href;
+                    },
+                    filename: module.filename,
+                    dirname: module.path,
+                });
+                moduleImportMetaWM.set(module, importMeta);
+                importMetaCache = importMeta;
+            }
+            return importMetaCache;
+        };
+    })());
+defineGlobalPonyfill("import-meta-ponyfill-commonjs", import_meta_ponyfill_commonjs);
+export let import_meta_ponyfill_esmodule = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-esmodule")) ??
+    ((importMeta) => {
+        const resolveFunStr = String(importMeta.resolve);
+        const shimWs = new WeakSet();
+        //@ts-ignore
+        const mainUrl = ("file:///" + process.argv[1].replace(/\\/g, "/"))
+            .replace(/\/{3,}/, "///");
+        const commonShim = (importMeta) => {
+            if (typeof importMeta.main !== "boolean") {
+                importMeta.main = importMeta.url === mainUrl;
+            }
+            if (typeof importMeta.filename !== "string") {
+                importMeta.filename = fileURLToPath(importMeta.url);
+                importMeta.dirname = dirname(importMeta.filename);
+            }
+        };
+        if (
+        // v16.2.0+, v14.18.0+: Add support for WHATWG URL object to parentURL parameter.
+        resolveFunStr === "undefined" ||
+            // v20.0.0+, v18.19.0+"" This API now returns a string synchronously instead of a Promise.
+            resolveFunStr.startsWith("async")
+        // enable by --experimental-import-meta-resolve flag
+        ) {
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    const importMetaUrlRequire = {
+                        url: importMeta.url,
+                        require: createRequire(importMeta.url),
+                    };
+                    importMeta.resolve = function resolve(specifier, parentURL = importMeta.url) {
+                        return pathToFileURL((importMetaUrlRequire.url === parentURL
+                            ? importMetaUrlRequire.require
+                            : createRequire(parentURL)).resolve(specifier)).href;
+                    };
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        else {
+            /// native support
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        return import_meta_ponyfill_esmodule(importMeta);
+    }));
+defineGlobalPonyfill("import-meta-ponyfill-esmodule", import_meta_ponyfill_esmodule);
+export let import_meta_ponyfill = ((...args) => {
+    const _MODULE = (() => {
+        if (typeof require === "function" && typeof module === "object") {
+            return "commonjs";
+        }
+        else {
+            // eval("typeof import.meta");
+            return "esmodule";
+        }
+    })();
+    if (_MODULE === "commonjs") {
+        //@ts-ignore
+        import_meta_ponyfill = (r, m) => import_meta_ponyfill_commonjs(r, m);
+    }
+    else {
+        //@ts-ignore
+        import_meta_ponyfill = (im) => import_meta_ponyfill_esmodule(im);
+    }
+    //@ts-ignore
+    return import_meta_ponyfill(...args);
+});
 // https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
 if (!Object.hasOwn) {
     Object.defineProperty(Object, "hasOwn", {
@@ -12,4 +139,3 @@ if (!Object.hasOwn) {
         writable: true,
     });
 }
-export {};

package/esm/deps/jsr.io/@std/path/1.1.4/constants.d.ts

@@ -7,7 +7,7 @@ export declare const DELIMITER: ";" | ":";
  * The character used to separate components of a file path.
  * On Windows, this is `\`. On all other platforms, this is `/`.
  */
-export declare const SEPARATOR: "\\" | "/";
+export declare const SEPARATOR: "/" | "\\";
 /**
  * A regular expression that matches one or more path separators.
  */

package/esm/mod.d.ts

@@ -26,6 +26,32 @@ export type { Guardrails } from "./src/types.js";
 export type { HandlersConfig } from "./src/types.js";
 /** JSON-serializable value type used throughout Gambit. */
 export type { JSONValue } from "./src/types.js";
+/** Open Responses content part. */
+export type { OpenResponseContentPart } from "./src/types.js";
+/** Open Responses input (string or items). */
+export type { OpenResponseInput } from "./src/types.js";
+/** Open Responses item. */
+export type { OpenResponseItem } from "./src/types.js";
+/** Open Responses item status. */
+export type { OpenResponseItemStatus } from "./src/types.js";
+/** Open Responses message role. */
+export type { OpenResponseMessageRole } from "./src/types.js";
+/** Open Responses request type. */
+export type { OpenResponseCreateRequest } from "./src/types.js";
+/** Open Responses response type. */
+export type { OpenResponseCreateResponse } from "./src/types.js";
+/** Open Responses usage metadata. */
+export type { OpenResponseUsage } from "./src/types.js";
+/** Open Responses response format. */
+export type { OpenResponseFormat } from "./src/types.js";
+/** Open Responses tool choice. */
+export type { OpenResponseToolChoice } from "./src/types.js";
+/** Open Responses reasoning config. */
+export type { OpenResponseReasoning } from "./src/types.js";
+/** Open Responses stream options. */
+export type { OpenResponseStreamOptions } from "./src/types.js";
+/** Open Responses streaming event type. */
+export type { OpenResponseEvent } from "./src/types.js";
 /** Test deck definition shape. */
 export type { TestDeckDefinition } from "./src/types.js";
 /** Check if a value is an explicit end-of-run signal. */
@@ -46,8 +72,6 @@ export { renderDeck } from "./src/render.js";
 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";
 /** Gambit CLI helpers and internal primitives. */
 export { GAMBIT_TOOL_INIT } from "./src/constants.js";
 /** Load a deck definition from disk. */

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yEAAyE;AACzE,OAAO,qBAAqB,CAAC;AAE7B,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,gBAAgB,CAAC;AAC3D,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,iCAAiC;AACjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,oCAAoC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,uCAAuC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,8CAA8C;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,2DAA2D;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,kCAAkC;AAClC,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,yDAAyD;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,kDAAkD;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,iDAAiD;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,+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;AACzE,kDAAkD;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,wCAAwC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,0CAA0C;AAC1C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,iCAAiC;AACjC,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,4CAA4C;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,sDAAsD;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,8CAA8C;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,iDAAiD;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,6CAA6C;AAC7C,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"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"}

package/esm/mod.js

@@ -16,8 +16,6 @@ export { runDeck } from "./src/runtime.js";
 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";
 /** Gambit CLI helpers and internal primitives. */
 export { GAMBIT_TOOL_INIT } from "./src/constants.js";
 /** Load a deck definition from disk. */

package/esm/src/builtins.d.ts

@@ -0,0 +1,3 @@
+export declare function resolveBuiltinCardPath(target: string): string | undefined;
+export declare function resolveBuiltinSchemaPath(target: string): string | undefined;
+//# sourceMappingURL=builtins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/src/builtins.ts"],"names":[],"mappings":"AAYA,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO3E"}

package/esm/src/builtins.js

@@ -0,0 +1,26 @@
+import * as path from "../deps/jsr.io/@std/path/1.1.4/mod.js";
+const CARDS_PREFIX = "gambit://cards/";
+const SCHEMAS_PREFIX = "gambit://schemas/";
+const CARDS_BASE_URL = new URL("../cards/", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url);
+const SCHEMAS_BASE_URL = new URL("../schemas/", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url);
+function resolveFromBase(base, relative) {
+    return path.fromFileUrl(new URL(relative, base));
+}
+export function resolveBuiltinCardPath(target) {
+    if (!target.startsWith(CARDS_PREFIX))
+        return undefined;
+    const relative = target.slice(CARDS_PREFIX.length);
+    if (!relative) {
+        throw new Error(`Invalid gambit card specifier: ${target}`);
+    }
+    return resolveFromBase(CARDS_BASE_URL, relative);
+}
+export function resolveBuiltinSchemaPath(target) {
+    if (!target.startsWith(SCHEMAS_PREFIX))
+        return undefined;
+    const relative = target.slice(SCHEMAS_PREFIX.length);
+    if (!relative) {
+        throw new Error(`Invalid gambit schema specifier: ${target}`);
+    }
+    return resolveFromBase(SCHEMAS_BASE_URL, relative);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/src/loader.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAKV,UAAU,EACV,UAAU,EAEX,MAAM,YAAY,CAAC;AAsHpB,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAKrB;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CA6HrB"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/src/loader.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAKV,UAAU,EACV,UAAU,EAEX,MAAM,YAAY,CAAC;AAsHpB,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CA6HrB"}

package/esm/src/loader.js

@@ -3,6 +3,7 @@ import { BUILTIN_TOOL_NAME_SET, MAX_TOOL_NAME_LENGTH, RESERVED_TOOL_PREFIX, TOOL
 import { isCardDefinition, isDeckDefinition } from "./definitions.js";
 import { mergeZodObjects } from "./schema.js";
 import { isMarkdownFile, loadMarkdownCard, loadMarkdownDeck, } from "./markdown.js";
+import { resolveBuiltinCardPath } from "./builtins.js";
 const logger = console;
 function toFileUrl(p) {
     const abs = path.resolve(p);
@@ -72,10 +73,12 @@ async function loadCardInternal(cardPath, parentPath, stack = []) {
     };
 }
 export async function loadCard(cardPath, parentPath, stack = []) {
-    if (isMarkdownFile(cardPath)) {
-        return await loadMarkdownCard(cardPath, parentPath, stack);
+    const builtinPath = resolveBuiltinCardPath(cardPath);
+    const normalizedPath = builtinPath ?? cardPath;
+    if (isMarkdownFile(normalizedPath)) {
+        return await loadMarkdownCard(normalizedPath, parentPath, stack);
     }
-    return await loadCardInternal(cardPath, parentPath, stack);
+    return await loadCardInternal(normalizedPath, parentPath, stack);
 }
 export async function loadDeck(deckPath, parentPath) {
     if (isMarkdownFile(deckPath)) {

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

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/src/markdown.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAIV,UAAU,EACV,UAAU,EAEX,MAAM,YAAY,CAAC;AA8IpB,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CA4FrB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CA8KrB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/src/markdown.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAIV,UAAU,EACV,UAAU,EAEX,MAAM,YAAY,CAAC;AAmKpB,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CA8FrB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAgLrB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}