pi-background-tasks 2.1.2 → 2.1.4

package/src/core/fusion/types.ts

@@ -30,6 +30,8 @@ export const FUSION_CALIBRATION_VIOLATION_SCHEMA_VERSION =
 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.
@@ -640,7 +642,8 @@ export type FusionErrorCode =
   | 'child_stdin_failed'
   | 'child_event_invalid'
   | 'child_exit_failed'
-  | 'child_runtime_budget_exceeded'
+  | 'child_runtime_limit_exceeded'
+  | 'child_runtime_payload_invalid'
   | 'child_cache_policy_invalid'
   | 'child_timeout'
   | 'child_output_cap'
@@ -876,6 +879,91 @@ export interface FusionArtifactRef {
   sha256: string;
 }
 
+export type FusionFailureArtifactClassification =
+  | 'complete_stage_output'
+  | 'partial_stage_output'
+  | 'oversized_original'
+  | 'empty_rejected_output'
+  | 'evidence_only';
+
+export interface FusionFailureEvidenceArtifact {
+  name: string;
+  classification: FusionFailureArtifactClassification;
+  ref: FusionArtifactRef;
+}
+
+export interface FusionFailureAttemptMetadata {
+  stage: FusionStage;
+  slot?: 1 | 2 | 3 | undefined;
+  attempt: number;
+  status: 'completed' | 'failed' | 'cancelled';
+  child_created: boolean;
+}
+
+export interface FusionFailureList<T> {
+  listed: readonly T[];
+  omitted_count: number;
+}
+
+export interface FusionFailureMessageMetadata {
+  byte_length: number;
+  sha256: string;
+  inline_message?: string | undefined;
+  omission_reason?: 'exceeds_inline_message_bytes_cap' | 'result_view_byte_budget' | undefined;
+}
+
+export interface FusionFailureSummaryV1 {
+  schema_version: typeof FUSION_FAILURE_SUMMARY_SCHEMA_VERSION;
+  run_id: string;
+  workflow: FusionWorkflowId;
+  source: FusionSource;
+  terminal_state: Exclude<FusionTerminalState, 'completed'>;
+  created_at: string;
+  answer: { present: false; reason: 'run_did_not_commit' };
+  failure: {
+    code: FusionErrorCode | null;
+    stage?: FusionStage | undefined;
+    slot?: 1 | 2 | 3 | undefined;
+    attempt?: number | undefined;
+    child_created: boolean;
+    message: FusionFailureMessageMetadata;
+  };
+  progress: FusionRunProgress;
+  usage_so_far: FusionUsage;
+  attempts: FusionFailureList<FusionFailureAttemptMetadata>;
+  evidence_artifacts: FusionFailureList<FusionFailureEvidenceArtifact>;
+  remediation_ids: readonly (
+    | 'inspect_manifest_bound_evidence'
+    | 'inspect_terminal_error'
+    | 'split_or_reduce_work'
+    | 'retry_same_route_after_operator_review'
+  )[];
+}
+
+export interface FusionFailureViewFailure {
+  code?: FusionErrorCode | null | undefined;
+  stage?: FusionStage | undefined;
+  slot?: 1 | 2 | 3 | undefined;
+  attempt?: number | undefined;
+  child_created?: boolean | undefined;
+  message: FusionFailureMessageMetadata;
+}
+
+export interface FusionFailureResultView {
+  schema_version: typeof FUSION_FAILURE_SUMMARY_SCHEMA_VERSION;
+  summary_status: 'verified' | 'legacy_manifest_only' | 'unavailable' | 'integrity_failed';
+  terminal_state: Exclude<FusionTerminalState, 'completed'>;
+  answer: { present: false; reason: 'run_did_not_commit' };
+  failure?: FusionFailureViewFailure | undefined;
+  progress?: FusionRunProgress | undefined;
+  usage_so_far?: FusionUsage | undefined;
+  attempts?: FusionFailureList<FusionFailureAttemptMetadata> | undefined;
+  evidence_artifacts?: FusionFailureList<FusionFailureEvidenceArtifact> | undefined;
+  remediation_ids?: FusionFailureSummaryV1['remediation_ids'] | undefined;
+  failure_summary_ref?: FusionArtifactRef | undefined;
+  summary_unavailable_reason?: 'no_durable_summary' | 'manifest_untrusted' | 'summary_integrity_failed' | undefined;
+}
+
 export interface FusionArtifactManifest {
   schema_version: typeof FUSION_MANIFEST_SCHEMA_VERSION;
   run_id: string;

package/src/delegate-extension.ts

@@ -11,8 +11,13 @@ import { Type, type Static } from 'typebox';
 import type { BgTask, BgTaskSnapshot, StartDelegateTaskOptions } from './core/common.js';
 import { truncateChars } from './core/common.js';
 import { sha256Buffer } from './core/attested-pi-run.js';
-import { readFusionCommittedResult } from './core/fusion/result-package.js';
-import { cloneFusionUsage, type FusionUsage, type FusionWorkflowId } from './core/fusion/types.js';
+import { readFusionCommittedResult, readFusionFailureResult } from './core/fusion/result-package.js';
+import {
+  cloneFusionUsage,
+  type FusionFailureResultView,
+  type FusionUsage,
+  type FusionWorkflowId,
+} from './core/fusion/types.js';
 import {
   DELEGATE_AUTO_DELIVER_MODES,
   DELEGATE_CAPABILITIES,
@@ -161,6 +166,16 @@ export interface FusionBackgroundResultDetails {
   answer_bytes?: number | undefined;
   answer_sha256?: string | undefined;
   usage_delivered?: boolean | undefined;
+  answer?: { present: false; reason: 'run_did_not_commit' } | undefined;
+  summary_status?: FusionFailureResultView['summary_status'] | undefined;
+  failure_summary_ref?: FusionFailureResultView['failure_summary_ref'] | undefined;
+  failure?: FusionFailureResultView['failure'] | undefined;
+  progress?: FusionFailureResultView['progress'] | undefined;
+  usage_so_far?: FusionFailureResultView['usage_so_far'] | undefined;
+  attempts?: FusionFailureResultView['attempts'] | undefined;
+  evidence_artifacts?: FusionFailureResultView['evidence_artifacts'] | undefined;
+  remediation_ids?: FusionFailureResultView['remediation_ids'] | undefined;
+  summary_unavailable_reason?: FusionFailureResultView['summary_unavailable_reason'] | undefined;
 }
 
 export type BackgroundResultDetails = DelegateResultDetails | FusionBackgroundResultDetails;
@@ -508,9 +523,48 @@ export function registerDelegateExtension(
           };
         }
         if (task.status !== 'completed' || fusion.outcome?.status !== 'committed') {
-          throw new Error(
-            `Fusion ${task.id} did not commit a result (${task.status}): ${fusion.outcome?.error ?? task.error ?? 'no terminal detail'}`,
-          );
+          const terminal = await readFusionFailureResult({
+            artifactDirAbs: fusion.artifactDirAbs,
+            artifactDir: fusion.artifactDir,
+            runId: fusion.runId,
+            workflow: fusion.workflow,
+          });
+          const state =
+            fusion.outcome?.status === 'cancelled' || task.status === 'killed'
+              ? 'cancelled'
+              : 'failed';
+          const details: FusionBackgroundResultDetails = {
+            schema_version: 'pi-background-tasks.fusion-result-view.v1',
+            task_id: task.id,
+            state,
+            delivery: 'none',
+            workflow: fusion.workflow,
+            artifact_dir: fusion.artifactDir,
+            answer: terminal.answer,
+            summary_status: terminal.summary_status,
+            ...(terminal.failure_summary_ref === undefined
+              ? {}
+              : { failure_summary_ref: terminal.failure_summary_ref }),
+            ...(terminal.failure === undefined ? {} : { failure: terminal.failure }),
+            ...(terminal.progress === undefined ? {} : { progress: terminal.progress }),
+            ...(terminal.usage_so_far === undefined ? {} : { usage_so_far: terminal.usage_so_far }),
+            ...(terminal.attempts === undefined ? {} : { attempts: terminal.attempts }),
+            ...(terminal.evidence_artifacts === undefined
+              ? {}
+              : { evidence_artifacts: terminal.evidence_artifacts }),
+            ...(terminal.remediation_ids === undefined
+              ? {}
+              : { remediation_ids: terminal.remediation_ids }),
+            ...(terminal.summary_unavailable_reason === undefined
+              ? {}
+              : { summary_unavailable_reason: terminal.summary_unavailable_reason }),
+          };
+          return {
+            content: textContent(
+              `Fusion ${task.id} ${state}; no answer was committed. Terminal evidence status: ${terminal.summary_status}. Delivery is none; use only the manifest-bound artifact references in details.`,
+            ),
+            details,
+          };
         }
         const verified = await readFusionCommittedResult({
           artifactDirAbs: fusion.artifactDirAbs,
@@ -673,6 +727,13 @@ export function registerDelegateExtension(
           0,
           0,
         );
+      if (fusion && (details.state === 'failed' || details.state === 'cancelled')) {
+        return new Text(
+          theme.fg('warning', `${details.state} fusion; no committed answer · ${details.summary_status ?? 'unavailable'}`),
+          0,
+          0,
+        );
+      }
       return new Text(
         `${theme.fg('success', fusion ? '✓ fusion answer' : '✓ delegate answer')} ${theme.fg('dim', `${String(details.answer_bytes ?? 0)}B · ${details.delivery}`)}`,
         0,

package/src/fusion-child-extension.ts

@@ -12,11 +12,6 @@ import { dirname, isAbsolute } from 'node:path';
 import { parseJsonText } from './core/common.js';
 import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
 import { Type, type Static } from 'typebox';
-import {
-  estimateInputTokens,
-  knownJsonSegment,
-  resolveTokenBudgetFamily,
-} from './core/context/token-budget.js';
 import {
   FUSION_TOOL_CALL_LOG_SCHEMA_VERSION,
   FUSION_WEB_FETCH_TOOL_NAME,
@@ -42,9 +37,7 @@ import {
   FUSION_CHILD_MAX_PROVIDER_REQUESTS,
   FUSION_CHILD_MAX_TOOL_CALLS,
   FUSION_CHILD_MAX_TOTAL_TOOL_RESULT_BYTES,
-  FUSION_CHILD_MIN_OUTPUT_RESERVE_TOKENS,
   FUSION_CHILD_RESULT_PREFIX,
-  FUSION_CHILD_SAFETY_RESERVE_TOKENS,
   FUSION_CHILD_SETTLEMENT_PREFIX,
   FUSION_RESEARCH_ENABLED_ENV,
   FUSION_RUNTIME_GUARD_PREFIX,
@@ -88,10 +81,8 @@ export {
   FUSION_CHILD_MAX_PROVIDER_REQUESTS,
   FUSION_CHILD_MAX_TOOL_CALLS,
   FUSION_CHILD_MAX_TOTAL_TOOL_RESULT_BYTES,
-  FUSION_CHILD_MIN_OUTPUT_RESERVE_TOKENS,
   FUSION_CHILD_RESULT_PREFIX,
   FUSION_CHILD_RESULT_SCHEMA_VERSION,
-  FUSION_CHILD_SAFETY_RESERVE_TOKENS,
   FUSION_CHILD_SETTLEMENT_PREFIX,
   FUSION_CHILD_SETTLEMENT_SCHEMA_VERSION,
   FUSION_RESEARCH_ENABLED_ENV,
@@ -370,8 +361,6 @@ export interface FusionRuntimeRequestEvaluationInput {
   payload: unknown;
   provider: string | undefined;
   model: string | undefined;
-  contextWindowTokens: number | undefined;
-  maxOutputTokens: number | undefined;
   requestOrdinal: number;
   toolCallCount: number;
 }
@@ -384,23 +373,6 @@ function invalidFusionRuntimeRequest(
     'provider_payload_invalid' | 'claude_cache_policy'
   > = 'provider_payload_invalid',
 ): FusionRuntimeGuardRecord {
-  const contextWindowTokens =
-    input.contextWindowTokens !== undefined &&
-    Number.isSafeInteger(input.contextWindowTokens) &&
-    input.contextWindowTokens > 0
-      ? input.contextWindowTokens
-      : 0;
-  const modelOutputTokens =
-    input.maxOutputTokens !== undefined &&
-    Number.isSafeInteger(input.maxOutputTokens) &&
-    input.maxOutputTokens > 0
-      ? input.maxOutputTokens
-      : 0;
-  const reservedOutputTokens = Math.max(FUSION_CHILD_MIN_OUTPUT_RESERVE_TOKENS, modelOutputTokens);
-  const allowedInputTokens = Math.max(
-    0,
-    contextWindowTokens - reservedOutputTokens - FUSION_CHILD_SAFETY_RESERVE_TOKENS,
-  );
   const emptyPayload = Buffer.alloc(0);
   return {
     schema_version: FUSION_RUNTIME_GUARD_SCHEMA_VERSION,
@@ -411,11 +383,6 @@ function invalidFusionRuntimeRequest(
     tool_call_count: input.toolCallCount,
     payload_bytes: 0,
     payload_sha256: sha256(emptyPayload),
-    estimated_input_tokens: 0,
-    context_window_tokens: contextWindowTokens,
-    reserved_output_tokens: reservedOutputTokens,
-    safety_reserve_tokens: FUSION_CHILD_SAFETY_RESERVE_TOKENS,
-    allowed_input_tokens: allowedInputTokens,
     message: `fusion child could not validate provider request ${String(input.requestOrdinal)}: ${detail}`,
   };
 }
@@ -455,84 +422,31 @@ export function prepareFusionRuntimeRequest(
 export function evaluateFusionRuntimeRequest(
   input: FusionRuntimeRequestEvaluationInput,
 ): FusionRuntimeGuardRecord | undefined {
-  let code: FusionRuntimeGuardCode | undefined;
-  let message = '';
-  let payloadBytes = Buffer.alloc(0);
-  let estimatedInputTokens = 0;
-  let allowedInputTokens = 0;
-  const provider = input.provider ?? 'unknown';
-  const model = input.model ?? 'unknown';
-  const contextWindowTokens = input.contextWindowTokens ?? 0;
-  const reservedOutputTokens = Math.max(
-    FUSION_CHILD_MIN_OUTPUT_RESERVE_TOKENS,
-    input.maxOutputTokens ?? 0,
-  );
-  try {
-    if (input.provider === undefined || input.model === undefined) {
-      throw new Error('active model is unavailable');
-    }
-    if (!Number.isSafeInteger(contextWindowTokens) || contextWindowTokens <= 0) {
-      throw new Error('active model context window is unavailable');
-    }
-    if (
-      input.maxOutputTokens === undefined ||
-      !Number.isSafeInteger(input.maxOutputTokens) ||
-      input.maxOutputTokens <= 0
-    ) {
-      throw new Error('active model maximum output tokens are unavailable');
-    }
-    allowedInputTokens =
-      contextWindowTokens - reservedOutputTokens - FUSION_CHILD_SAFETY_RESERVE_TOKENS;
-    if (allowedInputTokens <= 0) {
-      throw new Error('active model has no safe provider input capacity');
-    }
-    const payloadText = JSON.stringify(input.payload);
-    if (payloadText === undefined) throw new Error('provider payload serialized to undefined');
-    payloadBytes = Buffer.from(payloadText, 'utf8');
-    const family = resolveTokenBudgetFamily({ provider, model });
-    estimatedInputTokens = estimateInputTokens({
-      family: family.family,
-      calibrationBacked: family.backed,
-      familyResolution: family.resolution,
-      allowedInputTokens,
-      scope: 'fusion',
-      segments: [knownJsonSegment(payloadText)],
-    }).tokens;
-    if (input.requestOrdinal > FUSION_CHILD_MAX_PROVIDER_REQUESTS) {
-      code = 'provider_request_limit';
-      message = `fusion child reached provider request ${String(input.requestOrdinal)}, exceeding the ${String(FUSION_CHILD_MAX_PROVIDER_REQUESTS)}-request execution limit`;
-    } else if (estimatedInputTokens > allowedInputTokens) {
-      code = 'provider_request_budget';
-      message = `fusion child blocked provider request ${String(input.requestOrdinal)} before transport: exact final payload is ${String(payloadBytes.length)} UTF-8 bytes (estimated <= ${String(estimatedInputTokens)} input tokens), exceeding ${String(allowedInputTokens)} allowed input tokens after reserving ${String(reservedOutputTokens)} model output + ${String(FUSION_CHILD_SAFETY_RESERVE_TOKENS)} safety from the ${String(contextWindowTokens)}-token context window`;
-    }
-  } catch (error) {
-    code = 'provider_payload_invalid';
-    message = `fusion child could not validate provider request ${String(input.requestOrdinal)}: ${error instanceof Error ? error.message : String(error)}`;
+  if (input.provider === undefined || input.model === undefined) {
+    return invalidFusionRuntimeRequest(input, 'active model is unavailable');
   }
-  if (code === undefined) return undefined;
+  if (input.requestOrdinal <= FUSION_CHILD_MAX_PROVIDER_REQUESTS) return undefined;
+  const serialized: unknown = JSON.stringify(input.payload);
+  if (typeof serialized !== 'string') {
+    return invalidFusionRuntimeRequest(input, 'provider payload serialized to a non-string value');
+  }
+  const payloadBytes = Buffer.from(serialized, 'utf8');
   return {
     schema_version: FUSION_RUNTIME_GUARD_SCHEMA_VERSION,
-    code,
-    provider,
-    model,
+    code: 'provider_request_limit',
+    provider: input.provider,
+    model: input.model,
     request_ordinal: input.requestOrdinal,
     tool_call_count: input.toolCallCount,
     payload_bytes: payloadBytes.length,
     payload_sha256: sha256(payloadBytes),
-    estimated_input_tokens: estimatedInputTokens,
-    context_window_tokens: contextWindowTokens,
-    reserved_output_tokens: reservedOutputTokens,
-    safety_reserve_tokens: FUSION_CHILD_SAFETY_RESERVE_TOKENS,
-    allowed_input_tokens: allowedInputTokens,
-    message,
+    message: `fusion child reached provider request ${String(input.requestOrdinal)}, exceeding the ${String(FUSION_CHILD_MAX_PROVIDER_REQUESTS)}-request execution limit`,
   };
 }
 
 export interface FusionRuntimeToolLimitEvaluationInput {
   provider: string | undefined;
   model: string | undefined;
-  contextWindowTokens: number | undefined;
-  maxOutputTokens: number | undefined;
   requestOrdinal: number;
   toolCallCount: number;
 }
@@ -541,23 +455,6 @@ export function evaluateFusionRuntimeToolLimit(
   input: FusionRuntimeToolLimitEvaluationInput,
 ): FusionRuntimeGuardRecord | undefined {
   if (input.toolCallCount <= FUSION_CHILD_MAX_TOOL_CALLS) return undefined;
-  const contextWindowTokens =
-    input.contextWindowTokens !== undefined &&
-    Number.isSafeInteger(input.contextWindowTokens) &&
-    input.contextWindowTokens > 0
-      ? input.contextWindowTokens
-      : 0;
-  const modelOutputTokens =
-    input.maxOutputTokens !== undefined &&
-    Number.isSafeInteger(input.maxOutputTokens) &&
-    input.maxOutputTokens > 0
-      ? input.maxOutputTokens
-      : 0;
-  const reservedOutputTokens = Math.max(FUSION_CHILD_MIN_OUTPUT_RESERVE_TOKENS, modelOutputTokens);
-  const allowedInputTokens = Math.max(
-    0,
-    contextWindowTokens - reservedOutputTokens - FUSION_CHILD_SAFETY_RESERVE_TOKENS,
-  );
   const emptyPayload = Buffer.alloc(0);
   return {
     schema_version: FUSION_RUNTIME_GUARD_SCHEMA_VERSION,
@@ -568,11 +465,6 @@ export function evaluateFusionRuntimeToolLimit(
     tool_call_count: input.toolCallCount,
     payload_bytes: 0,
     payload_sha256: sha256(emptyPayload),
-    estimated_input_tokens: 0,
-    context_window_tokens: contextWindowTokens,
-    reserved_output_tokens: reservedOutputTokens,
-    safety_reserve_tokens: FUSION_CHILD_SAFETY_RESERVE_TOKENS,
-    allowed_input_tokens: allowedInputTokens,
     message: `fusion child reached tool call ${String(input.toolCallCount)}, exceeding the ${String(FUSION_CHILD_MAX_TOOL_CALLS)}-call execution limit`,
   };
 }
@@ -773,8 +665,6 @@ export default function fusionChildExtension(pi: ExtensionAPI): void {
           payload: event.payload,
           provider: model?.provider,
           model: model?.id,
-          contextWindowTokens: model?.contextWindow,
-          maxOutputTokens: model?.maxTokens,
           requestOrdinal: providerRequestCount,
           toolCallCount,
         },
@@ -793,8 +683,6 @@ export default function fusionChildExtension(pi: ExtensionAPI): void {
       payload: cacheNormalizedPayload,
       provider: model?.provider,
       model: model?.id,
-      contextWindowTokens: model?.contextWindow,
-      maxOutputTokens: model?.maxTokens,
       requestOrdinal: providerRequestCount,
       toolCallCount,
     });
@@ -888,8 +776,6 @@ export default function fusionChildExtension(pi: ExtensionAPI): void {
         const guard = evaluateFusionRuntimeToolLimit({
           provider: model?.provider,
           model: model?.id,
-          contextWindowTokens: model?.contextWindow,
-          maxOutputTokens: model?.maxTokens,
           requestOrdinal: providerRequestCount,
           toolCallCount,
         });