@tangle-network/agent-eval 0.109.1 → 0.110.1

package/dist/chunk-KMPRBJK4.js

@@ -1,74 +0,0 @@
-import {
-  buildTrajectory
-} from "./chunk-RZTMDUO7.js";
-import {
-  isLlmSpan,
-  isToolSpan
-} from "./chunk-5BKGXME7.js";
-
-// src/prm/training-export.ts
-async function exportTrainingData(store, graded, options = {}) {
-  const window = options.contextWindow ?? 5;
-  const out = [];
-  for (const g of graded) {
-    const trajectory = await buildTrajectory(store, g.runId);
-    const spanById = new Map(trajectory.steps.map((s) => [s.span.spanId, s]));
-    for (const gs of g.steps) {
-      const node = spanById.get(gs.spanId);
-      if (!node) continue;
-      const idx = trajectory.steps.indexOf(node);
-      const priorSpans = trajectory.steps.slice(Math.max(0, idx - window), idx).map((s) => s.span);
-      out.push({
-        runId: g.runId,
-        spanId: gs.spanId,
-        rubricId: gs.rubricId,
-        score: gs.score,
-        context: {
-          priorTurns: priorSpans.map(spanToTurn).filter((t) => t !== null),
-          step: { kind: node.span.kind, text: spanToText(node.span) }
-        },
-        rationale: gs.rationale,
-        evidence: gs.evidence
-      });
-    }
-  }
-  return out;
-}
-function toNdjson(samples) {
-  return `${samples.map((s) => JSON.stringify(s)).join("\n")}
-`;
-}
-function spanToTurn(span) {
-  if (isLlmSpan(span)) {
-    const text = span.output ?? span.messages.map((m) => `${m.role}: ${m.content}`).join("\n");
-    return { role: "assistant", content: text };
-  }
-  if (isToolSpan(span)) {
-    return {
-      role: "tool",
-      content: `${span.toolName}(${safeStringify(span.args)}) \u2192 ${safeStringify(span.result)}`
-    };
-  }
-  return null;
-}
-function spanToText(span) {
-  if (isLlmSpan(span)) return span.output ?? "";
-  if (isToolSpan(span))
-    return `${span.toolName}(${safeStringify(span.args)}) \u2192 ${safeStringify(span.result)}`;
-  return span.name;
-}
-function safeStringify(v) {
-  if (v === null || v === void 0) return "";
-  if (typeof v === "string") return v;
-  try {
-    return JSON.stringify(v);
-  } catch {
-    return String(v);
-  }
-}
-
-export {
-  exportTrainingData,
-  toNdjson
-};
-//# sourceMappingURL=chunk-KMPRBJK4.js.map

package/dist/chunk-KMPRBJK4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/prm/training-export.ts"],"sourcesContent":["/**\n * Export PRM-graded traces as training data for downstream reward-model\n * fine-tuning. Canonical format is NDJSON of\n * `{ trajectory_text, step_index, rubric, score }` so a small model can\n * learn to predict step rewards from step context.\n *\n * The framework doesn't train the model — we emit the data; callers\n * plug it into their preferred trainer (TRL, Unsloth, custom).\n */\n\nimport type { LlmSpan, Span } from '../trace/schema'\nimport { isLlmSpan, isToolSpan } from '../trace/schema'\nimport type { TraceStore } from '../trace/store'\nimport { buildTrajectory } from '../trajectory'\nimport type { PrmGradedTrace } from './rubric'\n\nexport interface PrmTrainingSample {\n  runId: string\n  spanId: string\n  rubricId: string\n  score: number\n  /** Serialized step context — step + surrounding conversation. */\n  context: {\n    priorTurns: Array<{ role: string; content: string }>\n    step: { kind: Span['kind']; text: string }\n  }\n  /** Optional evidence + rationale for auditability. */\n  rationale?: string\n  evidence?: string\n}\n\nexport async function exportTrainingData(\n  store: TraceStore,\n  graded: PrmGradedTrace[],\n  options: { contextWindow?: number } = {},\n): Promise<PrmTrainingSample[]> {\n  const window = options.contextWindow ?? 5\n  const out: PrmTrainingSample[] = []\n  for (const g of graded) {\n    const trajectory = await buildTrajectory(store, g.runId)\n    const spanById = new Map(trajectory.steps.map((s) => [s.span.spanId, s]))\n    for (const gs of g.steps) {\n      const node = spanById.get(gs.spanId)\n      if (!node) continue\n      const idx = trajectory.steps.indexOf(node)\n      const priorSpans = trajectory.steps.slice(Math.max(0, idx - window), idx).map((s) => s.span)\n      out.push({\n        runId: g.runId,\n        spanId: gs.spanId,\n        rubricId: gs.rubricId,\n        score: gs.score,\n        context: {\n          priorTurns: priorSpans\n            .map(spanToTurn)\n            .filter((t): t is { role: string; content: string } => t !== null),\n          step: { kind: node.span.kind, text: spanToText(node.span) },\n        },\n        rationale: gs.rationale,\n        evidence: gs.evidence,\n      })\n    }\n  }\n  return out\n}\n\n/** NDJSON serialization — write to file or stream directly to a trainer. */\nexport function toNdjson(samples: PrmTrainingSample[]): string {\n  return `${samples.map((s) => JSON.stringify(s)).join('\\n')}\\n`\n}\n\nfunction spanToTurn(span: Span): { role: string; content: string } | null {\n  if (isLlmSpan(span)) {\n    const text = span.output ?? span.messages.map((m) => `${m.role}: ${m.content}`).join('\\n')\n    return { role: 'assistant', content: text }\n  }\n  if (isToolSpan(span)) {\n    return {\n      role: 'tool',\n      content: `${span.toolName}(${safeStringify(span.args)}) → ${safeStringify(span.result)}`,\n    }\n  }\n  return null\n}\n\nfunction spanToText(span: Span): string {\n  if (isLlmSpan(span)) return (span as LlmSpan).output ?? ''\n  if (isToolSpan(span))\n    return `${span.toolName}(${safeStringify(span.args)}) → ${safeStringify(span.result)}`\n  return span.name\n}\n\nfunction safeStringify(v: unknown): string {\n  if (v === null || v === undefined) return ''\n  if (typeof v === 'string') return v\n  try {\n    return JSON.stringify(v)\n  } catch {\n    return String(v)\n  }\n}\n"],"mappings":";;;;;;;;;AA+BA,eAAsB,mBACpB,OACA,QACA,UAAsC,CAAC,GACT;AAC9B,QAAM,SAAS,QAAQ,iBAAiB;AACxC,QAAM,MAA2B,CAAC;AAClC,aAAW,KAAK,QAAQ;AACtB,UAAM,aAAa,MAAM,gBAAgB,OAAO,EAAE,KAAK;AACvD,UAAM,WAAW,IAAI,IAAI,WAAW,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC;AACxE,eAAW,MAAM,EAAE,OAAO;AACxB,YAAM,OAAO,SAAS,IAAI,GAAG,MAAM;AACnC,UAAI,CAAC,KAAM;AACX,YAAM,MAAM,WAAW,MAAM,QAAQ,IAAI;AACzC,YAAM,aAAa,WAAW,MAAM,MAAM,KAAK,IAAI,GAAG,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI;AAC3F,UAAI,KAAK;AAAA,QACP,OAAO,EAAE;AAAA,QACT,QAAQ,GAAG;AAAA,QACX,UAAU,GAAG;AAAA,QACb,OAAO,GAAG;AAAA,QACV,SAAS;AAAA,UACP,YAAY,WACT,IAAI,UAAU,EACd,OAAO,CAAC,MAA8C,MAAM,IAAI;AAAA,UACnE,MAAM,EAAE,MAAM,KAAK,KAAK,MAAM,MAAM,WAAW,KAAK,IAAI,EAAE;AAAA,QAC5D;AAAA,QACA,WAAW,GAAG;AAAA,QACd,UAAU,GAAG;AAAA,MACf,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,SAAS,SAAsC;AAC7D,SAAO,GAAG,QAAQ,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;AAAA;AAC5D;AAEA,SAAS,WAAW,MAAsD;AACxE,MAAI,UAAU,IAAI,GAAG;AACnB,UAAM,OAAO,KAAK,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,IAAI;AACzF,WAAO,EAAE,MAAM,aAAa,SAAS,KAAK;AAAA,EAC5C;AACA,MAAI,WAAW,IAAI,GAAG;AACpB,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,GAAG,KAAK,QAAQ,IAAI,cAAc,KAAK,IAAI,CAAC,YAAO,cAAc,KAAK,MAAM,CAAC;AAAA,IACxF;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,WAAW,MAAoB;AACtC,MAAI,UAAU,IAAI,EAAG,QAAQ,KAAiB,UAAU;AACxD,MAAI,WAAW,IAAI;AACjB,WAAO,GAAG,KAAK,QAAQ,IAAI,cAAc,KAAK,IAAI,CAAC,YAAO,cAAc,KAAK,MAAM,CAAC;AACtF,SAAO,KAAK;AACd;AAEA,SAAS,cAAc,GAAoB;AACzC,MAAI,MAAM,QAAQ,MAAM,OAAW,QAAO;AAC1C,MAAI,OAAO,MAAM,SAAU,QAAO;AAClC,MAAI;AACF,WAAO,KAAK,UAAU,CAAC;AAAA,EACzB,QAAQ;AACN,WAAO,OAAO,CAAC;AAAA,EACjB;AACF;","names":[]}

package/dist/chunk-Q2JRAWRI.js

@@ -1,196 +0,0 @@
-import {
-  objectiveEval
-} from "./chunk-YEHAEDUD.js";
-
-// src/knowledge/readiness.ts
-function scoreKnowledgeReadiness(options) {
-  const now = options.now ?? /* @__PURE__ */ new Date();
-  const requirements = options.requirements.map(normalizeRequirement);
-  const missing = requirements.filter((requirement) => isRequirementMissing(requirement, now));
-  const blockingMissingRequirements = missing.filter(isBlockingGap);
-  const nonBlockingGaps = missing.filter((requirement) => !isBlockingGap(requirement));
-  const readinessScore = weightedReadinessAt(requirements, now);
-  const bundle = {
-    taskId: options.taskId,
-    requirements,
-    evidenceIds: unique([
-      ...options.evidenceIds ?? [],
-      ...requirements.flatMap((r) => r.evidenceIds)
-    ]),
-    claimIds: unique(options.claimIds ?? []),
-    wikiPageIds: unique(options.wikiPageIds ?? []),
-    userAnswers: options.userAnswers ?? {},
-    missing,
-    readinessScore,
-    metadata: options.metadata
-  };
-  const recommendedAction = chooseRecommendedAction(blockingMissingRequirements, nonBlockingGaps);
-  const severity = blockingMissingRequirements.length > 0 ? "critical" : nonBlockingGaps.some((gap) => gap.importance === "high") ? "warning" : "info";
-  const reason = blockingMissingRequirements.length > 0 ? `${blockingMissingRequirements.length} blocking knowledge requirement(s) are missing.` : nonBlockingGaps.length > 0 ? `${nonBlockingGaps.length} non-blocking knowledge gap(s) remain.` : "All declared knowledge requirements are ready.";
-  return {
-    taskId: options.taskId,
-    readinessScore,
-    blockingMissingRequirements,
-    nonBlockingGaps,
-    recommendedAction,
-    bundle,
-    severity,
-    reason
-  };
-}
-function blockingKnowledgeEval(report, options = {}) {
-  const minimumScore = options.minimumScore ?? 0.7;
-  const passed = report.blockingMissingRequirements.length === 0 && report.readinessScore >= minimumScore;
-  if (options.emitter) {
-    void options.emitter.emit({
-      kind: "custom",
-      payload: knowledgeReadinessTracePayload(report, { passed, minimumScore })
-    }).catch(() => void 0);
-  }
-  return objectiveEval({
-    id: options.id ?? "knowledge-ready",
-    passed,
-    score: report.readinessScore,
-    severity: passed ? "info" : report.severity,
-    detail: report.reason,
-    evidence: report.blockingMissingRequirements.map((r) => r.id).join(", ") || void 0,
-    metadata: { knowledgeReadiness: report }
-  });
-}
-function knowledgeReadinessTracePayload(report, options = {}) {
-  return {
-    kind: "readiness_scored",
-    taskId: report.taskId,
-    passed: options.passed ?? report.blockingMissingRequirements.length === 0,
-    readinessScore: report.readinessScore,
-    minimumScore: options.minimumScore,
-    blockingRequirementIds: report.blockingMissingRequirements.map((r) => r.id),
-    nonBlockingRequirementIds: report.nonBlockingGaps.map((r) => r.id),
-    recommendedAction: report.recommendedAction,
-    severity: report.severity,
-    reason: report.reason
-  };
-}
-function userQuestionsForKnowledgeGaps(gaps) {
-  return gaps.filter((gap) => gap.acquisitionMode === "ask_user" || gap.fallbackPolicy === "ask").map((gap) => ({
-    id: `question_${gap.id}`,
-    question: `Please provide: ${gap.description}`,
-    reason: `Required for ${gap.requiredFor.join(", ") || "the task"}.`,
-    requirementId: gap.id,
-    importance: gap.importance,
-    answerType: gap.sensitivity === "secret" ? "credential" : "free_text",
-    impactIfUnknown: impactFor(gap)
-  }));
-}
-function acquisitionPlansForKnowledgeGaps(gaps) {
-  const byMode = /* @__PURE__ */ new Map();
-  for (const gap of gaps) {
-    const mode = planMode(gap.acquisitionMode);
-    if (!mode) continue;
-    const bucket = byMode.get(mode) ?? [];
-    bucket.push(gap);
-    byMode.set(mode, bucket);
-  }
-  return [...byMode.entries()].map(([mode, requirements]) => ({
-    id: `acquire_${mode}`,
-    requirementIds: requirements.map((r) => r.id),
-    mode,
-    description: descriptionForPlan(mode, requirements),
-    priority: maxImportance(requirements.map((r) => r.importance)),
-    questions: mode === "ask_user" ? userQuestionsForKnowledgeGaps(requirements) : void 0
-  }));
-}
-function normalizeRequirement(requirement) {
-  return {
-    ...requirement,
-    confidenceNeeded: clamp01(requirement.confidenceNeeded),
-    currentConfidence: clamp01(requirement.currentConfidence),
-    evidenceIds: unique(requirement.evidenceIds)
-  };
-}
-function weightedReadinessAt(requirements, now) {
-  if (requirements.length === 0) return 1;
-  let weightSum = 0;
-  let scoreSum = 0;
-  for (const requirement of requirements) {
-    const weight = importanceWeight(requirement.importance);
-    const score = isExpired(requirement, now) ? 0 : requirement.confidenceNeeded <= 0 ? 1 : Math.min(1, requirement.currentConfidence / requirement.confidenceNeeded);
-    weightSum += weight;
-    scoreSum += weight * score;
-  }
-  return clamp01(scoreSum / weightSum);
-}
-function isRequirementMissing(requirement, now) {
-  return isExpired(requirement, now) || requirement.currentConfidence < requirement.confidenceNeeded;
-}
-function isExpired(requirement, now) {
-  if (!requirement.validUntil) return false;
-  const deadline = Date.parse(requirement.validUntil);
-  if (!Number.isFinite(deadline)) return true;
-  return deadline <= now.getTime();
-}
-function isBlockingGap(requirement) {
-  return requirement.importance === "blocking" || requirement.fallbackPolicy === "block" || requirement.sensitivity === "secret";
-}
-function chooseRecommendedAction(blocking, nonBlocking) {
-  const gaps = blocking.length > 0 ? blocking : nonBlocking;
-  if (gaps.length === 0) return "run_agent";
-  if (gaps.some((gap) => gap.acquisitionMode === "ask_user" || gap.fallbackPolicy === "ask"))
-    return "ask_user";
-  if (gaps.some((gap) => gap.acquisitionMode === "query_connector")) return "query_connectors";
-  if (gaps.some(
-    (gap) => gap.acquisitionMode === "inspect_repo" || gap.acquisitionMode === "run_command"
-  ))
-    return "inspect_repo";
-  if (gaps.some((gap) => gap.acquisitionMode === "search_web")) return "collect_web_data";
-  if (gaps.some((gap) => gap.acquisitionMode === "not_available")) return "abort_or_rescope";
-  if (nonBlocking.some((gap) => gap.importance === "high")) return "build_domain_wiki";
-  return "continue_with_caveat";
-}
-function planMode(mode) {
-  if (mode === "infer_low_confidence" || mode === "not_available") return null;
-  return mode;
-}
-function descriptionForPlan(mode, requirements) {
-  const labels = requirements.map((r) => r.description).join("; ");
-  if (mode === "ask_user") return `Ask the user for: ${labels}`;
-  if (mode === "search_web") return `Search web or documentation sources for: ${labels}`;
-  if (mode === "query_connector") return `Query configured connectors for: ${labels}`;
-  if (mode === "inspect_repo") return `Inspect repository context for: ${labels}`;
-  if (mode === "run_command") return `Run local commands to collect: ${labels}`;
-  return `Build domain wiki evidence for: ${labels}`;
-}
-function impactFor(requirement) {
-  if (requirement.fallbackPolicy === "block") return "The agent should not run until this is known.";
-  if (requirement.fallbackPolicy === "continue_with_caveat")
-    return "The agent may continue, but must disclose uncertainty.";
-  if (requirement.fallbackPolicy === "use_default")
-    return "The agent will use the configured default if skipped.";
-  return "The agent should ask before continuing.";
-}
-function maxImportance(values) {
-  const order = ["blocking", "high", "medium", "low"];
-  return order.find((value) => values.includes(value)) ?? "low";
-}
-function importanceWeight(importance) {
-  if (importance === "blocking") return 8;
-  if (importance === "high") return 4;
-  if (importance === "medium") return 2;
-  return 1;
-}
-function clamp01(value) {
-  if (!Number.isFinite(value)) return 0;
-  return Math.max(0, Math.min(1, value));
-}
-function unique(items) {
-  return [...new Set(items)];
-}
-
-export {
-  scoreKnowledgeReadiness,
-  blockingKnowledgeEval,
-  knowledgeReadinessTracePayload,
-  userQuestionsForKnowledgeGaps,
-  acquisitionPlansForKnowledgeGaps
-};
-//# sourceMappingURL=chunk-Q2JRAWRI.js.map

package/dist/chunk-Q2JRAWRI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/knowledge/readiness.ts"],"sourcesContent":["import { type ControlEvalResult, objectiveEval } from '../control-runtime'\nimport type { TraceEmitter } from '../trace/emitter'\nimport type {\n  DataAcquisitionPlan,\n  KnowledgeAcquisitionMode,\n  KnowledgeBundle,\n  KnowledgeImportance,\n  KnowledgeReadinessReport,\n  KnowledgeRecommendedAction,\n  KnowledgeRequirement,\n  UserQuestion,\n} from './types'\n\nexport interface ScoreKnowledgeReadinessOptions {\n  taskId: string\n  requirements: KnowledgeRequirement[]\n  evidenceIds?: string[]\n  claimIds?: string[]\n  wikiPageIds?: string[]\n  userAnswers?: Record<string, string>\n  metadata?: Record<string, unknown>\n  now?: Date\n}\n\nexport function scoreKnowledgeReadiness(\n  options: ScoreKnowledgeReadinessOptions,\n): KnowledgeReadinessReport {\n  const now = options.now ?? new Date()\n  const requirements = options.requirements.map(normalizeRequirement)\n  const missing = requirements.filter((requirement) => isRequirementMissing(requirement, now))\n  const blockingMissingRequirements = missing.filter(isBlockingGap)\n  const nonBlockingGaps = missing.filter((requirement) => !isBlockingGap(requirement))\n  const readinessScore = weightedReadinessAt(requirements, now)\n  const bundle: KnowledgeBundle = {\n    taskId: options.taskId,\n    requirements,\n    evidenceIds: unique([\n      ...(options.evidenceIds ?? []),\n      ...requirements.flatMap((r) => r.evidenceIds),\n    ]),\n    claimIds: unique(options.claimIds ?? []),\n    wikiPageIds: unique(options.wikiPageIds ?? []),\n    userAnswers: options.userAnswers ?? {},\n    missing,\n    readinessScore,\n    metadata: options.metadata,\n  }\n  const recommendedAction = chooseRecommendedAction(blockingMissingRequirements, nonBlockingGaps)\n  const severity =\n    blockingMissingRequirements.length > 0\n      ? 'critical'\n      : nonBlockingGaps.some((gap) => gap.importance === 'high')\n        ? 'warning'\n        : 'info'\n  const reason =\n    blockingMissingRequirements.length > 0\n      ? `${blockingMissingRequirements.length} blocking knowledge requirement(s) are missing.`\n      : nonBlockingGaps.length > 0\n        ? `${nonBlockingGaps.length} non-blocking knowledge gap(s) remain.`\n        : 'All declared knowledge requirements are ready.'\n\n  return {\n    taskId: options.taskId,\n    readinessScore,\n    blockingMissingRequirements,\n    nonBlockingGaps,\n    recommendedAction,\n    bundle,\n    severity,\n    reason,\n  }\n}\n\nexport function blockingKnowledgeEval(\n  report: KnowledgeReadinessReport,\n  options: { id?: string; minimumScore?: number; emitter?: TraceEmitter } = {},\n): ControlEvalResult {\n  const minimumScore = options.minimumScore ?? 0.7\n  const passed =\n    report.blockingMissingRequirements.length === 0 && report.readinessScore >= minimumScore\n  if (options.emitter) {\n    void options.emitter\n      .emit({\n        kind: 'custom',\n        payload: knowledgeReadinessTracePayload(report, { passed, minimumScore }),\n      })\n      .catch(() => undefined)\n  }\n  return objectiveEval({\n    id: options.id ?? 'knowledge-ready',\n    passed,\n    score: report.readinessScore,\n    severity: passed ? 'info' : report.severity,\n    detail: report.reason,\n    evidence: report.blockingMissingRequirements.map((r) => r.id).join(', ') || undefined,\n    metadata: { knowledgeReadiness: report },\n  })\n}\n\nexport function knowledgeReadinessTracePayload(\n  report: KnowledgeReadinessReport,\n  options: { passed?: boolean; minimumScore?: number } = {},\n): Record<string, unknown> {\n  return {\n    kind: 'readiness_scored',\n    taskId: report.taskId,\n    passed: options.passed ?? report.blockingMissingRequirements.length === 0,\n    readinessScore: report.readinessScore,\n    minimumScore: options.minimumScore,\n    blockingRequirementIds: report.blockingMissingRequirements.map((r) => r.id),\n    nonBlockingRequirementIds: report.nonBlockingGaps.map((r) => r.id),\n    recommendedAction: report.recommendedAction,\n    severity: report.severity,\n    reason: report.reason,\n  }\n}\n\nexport function userQuestionsForKnowledgeGaps(gaps: KnowledgeRequirement[]): UserQuestion[] {\n  return gaps\n    .filter((gap) => gap.acquisitionMode === 'ask_user' || gap.fallbackPolicy === 'ask')\n    .map((gap) => ({\n      id: `question_${gap.id}`,\n      question: `Please provide: ${gap.description}`,\n      reason: `Required for ${gap.requiredFor.join(', ') || 'the task'}.`,\n      requirementId: gap.id,\n      importance: gap.importance,\n      answerType: gap.sensitivity === 'secret' ? 'credential' : 'free_text',\n      impactIfUnknown: impactFor(gap),\n    }))\n}\n\nexport function acquisitionPlansForKnowledgeGaps(\n  gaps: KnowledgeRequirement[],\n): DataAcquisitionPlan[] {\n  const byMode = new Map<string, KnowledgeRequirement[]>()\n  for (const gap of gaps) {\n    const mode = planMode(gap.acquisitionMode)\n    if (!mode) continue\n    const bucket = byMode.get(mode) ?? []\n    bucket.push(gap)\n    byMode.set(mode, bucket)\n  }\n  return [...byMode.entries()].map(([mode, requirements]) => ({\n    id: `acquire_${mode}`,\n    requirementIds: requirements.map((r) => r.id),\n    mode: mode as DataAcquisitionPlan['mode'],\n    description: descriptionForPlan(mode as DataAcquisitionPlan['mode'], requirements),\n    priority: maxImportance(requirements.map((r) => r.importance)),\n    questions: mode === 'ask_user' ? userQuestionsForKnowledgeGaps(requirements) : undefined,\n  }))\n}\n\nfunction normalizeRequirement(requirement: KnowledgeRequirement): KnowledgeRequirement {\n  return {\n    ...requirement,\n    confidenceNeeded: clamp01(requirement.confidenceNeeded),\n    currentConfidence: clamp01(requirement.currentConfidence),\n    evidenceIds: unique(requirement.evidenceIds),\n  }\n}\n\nfunction weightedReadinessAt(requirements: KnowledgeRequirement[], now: Date): number {\n  if (requirements.length === 0) return 1\n  let weightSum = 0\n  let scoreSum = 0\n  for (const requirement of requirements) {\n    const weight = importanceWeight(requirement.importance)\n    const score = isExpired(requirement, now)\n      ? 0\n      : requirement.confidenceNeeded <= 0\n        ? 1\n        : Math.min(1, requirement.currentConfidence / requirement.confidenceNeeded)\n    weightSum += weight\n    scoreSum += weight * score\n  }\n  return clamp01(scoreSum / weightSum)\n}\n\nfunction isRequirementMissing(requirement: KnowledgeRequirement, now: Date): boolean {\n  return isExpired(requirement, now) || requirement.currentConfidence < requirement.confidenceNeeded\n}\n\nfunction isExpired(requirement: KnowledgeRequirement, now: Date): boolean {\n  if (!requirement.validUntil) return false\n  const deadline = Date.parse(requirement.validUntil)\n  if (!Number.isFinite(deadline)) return true\n  return deadline <= now.getTime()\n}\n\nfunction isBlockingGap(requirement: KnowledgeRequirement): boolean {\n  return (\n    requirement.importance === 'blocking' ||\n    requirement.fallbackPolicy === 'block' ||\n    requirement.sensitivity === 'secret'\n  )\n}\n\nfunction chooseRecommendedAction(\n  blocking: KnowledgeRequirement[],\n  nonBlocking: KnowledgeRequirement[],\n): KnowledgeRecommendedAction {\n  const gaps = blocking.length > 0 ? blocking : nonBlocking\n  if (gaps.length === 0) return 'run_agent'\n  if (gaps.some((gap) => gap.acquisitionMode === 'ask_user' || gap.fallbackPolicy === 'ask'))\n    return 'ask_user'\n  if (gaps.some((gap) => gap.acquisitionMode === 'query_connector')) return 'query_connectors'\n  if (\n    gaps.some(\n      (gap) => gap.acquisitionMode === 'inspect_repo' || gap.acquisitionMode === 'run_command',\n    )\n  )\n    return 'inspect_repo'\n  if (gaps.some((gap) => gap.acquisitionMode === 'search_web')) return 'collect_web_data'\n  if (gaps.some((gap) => gap.acquisitionMode === 'not_available')) return 'abort_or_rescope'\n  if (nonBlocking.some((gap) => gap.importance === 'high')) return 'build_domain_wiki'\n  return 'continue_with_caveat'\n}\n\nfunction planMode(mode: KnowledgeAcquisitionMode): DataAcquisitionPlan['mode'] | null {\n  if (mode === 'infer_low_confidence' || mode === 'not_available') return null\n  return mode\n}\n\nfunction descriptionForPlan(\n  mode: DataAcquisitionPlan['mode'],\n  requirements: KnowledgeRequirement[],\n): string {\n  const labels = requirements.map((r) => r.description).join('; ')\n  if (mode === 'ask_user') return `Ask the user for: ${labels}`\n  if (mode === 'search_web') return `Search web or documentation sources for: ${labels}`\n  if (mode === 'query_connector') return `Query configured connectors for: ${labels}`\n  if (mode === 'inspect_repo') return `Inspect repository context for: ${labels}`\n  if (mode === 'run_command') return `Run local commands to collect: ${labels}`\n  return `Build domain wiki evidence for: ${labels}`\n}\n\nfunction impactFor(requirement: KnowledgeRequirement): string {\n  if (requirement.fallbackPolicy === 'block') return 'The agent should not run until this is known.'\n  if (requirement.fallbackPolicy === 'continue_with_caveat')\n    return 'The agent may continue, but must disclose uncertainty.'\n  if (requirement.fallbackPolicy === 'use_default')\n    return 'The agent will use the configured default if skipped.'\n  return 'The agent should ask before continuing.'\n}\n\nfunction maxImportance(values: KnowledgeImportance[]): KnowledgeImportance {\n  const order: KnowledgeImportance[] = ['blocking', 'high', 'medium', 'low']\n  return order.find((value) => values.includes(value)) ?? 'low'\n}\n\nfunction importanceWeight(importance: KnowledgeImportance): number {\n  if (importance === 'blocking') return 8\n  if (importance === 'high') return 4\n  if (importance === 'medium') return 2\n  return 1\n}\n\nfunction clamp01(value: number): number {\n  if (!Number.isFinite(value)) return 0\n  return Math.max(0, Math.min(1, value))\n}\n\nfunction unique<T>(items: T[]): T[] {\n  return [...new Set(items)]\n}\n"],"mappings":"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","names":[]}