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

package/esm/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/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,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/esm/mod.js

@@ -10,8 +10,14 @@ export { defineCard } from "@bolt-foundry/gambit-core";
 export { defineDeck } 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";
+/** 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";
 /** OpenAI Chat Completions compatibility helper for a deck. */
 export { chatCompletionsWithDeck } from "./src/openai_compat.js";
 /** Render a deck to a human-readable outline or debug view. */

package/esm/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/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":"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/esm/src/cli_utils.js

@@ -43,12 +43,24 @@ function findProjectRoot(startDir) {
     }
     return undefined;
 }
+export function resolveProjectRoot(startDir) {
+    return findProjectRoot(startDir);
+}
 export 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");
 }
 export function defaultTestBotStatePath(deckPath) {
     const slug = slugifyDeckPath(deckPath);

package/esm/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/esm/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/esm/src/default_runtime.js

@@ -0,0 +1,415 @@
+import * as dntShim from "../_dnt.shims.js";
+import { runDeck as runDeckCore } from "@bolt-foundry/gambit-core";
+import { createProviderMatchers } from "./model_matchers.js";
+import { withSessionArtifacts, } from "./session_artifacts.js";
+import { createModelAliasResolver, loadProjectConfig, } from "./project_config.js";
+import { CODEX_PREFIX, createCodexProvider } from "./providers/codex.js";
+import { createGoogleProvider } from "./providers/google.js";
+import { createOllamaProvider, ensureOllamaModel, fetchOllamaTags, OLLAMA_PREFIX, } from "./providers/ollama.js";
+import { createOpenRouterProvider } from "./providers/openrouter.js";
+import { createProviderRouter } from "./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
+        ? createOpenRouterProvider({
+            apiKey: openRouterApiKey,
+            baseURL: openRouterBaseURL ?? undefined,
+            enableResponses: opts.responsesMode &&
+                dntShim.Deno.env.get("GAMBIT_OPENROUTER_RESPONSES") !== "0",
+        })
+        : null;
+    const ollamaProvider = createOllamaProvider({
+        apiKey: dntShim.Deno.env.get("OLLAMA_API_KEY")?.trim() || undefined,
+        baseURL: ollamaBaseURL,
+    });
+    const googleProvider = googleApiKey
+        ? createGoogleProvider({
+            apiKey: googleApiKey,
+            baseURL: googleBaseURL,
+        })
+        : null;
+    const codexProvider = createCodexProvider();
+    const providerRouter = createProviderRouter({
+        providers: {
+            openrouter: openRouterProvider,
+            ollama: ollamaProvider,
+            google: googleProvider,
+            "codex-cli": codexProvider,
+        },
+        defaultProvider: opts.configuredFallbackProvider,
+        fallbackToDefaultOnMissing: ["google"],
+    });
+    const providerMatchers = createProviderMatchers(opts.effectiveFallbackProvider);
+    const ollamaTagsCache = {
+        promise: null,
+    };
+    const getOllamaTags = async () => {
+        if (!ollamaTagsCache.promise) {
+            ollamaTagsCache.promise = fetchOllamaTags(ollamaBaseURL);
+        }
+        return await ollamaTagsCache.promise;
+    };
+    const providerCapabilities = [
+        {
+            name: "ollama",
+            matches: providerMatchers.matchesOllama,
+            isAvailable: async (model, capabilityOpts) => {
+                const trimmed = model.slice(OLLAMA_PREFIX.length);
+                if (!trimmed) {
+                    return { available: false, reason: "missing Ollama model name" };
+                }
+                if (capabilityOpts.allowPull) {
+                    try {
+                        await 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_PREFIX)
+                    ? model.slice(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,
+            });
+        },
+    };
+}
+export async function createDefaultedRuntime(opts = {}) {
+    const logger = opts.logger ?? console;
+    const projectConfig = opts.projectConfig === undefined
+        ? await loadProjectConfig(opts.configHint)
+        : opts.projectConfig;
+    const modelAliasResolver = 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 runDeckCore(resolved);
+            }
+            const artifacts = withSessionArtifacts({
+                config: effectiveSessionArtifacts,
+                trace: resolved.trace,
+                onStateUpdate: resolved.onStateUpdate,
+                state: resolved.state,
+            });
+            try {
+                return await runDeckCore({
+                    ...resolved,
+                    state: artifacts.state,
+                    trace: artifacts.trace,
+                    onStateUpdate: artifacts.onStateUpdate,
+                });
+            }
+            finally {
+                artifacts.finalize();
+            }
+        },
+    };
+}
+export 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/esm/src/durable_streams.js

@@ -128,5 +128,30 @@ export 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";
 }

package/esm/src/model_matchers.d.ts

@@ -0,0 +1,10 @@
+import type { ProviderKey } from "./providers/router.js";
+export type ProviderMatchers = {
+    isUnprefixedModel: (model: string) => boolean;
+    matchesOpenRouter: (model: string) => boolean;
+    matchesOllama: (model: string) => boolean;
+    matchesGoogle: (model: string) => boolean;
+    matchesCodex: (model: string) => boolean;
+};
+export declare function createProviderMatchers(effectiveFallbackProvider: ProviderKey | null): ProviderMatchers;
+//# sourceMappingURL=model_matchers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model_matchers.d.ts","sourceRoot":"","sources":["../../src/src/model_matchers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,yBAAyB,EAAE,WAAW,GAAG,IAAI,GAC5C,gBAAgB,CAyBlB"}

package/esm/src/model_matchers.js

@@ -0,0 +1,26 @@
+import { GOOGLE_PREFIX } from "./providers/google.js";
+import { OLLAMA_PREFIX } from "./providers/ollama.js";
+import { OPENROUTER_PREFIX } from "./providers/openrouter.js";
+import { CODEX_PREFIX } from "./providers/codex.js";
+const LEGACY_CODEX_PREFIX = "codex/";
+const CODEX_PROVIDER_ALIAS = "codex-cli";
+export function createProviderMatchers(effectiveFallbackProvider) {
+    const isUnprefixedModel = (model) => model.trim() !== CODEX_PROVIDER_ALIAS &&
+        !model.startsWith(OPENROUTER_PREFIX) &&
+        !model.startsWith(OLLAMA_PREFIX) &&
+        !model.startsWith(GOOGLE_PREFIX) &&
+        !model.startsWith(CODEX_PREFIX) &&
+        !model.startsWith(LEGACY_CODEX_PREFIX);
+    return {
+        isUnprefixedModel,
+        matchesOpenRouter: (model) => model.startsWith(OPENROUTER_PREFIX) ||
+            (isUnprefixedModel(model) && effectiveFallbackProvider === "openrouter"),
+        matchesOllama: (model) => model.startsWith(OLLAMA_PREFIX) ||
+            (isUnprefixedModel(model) && effectiveFallbackProvider === "ollama"),
+        matchesGoogle: (model) => model.startsWith(GOOGLE_PREFIX) ||
+            (isUnprefixedModel(model) && effectiveFallbackProvider === "google"),
+        matchesCodex: (model) => model.trim() === CODEX_PROVIDER_ALIAS ||
+            model.startsWith(CODEX_PREFIX) ||
+            (isUnprefixedModel(model) && effectiveFallbackProvider === "codex-cli"),
+    };
+}

package/esm/src/openai_compat.d.ts

@@ -1,4 +1,5 @@
-import type { Guardrails, ModelMessage, ModelProvider, ToolDefinition } from "@bolt-foundry/gambit-core";
+import { resolveEffectivePermissions } from "@bolt-foundry/gambit-core";
+import type { Guardrails, ModelMessage, ModelProvider, PermissionDeclarationInput, PermissionTrace, ToolDefinition } from "@bolt-foundry/gambit-core";
 export declare const logger: Console;
 export type ChatCompletionsRequest = {
     model: string;
@@ -59,5 +60,15 @@ export declare function chatCompletionsWithDeck(args: {
     guardrails?: Partial<Guardrails>;
     defaultModel?: string;
     onStreamText?: (chunk: string) => void;
+    workspacePermissions?: PermissionDeclarationInput;
+    workspacePermissionsBaseDir?: string;
+    sessionPermissions?: PermissionDeclarationInput;
+    sessionPermissionsBaseDir?: string;
+    parentPermissions?: ReturnType<typeof resolveEffectivePermissions>["effective"];
+    workerSandbox?: boolean;
+    trace?: (event: {
+        type: string;
+        permissions?: PermissionTrace;
+    }) => void;
 }): Promise<ChatCompletionsResponse>;
 //# sourceMappingURL=openai_compat.d.ts.map