@zhushanwen/subagent-engine-sdk 0.11.0 → 0.12.0

package/dist/protocol/index.cjs

@@ -32,6 +32,10 @@ __export(protocol_exports, {
   ENGINE_TRANSPORT_ERROR_CODES: () => ENGINE_TRANSPORT_ERROR_CODES,
   ENGINE_TRANSPORT_ERROR_RECOVERY: () => ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError: () => EngineSdkError,
+  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,
   PROTOCOL_METHODS: () => PROTOCOL_METHODS,
@@ -48,6 +52,7 @@ __export(protocol_exports, {
   SUBAGENT_CONTROL_FRAME_KINDS: () => SUBAGENT_CONTROL_FRAME_KINDS,
   SUBAGENT_CONTROL_PROTOCOL_VERSION: () => SUBAGENT_CONTROL_PROTOCOL_VERSION,
   SUPPORTED_PROTOCOL_RANGE: () => SUPPORTED_PROTOCOL_RANGE,
+  _EventVocabSyncLock: () => _EventVocabSyncLock,
   assertChatConversationSupported: () => assertChatConversationSupported,
   engineConversationUnsupportedError: () => engineConversationUnsupportedError,
   engineProtocolMismatchError: () => engineProtocolMismatchError,
@@ -307,9 +312,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 = {};
@@ -453,6 +477,10 @@ var runSessionParamsSchema = {
   ENGINE_TRANSPORT_ERROR_CODES,
   ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError,
+  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,
   PROTOCOL_METHODS,
@@ -469,6 +497,7 @@ var runSessionParamsSchema = {
   SUBAGENT_CONTROL_FRAME_KINDS,
   SUBAGENT_CONTROL_PROTOCOL_VERSION,
   SUPPORTED_PROTOCOL_RANGE,
+  _EventVocabSyncLock,
   assertChatConversationSupported,
   engineConversationUnsupportedError,
   engineProtocolMismatchError,

package/dist/protocol/index.d.cts

@@ -1,7 +1,7 @@
-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 { 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';
 import { UiRequest, UiResponse } from '../ui-types.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 { 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';
 
 /** 协议版本（引擎包 manifest `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
 declare const ENGINE_PROTOCOL_VERSION = 1;
@@ -278,7 +278,7 @@ declare const notificationFrameSchema: {
                     readonly properties: {
                         readonly type: {
                             readonly type: "string";
-                            readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed"];
+                            readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed", "auto_retry"];
                         };
                     };
                 };
@@ -398,7 +398,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
                         readonly properties: {
                             readonly type: {
                                 readonly type: "string";
-                                readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed"];
+                                readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed", "auto_retry"];
                             };
                         };
                     };

package/dist/protocol/index.d.ts

@@ -1,7 +1,7 @@
-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 { 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';
 import { UiRequest, UiResponse } from '../ui-types.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 { 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';
 
 /** 协议版本（引擎包 manifest `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
 declare const ENGINE_PROTOCOL_VERSION = 1;
@@ -278,7 +278,7 @@ declare const notificationFrameSchema: {
                     readonly properties: {
                         readonly type: {
                             readonly type: "string";
-                            readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed"];
+                            readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed", "auto_retry"];
                         };
                     };
                 };
@@ -398,7 +398,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
                         readonly properties: {
                             readonly type: {
                                 readonly type: "string";
-                                readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed"];
+                                readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed", "auto_retry"];
                             };
                         };
                     };

package/dist/protocol/index.js

@@ -1,6 +1,10 @@
 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,
@@ -8,6 +12,7 @@ import {
   SUBAGENT_CONTROL_CLOSED_REASONS,
   SUBAGENT_CONTROL_FRAME_KINDS,
   SUBAGENT_CONTROL_PROTOCOL_VERSION,
+  _EventVocabSyncLock,
   errorResponseFrameSchema,
   isSubagentControlClosedReason,
   isSubagentControlFrameKind,
@@ -17,7 +22,7 @@ import {
   reverseRequestFrameSchema,
   runSessionParamsSchema,
   successResponseFrameSchema
-} from "../chunk-QBXDEF4N.js";
+} from "../chunk-7R6HYT2A.js";
 import {
   isNotificationFrame,
   isRequestFrame,
@@ -68,6 +73,10 @@ export {
   ENGINE_TRANSPORT_ERROR_CODES,
   ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError,
+  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,
   PROTOCOL_METHODS,
@@ -84,6 +93,7 @@ export {
   SUBAGENT_CONTROL_FRAME_KINDS,
   SUBAGENT_CONTROL_PROTOCOL_VERSION,
   SUPPORTED_PROTOCOL_RANGE,
+  _EventVocabSyncLock,
   assertChatConversationSupported,
   engineConversationUnsupportedError,
   engineProtocolMismatchError,

package/dist/server/index.d.cts

@@ -1,6 +1,6 @@
-import { b as AgentCallOpts, A as AgentEvent } from '../contract-types-BUHUMF9R.cjs';
-import { E as EngineSdkError } from '../error-codes-D_aPibUt.cjs';
-import { I as InitializeResult, R as RunContextParams, b as InitializeParams } from '../methods-CHiDwvRK.cjs';
+import { c as AgentCallOpts, A as AgentEvent } from '../contract-types-C1scOS_M.cjs';
+import { E as EngineSdkError } from '../error-codes-CgcjlmeD.cjs';
+import { I as InitializeResult, R as RunContextParams, b as InitializeParams } from '../methods-BzvzcCrB.cjs';
 import { ReverseRequestClock } from '../spawn.cjs';
 import 'node:child_process';
 import '../env.cjs';

package/dist/server/index.d.ts

@@ -1,6 +1,6 @@
-import { b as AgentCallOpts, A as AgentEvent } from '../contract-types-BUHUMF9R.js';
-import { E as EngineSdkError } from '../error-codes-DrNf0gwT.js';
-import { I as InitializeResult, R as RunContextParams, b as InitializeParams } from '../methods-BdIH3FwS.js';
+import { c as AgentCallOpts, A as AgentEvent } from '../contract-types-C1scOS_M.js';
+import { E as EngineSdkError } from '../error-codes-o4rNd1Ee.js';
+import { I as InitializeResult, R as RunContextParams, b as InitializeParams } from '../methods-CPMc4cvF.js';
 import { ReverseRequestClock } from '../spawn.js';
 import 'node:child_process';
 import '../env.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/subagent-engine-sdk",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Engine-side SDK for the subagent engine protocol: NDJSON stdio contract types, engine primitives (schema emulation, nesting guard, kill chain, journal replay projection, data-dir/paths resolution) — the shared contract root between subagent-core and engine CLI packages (engines import SDK only, never core)",
   "type": "module",
   "license": "MIT",
@@ -33,6 +33,17 @@
       },
       "default": "./dist/protocol/index.js"
     },
+    "./journal-replay": {
+      "import": {
+        "types": "./dist/journal-replay.d.ts",
+        "default": "./dist/journal-replay.js"
+      },
+      "require": {
+        "types": "./dist/journal-replay.d.cts",
+        "default": "./dist/journal-replay.cjs"
+      },
+      "default": "./dist/journal-replay.js"
+    },
     "./server": {
       "import": {
         "types": "./dist/server/index.d.ts",
@@ -45,7 +56,7 @@
       "default": "./dist/server/index.js"
     }
   },
-  "$comment": "W1 骨架（docs/design/subagent-engine-protocolization.impl-plan.md §2.1）。双形态同 subagent-core 先例（D4）：workspace 消费走 import 条件 -> src；npm 消费走 publishConfig -> dist。exports 面先收窄到 ./ 与 ./protocol（exports = semver 契约，收窄不放宽；引擎包 W5/W7 消费经主 barrel）。协议版本独立于包版本：ENGINE_PROTOCOL_VERSION = 1（src/protocol/engine-protocol.ts）。不变量：本包禁止 import @zhushanwen/subagent-core（检查 .githooks/check-engine-sdk-boundary.mjs）。src/env.ts 与 src/spawn.ts 是 W12 领地（impl-plan §2.12），本单元仅空骨架占位。tsup entry 逐模块具名登记（§2.1 末行），新增模块必须同步登记。files 不含 src/（对齐 subagent-core 2026-09-16 同型收敛）：npm 消费方经 publishConfig 整体替换后全指 dist，TS 源仅服务 workspace（node_modules symlink 直读磁盘源文件，不经 tarball）；dist 产物无 sourcemap/sourceMappingURL，移除 src 零断链。已知残留：顶层 main（src/index.ts，workspace 形态载体）被 npm files 规则强制隐含打进 tarball，对 npm 消费者不可达，纯体积噪声。",
+  "$comment": "W1 骨架（docs/design/subagent-engine-protocolization.impl-plan.md §2.1）。双形态同 subagent-core 先例（D4）：workspace 消费走 import 条件 -> src；npm 消费走 publishConfig -> dist。exports 面 = ./ 与 ./protocol、./server、./journal-replay（exports = semver 契约，收窄不放宽；引擎包 W5/W7 消费经主 barrel；./journal-replay 是 reducer 单源的 deep import 通道——core 持久化层经它引用避免拖 barrel 的 spawn/env/child_process 图，见 journal-replay.ts 头注）。协议版本独立于包版本：ENGINE_PROTOCOL_VERSION = 1（src/protocol/engine-protocol.ts）。不变量：本包禁止 import @zhushanwen/subagent-core（检查 .githooks/check-engine-sdk-boundary.mjs）。src/env.ts 与 src/spawn.ts 是 W12 领地（impl-plan §2.12），本单元仅空骨架占位。tsup entry 逐模块具名登记（§2.1 末行），新增模块必须同步登记。files 不含 src/（对齐 subagent-core 2026-09-16 同型收敛）：npm 消费方经 publishConfig 整体替换后全指 dist，TS 源仅服务 workspace（node_modules symlink 直读磁盘源文件，不经 tarball）；dist 产物无 sourcemap/sourceMappingURL，移除 src 零断链。已知残留：顶层 main（src/index.ts，workspace 形态载体）被 npm files 规则强制隐含打进 tarball，对 npm 消费者不可达，纯体积噪声。",
   "files": [
     "dist/"
   ],