@bolt-foundry/gambit-core 0.8.0 → 0.8.3

package/esm/src/state.d.ts

@@ -1,7 +1,9 @@
-import type { OpenResponseItem, OpenResponseMessageItem, TraceEvent } from "./types.js";
+import type { ModelMessage, ResponseItem, TraceEvent } from "./types.js";
 export type SavedState = {
     runId: string;
-    messages: Array<OpenResponseItem>;
+    messages: Array<ModelMessage>;
+    format?: "chat" | "responses";
+    items?: Array<ResponseItem>;
     meta?: Record<string, unknown>;
     messageRefs?: Array<MessageRef>;
     feedback?: Array<FeedbackEntry>;
@@ -11,8 +13,7 @@ export type SavedState = {
 };
 export type MessageRef = {
     id: string;
-    type: OpenResponseItem["type"];
-    role?: OpenResponseMessageItem["role"];
+    role: ModelMessage["role"];
 };
 export type FeedbackEntry = {
     id: string;

package/esm/src/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/src/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,iBAAiB,CAAC,EAAE,aAAa,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAclE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,QAK5D"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/src/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,iBAAiB,CAAC,EAAE,aAAa,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA2CF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAsBlE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,QAK5D"}

package/esm/src/state.js

@@ -1,12 +1,58 @@
 import * as dntShim from "../_dnt.shims.js";
 import * as path from "../deps/jsr.io/@std/path/1.1.4/mod.js";
+function deriveMessagesFromItems(items) {
+    const messages = [];
+    const callNameById = new Map();
+    for (const item of items) {
+        if (item.type === "message") {
+            const text = item.content
+                .map((part) => part.text)
+                .join("");
+            messages.push({
+                role: item.role,
+                content: text || null,
+            });
+            continue;
+        }
+        if (item.type === "function_call") {
+            callNameById.set(item.call_id, item.name);
+            messages.push({
+                role: "assistant",
+                content: null,
+                tool_calls: [{
+                        id: item.call_id,
+                        type: "function",
+                        function: { name: item.name, arguments: item.arguments },
+                    }],
+            });
+            continue;
+        }
+        if (item.type === "function_call_output") {
+            messages.push({
+                role: "tool",
+                name: callNameById.get(item.call_id),
+                tool_call_id: item.call_id,
+                content: item.output,
+            });
+        }
+    }
+    return messages;
+}
 export function loadState(filePath) {
     const resolved = path.resolve(filePath);
     try {
         const text = dntShim.Deno.readTextFileSync(resolved);
         const parsed = JSON.parse(text);
-        if (parsed && typeof parsed === "object" && Array.isArray(parsed.messages)) {
-            return parsed;
+        if (parsed && typeof parsed === "object") {
+            const record = parsed;
+            const hasMessages = Array.isArray(record.messages);
+            const hasItems = Array.isArray(record.items);
+            if (!hasMessages && hasItems) {
+                record.messages = deriveMessagesFromItems(record.items);
+            }
+            if (hasMessages || hasItems) {
+                return record;
+            }
         }
     }
     catch {

package/esm/src/types.d.ts

@@ -12,7 +12,7 @@ export type LogEntry = {
     meta?: unknown;
 };
 export type ModelParams = {
-    model?: string;
+    model?: string | Array<string>;
     temperature?: number;
     top_p?: number;
     frequency_penalty?: number;
@@ -63,7 +63,16 @@ export type HandlersConfig = {
 };
 export type BaseDefinition = {
     label?: Label;
+    startMode?: "assistant" | "user";
+    contextSchema?: ZodTypeAny;
+    responseSchema?: ZodTypeAny;
+    /**
+     * @deprecated Use contextSchema instead.
+     */
     inputSchema?: ZodTypeAny;
+    /**
+     * @deprecated Use responseSchema instead.
+     */
     outputSchema?: ZodTypeAny;
     allowEnd?: boolean;
     /**
@@ -88,7 +97,15 @@ export type DeckDefinition<Input = unknown> = BaseDefinition & {
 export type CardDefinition = BaseDefinition & {
     kind: "gambit.card";
     body?: string;
+    contextFragment?: ZodTypeAny;
+    responseFragment?: ZodTypeAny;
+    /**
+     * @deprecated Use contextFragment instead.
+     */
     inputFragment?: ZodTypeAny;
+    /**
+     * @deprecated Use responseFragment instead.
+     */
     outputFragment?: ZodTypeAny;
     respond?: boolean;
 };
@@ -128,46 +145,9 @@ export type ExecutionContext<Input = unknown> = {
 export interface DeckExecutor<Input = unknown> {
     (ctx: ExecutionContext<Input>): unknown | Promise<unknown>;
 }
-export type OpenResponseItemStatus = "in_progress" | "completed" | "incomplete";
-export type OpenResponseMessageRole = "system" | "user" | "assistant" | "tool" | "developer";
-export type OpenResponseContentPart = {
-    type: "input_text";
-    text: string;
-} | {
-    type: "output_text";
-    text: string;
-    annotations?: Array<unknown>;
-    logprobs?: Array<unknown>;
-} | {
-    type: "text";
-    text: string;
-} | {
-    type: "summary_text";
-    text: string;
-} | {
-    type: "reasoning_text";
-    text: string;
-} | {
-    type: "refusal";
-    refusal: string;
-} | {
-    type: "input_image";
-    image_url: string | null;
-    detail: "low" | "high" | "auto";
-} | {
-    type: "input_file";
-    filename?: string;
-    file_url?: string;
-} | {
-    type: "input_video";
-    video_url: string;
-};
-export type OpenResponseItem = {
-    type: "message";
-    id?: string;
-    status?: OpenResponseItemStatus;
-    role: OpenResponseMessageRole;
-    content: string | Array<OpenResponseContentPart> | null;
+export type ModelMessage = {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | null;
     name?: string;
     tool_call_id?: string;
     tool_calls?: Array<{
@@ -178,280 +158,158 @@ export type OpenResponseItem = {
             arguments: string;
         };
     }>;
+};
+export type ToolDefinition = {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, JSONValue>;
+    };
+};
+export type ResponseTextContent = {
+    type: "input_text";
+    text: string;
 } | {
-    type: "function_call";
+    type: "output_text";
+    text: string;
+};
+export type ResponseMessageItem = {
+    type: "message";
+    role: "system" | "user" | "assistant";
+    content: Array<ResponseTextContent>;
     id?: string;
-    status?: OpenResponseItemStatus;
+};
+export type ResponseFunctionCallItem = {
+    type: "function_call";
     call_id: string;
     name: string;
     arguments: string;
-} | {
-    type: "function_call_output";
     id?: string;
-    status?: OpenResponseItemStatus;
+};
+export type ResponseFunctionCallOutputItem = {
+    type: "function_call_output";
     call_id: string;
     output: string;
-} | {
-    type: "reasoning";
     id?: string;
-    status?: OpenResponseItemStatus;
-    summary: Array<OpenResponseContentPart>;
-    content?: Array<OpenResponseContentPart> | null;
-    encrypted_content?: string;
-} | {
-    type: "item_reference";
-    id: string;
-} | {
-    type: "output_text";
-    text: string;
-};
-export type OpenResponseMessageItem = Extract<OpenResponseItem, {
-    type: "message";
-}>;
-export type OpenResponseUsageDetails = {
-    cached_tokens?: number;
-    reasoning_tokens?: number;
-};
-export type OpenResponseUsage = {
-    input_tokens?: number;
-    output_tokens?: number;
-    total_tokens?: number;
-    input_tokens_details?: OpenResponseUsageDetails;
-    output_tokens_details?: OpenResponseUsageDetails;
-    promptTokens?: number;
-    completionTokens?: number;
-    totalTokens?: number;
-};
-export type OpenResponseFormat = {
-    type: "text";
-} | {
-    type: "json_object";
-} | {
-    type: "json_schema";
-    name: string;
-    description?: string | null;
-    schema: Record<string, JSONValue> | null;
-    strict?: boolean | null;
 };
-export type OpenResponseToolChoice = "none" | "auto" | "required" | {
+export type ResponseItem = ResponseMessageItem | ResponseFunctionCallItem | ResponseFunctionCallOutputItem;
+export type ResponseToolDefinition = {
     type: "function";
-    name?: string;
-};
-export type OpenResponseReasoning = {
-    effort?: "none" | "low" | "medium" | "high" | "xhigh";
-    summary?: "concise" | "detailed" | "auto";
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, JSONValue>;
+    };
 };
-export type OpenResponseStreamOptions = {
-    include_obfuscation?: boolean;
+export type ResponseToolChoice = "auto" | "required" | {
+    type: "function";
+    function: {
+        name: string;
+    };
 };
-export type OpenResponseInput = string | Array<OpenResponseItem> | null;
-export type OpenResponseCreateRequest = {
+export type CreateResponseRequest = {
     model: string;
-    input: OpenResponseInput;
-    tools?: Array<ToolDefinition>;
-    tool_choice?: OpenResponseToolChoice;
+    input: Array<ResponseItem>;
+    instructions?: string;
+    tools?: Array<ResponseToolDefinition>;
+    tool_choice?: ResponseToolChoice;
     stream?: boolean;
-    stream_options?: OpenResponseStreamOptions;
-    instructions?: string | null;
-    previous_response_id?: string | null;
-    truncation?: "auto" | "disabled";
-    reasoning?: OpenResponseReasoning | null;
     max_output_tokens?: number;
-    max_tool_calls?: number;
-    parallel_tool_calls?: boolean;
-    include?: Array<"reasoning.encrypted_content" | "message.output_text.logprobs">;
     metadata?: Record<string, JSONValue>;
-    store?: boolean;
-    background?: boolean;
-    safety_identifier?: string;
-    service_tier?: string;
-    prompt_cache_key?: string;
-    top_logprobs?: number;
-    temperature?: number;
-    top_p?: number;
-    presence_penalty?: number;
-    frequency_penalty?: number;
-    text?: OpenResponseFormat;
-    state?: SavedState;
     params?: Record<string, unknown>;
 };
-export type OpenResponseCreateResponse = {
+export type ResponseUsage = {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+};
+export type CreateResponseResponse = {
     id: string;
-    object?: "response";
-    created_at?: number;
-    completed_at?: number | null;
-    status?: string;
-    incomplete_details?: {
-        reason: string;
-    } | null;
-    error?: {
-        code: string;
-        message: string;
-    } | null;
+    object: "response";
     model?: string;
-    previous_response_id?: string | null;
-    instructions?: string | null;
-    tools?: Array<ToolDefinition>;
-    tool_choice?: OpenResponseToolChoice;
-    truncation?: "auto" | "disabled";
-    parallel_tool_calls?: boolean;
-    text?: OpenResponseFormat;
-    top_p?: number;
-    presence_penalty?: number;
-    frequency_penalty?: number;
-    top_logprobs?: number;
-    temperature?: number;
-    reasoning?: OpenResponseReasoning | null;
-    max_output_tokens?: number;
-    max_tool_calls?: number;
-    store?: boolean;
-    background?: boolean;
-    service_tier?: string;
-    metadata?: Record<string, JSONValue>;
-    safety_identifier?: string;
-    prompt_cache_key?: string;
-    output: Array<OpenResponseItem>;
-    finishReason?: "stop" | "tool_calls" | "length";
-    updatedState?: SavedState;
-    usage?: OpenResponseUsage;
+    created?: number;
+    status?: "completed" | "in_progress" | "failed";
+    output: Array<ResponseItem>;
+    usage?: ResponseUsage;
+    error?: {
+        code?: string;
+        message?: string;
+    };
 };
-export type OpenResponseEvent = {
+export type ResponseEvent = {
+    type: "response.created";
+    response: CreateResponseResponse;
+} | {
     type: "response.output_text.delta";
+    output_index: number;
     delta: string;
     item_id?: string;
-    sequence_number?: number;
-    output_index?: number;
-    content_index?: number;
-    logprobs?: Array<unknown>;
-    obfuscation?: string;
 } | {
     type: "response.output_text.done";
-    text?: string;
-    item_id?: string;
-    sequence_number?: number;
-    output_index?: number;
-    content_index?: number;
-    logprobs?: Array<unknown>;
-} | {
-    type: "response.output_item.added" | "response.output_item.done";
-    item?: OpenResponseItem;
-    output_index?: number;
-    sequence_number?: number;
-} | {
-    type: "response.content_part.added" | "response.content_part.done";
-    part?: OpenResponseContentPart;
-    item_id?: string;
-    output_index?: number;
-    content_index?: number;
-    sequence_number?: number;
-} | {
-    type: "response.function_call_arguments.delta";
-    delta?: string;
-    item_id?: string;
-    output_index?: number;
-    sequence_number?: number;
-    obfuscation?: string;
-} | {
-    type: "response.function_call_arguments.done";
-    arguments?: string;
-    item_id?: string;
-    output_index?: number;
-    sequence_number?: number;
-} | {
-    type: "response.refusal.delta";
-    delta?: string;
-    item_id?: string;
-    output_index?: number;
-    content_index?: number;
-    sequence_number?: number;
-} | {
-    type: "response.refusal.done";
-    refusal?: string;
-    item_id?: string;
-    output_index?: number;
-    content_index?: number;
-    sequence_number?: number;
-} | {
-    type: "response.reasoning.delta";
-    delta?: string;
-    item_id?: string;
-    output_index?: number;
-    content_index?: number;
-    sequence_number?: number;
-    obfuscation?: string;
-} | {
-    type: "response.reasoning.done";
-    text?: string;
-    item_id?: string;
-    output_index?: number;
-    content_index?: number;
-    sequence_number?: number;
-} | {
-    type: "response.reasoning_summary_text.delta";
-    delta?: string;
+    output_index: number;
+    text: string;
     item_id?: string;
-    output_index?: number;
-    summary_index?: number;
-    sequence_number?: number;
-    obfuscation?: string;
 } | {
-    type: "response.reasoning_summary_text.done";
-    text?: string;
-    item_id?: string;
-    output_index?: number;
-    summary_index?: number;
-    sequence_number?: number;
+    type: "response.output_item.added";
+    output_index: number;
+    item: ResponseItem;
 } | {
-    type: "response.reasoning_summary_part.added" | "response.reasoning_summary_part.done";
-    part?: OpenResponseContentPart;
-    item_id?: string;
-    output_index?: number;
-    summary_index?: number;
-    sequence_number?: number;
+    type: "response.output_item.done";
+    output_index: number;
+    item: ResponseItem;
 } | {
-    type: "response.created" | "response.queued" | "response.in_progress" | "response.failed" | "response.incomplete";
-    response?: OpenResponseCreateResponse;
-    sequence_number?: number;
+    type: "response.completed";
+    response: CreateResponseResponse;
 } | {
-    type: "error";
-    error?: {
-        code: string;
-        message: string;
+    type: "response.failed";
+    error: {
+        code?: string;
+        message?: string;
     };
-    sequence_number?: number;
-} | {
-    type: "response.completed";
-    response: OpenResponseCreateResponse;
-    sequence_number?: number;
 };
-export type ModelMessage = {
-    role: OpenResponseMessageRole;
-    content: string | null;
-    name?: string;
-    tool_call_id?: string;
-    tool_calls?: Array<{
-        id: string;
-        type: "function";
-        function: {
+export type ModelProvider = {
+    responses?: (input: {
+        request: CreateResponseRequest;
+        state?: SavedState;
+        onStreamEvent?: (event: ResponseEvent) => void;
+    }) => Promise<CreateResponseResponse>;
+    resolveModel?: (input: {
+        model: string | Array<string>;
+        params?: Record<string, unknown>;
+        deckPath?: string;
+    }) => Promise<{
+        model: string;
+        params?: Record<string, unknown>;
+    }>;
+    chat: (input: {
+        model: string;
+        messages: Array<ModelMessage>;
+        tools?: Array<ToolDefinition>;
+        stream?: boolean;
+        state?: SavedState;
+        onStreamText?: (chunk: string) => void;
+        /**
+         * Provider-specific pass-through parameters (e.g. OpenAI chat completion
+         * fields like temperature/max_tokens).
+         */
+        params?: Record<string, unknown>;
+    }) => Promise<{
+        message: ModelMessage;
+        finishReason: "stop" | "tool_calls" | "length";
+        toolCalls?: Array<{
+            id: string;
             name: string;
-            arguments: string;
+            args: Record<string, JSONValue>;
+        }>;
+        updatedState?: SavedState;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
         };
     }>;
 };
-export type ToolDefinition = {
-    type: "function";
-    function: {
-        name: string;
-        description?: string;
-        parameters?: Record<string, JSONValue> | null;
-        strict?: boolean;
-    };
-};
-export type ModelProvider = {
-    responses: (input: OpenResponseCreateRequest & {
-        onStreamEvent?: (event: OpenResponseEvent) => void;
-    }) => Promise<OpenResponseCreateResponse>;
-};
 type WithDeckRefs<T> = Omit<T, "actions" | "actionDecks" | "testDecks" | "graderDecks">;
 export type LoadedCard = WithDeckRefs<CardDefinition> & {
     path: string;
@@ -480,7 +338,7 @@ export type LoadedDeck = WithDeckRefs<DeckDefinition> & {
 };
 export type ToolCallResult = {
     toolContent: string;
-    extraMessages?: Array<OpenResponseItem>;
+    extraMessages?: Array<ModelMessage>;
 };
 export type TraceEvent = {
     ts?: number;
@@ -495,7 +353,7 @@ export type TraceEvent = {
     runId: string;
     actionCallId: string;
     deckPath: string;
-    message: OpenResponseItem;
+    message: ModelMessage;
     parentActionCallId?: string;
 } | {
     type: "run.end";
@@ -549,9 +407,11 @@ export type TraceEvent = {
     stream?: boolean;
     messageCount?: number;
     toolCount?: number;
-    messages: Array<OpenResponseItem>;
+    messages: Array<ModelMessage>;
     tools?: Array<ToolDefinition>;
     stateMessages?: number;
+    mode?: "chat" | "responses";
+    responseItems?: Array<ResponseItem>;
     parentActionCallId?: string;
 } | {
     type: "model.result";
@@ -560,13 +420,15 @@ export type TraceEvent = {
     deckPath: string;
     model?: string;
     finishReason: "stop" | "tool_calls" | "length";
-    message: OpenResponseItem;
+    message: ModelMessage;
     toolCalls?: Array<{
         id: string;
         name: string;
         args: JSONValue;
     }>;
     stateMessages?: number;
+    mode?: "chat" | "responses";
+    responseItems?: Array<ResponseItem>;
     parentActionCallId?: string;
 } | {
     type: "log";
@@ -587,5 +449,18 @@ export type TraceEvent = {
     parentActionCallId?: string;
     content: JSONValue;
 });
+export declare const openResponsesTypeFixtures: {
+    request: CreateResponseRequest;
+    response: CreateResponseResponse;
+    items: (ResponseMessageItem | ResponseFunctionCallItem | ResponseFunctionCallOutputItem)[];
+    events: ResponseEvent[];
+    tool: ResponseToolDefinition;
+    toolChoice: {
+        type: "function";
+        function: {
+            name: string;
+        };
+    };
+};
 export {};
 //# sourceMappingURL=types.d.ts.map