@broberg/ai-sdk 0.41.1 → 0.42.0

package/dist/index.d.ts

@@ -608,8 +608,28 @@ interface ClassifyInput {
     purpose?: string;
 }
 interface ClassifyResult {
-    label: string;
-    confidence: number;
+    /** The chosen label, or `null` when the model named a label that is not in `labels`
+     *  (F052).
+     *
+     *  MEASURED, not taken from the report: a reply with no JSON in it at all already
+     *  THREW (`parseJsonLoose`), and still does. So the silent fallback only ever fired on
+     *  a *parseable* answer naming an unknown label — a narrower hole than reported, and
+     *  the more dangerous half, because that answer looks like a real classification.
+     *
+     *  Until 0.41.1 this fell back to `labels[0]`, so "the model chose the first one" and
+     *  "the model could not answer" were the SAME VALUE at the call site. helpdesk routes
+     *  an autonomy level off this field — an unclassifiable ticket therefore landed on the
+     *  tenant's first intent, chosen by the order of a config array, with no error and no
+     *  log trace. `null` is the whole fix: there is no field to hardcode, because the
+     *  absence IS the signal. */
+    label: string | null;
+    /** The model's own answer when it did not match, so a caller can log or route what
+     *  actually came back instead of only knowing that something did not. */
+    rawLabel?: string;
+    /** `null` when the model reported no confidence. `0` is a REAL confidence and stays
+     *  `0` — the two used to be the same number, which made the field unusable as a
+     *  signal even for a caller who wanted to check it. */
+    confidence: number | null;
     usage: Usage;
 }
 interface RerankInput {
@@ -619,10 +639,18 @@ interface RerankInput {
     purpose?: string;
 }
 interface RerankResult {
+    /** Every entry is an item FROM `input.items` with a real numeric score. Items the
+     *  model invented are dropped; items it failed to score are named in `unscored`. */
     ranked: {
         item: string;
         score: number;
     }[];
+    /** Input items the model returned no usable score for. Empty on a clean answer.
+     *
+     *  Not an error — but a caller treating `ranked` as complete must look here (F052).
+     *  A missing item used to become `""` with score `0`, i.e. a plausible-looking entry
+     *  ranked last. */
+    unscored: string[];
     usage: Usage;
 }
 interface Contracts {
@@ -2338,8 +2366,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.41.1";
-declare const SDK_TAG: "@broberg/ai-sdk@0.41.1";
+declare const VERSION: "0.42.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.42.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.

package/dist/index.js

@@ -2694,9 +2694,14 @@ ${input.text}`,
         purpose: input.purpose ?? "contract:classify"
       });
       const parsed = parseJsonLoose(res.text);
-      const label = input.labels.includes(parsed.label ?? "") ? parsed.label : input.labels[0] ?? "";
-      const confidence = typeof parsed.confidence === "number" ? parsed.confidence : 0;
-      return { label, confidence, usage: res.usage };
+      const matched = typeof parsed.label === "string" && input.labels.includes(parsed.label);
+      return {
+        label: matched ? parsed.label : null,
+        ...matched ? {} : { rawLabel: typeof parsed.label === "string" ? parsed.label : res.text.slice(0, 200) },
+        // 0 is a real confidence; "no confidence reported" is not 0.
+        confidence: typeof parsed.confidence === "number" ? parsed.confidence : null,
+        usage: res.usage
+      };
     },
     async rerank(input) {
       const res = await client.chat({
@@ -2709,8 +2714,20 @@ ${JSON.stringify(input.items)}`,
         purpose: input.purpose ?? "contract:rerank"
       });
       const raw = parseJsonLoose(res.text);
-      const ranked = (Array.isArray(raw) ? raw : []).map((r) => ({ item: String(r.item ?? ""), score: typeof r.score === "number" ? r.score : 0 })).sort((a, b) => b.score - a.score);
-      return { ranked, usage: res.usage };
+      if (!Array.isArray(raw)) {
+        throw new Error(
+          `ai.contracts.rerank: the model did not return a JSON array. Got: ${res.text.slice(0, 200)}${res.text.length > 200 ? "\u2026" : ""}`
+        );
+      }
+      const scored = /* @__PURE__ */ new Map();
+      for (const r of raw) {
+        if (typeof r?.item !== "string" || !input.items.includes(r.item)) continue;
+        if (typeof r?.score !== "number") continue;
+        if (!scored.has(r.item)) scored.set(r.item, r.score);
+      }
+      const ranked = [...scored].map(([item, score]) => ({ item, score })).sort((a, b) => b.score - a.score);
+      const unscored = input.items.filter((i) => !scored.has(i));
+      return { ranked, unscored, usage: res.usage };
     }
   };
 }
@@ -3093,8 +3110,8 @@ var aiConfigSchema = z.object({
 });
 
 // src/version.ts
-var VERSION = "0.41.1";
-var SDK_TAG = "@broberg/ai-sdk@0.41.1";
+var VERSION = "0.42.0";
+var SDK_TAG = "@broberg/ai-sdk@0.42.0";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {