@tangle-network/agent-runtime 0.3.0 → 0.4.0

package/README.md

@@ -92,6 +92,10 @@ specific fields with `includeInputs`, `includeUserAnswers`,
 `includeRequirementDescriptions`. Task metadata and eval details are also
 redacted unless `includeMetadata` or `includeEvalDetails` is set.
 
+For control policies or route handlers that need a stable readiness branch,
+use `decideKnowledgeReadiness(report)`. It returns `ready`, `blocked`, or
+`caveat` plus gap IDs and the recommended action.
+
 Knowledge providers may implement:
 
 - `buildReadiness`

package/dist/index.d.ts

@@ -200,6 +200,7 @@ interface AgentTaskRunSummary {
     domain?: string;
     status: AgentTaskStatus;
     reason: string;
+    readinessStatus: KnowledgeReadinessDecision['status'];
     readinessScore: number;
     recommendedAction: KnowledgeReadinessReport['recommendedAction'];
     blockingGapIds: string[];
@@ -213,14 +214,27 @@ interface AgentTaskRunSummary {
     wallMs: number;
     costUsd: number;
 }
+interface KnowledgeReadinessDecision {
+    passed: boolean;
+    status: 'ready' | 'blocked' | 'caveat';
+    reason: string;
+    readinessScore: number;
+    recommendedAction: KnowledgeReadinessReport['recommendedAction'];
+    severity: KnowledgeReadinessReport['severity'];
+    blockingGapIds: string[];
+    nonBlockingGapIds: string[];
+}
 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 decideKnowledgeReadiness(report: KnowledgeReadinessReport, options?: {
+    minimumScore?: number;
+}): KnowledgeReadinessDecision;
 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 AgentTaskRunSummary, type AgentTaskSpec, type AgentTaskStatus, type RunAgentTaskOptions, type RuntimeEventCollector, type RuntimeTelemetryOptions, type SanitizedKnowledgeReadinessReport, type SanitizedKnowledgeRequirement, createRuntimeEventCollector, runAgentTask, sanitizeAgentRuntimeEvent, sanitizeKnowledgeReadinessReport, summarizeAgentTaskRun };
+export { type AgentAdapter, type AgentKnowledgeProvider, type AgentRuntimeEvent, type AgentRuntimeEventSink, type AgentTaskContext, type AgentTaskRunResult, type AgentTaskRunSummary, type AgentTaskSpec, type AgentTaskStatus, type KnowledgeReadinessDecision, type RunAgentTaskOptions, type RuntimeEventCollector, type RuntimeTelemetryOptions, type SanitizedKnowledgeReadinessReport, type SanitizedKnowledgeRequirement, createRuntimeEventCollector, decideKnowledgeReadiness, runAgentTask, sanitizeAgentRuntimeEvent, sanitizeKnowledgeReadinessReport, summarizeAgentTaskRun };

package/dist/index.js

@@ -80,6 +80,7 @@ function summarizeAgentTaskRun(result) {
     domain: result.task.domain,
     status: result.status,
     reason: result.control.reason,
+    readinessStatus: decideKnowledgeReadiness(result.knowledge).status,
     readinessScore: result.knowledge.readinessScore,
     recommendedAction: result.knowledge.recommendedAction,
     blockingGapIds: result.knowledge.blockingMissingRequirements.map((requirement) => requirement.id),
@@ -94,6 +95,45 @@ function summarizeAgentTaskRun(result) {
     costUsd: result.control.spentCostUsd
   };
 }
+function decideKnowledgeReadiness(report, options = {}) {
+  const minimumScore = options.minimumScore ?? 0.7;
+  const blockingGapIds = report.blockingMissingRequirements.map((requirement) => requirement.id);
+  const nonBlockingGapIds = report.nonBlockingGaps.map((requirement) => requirement.id);
+  if (blockingGapIds.length > 0) {
+    return {
+      passed: false,
+      status: "blocked",
+      reason: report.reason,
+      readinessScore: report.readinessScore,
+      recommendedAction: report.recommendedAction,
+      severity: report.severity,
+      blockingGapIds,
+      nonBlockingGapIds
+    };
+  }
+  if (report.readinessScore < minimumScore) {
+    return {
+      passed: false,
+      status: "caveat",
+      reason: `Knowledge readiness score ${report.readinessScore.toFixed(3)} is below minimum ${minimumScore.toFixed(3)}.`,
+      readinessScore: report.readinessScore,
+      recommendedAction: report.recommendedAction,
+      severity: report.severity,
+      blockingGapIds,
+      nonBlockingGapIds
+    };
+  }
+  return {
+    passed: true,
+    status: "ready",
+    reason: report.reason,
+    readinessScore: report.readinessScore,
+    recommendedAction: report.recommendedAction,
+    severity: report.severity,
+    blockingGapIds,
+    nonBlockingGapIds
+  };
+}
 function sanitizeKnowledgeReadinessReport(report, options = {}) {
   return {
     taskId: report.taskId,
@@ -309,6 +349,7 @@ function toAgentContext(task, knowledge, ctx) {
 }
 export {
   createRuntimeEventCollector,
+  decideKnowledgeReadiness,
   runAgentTask,
   sanitizeAgentRuntimeEvent,
   sanitizeKnowledgeReadinessReport,

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 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":[]}
+{"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  readinessStatus: KnowledgeReadinessDecision['status']\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 KnowledgeReadinessDecision {\n  passed: boolean\n  status: 'ready' | 'blocked' | 'caveat'\n  reason: string\n  readinessScore: number\n  recommendedAction: KnowledgeReadinessReport['recommendedAction']\n  severity: KnowledgeReadinessReport['severity']\n  blockingGapIds: string[]\n  nonBlockingGapIds: string[]\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    readinessStatus: decideKnowledgeReadiness(result.knowledge).status,\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 decideKnowledgeReadiness(\n  report: KnowledgeReadinessReport,\n  options: { minimumScore?: number } = {},\n): KnowledgeReadinessDecision {\n  const minimumScore = options.minimumScore ?? 0.7\n  const blockingGapIds = report.blockingMissingRequirements.map((requirement) => requirement.id)\n  const nonBlockingGapIds = report.nonBlockingGaps.map((requirement) => requirement.id)\n  if (blockingGapIds.length > 0) {\n    return {\n      passed: false,\n      status: 'blocked',\n      reason: report.reason,\n      readinessScore: report.readinessScore,\n      recommendedAction: report.recommendedAction,\n      severity: report.severity,\n      blockingGapIds,\n      nonBlockingGapIds,\n    }\n  }\n  if (report.readinessScore < minimumScore) {\n    return {\n      passed: false,\n      status: 'caveat',\n      reason: `Knowledge readiness score ${report.readinessScore.toFixed(3)} is below minimum ${minimumScore.toFixed(3)}.`,\n      readinessScore: report.readinessScore,\n      recommendedAction: report.recommendedAction,\n      severity: report.severity,\n      blockingGapIds,\n      nonBlockingGapIds,\n    }\n  }\n  return {\n    passed: true,\n    status: 'ready',\n    reason: report.reason,\n    readinessScore: report.readinessScore,\n    recommendedAction: report.recommendedAction,\n    severity: report.severity,\n    blockingGapIds,\n    nonBlockingGapIds,\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":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAaK;AA+NP,eAAsB,aACpB,SACoE;AACpE,QAAM,OAAO,QAAQ;AACrB,QAAM,KAAK,QAAQ,SAAS,EAAE,MAAM,cAAc,KAAK,CAAC;AACxD,QAAM,KAAK,QAAQ,SAAS,EAAE,MAAM,mBAAmB,KAAK,CAAC;AAC7D,MAAI,YAAY,MAAM,eAAe,MAAM,QAAQ,SAAS;AAC5D,QAAM,KAAK,QAAQ,SAAS,EAAE,MAAM,iBAAiB,MAAM,UAAU,CAAC;AACtE,QAAM,YAAY,8BAA8B,UAAU,2BAA2B;AACrF,QAAM,mBAAmB,iCAAiC;AAAA,IACxD,GAAG,UAAU;AAAA,IACb,GAAG,UAAU;AAAA,EACf,CAAC;AACD,QAAM,YAAY,MAAM,sBAAsB,MAAM,WAAW,kBAAkB,QAAQ,WAAW,QAAQ,OAAO;AACnH,MAAI,QAAQ,WAAW,qBAAqB,OAAO,KAAK,UAAU,WAAW,EAAE,SAAS,KAAK,UAAU,oBAAoB,SAAS,IAAI;AACtI,UAAM,KAAK,QAAQ,SAAS,EAAE,MAAM,mBAAmB,KAAK,CAAC;AAC7D,gBAAY,MAAM,QAAQ,UAAU,iBAAiB;AAAA,MACnD;AAAA,MACA,UAAU;AAAA,MACV,aAAa,UAAU;AAAA,MACvB,qBAAqB,UAAU;AAAA,IACjC,CAAC;AACD,UAAM,KAAK,QAAQ,SAAS,EAAE,MAAM,iBAAiB,MAAM,UAAU,CAAC;AAAA,EACxE;AAEA,QAAM,KAAK,QAAQ,SAAS,EAAE,MAAM,iBAAiB,MAAM,UAAU,CAAC;AACtE,QAAM,UAAU,MAAM,oBAA2D;AAAA,IAC/E,QAAQ,KAAK;AAAA,IACb,QAAQ,KAAK;AAAA,IACb,QAAQ,QAAQ;AAAA,IAChB,OAAO,QAAQ;AAAA,IACf,YAAY,QAAQ,cAAc,KAAK;AAAA,IACvC,WAAW,QAAQ;AAAA,IACnB,WAAW,QAAQ;AAAA,IACnB,SAAS,CAAC,EAAE,SAAS,YAAY,MAAM,QAAQ,QAAQ,QAAQ,EAAE,MAAM,WAAW,SAAS,YAAY,CAAC;AAAA,IACxG,UAAU,OAAO,EAAE,OAAO,SAAS,YAAY,MAAM;AACnD,YAAM,gBAAgB,sBAAsB,WAAW,EAAE,cAAc,QAAQ,sBAAsB,CAAC;AACtG,YAAM,QAAQ,MAAM,QAAQ,QAAQ,SAAS,EAAE,MAAM,WAAW,OAAO,SAAS,YAAY,CAAC;AAC7F,aAAO,CAAC,eAAwB,GAAG,KAAK;AAAA,IAC1C;AAAA,IACA,QAAQ,CAAC,QAAQ;AACf,UAAI,mBAAmB,IAAI,KAAK,GAAG;AACjC,eAAO,QAAQ,QAAQ,qBAAqB,EAAE,MAAM,WAAW,WAAW,iBAAiB,CAAC,KAAK;AAAA,UAC/F,MAAM;AAAA,UACN,MAAM;AAAA,UACN,OAAO,UAAU;AAAA,UACjB,QAAQ,gCAAgC,UAAU,MAAM;AAAA,QAC1D;AAAA,MACF;AACA,aAAO,QAAQ,QAAQ,OAAO,eAAe,MAAM,WAAW,GAAG,CAAC;AAAA,IACpE;AAAA,IACA,KAAK,CAAC,QAAQ,QAAQ,QAAQ,QAAQ,IAAI,QAAQ,eAAe,MAAM,WAAW,GAAG,CAAC;AAAA,IACtF,YAAY,QAAQ,QAAQ,aACxB,CAAC,QAAQ,QAAQ,QAAQ,WAAY,eAAe,MAAM,WAAW,GAAG,CAAC,IACzE;AAAA,IACJ,kBAAkB,QAAQ,QAAQ,mBAC9B,CAAC,EAAE,QAAQ,QAAQ,OAAO,OAAO,QAAQ,MAAM,QAAQ,QAAQ,iBAAkB,EAAE,QAAQ,QAAQ,MAAM,OAAO,OAAO,QAAQ,CAAC,IAChI;AAAA,IACJ,QAAQ,CAAC,SAAS,KAAK,QAAQ,SAAS,EAAE,MAAM,gBAAgB,MAAM,KAAK,CAAC;AAAA,EAC9E,CAAC;AACD,QAAM,KAAK,QAAQ,SAAS,EAAE,MAAM,eAAe,MAAM,QAAQ,CAAC;AAClE,QAAM,SAAS,kBAAkB,OAAO;AACxC,QAAM,KAAK,QAAQ,SAAS,EAAE,MAAM,YAAY,MAAM,QAAQ,QAAQ,QAAQ,OAAO,CAAC;AAEtF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa,UAAU;AAAA,IACvB,qBAAqB,UAAU;AAAA,IAC/B;AAAA,IACA,YAAY,QAAQ,QAAQ,oBAAoB,SAAS,IAAI,KAAK,CAAC;AAAA,EACrE;AACF;AAEO,SAAS,sBACd,QACqB;AACrB,SAAO;AAAA,IACL,QAAQ,OAAO,KAAK;AAAA,IACpB,QAAQ,OAAO,KAAK;AAAA,IACpB,QAAQ,OAAO;AAAA,IACf,QAAQ,OAAO,QAAQ;AAAA,IACvB,iBAAiB,yBAAyB,OAAO,SAAS,EAAE;AAAA,IAC5D,gBAAgB,OAAO,UAAU;AAAA,IACjC,mBAAmB,OAAO,UAAU;AAAA,IACpC,gBAAgB,OAAO,UAAU,4BAA4B,IAAI,CAAC,gBAAgB,YAAY,EAAE;AAAA,IAChG,mBAAmB,OAAO,UAAU,gBAAgB,IAAI,CAAC,gBAAgB,YAAY,EAAE;AAAA,IACvF,eAAe,OAAO,UAAU;AAAA,IAChC,sBAAsB,OAAO,iBAAiB;AAAA,IAC9C,uBAAuB,OAAO,oBAAoB;AAAA,IAClD,kBAAkB,OAAO,QAAQ,MAAM;AAAA,IACvC,MAAM,OAAO,QAAQ;AAAA,IACrB,cAAc,OAAO,QAAQ;AAAA,IAC7B,QAAQ,OAAO,QAAQ;AAAA,IACvB,SAAS,OAAO,QAAQ;AAAA,EAC1B;AACF;AAEO,SAAS,yBACd,QACA,UAAqC,CAAC,GACV;AAC5B,QAAM,eAAe,QAAQ,gBAAgB;AAC7C,QAAM,iBAAiB,OAAO,4BAA4B,IAAI,CAAC,gBAAgB,YAAY,EAAE;AAC7F,QAAM,oBAAoB,OAAO,gBAAgB,IAAI,CAAC,gBAAgB,YAAY,EAAE;AACpF,MAAI,eAAe,SAAS,GAAG;AAC7B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,QAAQ,OAAO;AAAA,MACf,gBAAgB,OAAO;AAAA,MACvB,mBAAmB,OAAO;AAAA,MAC1B,UAAU,OAAO;AAAA,MACjB;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,MAAI,OAAO,iBAAiB,cAAc;AACxC,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,QAAQ,6BAA6B,OAAO,eAAe,QAAQ,CAAC,CAAC,qBAAqB,aAAa,QAAQ,CAAC,CAAC;AAAA,MACjH,gBAAgB,OAAO;AAAA,MACvB,mBAAmB,OAAO;AAAA,MAC1B,UAAU,OAAO;AAAA,MACjB;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,QAAQ,OAAO;AAAA,IACf,gBAAgB,OAAO;AAAA,IACvB,mBAAmB,OAAO;AAAA,IAC1B,UAAU,OAAO;AAAA,IACjB;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,iCACd,QACA,UAAmC,CAAC,GACD;AACnC,SAAO;AAAA,IACL,QAAQ,OAAO;AAAA,IACf,gBAAgB,OAAO;AAAA,IACvB,mBAAmB,OAAO;AAAA,IAC1B,UAAU,OAAO;AAAA,IACjB,QAAQ,OAAO;AAAA,IACf,6BAA6B,OAAO,4BAA4B;AAAA,MAAI,CAAC,gBACnE,6BAA6B,aAAa,OAAO;AAAA,IACnD;AAAA,IACA,iBAAiB,OAAO,gBAAgB;AAAA,MAAI,CAAC,gBAC3C,6BAA6B,aAAa,OAAO;AAAA,IACnD;AAAA,IACA,eAAe,OAAO,OAAO,YAAY;AAAA,IACzC,aAAa,QAAQ,qBAAqB,OAAO,OAAO,cAAc;AAAA,IACtE,uBAAuB,OAAO,OAAO,QAAQ,IAAI,CAAC,gBAAgB,YAAY,EAAE;AAAA,EAClF;AACF;AAEO,SAAS,0BACd,OACA,UAAmC,CAAC,GACX;AACzB,QAAM,OAAO,EAAE,MAAM,MAAM,MAAM,MAAM,aAAa,MAAM,MAAM,OAAO,EAAE;AACzE,MAAI,MAAM,SAAS,qBAAqB,MAAM,SAAS,gBAAgB,MAAM,SAAS,iBAAiB;AACrG,WAAO,MAAM,SAAS,kBAClB,EAAE,GAAG,MAAM,WAAW,iCAAiC,MAAM,WAAW,OAAO,EAAE,IACjF;AAAA,EACN;AACA,MAAI,MAAM,SAAS,iBAAiB;AAClC,WAAO,EAAE,GAAG,MAAM,WAAW,iCAAiC,MAAM,WAAW,OAAO,EAAE;AAAA,EAC1F;AACA,MAAI,MAAM,SAAS,mBAAmB;AACpC,WAAO,EAAE,GAAG,MAAM,WAAW,MAAM,UAAU,IAAI,CAAC,aAAa,iBAAiB,UAAU,OAAO,CAAC,EAAE;AAAA,EACtG;AACA,MAAI,MAAM,SAAS,iBAAiB;AAClC,WAAO;AAAA,MACL,GAAG;AAAA,MACH,WAAW,MAAM,UAAU,IAAI,CAAC,aAAa,iBAAiB,UAAU,OAAO,CAAC;AAAA,MAChF,aAAa,QAAQ,qBAAqB,MAAM,cAAc,aAAa,MAAM,WAAW;AAAA,IAC9F;AAAA,EACF;AACA,MAAI,MAAM,SAAS,qBAAqB;AACtC,WAAO,EAAE,GAAG,MAAM,kBAAkB,MAAM,iBAAiB,IAAI,uBAAuB,EAAE;AAAA,EAC1F;AACA,MAAI,MAAM,SAAS,mBAAmB;AACpC,WAAO;AAAA,MACL,GAAG;AAAA,MACH,kBAAkB,MAAM,iBAAiB,IAAI,uBAAuB;AAAA,MACpE,uBAAuB,MAAM,oBAAoB;AAAA,MACjD,qBAAqB,QAAQ,qBAAqB,MAAM,sBAAsB;AAAA,IAChF;AAAA,EACF;AACA,MAAI,MAAM,SAAS,gBAAgB;AACjC,WAAO,EAAE,GAAG,MAAM,MAAM,oBAAoB,MAAM,MAAM,OAAO,EAAE;AAAA,EACnE;AACA,MAAI,MAAM,SAAS,eAAe;AAChC,WAAO,EAAE,GAAG,MAAM,SAAS,mBAAmB,MAAM,SAAS,OAAO,EAAE;AAAA,EACxE;AACA,SAAO,EAAE,GAAG,MAAM,QAAQ,MAAM,QAAQ,QAAQ,MAAM,OAAO;AAC/D;AAEO,SAAS,4BACd,UAAmC,CAAC,GAC0B;AAC9D,QAAM,SAAyC,CAAC;AAChD,SAAO;AAAA,IACL;AAAA,IACA,SAAS,CAAC,UAAU;AAClB,aAAO,KAAK,0BAA0B,OAAO,OAAO,CAAC;AAAA,IACvD;AAAA,EACF;AACF;AAEA,eAAe,sBACb,MACA,WACA,kBACA,UACA,SACiF;AACjF,MAAI,cAAsC,CAAC;AAC3C,MAAI,sBAAgC,CAAC;AACrC,MAAI,UAAU,SAAS,KAAK,UAAU,iBAAiB;AACrD,UAAM,KAAK,SAAS,EAAE,MAAM,mBAAmB,MAAM,UAAU,CAAC;AAChE,kBAAc,MAAM,SAAS,gBAAgB,WAAW,IAAI;AAC5D,UAAM,KAAK,SAAS,EAAE,MAAM,iBAAiB,MAAM,WAAW,YAAY,CAAC;AAAA,EAC7E;AACA,MAAI,iBAAiB,SAAS,KAAK,UAAU,yBAAyB;AACpE,UAAM,KAAK,SAAS,EAAE,MAAM,qBAAqB,MAAM,iBAAiB,CAAC;AACzE,0BAAsB,MAAM,SAAS,wBAAwB,kBAAkB,IAAI;AACnF,UAAM,KAAK,SAAS,EAAE,MAAM,mBAAmB,MAAM,kBAAkB,oBAAoB,CAAC;AAAA,EAC9F;AACA,SAAO,EAAE,aAAa,oBAAoB;AAC5C;AAEA,SAAS,aAAa,MAAqB,SAA2D;AACpG,SAAO;AAAA,IACL,IAAI,KAAK;AAAA,IACT,QAAQ,KAAK;AAAA,IACb,QAAQ,KAAK;AAAA,IACb,QAAQ,QAAQ,gBAAgB,KAAK,SAAS,KAAK,SAAS,eAAe;AAAA,IAC3E,mBAAmB,KAAK,mBAAmB;AAAA,MAAI,CAAC,gBAC9C,6BAA6B,aAAa,OAAO;AAAA,IACnD;AAAA,IACA,UAAU,QAAQ,kBAAkB,KAAK,WAAW,KAAK,WAAW,eAAe;AAAA,EACrF;AACF;AAEA,SAAS,6BACP,aACA,SAC+B;AAC/B,QAAM,qBAAqB,QAAQ,kCAAkC,YAAY,gBAAgB;AACjG,SAAO;AAAA,IACL,IAAI,YAAY;AAAA,IAChB,aAAa,qBAAqB,YAAY,cAAc;AAAA,IAC5D,aAAa,YAAY;AAAA,IACzB,UAAU,YAAY;AAAA,IACtB,iBAAiB,YAAY;AAAA,IAC7B,YAAY,YAAY;AAAA,IACxB,WAAW,YAAY;AAAA,IACvB,aAAa,YAAY;AAAA,IACzB,kBAAkB,YAAY;AAAA,IAC9B,mBAAmB,YAAY;AAAA,IAC/B,eAAe,YAAY,YAAY;AAAA,IACvC,aAAa,QAAQ,qBAAqB,YAAY,cAAc;AAAA,IACpE,gBAAgB,YAAY;AAAA,EAC9B;AACF;AAEA,SAAS,iBAAiB,UAAwB,SAA2D;AAC3G,SAAO;AAAA,IACL,IAAI,SAAS;AAAA,IACb,UAAU,QAAQ,kCAAkC,SAAS,eAAe,eACxE,SAAS,WACT;AAAA,IACJ,QAAQ,QAAQ,iCAAiC,SAAS,SAAS;AAAA,IACnE,eAAe,SAAS;AAAA,IACxB,YAAY,SAAS;AAAA,IACrB,YAAY,SAAS;AAAA,IACrB,iBAAiB,QAAQ,iCAAiC,SAAS,kBAAkB;AAAA,IACrF,aAAa,SAAS,SAAS,UAAU;AAAA,EAC3C;AACF;AAEA,SAAS,wBAAwB,MAAoD;AACnF,SAAO;AAAA,IACL,IAAI,KAAK;AAAA,IACT,gBAAgB,KAAK;AAAA,IACrB,MAAM,KAAK;AAAA,IACX,UAAU,KAAK;AAAA,IACf,uBAAuB,KAAK,qBAAqB,UAAU;AAAA,IAC3D,eAAe,KAAK,WAAW,UAAU;AAAA,EAC3C;AACF;AAEA,SAAS,oBACP,MACA,SACyB;AACzB,QAAM,gBAAgB,KAAK;AAC3B,SAAO;AAAA,IACL,OAAO,KAAK;AAAA,IACZ,cAAc,KAAK,SAAS;AAAA,IAC5B,QAAQ,KAAK,SAAS;AAAA,IACtB,QAAQ,QAAQ,0BAA0B,KAAK,SAAS,SAAS,aAAa,KAAK,SAAS,SAAS;AAAA,IACrG,QAAQ,QAAQ,0BAA0B,eAAe,KAAK,cAAc,SAAS;AAAA,IACrF,UAAU,eAAe;AAAA,IACzB,aAAa,eAAe,OAAO,QAAQ,cAAc,QAAQ;AAAA,IACjE,YAAY,eAAe;AAAA,IAC3B,aAAa,eAAe,KAAK,aAAa,OAAO;AAAA,IACrD,YAAY,eAAe,KAAK,YAAY,OAAO;AAAA,IACnD,WAAW,KAAK;AAAA,IAChB,SAAS,KAAK;AAAA,EAChB;AACF;AAEA,SAAS,mBACP,SACA,SACyB;AACzB,SAAO;AAAA,IACL,MAAM,QAAQ;AAAA,IACd,WAAW,QAAQ;AAAA,IACnB,QAAQ,QAAQ;AAAA,IAChB,OAAO,QAAQ;AAAA,IACf,WAAW,QAAQ,MAAM;AAAA,IACzB,QAAQ,QAAQ;AAAA,IAChB,cAAc,QAAQ;AAAA,IACtB,cAAc,QAAQ;AAAA,IACtB,WAAW,QAAQ;AAAA,IACnB,OAAO,QAAQ;AAAA,IACf,mBAAmB,QAAQ,cAAc;AAAA,IACzC,YAAY,eAAe,QAAQ,YAAY,OAAO;AAAA,EACxD;AACF;AAEA,SAAS,eAAe,OAA4B,SAAkE;AACpH,SAAO,MAAM,IAAI,CAAC,gBAAgB;AAAA,IAChC,IAAI,WAAW;AAAA,IACf,QAAQ,WAAW;AAAA,IACnB,OAAO,WAAW;AAAA,IAClB,UAAU,WAAW;AAAA,IACrB,WAAW,WAAW;AAAA,IACtB,QAAQ,QAAQ,qBAAqB,WAAW,SAAS;AAAA,IACzD,UAAU,QAAQ,qBAAqB,WAAW,WAAW;AAAA,EAC/D,EAAE;AACJ;AAEA,SAAS,aAAa,QAAwD;AAC5E,SAAO,OAAO,YAAY,OAAO,KAAK,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,YAAY,CAAC,CAAC;AACjF;AAEA,SAAS,eACP,MACA,UAC8D;AAC9D,MAAI,UAAU,eAAgB,QAAO,SAAS,eAAe,IAAI;AACjE,SAAO,wBAAwB;AAAA,IAC7B,QAAQ,KAAK;AAAA,IACb,cAAc,KAAK,qBAAqB,CAAC;AAAA,IACzC,UAAU,EAAE,QAAQ,KAAK,QAAQ,GAAG,KAAK,SAAS;AAAA,EACpD,CAAC;AACH;AAEA,SAAS,mBAAmB,OAAqC;AAC/D,SAAO,MAAM,KAAK,CAAC,eAAe,WAAW,OAAO,qBAAqB,CAAC,WAAW,MAAM;AAC7F;AAEA,SAAS,kBAAkB,SAA0F;AACnH,MAAI,QAAQ,cAAc,QAAS,QAAO;AAC1C,MAAI,QAAQ,OAAO,SAAS,6BAA6B,EAAG,QAAO;AACnE,MAAI,QAAQ,KAAM,QAAO;AACzB,SAAO;AACT;AAEA,eAAe,KACb,MACA,OACe;AACf,QAAM,OAAO,KAAK;AACpB;AAEA,SAAS,eACP,MACA,WACA,KACyD;AACzD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,IAAI;AAAA,IACX,OAAO,IAAI;AAAA,IACX,SAAS,IAAI;AAAA,IACb,QAAQ,IAAI;AAAA,IACZ,WAAW,IAAI;AAAA,IACf,QAAQ,IAAI;AAAA,IACZ,cAAc,IAAI;AAAA,IAClB,kBAAkB,IAAI;AAAA,IACtB,aAAa,IAAI;AAAA,EACnB;AACF;","names":[]}

package/package.json

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