@bolt-foundry/gambit-core 0.8.1 → 0.8.3

package/README.md

@@ -2,10 +2,10 @@
 
 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.
+execution, 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**
 >
@@ -22,13 +22,13 @@ authoring/runtime pieces that can live in any host.
 
 - Typed deck/card definitions with [`defineDeck`](src/definitions.ts) and
   [`defineCard`](src/definitions.ts) that enforce Zod
-  `inputSchema`/`outputSchema`.
+  `contextSchema`/`responseSchema`.
 - 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.
+- Response-first runtime helpers that plug into any model provider implementing
+  the core `ModelProvider` interface.
 - State utilities (`loadState`/`saveState`) used by the Gambit simulator for
   local-first transcripts, feedback, and notes.
 
@@ -58,13 +58,13 @@ 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.
+- **Decks**: The primary executable unit. Decks declare a label,
+  `contextSchema`, `responseSchema`, 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.
+  `contextFragment`/`responseFragment` 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.
@@ -86,8 +86,8 @@ import { z } from "zod";
 
 export default defineDeck({
   label: "Hello World",
-  inputSchema: z.object({ user: z.string() }),
-  outputSchema: z.object({ reply: z.string() }),
+  contextSchema: z.object({ user: z.string() }),
+  responseSchema: z.object({ reply: z.string() }),
   body: `
 You are a helpful assistant that greets the user by name.
 `,
@@ -107,7 +107,7 @@ import { z } from "zod";
 
 export default defineCard({
   label: "Shared context",
-  inputFragment: z.object({ customerId: z.string().uuid() }),
+  contextFragment: z.object({ customerId: z.string().uuid() }),
   body: "Always double check the account number before responding.",
 });
 ```
@@ -161,8 +161,8 @@ 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
+contextSchema: ./schemas/triage_input.ts
+responseSchema: ./schemas/triage_output.ts
 actionDecks:
   - name: escalate
     description: Escalate to a manager
@@ -181,25 +181,22 @@ clarifying questions before choosing an action.
 `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.
+text for built-in tools like `gambit_context`, `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`.
+- **Model providers**: adapters live 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.
+  [`GAMBIT_TOOL_CONTEXT`, `GAMBIT_TOOL_RESPOND`, `GAMBIT_TOOL_END`](src/constants.ts)
+  (`GAMBIT_TOOL_INIT` remains as a deprecated alias). define the reserved tool
+  names the runtime expects when the assistant starts, responds, and explicitly
+  ends runs.
 
 ## Persisted state and traces
 
@@ -223,6 +220,5 @@ 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.
+Tests exercise the Markdown loader, renderer, and runtime guardrails. Update
+snapshots/fixtures via `deno test -- --update` when necessary.

package/cards/context.card.md

@@ -2,8 +2,8 @@
 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.
+You will automatically receive a `gambit_context` 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/generate-test-input.card.md

@@ -0,0 +1,12 @@
++++
+label = "Generate test input"
++++
+
+When you receive a user message with:
+
+{ "type": "gambit_test_bot_init_fill", "missing": ["path.to.field", "..."],
+"current": { ... }, "schemaHints": [ ... ] }
+
+Return ONLY valid JSON that supplies values for the missing fields. Do not
+include any fields that are not listed in "missing". If the only missing path is
+"(root)", return the full init JSON value.

package/esm/mod.d.ts

@@ -26,6 +26,8 @@ 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 payload types. */
+export type { CreateResponseRequest, CreateResponseResponse, ResponseEvent, ResponseFunctionCallItem, ResponseFunctionCallOutputItem, ResponseItem, ResponseMessageItem, ResponseTextContent, ResponseToolChoice, ResponseToolDefinition, ResponseUsage, } 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. */
@@ -34,22 +36,20 @@ export { isGambitEndSignal } from "./src/runtime.js";
 export { runDeck } from "./src/runtime.js";
 /** Signal for explicitly ending a Gambit run. */
 export type { GambitEndSignal } from "./src/runtime.js";
-/** 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";
+/** Default guardrail settings applied to deck runs. */
+export { DEFAULT_GUARDRAILS } from "./src/constants.js";
+/** Reserved tool name prefix for Gambit tools. */
+export { RESERVED_TOOL_PREFIX } from "./src/constants.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";
+/** Schema helpers for ensuring Zod input/output shapes. */
+export { assertZodSchema, toJsonSchema } from "./src/schema.js";
 /** Gambit CLI helpers and internal primitives. */
-export { GAMBIT_TOOL_INIT } from "./src/constants.js";
+export { GAMBIT_TOOL_CONTEXT, GAMBIT_TOOL_INIT } from "./src/constants.js";
 /** Load a deck definition from disk. */
 export { loadDeck } from "./src/loader.js";
 /** Persisted run state stored on disk. */
@@ -64,6 +64,8 @@ export type { LoadedDeck } from "./src/types.js";
 export type { ModelMessage } from "./src/types.js";
 /** Model provider interface for LLM backends. */
 export type { ModelProvider } from "./src/types.js";
+/** Tool definition passed to model providers. */
+export type { ToolDefinition } from "./src/types.js";
 /** Trace events emitted during execution. */
 export type { TraceEvent } from "./src/types.js";
 //# sourceMappingURL=mod.d.ts.map

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

@@ -12,14 +12,16 @@ export { defineDeck } from "./src/definitions.js";
 export { isGambitEndSignal } from "./src/runtime.js";
 /** Run a deck and return its execution result. */
 export { runDeck } from "./src/runtime.js";
-/** OpenAI Chat Completions compatibility helper for a deck. */
-export { chatCompletionsWithDeck } from "./src/openai_compat.js";
+/** Default guardrail settings applied to deck runs. */
+export { DEFAULT_GUARDRAILS } from "./src/constants.js";
+/** Reserved tool name prefix for Gambit tools. */
+export { RESERVED_TOOL_PREFIX } from "./src/constants.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";
+/** Schema helpers for ensuring Zod input/output shapes. */
+export { assertZodSchema, toJsonSchema } from "./src/schema.js";
 /** Gambit CLI helpers and internal primitives. */
-export { GAMBIT_TOOL_INIT } from "./src/constants.js";
+export { GAMBIT_TOOL_CONTEXT, GAMBIT_TOOL_INIT } from "./src/constants.js";
 /** Load a deck definition from disk. */
 export { loadDeck } from "./src/loader.js";
 /** Persisted run state stored on disk. */

package/esm/src/constants.d.ts

@@ -6,6 +6,10 @@ export declare const DEFAULT_GUARDRAILS: {
 export declare const RESERVED_TOOL_PREFIX = "gambit_";
 export declare const TOOL_NAME_PATTERN: RegExp;
 export declare const MAX_TOOL_NAME_LENGTH = 64;
+export declare const GAMBIT_TOOL_CONTEXT = "gambit_context";
+/**
+ * @deprecated Use GAMBIT_TOOL_CONTEXT instead.
+ */
 export declare const GAMBIT_TOOL_INIT = "gambit_init";
 export declare const GAMBIT_TOOL_RESPOND = "gambit_respond";
 export declare const GAMBIT_TOOL_COMPLETE = "gambit_complete";

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAC5D,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AACpD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAKpD,CAAC;AAGH,eAAO,MAAM,uBAAuB,MAAM,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAC5D,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AACpD;;GAEG;AACH,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AACpD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAMpD,CAAC;AAGH,eAAO,MAAM,uBAAuB,MAAM,CAAC"}

package/esm/src/constants.js

@@ -6,11 +6,16 @@ export const DEFAULT_GUARDRAILS = {
 export const RESERVED_TOOL_PREFIX = "gambit_";
 export const TOOL_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
 export const MAX_TOOL_NAME_LENGTH = 64;
+export const GAMBIT_TOOL_CONTEXT = "gambit_context";
+/**
+ * @deprecated Use GAMBIT_TOOL_CONTEXT instead.
+ */
 export const GAMBIT_TOOL_INIT = "gambit_init";
 export const GAMBIT_TOOL_RESPOND = "gambit_respond";
 export const GAMBIT_TOOL_COMPLETE = "gambit_complete";
 export const GAMBIT_TOOL_END = "gambit_end";
 export const BUILTIN_TOOL_NAME_SET = new Set([
+    GAMBIT_TOOL_CONTEXT,
     GAMBIT_TOOL_INIT,
     GAMBIT_TOOL_RESPOND,
     GAMBIT_TOOL_COMPLETE,

package/esm/src/definitions.d.ts

@@ -1,6 +1,10 @@
 import type { CardDefinition, DeckDefinition } from "./types.js";
 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"> & {
+export declare function defineDeck<InputSchema extends z.ZodTypeAny, OutputSchema extends z.ZodTypeAny | undefined = undefined>(def: Omit<DeckDefinition<z.infer<InputSchema>>, "kind" | "contextSchema" | "responseSchema" | "inputSchema" | "outputSchema"> & {
+    contextSchema: InputSchema;
+    responseSchema?: OutputSchema;
+}): DeckDefinition<z.infer<InputSchema>>;
+export declare function defineDeck<InputSchema extends z.ZodTypeAny, OutputSchema extends z.ZodTypeAny | undefined = undefined>(def: Omit<DeckDefinition<z.infer<InputSchema>>, "kind" | "contextSchema" | "responseSchema" | "inputSchema" | "outputSchema"> & {
     inputSchema: InputSchema;
     outputSchema?: OutputSchema;
 }): DeckDefinition<z.infer<InputSchema>>;

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

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/src/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,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"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/src/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,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,EAClC,MAAM,GACN,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,cAAc,CACjB,GACC;IACA,aAAa,EAAE,WAAW,CAAC;IAC3B,cAAc,CAAC,EAAE,YAAY,CAAC;CAC/B,GACF,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AACxC,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,EAClC,MAAM,GACN,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,cAAc,CACjB,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/src/loader.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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;AAgMpB,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,CAsIrB"}

package/esm/src/loader.js

@@ -5,6 +5,54 @@ import { mergeZodObjects } from "./schema.js";
 import { isMarkdownFile, loadMarkdownCard, loadMarkdownDeck, } from "./markdown.js";
 import { resolveBuiltinCardPath } from "./builtins.js";
 const logger = console;
+const LEGACY_SCHEMA_WARNINGS = new Set();
+const LEGACY_FRAGMENT_WARNINGS = new Set();
+function warnLegacySchema(resolvedPath, legacy, replacement) {
+    const key = `${resolvedPath}:${legacy}`;
+    if (LEGACY_SCHEMA_WARNINGS.has(key))
+        return;
+    LEGACY_SCHEMA_WARNINGS.add(key);
+    logger.warn(`[gambit] deck at ${resolvedPath} uses deprecated "${legacy}"; rename to "${replacement}"`);
+}
+function warnLegacyFragment(resolvedPath, legacy, replacement) {
+    const key = `${resolvedPath}:${legacy}`;
+    if (LEGACY_FRAGMENT_WARNINGS.has(key))
+        return;
+    LEGACY_FRAGMENT_WARNINGS.add(key);
+    logger.warn(`[gambit] card at ${resolvedPath} uses deprecated "${legacy}"; rename to "${replacement}"`);
+}
+function normalizeDeckSchemas(deck, resolvedPath) {
+    if (deck.inputSchema !== undefined) {
+        warnLegacySchema(resolvedPath, "inputSchema", "contextSchema");
+    }
+    if (deck.outputSchema !== undefined) {
+        warnLegacySchema(resolvedPath, "outputSchema", "responseSchema");
+    }
+    const contextSchema = deck.contextSchema ?? deck.inputSchema;
+    const responseSchema = deck.responseSchema ?? deck.outputSchema;
+    return {
+        contextSchema,
+        responseSchema,
+        inputSchema: contextSchema,
+        outputSchema: responseSchema,
+    };
+}
+function normalizeCardFragments(card, resolvedPath) {
+    if (card.inputFragment !== undefined) {
+        warnLegacyFragment(resolvedPath, "inputFragment", "contextFragment");
+    }
+    if (card.outputFragment !== undefined) {
+        warnLegacyFragment(resolvedPath, "outputFragment", "responseFragment");
+    }
+    const contextFragment = card.contextFragment ?? card.inputFragment;
+    const responseFragment = card.responseFragment ?? card.outputFragment;
+    return {
+        contextFragment,
+        responseFragment,
+        inputFragment: contextFragment,
+        outputFragment: responseFragment,
+    };
+}
 function toFileUrl(p) {
     const abs = path.resolve(p);
     return path.toFileUrl(abs).href;
@@ -61,6 +109,7 @@ async function loadCardInternal(cardPath, parentPath, stack = []) {
     const graderDecks = normalizeCompanionDecks(card.graderDecks, resolved);
     actionDecks.forEach(checkReserved);
     const { label: _l, ...rest } = card;
+    const fragments = normalizeCardFragments(card, resolved);
     return {
         ...rest,
         label: cardLabel,
@@ -70,6 +119,7 @@ async function loadCardInternal(cardPath, parentPath, stack = []) {
         graderDecks,
         path: resolved,
         cards: [],
+        ...fragments,
     };
 }
 export async function loadCard(cardPath, parentPath, stack = []) {
@@ -111,12 +161,19 @@ export async function loadDeck(deckPath, parentPath) {
         mergedActions[action.name] = action;
     }
     const actionDecks = Object.values(mergedActions);
-    let inputSchema = deck.inputSchema;
-    let outputSchema = deck.outputSchema;
+    const schemaAliases = normalizeDeckSchemas(deck, resolved);
+    let inputSchema = schemaAliases.inputSchema;
+    let outputSchema = schemaAliases.outputSchema;
+    let contextSchema = schemaAliases.contextSchema;
+    let responseSchema = schemaAliases.responseSchema;
     for (const card of allCards) {
         inputSchema = mergeZodObjects(inputSchema, card.inputFragment);
         outputSchema = mergeZodObjects(outputSchema, card.outputFragment);
+        contextSchema = mergeZodObjects(contextSchema, card.contextFragment);
+        responseSchema = mergeZodObjects(responseSchema, card.responseFragment);
     }
+    inputSchema = contextSchema;
+    outputSchema = responseSchema;
     const executor = typeof deck.run === "function"
         ? deck.run
         : typeof deck.execute === "function"
@@ -163,6 +220,8 @@ export async function loadDeck(deckPath, parentPath) {
         actions: actionDecks,
         testDecks: normalizeCompanionDecks(deck.testDecks, resolved),
         graderDecks: normalizeCompanionDecks(deck.graderDecks, resolved),
+        contextSchema,
+        responseSchema,
         inputSchema,
         outputSchema,
         executor,

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

@@ -1 +1 @@
-{"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"}
+{"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;AA+LpB,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CA0GrB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAgMrB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/esm/src/markdown.js

@@ -1,7 +1,7 @@
 import * as dntShim from "../_dnt.shims.js";
 import { extract } from "../deps/jsr.io/@std/front-matter/1.0.9/any.js";
 import * as path from "../deps/jsr.io/@std/path/1.1.4/mod.js";
-import { BUILTIN_TOOL_NAME_SET, GAMBIT_TOOL_END, GAMBIT_TOOL_INIT, GAMBIT_TOOL_RESPOND, MAX_TOOL_NAME_LENGTH, RESERVED_TOOL_PREFIX, TOOL_NAME_PATTERN, } from "./constants.js";
+import { BUILTIN_TOOL_NAME_SET, GAMBIT_TOOL_CONTEXT, GAMBIT_TOOL_END, GAMBIT_TOOL_RESPOND, MAX_TOOL_NAME_LENGTH, RESERVED_TOOL_PREFIX, TOOL_NAME_PATTERN, } from "./constants.js";
 import { isCardDefinition } from "./definitions.js";
 import { loadCard } from "./loader.js";
 import { mergeZodObjects } from "./schema.js";
@@ -15,8 +15,10 @@ const LEGACY_MARKER_WARNINGS = {
     init: false,
     end: false,
 };
+const LEGACY_SCHEMA_WARNINGS = new Set();
+const LEGACY_FRAGMENT_WARNINGS = new Set();
 const INIT_TEXT = `
-You will automatically receive a \`${GAMBIT_TOOL_INIT}\` tool result at the start that provides run/context info.
+You will automatically receive a \`${GAMBIT_TOOL_CONTEXT}\` tool result at the start that provides run/context info.
 `.trim();
 const RESPOND_TEXT = `
 When you are done, call the \`${GAMBIT_TOOL_RESPOND}\` tool with a JSON object that includes your \`payload\` (validated output) and optional \`status\`/ \`message\`/ \`code\`/ \`meta\`. Do not end with normal assistant text; always finish by calling \`${GAMBIT_TOOL_RESPOND}\`.
@@ -30,6 +32,20 @@ function warnLegacyMarker(marker, replacement) {
     LEGACY_MARKER_WARNINGS[marker] = true;
     logger.warn(`[gambit] "gambit://${marker}" is deprecated; use ${replacement} instead.`);
 }
+function warnLegacySchema(resolvedPath, legacy, replacement) {
+    const key = `${resolvedPath}:${legacy}`;
+    if (LEGACY_SCHEMA_WARNINGS.has(key))
+        return;
+    LEGACY_SCHEMA_WARNINGS.add(key);
+    logger.warn(`[gambit] deck at ${resolvedPath} uses deprecated "${legacy}"; rename to "${replacement}"`);
+}
+function warnLegacyFragment(resolvedPath, legacy, replacement) {
+    const key = `${resolvedPath}:${legacy}`;
+    if (LEGACY_FRAGMENT_WARNINGS.has(key))
+        return;
+    LEGACY_FRAGMENT_WARNINGS.add(key);
+    logger.warn(`[gambit] card at ${resolvedPath} uses deprecated "${legacy}"; rename to "${replacement}"`);
+}
 function toFileUrl(p) {
     const abs = path.resolve(p);
     return path.toFileUrl(abs).href;
@@ -168,8 +184,18 @@ export async function loadMarkdownCard(filePath, parentPath, stack = []) {
             throw new Error(`Action name ${a.name} must match ${TOOL_NAME_PATTERN} and be <= ${MAX_TOOL_NAME_LENGTH} characters`);
         }
     });
-    const inputFragment = await maybeLoadSchema(attrs.inputSchema, resolved);
-    const outputFragment = await maybeLoadSchema(attrs.outputSchema, resolved);
+    const legacyInputSchema = attrs.inputSchema;
+    const legacyOutputSchema = attrs.outputSchema;
+    const contextFragment = await maybeLoadSchema(attrs.contextFragment ??
+        legacyInputSchema, resolved);
+    const responseFragment = await maybeLoadSchema(attrs.responseFragment ??
+        legacyOutputSchema, resolved);
+    if (legacyInputSchema !== undefined) {
+        warnLegacyFragment(resolved, "inputSchema", "contextFragment");
+    }
+    if (legacyOutputSchema !== undefined) {
+        warnLegacyFragment(resolved, "outputSchema", "responseFragment");
+    }
     const replaced = await expandEmbedsInBody({
         body,
         resolvedPath: resolved,
@@ -189,8 +215,10 @@ export async function loadMarkdownCard(filePath, parentPath, stack = []) {
         testDecks: normalizeDeckRefs(attrs.testDecks, resolved),
         graderDecks: normalizeDeckRefs(attrs.graderDecks, resolved),
         cards: embeddedCards,
-        inputFragment,
-        outputFragment,
+        contextFragment,
+        responseFragment,
+        inputFragment: contextFragment,
+        outputFragment: responseFragment,
         respond: respondFlag || replaced.respond,
     };
 }
@@ -233,8 +261,18 @@ export async function loadMarkdownDeck(filePath, parentPath) {
         stack: [resolved],
     });
     const cards = replaced.embeds;
-    const inputSchema = await maybeLoadSchema(deckMeta.inputSchema, resolved);
-    const outputSchema = await maybeLoadSchema(deckMeta.outputSchema, resolved);
+    const legacyInputSchema = deckMeta.inputSchema;
+    const legacyOutputSchema = deckMeta.outputSchema;
+    const contextSchema = await maybeLoadSchema(deckMeta.contextSchema ??
+        legacyInputSchema, resolved);
+    const responseSchema = await maybeLoadSchema(deckMeta.responseSchema ??
+        legacyOutputSchema, resolved);
+    if (legacyInputSchema !== undefined) {
+        warnLegacySchema(resolved, "inputSchema", "contextSchema");
+    }
+    if (legacyOutputSchema !== undefined) {
+        warnLegacySchema(resolved, "outputSchema", "responseSchema");
+    }
     const allCards = flattenCards(cards);
     const cleanedBody = replaced.body;
     const allowEnd = Boolean(deckMeta.allowEnd) ||
@@ -249,12 +287,14 @@ export async function loadMarkdownDeck(filePath, parentPath) {
     for (const action of actionDecks) {
         mergedActions[action.name] = action;
     }
-    let mergedInputSchema = inputSchema;
-    let mergedOutputSchema = outputSchema;
+    let mergedContextSchema = contextSchema;
+    let mergedResponseSchema = responseSchema;
     for (const card of allCards) {
-        mergedInputSchema = mergeZodObjects(mergedInputSchema, card.inputFragment);
-        mergedOutputSchema = mergeZodObjects(mergedOutputSchema, card.outputFragment);
+        mergedContextSchema = mergeZodObjects(mergedContextSchema, card.contextFragment);
+        mergedResponseSchema = mergeZodObjects(mergedResponseSchema, card.responseFragment);
     }
+    const mergedInputSchema = mergedContextSchema;
+    const mergedOutputSchema = mergedResponseSchema;
     const normalizeHandler = (cfg, kind) => {
         if (!cfg)
             return undefined;
@@ -302,8 +342,11 @@ export async function loadMarkdownDeck(filePath, parentPath) {
         graderDecks: mergeDeckRefs(rootGraderDecks, embeddedGraderDecks),
         cards: allCards,
         label: deckMeta.label,
+        startMode: deckMeta.startMode,
         modelParams: deckMeta.modelParams,
         guardrails: deckMeta.guardrails,
+        contextSchema: mergedContextSchema,
+        responseSchema: mergedResponseSchema,
         inputSchema: mergedInputSchema,
         outputSchema: mergedOutputSchema,
         handlers,

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

@@ -1 +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"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/src/render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,YAAY,EAEZ,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,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;AA6KF,wBAAsB,UAAU,CAC9B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA+E3B"}

package/esm/src/render.js

@@ -58,6 +58,12 @@ function warnIfSystemMismatch(args) {
 function toolName(tool) {
     return tool.function?.name ?? "";
 }
+function resolveContextSchema(deck) {
+    return deck.contextSchema ?? deck.inputSchema;
+}
+function resolveResponseSchema(deck) {
+    return deck.responseSchema ?? deck.outputSchema;
+}
 function assertNoToolNameCollisions(args) {
     if (!args.externalTools?.length)
         return;
@@ -80,12 +86,14 @@ async function buildDeckActionTools(deckPath) {
     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)`);
+        const contextSchema = resolveContextSchema(child);
+        const responseSchema = resolveResponseSchema(child);
+        if (!contextSchema || !responseSchema) {
+            throw new Error(`Deck ${child.path} must declare contextSchema and responseSchema (non-root)`);
         }
-        assertZodSchema(child.inputSchema, "inputSchema");
-        assertZodSchema(child.outputSchema, "outputSchema");
-        const params = toJsonSchema(child.inputSchema);
+        assertZodSchema(contextSchema, "contextSchema");
+        assertZodSchema(responseSchema, "responseSchema");
+        const params = toJsonSchema(contextSchema);
         tools.push({
             type: "function",
             function: {
@@ -102,8 +110,11 @@ function mergeModelParams(req, deckParams) {
     const out = { ...req };
     if (!deckParams)
         return out;
-    if (out.model === undefined && deckParams.model)
-        out.model = deckParams.model;
+    if (out.model === undefined && deckParams.model) {
+        out.model = Array.isArray(deckParams.model)
+            ? deckParams.model.find((entry) => typeof entry === "string" && entry.trim().length > 0)
+            : deckParams.model;
+    }
     if (out.temperature === undefined && deckParams.temperature !== undefined) {
         out.temperature = deckParams.temperature;
     }
@@ -167,7 +178,10 @@ export async function renderDeck(opts) {
         }
         tools = mergedReq.tools;
     }
-    const model = String(mergedReq.model ?? "").trim();
+    const resolvedModel = Array.isArray(mergedReq.model)
+        ? mergedReq.model.find((entry) => typeof entry === "string" && entry.trim().length > 0)
+        : mergedReq.model;
+    const model = String(resolvedModel ?? "").trim();
     if (!model) {
         throw new Error(`renderDeck requires request.model (or deck.modelParams.model): ${deck.path}`);
     }

package/esm/src/runtime.d.ts

@@ -29,6 +29,7 @@ type RunOptions = {
     onStateUpdate?: (state: SavedState) => void;
     onStreamText?: (chunk: string) => void;
     allowRootStringInput?: boolean;
+    responsesMode?: boolean;
 };
 export declare function runDeck(opts: RunOptions): Promise<unknown>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/src/runtime.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,UAAU,EAGV,aAAa,EAGd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,IAAI,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAM1E;AAiBD,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,YAAY,EAAE,UAAU,KAAK,IAAI,CAAC;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAgGhE"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/src/runtime.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,UAAU,EAIV,aAAa,EAKd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,IAAI,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAM1E;AAiBD,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,YAAY,EAAE,UAAU,KAAK,IAAI,CAAC;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAkGhE"}