modelrig 0.5.0 → 0.6.0

package/dist/adapters/gemini.js

@@ -26,6 +26,7 @@ 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
@@ -240,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) => ({
@@ -252,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).
@@ -282,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`
@@ -297,9 +319,12 @@ 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);
                 }
@@ -325,10 +350,11 @@ function createGeminiAdapter(config) {
                     // 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}`);
@@ -344,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":"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"}

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,
                 };
             }
         },

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

@@ -16,6 +16,8 @@ import type { AdapterRequest, AdapterStreamEvent, ProviderId, ServiceTier } from
 import type { OpenAIToolCallDelta } from "./tool-mapping";
 /** The permissive chunk shape common to the OpenAI-dialect hosts. */
 export interface OpenAIDialectChunk {
+    readonly id?: string;
+    readonly model?: string;
     readonly service_tier?: string;
     readonly choices: Array<{
         readonly delta?: {

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

@@ -1 +1 @@
-{"version":3,"file":"openai-stream.d.ts","sourceRoot":"","sources":["../../src/adapters/openai-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAElB,UAAU,EACV,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE;YACf,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;SACtD,CAAC;QACF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxC,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,qBAAqB,CAAC,EAAE;YAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;QAC1C;;6DAEqD;QACrD,QAAQ,CAAC,oBAAoB,CAAC,EAAE;YAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1E,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,GAAG,WAAW,CAAC;IACpD,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,WAAW,KAAK,WAAW,CAAC;CACrF;AAED;;;;;;GAMG;AACH,wBAAuB,mBAAmB,CACxC,MAAM,EAAE,aAAa,CAAC,kBAAkB,CAAC,EACzC,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,kBAAkB,GACtB,cAAc,CAAC,kBAAkB,CAAC,CAqGpC"}
+{"version":3,"file":"openai-stream.d.ts","sourceRoot":"","sources":["../../src/adapters/openai-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAElB,UAAU,EACV,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE;YACf,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;SACtD,CAAC;QACF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxC,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,qBAAqB,CAAC,EAAE;YAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;QAC1C;;6DAEqD;QACrD,QAAQ,CAAC,oBAAoB,CAAC,EAAE;YAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1E,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,GAAG,WAAW,CAAC;IACpD,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,WAAW,KAAK,WAAW,CAAC;CACrF;AAED;;;;;;GAMG;AACH,wBAAuB,mBAAmB,CACxC,MAAM,EAAE,aAAa,CAAC,kBAAkB,CAAC,EACzC,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,kBAAkB,GACtB,cAAc,CAAC,kBAAkB,CAAC,CAuHpC"}

package/dist/adapters/openai-stream.js

@@ -15,6 +15,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.streamOpenAIDialect = streamOpenAIDialect;
+const attempt_meta_map_1 = require("./attempt-meta-map");
 const tool_mapping_1 = require("./tool-mapping");
 /**
  * Drain an OpenAI-dialect completion stream into `AdapterStreamEvent`s. Emits a
@@ -34,11 +35,17 @@ async function* streamOpenAIDialect(chunks, req, dispatchedAt, cfg) {
     let cacheWriteTokens = 0;
     let responseTier = null;
     let finishReason = null;
+    let responseModel = "";
+    let responseId = "";
     for await (const chunk of chunks) {
         if (ttfbMs === undefined)
             ttfbMs = Date.now() - dispatchedAt;
         if (responseTier === null && chunk.service_tier !== undefined)
             responseTier = chunk.service_tier;
+        if (responseModel === "" && typeof chunk.model === "string")
+            responseModel = chunk.model;
+        if (responseId === "" && typeof chunk.id === "string")
+            responseId = chunk.id;
         const choice = chunk.choices[0];
         const content = choice?.delta?.content;
         if (content) {
@@ -73,6 +80,18 @@ async function* streamOpenAIDialect(chunks, req, dispatchedAt, cfg) {
         servedTier: cfg.mapServedTier(responseTier, req.requestedTier),
         ...(ttfbMs !== undefined ? { ttfbMs } : {}),
     };
+    const toolCalls = toolCallAcc.finalize();
+    // WI-1: native attempt envelope for the streamed call (streaming: true). Built
+    // once, attached to every terminal `final` result below.
+    const meta = (0, attempt_meta_map_1.buildAdapterMeta)(cfg.provider, {
+        req,
+        finishReasonRaw: finishReason,
+        refusal: refusalText.length > 0 || finishReason === "content_filter",
+        modelSnapshot: responseModel,
+        providerRequestId: responseId,
+        toolCalls,
+        streaming: true,
+    });
     const fail = (message, fixHint) => ({
         kind: "final",
         result: {
@@ -85,6 +104,7 @@ async function* streamOpenAIDialect(chunks, req, dispatchedAt, cfg) {
                 ...(fixHint !== undefined ? { fixHint } : {}),
             },
             usage,
+            meta,
         },
     });
     if (refusalText.length > 0) {
@@ -99,13 +119,13 @@ async function* streamOpenAIDialect(chunks, req, dispatchedAt, cfg) {
                     model: req.candidate.model,
                 },
                 usage,
+                meta,
             },
         };
         return;
     }
-    const toolCalls = toolCallAcc.finalize();
     if (toolCalls !== undefined) {
-        yield { kind: "final", result: { ok: true, text, usage, toolCalls } };
+        yield { kind: "final", result: { ok: true, text, usage, toolCalls, meta } };
         return;
     }
     if (text.trim().length === 0) {
@@ -116,5 +136,5 @@ async function* streamOpenAIDialect(chunks, req, dispatchedAt, cfg) {
         yield fail(`${cfg.provider} output truncated (finish_reason=length)`, "raise maxOutputTokens for this route");
         return;
     }
-    yield { kind: "final", result: { ok: true, text, usage } };
+    yield { kind: "final", result: { ok: true, text, usage, meta } };
 }

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,EAEhB,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,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,CA8BxE;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;AAcD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,eAAe,CAwMhF"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAIV,cAAc,EACd,eAAe,EAEhB,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,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,CA8BxE;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;AAcD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,eAAe,CAsOhF"}

package/dist/adapters/openai.js

@@ -24,6 +24,7 @@ exports.createOpenAIAdapter = createOpenAIAdapter;
 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");
 /** OpenAI's documented flex-eligible allowlist as of 2026-05 (ported).
  * Mini and nano variants are silently downgraded to default tier. */
@@ -162,6 +163,11 @@ function createOpenAIAdapter(config) {
         supportsTools: () => true,
         async call(req) {
             const model = req.candidate.model;
+            // WI-1: the native attempt envelope for this call — set once the signals
+            // are known (after the stream, or from the transport error), read by every
+            // return via the closure. Absent until then (a pre-signal throw ⇒ null meta
+            // downstream, byte-identical run result).
+            let attemptMeta;
             // F1: post-stream failures still billed tokens — attach usage.
             const fail = (cls, message, fixHint, usage) => ({
                 ok: false,
@@ -173,6 +179,7 @@ function createOpenAIAdapter(config) {
                     ...(fixHint !== undefined ? { fixHint } : {}),
                 },
                 ...(usage !== undefined ? { usage } : {}),
+                ...(attemptMeta !== undefined ? { meta: attemptMeta } : {}),
             });
             try {
                 const client = new openai_1.default({ apiKey: config.apiKey, timeout: req.timeoutMs });
@@ -191,12 +198,19 @@ function createOpenAIAdapter(config) {
                 let reasoningTokens = 0;
                 let responseTier = null;
                 let finishReason = null;
+                // WI-1 native fields: the provider-reported model snapshot + request id.
+                let responseModel = "";
+                let responseId = "";
                 for await (const chunk of stream) {
                     if (ttfbMs === undefined)
                         ttfbMs = Date.now() - dispatchedAt;
                     if (responseTier === null && chunk.service_tier !== undefined) {
                         responseTier = chunk.service_tier;
                     }
+                    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;
@@ -223,17 +237,30 @@ function createOpenAIAdapter(config) {
                     servedTier: mapServedTier(responseTier, req.requestedTier),
                     ...(ttfbMs !== undefined ? { ttfbMs } : {}),
                 };
+                // Tool-call turn (spec §4.4): the model chose to call a tool. Surface
+                // the normalized calls; text may legitimately be empty — do NOT run the
+                // empty/suspicious-short/validation guards below.
+                const toolCalls = toolCallAcc.finalize();
+                // WI-1: native attempt envelope, built once from this call's signals.
+                // refusal derivation: a streamed `refusal` delta OR finish_reason
+                // content_filter (documented in attempt-meta-map.ts).
+                attemptMeta = (0, attempt_meta_map_1.buildAdapterMeta)("openai", {
+                    req,
+                    finishReasonRaw: finishReason,
+                    refusal: refusalText.length > 0 || finishReason === "content_filter",
+                    reasoningTokens,
+                    modelSnapshot: responseModel,
+                    providerRequestId: responseId,
+                    toolCalls,
+                    streaming: false,
+                });
                 // Any streamed refusal is terminal for this call, even alongside
                 // partial content — OpenAI's structured-output semantics (ported).
                 if (refusalText.length > 0) {
                     return fail("refusal", `OpenAI refused structured output: ${refusalText.slice(0, 200)}`, undefined, usage);
                 }
-                // Tool-call turn (spec §4.4): the model chose to call a tool. Surface
-                // the normalized calls; text may legitimately be empty — do NOT run the
-                // empty/suspicious-short/validation guards below.
-                const toolCalls = toolCallAcc.finalize();
                 if (toolCalls !== undefined) {
-                    return { ok: true, text, usage, toolCalls };
+                    return { ok: true, text, usage, toolCalls, meta: attemptMeta };
                 }
                 const visibleCompletionTokens = Math.max(0, completionTokens - reasoningTokens);
                 if (finishReason === "stop" &&
@@ -249,11 +276,13 @@ function createOpenAIAdapter(config) {
                 if (finishReason === "length" && req.outputSchema !== null) {
                     return fail("content_invalid", "OpenAI 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 } = classifyOpenAIFailure(message);
+                // WI-1: a transport/SDK error carries only its coarse status/code.
+                attemptMeta = (0, attempt_meta_map_1.transportErrorMeta)(error);
                 return {
                     ok: false,
                     failure: {
@@ -264,6 +293,7 @@ function createOpenAIAdapter(config) {
                         cause: error,
                         ...(fixHint !== undefined ? { fixHint } : {}),
                     },
+                    meta: attemptMeta,
                 };
             }
         },

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

@@ -20,6 +20,8 @@ const node_crypto_1 = require("node:crypto");
 const fingerprint_1 = require("../registry/fingerprint");
 const run_context_1 = require("./run-context");
 const scrub_1 = require("./scrub");
+const classification_1 = require("./classification");
+const task_settings_1 = require("../settings/task-settings");
 /** Map an artifact `type` to a content-type for the object store. */
 function contentTypeFor(type) {
     const t = type.toLowerCase();
@@ -171,6 +173,19 @@ function createArtifactApi(deps) {
             // `artifact.save` and the run/@step graph compose. Null outside a step (or
             // outside a run context), exactly as before.
             const stepKey = opts.stepKey ?? ctx?.currentStepKey() ?? null;
+            // S8-b: validate data_classification against the shared enum. A bad value
+            // would fail the DB CHECK (00058) and drop the row at ingest, so catch it
+            // here with a teaching warning and drop the LABEL (the artifact still
+            // saves — a metadata typo must not lose the artifact). Normalize first so
+            // "PHI"/" pii " keep their meaning (and their scrub floor) rather than
+            // silently dropping.
+            let classification = (0, classification_1.normalizeClassification)(opts.classification);
+            if (opts.classification !== undefined && classification !== null && !(0, classification_1.isDataClassification)(classification)) {
+                console.warn(`[modelrig artifacts] artifact "${opts.name}" has an unknown data_classification ` +
+                    `${JSON.stringify(opts.classification)} — label dropped (artifact still saved). ` +
+                    `fix_hint: use one of ${classification_1.DATA_CLASSIFICATIONS.join(", ")}.`);
+                classification = null;
+            }
             // Custody applies only when a rig content policy exists AND the caller left
             // the bytes to us (a caller-supplied contentRef = their own store; managed
             // custody must not double-home it).
@@ -178,8 +193,12 @@ function createArtifactApi(deps) {
             // Scrub is computed HERE (before the row is written) so its counts-only
             // summary can ride the immutable artifact row (00039). Only when custody
             // applies; null otherwise (custody off ⇒ nothing was scanned).
-            const scrubbed = custodyApplies && content !== undefined ? (0, scrub_1.scrubContent)(serialized, content.scrub) : null;
-            const scrubSummary = scrubbed !== null && content !== undefined ? (0, scrub_1.summarizeScrub)(content.scrub, scrubbed) : null;
+            // S8-c: a `pii`/`phi` artifact forces the scrub mode to a floor of
+            // `redact`, so PII/PHI content is never uploaded verbatim even when the
+            // task's configured mode is `off`/`detect`. A stronger `block` stays.
+            const effScrub = content !== undefined ? (0, task_settings_1.effectiveScrubMode)(content.scrub, classification) : null;
+            const scrubbed = custodyApplies && content !== undefined && effScrub !== null ? (0, scrub_1.scrubContent)(serialized, effScrub) : null;
+            const scrubSummary = scrubbed !== null && effScrub !== null ? (0, scrub_1.summarizeScrub)(effScrub, scrubbed) : null;
             if (scrubbed !== null)
                 scrubFindings += scrubbed.findings.reduce((n, f) => n + f.count, 0);
             try {
@@ -201,7 +220,7 @@ function createArtifactApi(deps) {
                     contentRef: opts.contentRef ?? null,
                     contentHash,
                     contentBytes: bytes,
-                    dataClassification: opts.classification ?? null,
+                    dataClassification: classification,
                     expiresAt: opts.expiresAt ?? null,
                     // Per-row scrub findings ride the original (scanned) row (00039).
                     scrub: scrubSummary,
@@ -236,7 +255,7 @@ function createArtifactApi(deps) {
                     console.warn(`[modelrig artifacts] scrub blocked content for "${opts.name}" ` +
                         `(${scrubbed.findings.length} finding type(s)); metadata + hash kept, no content stored.`);
                 }
-                else if (content.scrub === "redact" && scrubbed.findings.length > 0 && scrubbed.text !== null) {
+                else if (effScrub === "redact" && scrubbed.findings.length > 0 && scrubbed.text !== null) {
                     // Redaction is a SUPERSEDING version (immutability): the original row
                     // keeps its hash and stores NO content; a new version records the
                     // masked content's hash and uploads the masked bytes.
@@ -262,7 +281,7 @@ function createArtifactApi(deps) {
                             contentRef: null,
                             contentHash: maskedHash,
                             contentBytes: maskedBytes,
-                            dataClassification: opts.classification ?? null,
+                            dataClassification: classification,
                             expiresAt: opts.expiresAt ?? null,
                             // Findings ride the original scanned row; the masked version stores
                             // no PII, so its own scrub is null (avoid double-counting).

package/dist/artifacts/classification.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The `data_classification` enum — the ONE place the vocabulary is spelled
+ * (screening SC-0 S8). Backs three enforcement points that must agree:
+ *   • the SDK save gate (`artifact.ts` — teaching warn + drop on a bad value),
+ *   • the server ingest validator (`ingest-artifacts.ts` — enum-only, counted),
+ *   • the DB CHECK (`00058_artifacts_data_classification_enum.sql`).
+ * Keeping the list here (not re-spelled at each site) is what keeps the three
+ * from drifting; the migration and this constant are diffed by eye in review.
+ *
+ * `pii`/`phi` are the SENSITIVE tiers: an artifact tagged either resolves an
+ * effective scrub mode of at least `redact` regardless of the task's configured
+ * mode (S8-c, `settings/task-settings.ts effectiveScrubMode`). NULL stays a
+ * valid "unclassified" state — the column is nullable and the SDK sends null
+ * when no classification is given; the enum constrains only NON-null values.
+ */
+export declare const DATA_CLASSIFICATIONS: readonly ["public", "internal", "confidential", "pii", "phi"];
+export type DataClassification = (typeof DATA_CLASSIFICATIONS)[number];
+/** The tiers that force the scrub floor (S8-c). A set for O(1) membership. */
+export declare const SENSITIVE_CLASSIFICATIONS: ReadonlySet<string>;
+/** Normalize a caller-supplied classification the way both enforcement sides
+ * do BEFORE the enum check — trim and lowercase, so `"PHI"`/`" phi "` resolve to
+ * `phi` (and keep their scrub floor) rather than silently dropping. Non-strings
+ * return null. */
+export declare function normalizeClassification(value: unknown): string | null;
+/** True when `value` is one of the enum values (after normalization). */
+export declare function isDataClassification(value: unknown): value is DataClassification;
+//# sourceMappingURL=classification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classification.d.ts","sourceRoot":"","sources":["../../src/artifacts/classification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,oBAAoB,+DAAgE,CAAC;AAElG,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAA2B,CAAC;AAEtF;;;kBAGkB;AAClB,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIrE;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAGhF"}