@zhushanwen/subagent-engine-sdk 0.11.0 → 0.12.0

package/dist/index.cjs

@@ -6598,6 +6598,10 @@ __export(src_exports, {
   ENGINE_TRANSPORT_ERROR_RECOVERY: () => ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError: () => EngineSdkError,
   ExecutionNestingContext: () => ExecutionNestingContext,
+  FAILURE_CAUSE_CLOSED_KINDS: () => FAILURE_CAUSE_CLOSED_KINDS,
+  FAILURE_CAUSE_KINDS_BY_CLASS: () => FAILURE_CAUSE_KINDS_BY_CLASS,
+  FAILURE_CAUSE_KINDS_BY_CLASS_LOCK: () => FAILURE_CAUSE_KINDS_BY_CLASS_LOCK,
+  FAILURE_CAUSE_KIND_VOCAB_LOCK: () => FAILURE_CAUSE_KIND_VOCAB_LOCK,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS: () => FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   HANDSHAKE_TIMEOUT_MS: () => HANDSHAKE_TIMEOUT_MS,
   HOST_TIMEOUT_ABORT_REASON: () => HOST_TIMEOUT_ABORT_REASON,
@@ -6625,8 +6629,11 @@ __export(src_exports, {
   ZCODE_HOST_DB_SUFFIX: () => ZCODE_HOST_DB_SUFFIX,
   ZCODE_ISOLATED_DB_SEGMENTS: () => ZCODE_ISOLATED_DB_SEGMENTS,
   ZCODE_PI_SYNCED_PROVIDER_CONFIG_SEGMENTS: () => ZCODE_PI_SYNCED_PROVIDER_CONFIG_SEGMENTS,
+  _EventVocabSyncLock: () => _EventVocabSyncLock,
   abortWithFallback: () => abortWithFallback,
+  addUsage: () => addUsage,
   aggregateUsage: () => aggregateUsage,
+  appendErrorFact: () => appendErrorFact,
   armEngineSelfDestruct: () => armEngineSelfDestruct,
   assertChatConversationSupported: () => assertChatConversationSupported,
   assertNotNestedSpawn: () => assertNotNestedSpawn,
@@ -6640,6 +6647,7 @@ __export(src_exports, {
   configureLoggerSink: () => configureLoggerSink,
   createReplayRecord: () => createReplayRecord,
   createUiChannelRegistry: () => createUiChannelRegistry,
+  emptyTurn: () => emptyTurn,
   engineConversationUnsupportedError: () => engineConversationUnsupportedError,
   engineProtocolMismatchError: () => engineProtocolMismatchError,
   engineSetModelUnsupportedError: () => engineSetModelUnsupportedError,
@@ -6936,9 +6944,28 @@ var AGENT_EVENT_TYPE_NAMES = [
   // noop-safe: 纯活性信号，双侧 reducer 恒 no-op（协议语义见 AgentEvent 头注），丢弃零差异
   "error",
   // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺 lastError 诊断留痕，已写状态不回滚
-  "armed"
+  "armed",
   // noop-safe: 旧宿主无武装等待窗消费点（fail-fast 属宿主新增逻辑），丢弃仅缺武装留痕，schema 强制第一道防线（引擎自查断言）不受损
+  "auto_retry"
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺重试边界留痕（journal 不可查失败尝试轨迹），轮成败判定与 turns/usage 计账不受损（P5 计账锚在引擎侧收尾快照，不依赖宿主消费本帧）
 ];
+var _EventVocabSyncLock = true;
+var FAILURE_CAUSE_CLOSED_KINDS = [
+  "rate_limited",
+  "protocol_unsupported",
+  "turn_budget_exhausted",
+  "timeout",
+  "no_deliverable",
+  "cancelled"
+];
+var FAILURE_CAUSE_KIND_VOCAB_LOCK = true;
+var FAILURE_CAUSE_KINDS_BY_CLASS = {
+  provider: ["rate_limited", "protocol_unsupported"],
+  harness: ["turn_budget_exhausted", "timeout"],
+  agent: ["no_deliverable"],
+  user: ["cancelled"]
+};
+var FAILURE_CAUSE_KINDS_BY_CLASS_LOCK = true;
 
 // src/protocol/schema.ts
 var ANY_JSON = {};
@@ -7475,7 +7502,8 @@ function createReplayRecord() {
     turns: [emptyTurn()],
     turnCount: 0,
     totalTokens: 0,
-    lastError: void 0
+    lastError: void 0,
+    errors: []
   };
 }
 function currentTurn(record) {
@@ -7569,7 +7597,11 @@ function applyTurnEnd(record) {
   turn.closed = true;
   turn.closedTs = Date.now();
   record.turnCount += 1;
-  record.lastError = void 0;
+}
+function appendErrorFact(record, message) {
+  if (!message) return;
+  (record.errors ??= []).push({ message, at: Date.now() });
+  record.lastError = message;
 }
 function applyMessageEnd(record, event) {
   if (event.usage) {
@@ -7578,11 +7610,11 @@ function applyMessageEnd(record, event) {
     record.totalTokens += (event.usage.input ?? 0) + (event.usage.output ?? 0) + (event.usage.cacheRead ?? 0) + (event.usage.cacheWrite ?? 0);
   }
   if (event.error) {
-    record.lastError = event.error;
+    appendErrorFact(record, event.error);
   }
 }
 function applyErrorEvent(record, event) {
-  record.lastError = event.message;
+  appendErrorFact(record, event.message);
 }
 function updateFromEvent(record, event) {
   switch (event.type) {
@@ -7602,7 +7634,7 @@ function updateFromEvent(record, event) {
     // ── message_end：usage 增量累加 + totalTokens 累加 ──
     case "message_end":
       return applyMessageEnd(record, event);
-    // ── error：存 record.lastError ──
+    // ── error：appendErrorFact 入账（errors 只追加 + lastError 派生）──
     case "error":
       return applyErrorEvent(record, event);
     // ── compaction：不产生数据（不变）──
@@ -7616,6 +7648,12 @@ function updateFromEvent(record, event) {
     //    双侧 reducer no-op 义务的 SDK 侧）
     case "armed":
       return;
+    // ── auto_retry：pi 原生重试边界帧（[subagent-observability §3.3.1 P5]）——
+    //    观测面（journal 留痕失败尝试轨迹），不进 record 派生视图：失败尝试的
+    //    turns/usage 切片与 retryAttempts 计数由引擎收尾快照一次产出（outcome
+    //    字段承载），reducer 写入会让失败尝试静默混进 turns 聚合，恰违背 P5 计账。
+    case "auto_retry":
+      return;
     default: {
       const _exhaustive = event;
       return _exhaustive;
@@ -8481,6 +8519,10 @@ function runEngineCliEntry(opts) {
   ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError,
   ExecutionNestingContext,
+  FAILURE_CAUSE_CLOSED_KINDS,
+  FAILURE_CAUSE_KINDS_BY_CLASS,
+  FAILURE_CAUSE_KINDS_BY_CLASS_LOCK,
+  FAILURE_CAUSE_KIND_VOCAB_LOCK,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   HANDSHAKE_TIMEOUT_MS,
   HOST_TIMEOUT_ABORT_REASON,
@@ -8508,8 +8550,11 @@ function runEngineCliEntry(opts) {
   ZCODE_HOST_DB_SUFFIX,
   ZCODE_ISOLATED_DB_SEGMENTS,
   ZCODE_PI_SYNCED_PROVIDER_CONFIG_SEGMENTS,
+  _EventVocabSyncLock,
   abortWithFallback,
+  addUsage,
   aggregateUsage,
+  appendErrorFact,
   armEngineSelfDestruct,
   assertChatConversationSupported,
   assertNotNestedSpawn,
@@ -8523,6 +8568,7 @@ function runEngineCliEntry(opts) {
   configureLoggerSink,
   createReplayRecord,
   createUiChannelRegistry,
+  emptyTurn,
   engineConversationUnsupportedError,
   engineProtocolMismatchError,
   engineSetModelUnsupportedError,

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReverseChannel, ReverseRequestTimeoutClass, SET_MODEL_REQUEST_TIMEOUT_MS, SET_MODEL_STAGE_TIMEOUT_MS, STDERR_TAIL_CHARS, SUBAGENT_CONTROL_CLOSED_REASONS, SUBAGENT_CONTROL_FRAME_KINDS, SUBAGENT_CONTROL_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_RANGE, SubagentControlClosedReason, SubagentControlFrameKind, errorResponseFrameSchema, isProtocolVersionCompatible, isSubagentControlClosedReason, isSubagentControlFrameKind, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema } from './protocol/index.cjs';
-export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_SPAWN_DELIVERY_ERROR_CODES, d as ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY, e as ENGINE_TIMEOUT_RECOVERY, f as ENGINE_TRANSPORT_ERROR_CODES, g as ENGINE_TRANSPORT_ERROR_RECOVERY, h as EngineProtocolErrorCode, E as EngineSdkError, i as EngineSpawnDeliveryErrorCode, j as EngineTransportErrorCode, k as ErrorResponseFrame, l as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, m as ResponseFrame, n as ReverseRequestFrame, o as ReverseResponseResult, S as SET_MODEL_ERROR_CODES, p as SET_MODEL_NOT_ACTIVE_CODE, q as STDOUT_TAIL_ECHO_CHARS, r as SetModelErrorCode, s as SuccessResponseFrame, t as assertChatConversationSupported, u as engineConversationUnsupportedError, v as engineProtocolMismatchError, w as engineSetModelUnsupportedError, x as engineTimeoutDetail, y as isEngineErrorPassthroughCode, z as isEngineProtocolErrorCode, A as isNotificationFrame, B as isRequestFrame, C as isResponseFrame, D as isReverseRequestFrame, F as schemaEmulationFailedDetail } from './error-codes-D_aPibUt.cjs';
-export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from './methods-CHiDwvRK.cjs';
-export { g as AGENT_EVENT_TYPE_NAMES, b as AgentCallOpts, A as AgentEvent, h as AgentEventTypeName, i as AgentFailureKind, c as AgentOutcome, j as AgentOutcomeUsage, k as AgentUsage, a as AgentUsageTotal, l as AssertMutuallyAssignable, d as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, I as InternalToolCall, f as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, e as ResumeAnchor, S as SessionView, n as ToolCall, o as ToolCallEntry, p as ToolCallResult, T as Turn, W as WorktreeHandle } from './contract-types-BUHUMF9R.cjs';
+export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_SPAWN_DELIVERY_ERROR_CODES, d as ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY, e as ENGINE_TIMEOUT_RECOVERY, f as ENGINE_TRANSPORT_ERROR_CODES, g as ENGINE_TRANSPORT_ERROR_RECOVERY, h as EngineProtocolErrorCode, E as EngineSdkError, i as EngineSpawnDeliveryErrorCode, j as EngineTransportErrorCode, k as ErrorResponseFrame, l as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, m as ResponseFrame, n as ReverseRequestFrame, o as ReverseResponseResult, S as SET_MODEL_ERROR_CODES, p as SET_MODEL_NOT_ACTIVE_CODE, q as STDOUT_TAIL_ECHO_CHARS, r as SetModelErrorCode, s as SuccessResponseFrame, t as assertChatConversationSupported, u as engineConversationUnsupportedError, v as engineProtocolMismatchError, w as engineSetModelUnsupportedError, x as engineTimeoutDetail, y as isEngineErrorPassthroughCode, z as isEngineProtocolErrorCode, A as isNotificationFrame, B as isRequestFrame, C as isResponseFrame, D as isReverseRequestFrame, F as schemaEmulationFailedDetail } from './error-codes-CgcjlmeD.cjs';
+export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from './methods-BzvzcCrB.cjs';
+export { h as AGENT_EVENT_TYPE_NAMES, c as AgentCallOpts, A as AgentEvent, i as AgentEventTypeName, j as AgentFailureKind, d as AgentOutcome, k as AgentOutcomeUsage, a as AgentUsage, b as AgentUsageTotal, l as AssertMutuallyAssignable, e as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, n as EngineStopReason, F as FAILURE_CAUSE_CLOSED_KINDS, o as FAILURE_CAUSE_KINDS_BY_CLASS, p as FAILURE_CAUSE_KINDS_BY_CLASS_LOCK, q as FAILURE_CAUSE_KIND_VOCAB_LOCK, r as FailureCause, s as FailureCauseClass, t as FailureRetryability, I as InternalToolCall, g as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, f as ResumeAnchor, S as SessionView, u as ToolCall, v as ToolCallEntry, w as ToolCallResult, T as Turn, W as WorktreeHandle, _ as _EventVocabSyncLock } from './contract-types-C1scOS_M.cjs';
 export { SCHEMA_EMULATION_TAIL_CHARS, StructuredOutputResult, buildSchemaEmulationSegment, extractAndValidateStructuredOutput } from './schema-emulation.cjs';
 export { ExecutionNestingContext, ExecutionNestingState, NESTED_SPAWN_ENV, NestedSpawnRejectedError, SpawnEnv, assertNotNestedSpawn, buildNestedSpawnEnv } from './nesting-guard.cjs';
 export { CoreLogger, LogLevel, LoggerSink, configureLoggerSink, getLogger, resetLoggerSinkForTests } from './logger.cjs';
 export { DEFAULT_KILL_GRACE_MS, DEFAULT_NATIVE_INTERRUPT_GRACE_MS, HOST_TIMEOUT_ABORT_REASON, KillChainOptions, KillableChild, PidChainOptions, abortWithFallback, killChain, killPidChain, probePidAlive, safeKill, synthesizeTimeoutOutcome } from './kill-chain.cjs';
-export { ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.cjs';
+export { ErrorFact, ReplayRecordView, addUsage, aggregateUsage, appendErrorFact, createReplayRecord, emptyTurn, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.cjs';
 export { TAIJI_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.cjs';
 export { resolveEngineDir, resolveEnginesRoot, resolveJournalPath, resolvePoolDir, sanitizeSeg } from './paths.cjs';
 export { UiMethod, UiRequest, UiRequestHandler, UiResponse, isUiResponse } from './ui-types.cjs';

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReverseChannel, ReverseRequestTimeoutClass, SET_MODEL_REQUEST_TIMEOUT_MS, SET_MODEL_STAGE_TIMEOUT_MS, STDERR_TAIL_CHARS, SUBAGENT_CONTROL_CLOSED_REASONS, SUBAGENT_CONTROL_FRAME_KINDS, SUBAGENT_CONTROL_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_RANGE, SubagentControlClosedReason, SubagentControlFrameKind, errorResponseFrameSchema, isProtocolVersionCompatible, isSubagentControlClosedReason, isSubagentControlFrameKind, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema } from './protocol/index.js';
-export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_SPAWN_DELIVERY_ERROR_CODES, d as ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY, e as ENGINE_TIMEOUT_RECOVERY, f as ENGINE_TRANSPORT_ERROR_CODES, g as ENGINE_TRANSPORT_ERROR_RECOVERY, h as EngineProtocolErrorCode, E as EngineSdkError, i as EngineSpawnDeliveryErrorCode, j as EngineTransportErrorCode, k as ErrorResponseFrame, l as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, m as ResponseFrame, n as ReverseRequestFrame, o as ReverseResponseResult, S as SET_MODEL_ERROR_CODES, p as SET_MODEL_NOT_ACTIVE_CODE, q as STDOUT_TAIL_ECHO_CHARS, r as SetModelErrorCode, s as SuccessResponseFrame, t as assertChatConversationSupported, u as engineConversationUnsupportedError, v as engineProtocolMismatchError, w as engineSetModelUnsupportedError, x as engineTimeoutDetail, y as isEngineErrorPassthroughCode, z as isEngineProtocolErrorCode, A as isNotificationFrame, B as isRequestFrame, C as isResponseFrame, D as isReverseRequestFrame, F as schemaEmulationFailedDetail } from './error-codes-DrNf0gwT.js';
-export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from './methods-BdIH3FwS.js';
-export { g as AGENT_EVENT_TYPE_NAMES, b as AgentCallOpts, A as AgentEvent, h as AgentEventTypeName, i as AgentFailureKind, c as AgentOutcome, j as AgentOutcomeUsage, k as AgentUsage, a as AgentUsageTotal, l as AssertMutuallyAssignable, d as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, I as InternalToolCall, f as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, e as ResumeAnchor, S as SessionView, n as ToolCall, o as ToolCallEntry, p as ToolCallResult, T as Turn, W as WorktreeHandle } from './contract-types-BUHUMF9R.js';
+export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_SPAWN_DELIVERY_ERROR_CODES, d as ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY, e as ENGINE_TIMEOUT_RECOVERY, f as ENGINE_TRANSPORT_ERROR_CODES, g as ENGINE_TRANSPORT_ERROR_RECOVERY, h as EngineProtocolErrorCode, E as EngineSdkError, i as EngineSpawnDeliveryErrorCode, j as EngineTransportErrorCode, k as ErrorResponseFrame, l as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, m as ResponseFrame, n as ReverseRequestFrame, o as ReverseResponseResult, S as SET_MODEL_ERROR_CODES, p as SET_MODEL_NOT_ACTIVE_CODE, q as STDOUT_TAIL_ECHO_CHARS, r as SetModelErrorCode, s as SuccessResponseFrame, t as assertChatConversationSupported, u as engineConversationUnsupportedError, v as engineProtocolMismatchError, w as engineSetModelUnsupportedError, x as engineTimeoutDetail, y as isEngineErrorPassthroughCode, z as isEngineProtocolErrorCode, A as isNotificationFrame, B as isRequestFrame, C as isResponseFrame, D as isReverseRequestFrame, F as schemaEmulationFailedDetail } from './error-codes-o4rNd1Ee.js';
+export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from './methods-CPMc4cvF.js';
+export { h as AGENT_EVENT_TYPE_NAMES, c as AgentCallOpts, A as AgentEvent, i as AgentEventTypeName, j as AgentFailureKind, d as AgentOutcome, k as AgentOutcomeUsage, a as AgentUsage, b as AgentUsageTotal, l as AssertMutuallyAssignable, e as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, n as EngineStopReason, F as FAILURE_CAUSE_CLOSED_KINDS, o as FAILURE_CAUSE_KINDS_BY_CLASS, p as FAILURE_CAUSE_KINDS_BY_CLASS_LOCK, q as FAILURE_CAUSE_KIND_VOCAB_LOCK, r as FailureCause, s as FailureCauseClass, t as FailureRetryability, I as InternalToolCall, g as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, f as ResumeAnchor, S as SessionView, u as ToolCall, v as ToolCallEntry, w as ToolCallResult, T as Turn, W as WorktreeHandle, _ as _EventVocabSyncLock } from './contract-types-C1scOS_M.js';
 export { SCHEMA_EMULATION_TAIL_CHARS, StructuredOutputResult, buildSchemaEmulationSegment, extractAndValidateStructuredOutput } from './schema-emulation.js';
 export { ExecutionNestingContext, ExecutionNestingState, NESTED_SPAWN_ENV, NestedSpawnRejectedError, SpawnEnv, assertNotNestedSpawn, buildNestedSpawnEnv } from './nesting-guard.js';
 export { CoreLogger, LogLevel, LoggerSink, configureLoggerSink, getLogger, resetLoggerSinkForTests } from './logger.js';
 export { DEFAULT_KILL_GRACE_MS, DEFAULT_NATIVE_INTERRUPT_GRACE_MS, HOST_TIMEOUT_ABORT_REASON, KillChainOptions, KillableChild, PidChainOptions, abortWithFallback, killChain, killPidChain, probePidAlive, safeKill, synthesizeTimeoutOutcome } from './kill-chain.js';
-export { ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.js';
+export { ErrorFact, ReplayRecordView, addUsage, aggregateUsage, appendErrorFact, createReplayRecord, emptyTurn, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.js';
 export { TAIJI_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.js';
 export { resolveEngineDir, resolveEnginesRoot, resolveJournalPath, resolvePoolDir, sanitizeSeg } from './paths.js';
 export { UiMethod, UiRequest, UiRequestHandler, UiResponse, isUiResponse } from './ui-types.js';

package/dist/index.js

@@ -72,6 +72,10 @@ import {
 import {
   AGENT_EVENT_TYPE_NAMES,
   ENGINE_PROTOCOL_SCHEMAS,
+  FAILURE_CAUSE_CLOSED_KINDS,
+  FAILURE_CAUSE_KINDS_BY_CLASS,
+  FAILURE_CAUSE_KINDS_BY_CLASS_LOCK,
+  FAILURE_CAUSE_KIND_VOCAB_LOCK,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   PROTOCOL_METHODS,
   REVERSE_CHANNELS,
@@ -79,6 +83,7 @@ import {
   SUBAGENT_CONTROL_CLOSED_REASONS,
   SUBAGENT_CONTROL_FRAME_KINDS,
   SUBAGENT_CONTROL_PROTOCOL_VERSION,
+  _EventVocabSyncLock,
   errorResponseFrameSchema,
   isSubagentControlClosedReason,
   isSubagentControlFrameKind,
@@ -88,7 +93,7 @@ import {
   reverseRequestFrameSchema,
   runSessionParamsSchema,
   successResponseFrameSchema
-} from "./chunk-QBXDEF4N.js";
+} from "./chunk-7R6HYT2A.js";
 import {
   isNotificationFrame,
   isRequestFrame,
@@ -157,13 +162,16 @@ import {
   resetLoggerSinkForTests
 } from "./chunk-NXNNXGTY.js";
 import {
+  addUsage,
   aggregateUsage,
+  appendErrorFact,
   createReplayRecord,
+  emptyTurn,
   eventsToSessionView,
   sessionIdFromHandle,
   toReplayedTurn,
   updateFromEvent
-} from "./chunk-YFSNX3N3.js";
+} from "./chunk-U5MBAKS5.js";
 import "./chunk-JSBRDJBE.js";
 
 // src/identity-env.ts
@@ -228,6 +236,10 @@ export {
   ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError,
   ExecutionNestingContext,
+  FAILURE_CAUSE_CLOSED_KINDS,
+  FAILURE_CAUSE_KINDS_BY_CLASS,
+  FAILURE_CAUSE_KINDS_BY_CLASS_LOCK,
+  FAILURE_CAUSE_KIND_VOCAB_LOCK,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   HANDSHAKE_TIMEOUT_MS,
   HOST_TIMEOUT_ABORT_REASON,
@@ -255,8 +267,11 @@ export {
   ZCODE_HOST_DB_SUFFIX,
   ZCODE_ISOLATED_DB_SEGMENTS,
   ZCODE_PI_SYNCED_PROVIDER_CONFIG_SEGMENTS,
+  _EventVocabSyncLock,
   abortWithFallback,
+  addUsage,
   aggregateUsage,
+  appendErrorFact,
   armEngineSelfDestruct,
   assertChatConversationSupported,
   assertNotNestedSpawn,
@@ -270,6 +285,7 @@ export {
   configureLoggerSink,
   createReplayRecord,
   createUiChannelRegistry,
+  emptyTurn,
   engineConversationUnsupportedError,
   engineProtocolMismatchError,
   engineSetModelUnsupportedError,

package/dist/journal-io.d.cts

@@ -1,4 +1,4 @@
-import { A as AgentEvent } from './contract-types-BUHUMF9R.cjs';
+import { A as AgentEvent } from './contract-types-C1scOS_M.cjs';
 
 /**
  * 重放 journal：读取路径下全部事件，重放即得 AgentEvent 流（read 第②级）。

package/dist/journal-io.d.ts

@@ -1,4 +1,4 @@
-import { A as AgentEvent } from './contract-types-BUHUMF9R.js';
+import { A as AgentEvent } from './contract-types-C1scOS_M.js';
 
 /**
  * 重放 journal：读取路径下全部事件，重放即得 AgentEvent 流（read 第②级）。

package/dist/journal-replay.cjs

@@ -20,8 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/journal-replay.ts
 var journal_replay_exports = {};
 __export(journal_replay_exports, {
+  addUsage: () => addUsage,
   aggregateUsage: () => aggregateUsage,
+  appendErrorFact: () => appendErrorFact,
   createReplayRecord: () => createReplayRecord,
+  emptyTurn: () => emptyTurn,
   eventsToSessionView: () => eventsToSessionView,
   sessionIdFromHandle: () => sessionIdFromHandle,
   toReplayedTurn: () => toReplayedTurn,
@@ -60,7 +63,8 @@ function createReplayRecord() {
     turns: [emptyTurn()],
     turnCount: 0,
     totalTokens: 0,
-    lastError: void 0
+    lastError: void 0,
+    errors: []
   };
 }
 function currentTurn(record) {
@@ -154,7 +158,11 @@ function applyTurnEnd(record) {
   turn.closed = true;
   turn.closedTs = Date.now();
   record.turnCount += 1;
-  record.lastError = void 0;
+}
+function appendErrorFact(record, message) {
+  if (!message) return;
+  (record.errors ??= []).push({ message, at: Date.now() });
+  record.lastError = message;
 }
 function applyMessageEnd(record, event) {
   if (event.usage) {
@@ -163,11 +171,11 @@ function applyMessageEnd(record, event) {
     record.totalTokens += (event.usage.input ?? 0) + (event.usage.output ?? 0) + (event.usage.cacheRead ?? 0) + (event.usage.cacheWrite ?? 0);
   }
   if (event.error) {
-    record.lastError = event.error;
+    appendErrorFact(record, event.error);
   }
 }
 function applyErrorEvent(record, event) {
-  record.lastError = event.message;
+  appendErrorFact(record, event.message);
 }
 function updateFromEvent(record, event) {
   switch (event.type) {
@@ -187,7 +195,7 @@ function updateFromEvent(record, event) {
     // ── message_end：usage 增量累加 + totalTokens 累加 ──
     case "message_end":
       return applyMessageEnd(record, event);
-    // ── error：存 record.lastError ──
+    // ── error：appendErrorFact 入账（errors 只追加 + lastError 派生）──
     case "error":
       return applyErrorEvent(record, event);
     // ── compaction：不产生数据（不变）──
@@ -201,6 +209,12 @@ function updateFromEvent(record, event) {
     //    双侧 reducer no-op 义务的 SDK 侧）
     case "armed":
       return;
+    // ── auto_retry：pi 原生重试边界帧（[subagent-observability §3.3.1 P5]）——
+    //    观测面（journal 留痕失败尝试轨迹），不进 record 派生视图：失败尝试的
+    //    turns/usage 切片与 retryAttempts 计数由引擎收尾快照一次产出（outcome
+    //    字段承载），reducer 写入会让失败尝试静默混进 turns 聚合，恰违背 P5 计账。
+    case "auto_retry":
+      return;
     default: {
       const _exhaustive = event;
       return _exhaustive;
@@ -255,8 +269,11 @@ function sessionIdFromHandle(handle) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  addUsage,
   aggregateUsage,
+  appendErrorFact,
   createReplayRecord,
+  emptyTurn,
   eventsToSessionView,
   sessionIdFromHandle,
   toReplayedTurn,

package/dist/journal-replay.d.cts

@@ -1,7 +1,18 @@
-import { T as Turn, a as AgentUsageTotal, A as AgentEvent, S as SessionView, E as EngineHandleData, R as ReplayedTurn } from './contract-types-BUHUMF9R.cjs';
+import { T as Turn, a as AgentUsage, b as AgentUsageTotal, A as AgentEvent, S as SessionView, E as EngineHandleData, R as ReplayedTurn } from './contract-types-C1scOS_M.cjs';
 
 /**
- * reducer 的 record 视图（core ExecutionRecord 的结构子集：reducer 只触碰这四个字段）。
+ * 轮失败事实（subagent-observability §3.3.5：失败事实只追加进 errors 数组，
+ * lastError 由「最后一个非空轮失败」派生——数组只追加且空串不入账，
+ * 尾项即最后一个非空失败）。事实源记录，append-only，不因后续轮终清除。
+ */
+interface ErrorFact {
+    /** 错误消息原文（空串 / 缺席不入账——无信息失败事实不占位）。 */
+    message: string;
+    /** 事实落账墙钟（Date.now()，ms）。 */
+    at: number;
+}
+/**
+ * reducer 的 record 视图（core ExecutionRecord 的结构子集：reducer 只触碰这五个字段）。
  * core ExecutionRecord 满足本视图（W2 断言挂靠点）；SDK 内自持 createReplayRecord 产出。
  */
 interface ReplayRecordView {
@@ -9,19 +20,42 @@ interface ReplayRecordView {
     turnCount: number;
     totalTokens: number;
     lastError: string | undefined;
+    /**
+     * 轮失败事实只追加数组（§3.3.5）。缺省 undefined 视为空（磁盘重建的旧 record
+     * 兼容——reducer 以 `??=` 兜底初始化，不要求构造方预置）。
+     */
+    errors?: ErrorFact[];
 }
+/**
+ * 累加两个 AgentUsage（field-wise）。prev 为空时返回 next 的拷贝。
+ * 供 message_end 把 usage 增量并入 turn.usageDelta。
+ */
+declare function addUsage(prev: AgentUsage | undefined, next: AgentUsage): AgentUsage;
+/** 创建一个空 turn（text/thinking 空，无 toolCalls，未结束）。 */
+declare function emptyTurn(): Turn;
 /** 重放场景的 record 构造（对齐 core eventsToSessionView 内 createRecord 后的 reducer 视图）。 */
 declare function createReplayRecord(): ReplayRecordView;
+/**
+ * [§3.3.5] 轮失败事实入账单点：append ErrorFact + lastError 派生刷新（唯一写点）。
+ * 空串 / 缺席不入账（无信息失败事实不占位）；`??=` 兜底磁盘重建的旧 record
+ * （无 errors 字段，缺省 undefined 视为空）。lastError = 最后追加的非空 message
+ * ——数组 append-only 且项非空，尾项即「最后一个非空轮失败」。
+ *
+ * [subagent-observability u3] 导出给 core 轮终写点（record-store-rounds 失败轮
+ * settlement）复用——u2 移交的「markRoundIdle 直写 rec.lastError 绕过 errors 数组」
+ * 收编：轮终失败事实与流内 error 事件走同一入账通道，写点单点（双写漂移防线）。
+ */
+declare function appendErrorFact(record: ReplayRecordView, message: string | undefined | null): void;
 /**
  * 从 AgentEvent 更新 record。所有数据收敛进 record.turns[]。
  *   - text/thinking：流式累积进 currentTurn()（完整内容，非切片）
  *   - tool_start/end：push 进 currentTurn().toolCalls（含完整 result）
  *     tool_end 跨 turn 扫描找 running 同名 toolCall（兜底滞后事件）
  *   - turn_end：结束当前 turn，记 closedTs（真实墙钟，供 getEventLog）；
- *     正常结束清 lastError（瞬态 error 恢复后不应误判 success=false）
+ *     不再清 lastError（§3.3.5——error → turn_end 序后 lastError 仍可读）
  *   - message_end：usage 增量存进末 turn.usageDelta（直接写末 turn，不开新 turn）；
  *     totalTokens 累加
- *   - error：存 record.lastError（getEventLog 派生 error 条目用）
+ *   - error：经 appendErrorFact 入账（errors 只追加 + lastError 派生刷新）
  *
  * 唯一写点——replay 与 live 共用（重放等价性的实现体）。
  *
@@ -42,4 +76,4 @@ declare function eventsToSessionView(events: readonly AgentEvent[], engineId: st
 /** handle.sessionRef 的 sessionId 提取（引擎自定义键，运行时 guard）。 */
 declare function sessionIdFromHandle(handle: EngineHandleData): string | undefined;
 
-export { type ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent };
+export { type ErrorFact, type ReplayRecordView, addUsage, aggregateUsage, appendErrorFact, createReplayRecord, emptyTurn, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent };

package/dist/journal-replay.d.ts

@@ -1,7 +1,18 @@
-import { T as Turn, a as AgentUsageTotal, A as AgentEvent, S as SessionView, E as EngineHandleData, R as ReplayedTurn } from './contract-types-BUHUMF9R.js';
+import { T as Turn, a as AgentUsage, b as AgentUsageTotal, A as AgentEvent, S as SessionView, E as EngineHandleData, R as ReplayedTurn } from './contract-types-C1scOS_M.js';
 
 /**
- * reducer 的 record 视图（core ExecutionRecord 的结构子集：reducer 只触碰这四个字段）。
+ * 轮失败事实（subagent-observability §3.3.5：失败事实只追加进 errors 数组，
+ * lastError 由「最后一个非空轮失败」派生——数组只追加且空串不入账，
+ * 尾项即最后一个非空失败）。事实源记录，append-only，不因后续轮终清除。
+ */
+interface ErrorFact {
+    /** 错误消息原文（空串 / 缺席不入账——无信息失败事实不占位）。 */
+    message: string;
+    /** 事实落账墙钟（Date.now()，ms）。 */
+    at: number;
+}
+/**
+ * reducer 的 record 视图（core ExecutionRecord 的结构子集：reducer 只触碰这五个字段）。
  * core ExecutionRecord 满足本视图（W2 断言挂靠点）；SDK 内自持 createReplayRecord 产出。
  */
 interface ReplayRecordView {
@@ -9,19 +20,42 @@ interface ReplayRecordView {
     turnCount: number;
     totalTokens: number;
     lastError: string | undefined;
+    /**
+     * 轮失败事实只追加数组（§3.3.5）。缺省 undefined 视为空（磁盘重建的旧 record
+     * 兼容——reducer 以 `??=` 兜底初始化，不要求构造方预置）。
+     */
+    errors?: ErrorFact[];
 }
+/**
+ * 累加两个 AgentUsage（field-wise）。prev 为空时返回 next 的拷贝。
+ * 供 message_end 把 usage 增量并入 turn.usageDelta。
+ */
+declare function addUsage(prev: AgentUsage | undefined, next: AgentUsage): AgentUsage;
+/** 创建一个空 turn（text/thinking 空，无 toolCalls，未结束）。 */
+declare function emptyTurn(): Turn;
 /** 重放场景的 record 构造（对齐 core eventsToSessionView 内 createRecord 后的 reducer 视图）。 */
 declare function createReplayRecord(): ReplayRecordView;
+/**
+ * [§3.3.5] 轮失败事实入账单点：append ErrorFact + lastError 派生刷新（唯一写点）。
+ * 空串 / 缺席不入账（无信息失败事实不占位）；`??=` 兜底磁盘重建的旧 record
+ * （无 errors 字段，缺省 undefined 视为空）。lastError = 最后追加的非空 message
+ * ——数组 append-only 且项非空，尾项即「最后一个非空轮失败」。
+ *
+ * [subagent-observability u3] 导出给 core 轮终写点（record-store-rounds 失败轮
+ * settlement）复用——u2 移交的「markRoundIdle 直写 rec.lastError 绕过 errors 数组」
+ * 收编：轮终失败事实与流内 error 事件走同一入账通道，写点单点（双写漂移防线）。
+ */
+declare function appendErrorFact(record: ReplayRecordView, message: string | undefined | null): void;
 /**
  * 从 AgentEvent 更新 record。所有数据收敛进 record.turns[]。
  *   - text/thinking：流式累积进 currentTurn()（完整内容，非切片）
  *   - tool_start/end：push 进 currentTurn().toolCalls（含完整 result）
  *     tool_end 跨 turn 扫描找 running 同名 toolCall（兜底滞后事件）
  *   - turn_end：结束当前 turn，记 closedTs（真实墙钟，供 getEventLog）；
- *     正常结束清 lastError（瞬态 error 恢复后不应误判 success=false）
+ *     不再清 lastError（§3.3.5——error → turn_end 序后 lastError 仍可读）
  *   - message_end：usage 增量存进末 turn.usageDelta（直接写末 turn，不开新 turn）；
  *     totalTokens 累加
- *   - error：存 record.lastError（getEventLog 派生 error 条目用）
+ *   - error：经 appendErrorFact 入账（errors 只追加 + lastError 派生刷新）
  *
  * 唯一写点——replay 与 live 共用（重放等价性的实现体）。
  *
@@ -42,4 +76,4 @@ declare function eventsToSessionView(events: readonly AgentEvent[], engineId: st
 /** handle.sessionRef 的 sessionId 提取（引擎自定义键，运行时 guard）。 */
 declare function sessionIdFromHandle(handle: EngineHandleData): string | undefined;
 
-export { type ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent };
+export { type ErrorFact, type ReplayRecordView, addUsage, aggregateUsage, appendErrorFact, createReplayRecord, emptyTurn, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent };

package/dist/journal-replay.js

@@ -1,15 +1,21 @@
 import {
+  addUsage,
   aggregateUsage,
+  appendErrorFact,
   createReplayRecord,
+  emptyTurn,
   eventsToSessionView,
   sessionIdFromHandle,
   toReplayedTurn,
   updateFromEvent
-} from "./chunk-YFSNX3N3.js";
+} from "./chunk-U5MBAKS5.js";
 import "./chunk-JSBRDJBE.js";
 export {
+  addUsage,
   aggregateUsage,
+  appendErrorFact,
   createReplayRecord,
+  emptyTurn,
   eventsToSessionView,
   sessionIdFromHandle,
   toReplayedTurn,

package/dist/kill-chain.d.cts

@@ -1,4 +1,4 @@
-import { b as AgentCallOpts, c as AgentOutcome } from './contract-types-BUHUMF9R.cjs';
+import { c as AgentCallOpts, d as AgentOutcome } from './contract-types-C1scOS_M.cjs';
 
 /**
  * 可杀子进程的结构形状（Node ChildProcess 的结构子集）。

package/dist/kill-chain.d.ts

@@ -1,4 +1,4 @@
-import { b as AgentCallOpts, c as AgentOutcome } from './contract-types-BUHUMF9R.js';
+import { c as AgentCallOpts, d as AgentOutcome } from './contract-types-C1scOS_M.js';
 
 /**
  * 可杀子进程的结构形状（Node ChildProcess 的结构子集）。

package/dist/{methods-CHiDwvRK.d.cts → methods-BzvzcCrB.d.cts}

@@ -1,4 +1,4 @@
-import { M as ModelRef, d as EngineCapabilities, f as ModelCatalogEntry, b as AgentCallOpts, e as ResumeAnchor, E as EngineHandleData, P as ProbeReport, c as AgentOutcome, S as SessionView } from './contract-types-BUHUMF9R.cjs';
+import { M as ModelRef, e as EngineCapabilities, g as ModelCatalogEntry, c as AgentCallOpts, f as ResumeAnchor, E as EngineHandleData, P as ProbeReport, d as AgentOutcome, S as SessionView } from './contract-types-C1scOS_M.cjs';
 
 /**
  * 正向方法名联合（恰好 10 个；PROTOCOL_METHODS 常量数组与之同源互证）。

package/dist/{methods-BdIH3FwS.d.ts → methods-CPMc4cvF.d.ts}

@@ -1,4 +1,4 @@
-import { M as ModelRef, d as EngineCapabilities, f as ModelCatalogEntry, b as AgentCallOpts, e as ResumeAnchor, E as EngineHandleData, P as ProbeReport, c as AgentOutcome, S as SessionView } from './contract-types-BUHUMF9R.js';
+import { M as ModelRef, e as EngineCapabilities, g as ModelCatalogEntry, c as AgentCallOpts, f as ResumeAnchor, E as EngineHandleData, P as ProbeReport, d as AgentOutcome, S as SessionView } from './contract-types-C1scOS_M.js';
 
 /**
  * 正向方法名联合（恰好 10 个；PROTOCOL_METHODS 常量数组与之同源互证）。

package/dist/port-contract.d.cts

@@ -1,5 +1,5 @@
-import { b as AgentCallOpts, E as EngineHandleData, d as EngineCapabilities, P as ProbeReport, A as AgentEvent, e as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-BUHUMF9R.cjs';
-import { S as SetModelParams, a as SetModelResult } from './methods-CHiDwvRK.cjs';
+import { c as AgentCallOpts, E as EngineHandleData, e as EngineCapabilities, P as ProbeReport, A as AgentEvent, f as ResumeAnchor, d as AgentOutcome, S as SessionView } from './contract-types-C1scOS_M.cjs';
+import { S as SetModelParams, a as SetModelResult } from './methods-BzvzcCrB.cjs';
 
 /**
  * 引擎进程内全量任务声明 = SDK AgentCallOpts 引擎侧子集 + 协议 ctx 还原字段（model/

package/dist/port-contract.d.ts

@@ -1,5 +1,5 @@
-import { b as AgentCallOpts, E as EngineHandleData, d as EngineCapabilities, P as ProbeReport, A as AgentEvent, e as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-BUHUMF9R.js';
-import { S as SetModelParams, a as SetModelResult } from './methods-BdIH3FwS.js';
+import { c as AgentCallOpts, E as EngineHandleData, e as EngineCapabilities, P as ProbeReport, A as AgentEvent, f as ResumeAnchor, d as AgentOutcome, S as SessionView } from './contract-types-C1scOS_M.js';
+import { S as SetModelParams, a as SetModelResult } from './methods-CPMc4cvF.js';
 
 /**
  * 引擎进程内全量任务声明 = SDK AgentCallOpts 引擎侧子集 + 协议 ctx 还原字段（model/