pi-background-tasks 2.5.0 → 2.6.0

package/dist/src/core/fusion/types.js

@@ -0,0 +1,207 @@
+export const FUSION_MODEL_CONFIG_SCHEMA_VERSION = 'pi-background-tasks.fusion-models.v1';
+export const FUSION_LEGACY_INPUT_SCHEMA_VERSION = 'pi-background-tasks.fusion-input.v4';
+export const FUSION_INPUT_SCHEMA_VERSION = 'pi-background-tasks.fusion-input.v5';
+export const FUSION_EVALUATION_SCHEMA_VERSION = 'pi-background-tasks.fusion-evaluation.v1';
+export const FUSION_VALIDATE_CANDIDATE_SCHEMA_VERSION = 'pi-background-tasks.fusion-validation-candidate.v1';
+export const FUSION_LEGACY_RESULT_SCHEMA_VERSION = 'pi-background-tasks.fusion-result.v4';
+export const FUSION_RESULT_SCHEMA_VERSION = 'pi-background-tasks.fusion-result.v5';
+export const FUSION_COMMITTED_RESULT_SCHEMA_VERSION = 'pi-background-tasks.fusion-committed-result.v1';
+export const FUSION_LEGACY_MANIFEST_SCHEMA_VERSION = 'pi-background-tasks.fusion-manifest.v3';
+export const FUSION_MANIFEST_SCHEMA_VERSION = 'pi-background-tasks.fusion-manifest.v4';
+export const FUSION_CONTEXT_LEDGER_SCHEMA_VERSION = 'pi-background-tasks.fusion-context-ledger.v2';
+export const FUSION_SOURCE_POLICY_SCHEMA_VERSION = 'pi-background-tasks.fusion-source-policy.v1';
+export const FUSION_BUDGET_PLAN_SCHEMA_VERSION = 'pi-background-tasks.fusion-budget-plan.v4';
+export const FUSION_CALIBRATION_VIOLATION_SCHEMA_VERSION = 'pi-background-tasks.fusion-calibration-violation.v2';
+export const FUSION_VALIDATE_CANDIDATE_CONTRACT_EVENT_SCHEMA_VERSION = 'pi-background-tasks.fusion-validation-candidate-contract-event.v1';
+export const FUSION_TOOL_CALL_LOG_SCHEMA_VERSION = 'pi-background-tasks.fusion-tool-call.v1';
+export const FUSION_FAILURE_SUMMARY_SCHEMA_VERSION = 'pi-background-tasks.fusion-failure-summary.v1';
+/**
+ * Conversation-projection transform shared by every Fusion entry point.
+ *
+ * The transform keeps visible user/assistant conversational text verbatim and
+ * replaces assistant thinking plus all tool traffic with deterministic,
+ * hash-accounted omission receipts. It never truncates retained text and never
+ * forwards raw image bytes.
+ */
+export const FUSION_CONTEXT_TRANSFORM_ID = 'visible-conversation-ledger-v2';
+export const FUSION_BRANCH_FILTER_ID = 'exclude-active-fusion-subtree-v1';
+/** Entry-point specific context policies. Both use the same payload-exclusion transform. */
+export const FUSION_TOOL_CONTEXT_POLICY_ID = 'fusion-tool-explicit-v2';
+export const FUSION_COMMAND_CONTEXT_POLICY_ID = 'fusion-command-conversation-v2';
+export const FUSION_IMAGE_OMISSION_PREFIX = '[Image omitted from fusion text transcript: ';
+export const FUSION_CANDIDATE_IDS = ['A', 'B', 'C'];
+export const FUSION_STAGE_VALUES = ['candidate', 'evaluation', 'merge'];
+export const FUSION_CAPABILITY_VALUES = Object.freeze(['reason', 'inspect', 'research']);
+/** No-tools capability for reason candidates, evaluator, repair, and merger. */
+export const FUSION_NO_TOOLS_CAPABILITY = 'reason';
+/** Legacy default retained for old type imports only. New workflows never default. */
+export const FUSION_BRAINSTORM_DEFAULT_CAPABILITY = 'inspect';
+/** @deprecated New v5 workflows have no caller capability default. */
+export const FUSION_DEFAULT_CAPABILITY = FUSION_BRAINSTORM_DEFAULT_CAPABILITY;
+export const FUSION_WEB_FETCH_TOOL_NAME = 'fusion_web_fetch';
+export const FUSION_INSPECT_TOOLS = Object.freeze(['read', 'grep', 'find', 'ls']);
+export const FUSION_RESEARCH_TOOLS = Object.freeze([
+    'read',
+    'grep',
+    'find',
+    'ls',
+    FUSION_WEB_FETCH_TOOL_NAME,
+]);
+/**
+ * Workflow identities sharing one orchestrator, one context projection, one
+ * evaluation schema, and one artifact store. A workflow selects stage framing and
+ * capability policy only; it never changes the canonical input schema.
+ */
+export const FUSION_WORKFLOW_IDS = Object.freeze([
+    'reason',
+    'investigate',
+    'research',
+    'validate',
+]);
+export const FUSION_PUBLIC_WORKFLOW_NAMES = Object.freeze([
+    'fusion_reason',
+    'fusion_investigate',
+    'fusion_research',
+    'fusion_validate',
+]);
+/**
+ * The single capability the validate workflow ever runs candidates with.
+ *
+ * Deliberately separate from the caller-selectable brainstorm default. Although
+ * both workflows currently give candidates read-only inspection, validation pins
+ * that capability as fixed policy rather than exposing a caller override.
+ */
+export const FUSION_VALIDATE_CAPABILITY = 'inspect';
+export const FUSION_FORBIDDEN_TOOLS = Object.freeze([
+    'bash',
+    'edit',
+    'write',
+    'fusion_brainstorm',
+    'fusion_reason',
+    'fusion_investigate',
+    'fusion_research',
+    'fusion_validate',
+    'bg_delegate',
+    'bg_result',
+    'bg_run',
+    'bg_kill',
+    'bg_status',
+    'bg_logs',
+    'bg_run_pi_attested',
+]);
+/**
+ * Prompt-expansion stages guarded by deterministic size accounting. `evaluation`
+ * and `evaluation_repair` share the evaluator model but render different prompts.
+ */
+export const FUSION_BUDGET_STAGE_VALUES = [
+    'candidate',
+    'evaluation',
+    'evaluation_repair',
+    'merge',
+];
+export const FUSION_SOURCE_VALUES = ['command', 'tool'];
+export const FUSION_STATE_VALUES = [
+    'initializing',
+    'candidates_running',
+    'candidates_complete',
+    'evaluating',
+    'evaluation_complete',
+    'merging',
+    'completed',
+    'failed',
+    'cancelled',
+];
+export const FUSION_NONTERMINAL_STATE_VALUES = [
+    'initializing',
+    'candidates_running',
+    'candidates_complete',
+    'evaluating',
+    'evaluation_complete',
+    'merging',
+];
+export const FUSION_TERMINAL_STATE_VALUES = ['completed', 'failed', 'cancelled'];
+export const FUSION_OMITTED_EVENT_KINDS = [
+    'assistant_thinking',
+    'tool_call',
+    'tool_result_text',
+    'tool_result_image',
+];
+const EMPTY_FUSION_COST = Object.freeze({
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    total: 0,
+});
+export const EMPTY_FUSION_USAGE = Object.freeze({
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    totalTokens: 0,
+    cost: EMPTY_FUSION_COST,
+});
+export function createEmptyFusionUsage() {
+    return cloneFusionUsage(EMPTY_FUSION_USAGE);
+}
+export function cloneFusionUsage(usage) {
+    return {
+        input: usage.input,
+        output: usage.output,
+        cacheRead: usage.cacheRead,
+        cacheWrite: usage.cacheWrite,
+        ...(usage.cacheWrite1h === undefined ? {} : { cacheWrite1h: usage.cacheWrite1h }),
+        ...(usage.reasoning === undefined ? {} : { reasoning: usage.reasoning }),
+        totalTokens: usage.totalTokens,
+        cost: {
+            input: usage.cost.input,
+            output: usage.cost.output,
+            cacheRead: usage.cost.cacheRead,
+            cacheWrite: usage.cost.cacheWrite,
+            total: usage.cost.total,
+        },
+    };
+}
+export function addFusionUsage(target, delta) {
+    target.input += delta.input;
+    target.output += delta.output;
+    target.cacheRead += delta.cacheRead;
+    target.cacheWrite += delta.cacheWrite;
+    if (delta.cacheWrite1h !== undefined) {
+        target.cacheWrite1h = (target.cacheWrite1h ?? 0) + delta.cacheWrite1h;
+    }
+    if (delta.reasoning !== undefined) {
+        target.reasoning = (target.reasoning ?? 0) + delta.reasoning;
+    }
+    target.totalTokens += delta.totalTokens;
+    target.cost.input += delta.cost.input;
+    target.cost.output += delta.cost.output;
+    target.cost.cacheRead += delta.cost.cacheRead;
+    target.cost.cacheWrite += delta.cost.cacheWrite;
+    target.cost.total += delta.cost.total;
+}
+export class FusionError extends Error {
+    code;
+    stage;
+    slot;
+    attempt;
+    artifactDir;
+    transient;
+    childCreated;
+    budget;
+    runProgress;
+    constructor(message, details) {
+        super(message);
+        this.name = 'FusionError';
+        this.code = details.code;
+        this.stage = details.stage;
+        this.slot = details.slot;
+        this.attempt = details.attempt;
+        this.artifactDir = details.artifactDir;
+        this.transient = details.transient ?? false;
+        this.childCreated = details.childCreated ?? true;
+        this.budget = details.budget;
+        this.runProgress = details.runProgress;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/core/fusion/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/fusion/types.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Usage } from '@earendil-works/pi-ai';\nimport type {\n  EstimateInputTokensResult,\n  TokenBudgetByteClassBreakdown,\n  TokenBudgetDominantByteClass,\n  TokenBudgetFamily,\n  TokenBudgetFamilyCalibration,\n  TokenBudgetRateSource,\n} from '../context/token-budget.js';\n\nexport type FusionThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';\n\nexport const FUSION_MODEL_CONFIG_SCHEMA_VERSION = 'pi-background-tasks.fusion-models.v1';\nexport const FUSION_LEGACY_INPUT_SCHEMA_VERSION = 'pi-background-tasks.fusion-input.v4';\nexport const FUSION_INPUT_SCHEMA_VERSION = 'pi-background-tasks.fusion-input.v5';\nexport const FUSION_EVALUATION_SCHEMA_VERSION = 'pi-background-tasks.fusion-evaluation.v1';\nexport const FUSION_VALIDATE_CANDIDATE_SCHEMA_VERSION =\n  'pi-background-tasks.fusion-validation-candidate.v1';\nexport const FUSION_LEGACY_RESULT_SCHEMA_VERSION = 'pi-background-tasks.fusion-result.v4';\nexport const FUSION_RESULT_SCHEMA_VERSION = 'pi-background-tasks.fusion-result.v5';\nexport const FUSION_COMMITTED_RESULT_SCHEMA_VERSION =\n  'pi-background-tasks.fusion-committed-result.v1';\nexport const FUSION_LEGACY_MANIFEST_SCHEMA_VERSION = 'pi-background-tasks.fusion-manifest.v3';\nexport const FUSION_MANIFEST_SCHEMA_VERSION = 'pi-background-tasks.fusion-manifest.v4';\nexport const FUSION_CONTEXT_LEDGER_SCHEMA_VERSION = 'pi-background-tasks.fusion-context-ledger.v2';\nexport const FUSION_SOURCE_POLICY_SCHEMA_VERSION = 'pi-background-tasks.fusion-source-policy.v1';\nexport const FUSION_BUDGET_PLAN_SCHEMA_VERSION = 'pi-background-tasks.fusion-budget-plan.v4';\nexport const FUSION_CALIBRATION_VIOLATION_SCHEMA_VERSION =\n  'pi-background-tasks.fusion-calibration-violation.v2';\nexport const FUSION_VALIDATE_CANDIDATE_CONTRACT_EVENT_SCHEMA_VERSION =\n  'pi-background-tasks.fusion-validation-candidate-contract-event.v1';\nexport const FUSION_TOOL_CALL_LOG_SCHEMA_VERSION = 'pi-background-tasks.fusion-tool-call.v1';\nexport const FUSION_FAILURE_SUMMARY_SCHEMA_VERSION =\n  'pi-background-tasks.fusion-failure-summary.v1';\n\n/**\n * Conversation-projection transform shared by every Fusion entry point.\n *\n * The transform keeps visible user/assistant conversational text verbatim and\n * replaces assistant thinking plus all tool traffic with deterministic,\n * hash-accounted omission receipts. It never truncates retained text and never\n * forwards raw image bytes.\n */\nexport const FUSION_CONTEXT_TRANSFORM_ID = 'visible-conversation-ledger-v2';\nexport const FUSION_BRANCH_FILTER_ID = 'exclude-active-fusion-subtree-v1';\n\n/** Entry-point specific context policies. Both use the same payload-exclusion transform. */\nexport const FUSION_TOOL_CONTEXT_POLICY_ID = 'fusion-tool-explicit-v2';\nexport const FUSION_COMMAND_CONTEXT_POLICY_ID = 'fusion-command-conversation-v2';\n\nexport const FUSION_IMAGE_OMISSION_PREFIX = '[Image omitted from fusion text transcript: ';\n\nexport const FUSION_CANDIDATE_IDS = ['A', 'B', 'C'] as const;\nexport type FusionCandidateId = (typeof FUSION_CANDIDATE_IDS)[number];\n\nexport const FUSION_STAGE_VALUES = ['candidate', 'evaluation', 'merge'] as const;\nexport type FusionStage = (typeof FUSION_STAGE_VALUES)[number];\n\nexport const FUSION_CAPABILITY_VALUES = Object.freeze(['reason', 'inspect', 'research'] as const);\nexport type FusionCapability = (typeof FUSION_CAPABILITY_VALUES)[number];\n\n/** No-tools capability for reason candidates, evaluator, repair, and merger. */\nexport const FUSION_NO_TOOLS_CAPABILITY: FusionCapability = 'reason';\n/** Legacy default retained for old type imports only. New workflows never default. */\nexport const FUSION_BRAINSTORM_DEFAULT_CAPABILITY: FusionCapability = 'inspect';\n/** @deprecated New v5 workflows have no caller capability default. */\nexport const FUSION_DEFAULT_CAPABILITY: FusionCapability = FUSION_BRAINSTORM_DEFAULT_CAPABILITY;\n\nexport const FUSION_WEB_FETCH_TOOL_NAME = 'fusion_web_fetch' as const;\nexport const FUSION_INSPECT_TOOLS = Object.freeze(['read', 'grep', 'find', 'ls'] as const);\nexport const FUSION_RESEARCH_TOOLS = Object.freeze([\n  'read',\n  'grep',\n  'find',\n  'ls',\n  FUSION_WEB_FETCH_TOOL_NAME,\n] as const);\n\n/**\n * Workflow identities sharing one orchestrator, one context projection, one\n * evaluation schema, and one artifact store. A workflow selects stage framing and\n * capability policy only; it never changes the canonical input schema.\n */\nexport const FUSION_WORKFLOW_IDS = Object.freeze([\n  'reason',\n  'investigate',\n  'research',\n  'validate',\n] as const);\nexport type FusionWorkflowId = (typeof FUSION_WORKFLOW_IDS)[number];\nexport const FUSION_PUBLIC_WORKFLOW_NAMES = Object.freeze([\n  'fusion_reason',\n  'fusion_investigate',\n  'fusion_research',\n  'fusion_validate',\n] as const);\nexport type FusionPublicWorkflowName = (typeof FUSION_PUBLIC_WORKFLOW_NAMES)[number];\nexport type FusionContextKind = 'session_projection' | 'clean_task';\n\n/**\n * The single capability the validate workflow ever runs candidates with.\n *\n * Deliberately separate from the caller-selectable brainstorm default. Although\n * both workflows currently give candidates read-only inspection, validation pins\n * that capability as fixed policy rather than exposing a caller override.\n */\nexport const FUSION_VALIDATE_CAPABILITY: FusionCapability = 'inspect';\n\nexport const FUSION_FORBIDDEN_TOOLS = Object.freeze([\n  'bash',\n  'edit',\n  'write',\n  'fusion_brainstorm',\n  'fusion_reason',\n  'fusion_investigate',\n  'fusion_research',\n  'fusion_validate',\n  'bg_delegate',\n  'bg_result',\n  'bg_run',\n  'bg_kill',\n  'bg_status',\n  'bg_logs',\n  'bg_run_pi_attested',\n] as const);\n\n/**\n * Prompt-expansion stages guarded by deterministic size accounting. `evaluation`\n * and `evaluation_repair` share the evaluator model but render different prompts.\n */\nexport const FUSION_BUDGET_STAGE_VALUES = [\n  'candidate',\n  'evaluation',\n  'evaluation_repair',\n  'merge',\n] as const;\nexport type FusionBudgetStage = (typeof FUSION_BUDGET_STAGE_VALUES)[number];\n\nexport const FUSION_SOURCE_VALUES = ['command', 'tool'] as const;\nexport type FusionSource = (typeof FUSION_SOURCE_VALUES)[number];\n\nexport const FUSION_STATE_VALUES = [\n  'initializing',\n  'candidates_running',\n  'candidates_complete',\n  'evaluating',\n  'evaluation_complete',\n  'merging',\n  'completed',\n  'failed',\n  'cancelled',\n] as const;\nexport type FusionState = (typeof FUSION_STATE_VALUES)[number];\nexport type FusionTerminalState = Extract<FusionState, 'completed' | 'failed' | 'cancelled'>;\nexport type FusionNonterminalState = Exclude<FusionState, FusionTerminalState>;\n\nexport const FUSION_NONTERMINAL_STATE_VALUES = [\n  'initializing',\n  'candidates_running',\n  'candidates_complete',\n  'evaluating',\n  'evaluation_complete',\n  'merging',\n] as const satisfies readonly FusionNonterminalState[];\n\nexport const FUSION_TERMINAL_STATE_VALUES = ['completed', 'failed', 'cancelled'] as const;\n\nexport type FusionModelSelection = '$current' | string;\n\nexport interface FusionModelConfigV1 {\n  schema_version: typeof FUSION_MODEL_CONFIG_SCHEMA_VERSION;\n  candidates: readonly [FusionModelSelection, FusionModelSelection, FusionModelSelection];\n  evaluator: FusionModelSelection;\n  merger: FusionModelSelection;\n}\n\nexport interface FusionModelConfigRevision {\n  path: string;\n  exists: boolean;\n  sha256: string | null;\n}\n\nexport interface LoadedFusionModelConfig {\n  config: FusionModelConfigV1;\n  revision: FusionModelConfigRevision;\n}\n\nexport interface ResolvedFusionModel {\n  selection: string;\n  source: 'current' | 'configured';\n  provider: string;\n  model: string;\n  qualifiedId: string;\n  thinkingLevel: FusionThinkingLevel;\n  contextWindow: number;\n  maxOutputTokens: number;\n}\n\nexport interface ResolvedFusionModels {\n  candidates: readonly [ResolvedFusionModel, ResolvedFusionModel, ResolvedFusionModel];\n  evaluator: ResolvedFusionModel;\n  merger: ResolvedFusionModel;\n}\n\nexport type FusionRequestAuthority = 'explicit_text' | 'directive_over_projected_conversation';\n\nexport interface FusionCanonicalRequestV3 {\n  /** Entry point that produced this request. */\n  source: FusionSource;\n  /** How children must weigh `text` against the projected conversation. */\n  authority: FusionRequestAuthority;\n  /** Verbatim request text. Never clipped, never rewritten. */\n  text: string;\n  /** Lowercase SHA-256 of the UTF-8 request bytes. */\n  sha256: string;\n}\n\nexport const FUSION_OMITTED_EVENT_KINDS = [\n  'assistant_thinking',\n  'tool_call',\n  'tool_result_text',\n  'tool_result_image',\n] as const;\nexport type FusionOmittedEventKind = (typeof FUSION_OMITTED_EVENT_KINDS)[number];\n\n/** One omitted conversation event. Ledger rows never leave the local artifact directory. */\nexport interface FusionOmittedEventRecord {\n  index: number;\n  source_ordinal: number;\n  block_ordinal: number;\n  kind: FusionOmittedEventKind;\n  payload_bytes: number;\n  payload_sha256: string;\n  tool_name?: string;\n  tool_call_id?: string;\n  mime_type?: string;\n}\n\nexport interface FusionOmittedActivityProjectionMapEntry {\n  canonical_entry_index: number;\n  entry_kind: 'omitted_activity';\n  ledger_index_first: number;\n  ledger_index_last: number;\n}\n\nexport interface FusionLedgerOnlyImageProjectionMapEntry {\n  entry_kind: 'ledger_only_tool_result_image';\n  ledger_index_first: number;\n  ledger_index_last: number;\n}\n\nexport type FusionContextProjectionMapEntry =\n  | FusionOmittedActivityProjectionMapEntry\n  | FusionLedgerOnlyImageProjectionMapEntry;\n\nexport interface FusionContextOmissionLedgerV2 {\n  schema_version: typeof FUSION_CONTEXT_LEDGER_SCHEMA_VERSION;\n  policy_id: string;\n  transform: typeof FUSION_CONTEXT_TRANSFORM_ID;\n  entries: readonly FusionOmittedEventRecord[];\n  projection_map: readonly FusionContextProjectionMapEntry[];\n  root_sha256: string;\n}\n\nexport type FusionProjectionTextEntry = [\n  tag: 't',\n  role: 'u' | 'a',\n  sourceOrdinal: number,\n  blockOrdinal: number,\n  text: string,\n];\n\nexport type FusionProjectionOmissionCounts = [\n  assistantThinking: number,\n  toolCalls: number,\n  toolResults: number,\n];\n\nexport type FusionProjectionOmissionEntry = [\n  tag: 'o',\n  sourceOrdinalSpan: [first: number, last: number],\n  bytes: number,\n  counts: FusionProjectionOmissionCounts,\n];\n\nexport type FusionProjectionEntry = FusionProjectionTextEntry | FusionProjectionOmissionEntry;\n\nexport interface FusionContextPolicyDescriptor {\n  id: string;\n  transform: typeof FUSION_CONTEXT_TRANSFORM_ID;\n  version: 2;\n  receipt_format: 'omitted_activity.v2';\n  user_text: 'verbatim';\n  assistant_text: 'verbatim';\n  assistant_thinking: 'ledger_only';\n  tool_call_arguments: 'ledger_only';\n  tool_results: 'ledger_only';\n  tool_payload_preview_bytes: 0;\n  images: 'marker_or_ledger_only';\n  unknown_block_behavior: 'error';\n}\n\nexport interface FusionBranchFilterDescriptor {\n  id: typeof FUSION_BRANCH_FILTER_ID;\n  tool_name: string;\n  tool_call_id: string | null;\n  active_tool_call_leaf_excluded: boolean;\n}\n\nexport interface FusionToolCallNameCount {\n  name: string;\n  calls: number;\n}\n\nexport interface FusionProjectionAccounting {\n  message_count: number;\n  included_text_entry_count: number;\n  included_user_text_bytes: number;\n  included_assistant_text_bytes: number;\n  included_image_marker_count: number;\n  empty_text_block_count: number;\n  omitted_run_count: number;\n  omitted_event_count: number;\n  omitted_thinking_bytes: number;\n  omitted_tool_call_count: number;\n  omitted_tool_call_argument_bytes: number;\n  omitted_tool_result_text_count: number;\n  omitted_tool_result_text_bytes: number;\n  omitted_tool_result_image_count: number;\n  omitted_tool_result_image_bytes: number;\n  tool_call_names: readonly FusionToolCallNameCount[];\n  ledger_entry_count: number;\n  ledger_root_sha256: string;\n  omission_receipt_utf8_bytes: number;\n}\n\nexport interface FusionConversationProjectionV4 {\n  policy: FusionContextPolicyDescriptor;\n  branch_filter: FusionBranchFilterDescriptor;\n  entries: readonly FusionProjectionEntry[];\n  accounting: FusionProjectionAccounting;\n}\n\nexport type FusionConversationProjectionV3 = FusionConversationProjectionV4;\n\nexport interface FusionDeclaredSourceV1 {\n  url: string;\n  canonical_url: string;\n  purpose: string;\n  sha256: string;\n}\n\nexport interface FusionCleanTaskContextV1 {\n  kind: 'clean_task';\n  policy_id: 'fusion-clean-task-v1';\n  declared_sources: readonly FusionDeclaredSourceV1[];\n}\n\nexport interface FusionSessionProjectionContextV1 {\n  kind: 'session_projection';\n  policy_id: 'fusion-session-projection-v1';\n  system_prompt: string;\n  conversation_projection: FusionConversationProjectionV4;\n}\n\nexport interface FusionCanonicalInputV5Base {\n  schema_version: typeof FUSION_INPUT_SCHEMA_VERSION;\n  workflow?: FusionWorkflowId | undefined;\n  cwd: string;\n  request: FusionCanonicalRequestV3;\n}\n\nexport interface FusionSessionProjectionCanonicalInputV5 extends FusionCanonicalInputV5Base {\n  workflow?: FusionWorkflowId | undefined;\n  /** @deprecated v4 readability alias. Present only for session-projection inputs at runtime. */\n  system_prompt: string;\n  /** @deprecated v4 readability alias. Present only for session-projection inputs at runtime. */\n  conversation_projection: FusionConversationProjectionV4;\n  context?: FusionSessionProjectionContextV1 | undefined;\n}\n\nexport interface FusionCleanTaskCanonicalInputV5 extends FusionCanonicalInputV5Base {\n  workflow: Exclude<FusionWorkflowId, 'reason'>;\n  context: FusionCleanTaskContextV1;\n}\n\nexport type FusionCanonicalInputV5 =\n  | FusionSessionProjectionCanonicalInputV5\n  | FusionCleanTaskCanonicalInputV5;\n\n/** Legacy v4 shape retained for frozen golden fixtures/readability only. */\nexport interface FusionCanonicalInputV4 {\n  schema_version: typeof FUSION_LEGACY_INPUT_SCHEMA_VERSION;\n  cwd: string;\n  system_prompt: string;\n  request: FusionCanonicalRequestV3;\n  conversation_projection: FusionConversationProjectionV4;\n}\n\nexport type FusionCanonicalInputV3 = FusionCanonicalInputV5;\n\nexport interface FusionSourcePolicyV1 {\n  schema_version: typeof FUSION_SOURCE_POLICY_SCHEMA_VERSION;\n  workflow: 'research';\n  cwd: string;\n  sources: readonly FusionDeclaredSourceV1[];\n  root_sha256: string;\n}\n\nexport interface FusionSourcePolicyArtifactRef extends FusionArtifactRef {\n  root_sha256: string;\n}\n\nexport interface CandidateAssessment {\n  candidate_id: FusionCandidateId;\n  summary: string;\n  strengths: readonly string[];\n  limitations: readonly string[];\n  useful_contributions: readonly string[];\n  risks: readonly string[];\n}\n\nexport interface FusionConflictPosition {\n  candidate_id: FusionCandidateId;\n  position: string;\n}\n\nexport interface FusionConflict {\n  topic: string;\n  positions: readonly FusionConflictPosition[];\n  resolution: string;\n}\n\nexport interface FusionSynthesisContribution {\n  candidate_id: FusionCandidateId;\n  contribution: string;\n}\n\nexport interface FusionSynthesisPlan {\n  must_include: readonly FusionSynthesisContribution[];\n  must_resolve: readonly string[];\n  must_avoid: readonly string[];\n}\n\nexport type FusionValidationSeverity = 'critical' | 'high' | 'minor';\n\nexport interface FusionValidationFindingRecord {\n  id: string;\n  candidate_id: FusionCandidateId;\n  severity: FusionValidationSeverity;\n  location: string;\n  evidence: string;\n  impact: string;\n  summary: string;\n}\n\nexport interface FusionValidationFindingDecision {\n  source_id: string;\n  disposition: 'include' | 'exclude';\n  rationale: string;\n  group_id?: string | undefined;\n}\n\nexport interface FusionValidationFindingGroup {\n  group_id: string;\n  source_ids: readonly string[];\n  severity: FusionValidationSeverity;\n  location: string;\n  evidence: string;\n  impact: string;\n  summary: string;\n  rationale: string;\n}\n\nexport interface FusionValidationFindingAccounting {\n  findings: readonly FusionValidationFindingRecord[];\n  decisions: readonly FusionValidationFindingDecision[];\n  groups: readonly FusionValidationFindingGroup[];\n}\n\nexport interface FusionValidationCandidateReportV1 {\n  schema_version: typeof FUSION_VALIDATE_CANDIDATE_SCHEMA_VERSION;\n  findings: readonly Omit<FusionValidationFindingRecord, 'id' | 'candidate_id'>[];\n  verified: readonly string[];\n  limitations: readonly string[];\n}\n\nexport interface FusionEvaluationV1 {\n  schema_version: typeof FUSION_EVALUATION_SCHEMA_VERSION;\n  candidate_assessments: readonly [CandidateAssessment, CandidateAssessment, CandidateAssessment];\n  agreements: readonly string[];\n  conflicts: readonly FusionConflict[];\n  synthesis_plan: FusionSynthesisPlan;\n  validation_accounting?: FusionValidationFindingAccounting | undefined;\n}\n\n/** Exact Pi usage contract used at the child, artifact, and host tool-result boundaries. */\nexport type FusionUsage = Usage;\n\nconst EMPTY_FUSION_COST: Usage['cost'] = Object.freeze({\n  input: 0,\n  output: 0,\n  cacheRead: 0,\n  cacheWrite: 0,\n  total: 0,\n});\n\nexport const EMPTY_FUSION_USAGE: FusionUsage = Object.freeze({\n  input: 0,\n  output: 0,\n  cacheRead: 0,\n  cacheWrite: 0,\n  totalTokens: 0,\n  cost: EMPTY_FUSION_COST,\n});\n\nexport function createEmptyFusionUsage(): FusionUsage {\n  return cloneFusionUsage(EMPTY_FUSION_USAGE);\n}\n\nexport function cloneFusionUsage(usage: FusionUsage): FusionUsage {\n  return {\n    input: usage.input,\n    output: usage.output,\n    cacheRead: usage.cacheRead,\n    cacheWrite: usage.cacheWrite,\n    ...(usage.cacheWrite1h === undefined ? {} : { cacheWrite1h: usage.cacheWrite1h }),\n    ...(usage.reasoning === undefined ? {} : { reasoning: usage.reasoning }),\n    totalTokens: usage.totalTokens,\n    cost: {\n      input: usage.cost.input,\n      output: usage.cost.output,\n      cacheRead: usage.cost.cacheRead,\n      cacheWrite: usage.cost.cacheWrite,\n      total: usage.cost.total,\n    },\n  };\n}\n\nexport function addFusionUsage(target: FusionUsage, delta: FusionUsage): void {\n  target.input += delta.input;\n  target.output += delta.output;\n  target.cacheRead += delta.cacheRead;\n  target.cacheWrite += delta.cacheWrite;\n  if (delta.cacheWrite1h !== undefined) {\n    target.cacheWrite1h = (target.cacheWrite1h ?? 0) + delta.cacheWrite1h;\n  }\n  if (delta.reasoning !== undefined) {\n    target.reasoning = (target.reasoning ?? 0) + delta.reasoning;\n  }\n  target.totalTokens += delta.totalTokens;\n  target.cost.input += delta.cost.input;\n  target.cost.output += delta.cost.output;\n  target.cost.cacheRead += delta.cost.cacheRead;\n  target.cost.cacheWrite += delta.cost.cacheWrite;\n  target.cost.total += delta.cost.total;\n}\n\nexport type FusionRunStageProgressStatus = 'not_started' | 'incomplete' | 'completed';\n\nexport interface FusionRunStageProgress {\n  status: FusionRunStageProgressStatus;\n  attempts_recorded: number;\n  children_created: number;\n  children_completed: number;\n  children_failed: number;\n  children_cancelled: number;\n  not_started_slots?: number | undefined;\n}\n\nexport interface FusionRunProgress {\n  manifest_state: FusionState;\n  candidates: FusionRunStageProgress;\n  evaluation: FusionRunStageProgress;\n  merge: FusionRunStageProgress;\n  usage_so_far: FusionUsage;\n}\n\nexport interface FusionResultBudgetDetails {\n  policy_id: string;\n  calibration_version: string;\n  route_table: readonly FusionRouteCapacity[];\n  rate_sources: readonly TokenBudgetRateSource[];\n  unknown_provider_warnings: readonly string[];\n  calibration_warnings: readonly FusionCalibrationViolation[];\n}\n\nexport interface FusionCommittedResultV1 {\n  schema_version: typeof FUSION_COMMITTED_RESULT_SCHEMA_VERSION;\n  run_id: string;\n  merged: FusionArtifactRef;\n  details: FusionResultDetails;\n}\n\nexport interface FusionResultDetails {\n  schema_version: typeof FUSION_RESULT_SCHEMA_VERSION;\n  run_id: string;\n  workflow: FusionWorkflowId;\n  source: FusionSource;\n  status: 'completed';\n  context: { kind: FusionContextKind; policy_id: string };\n  tool_policy: {\n    candidate_tools: readonly string[];\n    evaluation_tools: readonly [];\n    merge_tools: readonly [];\n  };\n  artifact_dir: string;\n  models: {\n    candidates: readonly [string, string, string];\n    evaluator: string;\n    merger: string;\n    thinking_level: string;\n  };\n  evaluator_attempts: number;\n  usage: FusionUsage;\n  budget: FusionResultBudgetDetails;\n}\n\nexport type FusionProgressEvent =\n  | { type: 'state'; state: FusionState }\n  | { type: 'candidate_started'; slot: 1 | 2 | 3; attempt: number }\n  | { type: 'candidate_completed'; slot: 1 | 2 | 3; completed: number; total: 3 }\n  | { type: 'evaluation_started'; attempt: 1 | 2; repair: boolean }\n  | { type: 'evaluation_retry'; errors: readonly string[] }\n  | { type: 'budget_warning'; warnings: readonly FusionBudgetWarning[]; error: string }\n  | { type: 'calibration_warning'; warning: FusionCalibrationViolation; artifact: string }\n  | { type: 'merge_started' }\n  | { type: 'completed'; runId: string; artifactDir: string }\n  | { type: 'failed'; runId: string; artifactDir: string; error: string }\n  | { type: 'cancelled'; runId: string; artifactDir: string; reason: string };\n\nexport type FusionErrorCode =\n  | 'config_invalid'\n  | 'config_conflict'\n  | 'model_unavailable'\n  | 'context_capture_failed'\n  | 'context_policy_unsupported_block'\n  | 'prompt_budget_exceeded_forecast'\n  | 'prompt_budget_exceeded_measured'\n  | 'model_capacity_unknown'\n  | 'child_spawn_failed'\n  | 'child_stdin_failed'\n  | 'child_event_invalid'\n  | 'child_exit_failed'\n  | 'child_runtime_limit_exceeded'\n  | 'child_runtime_payload_invalid'\n  | 'child_cache_policy_invalid'\n  | 'child_timeout'\n  | 'child_output_cap'\n  | 'child_cancelled'\n  | 'evaluation_invalid'\n  | 'artifact_error'\n  | 'state_transition_invalid'\n  | 'orchestration_failed';\n\nexport type FusionBudgetCheckKind = 'input_only_preflight' | 'rendered_prompt';\n\nexport interface FusionBudgetComponentBreakdown {\n  visible_text: { bytes: number; tokens: number };\n  omission_receipts: { bytes: number; tokens: number };\n  projection_metadata: { bytes: number; tokens: number };\n  request: { bytes: number; tokens: number };\n  static_stage_framing: { bytes: number; tokens: number };\n  upstream_output_contracts: { bytes: number; tokens: number };\n}\n\nexport interface FusionBudgetDenseRegion {\n  offset: number;\n  len: number;\n  detector: 'not_implemented_step_6';\n}\n\nexport interface FusionBudgetRouteTableEntry {\n  role: FusionRouteCapacity['role'];\n  qualified_id: string;\n  allowed_input_tokens: number;\n  family: TokenBudgetFamily;\n  effective_rate_bytes_per_token_x100: number;\n  byte_capacity_utf8_bytes: number;\n  backed: boolean;\n}\n\nexport interface FusionBudgetCounterfactuals {\n  empty_request: FusionBudgetEmptyRequestVerdict;\n  without_reservation: {\n    forecast_input_tokens_upper_bound: number;\n    signed_headroom_tokens: number;\n    fits: boolean;\n  };\n  at_median_rate: {\n    forecast_input_tokens_upper_bound: number | null;\n    signed_headroom_tokens: number | null;\n    fits: boolean | null;\n  };\n}\n\n/** Structured detail attached to a split prompt-budget failure. */\nexport interface FusionBudgetErrorDetail {\n  budget_stage: FusionBudgetStage;\n  slot?: 1 | 2 | 3;\n  measurement_kind: 'stage_forecast' | 'rendered_prompt';\n  check_kind: FusionBudgetCheckKind;\n  measured_utf8_bytes: number;\n  measured_input_tokens_upper_bound: number;\n  allowed_input_tokens: number;\n  limiting_model: {\n    provider: string;\n    model: string;\n    qualified_id: string;\n    context_window_tokens: number;\n  };\n  rate_source: TokenBudgetRateSource;\n  backed: boolean;\n  dominant_byte_class: TokenBudgetDominantByteClass;\n  component_breakdown: FusionBudgetComponentBreakdown;\n  byte_class_breakdown: TokenBudgetByteClassBreakdown;\n  dense_regions: readonly FusionBudgetDenseRegion[];\n  bytes_over: number;\n  tokens_over: number;\n  required_allowed_tokens: number;\n  route_table: readonly FusionBudgetRouteTableEntry[];\n  counterfactuals: FusionBudgetCounterfactuals;\n  stage_upstream_actuals: readonly { stage: FusionStage; bytes: number }[];\n  policy_id: string;\n  calibration_version: string;\n  context_policy_id: string;\n  remediation: readonly string[];\n  blockers: readonly FusionBudgetBlocker[];\n  artifact_dir: string;\n}\n\nexport interface FusionErrorDetails {\n  code: FusionErrorCode;\n  stage?: FusionStage;\n  slot?: 1 | 2 | 3;\n  attempt?: number;\n  artifactDir?: string;\n  transient?: boolean;\n  childCreated?: boolean;\n  budget?: FusionBudgetErrorDetail;\n  runProgress?: FusionRunProgress;\n}\n\nexport class FusionError extends Error {\n  readonly code: FusionErrorCode;\n  readonly stage: FusionStage | undefined;\n  readonly slot: 1 | 2 | 3 | undefined;\n  readonly attempt: number | undefined;\n  readonly artifactDir: string | undefined;\n  readonly transient: boolean;\n  readonly childCreated: boolean;\n  readonly budget: FusionBudgetErrorDetail | undefined;\n  readonly runProgress: FusionRunProgress | undefined;\n\n  constructor(message: string, details: FusionErrorDetails) {\n    super(message);\n    this.name = 'FusionError';\n    this.code = details.code;\n    this.stage = details.stage;\n    this.slot = details.slot;\n    this.attempt = details.attempt;\n    this.artifactDir = details.artifactDir;\n    this.transient = details.transient ?? false;\n    this.childCreated = details.childCreated ?? true;\n    this.budget = details.budget;\n    this.runProgress = details.runProgress;\n  }\n}\n\nexport interface FusionChildUsage extends FusionUsage {\n  provider: string;\n  model: string;\n  qualifiedId: string;\n}\n\nexport type FusionToolCallLogStatus = 'ok' | 'error';\n\nexport interface FusionToolCallLogRecord {\n  schema_version: typeof FUSION_TOOL_CALL_LOG_SCHEMA_VERSION;\n  ordinal: number;\n  tool_name: string;\n  arguments_sha256: string;\n  arguments_bytes: number;\n  result_bytes: number;\n  result_sha256: string;\n  status: FusionToolCallLogStatus;\n  duration_ms: number;\n  url?: string | undefined;\n  /** SHA-256 of a rejected attempted fetch URL; raw rejected URLs are never persisted. */\n  rejected_url_sha256?: string | undefined;\n  final_url?: string | undefined;\n  http_status?: number | undefined;\n  response_bytes?: number | undefined;\n  content_sha256?: string | undefined;\n}\n\nexport interface FusionToolCallLogSummary {\n  count: number;\n  total_result_bytes: number;\n  trace_complete: boolean;\n}\n\nexport interface FusionToolCallTrace {\n  bytes: Buffer;\n  records: readonly FusionToolCallLogRecord[];\n  summary: FusionToolCallLogSummary;\n}\n\nexport interface FusionCandidateOutputRecovery {\n  kind: 'same_session_compression';\n  limit_bytes: number;\n  original_record_index: number;\n  replacement_record_index: number | null;\n  original_json_rendered_bytes: number;\n  replacement_json_rendered_bytes: number | null;\n  original_text_sha256: string;\n  original_text: string;\n  status: 'completed' | 'failed';\n}\n\nexport interface FusionChildRunResult {\n  stage: FusionStage;\n  slot?: 1 | 2 | 3;\n  attempt: number;\n  provider: string;\n  model: string;\n  qualifiedId: string;\n  text: string;\n  /** Aggregate usage across the complete child agent loop. */\n  usage: FusionUsage;\n  /** First provider request, used for like-for-like prompt forecast calibration. */\n  firstRequestUsage?: FusionUsage;\n  /** Number of provider requests represented by aggregate usage. */\n  providerRequestCount?: number;\n  outputRecovery?: FusionCandidateOutputRecovery;\n  events: Buffer;\n  stderr: Buffer;\n  exitCode: number;\n  signal: NodeJS.Signals | null;\n  toolCallTrace?: FusionToolCallTrace;\n}\n\nexport interface FusionAttemptOutputRecoveryRecord {\n  kind: 'same_session_compression';\n  status: 'completed' | 'failed';\n  limit_bytes: number;\n  original_response_path: string;\n  original_record_index: number;\n  replacement_record_index: number | null;\n  original_json_rendered_bytes: number;\n  replacement_json_rendered_bytes: number | null;\n  original_text_sha256: string;\n}\n\nexport interface FusionAttemptArtifactRecord {\n  stage: FusionStage;\n  slot?: 1 | 2 | 3;\n  attempt: number;\n  status: 'completed' | 'failed' | 'cancelled';\n  child_created: boolean;\n  prompt_path: string;\n  events_path?: string;\n  stderr_path?: string;\n  response_path?: string;\n  partial_response_path?: string;\n  tool_calls_path?: string;\n  tool_calls?: FusionToolCallLogSummary;\n  output_recovery?: FusionAttemptOutputRecoveryRecord;\n  provider?: string;\n  model?: string;\n  qualifiedId?: string;\n  usage?: FusionUsage;\n  error?: string;\n}\n\nexport interface FusionArtifactRef {\n  path: string;\n  byte_length: number;\n  sha256: string;\n}\n\nexport type FusionFailureArtifactClassification =\n  | 'complete_stage_output'\n  | 'partial_stage_output'\n  | 'oversized_original'\n  | 'empty_rejected_output'\n  | 'evidence_only';\n\nexport interface FusionFailureEvidenceArtifact {\n  name: string;\n  classification: FusionFailureArtifactClassification;\n  ref: FusionArtifactRef;\n}\n\nexport interface FusionFailureAttemptMetadata {\n  stage: FusionStage;\n  slot?: 1 | 2 | 3 | undefined;\n  attempt: number;\n  status: 'completed' | 'failed' | 'cancelled';\n  child_created: boolean;\n}\n\nexport interface FusionFailureList<T> {\n  listed: readonly T[];\n  omitted_count: number;\n}\n\nexport interface FusionFailureMessageMetadata {\n  byte_length: number;\n  sha256: string;\n  inline_message?: string | undefined;\n  omission_reason?: 'exceeds_inline_message_bytes_cap' | 'result_view_byte_budget' | undefined;\n}\n\nexport interface FusionFailureSummaryV1 {\n  schema_version: typeof FUSION_FAILURE_SUMMARY_SCHEMA_VERSION;\n  run_id: string;\n  workflow: FusionWorkflowId;\n  source: FusionSource;\n  terminal_state: Exclude<FusionTerminalState, 'completed'>;\n  created_at: string;\n  answer: { present: false; reason: 'run_did_not_commit' };\n  failure: {\n    code: FusionErrorCode | null;\n    stage?: FusionStage | undefined;\n    slot?: 1 | 2 | 3 | undefined;\n    attempt?: number | undefined;\n    child_created: boolean;\n    message: FusionFailureMessageMetadata;\n  };\n  progress: FusionRunProgress;\n  usage_so_far: FusionUsage;\n  attempts: FusionFailureList<FusionFailureAttemptMetadata>;\n  evidence_artifacts: FusionFailureList<FusionFailureEvidenceArtifact>;\n  remediation_ids: readonly (\n    | 'inspect_manifest_bound_evidence'\n    | 'inspect_terminal_error'\n    | 'split_or_reduce_work'\n    | 'retry_same_route_after_operator_review'\n  )[];\n}\n\nexport interface FusionFailureViewFailure {\n  code?: FusionErrorCode | null | undefined;\n  stage?: FusionStage | undefined;\n  slot?: 1 | 2 | 3 | undefined;\n  attempt?: number | undefined;\n  child_created?: boolean | undefined;\n  message: FusionFailureMessageMetadata;\n}\n\nexport interface FusionFailureResultView {\n  schema_version: typeof FUSION_FAILURE_SUMMARY_SCHEMA_VERSION;\n  summary_status: 'verified' | 'legacy_manifest_only' | 'unavailable' | 'integrity_failed';\n  terminal_state: Exclude<FusionTerminalState, 'completed'>;\n  answer: { present: false; reason: 'run_did_not_commit' };\n  failure?: FusionFailureViewFailure | undefined;\n  progress?: FusionRunProgress | undefined;\n  usage_so_far?: FusionUsage | undefined;\n  attempts?: FusionFailureList<FusionFailureAttemptMetadata> | undefined;\n  evidence_artifacts?: FusionFailureList<FusionFailureEvidenceArtifact> | undefined;\n  remediation_ids?: FusionFailureSummaryV1['remediation_ids'] | undefined;\n  failure_summary_ref?: FusionArtifactRef | undefined;\n  summary_unavailable_reason?: 'no_durable_summary' | 'manifest_untrusted' | 'summary_integrity_failed' | undefined;\n}\n\nexport interface FusionArtifactManifest {\n  schema_version: typeof FUSION_MANIFEST_SCHEMA_VERSION;\n  run_id: string;\n  workflow: FusionWorkflowId;\n  source: FusionSource;\n  state: FusionState;\n  created_at: string;\n  updated_at: string;\n  cwd: string;\n  config: FusionModelConfigV1;\n  models: {\n    candidates: readonly [string, string, string];\n    evaluator: string;\n    merger: string;\n    thinking_level: string;\n  };\n  capabilities: {\n    candidate: FusionCapability;\n    evaluation: FusionCapability;\n    merge: FusionCapability;\n  };\n  context: {\n    kind: FusionContextKind;\n    policy_id: string;\n    ledger_artifact?: string;\n    source_policy_artifact?: string;\n  };\n  tool_policy: {\n    candidate_tools: readonly string[];\n    evaluation_tools: readonly [];\n    merge_tools: readonly [];\n  };\n  usage: FusionUsage;\n  attempts: readonly FusionAttemptArtifactRecord[];\n  artifacts: Readonly<Record<string, FusionArtifactRef>>;\n  anonymous_map?: Readonly<Record<FusionCandidateId, 1 | 2 | 3>>;\n  error?: string;\n}\n\nexport interface FusionRunResult {\n  mergedText: string;\n  details: FusionResultDetails;\n}\n\n/** Snapshot of one configured route's verified input capacity for one stage. */\nexport interface FusionRouteCapacity {\n  role: 'candidate-1' | 'candidate-2' | 'candidate-3' | 'evaluator' | 'merger';\n  provider: string;\n  model: string;\n  qualified_id: string;\n  context_window_tokens: number;\n  reserved_output_tokens: number;\n  framing_reserve_tokens: number;\n  safety_reserve_tokens: number;\n  allowed_input_tokens: number;\n  family: TokenBudgetFamily;\n  rate_source: TokenBudgetRateSource;\n  byte_capacity_utf8_bytes: number;\n}\n\nexport interface FusionBudgetStageComposition {\n  visible_text_bytes: number;\n  omission_receipt_bytes: number;\n  projection_metadata_bytes: number;\n  request_bytes: number;\n  static_stage_framing_bytes: number;\n  upstream_output_contract_bytes: number;\n}\n\nexport interface FusionStageBudgetPlanEntry {\n  budget_stage: FusionBudgetStage;\n  slot?: 1 | 2 | 3;\n  route: FusionRouteCapacity;\n  conditional: boolean;\n  check_kind: 'input_only_preflight';\n  input_utf8_bytes: number;\n  upstream_output_contract_bytes: number;\n  forecast_utf8_bytes: number;\n  input_only_input_tokens_upper_bound: number;\n  forecast_input_tokens_upper_bound: number;\n  allowed_input_tokens: number;\n  input_only_signed_headroom_tokens: number;\n  signed_headroom_tokens: number;\n  input_only_utilization_basis_points: number;\n  utilization_basis_points: number;\n  input_only_estimate: EstimateInputTokensResult;\n  reservation_estimate: EstimateInputTokensResult;\n  fits: boolean;\n  reservation_fits: boolean;\n}\n\nexport interface FusionBudgetBlocker extends FusionStageBudgetPlanEntry {\n  overage_tokens: number;\n  bytes_over: number;\n}\n\nexport interface FusionBudgetWarning extends FusionStageBudgetPlanEntry {\n  warning_kind: 'input_utilization' | 'worst_case_reservation';\n  threshold_basis_points: number;\n}\n\nexport interface FusionBudgetEmptyRequestVerdict {\n  request_utf8_bytes: number;\n  still_fails_with_empty_request: boolean;\n  shortening_request_can_help: boolean;\n  minimum_request_byte_reduction: number;\n  maximum_safe_request_utf8_bytes: number;\n  blockers_with_empty_request: readonly FusionBudgetBlocker[];\n}\n\nexport interface FusionBudgetPlanV1 {\n  schema_version: typeof FUSION_BUDGET_PLAN_SCHEMA_VERSION;\n  workflow: FusionWorkflowId;\n  context: { kind: FusionContextKind; policy_id: string };\n  fixed_candidate_policy: { capability: FusionCapability; tools: readonly string[] };\n  tool_policy: {\n    candidate_tools: readonly string[];\n    evaluation_tools: readonly [];\n    merge_tools: readonly [];\n  };\n  policy: FusionBudgetPolicyDescriptor;\n  routes: readonly FusionRouteCapacity[];\n  stages: readonly FusionStageBudgetPlanEntry[];\n  blockers: readonly FusionBudgetBlocker[];\n  primary_blocker?: FusionBudgetBlocker;\n  primary_blocker_composition?: FusionBudgetStageComposition;\n  empty_request: FusionBudgetEmptyRequestVerdict;\n  warnings: readonly FusionBudgetWarning[];\n}\n\n/** Documented, versioned budget policy. */\nexport interface FusionBudgetPolicyDescriptor {\n  id: 'fusion-budget-policy-v4';\n  route_output_reserve_strategy: 'max_fusion_contract_or_model_max';\n  calibration_version: string;\n  calibration_table: Readonly<Record<TokenBudgetFamily, TokenBudgetFamilyCalibration>>;\n  reserved_output_tokens: number;\n  framing_reserve_tokens: number;\n  safety_reserve_tokens: number;\n  candidate_output_contract_bytes: number;\n  evaluation_output_contract_bytes: number;\n  merge_output_contract_bytes: number;\n  diagnostics_contract_bytes: number;\n  utilization_warning_threshold_basis_points: 8000;\n}\n\nexport interface FusionCalibrationViolation {\n  schema_version: typeof FUSION_CALIBRATION_VIOLATION_SCHEMA_VERSION;\n  stage: FusionStage;\n  slot?: 1 | 2 | 3;\n  attempt: number;\n  route: {\n    provider: string;\n    model: string;\n    qualified_id: string;\n  };\n  family: TokenBudgetFamily;\n  rate_source: TokenBudgetRateSource;\n  prompt_utf8_bytes: number;\n  prompt_sha256: string;\n  observation_scope: 'first_provider_request';\n  provider_request_count: number;\n  forecast_input_tokens: number;\n  billed_input_tokens: number;\n  billed_input_breakdown: {\n    input: number;\n    cache_read: number;\n    cache_write: number;\n  };\n  under_forecast_tokens: number;\n  byte_class_breakdown: TokenBudgetByteClassBreakdown;\n  dominant_byte_class: TokenBudgetDominantByteClass;\n}\n"]}