@bolt-foundry/gambit 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,8 +1,16 @@
 +++
 [release]
-since = "225456917f75e92cc095af525201373c4be37944"
+since = "692534996df73790229b8303516d48be66136fce"
 +++
 
 # Changelog
 
+## Unreleased (v0.8.1)
+
+- TBD
+
+## v0.8.0
+
+- chore(gambit): prepare 0.8.0 changelog
+
 ## 0.7.0 — Show HN launch

package/README.md

@@ -1,23 +1,35 @@
-# Gambit
+# <img src="./gambit_1color_bg.png" alt="Gambit logo" height="50" />
 
 Gambit helps you build reliable LLM workflows by composing small, typed “decks”\
 with clear inputs/outputs and guardrails. Run decks locally, stream traces, and\
 debug with a built-in UI.
 
+[Watch the demo video](https://youtu.be/J_hQ2L_yy60).
+
 ## Quickstart
 
-Requirements: Node.js 18+ and `OPENROUTER_API_KEY` (set `OPENROUTER_BASE_URL`
-if\
+Requirements: Node.js 18+ and `OPENROUTER_API_KEY` (set `OPENROUTER_BASE_URL` if
 you proxy OpenRouter-style APIs).
 
 Run the CLI directly with npx (no install):
 
 ```
 export OPENROUTER_API_KEY=...
-npx @bolt-foundry/gambit init
+npx @bolt-foundry/gambit demo
+```
+
+Downloads example files (hello decks plus the `examples/` gallery) and sets
+environment variables.
+
+To scaffold a starter project that you can customize, run:
+
+```
+npx @bolt-foundry/gambit init my-project
 ```
 
-Downloads example files and sets environment variables.
+This creates a structured skeleton (`decks/`, `actions/`, `graders/`, `tests/`,
+`schemas/`, `.gambit/`) with README guides so you can start authoring your own
+workflows immediately.
 
 Run an example in the terminal (`repl`):
 
@@ -75,9 +87,12 @@ npx @bolt-foundry/gambit <command>
 Run a deck once:
 
 ```
-npx @bolt-foundry/gambit run <deck> --init <json|string> --message <json|string>
+npx @bolt-foundry/gambit run <deck> --context <json|string> --message <json|string>
 ```
 
+> `--context` replaces the old `--init` flag. The CLI still accepts `--init` as
+> a deprecated alias for now so existing scripts keep working.
+
 Drop into a REPL (streams by default):
 
 ```
@@ -177,7 +192,7 @@ You are a concise assistant. Greet the user and echo the input.
 Run it:
 
 ```
-npx @bolt-foundry/gambit run ./hello_world.deck.md --init '"Gambit"' --stream
+npx @bolt-foundry/gambit run ./hello_world.deck.md --context '"Gambit"' --stream
 ```
 
 ### Compute deck in TypeScript (no model call): `echo.deck.ts`
@@ -200,7 +215,7 @@ export default defineDeck({
 Run it:
 
 ```
-npx @bolt-foundry/gambit run ./echo.deck.ts --init '{"text":"ping"}'
+npx @bolt-foundry/gambit run ./echo.deck.ts --context '{"text":"ping"}'
 ```
 
 ### Deck with a child action (calls a TypeScript tool): `agent_with_time.deck.md`
@@ -238,7 +253,7 @@ export default defineDeck({
 Run it:
 
 ```
-npx @bolt-foundry/gambit run ./agent_with_time.deck.md --init '"hello"' --stream
+npx @bolt-foundry/gambit run ./agent_with_time.deck.md --context '"hello"' --stream
 ```
 
 ## Deno
@@ -249,13 +264,19 @@ Quickstart:
 
 ```
 export OPENROUTER_API_KEY=...
-deno run -A jsr:@bolt-foundry/gambit/cli init
+deno run -A jsr:@bolt-foundry/gambit/cli demo
+```
+
+Starter project:
+
+```
+deno run -A jsr:@bolt-foundry/gambit/cli init my-project
 ```
 
 Run a deck:
 
 ```
-deno run -A jsr:@bolt-foundry/gambit/cli run <deck> --init <json|string> --message <json|string>
+deno run -A jsr:@bolt-foundry/gambit/cli run <deck> --context <json|string> --message <json|string>
 ```
 
 Start the Debug UI:

package/esm/mod.d.ts

@@ -35,11 +35,11 @@ export { runDeck } from "@bolt-foundry/gambit-core";
 /** Signal for explicitly ending a Gambit run. */
 export type { GambitEndSignal } from "@bolt-foundry/gambit-core";
 /** OpenAI Chat Completions compatibility helper for a deck. */
-export { chatCompletionsWithDeck } from "@bolt-foundry/gambit-core";
+export { chatCompletionsWithDeck } from "./src/compat/openai.js";
 /** OpenAI-compatible request payload. */
-export type { ChatCompletionsRequest } from "@bolt-foundry/gambit-core";
+export type { ChatCompletionsRequest } from "./src/compat/openai.js";
 /** OpenAI-compatible response payload. */
-export type { ChatCompletionsResponse } from "@bolt-foundry/gambit-core";
+export type { ChatCompletionsResponse } from "./src/compat/openai.js";
 /** Render a deck to a human-readable outline or debug view. */
 export { renderDeck } from "@bolt-foundry/gambit-core";
 /** Options for deck rendering. */
@@ -47,7 +47,7 @@ export type { RenderDeckOptions } from "@bolt-foundry/gambit-core";
 /** Result data from rendering a deck. */
 export type { RenderDeckResult } from "@bolt-foundry/gambit-core";
 /** Provider factory for OpenRouter-backed model calls. */
-export { createOpenRouterProvider } from "@bolt-foundry/gambit-core";
+export { createOpenRouterProvider } from "./src/providers/openrouter.js";
 /** Start the WebSocket simulator server for the Gambit UI. */
 export { startWebSocketSimulator } from "./src/server.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,2BAA2B,CAAC;AACvD,oDAAoD;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,oCAAoC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,iCAAiC;AACjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,oCAAoC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,uCAAuC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,2DAA2D;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,iDAAiD;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,kCAAkC;AAClC,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,yDAAyD;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,kDAAkD;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,iDAAiD;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,+DAA+D;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,yCAAyC;AACzC,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,0CAA0C;AAC1C,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,kCAAkC;AAClC,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,0DAA0D;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,8DAA8D;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}
+{"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,2BAA2B,CAAC;AACvD,oDAAoD;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,oCAAoC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,iCAAiC;AACjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,oCAAoC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,uCAAuC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,2DAA2D;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,iDAAiD;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,kCAAkC;AAClC,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,yDAAyD;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,kDAAkD;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,iDAAiD;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,+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,2BAA2B,CAAC;AACvD,kCAAkC;AAClC,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,0DAA0D;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,8DAA8D;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/esm/mod.js

@@ -13,10 +13,10 @@ export { isGambitEndSignal } from "@bolt-foundry/gambit-core";
 /** Run a deck and return its execution result. */
 export { runDeck } from "@bolt-foundry/gambit-core";
 /** OpenAI Chat Completions compatibility helper for a deck. */
-export { chatCompletionsWithDeck } from "@bolt-foundry/gambit-core";
+export { chatCompletionsWithDeck } from "./src/compat/openai.js";
 /** Render a deck to a human-readable outline or debug view. */
 export { renderDeck } from "@bolt-foundry/gambit-core";
 /** Provider factory for OpenRouter-backed model calls. */
-export { createOpenRouterProvider } from "@bolt-foundry/gambit-core";
+export { createOpenRouterProvider } from "./src/providers/openrouter.js";
 /** Start the WebSocket simulator server for the Gambit UI. */
 export { startWebSocketSimulator } from "./src/server.js";

package/esm/src/cli_utils.d.ts

@@ -1,14 +1,13 @@
-import type { ModelMessage } from "@bolt-foundry/gambit-core";
-import type { SavedState } from "@bolt-foundry/gambit-core";
+import type { OpenResponseItem, SavedState } from "@bolt-foundry/gambit-core";
 export declare function parsePortValue(value: unknown, label?: string): number | undefined;
 export declare function normalizeFlagList(value: string | Array<string> | undefined): Array<string>;
 export declare function slugifyDeckPath(deckPath: string): string;
 export declare function defaultSessionRoot(deckPath: string): string;
 export declare function defaultTestBotStatePath(deckPath: string): string;
 export declare function enrichStateMeta(state: SavedState, deckPath: string): SavedState;
-export declare function parseInit(raw?: string): unknown;
+export declare function parseContext(raw?: string): unknown;
 export declare function parseMessage(raw?: string): unknown;
 export declare function parseBotInput(raw?: string): unknown;
-export declare function findLastAssistantMessage(messages: Array<ModelMessage>): string | undefined;
-export declare function extractInitInput(state?: SavedState): unknown;
+export declare function findLastAssistantMessage(messages: Array<OpenResponseItem>): string | undefined;
+export declare function extractContextInput(state?: SavedState): unknown;
 //# sourceMappingURL=cli_utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cli_utils.d.ts","sourceRoot":"","sources":["../../src/src/cli_utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,KAAK,SAAS,GACb,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,GACxC,KAAK,CAAC,MAAM,CAAC,CAGf;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQxD;AAuBD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,UAAU,CAOZ;AAED,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAC5B,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAe5D"}
+{"version":3,"file":"cli_utils.d.ts","sourceRoot":"","sources":["../../src/src/cli_utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,gBAAgB,EAChB,UAAU,EACX,MAAM,2BAA2B,CAAC;AAEnC,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,KAAK,SAAS,GACb,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,GACxC,KAAK,CAAC,MAAM,CAAC,CAGf;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQxD;AAuBD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,UAAU,CAOZ;AAED,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAOnD;AAmBD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAChC,MAAM,GAAG,SAAS,CAYpB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAkB/D"}

package/esm/src/cli_utils.js

@@ -64,7 +64,7 @@ export function enrichStateMeta(state, deckPath) {
     }
     return { ...state, meta };
 }
-export function parseInit(raw) {
+export function parseContext(raw) {
     if (raw === undefined)
         return undefined;
     try {
@@ -94,23 +94,43 @@ export function parseBotInput(raw) {
         return raw;
     }
 }
+function contentText(parts) {
+    return parts.map((part) => {
+        switch (part.type) {
+            case "input_text":
+            case "output_text":
+            case "text":
+            case "summary_text":
+            case "reasoning_text":
+                return part.text;
+            case "refusal":
+                return part.refusal;
+            default:
+                return "";
+        }
+    }).join("");
+}
 export function findLastAssistantMessage(messages) {
     for (let i = messages.length - 1; i >= 0; i--) {
         const msg = messages[i];
-        if (msg?.role === "assistant") {
-            return typeof msg.content === "string"
-                ? msg.content
-                : JSON.stringify(msg.content ?? "");
+        if (msg?.type === "message" && msg.role === "assistant") {
+            if (typeof msg.content === "string")
+                return msg.content;
+            if (Array.isArray(msg.content)) {
+                return contentText(msg.content);
+            }
+            return JSON.stringify(msg.content ?? "");
         }
     }
     return undefined;
 }
-export function extractInitInput(state) {
+export function extractContextInput(state) {
     if (!state?.messages)
         return undefined;
     for (let i = state.messages.length - 1; i >= 0; i--) {
         const msg = state.messages[i];
-        if (msg.role === "tool" && msg.name === GAMBIT_TOOL_INIT) {
+        if (msg.type === "message" && msg.role === "tool" &&
+            msg.name === GAMBIT_TOOL_INIT) {
             const content = msg.content;
             if (typeof content !== "string")
                 return undefined;

package/esm/src/compat/openai.d.ts

@@ -0,0 +1,2 @@
+export { type ChatCompletionsRequest, type ChatCompletionsResponse, chatCompletionsWithDeck, } from "@bolt-foundry/gambit-core";
+//# sourceMappingURL=openai.d.ts.map

package/esm/src/compat/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/src/compat/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC"}

package/esm/src/compat/openai.js

@@ -0,0 +1 @@
+export { chatCompletionsWithDeck, } from "@bolt-foundry/gambit-core";

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../../src/src/providers/openrouter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,aAAa,EAOd,MAAM,2BAA2B,CAAC;AAmNnC,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;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,aAAa,CAsdhB"}