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

package/esm/src/types.js

@@ -1 +1,102 @@
-export {};
+// Type fixtures to keep Open Responses shapes checked.
+const responseMessageFixture = {
+    type: "message",
+    role: "user",
+    content: [{ type: "input_text", text: "Hello there." }],
+    id: "msg_1",
+};
+const responseFunctionCallFixture = {
+    type: "function_call",
+    call_id: "call_1",
+    name: "lookup",
+    arguments: '{"query":"hello"}',
+    id: "call_1",
+};
+const responseFunctionOutputFixture = {
+    type: "function_call_output",
+    call_id: "call_1",
+    output: '{"result":"ok"}',
+    id: "out_1",
+};
+const responseAssistantFixture = {
+    type: "message",
+    role: "assistant",
+    content: [{ type: "output_text", text: "Hello!" }],
+    id: "msg_2",
+};
+const responseToolFixture = {
+    type: "function",
+    function: {
+        name: "lookup",
+        description: "Lookup helper",
+        parameters: { query: "string" },
+    },
+};
+const responseToolChoiceFixture = {
+    type: "function",
+    function: { name: "lookup" },
+};
+const createResponseRequestFixture = {
+    model: "gpt-4o-mini",
+    input: [
+        responseMessageFixture,
+        responseFunctionCallFixture,
+        responseFunctionOutputFixture,
+        responseAssistantFixture,
+    ],
+    instructions: "Be brief.",
+    tools: [responseToolFixture],
+    tool_choice: responseToolChoiceFixture,
+    stream: true,
+    max_output_tokens: 256,
+    metadata: { source: "fixture" },
+    params: { temperature: 0.2 },
+};
+const createResponseResponseFixture = {
+    id: "resp_1",
+    object: "response",
+    model: "gpt-4o-mini",
+    created: 1_700_000_000,
+    status: "completed",
+    output: [responseAssistantFixture],
+    usage: { promptTokens: 10, completionTokens: 4, totalTokens: 14 },
+};
+const responseEventsFixture = [
+    { type: "response.created", response: createResponseResponseFixture },
+    {
+        type: "response.output_text.delta",
+        output_index: 0,
+        delta: "Hel",
+        item_id: "msg_2",
+    },
+    {
+        type: "response.output_text.done",
+        output_index: 0,
+        text: "Hello!",
+        item_id: "msg_2",
+    },
+    {
+        type: "response.output_item.added",
+        output_index: 0,
+        item: responseAssistantFixture,
+    },
+    {
+        type: "response.output_item.done",
+        output_index: 0,
+        item: responseAssistantFixture,
+    },
+    { type: "response.completed", response: createResponseResponseFixture },
+];
+export const openResponsesTypeFixtures = {
+    request: createResponseRequestFixture,
+    response: createResponseResponseFixture,
+    items: [
+        responseMessageFixture,
+        responseFunctionCallFixture,
+        responseFunctionOutputFixture,
+        responseAssistantFixture,
+    ],
+    events: responseEventsFixture,
+    tool: responseToolFixture,
+    toolChoice: responseToolChoiceFixture,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolt-foundry/gambit-core",
-  "version": "0.8.1",
+  "version": "0.8.5-rc.10",
   "description": "Core runtime for Gambit decks.",
   "homepage": "https://github.com/bolt-foundry/gambit",
   "repository": {
@@ -17,11 +17,82 @@
     ".": {
       "import": "./esm/mod.js",
       "require": "./script/mod.js"
+    },
+    "./schemas/graders/respond.ts": {
+      "import": "./esm/schemas/graders/respond.js",
+      "require": "./script/schemas/graders/respond.js"
+    },
+    "./schemas/graders/respond.zod.ts": {
+      "import": "./esm/schemas/graders/respond.zod.js",
+      "require": "./script/schemas/graders/respond.zod.js"
+    },
+    "./schemas/graders/grader_output.ts": {
+      "import": "./esm/schemas/graders/grader_output.js",
+      "require": "./script/schemas/graders/grader_output.js"
+    },
+    "./schemas/graders/grader_output.zod.ts": {
+      "import": "./esm/schemas/graders/grader_output.zod.js",
+      "require": "./script/schemas/graders/grader_output.zod.js"
+    },
+    "./schemas/graders/contexts/turn.ts": {
+      "import": "./esm/schemas/graders/contexts/turn.js",
+      "require": "./script/schemas/graders/contexts/turn.js"
+    },
+    "./schemas/graders/contexts/turn.zod.ts": {
+      "import": "./esm/schemas/graders/contexts/turn.zod.js",
+      "require": "./script/schemas/graders/contexts/turn.zod.js"
+    },
+    "./schemas/graders/contexts/turn_tools.ts": {
+      "import": "./esm/schemas/graders/contexts/turn_tools.js",
+      "require": "./script/schemas/graders/contexts/turn_tools.js"
+    },
+    "./schemas/graders/contexts/turn_tools.zod.ts": {
+      "import": "./esm/schemas/graders/contexts/turn_tools.zod.js",
+      "require": "./script/schemas/graders/contexts/turn_tools.zod.js"
+    },
+    "./schemas/graders/contexts/conversation.ts": {
+      "import": "./esm/schemas/graders/contexts/conversation.js",
+      "require": "./script/schemas/graders/contexts/conversation.js"
+    },
+    "./schemas/graders/contexts/conversation.zod.ts": {
+      "import": "./esm/schemas/graders/contexts/conversation.zod.js",
+      "require": "./script/schemas/graders/contexts/conversation.zod.js"
+    },
+    "./schemas/graders/contexts/conversation_tools.ts": {
+      "import": "./esm/schemas/graders/contexts/conversation_tools.js",
+      "require": "./script/schemas/graders/contexts/conversation_tools.js"
+    },
+    "./schemas/graders/contexts/conversation_tools.zod.ts": {
+      "import": "./esm/schemas/graders/contexts/conversation_tools.zod.js",
+      "require": "./script/schemas/graders/contexts/conversation_tools.zod.js"
+    },
+    "./schemas/graders/contexts/tools.ts": {
+      "import": "./esm/schemas/graders/contexts/tools.js",
+      "require": "./script/schemas/graders/contexts/tools.js"
+    },
+    "./schemas/graders/contexts/tools.zod.ts": {
+      "import": "./esm/schemas/graders/contexts/tools.zod.js",
+      "require": "./script/schemas/graders/contexts/tools.zod.js"
+    },
+    "./schemas/scenarios/plain_chat_input_optional.ts": {
+      "import": "./esm/schemas/scenarios/plain_chat_input_optional.js",
+      "require": "./script/schemas/scenarios/plain_chat_input_optional.js"
+    },
+    "./schemas/scenarios/plain_chat_input_optional.zod.ts": {
+      "import": "./esm/schemas/scenarios/plain_chat_input_optional.zod.js",
+      "require": "./script/schemas/scenarios/plain_chat_input_optional.zod.js"
+    },
+    "./schemas/scenarios/plain_chat_output.ts": {
+      "import": "./esm/schemas/scenarios/plain_chat_output.js",
+      "require": "./script/schemas/scenarios/plain_chat_output.js"
+    },
+    "./schemas/scenarios/plain_chat_output.zod.ts": {
+      "import": "./esm/schemas/scenarios/plain_chat_output.zod.js",
+      "require": "./script/schemas/scenarios/plain_chat_output.zod.js"
     }
   },
   "scripts": {},
   "dependencies": {
-    "openai": "^4.78.1",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.0",
     "@deno/shim-deno": "~0.18.0"

package/schemas/graders/contexts/conversation.ts

@@ -1,17 +1,40 @@
 import { z } from "zod";
 
-export const graderMessageSchema = z.object({
+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.object({
-  messages: z.array(graderMessageSchema).optional(),
-  meta: z.record(z.any()).optional(),
-  notes: z.object({ text: z.string().optional() }).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(),
+  },
+);
 
-export default z.object({
-  session: graderConversationSchema,
-});
+const graderConversationContextSchema: z.ZodType<GraderConversationContext> = z
+  .object({
+    session: graderConversationSchema,
+  });
+
+export default graderConversationContextSchema;

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

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

package/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/schemas/graders/contexts/conversation_tools.zod.ts

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

package/schemas/graders/contexts/tools.ts

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

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

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

package/schemas/graders/contexts/turn.ts

@@ -4,7 +4,14 @@ import {
   graderMessageSchema,
 } from "./conversation.ts";
 
-export default z.object({
+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/schemas/graders/contexts/turn.zod.ts

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

package/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/schemas/graders/contexts/turn_tools.zod.ts

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

package/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/schemas/graders/grader_output.zod.ts

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

package/schemas/graders/respond.ts

@@ -1,9 +1,19 @@
 import { z } from "zod";
 
-export default z.object({
+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.string().optional(),
+  status: z.number().int().optional(),
   message: z.string().optional(),
-  code: z.any().optional(),
+  code: z.string().optional(),
   meta: z.record(z.any()).optional(),
 });
+
+export default respondSchema;

package/schemas/graders/respond.zod.ts

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

package/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/schemas/scenarios/plain_chat_input_optional.zod.ts

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

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

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

package/script/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/script/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/script/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/script/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/script/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/script/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/script/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 ?? "",
+  };
+}