@tangle-network/agent-runtime 0.2.0 → 0.3.0

package/README.md

@@ -72,6 +72,26 @@ Events cover readiness, question answering, acquisition, control-loop steps,
 and task completion. This keeps streaming UI, logs, and telemetry out of domain
 adapters while making every runtime transition observable.
 
+For logs, reports, and UI telemetry, do not serialize raw events directly.
+Use the built-in sanitized collector:
+
+```ts
+import { createRuntimeEventCollector, summarizeAgentTaskRun } from '@tangle-network/agent-runtime'
+
+const telemetry = createRuntimeEventCollector()
+const result = await runAgentTask({ task, adapter, onEvent: telemetry.onEvent })
+
+console.log(telemetry.events)
+console.log(summarizeAgentTaskRun(result))
+```
+
+Sanitized telemetry redacts task inputs, user answers, credential questions,
+control payloads, and evidence IDs by default. Private diagnostics can opt into
+specific fields with `includeInputs`, `includeUserAnswers`,
+`includeControlPayloads`, `includeEvidenceIds`, and
+`includeRequirementDescriptions`. Task metadata and eval details are also
+redacted unless `includeMetadata` or `includeEvalDetails` is set.
+
 Knowledge providers may implement:
 
 - `buildReadiness`

package/dist/index.d.ts

@@ -149,6 +149,78 @@ interface AgentTaskRunResult<TState, TAction, TActionResult, TEval extends Contr
     control: ControlRunResult<TState, TAction, TActionResult, TEval>;
     runRecords: RunRecord[];
 }
+interface RuntimeTelemetryOptions {
+    /**
+     * Include raw task inputs. Off by default because task inputs often
+     * contain customer facts, credentials, source text, or internal IDs.
+     */
+    includeInputs?: boolean;
+    /** Include requirement descriptions. Secret requirements are always redacted. */
+    includeRequirementDescriptions?: boolean;
+    /** Include evidence IDs. Off by default; counts are safer for shared reports. */
+    includeEvidenceIds?: boolean;
+    /** Include user answers from question preflight. Off by default. */
+    includeUserAnswers?: boolean;
+    /** Include action payloads and action results for control steps. Off by default. */
+    includeControlPayloads?: boolean;
+    /** Include task metadata. Off by default because metadata may carry IDs or policy internals. */
+    includeMetadata?: boolean;
+    /** Include eval detail/evidence strings. Off by default because validators may echo private input. */
+    includeEvalDetails?: boolean;
+}
+interface SanitizedKnowledgeRequirement {
+    id: string;
+    description?: string;
+    requiredFor: string[];
+    category: KnowledgeRequirement['category'];
+    acquisitionMode: KnowledgeRequirement['acquisitionMode'];
+    importance: KnowledgeRequirement['importance'];
+    freshness: KnowledgeRequirement['freshness'];
+    sensitivity: KnowledgeRequirement['sensitivity'];
+    confidenceNeeded: number;
+    currentConfidence: number;
+    evidenceCount: number;
+    evidenceIds?: string[];
+    fallbackPolicy: KnowledgeRequirement['fallbackPolicy'];
+}
+interface SanitizedKnowledgeReadinessReport {
+    taskId: string;
+    readinessScore: number;
+    recommendedAction: KnowledgeReadinessReport['recommendedAction'];
+    severity: KnowledgeReadinessReport['severity'];
+    reason: string;
+    blockingMissingRequirements: SanitizedKnowledgeRequirement[];
+    nonBlockingGaps: SanitizedKnowledgeRequirement[];
+    evidenceCount: number;
+    evidenceIds?: string[];
+    missingRequirementIds: string[];
+}
+interface AgentTaskRunSummary {
+    taskId: string;
+    domain?: string;
+    status: AgentTaskStatus;
+    reason: string;
+    readinessScore: number;
+    recommendedAction: KnowledgeReadinessReport['recommendedAction'];
+    blockingGapIds: string[];
+    nonBlockingGapIds: string[];
+    questionCount: number;
+    acquisitionPlanCount: number;
+    acquiredEvidenceCount: number;
+    controlStepCount: number;
+    pass: boolean;
+    failureClass?: string;
+    wallMs: number;
+    costUsd: number;
+}
+interface RuntimeEventCollector<TState = unknown, TAction = unknown, TActionResult = unknown, TEval extends ControlEvalResult = ControlEvalResult> {
+    onEvent: AgentRuntimeEventSink<TState, TAction, TActionResult, TEval>;
+    events: Array<Record<string, unknown>>;
+}
 declare function runAgentTask<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult>(options: RunAgentTaskOptions<TState, TAction, TActionResult, TEval>): Promise<AgentTaskRunResult<TState, TAction, TActionResult, TEval>>;
+declare function summarizeAgentTaskRun<TState, TAction, TActionResult, TEval extends ControlEvalResult>(result: AgentTaskRunResult<TState, TAction, TActionResult, TEval>): AgentTaskRunSummary;
+declare function sanitizeKnowledgeReadinessReport(report: KnowledgeReadinessReport, options?: RuntimeTelemetryOptions): SanitizedKnowledgeReadinessReport;
+declare function sanitizeAgentRuntimeEvent<TState, TAction, TActionResult, TEval extends ControlEvalResult>(event: AgentRuntimeEvent<TState, TAction, TActionResult, TEval>, options?: RuntimeTelemetryOptions): Record<string, unknown>;
+declare function createRuntimeEventCollector<TState = unknown, TAction = unknown, TActionResult = unknown, TEval extends ControlEvalResult = ControlEvalResult>(options?: RuntimeTelemetryOptions): RuntimeEventCollector<TState, TAction, TActionResult, TEval>;
 
-export { type AgentAdapter, type AgentKnowledgeProvider, type AgentRuntimeEvent, type AgentRuntimeEventSink, type AgentTaskContext, type AgentTaskRunResult, type AgentTaskSpec, type AgentTaskStatus, type RunAgentTaskOptions, runAgentTask };
+export { type AgentAdapter, type AgentKnowledgeProvider, type AgentRuntimeEvent, type AgentRuntimeEventSink, type AgentTaskContext, type AgentTaskRunResult, type AgentTaskRunSummary, type AgentTaskSpec, type AgentTaskStatus, type RunAgentTaskOptions, type RuntimeEventCollector, type RuntimeTelemetryOptions, type SanitizedKnowledgeReadinessReport, type SanitizedKnowledgeRequirement, createRuntimeEventCollector, runAgentTask, sanitizeAgentRuntimeEvent, sanitizeKnowledgeReadinessReport, summarizeAgentTaskRun };

package/dist/index.js

@@ -74,6 +74,90 @@ async function runAgentTask(options) {
     runRecords: options.adapter.projectRunRecords?.(control, task) ?? []
   };
 }
+function summarizeAgentTaskRun(result) {
+  return {
+    taskId: result.task.id,
+    domain: result.task.domain,
+    status: result.status,
+    reason: result.control.reason,
+    readinessScore: result.knowledge.readinessScore,
+    recommendedAction: result.knowledge.recommendedAction,
+    blockingGapIds: result.knowledge.blockingMissingRequirements.map((requirement) => requirement.id),
+    nonBlockingGapIds: result.knowledge.nonBlockingGaps.map((requirement) => requirement.id),
+    questionCount: result.questions.length,
+    acquisitionPlanCount: result.acquisitionPlans.length,
+    acquiredEvidenceCount: result.acquiredEvidenceIds.length,
+    controlStepCount: result.control.steps.length,
+    pass: result.control.pass,
+    failureClass: result.control.failureClass,
+    wallMs: result.control.wallMs,
+    costUsd: result.control.spentCostUsd
+  };
+}
+function sanitizeKnowledgeReadinessReport(report, options = {}) {
+  return {
+    taskId: report.taskId,
+    readinessScore: report.readinessScore,
+    recommendedAction: report.recommendedAction,
+    severity: report.severity,
+    reason: report.reason,
+    blockingMissingRequirements: report.blockingMissingRequirements.map(
+      (requirement) => sanitizeKnowledgeRequirement(requirement, options)
+    ),
+    nonBlockingGaps: report.nonBlockingGaps.map(
+      (requirement) => sanitizeKnowledgeRequirement(requirement, options)
+    ),
+    evidenceCount: report.bundle.evidenceIds.length,
+    evidenceIds: options.includeEvidenceIds ? report.bundle.evidenceIds : void 0,
+    missingRequirementIds: report.bundle.missing.map((requirement) => requirement.id)
+  };
+}
+function sanitizeAgentRuntimeEvent(event, options = {}) {
+  const base = { type: event.type, task: sanitizeTask(event.task, options) };
+  if (event.type === "readiness_start" || event.type === "task_start" || event.type === "control_start") {
+    return event.type === "control_start" ? { ...base, knowledge: sanitizeKnowledgeReadinessReport(event.knowledge, options) } : base;
+  }
+  if (event.type === "readiness_end") {
+    return { ...base, knowledge: sanitizeKnowledgeReadinessReport(event.knowledge, options) };
+  }
+  if (event.type === "questions_start") {
+    return { ...base, questions: event.questions.map((question) => sanitizeQuestion(question, options)) };
+  }
+  if (event.type === "questions_end") {
+    return {
+      ...base,
+      questions: event.questions.map((question) => sanitizeQuestion(question, options)),
+      userAnswers: options.includeUserAnswers ? event.userAnswers : redactRecord(event.userAnswers)
+    };
+  }
+  if (event.type === "acquisition_start") {
+    return { ...base, acquisitionPlans: event.acquisitionPlans.map(sanitizeAcquisitionPlan) };
+  }
+  if (event.type === "acquisition_end") {
+    return {
+      ...base,
+      acquisitionPlans: event.acquisitionPlans.map(sanitizeAcquisitionPlan),
+      acquiredEvidenceCount: event.acquiredEvidenceIds.length,
+      acquiredEvidenceIds: options.includeEvidenceIds ? event.acquiredEvidenceIds : void 0
+    };
+  }
+  if (event.type === "control_step") {
+    return { ...base, step: sanitizeControlStep(event.step, options) };
+  }
+  if (event.type === "control_end") {
+    return { ...base, control: sanitizeControlRun(event.control, options) };
+  }
+  return { ...base, status: event.status, reason: event.reason };
+}
+function createRuntimeEventCollector(options = {}) {
+  const events = [];
+  return {
+    events,
+    onEvent: (event) => {
+      events.push(sanitizeAgentRuntimeEvent(event, options));
+    }
+  };
+}
 async function runKnowledgePreflight(task, questions, acquisitionPlans, provider, onEvent) {
   let userAnswers = {};
   let acquiredEvidenceIds = [];
@@ -89,6 +173,105 @@ async function runKnowledgePreflight(task, questions, acquisitionPlans, provider
   }
   return { userAnswers, acquiredEvidenceIds };
 }
+function sanitizeTask(task, options) {
+  return {
+    id: task.id,
+    intent: task.intent,
+    domain: task.domain,
+    inputs: options.includeInputs ? task.inputs : task.inputs ? "[redacted]" : void 0,
+    requiredKnowledge: task.requiredKnowledge?.map(
+      (requirement) => sanitizeKnowledgeRequirement(requirement, options)
+    ),
+    metadata: options.includeMetadata ? task.metadata : task.metadata ? "[redacted]" : void 0
+  };
+}
+function sanitizeKnowledgeRequirement(requirement, options) {
+  const includeDescription = options.includeRequirementDescriptions && requirement.sensitivity !== "secret";
+  return {
+    id: requirement.id,
+    description: includeDescription ? requirement.description : void 0,
+    requiredFor: requirement.requiredFor,
+    category: requirement.category,
+    acquisitionMode: requirement.acquisitionMode,
+    importance: requirement.importance,
+    freshness: requirement.freshness,
+    sensitivity: requirement.sensitivity,
+    confidenceNeeded: requirement.confidenceNeeded,
+    currentConfidence: requirement.currentConfidence,
+    evidenceCount: requirement.evidenceIds.length,
+    evidenceIds: options.includeEvidenceIds ? requirement.evidenceIds : void 0,
+    fallbackPolicy: requirement.fallbackPolicy
+  };
+}
+function sanitizeQuestion(question, options) {
+  return {
+    id: question.id,
+    question: options.includeRequirementDescriptions && question.answerType !== "credential" ? question.question : void 0,
+    reason: options.includeRequirementDescriptions ? question.reason : void 0,
+    requirementId: question.requirementId,
+    importance: question.importance,
+    answerType: question.answerType,
+    impactIfUnknown: options.includeRequirementDescriptions ? question.impactIfUnknown : void 0,
+    optionCount: question.options?.length ?? 0
+  };
+}
+function sanitizeAcquisitionPlan(plan) {
+  return {
+    id: plan.id,
+    requirementIds: plan.requirementIds,
+    mode: plan.mode,
+    priority: plan.priority,
+    expectedEvidenceCount: plan.expectedEvidenceIds?.length ?? 0,
+    questionCount: plan.questions?.length ?? 0
+  };
+}
+function sanitizeControlStep(step, options) {
+  const actionOutcome = step.actionOutcome;
+  return {
+    index: step.index,
+    decisionType: step.decision.type,
+    reason: step.decision.reason,
+    action: options.includeControlPayloads && step.decision.type === "continue" ? step.decision.action : void 0,
+    result: options.includeControlPayloads && actionOutcome?.ok ? actionOutcome.result : void 0,
+    actionOk: actionOutcome?.ok,
+    actionError: actionOutcome?.ok === false ? actionOutcome.error : void 0,
+    durationMs: actionOutcome?.durationMs,
+    evalsBefore: summarizeEvals(step.evalsBefore, options),
+    evalsAfter: summarizeEvals(step.evalsAfter, options),
+    startedAt: step.startedAt,
+    endedAt: step.endedAt
+  };
+}
+function sanitizeControlRun(control, options) {
+  return {
+    pass: control.pass,
+    completed: control.completed,
+    reason: control.reason,
+    score: control.score,
+    stepCount: control.steps.length,
+    wallMs: control.wallMs,
+    spentCostUsd: control.spentCostUsd,
+    failureClass: control.failureClass,
+    stoppedBy: control.stoppedBy,
+    runId: control.runId,
+    runtimeErrorCount: control.runtimeErrors.length,
+    finalEvals: summarizeEvals(control.finalEvals, options)
+  };
+}
+function summarizeEvals(evals, options) {
+  return evals.map((evalResult) => ({
+    id: evalResult.id,
+    passed: evalResult.passed,
+    score: evalResult.score,
+    severity: evalResult.severity,
+    objective: evalResult.objective,
+    detail: options.includeEvalDetails ? evalResult.detail : void 0,
+    evidence: options.includeEvalDetails ? evalResult.evidence : void 0
+  }));
+}
+function redactRecord(record) {
+  return Object.fromEntries(Object.keys(record).map((key) => [key, "[redacted]"]));
+}
 function buildReadiness(task, provider) {
   if (provider?.buildReadiness) return provider.buildReadiness(task);
   return scoreKnowledgeReadiness({
@@ -125,6 +308,10 @@ function toAgentContext(task, knowledge, ctx) {
   };
 }
 export {
-  runAgentTask
+  createRuntimeEventCollector,
+  runAgentTask,
+  sanitizeAgentRuntimeEvent,
+  sanitizeKnowledgeReadinessReport,
+  summarizeAgentTaskRun
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  acquisitionPlansForKnowledgeGaps,\n  blockingKnowledgeEval,\n  runAgentControlLoop,\n  scoreKnowledgeReadiness,\n  userQuestionsForKnowledgeGaps,\n  type ControlBudget,\n  type ControlContext,\n  type ControlDecision,\n  type ControlEvalResult,\n  type ControlRunResult,\n  type ControlStep,\n  type DataAcquisitionPlan,\n  type KnowledgeReadinessReport,\n  type KnowledgeRequirement,\n  type RunRecord,\n  type TraceStore,\n  type UserQuestion,\n} from '@tangle-network/agent-eval'\n\nexport interface AgentTaskSpec {\n  id: string\n  intent: string\n  /** Domain is metadata, not an architectural boundary: tax, legal, gtm, creative, blueprint, redteam, etc. */\n  domain?: string\n  inputs?: Record<string, unknown>\n  requiredKnowledge?: KnowledgeRequirement[]\n  budget?: Partial<ControlBudget>\n  metadata?: Record<string, unknown>\n}\n\nexport interface AgentKnowledgeProvider {\n  buildReadiness?(task: AgentTaskSpec): Promise<KnowledgeReadinessReport> | KnowledgeReadinessReport\n  answerQuestions?(questions: UserQuestion[], task: AgentTaskSpec): Promise<Record<string, string>> | Record<string, string>\n  executeAcquisitionPlans?(plans: DataAcquisitionPlan[], task: AgentTaskSpec): Promise<string[]> | string[]\n  refreshReadiness?(input: {\n    task: AgentTaskSpec\n    previous: KnowledgeReadinessReport\n    userAnswers: Record<string, string>\n    acquiredEvidenceIds: string[]\n  }): Promise<KnowledgeReadinessReport> | KnowledgeReadinessReport\n}\n\nexport interface AgentTaskContext<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult> {\n  task: AgentTaskSpec\n  knowledge: KnowledgeReadinessReport\n  state: TState\n  evals: TEval[]\n  history: ControlStep<TState, TAction, TActionResult, TEval>[]\n  budget: ControlBudget\n  stepIndex: number\n  wallMs: number\n  spentCostUsd: number\n  remainingCostUsd?: number\n  abortSignal: AbortSignal\n}\n\nexport interface AgentAdapter<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult> {\n  observe(ctx: {\n    task: AgentTaskSpec\n    knowledge: KnowledgeReadinessReport\n    history: ControlStep<TState, TAction, TActionResult, TEval>[]\n    abortSignal: AbortSignal\n  }): Promise<TState> | TState\n\n  validate(ctx: {\n    task: AgentTaskSpec\n    knowledge: KnowledgeReadinessReport\n    state: TState\n    history: ControlStep<TState, TAction, TActionResult, TEval>[]\n    abortSignal: AbortSignal\n  }): Promise<TEval[]> | TEval[]\n\n  decide(ctx: AgentTaskContext<TState, TAction, TActionResult, TEval>): Promise<ControlDecision<TAction>> | ControlDecision<TAction>\n\n  act(action: TAction, ctx: AgentTaskContext<TState, TAction, TActionResult, TEval>): Promise<TActionResult> | TActionResult\n\n  shouldStop?(ctx: AgentTaskContext<TState, TAction, TActionResult, TEval>): Promise<{\n    stop: boolean\n    pass: boolean\n    reason: string\n    score?: number\n  }> | {\n    stop: boolean\n    pass: boolean\n    reason: string\n    score?: number\n  }\n\n  onKnowledgeBlocked?(ctx: {\n    task: AgentTaskSpec\n    knowledge: KnowledgeReadinessReport\n    questions: UserQuestion[]\n    acquisitionPlans: DataAcquisitionPlan[]\n  }): Promise<ControlDecision<TAction>> | ControlDecision<TAction>\n\n  getActionCostUsd?(ctx: {\n    action: TAction\n    result: TActionResult\n    task: AgentTaskSpec\n    state: TState\n    evals: TEval[]\n    history: ControlStep<TState, TAction, TActionResult, TEval>[]\n  }): number | undefined\n\n  projectRunRecords?(result: ControlRunResult<TState, TAction, TActionResult, TEval>, task: AgentTaskSpec): RunRecord[]\n}\n\nexport type AgentTaskStatus =\n  | 'completed'\n  | 'blocked'\n  | 'failed'\n  | 'aborted'\n\nexport type AgentRuntimeEvent<TState = unknown, TAction = unknown, TActionResult = unknown, TEval extends ControlEvalResult = ControlEvalResult> =\n  | { type: 'task_start'; task: AgentTaskSpec }\n  | { type: 'readiness_start'; task: AgentTaskSpec }\n  | { type: 'readiness_end'; task: AgentTaskSpec; knowledge: KnowledgeReadinessReport }\n  | { type: 'questions_start'; task: AgentTaskSpec; questions: UserQuestion[] }\n  | { type: 'questions_end'; task: AgentTaskSpec; questions: UserQuestion[]; userAnswers: Record<string, string> }\n  | { type: 'acquisition_start'; task: AgentTaskSpec; acquisitionPlans: DataAcquisitionPlan[] }\n  | { type: 'acquisition_end'; task: AgentTaskSpec; acquisitionPlans: DataAcquisitionPlan[]; acquiredEvidenceIds: string[] }\n  | { type: 'control_start'; task: AgentTaskSpec; knowledge: KnowledgeReadinessReport }\n  | { type: 'control_step'; task: AgentTaskSpec; step: ControlStep<TState, TAction, TActionResult, TEval> }\n  | { type: 'control_end'; task: AgentTaskSpec; control: ControlRunResult<TState, TAction, TActionResult, TEval> }\n  | { type: 'task_end'; task: AgentTaskSpec; status: AgentTaskStatus; reason: string }\n\nexport type AgentRuntimeEventSink<TState = unknown, TAction = unknown, TActionResult = unknown, TEval extends ControlEvalResult = ControlEvalResult> = (\n  event: AgentRuntimeEvent<TState, TAction, TActionResult, TEval>,\n) => Promise<void> | void\n\nexport interface RunAgentTaskOptions<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult> {\n  task: AgentTaskSpec\n  adapter: AgentAdapter<TState, TAction, TActionResult, TEval>\n  knowledge?: AgentKnowledgeProvider\n  onEvent?: AgentRuntimeEventSink<TState, TAction, TActionResult, TEval>\n  store?: TraceStore\n  signal?: AbortSignal\n  scenarioId?: string\n  projectId?: string\n  variantId?: string\n  minimumReadinessScore?: number\n}\n\nexport interface AgentTaskRunResult<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult> {\n  task: AgentTaskSpec\n  status: AgentTaskStatus\n  knowledge: KnowledgeReadinessReport\n  questions: UserQuestion[]\n  acquisitionPlans: DataAcquisitionPlan[]\n  userAnswers: Record<string, string>\n  acquiredEvidenceIds: string[]\n  control: ControlRunResult<TState, TAction, TActionResult, TEval>\n  runRecords: RunRecord[]\n}\n\nexport async function runAgentTask<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult>(\n  options: RunAgentTaskOptions<TState, TAction, TActionResult, TEval>,\n): Promise<AgentTaskRunResult<TState, TAction, TActionResult, TEval>> {\n  const task = options.task\n  await emit(options.onEvent, { type: 'task_start', task })\n  await emit(options.onEvent, { type: 'readiness_start', task })\n  let knowledge = await buildReadiness(task, options.knowledge)\n  await emit(options.onEvent, { type: 'readiness_end', task, knowledge })\n  const questions = userQuestionsForKnowledgeGaps(knowledge.blockingMissingRequirements)\n  const acquisitionPlans = acquisitionPlansForKnowledgeGaps([\n    ...knowledge.blockingMissingRequirements,\n    ...knowledge.nonBlockingGaps,\n  ])\n  const preflight = await runKnowledgePreflight(task, questions, acquisitionPlans, options.knowledge, options.onEvent)\n  if (options.knowledge?.refreshReadiness && (Object.keys(preflight.userAnswers).length > 0 || preflight.acquiredEvidenceIds.length > 0)) {\n    await emit(options.onEvent, { type: 'readiness_start', task })\n    knowledge = await options.knowledge.refreshReadiness({\n      task,\n      previous: knowledge,\n      userAnswers: preflight.userAnswers,\n      acquiredEvidenceIds: preflight.acquiredEvidenceIds,\n    })\n    await emit(options.onEvent, { type: 'readiness_end', task, knowledge })\n  }\n\n  await emit(options.onEvent, { type: 'control_start', task, knowledge })\n  const control = await runAgentControlLoop<TState, TAction, TActionResult, TEval>({\n    intent: task.intent,\n    budget: task.budget,\n    signal: options.signal,\n    store: options.store,\n    scenarioId: options.scenarioId ?? task.id,\n    projectId: options.projectId,\n    variantId: options.variantId,\n    observe: ({ history, abortSignal }) => options.adapter.observe({ task, knowledge, history, abortSignal }),\n    validate: async ({ state, history, abortSignal }) => {\n      const readinessEval = blockingKnowledgeEval(knowledge, { minimumScore: options.minimumReadinessScore })\n      const evals = await options.adapter.validate({ task, knowledge, state, history, abortSignal })\n      return [readinessEval as TEval, ...evals]\n    },\n    decide: (ctx) => {\n      if (isKnowledgeBlocked(ctx.evals)) {\n        return options.adapter.onKnowledgeBlocked?.({ task, knowledge, questions, acquisitionPlans }) ?? {\n          type: 'stop',\n          pass: false,\n          score: knowledge.readinessScore,\n          reason: `knowledge readiness blocked: ${knowledge.reason}`,\n        }\n      }\n      return options.adapter.decide(toAgentContext(task, knowledge, ctx))\n    },\n    act: (action, ctx) => options.adapter.act(action, toAgentContext(task, knowledge, ctx)),\n    shouldStop: options.adapter.shouldStop\n      ? (ctx) => options.adapter.shouldStop!(toAgentContext(task, knowledge, ctx))\n      : undefined,\n    getActionCostUsd: options.adapter.getActionCostUsd\n      ? ({ action, result, state, evals, history }) => options.adapter.getActionCostUsd!({ action, result, task, state, evals, history })\n      : undefined,\n    onStep: (step) => emit(options.onEvent, { type: 'control_step', task, step }),\n  })\n  await emit(options.onEvent, { type: 'control_end', task, control })\n  const status = statusFromControl(control)\n  await emit(options.onEvent, { type: 'task_end', task, status, reason: control.reason })\n\n  return {\n    task,\n    status,\n    knowledge,\n    questions,\n    acquisitionPlans,\n    userAnswers: preflight.userAnswers,\n    acquiredEvidenceIds: preflight.acquiredEvidenceIds,\n    control,\n    runRecords: options.adapter.projectRunRecords?.(control, task) ?? [],\n  }\n}\n\nasync function runKnowledgePreflight<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  task: AgentTaskSpec,\n  questions: UserQuestion[],\n  acquisitionPlans: DataAcquisitionPlan[],\n  provider: AgentKnowledgeProvider | undefined,\n  onEvent: AgentRuntimeEventSink<TState, TAction, TActionResult, TEval> | undefined,\n): Promise<{ userAnswers: Record<string, string>; acquiredEvidenceIds: string[] }> {\n  let userAnswers: Record<string, string> = {}\n  let acquiredEvidenceIds: string[] = []\n  if (questions.length > 0 && provider?.answerQuestions) {\n    await emit(onEvent, { type: 'questions_start', task, questions })\n    userAnswers = await provider.answerQuestions(questions, task)\n    await emit(onEvent, { type: 'questions_end', task, questions, userAnswers })\n  }\n  if (acquisitionPlans.length > 0 && provider?.executeAcquisitionPlans) {\n    await emit(onEvent, { type: 'acquisition_start', task, acquisitionPlans })\n    acquiredEvidenceIds = await provider.executeAcquisitionPlans(acquisitionPlans, task)\n    await emit(onEvent, { type: 'acquisition_end', task, acquisitionPlans, acquiredEvidenceIds })\n  }\n  return { userAnswers, acquiredEvidenceIds }\n}\n\nfunction buildReadiness(\n  task: AgentTaskSpec,\n  provider: AgentKnowledgeProvider | undefined,\n): Promise<KnowledgeReadinessReport> | KnowledgeReadinessReport {\n  if (provider?.buildReadiness) return provider.buildReadiness(task)\n  return scoreKnowledgeReadiness({\n    taskId: task.id,\n    requirements: task.requiredKnowledge ?? [],\n    metadata: { domain: task.domain, ...task.metadata },\n  })\n}\n\nfunction isKnowledgeBlocked(evals: ControlEvalResult[]): boolean {\n  return evals.some((evalResult) => evalResult.id === 'knowledge-ready' && !evalResult.passed)\n}\n\nfunction statusFromControl(control: ControlRunResult<unknown, unknown, unknown, ControlEvalResult>): AgentTaskStatus {\n  if (control.stoppedBy === 'abort') return 'aborted'\n  if (control.reason.includes('knowledge readiness blocked')) return 'blocked'\n  if (control.pass) return 'completed'\n  return 'failed'\n}\n\nasync function emit<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  sink: AgentRuntimeEventSink<TState, TAction, TActionResult, TEval> | undefined,\n  event: AgentRuntimeEvent<TState, TAction, TActionResult, TEval>,\n): Promise<void> {\n  await sink?.(event)\n}\n\nfunction toAgentContext<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  task: AgentTaskSpec,\n  knowledge: KnowledgeReadinessReport,\n  ctx: ControlContext<TState, TAction, TActionResult, TEval>,\n): AgentTaskContext<TState, TAction, TActionResult, TEval> {\n  return {\n    task,\n    knowledge,\n    state: ctx.state,\n    evals: ctx.evals,\n    history: ctx.history,\n    budget: ctx.budget,\n    stepIndex: ctx.stepIndex,\n    wallMs: ctx.wallMs,\n    spentCostUsd: ctx.spentCostUsd,\n    remainingCostUsd: ctx.remainingCostUsd,\n    abortSignal: ctx.abortSignal,\n  }\n}\n\nexport type {\n  ControlBudget,\n  ControlDecision,\n  ControlEvalResult,\n  ControlRunResult,\n  ControlStep,\n  DataAcquisitionPlan,\n  KnowledgeReadinessReport,\n  KnowledgeRequirement,\n  RunRecord,\n  UserQuestion,\n} from '@tangle-network/agent-eval'\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  acquisitionPlansForKnowledgeGaps,\n  blockingKnowledgeEval,\n  runAgentControlLoop,\n  scoreKnowledgeReadiness,\n  userQuestionsForKnowledgeGaps,\n  type ControlBudget,\n  type ControlContext,\n  type ControlDecision,\n  type ControlEvalResult,\n  type ControlRunResult,\n  type ControlStep,\n  type DataAcquisitionPlan,\n  type KnowledgeReadinessReport,\n  type KnowledgeRequirement,\n  type RunRecord,\n  type TraceStore,\n  type UserQuestion,\n} from '@tangle-network/agent-eval'\n\nexport interface AgentTaskSpec {\n  id: string\n  intent: string\n  /** Domain is metadata, not an architectural boundary: tax, legal, gtm, creative, blueprint, redteam, etc. */\n  domain?: string\n  inputs?: Record<string, unknown>\n  requiredKnowledge?: KnowledgeRequirement[]\n  budget?: Partial<ControlBudget>\n  metadata?: Record<string, unknown>\n}\n\nexport interface AgentKnowledgeProvider {\n  buildReadiness?(task: AgentTaskSpec): Promise<KnowledgeReadinessReport> | KnowledgeReadinessReport\n  answerQuestions?(questions: UserQuestion[], task: AgentTaskSpec): Promise<Record<string, string>> | Record<string, string>\n  executeAcquisitionPlans?(plans: DataAcquisitionPlan[], task: AgentTaskSpec): Promise<string[]> | string[]\n  refreshReadiness?(input: {\n    task: AgentTaskSpec\n    previous: KnowledgeReadinessReport\n    userAnswers: Record<string, string>\n    acquiredEvidenceIds: string[]\n  }): Promise<KnowledgeReadinessReport> | KnowledgeReadinessReport\n}\n\nexport interface AgentTaskContext<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult> {\n  task: AgentTaskSpec\n  knowledge: KnowledgeReadinessReport\n  state: TState\n  evals: TEval[]\n  history: ControlStep<TState, TAction, TActionResult, TEval>[]\n  budget: ControlBudget\n  stepIndex: number\n  wallMs: number\n  spentCostUsd: number\n  remainingCostUsd?: number\n  abortSignal: AbortSignal\n}\n\nexport interface AgentAdapter<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult> {\n  observe(ctx: {\n    task: AgentTaskSpec\n    knowledge: KnowledgeReadinessReport\n    history: ControlStep<TState, TAction, TActionResult, TEval>[]\n    abortSignal: AbortSignal\n  }): Promise<TState> | TState\n\n  validate(ctx: {\n    task: AgentTaskSpec\n    knowledge: KnowledgeReadinessReport\n    state: TState\n    history: ControlStep<TState, TAction, TActionResult, TEval>[]\n    abortSignal: AbortSignal\n  }): Promise<TEval[]> | TEval[]\n\n  decide(ctx: AgentTaskContext<TState, TAction, TActionResult, TEval>): Promise<ControlDecision<TAction>> | ControlDecision<TAction>\n\n  act(action: TAction, ctx: AgentTaskContext<TState, TAction, TActionResult, TEval>): Promise<TActionResult> | TActionResult\n\n  shouldStop?(ctx: AgentTaskContext<TState, TAction, TActionResult, TEval>): Promise<{\n    stop: boolean\n    pass: boolean\n    reason: string\n    score?: number\n  }> | {\n    stop: boolean\n    pass: boolean\n    reason: string\n    score?: number\n  }\n\n  onKnowledgeBlocked?(ctx: {\n    task: AgentTaskSpec\n    knowledge: KnowledgeReadinessReport\n    questions: UserQuestion[]\n    acquisitionPlans: DataAcquisitionPlan[]\n  }): Promise<ControlDecision<TAction>> | ControlDecision<TAction>\n\n  getActionCostUsd?(ctx: {\n    action: TAction\n    result: TActionResult\n    task: AgentTaskSpec\n    state: TState\n    evals: TEval[]\n    history: ControlStep<TState, TAction, TActionResult, TEval>[]\n  }): number | undefined\n\n  projectRunRecords?(result: ControlRunResult<TState, TAction, TActionResult, TEval>, task: AgentTaskSpec): RunRecord[]\n}\n\nexport type AgentTaskStatus =\n  | 'completed'\n  | 'blocked'\n  | 'failed'\n  | 'aborted'\n\nexport type AgentRuntimeEvent<TState = unknown, TAction = unknown, TActionResult = unknown, TEval extends ControlEvalResult = ControlEvalResult> =\n  | { type: 'task_start'; task: AgentTaskSpec }\n  | { type: 'readiness_start'; task: AgentTaskSpec }\n  | { type: 'readiness_end'; task: AgentTaskSpec; knowledge: KnowledgeReadinessReport }\n  | { type: 'questions_start'; task: AgentTaskSpec; questions: UserQuestion[] }\n  | { type: 'questions_end'; task: AgentTaskSpec; questions: UserQuestion[]; userAnswers: Record<string, string> }\n  | { type: 'acquisition_start'; task: AgentTaskSpec; acquisitionPlans: DataAcquisitionPlan[] }\n  | { type: 'acquisition_end'; task: AgentTaskSpec; acquisitionPlans: DataAcquisitionPlan[]; acquiredEvidenceIds: string[] }\n  | { type: 'control_start'; task: AgentTaskSpec; knowledge: KnowledgeReadinessReport }\n  | { type: 'control_step'; task: AgentTaskSpec; step: ControlStep<TState, TAction, TActionResult, TEval> }\n  | { type: 'control_end'; task: AgentTaskSpec; control: ControlRunResult<TState, TAction, TActionResult, TEval> }\n  | { type: 'task_end'; task: AgentTaskSpec; status: AgentTaskStatus; reason: string }\n\nexport type AgentRuntimeEventSink<TState = unknown, TAction = unknown, TActionResult = unknown, TEval extends ControlEvalResult = ControlEvalResult> = (\n  event: AgentRuntimeEvent<TState, TAction, TActionResult, TEval>,\n) => Promise<void> | void\n\nexport interface RunAgentTaskOptions<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult> {\n  task: AgentTaskSpec\n  adapter: AgentAdapter<TState, TAction, TActionResult, TEval>\n  knowledge?: AgentKnowledgeProvider\n  onEvent?: AgentRuntimeEventSink<TState, TAction, TActionResult, TEval>\n  store?: TraceStore\n  signal?: AbortSignal\n  scenarioId?: string\n  projectId?: string\n  variantId?: string\n  minimumReadinessScore?: number\n}\n\nexport interface AgentTaskRunResult<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult> {\n  task: AgentTaskSpec\n  status: AgentTaskStatus\n  knowledge: KnowledgeReadinessReport\n  questions: UserQuestion[]\n  acquisitionPlans: DataAcquisitionPlan[]\n  userAnswers: Record<string, string>\n  acquiredEvidenceIds: string[]\n  control: ControlRunResult<TState, TAction, TActionResult, TEval>\n  runRecords: RunRecord[]\n}\n\nexport interface RuntimeTelemetryOptions {\n  /**\n   * Include raw task inputs. Off by default because task inputs often\n   * contain customer facts, credentials, source text, or internal IDs.\n   */\n  includeInputs?: boolean\n  /** Include requirement descriptions. Secret requirements are always redacted. */\n  includeRequirementDescriptions?: boolean\n  /** Include evidence IDs. Off by default; counts are safer for shared reports. */\n  includeEvidenceIds?: boolean\n  /** Include user answers from question preflight. Off by default. */\n  includeUserAnswers?: boolean\n  /** Include action payloads and action results for control steps. Off by default. */\n  includeControlPayloads?: boolean\n  /** Include task metadata. Off by default because metadata may carry IDs or policy internals. */\n  includeMetadata?: boolean\n  /** Include eval detail/evidence strings. Off by default because validators may echo private input. */\n  includeEvalDetails?: boolean\n}\n\nexport interface SanitizedKnowledgeRequirement {\n  id: string\n  description?: string\n  requiredFor: string[]\n  category: KnowledgeRequirement['category']\n  acquisitionMode: KnowledgeRequirement['acquisitionMode']\n  importance: KnowledgeRequirement['importance']\n  freshness: KnowledgeRequirement['freshness']\n  sensitivity: KnowledgeRequirement['sensitivity']\n  confidenceNeeded: number\n  currentConfidence: number\n  evidenceCount: number\n  evidenceIds?: string[]\n  fallbackPolicy: KnowledgeRequirement['fallbackPolicy']\n}\n\nexport interface SanitizedKnowledgeReadinessReport {\n  taskId: string\n  readinessScore: number\n  recommendedAction: KnowledgeReadinessReport['recommendedAction']\n  severity: KnowledgeReadinessReport['severity']\n  reason: string\n  blockingMissingRequirements: SanitizedKnowledgeRequirement[]\n  nonBlockingGaps: SanitizedKnowledgeRequirement[]\n  evidenceCount: number\n  evidenceIds?: string[]\n  missingRequirementIds: string[]\n}\n\nexport interface AgentTaskRunSummary {\n  taskId: string\n  domain?: string\n  status: AgentTaskStatus\n  reason: string\n  readinessScore: number\n  recommendedAction: KnowledgeReadinessReport['recommendedAction']\n  blockingGapIds: string[]\n  nonBlockingGapIds: string[]\n  questionCount: number\n  acquisitionPlanCount: number\n  acquiredEvidenceCount: number\n  controlStepCount: number\n  pass: boolean\n  failureClass?: string\n  wallMs: number\n  costUsd: number\n}\n\nexport interface RuntimeEventCollector<TState = unknown, TAction = unknown, TActionResult = unknown, TEval extends ControlEvalResult = ControlEvalResult> {\n  onEvent: AgentRuntimeEventSink<TState, TAction, TActionResult, TEval>\n  events: Array<Record<string, unknown>>\n}\n\nexport async function runAgentTask<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult>(\n  options: RunAgentTaskOptions<TState, TAction, TActionResult, TEval>,\n): Promise<AgentTaskRunResult<TState, TAction, TActionResult, TEval>> {\n  const task = options.task\n  await emit(options.onEvent, { type: 'task_start', task })\n  await emit(options.onEvent, { type: 'readiness_start', task })\n  let knowledge = await buildReadiness(task, options.knowledge)\n  await emit(options.onEvent, { type: 'readiness_end', task, knowledge })\n  const questions = userQuestionsForKnowledgeGaps(knowledge.blockingMissingRequirements)\n  const acquisitionPlans = acquisitionPlansForKnowledgeGaps([\n    ...knowledge.blockingMissingRequirements,\n    ...knowledge.nonBlockingGaps,\n  ])\n  const preflight = await runKnowledgePreflight(task, questions, acquisitionPlans, options.knowledge, options.onEvent)\n  if (options.knowledge?.refreshReadiness && (Object.keys(preflight.userAnswers).length > 0 || preflight.acquiredEvidenceIds.length > 0)) {\n    await emit(options.onEvent, { type: 'readiness_start', task })\n    knowledge = await options.knowledge.refreshReadiness({\n      task,\n      previous: knowledge,\n      userAnswers: preflight.userAnswers,\n      acquiredEvidenceIds: preflight.acquiredEvidenceIds,\n    })\n    await emit(options.onEvent, { type: 'readiness_end', task, knowledge })\n  }\n\n  await emit(options.onEvent, { type: 'control_start', task, knowledge })\n  const control = await runAgentControlLoop<TState, TAction, TActionResult, TEval>({\n    intent: task.intent,\n    budget: task.budget,\n    signal: options.signal,\n    store: options.store,\n    scenarioId: options.scenarioId ?? task.id,\n    projectId: options.projectId,\n    variantId: options.variantId,\n    observe: ({ history, abortSignal }) => options.adapter.observe({ task, knowledge, history, abortSignal }),\n    validate: async ({ state, history, abortSignal }) => {\n      const readinessEval = blockingKnowledgeEval(knowledge, { minimumScore: options.minimumReadinessScore })\n      const evals = await options.adapter.validate({ task, knowledge, state, history, abortSignal })\n      return [readinessEval as TEval, ...evals]\n    },\n    decide: (ctx) => {\n      if (isKnowledgeBlocked(ctx.evals)) {\n        return options.adapter.onKnowledgeBlocked?.({ task, knowledge, questions, acquisitionPlans }) ?? {\n          type: 'stop',\n          pass: false,\n          score: knowledge.readinessScore,\n          reason: `knowledge readiness blocked: ${knowledge.reason}`,\n        }\n      }\n      return options.adapter.decide(toAgentContext(task, knowledge, ctx))\n    },\n    act: (action, ctx) => options.adapter.act(action, toAgentContext(task, knowledge, ctx)),\n    shouldStop: options.adapter.shouldStop\n      ? (ctx) => options.adapter.shouldStop!(toAgentContext(task, knowledge, ctx))\n      : undefined,\n    getActionCostUsd: options.adapter.getActionCostUsd\n      ? ({ action, result, state, evals, history }) => options.adapter.getActionCostUsd!({ action, result, task, state, evals, history })\n      : undefined,\n    onStep: (step) => emit(options.onEvent, { type: 'control_step', task, step }),\n  })\n  await emit(options.onEvent, { type: 'control_end', task, control })\n  const status = statusFromControl(control)\n  await emit(options.onEvent, { type: 'task_end', task, status, reason: control.reason })\n\n  return {\n    task,\n    status,\n    knowledge,\n    questions,\n    acquisitionPlans,\n    userAnswers: preflight.userAnswers,\n    acquiredEvidenceIds: preflight.acquiredEvidenceIds,\n    control,\n    runRecords: options.adapter.projectRunRecords?.(control, task) ?? [],\n  }\n}\n\nexport function summarizeAgentTaskRun<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  result: AgentTaskRunResult<TState, TAction, TActionResult, TEval>,\n): AgentTaskRunSummary {\n  return {\n    taskId: result.task.id,\n    domain: result.task.domain,\n    status: result.status,\n    reason: result.control.reason,\n    readinessScore: result.knowledge.readinessScore,\n    recommendedAction: result.knowledge.recommendedAction,\n    blockingGapIds: result.knowledge.blockingMissingRequirements.map((requirement) => requirement.id),\n    nonBlockingGapIds: result.knowledge.nonBlockingGaps.map((requirement) => requirement.id),\n    questionCount: result.questions.length,\n    acquisitionPlanCount: result.acquisitionPlans.length,\n    acquiredEvidenceCount: result.acquiredEvidenceIds.length,\n    controlStepCount: result.control.steps.length,\n    pass: result.control.pass,\n    failureClass: result.control.failureClass,\n    wallMs: result.control.wallMs,\n    costUsd: result.control.spentCostUsd,\n  }\n}\n\nexport function sanitizeKnowledgeReadinessReport(\n  report: KnowledgeReadinessReport,\n  options: RuntimeTelemetryOptions = {},\n): SanitizedKnowledgeReadinessReport {\n  return {\n    taskId: report.taskId,\n    readinessScore: report.readinessScore,\n    recommendedAction: report.recommendedAction,\n    severity: report.severity,\n    reason: report.reason,\n    blockingMissingRequirements: report.blockingMissingRequirements.map((requirement) =>\n      sanitizeKnowledgeRequirement(requirement, options),\n    ),\n    nonBlockingGaps: report.nonBlockingGaps.map((requirement) =>\n      sanitizeKnowledgeRequirement(requirement, options),\n    ),\n    evidenceCount: report.bundle.evidenceIds.length,\n    evidenceIds: options.includeEvidenceIds ? report.bundle.evidenceIds : undefined,\n    missingRequirementIds: report.bundle.missing.map((requirement) => requirement.id),\n  }\n}\n\nexport function sanitizeAgentRuntimeEvent<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  event: AgentRuntimeEvent<TState, TAction, TActionResult, TEval>,\n  options: RuntimeTelemetryOptions = {},\n): Record<string, unknown> {\n  const base = { type: event.type, task: sanitizeTask(event.task, options) }\n  if (event.type === 'readiness_start' || event.type === 'task_start' || event.type === 'control_start') {\n    return event.type === 'control_start'\n      ? { ...base, knowledge: sanitizeKnowledgeReadinessReport(event.knowledge, options) }\n      : base\n  }\n  if (event.type === 'readiness_end') {\n    return { ...base, knowledge: sanitizeKnowledgeReadinessReport(event.knowledge, options) }\n  }\n  if (event.type === 'questions_start') {\n    return { ...base, questions: event.questions.map((question) => sanitizeQuestion(question, options)) }\n  }\n  if (event.type === 'questions_end') {\n    return {\n      ...base,\n      questions: event.questions.map((question) => sanitizeQuestion(question, options)),\n      userAnswers: options.includeUserAnswers ? event.userAnswers : redactRecord(event.userAnswers),\n    }\n  }\n  if (event.type === 'acquisition_start') {\n    return { ...base, acquisitionPlans: event.acquisitionPlans.map(sanitizeAcquisitionPlan) }\n  }\n  if (event.type === 'acquisition_end') {\n    return {\n      ...base,\n      acquisitionPlans: event.acquisitionPlans.map(sanitizeAcquisitionPlan),\n      acquiredEvidenceCount: event.acquiredEvidenceIds.length,\n      acquiredEvidenceIds: options.includeEvidenceIds ? event.acquiredEvidenceIds : undefined,\n    }\n  }\n  if (event.type === 'control_step') {\n    return { ...base, step: sanitizeControlStep(event.step, options) }\n  }\n  if (event.type === 'control_end') {\n    return { ...base, control: sanitizeControlRun(event.control, options) }\n  }\n  return { ...base, status: event.status, reason: event.reason }\n}\n\nexport function createRuntimeEventCollector<TState = unknown, TAction = unknown, TActionResult = unknown, TEval extends ControlEvalResult = ControlEvalResult>(\n  options: RuntimeTelemetryOptions = {},\n): RuntimeEventCollector<TState, TAction, TActionResult, TEval> {\n  const events: Array<Record<string, unknown>> = []\n  return {\n    events,\n    onEvent: (event) => {\n      events.push(sanitizeAgentRuntimeEvent(event, options))\n    },\n  }\n}\n\nasync function runKnowledgePreflight<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  task: AgentTaskSpec,\n  questions: UserQuestion[],\n  acquisitionPlans: DataAcquisitionPlan[],\n  provider: AgentKnowledgeProvider | undefined,\n  onEvent: AgentRuntimeEventSink<TState, TAction, TActionResult, TEval> | undefined,\n): Promise<{ userAnswers: Record<string, string>; acquiredEvidenceIds: string[] }> {\n  let userAnswers: Record<string, string> = {}\n  let acquiredEvidenceIds: string[] = []\n  if (questions.length > 0 && provider?.answerQuestions) {\n    await emit(onEvent, { type: 'questions_start', task, questions })\n    userAnswers = await provider.answerQuestions(questions, task)\n    await emit(onEvent, { type: 'questions_end', task, questions, userAnswers })\n  }\n  if (acquisitionPlans.length > 0 && provider?.executeAcquisitionPlans) {\n    await emit(onEvent, { type: 'acquisition_start', task, acquisitionPlans })\n    acquiredEvidenceIds = await provider.executeAcquisitionPlans(acquisitionPlans, task)\n    await emit(onEvent, { type: 'acquisition_end', task, acquisitionPlans, acquiredEvidenceIds })\n  }\n  return { userAnswers, acquiredEvidenceIds }\n}\n\nfunction sanitizeTask(task: AgentTaskSpec, options: RuntimeTelemetryOptions): Record<string, unknown> {\n  return {\n    id: task.id,\n    intent: task.intent,\n    domain: task.domain,\n    inputs: options.includeInputs ? task.inputs : task.inputs ? '[redacted]' : undefined,\n    requiredKnowledge: task.requiredKnowledge?.map((requirement) =>\n      sanitizeKnowledgeRequirement(requirement, options),\n    ),\n    metadata: options.includeMetadata ? task.metadata : task.metadata ? '[redacted]' : undefined,\n  }\n}\n\nfunction sanitizeKnowledgeRequirement(\n  requirement: KnowledgeRequirement,\n  options: RuntimeTelemetryOptions,\n): SanitizedKnowledgeRequirement {\n  const includeDescription = options.includeRequirementDescriptions && requirement.sensitivity !== 'secret'\n  return {\n    id: requirement.id,\n    description: includeDescription ? requirement.description : undefined,\n    requiredFor: requirement.requiredFor,\n    category: requirement.category,\n    acquisitionMode: requirement.acquisitionMode,\n    importance: requirement.importance,\n    freshness: requirement.freshness,\n    sensitivity: requirement.sensitivity,\n    confidenceNeeded: requirement.confidenceNeeded,\n    currentConfidence: requirement.currentConfidence,\n    evidenceCount: requirement.evidenceIds.length,\n    evidenceIds: options.includeEvidenceIds ? requirement.evidenceIds : undefined,\n    fallbackPolicy: requirement.fallbackPolicy,\n  }\n}\n\nfunction sanitizeQuestion(question: UserQuestion, options: RuntimeTelemetryOptions): Record<string, unknown> {\n  return {\n    id: question.id,\n    question: options.includeRequirementDescriptions && question.answerType !== 'credential'\n      ? question.question\n      : undefined,\n    reason: options.includeRequirementDescriptions ? question.reason : undefined,\n    requirementId: question.requirementId,\n    importance: question.importance,\n    answerType: question.answerType,\n    impactIfUnknown: options.includeRequirementDescriptions ? question.impactIfUnknown : undefined,\n    optionCount: question.options?.length ?? 0,\n  }\n}\n\nfunction sanitizeAcquisitionPlan(plan: DataAcquisitionPlan): Record<string, unknown> {\n  return {\n    id: plan.id,\n    requirementIds: plan.requirementIds,\n    mode: plan.mode,\n    priority: plan.priority,\n    expectedEvidenceCount: plan.expectedEvidenceIds?.length ?? 0,\n    questionCount: plan.questions?.length ?? 0,\n  }\n}\n\nfunction sanitizeControlStep<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  step: ControlStep<TState, TAction, TActionResult, TEval>,\n  options: RuntimeTelemetryOptions,\n): Record<string, unknown> {\n  const actionOutcome = step.actionOutcome\n  return {\n    index: step.index,\n    decisionType: step.decision.type,\n    reason: step.decision.reason,\n    action: options.includeControlPayloads && step.decision.type === 'continue' ? step.decision.action : undefined,\n    result: options.includeControlPayloads && actionOutcome?.ok ? actionOutcome.result : undefined,\n    actionOk: actionOutcome?.ok,\n    actionError: actionOutcome?.ok === false ? actionOutcome.error : undefined,\n    durationMs: actionOutcome?.durationMs,\n    evalsBefore: summarizeEvals(step.evalsBefore, options),\n    evalsAfter: summarizeEvals(step.evalsAfter, options),\n    startedAt: step.startedAt,\n    endedAt: step.endedAt,\n  }\n}\n\nfunction sanitizeControlRun<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  control: ControlRunResult<TState, TAction, TActionResult, TEval>,\n  options: RuntimeTelemetryOptions,\n): Record<string, unknown> {\n  return {\n    pass: control.pass,\n    completed: control.completed,\n    reason: control.reason,\n    score: control.score,\n    stepCount: control.steps.length,\n    wallMs: control.wallMs,\n    spentCostUsd: control.spentCostUsd,\n    failureClass: control.failureClass,\n    stoppedBy: control.stoppedBy,\n    runId: control.runId,\n    runtimeErrorCount: control.runtimeErrors.length,\n    finalEvals: summarizeEvals(control.finalEvals, options),\n  }\n}\n\nfunction summarizeEvals(evals: ControlEvalResult[], options: RuntimeTelemetryOptions): Array<Record<string, unknown>> {\n  return evals.map((evalResult) => ({\n    id: evalResult.id,\n    passed: evalResult.passed,\n    score: evalResult.score,\n    severity: evalResult.severity,\n    objective: evalResult.objective,\n    detail: options.includeEvalDetails ? evalResult.detail : undefined,\n    evidence: options.includeEvalDetails ? evalResult.evidence : undefined,\n  }))\n}\n\nfunction redactRecord(record: Record<string, string>): Record<string, string> {\n  return Object.fromEntries(Object.keys(record).map((key) => [key, '[redacted]']))\n}\n\nfunction buildReadiness(\n  task: AgentTaskSpec,\n  provider: AgentKnowledgeProvider | undefined,\n): Promise<KnowledgeReadinessReport> | KnowledgeReadinessReport {\n  if (provider?.buildReadiness) return provider.buildReadiness(task)\n  return scoreKnowledgeReadiness({\n    taskId: task.id,\n    requirements: task.requiredKnowledge ?? [],\n    metadata: { domain: task.domain, ...task.metadata },\n  })\n}\n\nfunction isKnowledgeBlocked(evals: ControlEvalResult[]): boolean {\n  return evals.some((evalResult) => evalResult.id === 'knowledge-ready' && !evalResult.passed)\n}\n\nfunction statusFromControl(control: ControlRunResult<unknown, unknown, unknown, ControlEvalResult>): AgentTaskStatus {\n  if (control.stoppedBy === 'abort') return 'aborted'\n  if (control.reason.includes('knowledge readiness blocked')) return 'blocked'\n  if (control.pass) return 'completed'\n  return 'failed'\n}\n\nasync function emit<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  sink: AgentRuntimeEventSink<TState, TAction, TActionResult, TEval> | undefined,\n  event: AgentRuntimeEvent<TState, TAction, TActionResult, TEval>,\n): Promise<void> {\n  await sink?.(event)\n}\n\nfunction toAgentContext<TState, TAction, TActionResult, TEval extends ControlEvalResult>(\n  task: AgentTaskSpec,\n  knowledge: KnowledgeReadinessReport,\n  ctx: ControlContext<TState, TAction, TActionResult, TEval>,\n): AgentTaskContext<TState, TAction, TActionResult, TEval> {\n  return {\n    task,\n    knowledge,\n    state: ctx.state,\n    evals: ctx.evals,\n    history: ctx.history,\n    budget: ctx.budget,\n    stepIndex: ctx.stepIndex,\n    wallMs: ctx.wallMs,\n    spentCostUsd: ctx.spentCostUsd,\n    remainingCostUsd: ctx.remainingCostUsd,\n    abortSignal: ctx.abortSignal,\n  }\n}\n\nexport type {\n  ControlBudget,\n  ControlDecision,\n  ControlEvalResult,\n  ControlRunResult,\n  ControlStep,\n  DataAcquisitionPlan,\n  KnowledgeReadinessReport,\n  KnowledgeRequirement,\n  RunRecord,\n  UserQuestion,\n} from '@tangle-network/agent-eval'\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-runtime",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Reusable runtime lifecycle for domain-specific agents.",
   "homepage": "https://github.com/tangle-network/agent-runtime#readme",
   "repository": {