@bolt-foundry/gambit-core 0.8.5-rc.9 → 0.8.5

package/README.md

@@ -211,8 +211,9 @@ clarifying questions before choosing an action.
 `loadDeck` normalizes relative paths, merges card fragments, enforces unique
 action names, and warns about deprecated fields (`actions`,
 `handlers.onInterval`, `intervalMs`). The Markdown loader also injects helper
-text for built-in tools like `gambit_context`, `gambit_respond`, and
-`gambit_end` when you add `gambit://` markers.
+text for built-in tools like `gambit_context` when you add `gambit://` markers.
+Legacy `gambit_respond` and `gambit_end` markers are migration-only and now
+hard-fail in default runtime paths.
 
 ## Compatibility and utilities
 
@@ -224,9 +225,9 @@ text for built-in tools like `gambit_context`, `gambit_respond`, and
   conforming to the `responses()` signature in `ModelProvider`.
 - **Constants**:
   [`GAMBIT_TOOL_CONTEXT`, `GAMBIT_TOOL_RESPOND`, `GAMBIT_TOOL_END`](src/constants.ts)
-  (`GAMBIT_TOOL_INIT` remains as a deprecated alias). define the reserved tool
-  names the runtime expects when the assistant starts, responds, and explicitly
-  ends runs.
+  (`GAMBIT_TOOL_INIT` remains as a deprecated alias). `GAMBIT_TOOL_RESPOND` and
+  `GAMBIT_TOOL_END` remain for migration detection and legacy trace handling;
+  default runtime paths no longer expose them as callable synthetic tools.
 
 ## Persisted state and traces
 

package/cards/context.card.md

@@ -3,7 +3,7 @@ label = "Gambit context primer"
 +++
 
 You will automatically receive a `gambit_context` tool result at the start of
-the run whenever the caller supplies `--context` (formerly `--init`). This
-payload contains run metadata or seeded inputs. Read it before you respond,
-treat it as trusted context, and keep it on hand throughout the workflow so
-downstream actions have the right data.
+the run whenever the caller supplies `--context`. This payload contains run
+metadata or seeded inputs. Read it before you respond, treat it as trusted
+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/decks/anthropic/agent-sdk/PROMPT.md

@@ -0,0 +1,9 @@
++++
+label = "Anthropic agent SDK bridge"
+contextSchema = "gambit://schemas/scenarios/plain_chat_input_optional.zod.ts"
+responseSchema = "gambit://schemas/scenarios/plain_chat_output.zod.ts"
++++
+
+This stdlib deck provides the default bridge between the Anthropic agent SDK
+runtime and Gambit decks. It is intentionally minimal; downstream runners supply
+the actual runtime behavior.

package/decks/openai/codex-sdk/PROMPT.md

@@ -0,0 +1,9 @@
++++
+label = "Codex SDK bridge"
+contextSchema = "gambit://schemas/scenarios/plain_chat_input_optional.zod.ts"
+responseSchema = "gambit://schemas/scenarios/plain_chat_output.zod.ts"
++++
+
+This stdlib deck provides the default bridge between the Codex SDK runtime and
+Gambit decks. It is intentionally minimal; downstream runners supply the actual
+runtime behavior.

package/decks/openai/codex-sdk/codex_client.ts

@@ -0,0 +1,109 @@
+export type CodexTurnInput = {
+  userText: string;
+  threadId?: string;
+  systemPrompt?: string;
+};
+
+export type CodexTurnOutput = {
+  threadId: string;
+  assistantText: string;
+};
+
+type CodexEvent =
+  | { type: "thread.started"; thread_id?: unknown }
+  | {
+    type: "item.completed";
+    item?: { type?: unknown; text?: unknown };
+  }
+  | { type: string; [key: string]: unknown };
+
+function runCwd(): string {
+  const botRoot = Deno.env.get("GAMBIT_BOT_ROOT");
+  if (typeof botRoot === "string" && botRoot.trim().length > 0) {
+    return botRoot.trim();
+  }
+  return Deno.cwd();
+}
+
+function parseCodexEvents(stdout: string): {
+  threadId?: string;
+  assistantText?: string;
+} {
+  let threadId: string | undefined;
+  let assistantText: string | undefined;
+
+  for (const line of stdout.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("{")) continue;
+    let parsed: CodexEvent | null = null;
+    try {
+      parsed = JSON.parse(trimmed) as CodexEvent;
+    } catch {
+      continue;
+    }
+    if (!parsed || typeof parsed !== "object") continue;
+    if (parsed.type === "thread.started") {
+      if (typeof parsed.thread_id === "string" && parsed.thread_id.trim()) {
+        threadId = parsed.thread_id.trim();
+      }
+      continue;
+    }
+    if (parsed.type === "item.completed") {
+      const item = parsed.item;
+      if (!item || typeof item !== "object") continue;
+      const rec = item as Record<string, unknown>;
+      if (rec.type !== "agent_message") continue;
+      if (typeof rec.text !== "string") continue;
+      const next = rec.text.trim();
+      if (next) assistantText = next;
+    }
+  }
+
+  return { threadId, assistantText };
+}
+
+export async function sendCodexTurn(
+  input: CodexTurnInput,
+): Promise<CodexTurnOutput> {
+  const prompt = input.systemPrompt && input.systemPrompt.trim()
+    ? `${input.systemPrompt.trim()}\n\n${input.userText}`
+    : input.userText;
+
+  const args = input.threadId
+    ? [
+      "exec",
+      "resume",
+      "--skip-git-repo-check",
+      "--json",
+      input.threadId,
+      prompt,
+    ]
+    : ["exec", "--skip-git-repo-check", "--json", prompt];
+
+  const out = await new Deno.Command("codex", {
+    args,
+    cwd: runCwd(),
+    stdout: "piped",
+    stderr: "piped",
+  }).output();
+
+  const stdout = new TextDecoder().decode(out.stdout);
+  const stderr = new TextDecoder().decode(out.stderr);
+  if (!out.success) {
+    throw new Error(
+      `codex exec failed (exit ${out.code}): ${stderr.trim() || stdout.trim()}`,
+    );
+  }
+
+  const parsed = parseCodexEvents(stdout);
+  const threadId = parsed.threadId ?? input.threadId;
+  if (!threadId) {
+    throw new Error(
+      `codex exec succeeded but no thread id found in output: ${stdout.trim()}`,
+    );
+  }
+  return {
+    threadId,
+    assistantText: parsed.assistantText ?? "",
+  };
+}

package/decks/openai/codex-sdk/codex_sdk_bridge.deck.ts

@@ -0,0 +1,36 @@
+import { defineDeck } from "../../../src/definitions.ts";
+import { z } from "zod";
+import { sendCodexTurn } from "./codex_client.ts";
+
+const CODEX_THREAD_META_KEY = "codex.threadId";
+
+export default defineDeck({
+  label: "codex_sdk_bridge",
+  contextSchema: z.string().optional(),
+  responseSchema: z.string(),
+  async run(ctx) {
+    const userText = typeof ctx.initialUserMessage === "string" &&
+        ctx.initialUserMessage.trim()
+      ? ctx.initialUserMessage.trim()
+      : typeof ctx.input === "string" && ctx.input.trim()
+      ? ctx.input.trim()
+      : "";
+
+    if (!userText) return "";
+
+    const priorThreadId = ctx.getSessionMeta<string>(CODEX_THREAD_META_KEY);
+    const systemPrompt = ctx.getSessionMeta<string>("codex.systemPrompt");
+
+    ctx.appendMessage({ role: "user", content: userText });
+
+    const result = await sendCodexTurn({
+      userText,
+      threadId: priorThreadId,
+      systemPrompt,
+    });
+
+    ctx.setSessionMeta(CODEX_THREAD_META_KEY, result.threadId);
+    ctx.appendMessage({ role: "assistant", content: result.assistantText });
+    return result.assistantText;
+  },
+});

package/esm/cards/context.card.md

@@ -0,0 +1,9 @@
++++
+label = "Gambit context primer"
++++
+
+You will automatically receive a `gambit_context` tool result at the start of
+the run whenever the caller supplies `--context`. This payload contains run
+metadata or seeded inputs. Read it before you respond, treat it as trusted
+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/cards/end.card.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/cards/generate-test-input.card.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/cards/respond.card.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/decks/anthropic/agent-sdk/PROMPT.md

@@ -0,0 +1,9 @@
++++
+label = "Anthropic agent SDK bridge"
+contextSchema = "gambit://schemas/scenarios/plain_chat_input_optional.zod.ts"
+responseSchema = "gambit://schemas/scenarios/plain_chat_output.zod.ts"
++++
+
+This stdlib deck provides the default bridge between the Anthropic agent SDK
+runtime and Gambit decks. It is intentionally minimal; downstream runners supply
+the actual runtime behavior.

package/esm/decks/openai/codex-sdk/PROMPT.md

@@ -0,0 +1,9 @@
++++
+label = "Codex SDK bridge"
+contextSchema = "gambit://schemas/scenarios/plain_chat_input_optional.zod.ts"
+responseSchema = "gambit://schemas/scenarios/plain_chat_output.zod.ts"
++++
+
+This stdlib deck provides the default bridge between the Codex SDK runtime and
+Gambit decks. It is intentionally minimal; downstream runners supply the actual
+runtime behavior.

package/esm/decks/openai/codex-sdk/codex_client.ts

@@ -0,0 +1,109 @@
+export type CodexTurnInput = {
+  userText: string;
+  threadId?: string;
+  systemPrompt?: string;
+};
+
+export type CodexTurnOutput = {
+  threadId: string;
+  assistantText: string;
+};
+
+type CodexEvent =
+  | { type: "thread.started"; thread_id?: unknown }
+  | {
+    type: "item.completed";
+    item?: { type?: unknown; text?: unknown };
+  }
+  | { type: string; [key: string]: unknown };
+
+function runCwd(): string {
+  const botRoot = Deno.env.get("GAMBIT_BOT_ROOT");
+  if (typeof botRoot === "string" && botRoot.trim().length > 0) {
+    return botRoot.trim();
+  }
+  return Deno.cwd();
+}
+
+function parseCodexEvents(stdout: string): {
+  threadId?: string;
+  assistantText?: string;
+} {
+  let threadId: string | undefined;
+  let assistantText: string | undefined;
+
+  for (const line of stdout.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("{")) continue;
+    let parsed: CodexEvent | null = null;
+    try {
+      parsed = JSON.parse(trimmed) as CodexEvent;
+    } catch {
+      continue;
+    }
+    if (!parsed || typeof parsed !== "object") continue;
+    if (parsed.type === "thread.started") {
+      if (typeof parsed.thread_id === "string" && parsed.thread_id.trim()) {
+        threadId = parsed.thread_id.trim();
+      }
+      continue;
+    }
+    if (parsed.type === "item.completed") {
+      const item = parsed.item;
+      if (!item || typeof item !== "object") continue;
+      const rec = item as Record<string, unknown>;
+      if (rec.type !== "agent_message") continue;
+      if (typeof rec.text !== "string") continue;
+      const next = rec.text.trim();
+      if (next) assistantText = next;
+    }
+  }
+
+  return { threadId, assistantText };
+}
+
+export async function sendCodexTurn(
+  input: CodexTurnInput,
+): Promise<CodexTurnOutput> {
+  const prompt = input.systemPrompt && input.systemPrompt.trim()
+    ? `${input.systemPrompt.trim()}\n\n${input.userText}`
+    : input.userText;
+
+  const args = input.threadId
+    ? [
+      "exec",
+      "resume",
+      "--skip-git-repo-check",
+      "--json",
+      input.threadId,
+      prompt,
+    ]
+    : ["exec", "--skip-git-repo-check", "--json", prompt];
+
+  const out = await new Deno.Command("codex", {
+    args,
+    cwd: runCwd(),
+    stdout: "piped",
+    stderr: "piped",
+  }).output();
+
+  const stdout = new TextDecoder().decode(out.stdout);
+  const stderr = new TextDecoder().decode(out.stderr);
+  if (!out.success) {
+    throw new Error(
+      `codex exec failed (exit ${out.code}): ${stderr.trim() || stdout.trim()}`,
+    );
+  }
+
+  const parsed = parseCodexEvents(stdout);
+  const threadId = parsed.threadId ?? input.threadId;
+  if (!threadId) {
+    throw new Error(
+      `codex exec succeeded but no thread id found in output: ${stdout.trim()}`,
+    );
+  }
+  return {
+    threadId,
+    assistantText: parsed.assistantText ?? "",
+  };
+}

package/esm/decks/openai/codex-sdk/codex_sdk_bridge.deck.ts

@@ -0,0 +1,36 @@
+import { defineDeck } from "../../../src/definitions.ts";
+import { z } from "zod";
+import { sendCodexTurn } from "./codex_client.ts";
+
+const CODEX_THREAD_META_KEY = "codex.threadId";
+
+export default defineDeck({
+  label: "codex_sdk_bridge",
+  contextSchema: z.string().optional(),
+  responseSchema: z.string(),
+  async run(ctx) {
+    const userText = typeof ctx.initialUserMessage === "string" &&
+        ctx.initialUserMessage.trim()
+      ? ctx.initialUserMessage.trim()
+      : typeof ctx.input === "string" && ctx.input.trim()
+      ? ctx.input.trim()
+      : "";
+
+    if (!userText) return "";
+
+    const priorThreadId = ctx.getSessionMeta<string>(CODEX_THREAD_META_KEY);
+    const systemPrompt = ctx.getSessionMeta<string>("codex.systemPrompt");
+
+    ctx.appendMessage({ role: "user", content: userText });
+
+    const result = await sendCodexTurn({
+      userText,
+      threadId: priorThreadId,
+      systemPrompt,
+    });
+
+    ctx.setSessionMeta(CODEX_THREAD_META_KEY, result.threadId);
+    ctx.appendMessage({ role: "assistant", content: result.assistantText });
+    return result.assistantText;
+  },
+});

package/esm/mod.d.ts

@@ -27,7 +27,7 @@ export type { HandlersConfig } from "./src/types.js";
 /** JSON-serializable value type used throughout Gambit. */
 export type { JSONValue } from "./src/types.js";
 /** Open Responses content payload types. */
-export type { CreateResponseRequest, CreateResponseResponse, ResponseEvent, ResponseFunctionCallItem, ResponseFunctionCallOutputItem, ResponseItem, ResponseMessageItem, ResponseTextContent, ResponseToolChoice, ResponseToolDefinition, ResponseUsage, } from "./src/types.js";
+export type { CreateResponseRequest, CreateResponseResponse, ResponseEvent, ResponseExtensionItem, ResponseFunctionCallItem, ResponseFunctionCallOutputItem, ResponseItem, ResponseItemExtensionDefinition, ResponseMessageItem, ResponseTextContent, ResponseToolChoice, ResponseToolDefinition, ResponseUsage, } from "./src/types.js";
 /** Test deck definition shape. */
 export type { TestDeckDefinition } from "./src/types.js";
 /** Permission declaration shape used by deck metadata and config layers. */

package/esm/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"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"}

package/esm/schemas/graders/contexts/conversation.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+
+type GraderMessage = {
+  role: string;
+  content?: unknown;
+  name?: string;
+};
+
+type GraderConversation = {
+  messages?: Array<GraderMessage>;
+  meta?: Record<string, unknown>;
+  notes?: {
+    text?: string;
+  };
+};
+
+type GraderConversationContext = {
+  session: GraderConversation;
+};
+
+export const graderMessageSchema: z.ZodType<GraderMessage> = z.object({
+  role: z.string(),
+  content: z.any().optional(),
+  name: z.string().optional(),
+});
+
+export const graderConversationSchema: z.ZodType<GraderConversation> = z.object(
+  {
+    messages: z.array(graderMessageSchema).optional(),
+    meta: z.record(z.any()).optional(),
+    notes: z.object({ text: z.string().optional() }).optional(),
+  },
+);
+
+const graderConversationContextSchema: z.ZodType<GraderConversationContext> = z
+  .object({
+    session: graderConversationSchema,
+  });
+
+export default graderConversationContextSchema;

package/esm/schemas/graders/contexts/conversation.zod.ts

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

package/esm/schemas/graders/contexts/conversation_tools.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+
+type GraderToolCall = {
+  id?: string;
+  type?: string;
+  function: {
+    name: string;
+    arguments?: string;
+  };
+};
+
+type GraderConversationMessageWithTools = {
+  role: string;
+  content?: unknown;
+  name?: string;
+  tool_calls?: Array<GraderToolCall>;
+};
+
+type GraderConversationWithTools = {
+  messages?: Array<GraderConversationMessageWithTools>;
+  meta?: Record<string, unknown>;
+  notes?: {
+    text?: string;
+  };
+};
+
+type GraderConversationToolsContext = {
+  session: GraderConversationWithTools;
+};
+
+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 graderConversationMessageWithToolsSchema: z.ZodType<
+  GraderConversationMessageWithTools
+> = 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(graderConversationMessageWithToolsSchema).optional(),
+  meta: z.record(z.any()).optional(),
+  notes: z.object({ text: z.string().optional() }).optional(),
+});
+
+const graderConversationToolsContextSchema: z.ZodType<
+  GraderConversationToolsContext
+> = z.object({
+  session: graderConversationWithToolsSchema,
+});
+
+export default graderConversationToolsContextSchema;

package/esm/schemas/graders/contexts/conversation_tools.zod.ts

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

package/esm/schemas/graders/contexts/tools.ts

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

package/esm/schemas/graders/contexts/tools.zod.ts

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

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

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import {
+  graderConversationSchema,
+  graderMessageSchema,
+} from "./conversation.ts";
+
+type GraderTurnContext = {
+  session: z.infer<typeof graderConversationSchema>;
+  messageToGrade: z.infer<typeof graderMessageSchema>;
+};
+
+const graderTurnContextSchema: z.ZodType<GraderTurnContext> = z.object({
+  session: graderConversationSchema,
+  messageToGrade: graderMessageSchema,
+});
+
+export default graderTurnContextSchema;

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

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

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

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

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;