agentfootprint-lens 0.32.0 → 0.33.1

package/dist/{chunk-QBSH233H.js → chunk-6EHPI5F6.js}

@@ -1552,8 +1552,159 @@ import {
   renderCommentary,
   selectCommentaryKey
 } from "agentfootprint";
+
+// src/core/humanizeRouting.ts
+function fmtScore(n) {
+  return String(Number(n.toFixed(2)));
+}
+function fmtShare(n) {
+  return `${Math.round(n * 100)}%`;
+}
+function quoteList(ids) {
+  return ids.join(", ");
+}
+function q(id) {
+  return id === void 0 ? void 0 : `"${id}"`;
+}
+function movement(p) {
+  const { from, to } = p;
+  if (to !== void 0 && from !== void 0) {
+    return from === to ? `Stayed in ${q(to)}` : `Moved from ${q(from)} to ${q(to)}`;
+  }
+  if (to !== void 0) return `Turn started in ${q(to)}`;
+  if (from !== void 0) return `Stayed in ${q(from)}`;
+  return "The turn was routed";
+}
+function droppedResumeNote(p) {
+  const d = p.droppedResume;
+  if (!d) return "";
+  return ` The conversation's saved place (${q(d.id)}) no longer exists in this deployment.`;
+}
+function humanizeTurnRouted(p) {
+  switch (p.by) {
+    case "entry":
+    case "rule":
+      return `${movement(p)} \u2014 a rule matched (tier 1).${droppedResumeNote(p)}`;
+    case "intent": {
+      const winner = p.scores?.[0];
+      const ruRow = p.runnerUp && p.scores ? p.scores.find((s) => s.id === p.runnerUp.id) : void 0;
+      let clause = " \u2014 intent";
+      if (winner) {
+        clause += ` scored ${fmtScore(winner.score)}`;
+        if (ruRow) clause += ` vs ${fmtScore(ruRow.score)} for runner-up ${q(ruRow.id)}`;
+        else if (p.runnerUp)
+          clause += `, ${fmtScore(p.runnerUp.gap)} ahead of ${q(p.runnerUp.id)}`;
+      } else {
+        clause += " matched";
+      }
+      const scorer = p.scorer ? ` (${p.scorer} scorer)` : "";
+      return `${movement(p)}${clause}${scorer}.${droppedResumeNote(p)}`;
+    }
+    case "continuity": {
+      const nearTie = p.decisive === false && p.scores && p.scores.length >= 2;
+      if (nearTie) {
+        const [a, b] = p.scores;
+        const where2 = p.to ?? p.from;
+        const tail = where2 !== void 0 ? `; continuing in ${q(where2)}` : "";
+        return `Stayed \u2014 near-tie between ${q(a.id)} (${fmtShare(a.relevance)}) and ${q(b.id)} (${fmtShare(b.relevance)})${tail}.${droppedResumeNote(p)}`;
+      }
+      const where = p.to ?? p.from;
+      const head = where !== void 0 ? `Stayed in ${q(where)}` : "Stayed";
+      return `${head} \u2014 treated as a continuation of the conversation.${droppedResumeNote(p)}`;
+    }
+    case "menu":
+    case "model-pick": {
+      let line = "No single skill won \u2014 the model was offered a menu";
+      if (p.offered && p.offered.length > 0)
+        line += ` of ${p.offered.length}: ${quoteList(p.offered)}`;
+      if (p.stayOffered) line += `; 'stay' was on the menu`;
+      return `${line}.${droppedResumeNote(p)}`;
+    }
+    case "none": {
+      if (p.droppedResume) {
+        let line = `The conversation's saved place (${q(p.droppedResume.id)}) no longer exists in this deployment \u2014 the turn started fresh.`;
+        if (p.offered && p.offered.length > 0)
+          line += ` Options on the record: ${quoteList(p.offered)}.`;
+        return line;
+      }
+      if (p.offered && p.offered.length > 0) {
+        const top = p.scores?.[0]?.score;
+        const floor = p.policy?.floor;
+        const cleared = top !== void 0 && Number.isFinite(top) && (floor === void 0 || top > floor);
+        if (p.decisive === false && (p.scores?.length ?? 0) >= 2 && cleared) {
+          return `This message matched ${quoteList(p.offered)} too closely to call, and rails mode does not let the model break the tie \u2014 the turn ran on the base prompt.`;
+        }
+        if (top !== void 0 && !cleared) {
+          return `No rule or intent matched this message strongly enough, and rails mode does not let the model route \u2014 the turn ran on the base prompt. The full menu stayed on the record: ${quoteList(p.offered)}.`;
+        }
+        return `Routing ended in a menu, but rails mode does not let the model route \u2014 the turn ran on the base prompt. On the record: ${quoteList(p.offered)}.`;
+      }
+      return "Routing decided nothing this turn \u2014 the turn ran on the base prompt.";
+    }
+    default:
+      return `Turn routing: ${p.by}${p.to !== void 0 ? ` \u2192 ${q(p.to)}` : ""}.`;
+  }
+}
+var COUNT_WORDS = ["Zero", "One", "Two", "Three", "Four", "Five"];
+function humanizeRouteConflict(p) {
+  const winner = p.winner;
+  const losers = p.losers ?? [];
+  const winnerClause = winner ? `${winner.toolName ?? "a tool"} \u2192 ${q(winner.target) ?? "its target"} won (first in the batch)` : "the first match in the batch won";
+  if (losers.length === 0) {
+    return `Tool results conflicted on the next skill \u2014 ${winnerClause}.`;
+  }
+  const count = losers.length + 1;
+  const countWord = count < COUNT_WORDS.length ? COUNT_WORDS[count] : String(count);
+  const loserClause = losers.map((l) => `${l.toolName ?? "a tool"} \u2192 ${q(l.target) ?? "another skill"}`).join(", ");
+  const verb = losers.length === 1 ? "was" : "were";
+  return `${countWord} tool results wanted different next skills \u2014 ${winnerClause}; ${loserClause} ${verb} suppressed and ${losers.length === 1 ? "is" : "are"} on the record.`;
+}
+function humanizeSkillRejected(p) {
+  const pick = `The model tried to switch to ${q(p.requestedId)}`;
+  if (p.posture === "guard") {
+    let line2 = `${pick}, but that pick was off the menu it was given \u2014 refused (guard).`;
+    if (p.allowed && p.allowed.length > 0) line2 += ` Reachable: ${quoteList(p.allowed)}.`;
+    return line2;
+  }
+  if (p.posture === "rails") {
+    return `${pick}, but rails mode does not let the model route \u2014 refused.`;
+  }
+  const at = p.currentSkillId !== void 0 ? q(p.currentSkillId) : "the start";
+  let line = `${pick}, but it is not reachable from ${at} \u2014 refused.`;
+  if (p.allowed && p.allowed.length > 0) line += ` Reachable: ${quoteList(p.allowed)}.`;
+  return line;
+}
+function humanizeCursorMovePick(move) {
+  if (!move || move.by !== "model-pick") return null;
+  if (move.offered === void 0 && move.declinedOffer === void 0) return null;
+  let line = move.to !== void 0 ? `The model chose ${q(move.to)}` : "The model made a pick";
+  if (move.offered !== void 0 && move.declinedOffer !== true) {
+    line += ` from a ${move.offered.length}-item menu`;
+    const rest = move.to !== void 0 ? move.offered.filter((id) => id !== move.to) : move.offered;
+    if (rest.length > 0) line += ` (${quoteList(rest)} were offered too)`;
+  }
+  if (move.from !== void 0 && move.from !== move.to) {
+    line += `, moving from ${q(move.from)}`;
+  }
+  line += ".";
+  if (move.declinedOffer === true) {
+    line += " Its pick was not on the offered menu \u2014 the divergence is on the record.";
+  }
+  return line;
+}
+
+// src/core/humanizer.ts
 var defaultHumanizer = (event) => {
-  if (event.type === "agentfootprint.context.evaluated") return null;
+  if (event.type === "agentfootprint.context.evaluated") {
+    const cursorMove = event.payload.cursorMove;
+    return humanizeCursorMovePick(cursorMove);
+  }
+  if (event.type === "agentfootprint.skill.turn_routed") {
+    return humanizeTurnRouted(event.payload);
+  }
+  if (event.type === "agentfootprint.skill.route_conflict") {
+    return humanizeRouteConflict(event.payload);
+  }
   switch (event.type) {
     // Composition
     case "agentfootprint.composition.enter":
@@ -1637,6 +1788,8 @@ var defaultHumanizer = (event) => {
       return `Skill "${event.payload.skillId}" activated \u2014 ${event.payload.reason}.`;
     case "agentfootprint.skill.deactivated":
       return `Skill "${event.payload.skillId}" deactivated \u2014 ${event.payload.reason}.`;
+    case "agentfootprint.skill.rejected":
+      return humanizeSkillRejected(event.payload);
     // Error
     case "agentfootprint.error.fatal":
       return `\u26D4 The run failed \u2014 ${event.payload.error}`;
@@ -2525,20 +2678,20 @@ function expandSubflowInternals(subflows) {
     replayWalkInto(subRec, walkSubflowSpec(spec, path, { recurse: false }));
     const sub = subTrace.getGraph();
     const prefix = path.endsWith("/") ? path : `${path}/`;
-    const q = (id) => id.startsWith(prefix) ? id : `${prefix}${id}`;
+    const q2 = (id) => id.startsWith(prefix) ? id : `${prefix}${id}`;
     for (const n of sub.nodes) {
       nodes.push({
         ...n,
-        id: q(n.id),
+        id: q2(n.id),
         data: { ...n.data, subflowOf: subflowId }
       });
     }
     for (const e of sub.edges) {
       edges.push({
         ...e,
-        id: `${q(e.source)}->${q(e.target)}`,
-        source: q(e.source),
-        target: q(e.target)
+        id: `${q2(e.source)}->${q2(e.target)}`,
+        source: q2(e.source),
+        target: q2(e.target)
       });
     }
   }
@@ -3055,4 +3208,4 @@ export {
   buildNewIssueUrl,
   encodeBase64
 };
-//# sourceMappingURL=chunk-QBSH233H.js.map
+//# sourceMappingURL=chunk-6EHPI5F6.js.map