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

package/CHANGELOG.md

@@ -1,14 +1,86 @@
 +++
 [release]
-since = "849762245925cce325c04da1d604088370ec3723"
+since = "f9185fb1967a31e92a4a26dbb94cfe1322148406"
 +++
 
 # Changelog
 
-## Unreleased (v0.8.4)
+## Unreleased (v0.8.5)
 
 - TBD
 
+## v0.8.5-rc.10
+
+- #4004: add OpenResponses convergence runtime + extensions + async action
+  semantics in gambit-core.
+- #4004: retire synthetic respond/end docs and align deck authoring guidance.
+- #4010: fix gambit-core npm runtime layouts to ship built-in snippets/decks.
+
+## v0.8.5-rc.9
+
+- TBD
+
+## v0.8.5-rc.8
+
+- chore(gambit): cut 0.8.5-rc.7
+- Switch ci-gambit-core to run nix develop via step commands with a profile
+  instead of custom shell overrides. This avoids both workflow-parse failures
+  and literal path resolution failures.
+
+## v0.8.5-rc.7
+
+- chore(gambit): cut 0.8.5-rc.6
+- fix(gambit-ci): stop using github.workspace in shell field
+- fix(gambit): include `src/decks` assets in compiled CLI binaries
+
+## v0.8.5-rc.6
+
+- chore(gambit): cut 0.8.5-rc.5 and pin React to 19.2.4
+- chore(repo): pin jsx-runtime imports to react 19.2.4
+- refactor(gambit): Fix left drawer
+- feat(gambit-simulator-ui): send scenario run errors to workbench chat
+- refactor(gambit-simulator-ui): replace placeholders with reusable callout
+- fix(gambit): validate explicit deck path and stabilize stop test
+- feat(simulator-ui): use icon remove action for error context chip
+- fix(gambit): invalidate build deck label cache on frontmatter changes
+- feat(gambit): add workbench composer chip and chat flow updates
+
+## v0.8.5-rc.5
+
+- TBD
+
+## v0.8.5-rc.4
+
+- chore(infra): run `deno task build_npm` for gambit during `bft precommit`
+- fix(gambit): ignore dnt TS2345 diagnostics from vendored `@std/fs` and
+  `@std/toml` npm-compat sources
+
+## v0.8.5-rc.3
+
+- fix(gambit-release): support nested core path and cut 0.8.5-rc.2
+- refactor(gambit-core): remove built-in exec tool from runtime
+- fix(gambit-core): partition worker sandbox by runtime host
+- test(gambit-core): add unsupported worker sandbox coverage
+- docs(gambit-core): document worker sandbox host contract
+- ci(gambit-core): gate npm compatibility in core CI
+
+## v0.8.5-rc.2
+
+- TBD
+
+## v0.8.5-rc.1
+
+- feat(gambit): remove `gambit init`; onboarding now routes through
+  `gambit serve`
+- feat(gambit): add `createDefaultedRuntime` and defaulted `runDeck` wrapper
+  with CLI-equivalent provider/model routing for library callers
+- refactor(gambit): route CLI runtime/provider setup through shared
+  `default_runtime` construction path
+- feat(demo-runner): migrate demo test-deck prompt generation to Gambit default
+  runtime wrapper (no hardwired OpenRouter provider)
+- docs(gambit): add migration guidance for `runDeck` wrapper and `runDeckCore`
+  replacement mapping
+
 ## v0.8.3
 
 - fix(gambit): include CLI docs/reference files in binary builds

package/README.md

@@ -22,15 +22,14 @@ 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:
+To start onboarding with the simulator, run:
 
 ```
-npx @bolt-foundry/gambit init my-project
+npx @bolt-foundry/gambit serve gambit/hello.deck.md
+open http://localhost:8000/debug
 ```
 
-This creates a structured skeleton (`decks/`, `actions/`, `graders/`, `tests/`,
-`schemas/`, `.gambit/`) with README guides so you can start authoring your own
-workflows immediately.
+Use the Build tab to draft your own workspace decks and scenarios.
 
 Run an example in the terminal (`repl`):
 
@@ -100,10 +99,10 @@ Drop into a REPL (streams by default):
 npx @bolt-foundry/gambit repl <deck>
 ```
 
-Run a persona against a root deck (test bot):
+Run a persona against a root deck (scenario):
 
 ```
-npx @bolt-foundry/gambit test-bot <root-deck> --test-deck <persona-deck>
+npx @bolt-foundry/gambit scenario <root-deck> --test-deck <persona-deck>
 ```
 
 Grade a saved session:
@@ -124,6 +123,23 @@ Tracing and state:
 `--verbose` to print events\
 `--state <file>` to persist a session.
 
+### Worker sandbox defaults
+
+- Deck-executing CLI surfaces default to worker sandbox execution.
+- Use `--no-worker-sandbox` (or `--legacy-exec`) to force legacy in-process
+  execution.
+- `--worker-sandbox` explicitly forces worker execution on.
+- `--sandbox` / `--no-sandbox` are deprecated aliases.
+- `gambit.toml` equivalent:
+  ```toml
+  [execution]
+  worker_sandbox = false # same as --no-worker-sandbox
+  # legacy_exec = true    # equivalent rollback toggle
+  ```
+
+The npm launcher (`npx @bolt-foundry/gambit ...`) runs the Gambit CLI binary for
+your platform, so these defaults and flags apply there as well.
+
 ## Using the Simulator
 
 The simulator is the local Debug UI that streams runs and renders traces.
@@ -173,6 +189,59 @@ Define `contextSchema`/`responseSchema` with Zod to validate IO, and implement\
 `ctx.spawnAndWait({ path, input })`. Emit structured trace events with\
 `ctx.log(...)`.
 
+### Runtime defaults for programmatic `runDeck`
+
+`runDeck` from `@bolt-foundry/gambit` now uses CLI-equivalent provider/model
+defaults (alias expansion, provider routing, fallback behavior).
+
+Before (direct-provider setup in each caller):
+
+```ts
+import { createOpenRouterProvider, runDeck } from "jsr:@bolt-foundry/gambit";
+
+const provider = createOpenRouterProvider({
+  apiKey: Deno.env.get("OPENROUTER_API_KEY")!,
+});
+await runDeck({
+  path: "./root.deck.md",
+  input: { message: "hi" },
+  modelProvider: provider,
+});
+```
+
+After (defaulted wrapper):
+
+```ts
+import { runDeck } from "jsr:@bolt-foundry/gambit";
+
+await runDeck({
+  path: "./root.deck.md",
+  input: { message: "hi" },
+});
+```
+
+Per-runtime override (shared runtime object):
+
+```ts
+import { createDefaultedRuntime, runDeck } from "jsr:@bolt-foundry/gambit";
+
+const runtime = await createDefaultedRuntime({
+  fallbackProvider: "codex-cli",
+});
+
+await runDeck({
+  runtime,
+  path: "./root.deck.md",
+  input: { message: "hi" },
+});
+```
+
+Replacement mapping:
+
+- Legacy direct core passthrough export: `runDeck` -> `runDeckCore`
+- Defaulted wrapper export: `runDeck`
+- Runtime builder: `createDefaultedRuntime`
+
 ---
 
 ## Author your first deck
@@ -226,7 +295,7 @@ npx @bolt-foundry/gambit run ./echo.deck.ts --context '{"text":"ping"}'
 +++
 label = "agent_with_time"
 modelParams = { model = "openai/gpt-4o-mini", temperature = 0 }
-[[actionDecks]]
+[[actions]]
 name = "get_time"
 path = "./get_time.deck.ts"
 description = "Return the current ISO timestamp."
@@ -258,10 +327,11 @@ Run it:
 npx @bolt-foundry/gambit run ./agent_with_time.deck.md --context '"hello"' --stream
 ```
 
-### Respond flow demo (non-root decks + grading)
+### Legacy respond-flow demo (historical compatibility)
 
-Need a turnkey scenario that hits personas → init → non-root `gambit_respond`
-payloads → graders? Use the example in `packages/gambit/examples/respond_flow/`.
+`packages/gambit/examples/respond_flow/` is kept as a legacy compatibility
+example for historical transcript/grader behavior. New decks should return
+schema-valid assistant output directly instead of calling `gambit_respond`.
 
 ```
 cd packages/gambit
@@ -271,12 +341,12 @@ npx @bolt-foundry/gambit serve ./examples/respond_flow/decks/root.deck.ts --port
 Then:
 
 1. Open `http://localhost:8000/test`, pick the **Escalation persona**, and run
-   it. Leave the “Use test deck input for init” toggle on to see persona data
-   seed the init form automatically.
-2. Switch to the Debug tab to inspect the session—the child deck emits a
-   `gambit_respond` payload that now shows up as a structured assistant turn.
-3. Head to the Calibrate tab and run the **Respond payload grader** to exercise
-   grading on the non-root respond output.
+   it. Leave the “Use scenario deck input for init” toggle on to see persona
+   data seed the init form automatically.
+2. Switch to the Debug tab to inspect the session; this scenario still emits
+   legacy `gambit_respond` payloads for compatibility testing.
+3. Head to the Calibrate tab and run the **Respond payload grader** to validate
+   historical non-root respond-output handling.
 
 ## Deno
 
@@ -289,12 +359,6 @@ export OPENROUTER_API_KEY=...
 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:
 
 ```

package/esm/_dnt.polyfills.d.ts

@@ -97,5 +97,22 @@ interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyf
 export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
 export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
 export declare let import_meta_ponyfill: ImportMetaPonyfill;
+declare global {
+    interface Object {
+        /**
+         * Determines whether an object has a property with the specified name.
+         * @param o An object.
+         * @param v A property name.
+         */
+        hasOwn(o: object, v: PropertyKey): boolean;
+    }
+}
+export {};
+declare global {
+    interface ArrayConstructor {
+        fromAsync<T>(iterableOrArrayLike: AsyncIterable<T> | Iterable<T | Promise<T>> | ArrayLike<T | Promise<T>>): Promise<T[]>;
+        fromAsync<T, U>(iterableOrArrayLike: AsyncIterable<T> | Iterable<T> | ArrayLike<T>, mapFn: (value: Awaited<T>) => U, thisArg?: any): Promise<Awaited<U>[]>;
+    }
+}
 export {};
 //# sourceMappingURL=_dnt.polyfills.d.ts.map

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

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

package/esm/_dnt.polyfills.js

@@ -125,3 +125,126 @@ export let import_meta_ponyfill = ((...args) => {
     //@ts-ignore
     return import_meta_ponyfill(...args);
 });
+// https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
+if (!Object.hasOwn) {
+    Object.defineProperty(Object, "hasOwn", {
+        value: function (object, property) {
+            if (object == null) {
+                throw new TypeError("Cannot convert undefined or null to object");
+            }
+            return Object.prototype.hasOwnProperty.call(Object(object), property);
+        },
+        configurable: true,
+        enumerable: false,
+        writable: true,
+    });
+}
+// From https://github.com/es-shims/array-from-async/blob/4a5ff83947b861f35b380d5d4f20da2f07698638/index.mjs
+// Tried to have dnt depend on the package instead, but it distributes as an
+// ES module, so doesn't work with CommonJS.
+//
+// Code below:
+//
+// Copyright 2021 J. S. Choi
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions
+// are met:
+//
+// 1. Redistributions of source code must retain the above copyright
+//    notice, this list of conditions and the following disclaimer.
+//
+// 2. Redistributions in binary form must reproduce the above copyright
+//    notice, this list of conditions and the following disclaimer in the
+//    documentation and/or other materials provided with the distribution.
+//
+// 3. Neither the name of the copyright holder nor the names of its
+//    contributors may be used to endorse or promote products derived from
+//    this software without specific prior written permission.
+//
+// **This software is provided by the copyright holders and contributors
+// "as is" and any express or implied warranties, including, but not
+// limited to, the implied warranties of merchantability and fitness for a
+// particular purpose are disclaimed. In no event shall the copyright
+// holder or contributors be liable for any direct, indirect, incidental,
+// special, exemplary, or consequential damages (including, but not limited
+// to, procurement of substitute goods or services; loss of use, data, or
+// profits; or business interruption) however caused and on any theory of
+// liability, whether in contract, strict liability, or tort (including
+// negligence or otherwise) arising in any way out of the use of this
+// software, even if advised of the possibility of such damage.**
+const { MAX_SAFE_INTEGER } = Number;
+const iteratorSymbol = Symbol.iterator;
+const asyncIteratorSymbol = Symbol.asyncIterator;
+const IntrinsicArray = Array;
+const tooLongErrorMessage = 'Input is too long and exceeded Number.MAX_SAFE_INTEGER times.';
+function isConstructor(obj) {
+    if (obj != null) {
+        const prox = new Proxy(obj, {
+            construct() {
+                return prox;
+            },
+        });
+        try {
+            new prox;
+            return true;
+        }
+        catch (err) {
+            return false;
+        }
+    }
+    else {
+        return false;
+    }
+}
+async function fromAsync(items, mapfn, thisArg) {
+    const itemsAreIterable = (asyncIteratorSymbol in items ||
+        iteratorSymbol in items);
+    if (itemsAreIterable) {
+        const result = isConstructor(this)
+            ? new this
+            : IntrinsicArray(0);
+        let i = 0;
+        for await (const v of items) {
+            if (i > MAX_SAFE_INTEGER) {
+                throw TypeError(tooLongErrorMessage);
+            }
+            else if (mapfn) {
+                result[i] = await mapfn.call(thisArg, v, i);
+            }
+            else {
+                result[i] = v;
+            }
+            i++;
+        }
+        result.length = i;
+        return result;
+    }
+    else {
+        // In this case, the items are assumed to be an arraylike object with
+        // a length property and integer properties for each element.
+        const { length } = items;
+        const result = isConstructor(this)
+            ? new this(length)
+            : IntrinsicArray(length);
+        let i = 0;
+        while (i < length) {
+            if (i > MAX_SAFE_INTEGER) {
+                throw TypeError(tooLongErrorMessage);
+            }
+            const v = await items[i];
+            if (mapfn) {
+                result[i] = await mapfn.call(thisArg, v, i);
+            }
+            else {
+                result[i] = v;
+            }
+            i++;
+        }
+        result.length = i;
+        return result;
+    }
+}
+if (!Array.fromAsync) {
+    Array.fromAsync = fromAsync;
+}