@bolt-foundry/gambit-core 0.8.1 → 0.8.5-rc.3

package/script/schemas/scenarios/plain_chat_output.d.ts

@@ -0,0 +1,5 @@
+import "../../_dnt.polyfills.js";
+import { z } from "zod";
+declare const plainChatOutputSchema: z.ZodType<string>;
+export default plainChatOutputSchema;
+//# sourceMappingURL=plain_chat_output.d.ts.map

package/script/schemas/scenarios/plain_chat_output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain_chat_output.d.ts","sourceRoot":"","sources":["../../../src/schemas/scenarios/plain_chat_output.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAc,CAAC;AAE5D,eAAe,qBAAqB,CAAC"}

package/script/schemas/scenarios/plain_chat_output.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("../../_dnt.polyfills.js");
+const zod_1 = require("zod");
+const plainChatOutputSchema = zod_1.z.string();
+exports.default = plainChatOutputSchema;

package/script/schemas/scenarios/plain_chat_output.zod.d.ts

@@ -0,0 +1,3 @@
+import "../../_dnt.polyfills.js";
+export { default } from "./plain_chat_output.js";
+//# sourceMappingURL=plain_chat_output.zod.d.ts.map

package/script/schemas/scenarios/plain_chat_output.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain_chat_output.zod.d.ts","sourceRoot":"","sources":["../../../src/schemas/scenarios/plain_chat_output.zod.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}

package/script/schemas/scenarios/plain_chat_output.zod.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+require("../../_dnt.polyfills.js");
+var plain_chat_output_js_1 = require("./plain_chat_output.js");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(plain_chat_output_js_1).default; } });

package/script/src/builtins.d.ts

@@ -1,3 +1,5 @@
 export declare function resolveBuiltinCardPath(target: string): string | undefined;
+export declare function resolveBuiltinSnippetPath(target: string): string | undefined;
 export declare function resolveBuiltinSchemaPath(target: string): string | undefined;
+export declare function resolveBuiltinDeckPath(target: string): string | undefined;
 //# sourceMappingURL=builtins.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/src/builtins.ts"],"names":[],"mappings":"AAYA,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOzE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO3E"}
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/src/builtins.ts"],"names":[],"mappings":"AAqBA,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAazE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO5E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgB3E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBzE"}

package/script/src/builtins.js

@@ -34,30 +34,76 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveBuiltinCardPath = resolveBuiltinCardPath;
+exports.resolveBuiltinSnippetPath = resolveBuiltinSnippetPath;
 exports.resolveBuiltinSchemaPath = resolveBuiltinSchemaPath;
+exports.resolveBuiltinDeckPath = resolveBuiltinDeckPath;
 const path = __importStar(require("../deps/jsr.io/@std/path/1.1.4/mod.js"));
 const CARDS_PREFIX = "gambit://cards/";
+const SNIPPETS_PREFIX = "gambit://snippets/";
 const SCHEMAS_PREFIX = "gambit://schemas/";
+const DECKS_PREFIX = "gambit://decks/";
 const CARDS_BASE_URL = new URL("../cards/", globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url);
+const SNIPPETS_BASE_URL = new URL("../snippets/", globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url);
 const SCHEMAS_BASE_URL = new URL("../schemas/", globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url);
+const DECKS_BASE_URL = new URL("../decks/", globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url);
+const LEGACY_CARD_WARNINGS = new Set();
+const LEGACY_SCHEMA_WARNINGS = new Set();
+const LEGACY_DECK_WARNINGS = new Set();
+const logger = console;
 function resolveFromBase(base, relative) {
     return path.fromFileUrl(new URL(relative, base));
 }
 function resolveBuiltinCardPath(target) {
     if (!target.startsWith(CARDS_PREFIX))
         return undefined;
+    if (!LEGACY_CARD_WARNINGS.has(target)) {
+        LEGACY_CARD_WARNINGS.add(target);
+        logger.warn(`[gambit] "${target}" is deprecated; use gambit://snippets instead.`);
+    }
     const relative = target.slice(CARDS_PREFIX.length);
     if (!relative) {
         throw new Error(`Invalid gambit card specifier: ${target}`);
     }
     return resolveFromBase(CARDS_BASE_URL, relative);
 }
+function resolveBuiltinSnippetPath(target) {
+    if (!target.startsWith(SNIPPETS_PREFIX))
+        return undefined;
+    const relative = target.slice(SNIPPETS_PREFIX.length);
+    if (!relative) {
+        throw new Error(`Invalid gambit snippet specifier: ${target}`);
+    }
+    return resolveFromBase(SNIPPETS_BASE_URL, relative);
+}
 function resolveBuiltinSchemaPath(target) {
     if (!target.startsWith(SCHEMAS_PREFIX))
         return undefined;
-    const relative = target.slice(SCHEMAS_PREFIX.length);
+    let relative = target.slice(SCHEMAS_PREFIX.length);
     if (!relative) {
         throw new Error(`Invalid gambit schema specifier: ${target}`);
     }
+    if (relative.endsWith(".ts") && !relative.endsWith(".zod.ts")) {
+        if (!LEGACY_SCHEMA_WARNINGS.has(target)) {
+            LEGACY_SCHEMA_WARNINGS.add(target);
+            logger.warn(`[gambit] "${target}" is deprecated; use .zod.ts schema URIs instead.`);
+        }
+        relative = `${relative.slice(0, -3)}.zod.ts`;
+    }
     return resolveFromBase(SCHEMAS_BASE_URL, relative);
 }
+function resolveBuiltinDeckPath(target) {
+    if (!target.startsWith(DECKS_PREFIX))
+        return undefined;
+    let relative = target.slice(DECKS_PREFIX.length);
+    if (!relative) {
+        throw new Error(`Invalid gambit deck specifier: ${target}`);
+    }
+    if (!relative.endsWith("/PROMPT.md")) {
+        if (!LEGACY_DECK_WARNINGS.has(target)) {
+            LEGACY_DECK_WARNINGS.add(target);
+            logger.warn(`[gambit] "${target}" is deprecated; use gambit://decks/.../PROMPT.md instead.`);
+        }
+        relative = `${relative.replace(/\/?$/, "/")}PROMPT.md`;
+    }
+    return resolveFromBase(DECKS_BASE_URL, relative);
+}

package/script/src/constants.d.ts

@@ -6,6 +6,10 @@ export declare const DEFAULT_GUARDRAILS: {
 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_CONTEXT = "gambit_context";
+/**
+ * @deprecated Use GAMBIT_TOOL_CONTEXT instead.
+ */
 export declare const GAMBIT_TOOL_INIT = "gambit_init";
 export declare const GAMBIT_TOOL_RESPOND = "gambit_respond";
 export declare const GAMBIT_TOOL_COMPLETE = "gambit_complete";

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

@@ -1 +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"}
+{"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,mBAAmB,mBAAmB,CAAC;AACpD;;GAEG;AACH,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,CAMpD,CAAC;AAGH,eAAO,MAAM,uBAAuB,MAAM,CAAC"}

package/script/src/constants.js

@@ -1,6 +1,6 @@
 "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_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.GAMBIT_TOOL_CONTEXT = 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,
@@ -9,11 +9,16 @@ exports.DEFAULT_GUARDRAILS = {
 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_CONTEXT = "gambit_context";
+/**
+ * @deprecated Use GAMBIT_TOOL_CONTEXT instead.
+ */
 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_CONTEXT,
     exports.GAMBIT_TOOL_INIT,
     exports.GAMBIT_TOOL_RESPOND,
     exports.GAMBIT_TOOL_COMPLETE,

package/script/src/definitions.d.ts

@@ -1,6 +1,10 @@
 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"> & {
+export declare function defineDeck<InputSchema extends z.ZodTypeAny, OutputSchema extends z.ZodTypeAny | undefined = undefined>(def: Omit<DeckDefinition<z.infer<InputSchema>>, "kind" | "contextSchema" | "responseSchema" | "inputSchema" | "outputSchema"> & {
+    contextSchema: InputSchema;
+    responseSchema?: OutputSchema;
+}): DeckDefinition<z.infer<InputSchema>>;
+export declare function defineDeck<InputSchema extends z.ZodTypeAny, OutputSchema extends z.ZodTypeAny | undefined = undefined>(def: Omit<DeckDefinition<z.infer<InputSchema>>, "kind" | "contextSchema" | "responseSchema" | "inputSchema" | "outputSchema"> & {
     inputSchema: InputSchema;
     outputSchema?: OutputSchema;
 }): DeckDefinition<z.infer<InputSchema>>;

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

@@ -1 +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"}
+{"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,EAClC,MAAM,GACN,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,cAAc,CACjB,GACC;IACA,aAAa,EAAE,WAAW,CAAC;IAC3B,cAAc,CAAC,EAAE,YAAY,CAAC;CAC/B,GACF,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AACxC,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,EAClC,MAAM,GACN,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,cAAc,CACjB,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/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/src/loader.ts"],"names":[],"mappings":"AAeA,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,CAOrB;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CA6HrB"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/src/loader.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAMV,UAAU,EACV,UAAU,EAEX,MAAM,YAAY,CAAC;AAiPpB,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CA4JrB"}

package/script/src/loader.js

@@ -35,13 +35,63 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadCard = loadCard;
 exports.loadDeck = loadDeck;
+const dntShim = __importStar(require("../_dnt.shims.js"));
 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 permissions_js_1 = require("./permissions.js");
 const schema_js_1 = require("./schema.js");
 const markdown_js_1 = require("./markdown.js");
 const builtins_js_1 = require("./builtins.js");
 const logger = console;
+const LEGACY_SCHEMA_WARNINGS = new Set();
+const LEGACY_FRAGMENT_WARNINGS = new Set();
+function warnLegacySchema(resolvedPath, legacy, replacement) {
+    const key = `${resolvedPath}:${legacy}`;
+    if (LEGACY_SCHEMA_WARNINGS.has(key))
+        return;
+    LEGACY_SCHEMA_WARNINGS.add(key);
+    logger.warn(`[gambit] deck at ${resolvedPath} uses deprecated "${legacy}"; rename to "${replacement}"`);
+}
+function warnLegacyFragment(resolvedPath, legacy, replacement) {
+    const key = `${resolvedPath}:${legacy}`;
+    if (LEGACY_FRAGMENT_WARNINGS.has(key))
+        return;
+    LEGACY_FRAGMENT_WARNINGS.add(key);
+    logger.warn(`[gambit] card at ${resolvedPath} uses deprecated "${legacy}"; rename to "${replacement}"`);
+}
+function normalizeDeckSchemas(deck, resolvedPath) {
+    if (deck.inputSchema !== undefined) {
+        warnLegacySchema(resolvedPath, "inputSchema", "contextSchema");
+    }
+    if (deck.outputSchema !== undefined) {
+        warnLegacySchema(resolvedPath, "outputSchema", "responseSchema");
+    }
+    const contextSchema = deck.contextSchema ?? deck.inputSchema;
+    const responseSchema = deck.responseSchema ?? deck.outputSchema;
+    return {
+        contextSchema,
+        responseSchema,
+        inputSchema: contextSchema,
+        outputSchema: responseSchema,
+    };
+}
+function normalizeCardFragments(card, resolvedPath) {
+    if (card.inputFragment !== undefined) {
+        warnLegacyFragment(resolvedPath, "inputFragment", "contextFragment");
+    }
+    if (card.outputFragment !== undefined) {
+        warnLegacyFragment(resolvedPath, "outputFragment", "responseFragment");
+    }
+    const contextFragment = card.contextFragment ?? card.inputFragment;
+    const responseFragment = card.responseFragment ?? card.outputFragment;
+    return {
+        contextFragment,
+        responseFragment,
+        inputFragment: contextFragment,
+        outputFragment: responseFragment,
+    };
+}
 function toFileUrl(p) {
     const abs = path.resolve(p);
     return path.toFileUrl(abs).href;
@@ -51,7 +101,10 @@ function normalizeActionDecks(actions, basePath) {
         return [];
     return actions.map((a) => ({
         ...a,
-        path: basePath ? path.resolve(path.dirname(basePath), a.path) : a.path,
+        path: a.path.startsWith("gambit://") || !basePath
+            ? a.path
+            : path.resolve(path.dirname(basePath), a.path),
+        permissions: (0, permissions_js_1.normalizePermissionDeclaration)(a.permissions, basePath ? path.dirname(basePath) : dntShim.Deno.cwd()),
     }));
 }
 function normalizeCompanionDecks(decks, basePath) {
@@ -59,9 +112,10 @@ function normalizeCompanionDecks(decks, basePath) {
         return [];
     return decks.map((deck) => ({
         ...deck,
-        path: basePath
-            ? path.resolve(path.dirname(basePath), deck.path)
-            : deck.path,
+        path: deck.path.startsWith("gambit://") || !basePath
+            ? deck.path
+            : path.resolve(path.dirname(basePath), deck.path),
+        permissions: (0, permissions_js_1.normalizePermissionDeclaration)(deck.permissions, basePath ? path.dirname(basePath) : dntShim.Deno.cwd()),
     }));
 }
 function checkReserved(action) {
@@ -74,6 +128,30 @@ function checkReserved(action) {
         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`);
     }
 }
+function normalizeExternalTools(tools, resolvedPath) {
+    if (!tools)
+        return [];
+    return tools.map((tool) => {
+        const name = String(tool.name ?? "").trim();
+        if (!name) {
+            throw new Error(`External tool must include a name (${resolvedPath})`);
+        }
+        if (name.startsWith(constants_js_1.RESERVED_TOOL_PREFIX)) {
+            throw new Error(`External tool name ${name} is reserved (prefix ${constants_js_1.RESERVED_TOOL_PREFIX})`);
+        }
+        if (!constants_js_1.TOOL_NAME_PATTERN.test(name) ||
+            name.length > constants_js_1.MAX_TOOL_NAME_LENGTH) {
+            throw new Error(`External tool name ${name} must match ${constants_js_1.TOOL_NAME_PATTERN} and be <= ${constants_js_1.MAX_TOOL_NAME_LENGTH} characters`);
+        }
+        return {
+            name,
+            description: typeof tool.description === "string"
+                ? tool.description
+                : undefined,
+            inputSchema: tool.inputSchema,
+        };
+    });
+}
 async function loadCardInternal(cardPath, parentPath, stack = []) {
     const resolved = parentPath
         ? path.resolve(path.dirname(parentPath), cardPath)
@@ -98,6 +176,7 @@ async function loadCardInternal(cardPath, parentPath, stack = []) {
     const graderDecks = normalizeCompanionDecks(card.graderDecks, resolved);
     actionDecks.forEach(checkReserved);
     const { label: _l, ...rest } = card;
+    const fragments = normalizeCardFragments(card, resolved);
     return {
         ...rest,
         label: cardLabel,
@@ -107,28 +186,37 @@ async function loadCardInternal(cardPath, parentPath, stack = []) {
         graderDecks,
         path: resolved,
         cards: [],
+        ...fragments,
+        permissions: (0, permissions_js_1.normalizePermissionDeclaration)(card.permissions, path.dirname(resolved)),
     };
 }
 async function loadCard(cardPath, parentPath, stack = []) {
     const builtinPath = (0, builtins_js_1.resolveBuiltinCardPath)(cardPath);
-    const normalizedPath = builtinPath ?? cardPath;
+    const snippetPath = (0, builtins_js_1.resolveBuiltinSnippetPath)(cardPath);
+    const normalizedPath = snippetPath ?? builtinPath ?? cardPath;
     if ((0, markdown_js_1.isMarkdownFile)(normalizedPath)) {
         return await (0, markdown_js_1.loadMarkdownCard)(normalizedPath, parentPath, stack);
     }
     return await loadCardInternal(normalizedPath, parentPath, stack);
 }
 async function loadDeck(deckPath, parentPath) {
-    if ((0, markdown_js_1.isMarkdownFile)(deckPath)) {
-        return await (0, markdown_js_1.loadMarkdownDeck)(deckPath, parentPath);
+    const builtinDeck = (0, builtins_js_1.resolveBuiltinDeckPath)(deckPath);
+    const normalizedDeckPath = builtinDeck ?? deckPath;
+    const markdownParent = builtinDeck ? undefined : parentPath;
+    if ((0, markdown_js_1.isMarkdownFile)(normalizedDeckPath)) {
+        return await (0, markdown_js_1.loadMarkdownDeck)(normalizedDeckPath, markdownParent);
     }
-    const resolved = parentPath
-        ? path.resolve(path.dirname(parentPath), deckPath)
-        : path.resolve(deckPath);
+    const resolved = markdownParent
+        ? path.resolve(path.dirname(markdownParent), normalizedDeckPath)
+        : path.resolve(normalizedDeckPath);
     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`);
     }
+    if (deck.mcpServers !== undefined) {
+        throw new Error(`Deck-level [[mcpServers]] is unsupported in this phase (${resolved})`);
+    }
     const deckLabel = deck.label;
     const cards = [];
     const mergedActions = {};
@@ -148,12 +236,26 @@ async function loadDeck(deckPath, parentPath) {
         mergedActions[action.name] = action;
     }
     const actionDecks = Object.values(mergedActions);
-    let inputSchema = deck.inputSchema;
-    let outputSchema = deck.outputSchema;
+    const tools = normalizeExternalTools(deck.tools, resolved);
+    const actionNames = new Set(actionDecks.map((action) => action.name));
+    for (const tool of tools) {
+        if (actionNames.has(tool.name)) {
+            logger.warn(`[gambit] tool ${tool.name} is shadowed by an action in ${resolved}`);
+        }
+    }
+    const schemaAliases = normalizeDeckSchemas(deck, resolved);
+    let inputSchema = schemaAliases.inputSchema;
+    let outputSchema = schemaAliases.outputSchema;
+    let contextSchema = schemaAliases.contextSchema;
+    let responseSchema = schemaAliases.responseSchema;
     for (const card of allCards) {
         inputSchema = (0, schema_js_1.mergeZodObjects)(inputSchema, card.inputFragment);
         outputSchema = (0, schema_js_1.mergeZodObjects)(outputSchema, card.outputFragment);
+        contextSchema = (0, schema_js_1.mergeZodObjects)(contextSchema, card.contextFragment);
+        responseSchema = (0, schema_js_1.mergeZodObjects)(responseSchema, card.responseFragment);
     }
+    inputSchema = contextSchema;
+    outputSchema = responseSchema;
     const executor = typeof deck.run === "function"
         ? deck.run
         : typeof deck.execute === "function"
@@ -200,11 +302,15 @@ async function loadDeck(deckPath, parentPath) {
         actions: actionDecks,
         testDecks: normalizeCompanionDecks(deck.testDecks, resolved),
         graderDecks: normalizeCompanionDecks(deck.graderDecks, resolved),
+        tools,
+        contextSchema,
+        responseSchema,
         inputSchema,
         outputSchema,
         executor,
         handlers,
         respond: deck.respond,
+        permissions: (0, permissions_js_1.normalizePermissionDeclaration)(deck.permissions, path.dirname(resolved)),
     };
 }
 function flattenCards(cards) {

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

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/src/markdown.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAIV,UAAU,EACV,UAAU,EAEX,MAAM,YAAY,CAAC;AAmKpB,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CA8FrB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAgLrB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/src/markdown.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAKV,UAAU,EACV,UAAU,EAEX,MAAM,YAAY,CAAC;AAuVpB,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,GAAE,KAAK,CAAC,MAAM,CAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAsGrB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAqPrB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}