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

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.ts

@@ -0,0 +1,63 @@
+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;
+};
+
+const graderToolCallSchema: z.ZodType<GraderToolCall> = z.object({
+  id: z.string().optional(),
+  type: z.string().optional(),
+  function: z.object({
+    name: z.string(),
+    arguments: z.string().optional(),
+  }),
+});
+
+export const graderMessageWithToolsSchema: z.ZodType<GraderMessageWithTools> = z
+  .object({
+    role: z.string(),
+    content: z.any().optional(),
+    name: z.string().optional(),
+    tool_calls: z.array(graderToolCallSchema).optional(),
+  });
+
+export const graderConversationWithToolsSchema: z.ZodType<
+  GraderConversationWithTools
+> = z.object({
+  messages: z.array(graderMessageWithToolsSchema).optional(),
+  meta: z.record(z.any()).optional(),
+  notes: z.object({ text: z.string().optional() }).optional(),
+});
+
+const graderTurnToolsContextSchema: z.ZodType<GraderTurnToolsContext> = 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/contexts/turn_tools.zod.ts

@@ -0,0 +1 @@
+export { default } from "./turn_tools.ts";

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.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+
+type GraderOutput = {
+  score: number;
+  reason: string;
+  evidence?: Array<string>;
+};
+
+const graderOutputSchema: z.ZodType<GraderOutput> = 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/grader_output.zod.ts

@@ -0,0 +1 @@
+export { default } from "./grader_output.ts";

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.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+
+type RespondEnvelope = {
+  payload?: unknown;
+  status?: number;
+  message?: string;
+  code?: string;
+  meta?: Record<string, unknown>;
+};
+
+const respondSchema: z.ZodType<RespondEnvelope> = 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/graders/respond.zod.ts

@@ -0,0 +1 @@
+export { default } from "./respond.ts";

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.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+
+const plainChatInputOptionalSchema: z.ZodType<string | undefined> = 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_input_optional.zod.ts

@@ -0,0 +1 @@
+export { default } from "./plain_chat_input_optional.ts";

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.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+
+const plainChatOutputSchema: z.ZodType<string> = 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/schemas/scenarios/plain_chat_output.zod.ts

@@ -0,0 +1 @@
+export { default } from "./plain_chat_output.ts";

package/esm/snippets/context.md

@@ -0,0 +1,8 @@
++++
+label = "Gambit context primer"
++++
+
+The first turn you see should be a `gambit_context` tool. This payload contains
+run metadata or seeded inputs. Read it before you respond, treat it as important
+context, and keep it on hand throughout the workflow so downstream actions have
+the right data. Do not call `gambit_context` yourself; runtime injects it once.

package/esm/snippets/end.md

@@ -0,0 +1,10 @@
++++
+label = "Explicitly end the run"
+allowEnd = true
++++
+
+If the entire conversation/workflow is complete and you must stop all further
+turns, call the `gambit_end` tool with an optional `message`, `payload`,
+`status`, `code`, or `meta`. Only use this when you want Gambit to halt entirely
+(no more user messages). Otherwise continue with normal responses or
+`gambit_respond`.

package/esm/snippets/generate-test-input.md

@@ -0,0 +1,12 @@
++++
+label = "Generate test input"
++++
+
+When you receive a user message with:
+
+{ "type": "gambit_test_bot_init_fill", "missing": ["path.to.field", "..."],
+"current": { ... }, "schemaHints": [ ... ] }
+
+Return ONLY valid JSON that supplies values for the missing fields. Do not
+include any fields that are not listed in "missing". If the only missing path is
+"(root)", return the full init JSON value.

package/esm/snippets/init.md

@@ -0,0 +1,12 @@
++++
+label = "Fill missing init fields"
++++
+
+When you receive a user message with:
+
+{ "type": "gambit_test_bot_init_fill", "missing": ["path.to.field", "..."],
+"current": { ... }, "schemaHints": [ ... ] }
+
+Return ONLY valid JSON that supplies values for the missing fields. Do not
+include any fields that are not listed in "missing". If the only missing path is
+"(root)", return the full init JSON value.

package/esm/snippets/respond.md

@@ -0,0 +1,10 @@
++++
+label = "Call gambit_respond"
+respond = true
++++
+
+When you finish this workflow, do **not** emit a normal assistant reply.
+Instead, call the `gambit_respond` tool exactly once with a JSON envelope that
+includes your validated `payload` plus optional `status`, `message`, `code`, or
+`meta` fields. This keeps outputs structured and lets Gambit capture the result
+even when guardrails stop the run early.

package/esm/snippets/scenario-participant.md

@@ -0,0 +1,10 @@
++++
+label = "Scenario participant"
++++
+
+You are the synthetic scenario participant in this run.
+
+- Stay in the user/participant role for every turn.
+- Do not speak as the assistant.
+- Do not narrate assistant reasoning, tools, or internal state.
+- When the scenario is complete, return exactly one empty message.

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,9 +6,12 @@ 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";
 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;

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,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAGpD,CAAC;AAGH,eAAO,MAAM,uBAAuB,MAAM,CAAC"}

package/esm/src/constants.js

@@ -6,15 +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,
-    GAMBIT_TOOL_END,
 ]);
 // Default delay for busy/idle handler triggers.
 export const DEFAULT_STATUS_DELAY_MS = 800;

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,EAGX,MAAM,YAAY,CAAC;AA8WpB,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,CAiKrB"}