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

package/esm/schemas/graders/contexts/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../../../src/schemas/graders/contexts/turn.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAClD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;CACrD,CAAC;AAEF,QAAA,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAGxD,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

package/esm/schemas/graders/contexts/turn.js

@@ -0,0 +1,8 @@
+import "../../../_dnt.polyfills.js";
+import { z } from "zod";
+import { graderConversationSchema, graderMessageSchema, } from "./conversation.js";
+const graderTurnContextSchema = z.object({
+    session: graderConversationSchema,
+    messageToGrade: graderMessageSchema,
+});
+export default graderTurnContextSchema;

package/esm/schemas/graders/contexts/turn.zod.d.ts

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

package/esm/schemas/graders/contexts/turn.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.zod.d.ts","sourceRoot":"","sources":["../../../../src/schemas/graders/contexts/turn.zod.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/esm/schemas/graders/contexts/turn.zod.js

@@ -0,0 +1,2 @@
+import "../../../_dnt.polyfills.js";
+export { default } from "./turn.js";

package/esm/schemas/graders/contexts/turn_tools.d.ts

@@ -0,0 +1,32 @@
+import "../../../_dnt.polyfills.js";
+import { z } from "zod";
+type GraderToolCall = {
+    id?: string;
+    type?: string;
+    function: {
+        name: string;
+        arguments?: string;
+    };
+};
+type GraderMessageWithTools = {
+    role: string;
+    content?: unknown;
+    name?: string;
+    tool_calls?: Array<GraderToolCall>;
+};
+type GraderConversationWithTools = {
+    messages?: Array<GraderMessageWithTools>;
+    meta?: Record<string, unknown>;
+    notes?: {
+        text?: string;
+    };
+};
+type GraderTurnToolsContext = {
+    session: GraderConversationWithTools;
+    messageToGrade: GraderMessageWithTools;
+};
+export declare const graderMessageWithToolsSchema: z.ZodType<GraderMessageWithTools>;
+export declare const graderConversationWithToolsSchema: z.ZodType<GraderConversationWithTools>;
+declare const graderTurnToolsContextSchema: z.ZodType<GraderTurnToolsContext>;
+export default graderTurnToolsContextSchema;
+//# sourceMappingURL=turn_tools.d.ts.map

package/esm/schemas/graders/contexts/turn_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn_tools.d.ts","sourceRoot":"","sources":["../../../../src/schemas/graders/contexts/turn_tools.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,KAAK,cAAc,GAAG;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CACpC,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,QAAQ,CAAC,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,OAAO,EAAE,2BAA2B,CAAC;IACrC,cAAc,EAAE,sBAAsB,CAAC;CACxC,CAAC;AAWF,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAMvE,CAAC;AAEL,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,OAAO,CACvD,2BAA2B,CAK3B,CAAC;AAEH,QAAA,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAIhE,CAAC;AAEL,eAAe,4BAA4B,CAAC"}

package/esm/schemas/graders/contexts/turn_tools.js

@@ -0,0 +1,28 @@
+import "../../../_dnt.polyfills.js";
+import { z } from "zod";
+const graderToolCallSchema = z.object({
+    id: z.string().optional(),
+    type: z.string().optional(),
+    function: z.object({
+        name: z.string(),
+        arguments: z.string().optional(),
+    }),
+});
+export const graderMessageWithToolsSchema = z
+    .object({
+    role: z.string(),
+    content: z.any().optional(),
+    name: z.string().optional(),
+    tool_calls: z.array(graderToolCallSchema).optional(),
+});
+export const graderConversationWithToolsSchema = z.object({
+    messages: z.array(graderMessageWithToolsSchema).optional(),
+    meta: z.record(z.any()).optional(),
+    notes: z.object({ text: z.string().optional() }).optional(),
+});
+const graderTurnToolsContextSchema = z
+    .object({
+    session: graderConversationWithToolsSchema,
+    messageToGrade: graderMessageWithToolsSchema,
+});
+export default graderTurnToolsContextSchema;

package/esm/schemas/graders/contexts/turn_tools.zod.d.ts

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

package/esm/schemas/graders/contexts/turn_tools.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn_tools.zod.d.ts","sourceRoot":"","sources":["../../../../src/schemas/graders/contexts/turn_tools.zod.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}

package/esm/schemas/graders/contexts/turn_tools.zod.js

@@ -0,0 +1,2 @@
+import "../../../_dnt.polyfills.js";
+export { default } from "./turn_tools.js";

package/esm/schemas/graders/grader_output.d.ts

@@ -0,0 +1,10 @@
+import "../../_dnt.polyfills.js";
+import { z } from "zod";
+type GraderOutput = {
+    score: number;
+    reason: string;
+    evidence?: Array<string>;
+};
+declare const graderOutputSchema: z.ZodType<GraderOutput>;
+export default graderOutputSchema;
+//# sourceMappingURL=grader_output.d.ts.map

package/esm/schemas/graders/grader_output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grader_output.d.ts","sourceRoot":"","sources":["../../../src/schemas/graders/grader_output.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC1B,CAAC;AAEF,QAAA,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAI9C,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/esm/schemas/graders/grader_output.js

@@ -0,0 +1,8 @@
+import "../../_dnt.polyfills.js";
+import { z } from "zod";
+const graderOutputSchema = z.object({
+    score: z.number().int().min(-3).max(3),
+    reason: z.string(),
+    evidence: z.array(z.string()).optional(),
+});
+export default graderOutputSchema;

package/esm/schemas/graders/grader_output.zod.d.ts

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

package/esm/schemas/graders/grader_output.zod.d.ts.map

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

package/esm/schemas/graders/grader_output.zod.js

@@ -0,0 +1,2 @@
+import "../../_dnt.polyfills.js";
+export { default } from "./grader_output.js";

package/esm/schemas/graders/respond.d.ts

@@ -0,0 +1,12 @@
+import "../../_dnt.polyfills.js";
+import { z } from "zod";
+type RespondEnvelope = {
+    payload?: unknown;
+    status?: number;
+    message?: string;
+    code?: string;
+    meta?: Record<string, unknown>;
+};
+declare const respondSchema: z.ZodType<RespondEnvelope>;
+export default respondSchema;
+//# sourceMappingURL=respond.d.ts.map

package/esm/schemas/graders/respond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.d.ts","sourceRoot":"","sources":["../../../src/schemas/graders/respond.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,KAAK,eAAe,GAAG;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAM5C,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/esm/schemas/graders/respond.js

@@ -0,0 +1,10 @@
+import "../../_dnt.polyfills.js";
+import { z } from "zod";
+const respondSchema = z.object({
+    payload: z.any().optional(),
+    status: z.number().int().optional(),
+    message: z.string().optional(),
+    code: z.string().optional(),
+    meta: z.record(z.any()).optional(),
+});
+export default respondSchema;

package/esm/schemas/graders/respond.zod.d.ts

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

package/esm/schemas/graders/respond.zod.d.ts.map

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

package/esm/schemas/graders/respond.zod.js

@@ -0,0 +1,2 @@
+import "../../_dnt.polyfills.js";
+export { default } from "./respond.js";

package/esm/schemas/scenarios/plain_chat_input_optional.d.ts

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

package/esm/schemas/scenarios/plain_chat_input_optional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain_chat_input_optional.d.ts","sourceRoot":"","sources":["../../../src/schemas/scenarios/plain_chat_input_optional.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,SAAS,CACnD,CAAC;AAEd,eAAe,4BAA4B,CAAC"}

package/esm/schemas/scenarios/plain_chat_input_optional.js

@@ -0,0 +1,5 @@
+import "../../_dnt.polyfills.js";
+import { z } from "zod";
+const plainChatInputOptionalSchema = z.string()
+    .optional();
+export default plainChatInputOptionalSchema;

package/esm/schemas/scenarios/plain_chat_input_optional.zod.d.ts

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

package/esm/schemas/scenarios/plain_chat_input_optional.zod.d.ts.map

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

package/esm/schemas/scenarios/plain_chat_input_optional.zod.js

@@ -0,0 +1,2 @@
+import "../../_dnt.polyfills.js";
+export { default } from "./plain_chat_input_optional.js";

package/esm/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/esm/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/esm/schemas/scenarios/plain_chat_output.js

@@ -0,0 +1,4 @@
+import "../../_dnt.polyfills.js";
+import { z } from "zod";
+const plainChatOutputSchema = z.string();
+export default plainChatOutputSchema;

package/esm/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/esm/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/esm/schemas/scenarios/plain_chat_output.zod.js

@@ -0,0 +1,2 @@
+import "../../_dnt.polyfills.js";
+export { default } from "./plain_chat_output.js";

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

@@ -1,26 +1,70 @@
 import * as path from "../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-esmodule")](import.meta).url);
+const SNIPPETS_BASE_URL = new URL("../snippets/", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url);
 const SCHEMAS_BASE_URL = new URL("../schemas/", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url);
+const DECKS_BASE_URL = new URL("../decks/", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).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));
 }
 export 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);
 }
+export 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);
+}
 export 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);
 }
+export 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/esm/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/esm/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/esm/src/constants.js

@@ -6,11 +6,16 @@ export const DEFAULT_GUARDRAILS = {
 export const RESERVED_TOOL_PREFIX = "gambit_";
 export const TOOL_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
 export const MAX_TOOL_NAME_LENGTH = 64;
+export const GAMBIT_TOOL_CONTEXT = "gambit_context";
+/**
+ * @deprecated Use GAMBIT_TOOL_CONTEXT instead.
+ */
 export const GAMBIT_TOOL_INIT = "gambit_init";
 export const GAMBIT_TOOL_RESPOND = "gambit_respond";
 export const GAMBIT_TOOL_COMPLETE = "gambit_complete";
 export const GAMBIT_TOOL_END = "gambit_end";
 export const BUILTIN_TOOL_NAME_SET = new Set([
+    GAMBIT_TOOL_CONTEXT,
     GAMBIT_TOOL_INIT,
     GAMBIT_TOOL_RESPOND,
     GAMBIT_TOOL_COMPLETE,

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

@@ -1,10 +1,60 @@
+import * as dntShim from "../_dnt.shims.js";
 import * as path from "../deps/jsr.io/@std/path/1.1.4/mod.js";
 import { BUILTIN_TOOL_NAME_SET, MAX_TOOL_NAME_LENGTH, RESERVED_TOOL_PREFIX, TOOL_NAME_PATTERN, } from "./constants.js";
 import { isCardDefinition, isDeckDefinition } from "./definitions.js";
+import { normalizePermissionDeclaration, } from "./permissions.js";
 import { mergeZodObjects } from "./schema.js";
 import { isMarkdownFile, loadMarkdownCard, loadMarkdownDeck, } from "./markdown.js";
-import { resolveBuiltinCardPath } from "./builtins.js";
+import { resolveBuiltinCardPath, resolveBuiltinDeckPath, resolveBuiltinSnippetPath, } from "./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;
@@ -14,7 +64,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: normalizePermissionDeclaration(a.permissions, basePath ? path.dirname(basePath) : dntShim.Deno.cwd()),
     }));
 }
 function normalizeCompanionDecks(decks, basePath) {
@@ -22,9 +75,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: normalizePermissionDeclaration(deck.permissions, basePath ? path.dirname(basePath) : dntShim.Deno.cwd()),
     }));
 }
 function checkReserved(action) {
@@ -37,6 +91,30 @@ function checkReserved(action) {
         throw new Error(`Action name ${action.name} must match ${TOOL_NAME_PATTERN} and be <= ${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(RESERVED_TOOL_PREFIX)) {
+            throw new Error(`External tool name ${name} is reserved (prefix ${RESERVED_TOOL_PREFIX})`);
+        }
+        if (!TOOL_NAME_PATTERN.test(name) ||
+            name.length > MAX_TOOL_NAME_LENGTH) {
+            throw new Error(`External tool name ${name} must match ${TOOL_NAME_PATTERN} and be <= ${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)
@@ -61,6 +139,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,
@@ -70,28 +149,37 @@ async function loadCardInternal(cardPath, parentPath, stack = []) {
         graderDecks,
         path: resolved,
         cards: [],
+        ...fragments,
+        permissions: normalizePermissionDeclaration(card.permissions, path.dirname(resolved)),
     };
 }
 export async function loadCard(cardPath, parentPath, stack = []) {
     const builtinPath = resolveBuiltinCardPath(cardPath);
-    const normalizedPath = builtinPath ?? cardPath;
+    const snippetPath = resolveBuiltinSnippetPath(cardPath);
+    const normalizedPath = snippetPath ?? builtinPath ?? cardPath;
     if (isMarkdownFile(normalizedPath)) {
         return await loadMarkdownCard(normalizedPath, parentPath, stack);
     }
     return await loadCardInternal(normalizedPath, parentPath, stack);
 }
 export async function loadDeck(deckPath, parentPath) {
-    if (isMarkdownFile(deckPath)) {
-        return await loadMarkdownDeck(deckPath, parentPath);
+    const builtinDeck = resolveBuiltinDeckPath(deckPath);
+    const normalizedDeckPath = builtinDeck ?? deckPath;
+    const markdownParent = builtinDeck ? undefined : parentPath;
+    if (isMarkdownFile(normalizedDeckPath)) {
+        return await 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 import(toFileUrl(resolved));
     const deck = mod.default;
     if (!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 = {};
@@ -111,12 +199,26 @@ export 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 = mergeZodObjects(inputSchema, card.inputFragment);
         outputSchema = mergeZodObjects(outputSchema, card.outputFragment);
+        contextSchema = mergeZodObjects(contextSchema, card.contextFragment);
+        responseSchema = mergeZodObjects(responseSchema, card.responseFragment);
     }
+    inputSchema = contextSchema;
+    outputSchema = responseSchema;
     const executor = typeof deck.run === "function"
         ? deck.run
         : typeof deck.execute === "function"
@@ -163,11 +265,15 @@ export 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: normalizePermissionDeclaration(deck.permissions, path.dirname(resolved)),
     };
 }
 function flattenCards(cards) {

package/esm/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"}