@bolt-foundry/gambit 0.8.3 → 0.8.5-rc.4

package/script/mod.d.ts

@@ -26,12 +26,22 @@ export type { Guardrails } from "@bolt-foundry/gambit-core";
 export type { JSONValue } from "@bolt-foundry/gambit-core";
 /** Model provider interface for LLM backends. */
 export type { ModelProvider } from "@bolt-foundry/gambit-core";
-/** Test deck definition shape. */
+/** Scenario deck definition shape. */
 export type { TestDeckDefinition } from "@bolt-foundry/gambit-core";
 /** Check if a value is an explicit end-of-run signal. */
 export { isGambitEndSignal } from "@bolt-foundry/gambit-core";
-/** Run a deck and return its execution result. */
-export { runDeck } from "@bolt-foundry/gambit-core";
+/** Check whether an error represents runtime cancellation. */
+export { isRunCanceledError } from "@bolt-foundry/gambit-core";
+/** Build a runtime with CLI-equivalent provider defaults and routing. */
+export { createDefaultedRuntime } from "./src/default_runtime.js";
+/** Runtime defaults/options for the `runDeck` wrapper. */
+export type { CreateDefaultedRuntimeOptions, DefaultedRuntime, DefaultedRuntimeRunOptions, RunDeckWithDefaultsOptions, } from "./src/default_runtime.js";
+/** Session artifact persistence config for default runtime runs. */
+export type { SessionArtifactsConfig } from "./src/session_artifacts.js";
+/** Run a deck with default provider/model/runtime behavior. */
+export { runDeck } from "./src/default_runtime.js";
+/** Run a deck directly through gambit-core without gambit defaults. */
+export { runDeck as runDeckCore } 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. */

package/script/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,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,sDAAsD;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,6DAA6D;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,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,sCAAsC;AACtC,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,yDAAyD;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,8DAA8D;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,yEAAyE;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,0DAA0D;AAC1D,YAAY,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,oEAAoE;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,+DAA+D;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,uEAAuE;AACvE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACnE,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,sDAAsD;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,6DAA6D;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,8DAA8D;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/script/mod.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.startWebSocketSimulator = exports.createGoogleProvider = exports.createOllamaProvider = exports.createOpenRouterProvider = exports.renderDeck = exports.chatCompletionsWithDeck = exports.runDeck = exports.isGambitEndSignal = exports.defineDeck = exports.defineCard = void 0;
+exports.startWebSocketSimulator = exports.createGoogleProvider = exports.createOllamaProvider = exports.createOpenRouterProvider = exports.renderDeck = exports.chatCompletionsWithDeck = exports.runDeckCore = exports.runDeck = exports.createDefaultedRuntime = exports.isRunCanceledError = exports.isGambitEndSignal = exports.defineDeck = exports.defineCard = void 0;
 /**
  * Gambit exports for authoring and running decks/cards with runtime helpers.
  *
@@ -16,15 +16,24 @@ Object.defineProperty(exports, "defineDeck", { enumerable: true, get: function (
 /** Check if a value is an explicit end-of-run signal. */
 var gambit_core_3 = require("@bolt-foundry/gambit-core");
 Object.defineProperty(exports, "isGambitEndSignal", { enumerable: true, get: function () { return gambit_core_3.isGambitEndSignal; } });
-/** Run a deck and return its execution result. */
+/** Check whether an error represents runtime cancellation. */
 var gambit_core_4 = require("@bolt-foundry/gambit-core");
-Object.defineProperty(exports, "runDeck", { enumerable: true, get: function () { return gambit_core_4.runDeck; } });
+Object.defineProperty(exports, "isRunCanceledError", { enumerable: true, get: function () { return gambit_core_4.isRunCanceledError; } });
+/** Build a runtime with CLI-equivalent provider defaults and routing. */
+var default_runtime_js_1 = require("./src/default_runtime.js");
+Object.defineProperty(exports, "createDefaultedRuntime", { enumerable: true, get: function () { return default_runtime_js_1.createDefaultedRuntime; } });
+/** Run a deck with default provider/model/runtime behavior. */
+var default_runtime_js_2 = require("./src/default_runtime.js");
+Object.defineProperty(exports, "runDeck", { enumerable: true, get: function () { return default_runtime_js_2.runDeck; } });
+/** Run a deck directly through gambit-core without gambit defaults. */
+var gambit_core_5 = require("@bolt-foundry/gambit-core");
+Object.defineProperty(exports, "runDeckCore", { enumerable: true, get: function () { return gambit_core_5.runDeck; } });
 /** OpenAI Chat Completions compatibility helper for a deck. */
 var openai_compat_js_1 = require("./src/openai_compat.js");
 Object.defineProperty(exports, "chatCompletionsWithDeck", { enumerable: true, get: function () { return openai_compat_js_1.chatCompletionsWithDeck; } });
 /** Render a deck to a human-readable outline or debug view. */
-var gambit_core_5 = require("@bolt-foundry/gambit-core");
-Object.defineProperty(exports, "renderDeck", { enumerable: true, get: function () { return gambit_core_5.renderDeck; } });
+var gambit_core_6 = require("@bolt-foundry/gambit-core");
+Object.defineProperty(exports, "renderDeck", { enumerable: true, get: function () { return gambit_core_6.renderDeck; } });
 /** Provider factory for OpenRouter-backed model calls. */
 var openrouter_js_1 = require("./src/providers/openrouter.js");
 Object.defineProperty(exports, "createOpenRouterProvider", { enumerable: true, get: function () { return openrouter_js_1.createOpenRouterProvider; } });

package/script/src/cli_utils.d.ts

@@ -3,6 +3,7 @@ import type { 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 resolveProjectRoot(startDir: string): string | undefined;
 export declare function defaultSessionRoot(deckPath: string): string;
 export declare function defaultTestBotStatePath(deckPath: string): string;
 export declare function enrichStateMeta(state: SavedState, deckPath: string): SavedState;

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

@@ -1 +1 @@
-{"version":3,"file":"cli_utils.d.ts","sourceRoot":"","sources":["../../src/src/cli_utils.ts"],"names":[],"mappings":"AAMA,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,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;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAC5B,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAuB/D"}
+{"version":3,"file":"cli_utils.d.ts","sourceRoot":"","sources":["../../src/src/cli_utils.ts"],"names":[],"mappings":"AAMA,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,GAAG,SAAS,CAEvE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkB3D;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;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAC5B,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAuB/D"}

package/script/src/cli_utils.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parsePortValue = parsePortValue;
 exports.normalizeFlagList = normalizeFlagList;
 exports.slugifyDeckPath = slugifyDeckPath;
+exports.resolveProjectRoot = resolveProjectRoot;
 exports.defaultSessionRoot = defaultSessionRoot;
 exports.defaultTestBotStatePath = defaultTestBotStatePath;
 exports.enrichStateMeta = enrichStateMeta;
@@ -89,12 +90,24 @@ function findProjectRoot(startDir) {
     }
     return undefined;
 }
+function resolveProjectRoot(startDir) {
+    return findProjectRoot(startDir);
+}
 function defaultSessionRoot(deckPath) {
     const resolvedDeckPath = path.resolve(deckPath);
+    const marker = `${path.SEPARATOR}.gambit${path.SEPARATOR}workspaces${path.SEPARATOR}`;
+    const markerIndex = resolvedDeckPath.lastIndexOf(marker);
+    if (markerIndex >= 0) {
+        const suffix = resolvedDeckPath.slice(markerIndex + marker.length);
+        const markerSegments = suffix.split(path.SEPARATOR).filter(Boolean);
+        if (markerSegments.length >= 2 && markerSegments[1] === "deck") {
+            return path.resolve(resolvedDeckPath.slice(0, markerIndex + marker.length));
+        }
+    }
     const deckDir = path.dirname(resolvedDeckPath);
     const projectRoot = findProjectRoot(deckDir);
     const baseDir = projectRoot ?? deckDir;
-    return path.join(baseDir, ".gambit", "sessions");
+    return path.join(baseDir, ".gambit", "workspaces");
 }
 function defaultTestBotStatePath(deckPath) {
     const slug = slugifyDeckPath(deckPath);

package/script/src/default_runtime.d.ts

@@ -0,0 +1,46 @@
+import { runDeck as runDeckCore } from "@bolt-foundry/gambit-core";
+import type { ModelProvider } from "@bolt-foundry/gambit-core";
+import { type SessionArtifactsConfig } from "./session_artifacts.js";
+import { type LoadedProjectConfig, type ModelAliasResolver } from "./project_config.js";
+import { type ProviderKey } from "./providers/router.js";
+type WarnLogger = Pick<Console, "warn">;
+type CoreRunDeckOptions = Parameters<typeof runDeckCore>[0];
+export type DefaultedRuntimeRunOptions = Omit<CoreRunDeckOptions, "modelProvider" | "defaultModel" | "modelOverride" | "responsesMode"> & {
+    modelProvider?: ModelProvider;
+    defaultModel?: string;
+    modelOverride?: string;
+    responsesMode?: boolean;
+    sessionArtifacts?: SessionArtifactsConfig | false;
+};
+export type CreateDefaultedRuntimeOptions = {
+    configHint?: string;
+    projectConfig?: LoadedProjectConfig | null;
+    modelProvider?: ModelProvider;
+    defaultModel?: string;
+    modelOverride?: string;
+    responsesMode?: boolean;
+    fallbackProvider?: ProviderKey | null;
+    logger?: WarnLogger;
+    sessionArtifacts?: SessionArtifactsConfig;
+};
+export type DefaultedRuntime = {
+    projectConfig: LoadedProjectConfig | null;
+    modelAliasResolver: ModelAliasResolver;
+    configuredFallbackProvider: ProviderKey | null | undefined;
+    effectiveFallbackProvider: ProviderKey | null;
+    modelProvider: ModelProvider;
+    defaultModel?: string;
+    modelOverride?: string;
+    responsesMode: boolean;
+    sessionArtifacts?: SessionArtifactsConfig;
+    resolveRunOptions: (opts: DefaultedRuntimeRunOptions) => CoreRunDeckOptions;
+    runDeck: (opts: DefaultedRuntimeRunOptions) => Promise<unknown>;
+};
+export type RunDeckWithDefaultsOptions = DefaultedRuntimeRunOptions & {
+    runtime?: DefaultedRuntime;
+    runtimeOptions?: CreateDefaultedRuntimeOptions;
+};
+export declare function createDefaultedRuntime(opts?: CreateDefaultedRuntimeOptions): Promise<DefaultedRuntime>;
+export declare function runDeck(opts: RunDeckWithDefaultsOptions): Promise<unknown>;
+export {};
+//# sourceMappingURL=default_runtime.d.ts.map

package/script/src/default_runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default_runtime.d.ts","sourceRoot":"","sources":["../../src/src/default_runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAGV,aAAa,EAId,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,KAAK,mBAAmB,EAExB,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAI/E,KAAK,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAoBxC,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5D,MAAM,MAAM,0BAA0B,GAClC,IAAI,CACJ,kBAAkB,EAChB,eAAe,GACf,cAAc,GACd,eAAe,GACf,eAAe,CAClB,GACC;IACA,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,KAAK,CAAC;CACnD,CAAC;AAEJ,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,0BAA0B,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D,yBAAyB,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9C,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,iBAAiB,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,kBAAkB,CAAC;IAC5E,OAAO,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,0BAA0B,GAAG;IACpE,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,cAAc,CAAC,EAAE,6BAA6B,CAAC;CAChD,CAAC;AAgZF,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,6BAAkC,GACvC,OAAO,CAAC,gBAAgB,CAAC,CA8E3B;AAED,wBAAsB,OAAO,CAC3B,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/script/src/default_runtime.js

@@ -0,0 +1,452 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultedRuntime = createDefaultedRuntime;
+exports.runDeck = runDeck;
+const dntShim = __importStar(require("../_dnt.shims.js"));
+const gambit_core_1 = require("@bolt-foundry/gambit-core");
+const model_matchers_js_1 = require("./model_matchers.js");
+const session_artifacts_js_1 = require("./session_artifacts.js");
+const project_config_js_1 = require("./project_config.js");
+const codex_js_1 = require("./providers/codex.js");
+const google_js_1 = require("./providers/google.js");
+const ollama_js_1 = require("./providers/ollama.js");
+const openrouter_js_1 = require("./providers/openrouter.js");
+const router_js_1 = require("./providers/router.js");
+const DEFAULT_OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+function mergeParams(aliasParams, baseParams) {
+    if (aliasParams && baseParams) {
+        return { ...aliasParams, ...baseParams };
+    }
+    return baseParams ?? aliasParams;
+}
+function parseFallbackProviderFromConfig(fallbackProviderRaw, logger) {
+    if (typeof fallbackProviderRaw !== "string") {
+        return undefined;
+    }
+    const normalized = fallbackProviderRaw.trim().toLowerCase();
+    if (normalized === "none") {
+        return null;
+    }
+    if (normalized === "codex") {
+        throw new Error('[gambit] providers.fallback "codex" is no longer supported. Use "codex-cli" or "none".');
+    }
+    if (normalized === "openrouter" || normalized === "ollama" ||
+        normalized === "google" || normalized === "codex-cli") {
+        return normalized;
+    }
+    if (normalized.length > 0) {
+        logger.warn(`[gambit] Unknown providers.fallback "${fallbackProviderRaw}" in gambit.toml; using default fallback.`);
+    }
+    return undefined;
+}
+function resolveConfiguredFallbackProvider(opts) {
+    if (opts.runtimeOverride !== undefined) {
+        return opts.runtimeOverride;
+    }
+    return parseFallbackProviderFromConfig(opts.projectConfig?.providers?.fallback, opts.logger);
+}
+function resolveDefaultResponsesMode() {
+    const chatFallback = dntShim.Deno.env.get("GAMBIT_CHAT_FALLBACK") === "1";
+    return !chatFallback && dntShim.Deno.env.get("GAMBIT_RESPONSES_MODE") !== "0";
+}
+function resolveSessionArtifactsConfig(opts) {
+    if (opts.runConfig === false)
+        return undefined;
+    if (!opts.runtimeConfig && !opts.runConfig)
+        return undefined;
+    const merged = {
+        ...(opts.runtimeConfig ?? {}),
+        ...(opts.runConfig ?? {}),
+    };
+    if (typeof merged.rootDir !== "string" || !merged.rootDir.trim()) {
+        throw new Error("sessionArtifacts.rootDir is required when persistence is enabled.");
+    }
+    return {
+        rootDir: merged.rootDir,
+        sessionId: merged.sessionId,
+        continueSession: merged.continueSession,
+    };
+}
+function buildDefaultModelProvider(opts) {
+    const openRouterApiKey = dntShim.Deno.env.get("OPENROUTER_API_KEY")?.trim();
+    const googleApiKey = (dntShim.Deno.env.get("GOOGLE_API_KEY") ??
+        dntShim.Deno.env.get("GEMINI_API_KEY"))?.trim();
+    const openRouterBaseURL = dntShim.Deno.env.get("OPENROUTER_BASE_URL") ??
+        DEFAULT_OPENROUTER_BASE_URL;
+    const ollamaBaseURL = dntShim.Deno.env.get("OLLAMA_BASE_URL") ?? undefined;
+    const googleBaseURL = dntShim.Deno.env.get("GOOGLE_BASE_URL") ??
+        dntShim.Deno.env.get("GEMINI_BASE_URL") ??
+        undefined;
+    const openRouterProvider = openRouterApiKey
+        ? (0, openrouter_js_1.createOpenRouterProvider)({
+            apiKey: openRouterApiKey,
+            baseURL: openRouterBaseURL ?? undefined,
+            enableResponses: opts.responsesMode &&
+                dntShim.Deno.env.get("GAMBIT_OPENROUTER_RESPONSES") !== "0",
+        })
+        : null;
+    const ollamaProvider = (0, ollama_js_1.createOllamaProvider)({
+        apiKey: dntShim.Deno.env.get("OLLAMA_API_KEY")?.trim() || undefined,
+        baseURL: ollamaBaseURL,
+    });
+    const googleProvider = googleApiKey
+        ? (0, google_js_1.createGoogleProvider)({
+            apiKey: googleApiKey,
+            baseURL: googleBaseURL,
+        })
+        : null;
+    const codexProvider = (0, codex_js_1.createCodexProvider)();
+    const providerRouter = (0, router_js_1.createProviderRouter)({
+        providers: {
+            openrouter: openRouterProvider,
+            ollama: ollamaProvider,
+            google: googleProvider,
+            "codex-cli": codexProvider,
+        },
+        defaultProvider: opts.configuredFallbackProvider,
+        fallbackToDefaultOnMissing: ["google"],
+    });
+    const providerMatchers = (0, model_matchers_js_1.createProviderMatchers)(opts.effectiveFallbackProvider);
+    const ollamaTagsCache = {
+        promise: null,
+    };
+    const getOllamaTags = async () => {
+        if (!ollamaTagsCache.promise) {
+            ollamaTagsCache.promise = (0, ollama_js_1.fetchOllamaTags)(ollamaBaseURL);
+        }
+        return await ollamaTagsCache.promise;
+    };
+    const providerCapabilities = [
+        {
+            name: "ollama",
+            matches: providerMatchers.matchesOllama,
+            isAvailable: async (model, capabilityOpts) => {
+                const trimmed = model.slice(ollama_js_1.OLLAMA_PREFIX.length);
+                if (!trimmed) {
+                    return { available: false, reason: "missing Ollama model name" };
+                }
+                if (capabilityOpts.allowPull) {
+                    try {
+                        await (0, ollama_js_1.ensureOllamaModel)(trimmed, ollamaBaseURL);
+                        return { available: true };
+                    }
+                    catch (err) {
+                        return {
+                            available: false,
+                            reason: err instanceof Error ? err.message : String(err),
+                        };
+                    }
+                }
+                try {
+                    const tags = await getOllamaTags();
+                    if (tags.has(trimmed)) {
+                        return { available: true };
+                    }
+                    return {
+                        available: false,
+                        reason: `Ollama model "${trimmed}" not installed`,
+                    };
+                }
+                catch (err) {
+                    return {
+                        available: false,
+                        reason: err instanceof Error ? err.message : String(err),
+                    };
+                }
+            },
+        },
+        {
+            name: "google",
+            matches: providerMatchers.matchesGoogle,
+            isAvailable: (_model, _capabilityOpts) => Promise.resolve(googleApiKey
+                ? { available: true }
+                : (opts.effectiveFallbackProvider === "openrouter" &&
+                    openRouterApiKey)
+                    ? { available: true }
+                    : {
+                        available: false,
+                        reason: "GOOGLE_API_KEY or GEMINI_API_KEY is not set",
+                    }),
+        },
+        {
+            name: "openrouter",
+            matches: providerMatchers.matchesOpenRouter,
+            isAvailable: (_model, _capabilityOpts) => Promise.resolve(openRouterApiKey ? { available: true } : {
+                available: false,
+                reason: "OPENROUTER_API_KEY is not set",
+            }),
+        },
+        {
+            name: "codex-cli",
+            matches: providerMatchers.matchesCodex,
+            isAvailable: (model, _capabilityOpts) => {
+                if (model === "codex" || model.startsWith("codex/")) {
+                    return Promise.resolve({
+                        available: false,
+                        reason: 'legacy codex prefix is unsupported; use "codex-cli/default" or "codex-cli/<model>"',
+                    });
+                }
+                const stripped = model.startsWith(codex_js_1.CODEX_PREFIX)
+                    ? model.slice(codex_js_1.CODEX_PREFIX.length)
+                    : model;
+                if (!stripped.trim()) {
+                    return Promise.resolve({
+                        available: false,
+                        reason: "missing Codex model name",
+                    });
+                }
+                return Promise.resolve({ available: true });
+            },
+        },
+    ];
+    const warnedMissingAliases = new Set();
+    const expandModelCandidates = (model, params) => {
+        if (!model)
+            return { candidates: [], allowPull: false };
+        const baseParams = params;
+        const entries = Array.isArray(model) ? model : [model];
+        const allowPull = !Array.isArray(model);
+        const candidates = [];
+        for (const entry of entries) {
+            if (typeof entry !== "string" || !entry.trim())
+                continue;
+            const resolution = opts.modelAliasResolver(entry);
+            if (resolution.missingAlias && !warnedMissingAliases.has(entry)) {
+                opts.logger.warn(`[gambit] Model alias "${entry}" is not defined in gambit.toml; using literal value.`);
+                warnedMissingAliases.add(entry);
+            }
+            if (resolution.applied) {
+                const resolvedModel = resolution.model;
+                const mergedParams = mergeParams(resolution.params, baseParams);
+                if (Array.isArray(resolvedModel)) {
+                    for (const candidate of resolvedModel) {
+                        if (!candidate.trim())
+                            continue;
+                        candidates.push({
+                            model: candidate,
+                            params: mergedParams,
+                        });
+                    }
+                }
+                else if (resolvedModel) {
+                    candidates.push({
+                        model: resolvedModel,
+                        params: mergedParams,
+                    });
+                }
+            }
+            else {
+                candidates.push({
+                    model: entry,
+                    params: baseParams,
+                });
+            }
+        }
+        const allowPullForSingle = allowPull && candidates.length <= 1;
+        return { candidates, allowPull: allowPullForSingle };
+    };
+    const resolveModelSelection = async (model, params, deckPath) => {
+        const { candidates, allowPull } = expandModelCandidates(model, params);
+        if (candidates.length === 0) {
+            throw new Error(deckPath
+                ? `No model configured for deck ${deckPath}`
+                : "No model configured.");
+        }
+        const failures = [];
+        for (const candidate of candidates) {
+            const capability = providerCapabilities.find((entry) => entry.matches(candidate.model));
+            const availability = capability
+                ? await capability.isAvailable(candidate.model, { allowPull })
+                : {
+                    available: false,
+                    reason: "no provider registered for model",
+                };
+            if (availability.available) {
+                return {
+                    model: candidate.model,
+                    params: candidate.params,
+                };
+            }
+            const label = capability ? capability.name : "unknown";
+            const reason = availability.reason ? `: ${availability.reason}` : "";
+            failures.push(`${candidate.model} (${label}${reason})`);
+        }
+        const suffix = failures.length ? ` Tried: ${failures.join(", ")}.` : "";
+        throw new Error(deckPath
+            ? `No available model found for deck ${deckPath}.${suffix}`
+            : `No available model found.${suffix}`);
+    };
+    const shouldResolveModel = (model) => {
+        if (Array.isArray(model))
+            return true;
+        const resolution = opts.modelAliasResolver(model);
+        return Boolean(resolution.applied || resolution.missingAlias);
+    };
+    return {
+        resolveModel: async (input) => await resolveModelSelection(input.model, input.params, input.deckPath),
+        responses: async (input) => {
+            const applied = shouldResolveModel(input.request.model)
+                ? await resolveModelSelection(input.request.model, input.request.params, input.deckPath)
+                : { model: input.request.model, params: input.request.params };
+            const request = {
+                ...input.request,
+                model: applied.model ?? input.request.model,
+                params: applied.params,
+            };
+            if (typeof request.model !== "string" || !request.model) {
+                throw new Error("Model is required.");
+            }
+            const selection = providerRouter.resolve({ model: request.model });
+            const responses = selection.provider.responses;
+            if (!responses) {
+                throw new Error(`${selection.providerKey} provider does not support responses.`);
+            }
+            return await responses({
+                ...input,
+                request: {
+                    ...request,
+                    model: selection.model,
+                },
+            });
+        },
+        chat: async (input) => {
+            const applied = shouldResolveModel(input.model)
+                ? await resolveModelSelection(input.model, input.params, input.deckPath)
+                : { model: input.model, params: input.params };
+            const request = {
+                ...input,
+                model: applied.model ?? input.model,
+                params: applied.params,
+            };
+            if (typeof request.model !== "string" || !request.model) {
+                throw new Error("Model is required.");
+            }
+            const selection = providerRouter.resolve({ model: request.model });
+            return await selection.provider.chat({
+                ...request,
+                model: selection.model,
+            });
+        },
+    };
+}
+async function createDefaultedRuntime(opts = {}) {
+    const logger = opts.logger ?? console;
+    const projectConfig = opts.projectConfig === undefined
+        ? await (0, project_config_js_1.loadProjectConfig)(opts.configHint)
+        : opts.projectConfig;
+    const modelAliasResolver = (0, project_config_js_1.createModelAliasResolver)(projectConfig?.config);
+    const configuredFallbackProvider = resolveConfiguredFallbackProvider({
+        runtimeOverride: opts.fallbackProvider,
+        projectConfig: projectConfig?.config,
+        logger,
+    });
+    const effectiveFallbackProvider = configuredFallbackProvider === undefined
+        ? "openrouter"
+        : configuredFallbackProvider;
+    const responsesMode = opts.responsesMode ?? resolveDefaultResponsesMode();
+    const modelProvider = opts.modelProvider ??
+        buildDefaultModelProvider({
+            modelAliasResolver,
+            configuredFallbackProvider,
+            effectiveFallbackProvider,
+            responsesMode,
+            logger,
+        });
+    const defaultModel = opts.defaultModel;
+    const modelOverride = opts.modelOverride;
+    const runtimeSessionArtifacts = opts.sessionArtifacts;
+    const resolveRunOptions = (runOpts) => {
+        const { sessionArtifacts: _sessionArtifacts, ...coreRunOpts } = runOpts;
+        return {
+            ...coreRunOpts,
+            modelProvider: runOpts.modelProvider ?? modelProvider,
+            defaultModel: runOpts.defaultModel ?? defaultModel,
+            modelOverride: runOpts.modelOverride ?? modelOverride,
+            responsesMode: runOpts.responsesMode ?? responsesMode,
+        };
+    };
+    return {
+        projectConfig,
+        modelAliasResolver,
+        configuredFallbackProvider,
+        effectiveFallbackProvider,
+        modelProvider,
+        defaultModel,
+        modelOverride,
+        responsesMode,
+        sessionArtifacts: runtimeSessionArtifacts,
+        resolveRunOptions,
+        runDeck: async (runOpts) => {
+            const resolved = resolveRunOptions(runOpts);
+            const effectiveSessionArtifacts = resolveSessionArtifactsConfig({
+                runtimeConfig: runtimeSessionArtifacts,
+                runConfig: runOpts.sessionArtifacts,
+            });
+            if (!effectiveSessionArtifacts) {
+                return await (0, gambit_core_1.runDeck)(resolved);
+            }
+            const artifacts = (0, session_artifacts_js_1.withSessionArtifacts)({
+                config: effectiveSessionArtifacts,
+                trace: resolved.trace,
+                onStateUpdate: resolved.onStateUpdate,
+                state: resolved.state,
+            });
+            try {
+                return await (0, gambit_core_1.runDeck)({
+                    ...resolved,
+                    state: artifacts.state,
+                    trace: artifacts.trace,
+                    onStateUpdate: artifacts.onStateUpdate,
+                });
+            }
+            finally {
+                artifacts.finalize();
+            }
+        },
+    };
+}
+async function runDeck(opts) {
+    if (opts.runtime && opts.runtimeOptions) {
+        throw new Error("runDeck received both runtime and runtimeOptions. Pass only one.");
+    }
+    const runtime = opts.runtime ??
+        await createDefaultedRuntime({
+            ...opts.runtimeOptions,
+            configHint: opts.runtimeOptions?.configHint ?? opts.path,
+        });
+    const { runtime: _runtime, runtimeOptions: _runtimeOptions, ...runOpts } = opts;
+    return await runtime.runDeck(runOpts);
+}

package/script/src/durable_streams.js

@@ -132,5 +132,30 @@ async function handleDurableStreamRequest(request) {
     });
 }
 function formatSseEvent(event) {
-    return `id: ${event.offset}\ndata: ${JSON.stringify(event)}\n\n`;
+    const payload = normalizeSsePayload(event.data);
+    const type = payload.type;
+    return `id: ${event.offset}\nevent: ${type}\ndata: ${JSON.stringify(payload)}\n\n`;
+}
+function normalizeSsePayload(value) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        const record = value;
+        const rawType = typeof record.type === "string"
+            ? record.type.trim()
+            : "gambit.event";
+        const type = sanitizeSseEventType(rawType);
+        return {
+            ...record,
+            type,
+        };
+    }
+    return {
+        type: "gambit.event",
+        value,
+    };
+}
+function sanitizeSseEventType(value) {
+    if (!value)
+        return "gambit.event";
+    const normalized = value.replace(/[^A-Za-z0-9_.-]/g, "_");
+    return normalized.length > 0 ? normalized : "gambit.event";
 }