@ai-matrx/agents 0.13.16 → 0.14.0

package/dist/presentation/decision-answers.d.cts

@@ -0,0 +1,113 @@
+/**
+ * Reading a `decision_answers` payload — THE ONE reader, shared by every
+ * surface that shows a decision (matrx-frontend's answers card, review queue,
+ * comparison table and text export; Workflow Studio's decision block).
+ *
+ * Contract: `common-docs/systems/agents/typed-messages/FEATURE.md`
+ * ("Kind `decision_answers`"). The reader is DEFENSIVE by design — a
+ * malformed answer is shown as unreadable, never coerced into a number that
+ * a person would then act on. A probability is a claim about the world; a
+ * silently-defaulted one is a lie with a bar chart next to it.
+ *
+ * Pure and framework-free: no React, no DOM, no host imports.
+ */
+declare const DECISION_ANSWERS_KIND: "decision_answers";
+/** How the probability was obtained. Never inferred — always stated. */
+type DecisionMethod = "native" | "verbalized" | "verbalized_calibrated";
+interface DecisionAnswerView {
+    name: string;
+    type: "noul" | "choice" | "score" | "unknown";
+    /** The answer verbatim: boolean, option name, or score. */
+    answer: boolean | string | number | null;
+    /**
+     * Yes/No only — probability that the answer is TRUE, verbatim from the
+     * payload. This is NOT the probability of the answer given: a `false`
+     * answer at `probability: 0.29` is a 71% No. Use `answerProbability` for
+     * the number that belongs beside the answer; this one is for the
+     * distribution and the author's threshold, both of which are stated on the
+     * true-probability scale.
+     */
+    probability: number | null;
+    /**
+     * The full distribution, option/level → probability. For Yes/No this is
+     * SYNTHESISED from `probability` (Yes p, No 1−p) so every type has one
+     * distribution shape and no surface has to derive the complement itself.
+     */
+    probabilities: Array<{
+        key: string;
+        label: string;
+        value: number;
+    }>;
+    /**
+     * The distribution key the ANSWER points at: the option for a choice, the
+     * MOST LIKELY level (the distribution's peak) for a score, `"true"`/`"false"`
+     * for a Yes/No. `null` when the answer is unreadable or no distribution was
+     * returned. A score's weighted number is shown as the number; its label and
+     * percentage come from the peak, so the headline and the bold bar below it
+     * are the same level (see `answerKeyFor`).
+     */
+    answerKey: string | null;
+    confidence: number | null;
+    /** Score only — level number → what that level means. */
+    legend: Record<string, string>;
+    /** The author's suggested cut, when the surface knows it. */
+    suggestedThreshold: number | null;
+    /** The question as asked, when the surface can supply it. */
+    instruction: string | null;
+}
+interface DecisionAnswersView {
+    model: string | null;
+    method: DecisionMethod | null;
+    answers: DecisionAnswerView[];
+    /** Questions the holder refused, with the reason it gave. */
+    refusals: Array<{
+        name: string;
+        reason: string;
+    }>;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    costUsd: number | null;
+}
+/** `null` when the value is not a decision_answers payload at all. */
+declare function readDecisionAnswers(value: unknown): DecisionAnswersView | null;
+/** How the answer reads on screen. Never invented — `null` stays unreadable. */
+declare function formatDecisionAnswer(answer: DecisionAnswerView): string;
+/**
+ * The answer in words, for a glance. A score reads as its peak level
+ * ("4 · down for someone"), never "2.3 — down for someone", which put the
+ * probability-weighted average and the peak level's name in one phrase. The
+ * average stays available on the view (`answer.answer`) for surfaces that show
+ * it as a secondary figure; the text export keeps `formatDecisionAnswer`.
+ */
+declare function formatAnswerHeadline(answer: DecisionAnswerView): string;
+/**
+ * The one number that belongs beside the answer: the probability OF THE
+ * ANSWER GIVEN, never the biggest number in the distribution and never the
+ * raw `probability` field.
+ *
+ * Two ways this used to lie, both live: a `noul` answered `false` at
+ * `probability: 0.3` printed "No 30%" when the model was 70% sure of No; and
+ * a score's label and percentage came from different levels. For a score the
+ * label is the peak level, so this is the peak's own probability — the label
+ * and the number always describe the same level.
+ */
+declare function answerProbability(answer: DecisionAnswerView): number | null;
+/** P(true) for a Yes/No — the scale the author's threshold is stated on. */
+declare function probabilityOfTrue(answer: DecisionAnswerView): number | null;
+declare const METHOD_LABELS: Record<DecisionMethod, string>;
+declare const METHOD_EXPLANATIONS: Record<DecisionMethod, string>;
+/**
+ * A decision turn as READABLE TEXT — for every surface that shows a run's
+ * result as a string instead of drawing the `DecisionAnswers` card: the toast
+ * preview, agent apps (their `response` string, public `/p/<slug>` included),
+ * a shortcut's `responseText` handed to its caller. A decision turn carries no
+ * text at all, so every one of those surfaces used to show nothing — or wait
+ * forever — over a paid, finished verdict.
+ *
+ * One line per answer, with the probability OF THE ANSWER GIVEN (never the raw
+ * P(true) a `false` answer carries), then the refusals with their reasons.
+ * `null` when the value is not a decision payload — never a guess.
+ */
+declare function decisionAnswersText(payload: unknown): string | null;
+
+export { DECISION_ANSWERS_KIND, type DecisionAnswerView, type DecisionAnswersView, type DecisionMethod, METHOD_EXPLANATIONS, METHOD_LABELS, answerProbability, decisionAnswersText, formatAnswerHeadline, formatDecisionAnswer, probabilityOfTrue, readDecisionAnswers };

package/dist/presentation/decision-answers.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Reading a `decision_answers` payload — THE ONE reader, shared by every
+ * surface that shows a decision (matrx-frontend's answers card, review queue,
+ * comparison table and text export; Workflow Studio's decision block).
+ *
+ * Contract: `common-docs/systems/agents/typed-messages/FEATURE.md`
+ * ("Kind `decision_answers`"). The reader is DEFENSIVE by design — a
+ * malformed answer is shown as unreadable, never coerced into a number that
+ * a person would then act on. A probability is a claim about the world; a
+ * silently-defaulted one is a lie with a bar chart next to it.
+ *
+ * Pure and framework-free: no React, no DOM, no host imports.
+ */
+declare const DECISION_ANSWERS_KIND: "decision_answers";
+/** How the probability was obtained. Never inferred — always stated. */
+type DecisionMethod = "native" | "verbalized" | "verbalized_calibrated";
+interface DecisionAnswerView {
+    name: string;
+    type: "noul" | "choice" | "score" | "unknown";
+    /** The answer verbatim: boolean, option name, or score. */
+    answer: boolean | string | number | null;
+    /**
+     * Yes/No only — probability that the answer is TRUE, verbatim from the
+     * payload. This is NOT the probability of the answer given: a `false`
+     * answer at `probability: 0.29` is a 71% No. Use `answerProbability` for
+     * the number that belongs beside the answer; this one is for the
+     * distribution and the author's threshold, both of which are stated on the
+     * true-probability scale.
+     */
+    probability: number | null;
+    /**
+     * The full distribution, option/level → probability. For Yes/No this is
+     * SYNTHESISED from `probability` (Yes p, No 1−p) so every type has one
+     * distribution shape and no surface has to derive the complement itself.
+     */
+    probabilities: Array<{
+        key: string;
+        label: string;
+        value: number;
+    }>;
+    /**
+     * The distribution key the ANSWER points at: the option for a choice, the
+     * MOST LIKELY level (the distribution's peak) for a score, `"true"`/`"false"`
+     * for a Yes/No. `null` when the answer is unreadable or no distribution was
+     * returned. A score's weighted number is shown as the number; its label and
+     * percentage come from the peak, so the headline and the bold bar below it
+     * are the same level (see `answerKeyFor`).
+     */
+    answerKey: string | null;
+    confidence: number | null;
+    /** Score only — level number → what that level means. */
+    legend: Record<string, string>;
+    /** The author's suggested cut, when the surface knows it. */
+    suggestedThreshold: number | null;
+    /** The question as asked, when the surface can supply it. */
+    instruction: string | null;
+}
+interface DecisionAnswersView {
+    model: string | null;
+    method: DecisionMethod | null;
+    answers: DecisionAnswerView[];
+    /** Questions the holder refused, with the reason it gave. */
+    refusals: Array<{
+        name: string;
+        reason: string;
+    }>;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    costUsd: number | null;
+}
+/** `null` when the value is not a decision_answers payload at all. */
+declare function readDecisionAnswers(value: unknown): DecisionAnswersView | null;
+/** How the answer reads on screen. Never invented — `null` stays unreadable. */
+declare function formatDecisionAnswer(answer: DecisionAnswerView): string;
+/**
+ * The answer in words, for a glance. A score reads as its peak level
+ * ("4 · down for someone"), never "2.3 — down for someone", which put the
+ * probability-weighted average and the peak level's name in one phrase. The
+ * average stays available on the view (`answer.answer`) for surfaces that show
+ * it as a secondary figure; the text export keeps `formatDecisionAnswer`.
+ */
+declare function formatAnswerHeadline(answer: DecisionAnswerView): string;
+/**
+ * The one number that belongs beside the answer: the probability OF THE
+ * ANSWER GIVEN, never the biggest number in the distribution and never the
+ * raw `probability` field.
+ *
+ * Two ways this used to lie, both live: a `noul` answered `false` at
+ * `probability: 0.3` printed "No 30%" when the model was 70% sure of No; and
+ * a score's label and percentage came from different levels. For a score the
+ * label is the peak level, so this is the peak's own probability — the label
+ * and the number always describe the same level.
+ */
+declare function answerProbability(answer: DecisionAnswerView): number | null;
+/** P(true) for a Yes/No — the scale the author's threshold is stated on. */
+declare function probabilityOfTrue(answer: DecisionAnswerView): number | null;
+declare const METHOD_LABELS: Record<DecisionMethod, string>;
+declare const METHOD_EXPLANATIONS: Record<DecisionMethod, string>;
+/**
+ * A decision turn as READABLE TEXT — for every surface that shows a run's
+ * result as a string instead of drawing the `DecisionAnswers` card: the toast
+ * preview, agent apps (their `response` string, public `/p/<slug>` included),
+ * a shortcut's `responseText` handed to its caller. A decision turn carries no
+ * text at all, so every one of those surfaces used to show nothing — or wait
+ * forever — over a paid, finished verdict.
+ *
+ * One line per answer, with the probability OF THE ANSWER GIVEN (never the raw
+ * P(true) a `false` answer carries), then the refusals with their reasons.
+ * `null` when the value is not a decision payload — never a guess.
+ */
+declare function decisionAnswersText(payload: unknown): string | null;
+
+export { DECISION_ANSWERS_KIND, type DecisionAnswerView, type DecisionAnswersView, type DecisionMethod, METHOD_EXPLANATIONS, METHOD_LABELS, answerProbability, decisionAnswersText, formatAnswerHeadline, formatDecisionAnswer, probabilityOfTrue, readDecisionAnswers };

package/dist/presentation/decision-answers.js

@@ -0,0 +1,174 @@
+// presentation/decision-answers.ts
+var DECISION_ANSWERS_KIND = "decision_answers";
+function record(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function finiteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function readMethod(value) {
+  return value === "native" || value === "verbalized" || value === "verbalized_calibrated" ? value : null;
+}
+function readDistribution(value, legend) {
+  const raw = record(value);
+  if (!raw) return [];
+  return Object.entries(raw).map(([key, probability]) => ({
+    key,
+    label: legend[key] ?? key,
+    value: finiteNumber(probability) ?? 0
+  })).sort((a, b) => b.value - a.value);
+}
+function readLegend(value) {
+  const raw = record(value);
+  if (!raw) return {};
+  const out = {};
+  for (const [key, entry] of Object.entries(raw)) {
+    if (typeof entry === "string") out[key] = entry;
+  }
+  return out;
+}
+function noulDistribution(probability) {
+  if (probability == null) return [];
+  return [
+    { key: "true", label: "Yes", value: probability },
+    { key: "false", label: "No", value: 1 - probability }
+  ].sort((a, b) => b.value - a.value);
+}
+function answerKeyFor(type, answer, probabilities) {
+  if (answer === null || probabilities.length === 0) return null;
+  if (typeof answer === "boolean") return answer ? "true" : "false";
+  if (typeof answer === "string") {
+    return probabilities.some((entry) => entry.key === answer) ? answer : null;
+  }
+  if (type === "choice") return null;
+  let best = null;
+  let bestValue = Number.NEGATIVE_INFINITY;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const entry of probabilities) {
+    const level = Number(entry.key);
+    if (!Number.isFinite(level)) continue;
+    const distance = Math.abs(level - answer);
+    if (entry.value > bestValue || entry.value === bestValue && distance < bestDistance) {
+      bestValue = entry.value;
+      bestDistance = distance;
+      best = entry.key;
+    }
+  }
+  return best;
+}
+function readAnswer(name, value) {
+  const raw = record(value);
+  const type = raw?.type === "noul" || raw?.type === "choice" || raw?.type === "score" ? raw.type : "unknown";
+  const legend = readLegend(raw?.legend);
+  const answerRaw = raw?.answer;
+  const answer = typeof answerRaw === "boolean" || typeof answerRaw === "string" || typeof answerRaw === "number" ? answerRaw : null;
+  const probability = finiteNumber(raw?.probability);
+  const probabilities = type === "noul" ? noulDistribution(probability) : readDistribution(raw?.probabilities, legend);
+  return {
+    name,
+    type,
+    answer,
+    probability,
+    probabilities,
+    answerKey: answerKeyFor(type, answer, probabilities),
+    confidence: finiteNumber(raw?.confidence),
+    legend,
+    suggestedThreshold: finiteNumber(raw?.suggested_threshold),
+    instruction: typeof raw?.instructions === "string" ? raw.instructions : null
+  };
+}
+function readDecisionAnswers(value) {
+  const raw = record(value);
+  if (!raw) return null;
+  const answers = record(raw.answers);
+  if (!answers) return null;
+  const unanswerable = record(raw.unanswerable);
+  const usage = record(raw.usage);
+  return {
+    model: typeof raw.model === "string" ? raw.model : null,
+    method: readMethod(raw.method),
+    answers: Object.entries(answers).map(
+      ([name, answer]) => readAnswer(name, answer)
+    ),
+    refusals: unanswerable ? Object.entries(unanswerable).map(([name, reason]) => ({
+      name,
+      reason: typeof reason === "string" && reason.trim() ? reason : "No reason was given."
+    })) : [],
+    inputTokens: finiteNumber(usage?.input_tokens),
+    outputTokens: finiteNumber(usage?.output_tokens),
+    costUsd: finiteNumber(raw.cost_usd)
+  };
+}
+function formatDecisionAnswer(answer) {
+  if (answer.answer === null) return "unreadable";
+  if (typeof answer.answer === "boolean") return answer.answer ? "Yes" : "No";
+  if (typeof answer.answer === "number") {
+    const shown = Number.isInteger(answer.answer) ? String(answer.answer) : answer.answer.toFixed(1);
+    const key = answer.answerKey;
+    const level = key == null ? void 0 : answer.legend[key];
+    return level ? `${shown} \u2014 ${level}` : shown;
+  }
+  return answer.answer;
+}
+function formatAnswerHeadline(answer) {
+  if (answer.type === "score" && typeof answer.answer === "number") {
+    const key = answer.answerKey;
+    const label = key == null ? void 0 : answer.legend[key];
+    if (label) return `${key} \xB7 ${label}`;
+  }
+  return formatDecisionAnswer(answer);
+}
+function answerProbability(answer) {
+  const key = answer.answerKey;
+  if (key != null) {
+    const entry = answer.probabilities.find((e) => e.key === key);
+    if (entry) return entry.value;
+  }
+  if (answer.type === "noul") return null;
+  if (answer.probability != null) return answer.probability;
+  return null;
+}
+function probabilityOfTrue(answer) {
+  return answer.type === "noul" ? answer.probability : null;
+}
+var METHOD_LABELS = {
+  native: "native",
+  verbalized: "verbalized",
+  verbalized_calibrated: "verbalized, calibrated"
+};
+var METHOD_EXPLANATIONS = {
+  native: "The model's own probability, read from its decision route \u2014 not something it wrote out in words.",
+  verbalized: "The model was asked for a probability and wrote one. It reads like a measurement but it is an opinion.",
+  verbalized_calibrated: "A written probability, corrected against this agent version's recorded ground-truth verdicts."
+};
+function decisionAnswersText(payload) {
+  const view = readDecisionAnswers(payload);
+  if (!view) return null;
+  const lines = [];
+  for (const answer of view.answers) {
+    const p = answerProbability(answer);
+    const shown = formatDecisionAnswer(answer);
+    lines.push(
+      `- ${answer.name}: ${shown}${p == null ? "" : ` (${Math.round(p * 100)}%)`}`
+    );
+  }
+  for (const refusal of view.refusals) {
+    lines.push(`- ${refusal.name}: not answered. ${refusal.reason}`);
+  }
+  if (lines.length === 0) lines.push("- No answers were returned.");
+  const how = view.method ? `${METHOD_LABELS[view.method]} probabilities` : "probabilities of unknown origin";
+  const header = `Decision (${how}${view.model ? `, ${view.model}` : ""})`;
+  return [header, ...lines].join("\n");
+}
+export {
+  DECISION_ANSWERS_KIND,
+  METHOD_EXPLANATIONS,
+  METHOD_LABELS,
+  answerProbability,
+  decisionAnswersText,
+  formatAnswerHeadline,
+  formatDecisionAnswer,
+  probabilityOfTrue,
+  readDecisionAnswers
+};
+//# sourceMappingURL=decision-answers.js.map

package/dist/presentation/decision-answers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../presentation/decision-answers.ts"],"sourcesContent":["/**\n * Reading a `decision_answers` payload — THE ONE reader, shared by every\n * surface that shows a decision (matrx-frontend's answers card, review queue,\n * comparison table and text export; Workflow Studio's decision block).\n *\n * Contract: `common-docs/systems/agents/typed-messages/FEATURE.md`\n * (\"Kind `decision_answers`\"). The reader is DEFENSIVE by design — a\n * malformed answer is shown as unreadable, never coerced into a number that\n * a person would then act on. A probability is a claim about the world; a\n * silently-defaulted one is a lie with a bar chart next to it.\n *\n * Pure and framework-free: no React, no DOM, no host imports.\n */\n\nexport const DECISION_ANSWERS_KIND = \"decision_answers\" as const;\n\n/** How the probability was obtained. Never inferred — always stated. */\nexport type DecisionMethod = \"native\" | \"verbalized\" | \"verbalized_calibrated\";\n\nexport interface DecisionAnswerView {\n  name: string;\n  type: \"noul\" | \"choice\" | \"score\" | \"unknown\";\n  /** The answer verbatim: boolean, option name, or score. */\n  answer: boolean | string | number | null;\n  /**\n   * Yes/No only — probability that the answer is TRUE, verbatim from the\n   * payload. This is NOT the probability of the answer given: a `false`\n   * answer at `probability: 0.29` is a 71% No. Use `answerProbability` for\n   * the number that belongs beside the answer; this one is for the\n   * distribution and the author's threshold, both of which are stated on the\n   * true-probability scale.\n   */\n  probability: number | null;\n  /**\n   * The full distribution, option/level → probability. For Yes/No this is\n   * SYNTHESISED from `probability` (Yes p, No 1−p) so every type has one\n   * distribution shape and no surface has to derive the complement itself.\n   */\n  probabilities: Array<{ key: string; label: string; value: number }>;\n  /**\n   * The distribution key the ANSWER points at: the option for a choice, the\n   * MOST LIKELY level (the distribution's peak) for a score, `\"true\"`/`\"false\"`\n   * for a Yes/No. `null` when the answer is unreadable or no distribution was\n   * returned. A score's weighted number is shown as the number; its label and\n   * percentage come from the peak, so the headline and the bold bar below it\n   * are the same level (see `answerKeyFor`).\n   */\n  answerKey: string | null;\n  confidence: number | null;\n  /** Score only — level number → what that level means. */\n  legend: Record<string, string>;\n  /** The author's suggested cut, when the surface knows it. */\n  suggestedThreshold: number | null;\n  /** The question as asked, when the surface can supply it. */\n  instruction: string | null;\n}\n\nexport interface DecisionAnswersView {\n  model: string | null;\n  method: DecisionMethod | null;\n  answers: DecisionAnswerView[];\n  /** Questions the holder refused, with the reason it gave. */\n  refusals: Array<{ name: string; reason: string }>;\n  inputTokens: number | null;\n  outputTokens: number | null;\n  costUsd: number | null;\n}\n\nfunction record(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nfunction finiteNumber(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null;\n}\n\nfunction readMethod(value: unknown): DecisionMethod | null {\n  return value === \"native\" ||\n    value === \"verbalized\" ||\n    value === \"verbalized_calibrated\"\n    ? value\n    : null;\n}\n\nfunction readDistribution(\n  value: unknown,\n  legend: Record<string, string>,\n): Array<{ key: string; label: string; value: number }> {\n  const raw = record(value);\n  if (!raw) return [];\n  return Object.entries(raw)\n    .map(([key, probability]) => ({\n      key,\n      label: legend[key] ?? key,\n      value: finiteNumber(probability) ?? 0,\n    }))\n    .sort((a, b) => b.value - a.value);\n}\n\nfunction readLegend(value: unknown): Record<string, string> {\n  const raw = record(value);\n  if (!raw) return {};\n  const out: Record<string, string> = {};\n  for (const [key, entry] of Object.entries(raw)) {\n    if (typeof entry === \"string\") out[key] = entry;\n  }\n  return out;\n}\n\n/**\n * Yes/No as a two-entry distribution. `probability` is P(true), so No is its\n * complement — the one place that subtraction happens.\n */\nfunction noulDistribution(\n  probability: number | null,\n): Array<{ key: string; label: string; value: number }> {\n  if (probability == null) return [];\n  return [\n    { key: \"true\", label: \"Yes\", value: probability },\n    { key: \"false\", label: \"No\", value: 1 - probability },\n  ].sort((a, b) => b.value - a.value);\n}\n\n/**\n * The distribution entry the answer points at.\n *\n * A score is a probability-weighted number BETWEEN levels (2.9 on a\n * five-level scale). Its headline used to take the label of the level NEAREST\n * that number, which on a spread distribution read as a contradiction:\n * \"urgency 2.9 — data or money at risk 16%\" printed above bars led by\n * \"a feature is blocked 46%\". The label now names the MOST LIKELY level — the\n * peak — with the peak's own probability, while the weighted score stays the\n * number (Arman's ruling via the owning session, 2026-09-23). A tie on the\n * peak goes to the level nearest the weighted score, so the choice is stable.\n * Keys are compared as numbers, never by an assumed 0- or 1-based index.\n */\nfunction answerKeyFor(\n  type: DecisionAnswerView[\"type\"],\n  answer: boolean | string | number | null,\n  probabilities: Array<{ key: string; label: string; value: number }>,\n): string | null {\n  if (answer === null || probabilities.length === 0) return null;\n  if (typeof answer === \"boolean\") return answer ? \"true\" : \"false\";\n  if (typeof answer === \"string\") {\n    return probabilities.some((entry) => entry.key === answer) ? answer : null;\n  }\n  if (type === \"choice\") return null;\n  let best: string | null = null;\n  let bestValue = Number.NEGATIVE_INFINITY;\n  let bestDistance = Number.POSITIVE_INFINITY;\n  for (const entry of probabilities) {\n    const level = Number(entry.key);\n    if (!Number.isFinite(level)) continue;\n    const distance = Math.abs(level - answer);\n    if (\n      entry.value > bestValue ||\n      (entry.value === bestValue && distance < bestDistance)\n    ) {\n      bestValue = entry.value;\n      bestDistance = distance;\n      best = entry.key;\n    }\n  }\n  return best;\n}\n\nfunction readAnswer(name: string, value: unknown): DecisionAnswerView {\n  const raw = record(value);\n  const type =\n    raw?.type === \"noul\" || raw?.type === \"choice\" || raw?.type === \"score\"\n      ? raw.type\n      : \"unknown\";\n  const legend = readLegend(raw?.legend);\n  const answerRaw = raw?.answer;\n  const answer =\n    typeof answerRaw === \"boolean\" ||\n    typeof answerRaw === \"string\" ||\n    typeof answerRaw === \"number\"\n      ? answerRaw\n      : null;\n  const probability = finiteNumber(raw?.probability);\n  const probabilities =\n    type === \"noul\"\n      ? noulDistribution(probability)\n      : readDistribution(raw?.probabilities, legend);\n  return {\n    name,\n    type,\n    answer,\n    probability,\n    probabilities,\n    answerKey: answerKeyFor(type, answer, probabilities),\n    confidence: finiteNumber(raw?.confidence),\n    legend,\n    suggestedThreshold: finiteNumber(raw?.suggested_threshold),\n    instruction:\n      typeof raw?.instructions === \"string\"\n        ? (raw.instructions as string)\n        : null,\n  };\n}\n\n/** `null` when the value is not a decision_answers payload at all. */\nexport function readDecisionAnswers(\n  value: unknown,\n): DecisionAnswersView | null {\n  const raw = record(value);\n  if (!raw) return null;\n  const answers = record(raw.answers);\n  if (!answers) return null;\n\n  const unanswerable = record(raw.unanswerable);\n  const usage = record(raw.usage);\n\n  return {\n    model: typeof raw.model === \"string\" ? raw.model : null,\n    method: readMethod(raw.method),\n    answers: Object.entries(answers).map(([name, answer]) =>\n      readAnswer(name, answer),\n    ),\n    refusals: unanswerable\n      ? Object.entries(unanswerable).map(([name, reason]) => ({\n          name,\n          reason:\n            typeof reason === \"string\" && reason.trim()\n              ? reason\n              : \"No reason was given.\",\n        }))\n      : [],\n    inputTokens: finiteNumber(usage?.input_tokens),\n    outputTokens: finiteNumber(usage?.output_tokens),\n    costUsd: finiteNumber(raw.cost_usd),\n  };\n}\n\n/** How the answer reads on screen. Never invented — `null` stays unreadable. */\nexport function formatDecisionAnswer(answer: DecisionAnswerView): string {\n  if (answer.answer === null) return \"unreadable\";\n  if (typeof answer.answer === \"boolean\") return answer.answer ? \"Yes\" : \"No\";\n  if (typeof answer.answer === \"number\") {\n    const shown = Number.isInteger(answer.answer)\n      ? String(answer.answer)\n      : answer.answer.toFixed(1);\n    const key = answer.answerKey;\n    const level = key == null ? undefined : answer.legend[key];\n    return level ? `${shown} — ${level}` : shown;\n  }\n  return answer.answer;\n}\n\n/**\n * The answer in words, for a glance. A score reads as its peak level\n * (\"4 · down for someone\"), never \"2.3 — down for someone\", which put the\n * probability-weighted average and the peak level's name in one phrase. The\n * average stays available on the view (`answer.answer`) for surfaces that show\n * it as a secondary figure; the text export keeps `formatDecisionAnswer`.\n */\nexport function formatAnswerHeadline(answer: DecisionAnswerView): string {\n  if (answer.type === \"score\" && typeof answer.answer === \"number\") {\n    const key = answer.answerKey;\n    const label = key == null ? undefined : answer.legend[key];\n    if (label) return `${key} · ${label}`;\n  }\n  return formatDecisionAnswer(answer);\n}\n\n/**\n * The one number that belongs beside the answer: the probability OF THE\n * ANSWER GIVEN, never the biggest number in the distribution and never the\n * raw `probability` field.\n *\n * Two ways this used to lie, both live: a `noul` answered `false` at\n * `probability: 0.3` printed \"No 30%\" when the model was 70% sure of No; and\n * a score's label and percentage came from different levels. For a score the\n * label is the peak level, so this is the peak's own probability — the label\n * and the number always describe the same level.\n */\nexport function answerProbability(answer: DecisionAnswerView): number | null {\n  const key = answer.answerKey;\n  if (key != null) {\n    const entry = answer.probabilities.find((e) => e.key === key);\n    if (entry) return entry.value;\n  }\n  if (answer.type === \"noul\") return null;\n  if (answer.probability != null) return answer.probability;\n  return null;\n}\n\n/** P(true) for a Yes/No — the scale the author's threshold is stated on. */\nexport function probabilityOfTrue(answer: DecisionAnswerView): number | null {\n  return answer.type === \"noul\" ? answer.probability : null;\n}\n\nexport const METHOD_LABELS: Record<DecisionMethod, string> = {\n  native: \"native\",\n  verbalized: \"verbalized\",\n  verbalized_calibrated: \"verbalized, calibrated\",\n};\n\nexport const METHOD_EXPLANATIONS: Record<DecisionMethod, string> = {\n  native:\n    \"The model's own probability, read from its decision route — not something it wrote out in words.\",\n  verbalized:\n    \"The model was asked for a probability and wrote one. It reads like a measurement but it is an opinion.\",\n  verbalized_calibrated:\n    \"A written probability, corrected against this agent version's recorded ground-truth verdicts.\",\n};\n\n/**\n * A decision turn as READABLE TEXT — for every surface that shows a run's\n * result as a string instead of drawing the `DecisionAnswers` card: the toast\n * preview, agent apps (their `response` string, public `/p/<slug>` included),\n * a shortcut's `responseText` handed to its caller. A decision turn carries no\n * text at all, so every one of those surfaces used to show nothing — or wait\n * forever — over a paid, finished verdict.\n *\n * One line per answer, with the probability OF THE ANSWER GIVEN (never the raw\n * P(true) a `false` answer carries), then the refusals with their reasons.\n * `null` when the value is not a decision payload — never a guess.\n */\nexport function decisionAnswersText(payload: unknown): string | null {\n  const view = readDecisionAnswers(payload);\n  if (!view) return null;\n  const lines: string[] = [];\n  for (const answer of view.answers) {\n    const p = answerProbability(answer);\n    const shown = formatDecisionAnswer(answer);\n    lines.push(\n      `- ${answer.name}: ${shown}${p == null ? \"\" : ` (${Math.round(p * 100)}%)`}`,\n    );\n  }\n  for (const refusal of view.refusals) {\n    lines.push(`- ${refusal.name}: not answered. ${refusal.reason}`);\n  }\n  if (lines.length === 0) lines.push(\"- No answers were returned.\");\n  const how = view.method\n    ? `${METHOD_LABELS[view.method]} probabilities`\n    : \"probabilities of unknown origin\";\n  const header = `Decision (${how}${view.model ? `, ${view.model}` : \"\"})`;\n  return [header, ...lines].join(\"\\n\");\n}\n"],"mappings":"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","names":[]}