modelrig 0.11.0 → 0.12.0

package/dist/adapters/history-mapping.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Messages lane — provider-neutral history → each provider family's native
+ * conversation shape (ARC-β, builder-prompt-02 §1.2). The single place every
+ * dialect is translated, so each adapter's diff is one branch:
+ * `req.history !== undefined ? <family mapper> : <today's literal>`.
+ *
+ * SEMANTICS (identical for every family, `AdapterRequest.history`):
+ *   provider messages = [system(systemPrompt)] + map(history)
+ *                       + (userPrompt !== "" ? [user(userPrompt)] : [])
+ * The system prompt keeps its family-native slot (OpenAI `system` message,
+ * Anthropic top-level `system`, Gemini `systemInstruction`, Responses `system`
+ * input item) exactly as the single-turn path delivers it.
+ *
+ * Pure functions, no I/O. History is assumed VALID (run/messages.ts validates
+ * at every SDK entry): tool results answer a prior call, arguments are JSON.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userSideMentions = userSideMentions;
+exports.toOpenAIChatMessages = toOpenAIChatMessages;
+exports.toResponsesInput = toResponsesInput;
+exports.toAnthropicMessages = toAnthropicMessages;
+exports.toGeminiContents = toGeminiContents;
+const messages_1 = require("../run/messages");
+// ── shared ───────────────────────────────────────────────────────────────────
+/** True when `word` appears in the user side of a request — the single-turn
+ * `userPrompt`, or (messages lane) any history text. The DeepSeek / compat
+ * JSON-guard keys on this so a one-turn history is guarded exactly like the
+ * legacy `userPrompt` it replaces. */
+function userSideMentions(req, word) {
+    if (req.userPrompt.includes(word))
+        return true;
+    if (req.history === undefined)
+        return false;
+    return req.history.some((m) => (m.role === "tool" ? m.content : (0, messages_1.contentText)(m.content)).includes(word));
+}
+/** Parse a tool call's JSON-string arguments into the object Anthropic `input`
+ * / Gemini `args` require. Validation guarantees JSON; a non-object value is
+ * wrapped so the provider still receives an object (never dropped). */
+function parseArgs(args) {
+    try {
+        const v = JSON.parse(args);
+        return typeof v === "object" && v !== null && !Array.isArray(v) ? v : { value: v };
+    }
+    catch {
+        return { value: args };
+    }
+}
+function chatContent(c, opts) {
+    if (typeof c === "string" || opts.flattenParts)
+        return (0, messages_1.contentText)(c);
+    return c.map((p) => ({ type: "text", text: p.text }));
+}
+/** History → OpenAI Chat Completions `messages` (tool_calls / role:"tool"). */
+function toOpenAIChatMessages(systemPrompt, history, userPrompt, opts) {
+    const out = systemPrompt !== "" ? [{ role: "system", content: systemPrompt }] : [];
+    for (const m of history) {
+        if (m.role === "user") {
+            out.push({ role: "user", content: chatContent(m.content, opts) });
+        }
+        else if (m.role === "tool") {
+            out.push({ role: "tool", tool_call_id: m.toolCallId, content: m.content });
+        }
+        else {
+            const calls = m.toolCalls ?? [];
+            const text = (0, messages_1.contentText)(m.content);
+            out.push({
+                role: "assistant",
+                // OpenAI: an assistant turn that only called tools carries `content: null`.
+                content: calls.length > 0 && text === "" ? null : chatContent(m.content, opts),
+                ...(calls.length > 0
+                    ? {
+                        tool_calls: calls.map((c) => ({
+                            id: c.id,
+                            type: "function",
+                            function: { name: c.function.name, arguments: c.function.arguments },
+                        })),
+                    }
+                    : {}),
+            });
+        }
+    }
+    if (userPrompt !== "")
+        out.push({ role: "user", content: userPrompt });
+    return out;
+}
+/** History → Responses API `input` (messages + function_call /
+ * function_call_output items). */
+function toResponsesInput(systemPrompt, history, userPrompt) {
+    const out = systemPrompt !== "" ? [{ role: "system", content: systemPrompt }] : [];
+    for (const m of history) {
+        if (m.role === "user") {
+            out.push(typeof m.content === "string"
+                ? { role: "user", content: m.content }
+                : { role: "user", content: m.content.map((p) => ({ type: "input_text", text: p.text })) });
+        }
+        else if (m.role === "tool") {
+            out.push({ type: "function_call_output", call_id: m.toolCallId, output: m.content });
+        }
+        else {
+            const text = (0, messages_1.contentText)(m.content);
+            if (text !== "" || (m.toolCalls ?? []).length === 0)
+                out.push({ role: "assistant", content: text });
+            for (const c of m.toolCalls ?? []) {
+                out.push({ type: "function_call", call_id: c.id, name: c.function.name, arguments: c.function.arguments });
+            }
+        }
+    }
+    if (userPrompt !== "")
+        out.push({ role: "user", content: userPrompt });
+    return out;
+}
+const toBlocks = (c) => typeof c === "string" ? [{ type: "text", text: c }] : c;
+/** Push, merging into the previous message when the role repeats (Anthropic
+ * alternates user/assistant; tool results ride in a user turn, so tool results
+ * and a following user message share one user message). */
+function pushAnthropic(out, msg) {
+    const prev = out[out.length - 1];
+    if (prev !== undefined && prev.role === msg.role) {
+        out[out.length - 1] = { role: msg.role, content: [...toBlocks(prev.content), ...toBlocks(msg.content)] };
+        return;
+    }
+    out.push(msg);
+}
+/** History → Anthropic Messages `messages` (the system prompt stays the
+ * top-level `system`, built by the adapter exactly as today). */
+function toAnthropicMessages(history, userPrompt) {
+    const out = [];
+    for (const m of history) {
+        if (m.role === "user") {
+            pushAnthropic(out, {
+                role: "user",
+                content: typeof m.content === "string" ? m.content : m.content.map((p) => ({ type: "text", text: p.text })),
+            });
+        }
+        else if (m.role === "tool") {
+            pushAnthropic(out, { role: "user", content: [{ type: "tool_result", tool_use_id: m.toolCallId, content: m.content }] });
+        }
+        else {
+            const calls = m.toolCalls ?? [];
+            if (calls.length === 0) {
+                pushAnthropic(out, {
+                    role: "assistant",
+                    content: typeof m.content === "string" ? m.content : m.content.map((p) => ({ type: "text", text: p.text })),
+                });
+                continue;
+            }
+            const text = (0, messages_1.contentText)(m.content);
+            pushAnthropic(out, {
+                role: "assistant",
+                content: [
+                    ...(text !== "" ? [{ type: "text", text }] : []),
+                    ...calls.map((c) => ({ type: "tool_use", id: c.id, name: c.function.name, input: parseArgs(c.function.arguments) })),
+                ],
+            });
+        }
+    }
+    if (userPrompt !== "")
+        pushAnthropic(out, { role: "user", content: userPrompt });
+    return out;
+}
+function pushGemini(out, c) {
+    const prev = out[out.length - 1];
+    if (prev !== undefined && prev.role === c.role) {
+        out[out.length - 1] = { role: c.role, parts: [...prev.parts, ...c.parts] };
+        return;
+    }
+    out.push(c);
+}
+const textParts = (c) => typeof c === "string" ? [{ text: c }] : c.map((p) => ({ text: p.text }));
+/** A tool result → Gemini `functionResponse.response` (must be an object): a
+ * JSON-object result passes through; anything else rides as `{ result }`. */
+function functionResponseBody(content) {
+    try {
+        const v = JSON.parse(content);
+        if (typeof v === "object" && v !== null && !Array.isArray(v))
+            return v;
+    }
+    catch {
+        // not JSON — fall through to the text wrapper
+    }
+    return { result: content };
+}
+/**
+ * History → Gemini `contents`. `cachedPrefix` (non-empty) is the system prompt
+ * when a `cachedContent` handle forbids `systemInstruction` (issue #5 R1): it is
+ * delivered in the user turn exactly like the single-turn `cachedUserTurn` —
+ * folded into the first user message's first text part as `prefix\n\ntext`.
+ */
+function toGeminiContents(history, userPrompt, cachedPrefix = "") {
+    const out = [];
+    // Gemini function calls carry no id — a tool result is matched to the NAME of
+    // the call it answers (validation guarantees the call precedes it).
+    const nameById = new Map();
+    for (const m of history) {
+        if (m.role === "user") {
+            pushGemini(out, { role: "user", parts: textParts(m.content) });
+        }
+        else if (m.role === "tool") {
+            pushGemini(out, {
+                role: "user",
+                parts: [{ functionResponse: { name: nameById.get(m.toolCallId) ?? m.toolCallId, response: functionResponseBody(m.content) } }],
+            });
+        }
+        else {
+            const calls = m.toolCalls ?? [];
+            for (const c of calls)
+                nameById.set(c.id, c.function.name);
+            const text = (0, messages_1.contentText)(m.content);
+            pushGemini(out, {
+                role: "model",
+                parts: [
+                    ...(text !== "" || calls.length === 0 ? textParts(m.content) : []),
+                    ...calls.map((c) => ({ functionCall: { name: c.function.name, args: parseArgs(c.function.arguments) } })),
+                ],
+            });
+        }
+    }
+    if (userPrompt !== "")
+        pushGemini(out, { role: "user", parts: [{ text: userPrompt }] });
+    if (cachedPrefix === "")
+        return out;
+    const first = out[0];
+    const firstPart = first?.parts[0];
+    if (first !== undefined && first.role === "user" && firstPart !== undefined && "text" in firstPart) {
+        out[0] = { role: "user", parts: [{ text: `${cachedPrefix}\n\n${firstPart.text}` }, ...first.parts.slice(1)] };
+        return out;
+    }
+    return [{ role: "user", parts: [{ text: cachedPrefix }] }, ...out];
+}

package/dist/adapters/openai-compat.d.ts

@@ -20,6 +20,7 @@
 import type { CapabilityFlag, ProviderAdapter, ProviderId } from "../types/provider";
 import type { ClassifiedFailure, ShapingInput } from "./gemini";
 import type { OpenAIWireTool, OpenAIWireToolChoice } from "./tool-mapping";
+import type { OpenAIChatWireMessage } from "./history-mapping";
 /** Fireworks serves models at accounts/fireworks/models/<short> — routes
  * declare the short name; the wire gets the full path (LiteLLM
  * fireworks_ai transformation, harvested). */
@@ -40,10 +41,7 @@ export interface OpenAICompatHost {
  * fail-closed (raw-support.ts) until B4b wires native GLM `web_search`. */
 export declare const OPENAI_COMPAT_HOSTS: Readonly<Record<"deepinfra" | "fireworks" | "zai", OpenAICompatHost>>;
 export declare function classifyCompatFailure(message: string, host: string): ClassifiedFailure;
-interface ChatMessage {
-    readonly role: "system" | "user";
-    readonly content: string;
-}
+type ChatMessage = OpenAIChatWireMessage;
 export interface OpenAICompatShapedParams {
     readonly model: string;
     readonly max_tokens: number;

package/dist/adapters/openai-compat.d.ts.map

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

package/dist/adapters/openai-compat.js

@@ -32,6 +32,7 @@ const tool_mapping_1 = require("./tool-mapping");
 const openai_stream_1 = require("./openai-stream");
 const attempt_meta_map_1 = require("./attempt-meta-map");
 const sampling_1 = require("./sampling");
+const history_mapping_1 = require("./history-mapping");
 const DEFAULT_MAX_TOKENS = 32000;
 /** Fireworks serves models at accounts/fireworks/models/<short> — routes
  * declare the short name; the wire gets the full path (LiteLLM
@@ -96,13 +97,16 @@ function buildOpenAICompatParams(model, req, profileFlags) {
     const wantJson = req.outputSchema !== null;
     const strict = wantJson && profileFlags.has("structured_native");
     let systemPrompt = req.systemPrompt;
-    if (wantJson && !strict && !req.systemPrompt.includes("JSON") && !req.userPrompt.includes("JSON")) {
+    if (wantJson && !strict && !req.systemPrompt.includes("JSON") && !(0, history_mapping_1.userSideMentions)(req, "JSON")) {
         systemPrompt = systemPrompt === "" ? JSON_GUARD : `${systemPrompt}\n\n${JSON_GUARD}`;
     }
-    const messages = [
-        ...(systemPrompt !== "" ? [{ role: "system", content: systemPrompt }] : []),
-        { role: "user", content: req.userPrompt },
-    ];
+    // ARC-β: history present ⇒ mapped conversation; absent ⇒ today's literal (byte-identical).
+    const messages = req.history !== undefined
+        ? (0, history_mapping_1.toOpenAIChatMessages)(systemPrompt, req.history, req.userPrompt, { flattenParts: true })
+        : [
+            ...(systemPrompt !== "" ? [{ role: "system", content: systemPrompt }] : []),
+            { role: "user", content: req.userPrompt },
+        ];
     return {
         model,
         max_tokens: (0, sampling_1.effectiveMaxOutputTokens)(req, DEFAULT_MAX_TOKENS),

package/dist/adapters/openai.d.ts

@@ -15,16 +15,14 @@ import type { CapabilityFlag, ProviderAdapter, ServiceTier } from "../types/prov
 import type { ClassifiedFailure, ShapingInput } from "./gemini";
 import type { OpenAIWireTool, OpenAIWireToolChoice } from "./tool-mapping";
 import type { ServedTierSource } from "../telemetry/attempt-meta";
+import type { OpenAIChatWireMessage } from "./history-mapping";
 export interface OpenAIAdapterConfig {
     readonly apiKey: string;
 }
 export declare function isModelFlexEligible(modelName: string): boolean;
 export declare function openaiSupports(feature: CapabilityFlag, model: string): boolean;
 export declare function classifyOpenAIFailure(message: string): ClassifiedFailure;
-interface ChatMessage {
-    readonly role: "system" | "user";
-    readonly content: string;
-}
+type ChatMessage = OpenAIChatWireMessage;
 export interface OpenAIShapedParams {
     readonly model: string;
     readonly max_completion_tokens: number;

package/dist/adapters/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAIV,cAAc,EACd,eAAe,EACf,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAMhE,OAAO,KAAK,EAAuB,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAIhG,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAKjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAMD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAI9D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAe9E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA0CxE;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;KAAE,CAAC;IAC1D,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC;IACxC;;;oEAGgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClE,QAAQ,CAAC,eAAe,CAAC,EACrB;QAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,GAChC;QACE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAC7B,QAAQ,CAAC,WAAW,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;SAAE,CAAC;KACjG,CAAC;IACN,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,kBAAkB,CAuDtF;AAOD;;;iEAGiE;AACjE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,SAAS,EAAE,WAAW,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAKnE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,eAAe,CAuQhF"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAIV,cAAc,EACd,eAAe,EACf,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAMhE,OAAO,KAAK,EAAuB,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAIhG,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAKjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAMD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAI9D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAe9E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA0CxE;AAED,KAAK,WAAW,GAAG,qBAAqB,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;KAAE,CAAC;IAC1D,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC;IACxC;;;oEAGgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClE,QAAQ,CAAC,eAAe,CAAC,EACrB;QAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,GAChC;QACE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAC7B,QAAQ,CAAC,WAAW,EAAE;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;SAAE,CAAC;KACjG,CAAC;IACN,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,kBAAkB,CA0DtF;AAOD;;;iEAGiE;AACjE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,SAAS,EAAE,WAAW,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAKnE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,eAAe,CAuQhF"}

package/dist/adapters/openai.js

@@ -28,6 +28,7 @@ const openai_stream_1 = require("./openai-stream");
 const attempt_meta_map_1 = require("./attempt-meta-map");
 const sampling_1 = require("./sampling");
 const responses_api_1 = require("./responses-api");
+const history_mapping_1 = require("./history-mapping");
 /** OpenAI's documented flex-eligible allowlist as of 2026-05 (ported).
  * Mini and nano variants are silently downgraded to default tier. */
 const FLEX_ELIGIBLE_PREFIXES = ["gpt-5.4", "gpt-5.2", "gpt-5.1", "gpt-5", "gpt-4.1"];
@@ -101,10 +102,13 @@ function classifyOpenAIFailure(message) {
 }
 const DEFAULT_MAX_COMPLETION_TOKENS = 32000;
 function buildOpenAIParams(model, req) {
-    const messages = [
-        ...(req.systemPrompt !== "" ? [{ role: "system", content: req.systemPrompt }] : []),
-        { role: "user", content: req.userPrompt },
-    ];
+    // ARC-β: history present ⇒ mapped conversation; absent ⇒ today's literal (byte-identical).
+    const messages = req.history !== undefined
+        ? (0, history_mapping_1.toOpenAIChatMessages)(req.systemPrompt, req.history, req.userPrompt, { flattenParts: false })
+        : [
+            ...(req.systemPrompt !== "" ? [{ role: "system", content: req.systemPrompt }] : []),
+            { role: "user", content: req.userPrompt },
+        ];
     return {
         model,
         max_completion_tokens: (0, sampling_1.effectiveMaxOutputTokens)(req, DEFAULT_MAX_COMPLETION_TOKENS),

package/dist/adapters/responses-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responses-api.d.ts","sourceRoot":"","sources":["../../src/adapters/responses-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,SAAS,CAAC,gCAAgC,CAAC;AAEtF;mFACmF;AACnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C;iDAC6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,qBAAqB,CA8B/E;AA6BD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,CAyDrE"}
+{"version":3,"file":"responses-api.d.ts","sourceRoot":"","sources":["../../src/adapters/responses-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQpD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,SAAS,CAAC,gCAAgC,CAAC;AAEtF;mFACmF;AACnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C;iDAC6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,qBAAqB,CAkC/E;AA6BD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,CAyDrE"}

package/dist/adapters/responses-api.js

@@ -21,6 +21,7 @@ exports.buildResponsesParams = buildResponsesParams;
 exports.mapResponsesResult = mapResponsesResult;
 const sampling_1 = require("./sampling");
 const raw_support_1 = require("../run/raw-support");
+const history_mapping_1 = require("./history-mapping");
 /** Parity with the Chat Completions default output cap (openai.ts / grok.ts). */
 const DEFAULT_MAX_OUTPUT_TOKENS = 32000;
 /**
@@ -33,10 +34,14 @@ const DEFAULT_MAX_OUTPUT_TOKENS = 32000;
  * (the SAME disclosed mapping the Chat Completions path uses — never a silent drop).
  */
 function buildResponsesParams(req) {
-    const input = [
-        ...(req.systemPrompt !== "" ? [{ role: "system", content: req.systemPrompt }] : []),
-        { role: "user", content: req.userPrompt },
-    ];
+    // ARC-β: history present ⇒ messages + function_call / function_call_output
+    // items (history-mapping.ts); absent ⇒ today's literal (byte-identical).
+    const input = req.history !== undefined
+        ? (0, history_mapping_1.toResponsesInput)(req.systemPrompt, req.history, req.userPrompt)
+        : [
+            ...(req.systemPrompt !== "" ? [{ role: "system", content: req.systemPrompt }] : []),
+            { role: "user", content: req.userPrompt },
+        ];
     const reasoning = req.reasoning !== undefined
         ? {
             reasoning: {

package/dist/artifacts/artifact.d.ts.map

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

package/dist/artifacts/artifact.js

@@ -23,6 +23,7 @@ const scrub_1 = require("./scrub");
 const classification_1 = require("./classification");
 const task_settings_1 = require("../settings/task-settings");
 const manifest_1 = require("../prompts/manifest");
+const media_1 = require("./media");
 /** The configured scrub mode for one artifact save (BEFORE the S8-c PII/PHI
  * floor). Resolved EXACTLY as capture-write.ts / samples.ts do: a configured
  * control plane WINS (`resolver.get(task).scrub`), else the rig's default. A
@@ -47,6 +48,8 @@ function contentTypeFor(type) {
     // PSR-1: a structure-only assembly manifest is stored as a linked JSON artifact.
     if (t === "manifest")
         return "application/json";
+    if ((0, media_1.isMediaType)(t))
+        return t; // ARC-4: generated media keeps its own MIME type
     return "application/octet-stream";
 }
 function idOf(ref) {
@@ -165,6 +168,78 @@ function createArtifactApi(deps) {
             }
         }
     }
+    /** ARC-4: save a generated image/video/audio artifact. Same row, lineage and
+     * classification rules as `save`; the bytes are hashed as bytes, the row
+     * carries the unscreened-media scrub flag, and custody uploads the bytes
+     * verbatim under their own MIME type — unless the effective scrub mode is
+     * redact/block, which bytes cannot honour (fail-closed: no upload, counted). */
+    const saveMedia = (value, opts, ctx) => {
+        // F6: only allowlisted media types are stored (svg can carry script).
+        if (!(0, media_1.isAllowedMediaType)(opts.type))
+            return (0, media_1.warnRefusedMediaType)(opts.name, opts.type);
+        const body = (0, media_1.mediaBytes)(value);
+        const contentHash = `sha256:${(0, node_crypto_1.createHash)("sha256").update(body).digest("hex")}`;
+        const id = (0, node_crypto_1.randomUUID)();
+        const version = opts.supersedes !== undefined ? opts.supersedes.version + 1 : 1;
+        const stepKey = opts.stepKey ?? ctx?.currentStepKey() ?? null;
+        const norm = (0, classification_1.normalizeClassification)(opts.classification);
+        const classification = norm !== null && (0, classification_1.isDataClassification)(norm) ? norm : null;
+        if (opts.classification !== undefined && norm !== null && classification === null) {
+            console.warn(`[modelrig artifacts] artifact "${opts.name}" has an unknown data_classification — label dropped (artifact still saved). ` +
+                `fix_hint: use one of ${classification_1.DATA_CLASSIFICATIONS.join(", ")}.`);
+        }
+        // Custody decision BEFORE the row, so the row's scrub record is truthful (F5).
+        const custody = content !== undefined && opts.contentRef === undefined;
+        const mode = custody && content !== undefined ? (0, task_settings_1.effectiveScrubMode)(resolveContentScrubMode(content, opts.task), classification) : null;
+        const refused = mode !== null && !(0, media_1.mediaUploadAllowed)(mode);
+        try {
+            store.recordArtifact({
+                id,
+                runId: ctx?.runId ?? null,
+                stepKey,
+                attemptNo: opts.attemptNo ?? null,
+                task: opts.task ?? null,
+                name: opts.name,
+                type: opts.type,
+                version,
+                supersedesArtifactId: opts.supersedes?.id ?? null,
+                declaredSchema: null,
+                fingerprintCell: null,
+                contentRef: opts.contentRef ?? null,
+                contentHash,
+                contentBytes: body.byteLength,
+                dataClassification: classification,
+                expiresAt: opts.expiresAt ?? null,
+                scrub: refused && mode !== null ? (0, media_1.refusedMediaScrub)(mode) : (0, media_1.unscreenedMediaScrub)(),
+            });
+            saves += 1;
+            if (opts.task !== undefined)
+                savedTasks.set(id, opts.task);
+            if (ctx !== null) {
+                for (const loadedId of ctx.takeLoadedIds()) {
+                    if (loadedId === id)
+                        continue;
+                    store.recordArtifactEdge({ fromArtifactId: id, toArtifactId: loadedId, kind: "derived_from" });
+                    inferredEdges += 1;
+                }
+            }
+        }
+        catch (err) {
+            warn("save (media)", err);
+            return null;
+        }
+        if (content !== undefined && mode !== null) {
+            if (!refused) {
+                fireUpload({ artifactId: id, contentType: contentTypeFor(opts.type), body, contentHash }, content.upload);
+            }
+            else {
+                contentBlocked += 1;
+                console.warn(`[modelrig artifacts] media artifact "${opts.name}" NOT uploaded: scrub mode "${mode}" cannot be applied to ` +
+                    "image/video/audio bytes (the scrub engine reads text only); metadata + hash kept.");
+            }
+        }
+        return { id, name: opts.name, type: opts.type, version };
+    };
     // Extracted so `saveManifest` (PSR-1) can compose them without re-implementing
     // the custody/lineage save path or the edges_no_self link. The bodies are the
     // original `save`/`link` verbatim — the returned object references these.
@@ -177,6 +252,10 @@ function createArtifactApi(deps) {
                 "(fail-closed at the SDK gate; no metadata, no hash persisted).");
             return null;
         }
+        // ARC-4: generated media (image/video/audio) takes its own path — binary
+        // bytes, flagged unscreened (media.ts). Text keeps the path below.
+        if ((0, media_1.isMediaType)(opts.type))
+            return saveMedia(value, opts, ctx);
         // Hash the serialization, then DISCARD the bytes — metadata + hash only.
         const serialized = typeof value === "string" ? value : JSON.stringify(value ?? null);
         const bytes = Buffer.byteLength(serialized, "utf8");

package/dist/artifacts/conversation.d.ts

@@ -0,0 +1,128 @@
+/**
+ * ARC-1 — conversations as runs: `rig.conversation(id, { agent, user?, tenant? })`.
+ *
+ * A conversation (support chat, sales thread, agent task loop) is ONE `runs`
+ * row: `pipeline = agent`, `episode_key = <your conversation id>`,
+ * `meta.trigger = "conversation"`. Each turn is a set of `steps` in that run.
+ * No new table (ARC-D1). The returned handle IS the run handle `run.start`
+ * returns (`runId`, `end`), plus `turn(fn)` and the conversation id.
+ *
+ * ── TURN STEPS — THE RULE ─────────────────────────────────────────────────
+ *  - `conversation.turn(fn)` opens turn n+1 (n starts at 0 — or, on re-entry,
+ *    at the highest turn already recorded for this run) and every `rig.run` /
+ *    `rig.runRaw` / `rig.recordCall` inside `fn` records under step key
+ *    `turn:<n>.<k>`, where k = 1, 2, … is the call's index WITHIN the turn.
+ *    (Why `.k`: a repeated step key inside one run is read as a RETRY — the
+ *    context bumps `attempt_no` for the same key — so two calls in one turn
+ *    must not share `turn:<n>`. `turn:<n>.<k>` keeps every call its own step
+ *    while the turn number stays the prefix every reader groups on.)
+ *  - A call made on the conversation OUTSIDE any `turn()` attaches to the
+ *    CURRENT turn (turn 1 if none was opened yet).
+ *  - An explicit `stepKey` (or `tags.step`) from the caller always wins — the
+ *    turn rule only replaces the auto-minted key.
+ *  - Retries/fallbacks of ONE call reuse its key (attempt_no distinguishes them).
+ *
+ * ── RE-ENTRY ──────────────────────────────────────────────────────────────
+ * A later request with the same `(agent, id)` re-enters the open run instead of
+ * starting a new one: first this process's open conversations, then the LOCAL
+ * store's newest `running` run for `(agent, id)` (so a restarted worker
+ * continues the run and its turn numbering). Cross-process re-entry (another
+ * HTTP worker with its own store) is OUT OF SCOPE for the SDK: a race or a
+ * second worker produces a second run with the same episode_key, which 00031
+ * already tolerates and the console groups by conversation id. Pin with the
+ * returned `runId` if you need one run.
+ *
+ * ── CLOSING ───────────────────────────────────────────────────────────────
+ * `conversation.end(status = "succeeded")`. Conversations rarely end cleanly, so
+ * the server's idle sweep (`conversation-idle-close`) also closes `running`
+ * conversations idle past the org's `idle_close_minutes` (default 30).
+ *
+ * ── CONCURRENCY ───────────────────────────────────────────────────────────
+ * `rig.conversation()` makes the run ambient on the current async path (like
+ * `run.start`, via `enterWith`). `turn(fn)` runs `fn` inside its OWN scope
+ * (`AsyncLocalStorage.run`), so overlapping turns of DIFFERENT conversations in
+ * one process never cross-attribute.
+ *
+ * Inert (a pass-through `turn`, no rows) when the run namespace is disabled.
+ */
+import type { RunEndOptions, RunHandle, RunStatus } from "./run-context";
+import type { RunLimits } from "../run/limits";
+/** The step-key prefix of a conversation turn. */
+export declare const TURN_STEP_PREFIX = "turn:";
+/** `turn:<n>.<k>` — turn n, k-th call within it. */
+export declare function turnStepKey(turn: number, call: number): string;
+/** The turn number a step key belongs to, or null when it is not a turn key.
+ * Accepts `turn:<n>` (an explicit caller key) and `turn:<n>.<k>`. */
+export declare function turnNumberOf(stepKey: string): number | null;
+/** The highest turn among recorded step keys (0 when none). */
+export declare function maxTurnOf(stepKeys: Iterable<string>): number;
+/** The highest turn AND the highest call index within it — the counter seed on
+ * re-entry, so a call that attaches to the current turn never reuses a recorded
+ * `turn:<n>.<k>` key (a reused key would read as a retry). */
+export declare function turnStateOf(stepKeys: Iterable<string>): {
+    readonly turn: number;
+    readonly call: number;
+};
+/** Per-conversation turn bookkeeping: which turn is current and the next call
+ * index within it. Pure; one per conversation context. */
+export declare class TurnCounter {
+    private turnNo;
+    private callNo;
+    /** Seed from a re-entered run: the current turn and its highest call index. */
+    constructor(startAfterTurn?: number, startAfterCall?: number);
+    /** Open the next turn; returns its number. */
+    open(): number;
+    /** The current turn (0 before any). */
+    current(): number;
+    /** Mint the step key for the next call: the current turn (turn 1 if none was
+     * opened yet), next call index. */
+    mint(): string;
+}
+export interface ConversationOptions {
+    /** The agent / bot name — the run's `pipeline`. Required. */
+    readonly agent: string;
+    /** Your end user's opaque id → `tags.user` on every call (never a name/email). */
+    readonly user?: string;
+    /** Your end customer (Tenant Ledger subject) → `tags.subject` on every call. */
+    readonly tenant?: string;
+    readonly environment?: string;
+    /** ARC-5 run limits for the conversation's run (see run/limits.ts). Applied
+     * when the run is STARTED; a re-entry keeps the open run's limits. */
+    readonly limits?: RunLimits;
+}
+/** The handle `rig.conversation` returns — the run handle plus turns. */
+export interface ConversationHandle extends RunHandle {
+    /** Your conversation id (the run's episode_key). */
+    readonly conversationId: string;
+    /** True when this call re-entered an already-open run. */
+    readonly resumed: boolean;
+    /** The current turn number (0 before the first). */
+    currentTurn(): number;
+    /** Open the next turn and run `fn` inside it (see the turn rule above). */
+    turn<T>(fn: () => Promise<T> | T): Promise<T>;
+    /** Close the conversation (default "succeeded"). */
+    end(status?: RunStatus, opts?: RunEndOptions): void;
+}
+/** What `rig.conversation` needs from the run namespace — implemented in
+ * run-context.ts, which owns the ambient storage. */
+export interface ConversationHost<Ctx> {
+    readonly enabled: boolean;
+    /** Find (in-process, then local store) or start the conversation's run. */
+    openOrResume(id: string, opts: ConversationOptions): {
+        readonly ctx: Ctx;
+        readonly resumed: boolean;
+    };
+    runIdOf(ctx: Ctx): string;
+    counterOf(ctx: Ctx): TurnCounter;
+    /** Make `ctx` ambient on the current async path (enterWith). */
+    enter(ctx: Ctx): void;
+    /** Run `fn` with `ctx` ambient in its own scope (storage.run). */
+    runIn<T>(ctx: Ctx, fn: () => Promise<T>): Promise<T>;
+    end(ctx: Ctx, status?: RunStatus, opts?: RunEndOptions): void;
+}
+/** The step tags a conversation stamps on every call (caller tags win). */
+export declare function conversationTags(opts: ConversationOptions): Readonly<Record<string, string>>;
+/** Build a conversation handle over a host. Bad `id`/`agent` is a caller bug and
+ * throws (like `buildGradeRow`); a disabled namespace is inert. */
+export declare function createConversation<Ctx>(host: ConversationHost<Ctx>, id: string, opts: ConversationOptions): ConversationHandle;
+//# sourceMappingURL=conversation.d.ts.map