modelrig 0.4.0 → 0.6.0

package/dist/adapters/attempt-meta-map.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Per-adapter NATIVE metadata mapping (WI-1, spec §2). ONE place that turns a
+ * provider's native finish/refusal/usage/id signals into the additive
+ * `AdapterResult.meta` (`Partial<AttemptMetaV1>`). Adapters map ONLY what the
+ * provider reports; the producer (`telemetry/attempt-meta.ts`) adds
+ * hashes/sizes/cost and enforces the classification rule. Absent = unknown;
+ * nothing here is inferred.
+ *
+ * `refusal` derivation, per adapter:
+ *  - openai / grok / deepseek / deepinfra / fireworks (OpenAI dialect): the
+ *    stream carried a non-empty `choices[].delta.refusal` string, OR
+ *    `finish_reason === "content_filter"`.
+ *  - anthropic: `stop_reason === "refusal"`.
+ *  - gemini: `finishReason` is `SAFETY` / `PROHIBITED_CONTENT` / `RECITATION`.
+ * The refusal TEXT itself is never carried (content) — only the boolean.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapFinishReason = mapFinishReason;
+exports.samplingEcho = samplingEcho;
+exports.aggregateToolCalls = aggregateToolCalls;
+exports.buildAdapterMeta = buildAdapterMeta;
+exports.transportErrorMeta = transportErrorMeta;
+/** Map a provider's native finish/stop reason to the `FinishReason` enum
+ * (spec §2). Unknown/absent ⇒ undefined (never inferred); an unrecognised
+ * non-empty value ⇒ `"other"`. */
+function mapFinishReason(provider, raw) {
+    if (raw === null || raw === undefined || raw === "")
+        return undefined;
+    if (provider === "anthropic") {
+        switch (raw) {
+            case "end_turn":
+            case "stop_sequence":
+                return "stop";
+            case "max_tokens":
+                return "length";
+            case "tool_use":
+                return "tool_calls";
+            case "refusal":
+                return "refusal";
+            default:
+                return "other";
+        }
+    }
+    if (provider === "gemini") {
+        switch (raw) {
+            case "STOP":
+                return "stop";
+            case "MAX_TOKENS":
+                return "length";
+            case "SAFETY":
+            case "PROHIBITED_CONTENT":
+            case "RECITATION":
+                return "content_filter";
+            default:
+                return "other";
+        }
+    }
+    // OpenAI dialect (openai / grok / deepseek / deepinfra / fireworks).
+    switch (raw) {
+        case "stop":
+            return "stop";
+        case "length":
+            return "length";
+        case "tool_calls":
+        case "function_call":
+            return "tool_calls";
+        case "content_filter":
+            return "content_filter";
+        default:
+            return "other";
+    }
+}
+/** The declared sampling echo (spec §2 `sampling`) — the values ModelRig sent,
+ * read back from the request. topP → top_p, maxOutputTokens → max_output_tokens
+ * (the raw lane's top-level or the routed lane's `sampling` block). Numbers
+ * only; undefined when the caller declared none. */
+function samplingEcho(req) {
+    const s = {};
+    if (typeof req.sampling?.temperature === "number")
+        s.temperature = req.sampling.temperature;
+    if (typeof req.sampling?.topP === "number")
+        s.top_p = req.sampling.topP;
+    const maxOut = req.sampling?.maxOutputTokens ?? req.maxOutputTokens;
+    if (typeof maxOut === "number")
+        s.max_output_tokens = maxOut;
+    return Object.keys(s).length > 0 ? s : undefined;
+}
+/** Aggregate normalized tool calls into `{ name, count }` (RAW names — the
+ * producer hashes undeclared ones). Undefined when the turn made none. */
+function aggregateToolCalls(toolCalls) {
+    if (toolCalls === undefined || toolCalls.length === 0)
+        return undefined;
+    const counts = new Map();
+    for (const tc of toolCalls) {
+        const name = tc.function.name;
+        counts.set(name, (counts.get(name) ?? 0) + 1);
+    }
+    return [...counts.entries()].map(([name, count]) => ({ name, count }));
+}
+/** Build one adapter's NATIVE `meta` (spec §2). Only defined signals appear —
+ * everything else is unknown and omitted. The producer takes it from here. */
+function buildAdapterMeta(provider, s) {
+    const meta = {};
+    const finish = mapFinishReason(provider, s.finishReasonRaw);
+    if (finish !== undefined)
+        meta.finish_reason = finish;
+    if (typeof s.refusal === "boolean")
+        meta.refusal = s.refusal;
+    if (typeof s.reasoningTokens === "number" && s.reasoningTokens > 0) {
+        meta.reasoning_tokens = s.reasoningTokens;
+    }
+    if (typeof s.modelSnapshot === "string" && s.modelSnapshot !== "")
+        meta.model_snapshot = s.modelSnapshot;
+    if (typeof s.providerRequestId === "string" && s.providerRequestId !== "") {
+        meta.provider_request_id = s.providerRequestId;
+    }
+    if (typeof s.region === "string" && s.region !== "")
+        meta.region = s.region;
+    const sampling = samplingEcho(s.req);
+    if (sampling !== undefined)
+        meta.sampling = sampling;
+    const tools = aggregateToolCalls(s.toolCalls);
+    if (tools !== undefined)
+        meta.tool_calls = tools;
+    if (s.grounding !== undefined) {
+        const g = {};
+        if (typeof s.grounding.citations === "number")
+            g.citations = s.grounding.citations;
+        if (typeof s.grounding.searchProvider === "string")
+            g.search_provider = s.grounding.searchProvider;
+        if (Object.keys(g).length > 0)
+            meta.grounding = g;
+    }
+    if (typeof s.streaming === "boolean")
+        meta.streaming = s.streaming;
+    return meta;
+}
+/** A transport/SDK error's coarse envelope (spec §2 `http_status`/`error_code`).
+ * Reads `error.status` (number) and a short `error.code` / `error.error.code`
+ * slug — NEVER the message (that is free text). The producer's classification
+ * rule drops a code that turns out to be free text. */
+function transportErrorMeta(error) {
+    const meta = {};
+    if (typeof error === "object" && error !== null) {
+        const e = error;
+        if (typeof e.status === "number" && Number.isFinite(e.status))
+            meta.http_status = e.status;
+        const code = typeof e.code === "string" ? e.code : e.error?.code;
+        if (typeof code === "string" && code !== "")
+            meta.error_code = code;
+    }
+    return meta;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"deepseek.d.ts","sourceRoot":"","sources":["../../src/adapters/deepseek.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAIV,cAAc,EACd,eAAe,EAChB,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;AAMhG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAMhF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAiB1E;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,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,eAAe,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAOD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,oBAAoB,CAkC1F;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CA8JpF"}
+{"version":3,"file":"deepseek.d.ts","sourceRoot":"","sources":["../../src/adapters/deepseek.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAIV,cAAc,EACd,eAAe,EAChB,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;AAQhG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAMhF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAiB1E;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,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,eAAe,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAOD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,oBAAoB,CAkC1F;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAoLpF"}

package/dist/adapters/deepseek.js

@@ -24,6 +24,7 @@ exports.createDeepSeekAdapter = createDeepSeekAdapter;
 const openai_1 = __importDefault(require("openai"));
 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 DEEPSEEK_BASE_URL = "https://api.deepseek.com";
 const DEFAULT_MAX_TOKENS = 64000; // R1/V3 max — full capacity for long reports (ported)
@@ -102,6 +103,8 @@ function createDeepSeekAdapter(config) {
         supportsTools: () => true,
         async call(req) {
             const model = req.candidate.model;
+            // WI-1: native attempt envelope for this call (see openai.ts for the pattern).
+            let attemptMeta;
             // F1: post-stream failures still billed tokens — attach usage.
             const fail = (cls, message, fixHint, usage) => ({
                 ok: false,
@@ -113,6 +116,7 @@ function createDeepSeekAdapter(config) {
                     ...(fixHint !== undefined ? { fixHint } : {}),
                 },
                 ...(usage !== undefined ? { usage } : {}),
+                ...(attemptMeta !== undefined ? { meta: attemptMeta } : {}),
             });
             try {
                 const client = new openai_1.default({
@@ -130,12 +134,18 @@ function createDeepSeekAdapter(config) {
                 let finishReason = null;
                 // TTFB (Phase 4 WS3): first streamed chunk = first body byte.
                 let ttfbMs;
+                let responseModel = "";
+                let responseId = "";
                 const toolCallAcc = (0, tool_mapping_1.createOpenAIToolCallAccumulator)();
                 // Only delta.content is accumulated — a reasoner's reasoning_content
                 // (chain-of-thought) must never leak into the JSON buffer (ported).
                 for await (const chunk of stream) {
                     if (ttfbMs === undefined)
                         ttfbMs = Date.now() - dispatchedAt;
+                    if (responseModel === "" && typeof chunk.model === "string")
+                        responseModel = chunk.model;
+                    if (responseId === "" && typeof chunk.id === "string")
+                        responseId = chunk.id;
                     const choice = chunk.choices[0];
                     if (choice?.delta?.content)
                         text += choice.delta.content;
@@ -159,8 +169,19 @@ function createDeepSeekAdapter(config) {
                 };
                 // Tool-call turn (spec §4.4): surface normalized calls, skip content guards.
                 const toolCalls = toolCallAcc.finalize();
+                // WI-1: native attempt envelope. DeepSeek has no `refusal` delta — a
+                // refusal surfaces as finish_reason content_filter.
+                attemptMeta = (0, attempt_meta_map_1.buildAdapterMeta)("deepseek", {
+                    req,
+                    finishReasonRaw: finishReason,
+                    refusal: finishReason === "content_filter",
+                    modelSnapshot: responseModel,
+                    providerRequestId: responseId,
+                    toolCalls,
+                    streaming: false,
+                });
                 if (toolCalls !== undefined) {
-                    return { ok: true, text, usage, toolCalls };
+                    return { ok: true, text, usage, toolCalls, meta: attemptMeta };
                 }
                 if (text.trim().length === 0) {
                     return fail("content_invalid", `empty response from DeepSeek (finish_reason=${finishReason ?? "none"})`, undefined, usage);
@@ -168,11 +189,12 @@ function createDeepSeekAdapter(config) {
                 if (finishReason === "length" && req.outputSchema !== null) {
                     return fail("content_invalid", "DeepSeek JSON output truncated (finish_reason=length)", "raise maxOutputTokens for this route", usage);
                 }
-                return { ok: true, text, usage };
+                return { ok: true, text, usage, meta: attemptMeta };
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
                 const { cls, fixHint } = classifyDeepSeekFailure(message);
+                attemptMeta = (0, attempt_meta_map_1.transportErrorMeta)(error);
                 return {
                     ok: false,
                     failure: {
@@ -183,6 +205,7 @@ function createDeepSeekAdapter(config) {
                         cause: error,
                         ...(fixHint !== undefined ? { fixHint } : {}),
                     },
+                    meta: attemptMeta,
                 };
             }
         },

package/dist/adapters/gemini.d.ts

@@ -56,5 +56,44 @@ export interface GeminiShapedRequest {
 }
 /** Pure request shaping — everything except the abort signal. */
 export declare function buildGeminiRequest(model: string, req: ShapingInput): GeminiShapedRequest;
+/** A candidate's parts as we read them post-response — `functionCall`, `text`,
+ * and (if `includeThoughts` were ever set) a `thought`-flagged text part may all
+ * appear on the same candidate (a grounded / thinking turn). */
+type GeminiCandidatePart = {
+    readonly functionCall?: unknown;
+    readonly text?: string;
+    readonly thought?: boolean;
+};
+type GeminiCandidateShape = {
+    readonly content?: {
+        readonly parts?: readonly GeminiCandidatePart[];
+    };
+};
+/**
+ * #245 secondary — concatenate the answer `text` parts of a Gemini candidate's
+ * content. On the raw / no-tools lane a grounding-originated `functionCall` part
+ * (googleSearch) is NOT a tool-call turn, and the SDK's `response.text` getter
+ * returns empty (and logs a warning) on a response that mixes `functionCall` +
+ * `text` parts — so read the text parts directly. `thought`-flagged parts are
+ * skipped to match `response.text` semantics (they are the reasoning summary, not
+ * the answer). Pure + exported for the fixture regression test (no network).
+ * (spec §2 Secondary — the SNPS bug.)
+ */
+export declare function extractGeminiCandidateText(candidate: GeminiCandidateShape | undefined): string;
+/** #245 secondary — whether a candidate carries a `functionCall` part. On the
+ * no-tools lane this means grounding produced only a googleSearch invocation with
+ * no text answer, which the empty-response `fixHint` should name. */
+export declare function geminiCandidateHasFunctionCall(candidate: GeminiCandidateShape | undefined): boolean;
+/**
+ * #245 secondary — pick the answer text from a Gemini response. The branch the
+ * `call()` path uses, extracted pure so it is unit-testable without a network:
+ *  - tools declared: trust the SDK `response.text` getter, byte-identical to
+ *    pre-#245 (a functionCall turn is handled earlier as a tool-call).
+ *  - no tools declared: read the candidate's text parts directly, because
+ *    `response.text` returns empty on a grounding-originated functionCall+text
+ *    response; fall back to `response.text` only if there is no text part.
+ */
+export declare function resolveGeminiText(candidate: GeminiCandidateShape | undefined, responseText: string | undefined, hasTools: boolean): string;
 export declare function createGeminiAdapter(config: GeminiAdapterConfig): ProviderAdapter;
+export {};
 //# sourceMappingURL=gemini.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/adapters/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,cAAc,EAGd,cAAc,EACd,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,mBAAmB,CAAC;AAKlE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;mCAImC;AACnC,eAAO,MAAM,8BAA8B,EAAE,WAAW,CAAC,MAAM,CAI7D,CAAC;AA0BH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG9E;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAyCxE;AAED;6EAC6E;AAC7E,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;AAE7D;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,iBAAiB,GAAG,IAAI,CAQrG;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,mBAAmB,CAqDxF;AA0BD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,eAAe,CA+JhF"}
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/adapters/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,cAAc,EAGd,cAAc,EACd,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,mBAAmB,CAAC;AAQlE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;mCAImC;AACnC,eAAO,MAAM,8BAA8B,EAAE,WAAW,CAAC,MAAM,CAI7D,CAAC;AA0BH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG9E;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAyCxE;AAED;6EAC6E;AAC7E,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;AAE7D;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,iBAAiB,GAAG,IAAI,CAQrG;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,mBAAmB,CAqDxF;AA0BD;;gEAEgE;AAChE,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AACF,KAAK,oBAAoB,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAEvG;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAM9F;AAED;;qEAEqE;AACrE,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAInG;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,OAAO,GAChB,MAAM,CAGR;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,eAAe,CA4MhF"}

package/dist/adapters/gemini.js

@@ -20,9 +20,13 @@ exports.geminiSupports = geminiSupports;
 exports.classifyGeminiFailure = classifyGeminiFailure;
 exports.geminiReasoningUnsupported = geminiReasoningUnsupported;
 exports.buildGeminiRequest = buildGeminiRequest;
+exports.extractGeminiCandidateText = extractGeminiCandidateText;
+exports.geminiCandidateHasFunctionCall = geminiCandidateHasFunctionCall;
+exports.resolveGeminiText = resolveGeminiText;
 exports.createGeminiAdapter = createGeminiAdapter;
 const genai_1 = require("@google/genai");
 const tool_mapping_1 = require("./tool-mapping");
+const attempt_meta_map_1 = require("./attempt-meta-map");
 const sampling_1 = require("./sampling");
 /** Models that accept thinkingConfig — passing it to 2.x models 400s.
  * Ported from the production THINKING_CAPABLE_MODELS set. EXPORTED (CE-9 R6) so
@@ -190,6 +194,43 @@ function extractServedTier(rawServiceTier, trafficType, requested) {
         return "priority";
     return requested;
 }
+/**
+ * #245 secondary — concatenate the answer `text` parts of a Gemini candidate's
+ * content. On the raw / no-tools lane a grounding-originated `functionCall` part
+ * (googleSearch) is NOT a tool-call turn, and the SDK's `response.text` getter
+ * returns empty (and logs a warning) on a response that mixes `functionCall` +
+ * `text` parts — so read the text parts directly. `thought`-flagged parts are
+ * skipped to match `response.text` semantics (they are the reasoning summary, not
+ * the answer). Pure + exported for the fixture regression test (no network).
+ * (spec §2 Secondary — the SNPS bug.)
+ */
+function extractGeminiCandidateText(candidate) {
+    return (candidate?.content?.parts ?? [])
+        .filter((p) => p.thought !== true)
+        .map((p) => p.text)
+        .filter((t) => typeof t === "string")
+        .join("");
+}
+/** #245 secondary — whether a candidate carries a `functionCall` part. On the
+ * no-tools lane this means grounding produced only a googleSearch invocation with
+ * no text answer, which the empty-response `fixHint` should name. */
+function geminiCandidateHasFunctionCall(candidate) {
+    return (candidate?.content?.parts ?? []).some((p) => p.functionCall !== undefined && p.functionCall !== null);
+}
+/**
+ * #245 secondary — pick the answer text from a Gemini response. The branch the
+ * `call()` path uses, extracted pure so it is unit-testable without a network:
+ *  - tools declared: trust the SDK `response.text` getter, byte-identical to
+ *    pre-#245 (a functionCall turn is handled earlier as a tool-call).
+ *  - no tools declared: read the candidate's text parts directly, because
+ *    `response.text` returns empty on a grounding-originated functionCall+text
+ *    response; fall back to `response.text` only if there is no text part.
+ */
+function resolveGeminiText(candidate, responseText, hasTools) {
+    if (hasTools)
+        return responseText ?? "";
+    return extractGeminiCandidateText(candidate) || (responseText ?? "");
+}
 function createGeminiAdapter(config) {
     const ai = new genai_1.GoogleGenAI({ apiKey: config.apiKey });
     return {
@@ -200,6 +241,8 @@ function createGeminiAdapter(config) {
             const model = req.candidate.model;
             const abortController = new AbortController();
             const timeoutId = setTimeout(() => abortController.abort(), req.timeoutMs);
+            // WI-1: native attempt envelope for this call (see openai.ts for the pattern).
+            let attemptMeta;
             // F1: post-response failures (refusal/empty/truncation) still billed
             // tokens — they attach the response usage so the run loop accounts them.
             const fail = (cls, message, fixHint, usage) => ({
@@ -212,6 +255,7 @@ function createGeminiAdapter(config) {
                     ...(fixHint !== undefined ? { fixHint } : {}),
                 },
                 ...(usage !== undefined ? { usage } : {}),
+                ...(attemptMeta !== undefined ? { meta: attemptMeta } : {}),
             });
             // CE-2 F3: reject reasoning on a non-thinking model BEFORE any dispatch —
             // classified, terminal, never a silent drop (spec §3 F3).
@@ -242,6 +286,24 @@ function createGeminiAdapter(config) {
                 const usage = { tokensIn, tokensOut, tokensCached, servedTier, ttfbMs };
                 const candidates = response.candidates;
                 const finishReason = candidates?.[0]?.finishReason;
+                // WI-1 native fields: provider-reported model snapshot + request id.
+                const respIds = response;
+                // WI-1: native attempt envelope. refusal derives from the safety/recitation
+                // finishReasons (mapFinishReason folds them to content_filter). grounding
+                // present when this route asked for native grounding (googleSearch).
+                const mkMeta = (toolCalls) => (0, attempt_meta_map_1.buildAdapterMeta)("gemini", {
+                    req,
+                    finishReasonRaw: finishReason,
+                    refusal: finishReason === "SAFETY" ||
+                        finishReason === "PROHIBITED_CONTENT" ||
+                        finishReason === "RECITATION",
+                    reasoningTokens: usageMetadata.thoughtsTokenCount,
+                    modelSnapshot: respIds.modelVersion,
+                    providerRequestId: respIds.responseId,
+                    toolCalls,
+                    grounding: req.grounding === true ? { searchProvider: "google" } : undefined,
+                    streaming: false,
+                });
                 // Tool-call turn (spec §4.4): collect functionCall parts. When present,
                 // surface normalized calls and skip the text/empty/truncation guards.
                 // Read any accompanying text from the parts (not the `response.text`
@@ -257,27 +319,42 @@ function createGeminiAdapter(config) {
                             .map((p) => p.text)
                             .filter((t) => typeof t === "string")
                             .join("");
-                        return { ok: true, text: toolText, usage, toolCalls };
+                        attemptMeta = mkMeta(toolCalls);
+                        return { ok: true, text: toolText, usage, toolCalls, meta: attemptMeta };
                     }
                 }
+                // Non-tool paths share one envelope (refusal / empty / truncation / ok).
+                attemptMeta = mkMeta();
                 if (finishReason === "SAFETY" || finishReason === "PROHIBITED_CONTENT") {
                     return fail("refusal", `Gemini blocked output via safety filter (finishReason=${finishReason})`, undefined, usage);
                 }
                 if (finishReason === "RECITATION") {
                     return fail("refusal", "Gemini blocked output via recitation filter (finishReason=RECITATION)", undefined, usage);
                 }
-                const text = response.text ?? "";
+                // #245 secondary: when the caller declared NO tools, a `functionCall`
+                // part is grounding-originated (googleSearch), NOT a tool-call turn — and
+                // `response.text` returns empty on a mixed functionCall+text response, so
+                // read the text parts directly. When tools WERE declared this path is
+                // reached only for a no-functionCall response, so `response.text` is
+                // byte-identical to before.
+                const noTools = req.tools === undefined || req.tools.length === 0;
+                const text = resolveGeminiText(candidates?.[0], response.text, !noTools);
                 if (text.trim().length === 0) {
-                    return fail("content_invalid", `empty response from Gemini (finishReason=${finishReason ?? "none"})`, undefined, usage);
+                    const groundedNoText = noTools &&
+                        geminiCandidateHasFunctionCall(candidates?.[0]);
+                    return fail("content_invalid", `empty response from Gemini (finishReason=${finishReason ?? "none"})`, groundedNoText
+                        ? "the grounded response returned only a googleSearch functionCall part with no text — refine the grounding query, or remove grounding if the model can answer directly"
+                        : undefined, usage);
                 }
                 if (finishReason === "MAX_TOKENS" && req.outputSchema !== null) {
                     // A truncated structured emission is mid-object and unparseable.
                     return fail("content_invalid", "Gemini structured output truncated (finishReason=MAX_TOKENS)", "raise maxOutputTokens for this route or reduce thinking budget", usage);
                 }
-                return { ok: true, text, usage };
+                return { ok: true, text, usage, meta: attemptMeta };
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
+                attemptMeta = (0, attempt_meta_map_1.transportErrorMeta)(error);
                 // An abort we triggered is our timeout regardless of message text.
                 if (abortController.signal.aborted) {
                     return fail("timeout", `Gemini call exceeded timeoutMs=${req.timeoutMs}: ${message}`);
@@ -293,6 +370,7 @@ function createGeminiAdapter(config) {
                         cause: error,
                         ...(fixHint !== undefined ? { fixHint } : {}),
                     },
+                    meta: attemptMeta,
                 };
             }
             finally {

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

@@ -1 +1 @@
-{"version":3,"file":"grok.d.ts","sourceRoot":"","sources":["../../src/adapters/grok.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAIV,cAAc,EACd,eAAe,EAChB,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;AAOhG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAKD,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAc7E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA+BtE;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,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;8EAC0E;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;4DAGwD;IACxD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3C,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;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,gBAAgB,CAmDlF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAgK5E"}
+{"version":3,"file":"grok.d.ts","sourceRoot":"","sources":["../../src/adapters/grok.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAIV,cAAc,EACd,eAAe,EAChB,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;AAShG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAKD,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAc7E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA+BtE;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,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;8EAC0E;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;4DAGwD;IACxD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3C,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;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,gBAAgB,CAmDlF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAsL5E"}

package/dist/adapters/grok.js

@@ -22,6 +22,7 @@ exports.createGrokAdapter = createGrokAdapter;
 const openai_1 = __importDefault(require("openai"));
 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 raw_support_1 = require("../run/raw-support");
 const GROK_BASE_URL = "https://api.x.ai/v1";
@@ -135,6 +136,8 @@ function createGrokAdapter(config) {
         supportsTools: () => true,
         async call(req) {
             const model = req.candidate.model;
+            // WI-1: native attempt envelope for this call (see openai.ts for the pattern).
+            let attemptMeta;
             // F1: post-stream failures still billed tokens — attach usage.
             const fail = (cls, message, fixHint, usage) => ({
                 ok: false,
@@ -146,6 +149,7 @@ function createGrokAdapter(config) {
                     ...(fixHint !== undefined ? { fixHint } : {}),
                 },
                 ...(usage !== undefined ? { usage } : {}),
+                ...(attemptMeta !== undefined ? { meta: attemptMeta } : {}),
             });
             try {
                 const client = new openai_1.default({
@@ -161,10 +165,16 @@ function createGrokAdapter(config) {
                 let cachedTokens = 0;
                 let cacheWriteTokens = 0;
                 let finishReason = null;
+                let responseModel = "";
+                let responseId = "";
                 const toolCallAcc = (0, tool_mapping_1.createOpenAIToolCallAccumulator)();
                 // Only delta.content is accumulated — a reasoning model's trace must
                 // never leak into the JSON buffer (deepseek reasoner rule applied).
                 for await (const chunk of stream) {
+                    if (responseModel === "" && typeof chunk.model === "string")
+                        responseModel = chunk.model;
+                    if (responseId === "" && typeof chunk.id === "string")
+                        responseId = chunk.id;
                     const choice = chunk.choices[0];
                     if (choice?.delta?.content)
                         text += choice.delta.content;
@@ -190,8 +200,19 @@ function createGrokAdapter(config) {
                 // Tool-call turn (spec §4.4): surface normalized calls, skip the
                 // empty/truncation content guards below.
                 const toolCalls = toolCallAcc.finalize();
+                // WI-1: native attempt envelope (no `refusal` delta on this dialect →
+                // refusal derives from finish_reason content_filter).
+                attemptMeta = (0, attempt_meta_map_1.buildAdapterMeta)("grok", {
+                    req,
+                    finishReasonRaw: finishReason,
+                    refusal: finishReason === "content_filter",
+                    modelSnapshot: responseModel,
+                    providerRequestId: responseId,
+                    toolCalls,
+                    streaming: false,
+                });
                 if (toolCalls !== undefined) {
-                    return { ok: true, text, usage, toolCalls };
+                    return { ok: true, text, usage, toolCalls, meta: attemptMeta };
                 }
                 if (text.trim().length === 0) {
                     return fail("content_invalid", `empty response from Grok (finish_reason=${finishReason ?? "none"})`, undefined, usage);
@@ -199,11 +220,12 @@ function createGrokAdapter(config) {
                 if (finishReason === "length" && req.outputSchema !== null) {
                     return fail("content_invalid", "Grok structured output truncated (finish_reason=length)", "raise maxOutputTokens for this route", usage);
                 }
-                return { ok: true, text, usage };
+                return { ok: true, text, usage, meta: attemptMeta };
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
                 const { cls, fixHint } = classifyGrokFailure(message);
+                attemptMeta = (0, attempt_meta_map_1.transportErrorMeta)(error);
                 return {
                     ok: false,
                     failure: {
@@ -214,6 +236,7 @@ function createGrokAdapter(config) {
                         cause: error,
                         ...(fixHint !== undefined ? { fixHint } : {}),
                     },
+                    meta: attemptMeta,
                 };
             }
         },

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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAIV,cAAc,EACd,eAAe,EACf,UAAU,EACX,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;AAUhG;;8CAE8C;AAC9C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAED;;;0EAG0E;AAC1E,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,GAAG,WAAW,EAAE,gBAAgB,CAAC,CAG7F,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA2BtF;AAED,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,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;;oFAEgF;IAChF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClE;kEAC8D;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,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,IAAI,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACjG,CAAC;IACN,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAOD;;2DAE2D;AAC3D,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,YAAY,EACjB,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,GACxC,wBAAwB,CAmD1B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD;+DAC2D;IAC3D,QAAQ,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC,cAAc,CAAC,CAAC;CAC5E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,eAAe,CA8L5F"}

package/dist/adapters/openai-compat.js

@@ -30,6 +30,7 @@ exports.createOpenAICompatAdapter = createOpenAICompatAdapter;
 const openai_1 = __importDefault(require("openai"));
 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 DEFAULT_MAX_TOKENS = 32000;
 /** Fireworks serves models at accounts/fireworks/models/<short> — routes
@@ -146,6 +147,8 @@ function createOpenAICompatAdapter(config) {
         supportsTools: () => true,
         async call(req) {
             const model = req.candidate.model;
+            // WI-1: native attempt envelope for this call (see openai.ts for the pattern).
+            let attemptMeta;
             const fail = (cls, message, fixHint, usage) => ({
                 ok: false,
                 failure: {
@@ -156,6 +159,7 @@ function createOpenAICompatAdapter(config) {
                     ...(fixHint !== undefined ? { fixHint } : {}),
                 },
                 ...(usage !== undefined ? { usage } : {}),
+                ...(attemptMeta !== undefined ? { meta: attemptMeta } : {}),
             });
             try {
                 const client = new openai_1.default({
@@ -174,10 +178,16 @@ function createOpenAICompatAdapter(config) {
                 let finishReason = null;
                 // TTFB (Phase 4 WS3): first streamed chunk = first body byte.
                 let ttfbMs;
+                let responseModel = "";
+                let responseId = "";
                 const toolCallAcc = (0, tool_mapping_1.createOpenAIToolCallAccumulator)();
                 for await (const chunk of stream) {
                     if (ttfbMs === undefined)
                         ttfbMs = Date.now() - dispatchedAt;
+                    if (responseModel === "" && typeof chunk.model === "string")
+                        responseModel = chunk.model;
+                    if (responseId === "" && typeof chunk.id === "string")
+                        responseId = chunk.id;
                     const choice = chunk.choices[0];
                     if (choice?.delta?.content)
                         text += choice.delta.content;
@@ -203,8 +213,19 @@ function createOpenAICompatAdapter(config) {
                 };
                 // Tool-call turn (spec §4.4): surface normalized calls, skip content guards.
                 const toolCalls = toolCallAcc.finalize();
+                // WI-1: native attempt envelope (no `refusal` delta on this dialect →
+                // refusal derives from finish_reason content_filter).
+                attemptMeta = (0, attempt_meta_map_1.buildAdapterMeta)(config.providerId, {
+                    req,
+                    finishReasonRaw: finishReason,
+                    refusal: finishReason === "content_filter",
+                    modelSnapshot: responseModel,
+                    providerRequestId: responseId,
+                    toolCalls,
+                    streaming: false,
+                });
                 if (toolCalls !== undefined) {
-                    return { ok: true, text, usage, toolCalls };
+                    return { ok: true, text, usage, toolCalls, meta: attemptMeta };
                 }
                 if (text.trim().length === 0) {
                     return fail("content_invalid", `empty response from ${config.providerId} (finish_reason=${finishReason ?? "none"})`, undefined, usage);
@@ -212,11 +233,12 @@ function createOpenAICompatAdapter(config) {
                 if (finishReason === "length" && req.outputSchema !== null) {
                     return fail("content_invalid", `${config.providerId} JSON output truncated (finish_reason=length)`, "raise maxOutputTokens for this route", usage);
                 }
-                return { ok: true, text, usage };
+                return { ok: true, text, usage, meta: attemptMeta };
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
                 const { cls, fixHint } = classifyCompatFailure(message, config.providerId);
+                attemptMeta = (0, attempt_meta_map_1.transportErrorMeta)(error);
                 return {
                     ok: false,
                     failure: {
@@ -227,6 +249,7 @@ function createOpenAICompatAdapter(config) {
                         cause: error,
                         ...(fixHint !== undefined ? { fixHint } : {}),
                     },
+                    meta: attemptMeta,
                 };
             }
         },