@bolt-foundry/gambit-core 0.5.3-dev

package/script/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yEAAyE;AACzE,OAAO,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,oDAAoD;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,oCAAoC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,6BAA6B;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,iCAAiC;AACjC,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,oCAAoC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,uCAAuC;AACvC,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,2DAA2D;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,iDAAiD;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,kCAAkC;AAClC,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,yDAAyD;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,kDAAkD;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,iDAAiD;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,+DAA+D;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,yCAAyC;AACzC,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,0CAA0C;AAC1C,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,kCAAkC;AAClC,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,0DAA0D;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC"}

package/script/mod.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenRouterProvider = exports.renderDeck = exports.chatCompletionsWithDeck = exports.runDeck = exports.isGambitEndSignal = exports.defineDeck = exports.defineCard = void 0;
+/**
+ * Gambit core exports for authoring and running decks/cards with runtime helpers.
+ *
+ * @module
+ */
+/** Define a reusable card with shared behavior, tools, or guardrails. */
+require("./_dnt.polyfills.js");
+var definitions_js_1 = require("./src/definitions.js");
+Object.defineProperty(exports, "defineCard", { enumerable: true, get: function () { return definitions_js_1.defineCard; } });
+/** Define a deck, the primary unit of execution. */
+var definitions_js_2 = require("./src/definitions.js");
+Object.defineProperty(exports, "defineDeck", { enumerable: true, get: function () { return definitions_js_2.defineDeck; } });
+/** Check if a value is an explicit end-of-run signal. */
+var runtime_js_1 = require("./src/runtime.js");
+Object.defineProperty(exports, "isGambitEndSignal", { enumerable: true, get: function () { return runtime_js_1.isGambitEndSignal; } });
+/** Run a deck and return its execution result. */
+var runtime_js_2 = require("./src/runtime.js");
+Object.defineProperty(exports, "runDeck", { enumerable: true, get: function () { return runtime_js_2.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 render_js_1 = require("./src/render.js");
+Object.defineProperty(exports, "renderDeck", { enumerable: true, get: function () { return render_js_1.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/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/script/src/constants.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_GUARDRAILS: {
+    readonly maxDepth: 3;
+    readonly maxPasses: 10;
+    readonly timeoutMs: 120000;
+};
+export declare const RESERVED_TOOL_PREFIX = "gambit_";
+export declare const TOOL_NAME_PATTERN: RegExp;
+export declare const MAX_TOOL_NAME_LENGTH = 64;
+export declare const GAMBIT_TOOL_INIT = "gambit_init";
+export declare const GAMBIT_TOOL_RESPOND = "gambit_respond";
+export declare const GAMBIT_TOOL_COMPLETE = "gambit_complete";
+export declare const GAMBIT_TOOL_END = "gambit_end";
+export declare const BUILTIN_TOOL_NAME_SET: ReadonlySet<string>;
+export declare const DEFAULT_STATUS_DELAY_MS = 800;
+//# sourceMappingURL=constants.d.ts.map

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

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

package/script/src/constants.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STATUS_DELAY_MS = exports.BUILTIN_TOOL_NAME_SET = exports.GAMBIT_TOOL_END = exports.GAMBIT_TOOL_COMPLETE = exports.GAMBIT_TOOL_RESPOND = exports.GAMBIT_TOOL_INIT = exports.MAX_TOOL_NAME_LENGTH = exports.TOOL_NAME_PATTERN = exports.RESERVED_TOOL_PREFIX = exports.DEFAULT_GUARDRAILS = void 0;
+exports.DEFAULT_GUARDRAILS = {
+    maxDepth: 3,
+    maxPasses: 10,
+    timeoutMs: 120_000,
+};
+exports.RESERVED_TOOL_PREFIX = "gambit_";
+exports.TOOL_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+exports.MAX_TOOL_NAME_LENGTH = 64;
+exports.GAMBIT_TOOL_INIT = "gambit_init";
+exports.GAMBIT_TOOL_RESPOND = "gambit_respond";
+exports.GAMBIT_TOOL_COMPLETE = "gambit_complete";
+exports.GAMBIT_TOOL_END = "gambit_end";
+exports.BUILTIN_TOOL_NAME_SET = new Set([
+    exports.GAMBIT_TOOL_INIT,
+    exports.GAMBIT_TOOL_RESPOND,
+    exports.GAMBIT_TOOL_COMPLETE,
+    exports.GAMBIT_TOOL_END,
+]);
+// Default delay for busy/idle handler triggers.
+exports.DEFAULT_STATUS_DELAY_MS = 800;

package/script/src/definitions.d.ts

@@ -0,0 +1,11 @@
+import type { CardDefinition, DeckDefinition } from "./types.js";
+import type { z } from "zod";
+export declare function defineDeck<InputSchema extends z.ZodTypeAny, OutputSchema extends z.ZodTypeAny | undefined = undefined>(def: Omit<DeckDefinition<z.infer<InputSchema>>, "kind" | "inputSchema" | "outputSchema"> & {
+    inputSchema: InputSchema;
+    outputSchema?: OutputSchema;
+}): DeckDefinition<z.infer<InputSchema>>;
+export declare function defineDeck(def: Omit<DeckDefinition, "kind">): DeckDefinition;
+export declare function defineCard(def: Omit<CardDefinition, "kind">): CardDefinition;
+export declare function isDeckDefinition(value: unknown): value is DeckDefinition;
+export declare function isCardDefinition(value: unknown): value is CardDefinition;
+//# sourceMappingURL=definitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/src/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAgB,UAAU,CACxB,WAAW,SAAS,CAAC,CAAC,UAAU,EAChC,YAAY,SAAS,CAAC,CAAC,UAAU,GAAG,SAAS,GAAG,SAAS,EAEzD,GAAG,EACC,IAAI,CACJ,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EACpC,MAAM,GAAG,aAAa,GAAG,cAAc,CACxC,GACC;IACA,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,GACF,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AACxC,wBAAgB,UAAU,CACxB,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAChC,cAAc,CAAC;AAOlB,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,cAAc,CAE5E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAKxE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAKxE"}

package/script/src/definitions.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineDeck = defineDeck;
+exports.defineCard = defineCard;
+exports.isDeckDefinition = isDeckDefinition;
+exports.isCardDefinition = isCardDefinition;
+function defineDeck(def) {
+    return { kind: "gambit.deck", ...def };
+}
+function defineCard(def) {
+    return { kind: "gambit.card", ...def };
+}
+function isDeckDefinition(value) {
+    return Boolean(value && typeof value === "object" &&
+        value.kind === "gambit.deck");
+}
+function isCardDefinition(value) {
+    return Boolean(value && typeof value === "object" &&
+        value.kind === "gambit.card");
+}

package/script/src/loader.d.ts

@@ -0,0 +1,4 @@
+import type { LoadedCard, LoadedDeck } from "./types.js";
+export declare function loadCard(cardPath: string, parentPath?: string, stack?: Array<string>): Promise<LoadedCard>;
+export declare function loadDeck(deckPath: string, parentPath?: string): Promise<LoadedDeck>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/src/loader.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAKV,UAAU,EACV,UAAU,EAEX,MAAM,YAAY,CAAC;AAsHpB,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAKrB;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CA6HrB"}

package/script/src/loader.js

@@ -0,0 +1,206 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCard = loadCard;
+exports.loadDeck = loadDeck;
+const path = __importStar(require("../deps/jsr.io/@std/path/1.1.4/mod.js"));
+const constants_js_1 = require("./constants.js");
+const definitions_js_1 = require("./definitions.js");
+const schema_js_1 = require("./schema.js");
+const markdown_js_1 = require("./markdown.js");
+const logger = console;
+function toFileUrl(p) {
+    const abs = path.resolve(p);
+    return path.toFileUrl(abs).href;
+}
+function normalizeActionDecks(actions, basePath) {
+    if (!actions)
+        return [];
+    return actions.map((a) => ({
+        ...a,
+        path: basePath ? path.resolve(path.dirname(basePath), a.path) : a.path,
+    }));
+}
+function normalizeCompanionDecks(decks, basePath) {
+    if (!decks)
+        return [];
+    return decks.map((deck) => ({
+        ...deck,
+        path: basePath
+            ? path.resolve(path.dirname(basePath), deck.path)
+            : deck.path,
+    }));
+}
+function checkReserved(action) {
+    if (action.name.startsWith(constants_js_1.RESERVED_TOOL_PREFIX) &&
+        !constants_js_1.BUILTIN_TOOL_NAME_SET.has(action.name)) {
+        throw new Error(`Action name ${action.name} is reserved (prefix ${constants_js_1.RESERVED_TOOL_PREFIX})`);
+    }
+    if (!constants_js_1.TOOL_NAME_PATTERN.test(action.name) ||
+        action.name.length > constants_js_1.MAX_TOOL_NAME_LENGTH) {
+        throw new Error(`Action name ${action.name} must match ${constants_js_1.TOOL_NAME_PATTERN} and be <= ${constants_js_1.MAX_TOOL_NAME_LENGTH} characters`);
+    }
+}
+async function loadCardInternal(cardPath, parentPath, stack = []) {
+    const resolved = parentPath
+        ? path.resolve(path.dirname(parentPath), cardPath)
+        : path.resolve(cardPath);
+    if (stack.includes(resolved)) {
+        throw new Error(`Card/embed cycle detected: ${[...stack, resolved].join(" -> ")}`);
+    }
+    const mod = await Promise.resolve(`${toFileUrl(resolved)}`).then(s => __importStar(require(s)));
+    const card = mod.default;
+    if (!(0, definitions_js_1.isCardDefinition)(card)) {
+        throw new Error(`Card at ${resolved} did not export a valid card definition`);
+    }
+    if (card.handlers) {
+        throw new Error(`Card at ${resolved} cannot declare handlers (deck-only)`);
+    }
+    const cardLabel = card.label;
+    const actionDecks = normalizeActionDecks(card.actionDecks ?? card.actions, resolved);
+    if (!card.actionDecks && card.actions?.length) {
+        logger.warn(`[gambit] card at ${resolved} uses deprecated "actions"; rename to "actionDecks"`);
+    }
+    const testDecks = normalizeCompanionDecks(card.testDecks, resolved);
+    const graderDecks = normalizeCompanionDecks(card.graderDecks, resolved);
+    actionDecks.forEach(checkReserved);
+    const { label: _l, ...rest } = card;
+    return {
+        ...rest,
+        label: cardLabel,
+        actionDecks,
+        actions: actionDecks,
+        testDecks,
+        graderDecks,
+        path: resolved,
+        cards: [],
+    };
+}
+async function loadCard(cardPath, parentPath, stack = []) {
+    if ((0, markdown_js_1.isMarkdownFile)(cardPath)) {
+        return await (0, markdown_js_1.loadMarkdownCard)(cardPath, parentPath, stack);
+    }
+    return await loadCardInternal(cardPath, parentPath, stack);
+}
+async function loadDeck(deckPath, parentPath) {
+    if ((0, markdown_js_1.isMarkdownFile)(deckPath)) {
+        return await (0, markdown_js_1.loadMarkdownDeck)(deckPath, parentPath);
+    }
+    const resolved = parentPath
+        ? path.resolve(path.dirname(parentPath), deckPath)
+        : path.resolve(deckPath);
+    const mod = await Promise.resolve(`${toFileUrl(resolved)}`).then(s => __importStar(require(s)));
+    const deck = mod.default;
+    if (!(0, definitions_js_1.isDeckDefinition)(deck)) {
+        throw new Error(`Deck at ${resolved} did not export a valid deck definition`);
+    }
+    const deckLabel = deck.label;
+    const cards = [];
+    const mergedActions = {};
+    const allCards = flattenCards(cards);
+    for (const card of allCards) {
+        for (const action of card.actionDecks ?? []) {
+            checkReserved(action);
+            mergedActions[action.name] = action;
+        }
+    }
+    const deckActionDecks = deck.actionDecks ?? deck.actions;
+    if (!deck.actionDecks && deck.actions?.length) {
+        logger.warn(`[gambit] deck at ${resolved} uses deprecated "actions"; rename to "actionDecks"`);
+    }
+    for (const action of normalizeActionDecks(deckActionDecks, resolved)) {
+        checkReserved(action);
+        mergedActions[action.name] = action;
+    }
+    const actionDecks = Object.values(mergedActions);
+    let inputSchema = deck.inputSchema;
+    let outputSchema = deck.outputSchema;
+    for (const card of allCards) {
+        inputSchema = (0, schema_js_1.mergeZodObjects)(inputSchema, card.inputFragment);
+        outputSchema = (0, schema_js_1.mergeZodObjects)(outputSchema, card.outputFragment);
+    }
+    const executor = typeof deck.run === "function"
+        ? deck.run
+        : typeof deck.execute === "function"
+            ? deck.execute
+            : undefined;
+    const normalizeHandler = (cfg, kind) => {
+        if (!cfg)
+            return undefined;
+        const repeatMs = cfg.repeatMs ?? cfg.intervalMs;
+        if (cfg.intervalMs !== undefined && cfg.repeatMs === undefined) {
+            logger.warn(`[gambit] handlers.${kind}.intervalMs is deprecated; use repeatMs (${resolved})`);
+        }
+        return {
+            ...cfg,
+            repeatMs,
+            path: path.resolve(path.dirname(resolved), cfg.path),
+        };
+    };
+    const intervalAlias = deck.handlers?.onInterval;
+    const onBusy = normalizeHandler(deck.handlers?.onBusy ?? intervalAlias, intervalAlias ? "onInterval" : "onBusy");
+    if (!deck.handlers?.onBusy && intervalAlias) {
+        logger.warn(`[gambit] handlers.onInterval is deprecated; use handlers.onBusy (${resolved})`);
+    }
+    const onIdle = normalizeHandler(deck.handlers?.onIdle, "onIdle");
+    const handlers = deck.handlers
+        ? {
+            onError: deck.handlers.onError
+                ? {
+                    ...deck.handlers.onError,
+                    path: path.resolve(path.dirname(resolved), deck.handlers.onError.path),
+                }
+                : undefined,
+            onBusy,
+            onIdle,
+        }
+        : undefined;
+    const { label: _l, ...rest } = deck;
+    return {
+        ...rest,
+        label: deckLabel,
+        path: resolved,
+        cards: allCards,
+        actionDecks,
+        actions: actionDecks,
+        testDecks: normalizeCompanionDecks(deck.testDecks, resolved),
+        graderDecks: normalizeCompanionDecks(deck.graderDecks, resolved),
+        inputSchema,
+        outputSchema,
+        executor,
+        handlers,
+        respond: deck.respond,
+    };
+}
+function flattenCards(cards) {
+    const flat = [];
+    for (const card of cards) {
+        flat.push(card);
+        const nested = card.cards ?? [];
+        if (nested.length)
+            flat.push(...flattenCards(nested));
+    }
+    return flat;
+}

package/script/src/markdown.d.ts

@@ -0,0 +1,5 @@
+import type { LoadedCard, LoadedDeck } from "./types.js";
+export declare function loadMarkdownCard(filePath: string, parentPath?: string, stack?: Array<string>): Promise<LoadedCard>;
+export declare function loadMarkdownDeck(filePath: string, parentPath?: string): Promise<LoadedDeck>;
+export declare function isMarkdownFile(filePath: string): boolean;
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/src/markdown.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAIV,UAAU,EACV,UAAU,EAEX,MAAM,YAAY,CAAC;AA8IpB,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CA4FrB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CA8KrB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}