@zhushanwen/extension-protocol 0.15.0 → 0.16.0

package/dist/index.d.ts

@@ -981,20 +981,25 @@ declare function isFormAnswers(value: unknown): value is FormAnswers;
  */
 declare const SESSION_MANAGER_MARKER = "\0TAIJI_SESSION_MANAGER";
 /**
- * 6 个 action 的运行时集合（与 SessionManagerAction 类型同源——types.ts 从此派生）。
+ * 7 个 action 的运行时集合（与 SessionManagerAction 类型同源——types.ts 从此派生）。
  * event-adapter 用它把 JSON 解析出的 action 字符串收窄为联合类型，
  * 非法值折叠为 '__malformed__' 哨兵（与 handler default 分支同走 cancelled）。
+ *
+ * 'watch'（notify-once D6）：通知债权的纯应答通道——单键 params={notifyId} 寻址、
+ * 不传 timeout、fire-and-forget 长挂 select；必须在本集合内，否则 event-adapter
+ * 把它折叠成 '__malformed__'（旧 runtime 兼容象限的静默降级形态），watch 永远到不了
+ * handler 路由。
  */
-declare const SESSION_MANAGER_ACTIONS: readonly ["create", "send", "history", "status", "list", "abort"];
+declare const SESSION_MANAGER_ACTIONS: readonly ["create", "send", "history", "status", "list", "abort", "watch"];
 
 /**
  * session-manager extension 的类型定义。
  *
- * 6 个 action 的请求 params 和结果类型，供 handler 和 extension 共用。
+ * 7 个 action 的请求 params 和结果类型，供 handler 和 extension 共用。
  * marker 检测后按 action 分发到对应 handler 分支。
  */
 
-/** session-manager 支持的 6 个 action（从 SESSION_MANAGER_ACTIONS 集合派生，值与类型同源） */
+/** session-manager 支持的 7 个 action（从 SESSION_MANAGER_ACTIONS 集合派生，值与类型同源） */
 type SessionManagerAction = (typeof SESSION_MANAGER_ACTIONS)[number];
 /** 各 action 的请求参数映射 */
 interface SessionManagerParams {
@@ -1004,6 +1009,7 @@ interface SessionManagerParams {
     status: SessionManagerStatusParams;
     list: SessionManagerListParams;
     abort: SessionManagerAbortParams;
+    watch: SessionManagerWatchParams;
 }
 /** create action 参数 */
 interface SessionManagerCreateParams {
@@ -1013,11 +1019,21 @@ interface SessionManagerCreateParams {
     label?: string;
     /** 初始 prompt（可选；提供时 create 后立即注入——设计文档 §5.2 原子性决策） */
     prompt?: string;
+    /**
+     * 完成通知债权的幂等键（optional，notify-once D2/D6）：extension 侧
+     * `crypto.randomUUID()` 前缀 `sm-` 生成。缺省/畸形 → runtime 不 arm、
+     * `willNotify:false`、零完成通知——兼容判据从版本二分改为字段有无。
+     * 形态判定不在 params 守卫（畸形不构成 params 错误、动作照常执行），
+     * 由 runtime 受理点消费 `isSessionManagerNotifyId` 作 arm 判据。
+     */
+    notifyId?: string;
 }
 /** send action 参数 */
 interface SessionManagerSendParams {
     sessionId: string;
     prompt: string;
+    /** 完成通知债权的幂等键（optional，语义同 create：缺省/畸形 → 不 arm + willNotify:false） */
+    notifyId?: string;
 }
 /** history action 参数 */
 interface SessionManagerHistoryParams {
@@ -1035,9 +1051,20 @@ type SessionManagerListParams = Record<string, never>;
 interface SessionManagerAbortParams {
     sessionId: string;
 }
-/** create：全字段可选 string */
+/**
+ * watch action 参数（notify-once D2/D6）：通知债权的纯应答通道，**单键寻址**——
+ * runtime 按 `(调用方 parentSid, notifyId)` 反查 claim，parentSid 取自调用方连接身份、
+ * **协议面不定义不携带**（可推导字段免传，多余字段被守卫拒绝）。不传 timeout、
+ * fire-and-forget 长挂 select；每 claim 单 watch 槽（新覆盖旧，runtime 只 respond 最新）。
+ */
+interface SessionManagerWatchParams {
+    /** 目标 claim/lifetime 的幂等键（`sm-` 前缀 UUID，形态自检见 isSessionManagerNotifyId） */
+    notifyId: string;
+}
+declare function isSessionManagerNotifyId(v: unknown): v is string;
+/** create：字段可选 string + optional notifyId（类型面，sm- 形态判定归 arm 判据） */
 declare function isSessionManagerCreateParams(v: unknown): v is SessionManagerCreateParams;
-/** send：sessionId + prompt 必填 */
+/** send：sessionId + prompt 必填，notifyId optional（类型面校验同 create） */
 declare function isSessionManagerSendParams(v: unknown): v is SessionManagerSendParams;
 /** history：sessionId 必填、tailTurns 可选 number */
 declare function isSessionManagerHistoryParams(v: unknown): v is SessionManagerHistoryParams;
@@ -1046,11 +1073,31 @@ declare function isSessionManagerStatusParams(v: unknown): v is SessionManagerSt
 declare function isSessionManagerAbortParams(v: unknown): v is SessionManagerAbortParams;
 /** list：无参数（过滤由 handler 固化，params 不携带任何过滤字段） */
 declare function isSessionManagerListParams(v: unknown): v is SessionManagerListParams;
+/**
+ * watch：**封闭单键** `{notifyId}` 守卫（notify-once D2 形态入站自检）——
+ * 空载荷 / 缺字段 / 夹带任何额外字段（如 parentSid：归属由 runtime 取连接身份，
+ * 协议面不定义）/ notifyId 非 string / 形态不符（缺 `sm-` 前缀、非 UUID 体、超长）
+ * → false → handler dispatch 抛错走 respond({error}) 错误闭环（error envelope）。
+ * 形态函数与 lifetimeNotifyId 同一实现（防自检拒掉 runtime 生成的 lifetime watch）。
+ */
+declare function isSessionManagerWatchParams(v: unknown): v is SessionManagerWatchParams;
 /** create 结果 */
 interface SessionManagerCreateResult {
     sessionId: string;
     status: 'created';
     modelId?: string;
+    /**
+     * 完成通知债权是否已 arm（notify-once D6，LLM 契约面显式化）：create 无 prompt /
+     * notifyId 缺省或畸形 → false（零完成通知）；true 时首次完成恰回一条通知。
+     * 注意与 lifetimeNotifyId 正交——后者恒存在（死亡通知与债权无关）。
+     */
+    willNotify: boolean;
+    /**
+     * runtime 在 handleCreate 自动 arm 的 lifetime（死亡）通知幂等键（notify-once D2/D5）：
+     * create 成恒返回、`sm-` 同形态同校验；与 params.notifyId（claim 键）双键独立，
+     * 杜绝撞幂等键。extension 据此注册 pending（register id = 本键）并开终身 watch。
+     */
+    lifetimeNotifyId: string;
 }
 /**
  * send 结果（sd-u5 起）：消息已入队/已投递——目标 busy 时在下一 turn 边界注入。
@@ -1058,6 +1105,8 @@ interface SessionManagerCreateResult {
  */
 interface SessionManagerSendResult {
     queued: true;
+    /** 完成通知债权是否已 arm（notify-once D6）：notifyId 缺省/畸形 → false（零完成通知） */
+    willNotify: boolean;
 }
 /** history 结果 */
 interface SessionManagerHistoryResult {
@@ -1068,10 +1117,18 @@ interface SessionManagerHistoryResult {
 interface SessionManagerStatusResult {
     status: string;
     modelId?: string;
+    /**
+     * 「未送达结果」事实计数（notify-once D6/D7，非警示布尔）：orphaned 与
+     * fulfilled-no-watch（TTL 清扫转入）两态的在册总数。天然无清除语义问题、无
+     * cry-wolf；持久化二期补投时递减自洽。ownership 校验同其余按 sessionId 寻址的 action。
+     */
+    undeliveredResults: number;
 }
 /** list 结果 */
 interface SessionManagerListResult {
     sessions: SessionManagerSessionSummary[];
+    /** 「未送达结果」事实计数（语义同 status：发起方名下全量在册数） */
+    undeliveredResults: number;
 }
 /** list 返回的 session 摘要（精简版） */
 interface SessionManagerSessionSummary {
@@ -1086,6 +1143,60 @@ interface SessionManagerSessionSummary {
 interface SessionManagerAbortResult {
     success: boolean;
 }
+/**
+ * watch 应答 reason 词表（封闭 7 值）——与 pending-entries `mapReasonToStatus` 的
+ * 4 个新 case 同词形（stopped→aborted、exited/deleted/orphaned→cancelled），
+ * **不扩共享词表**：精确状态由通知正文与 `get_session_status` 承载。
+ */
+type SessionManagerWatchReason = 
+/** settle 兑现 / catch-up 快照（outcome 映射 completed/failed/stopped） */
+'completed' | 'failed' | 'stopped'
+/** 终局死亡（delete/forceQuit/不可恢复 crash；respawn 链静默不发声） */
+ | 'exited' | 'deleted'
+/** 静默折叠（主 abort / 二次校验归属失效 / fail-closed 查无 claim / 旧 runtime 兼容象限） */
+ | 'cancelled'
+/** orphan 吸收态（父 pi 死亡批量转移 / TTL 清扫 / respond 失败） */
+ | 'orphaned';
+/**
+ * watch respond payload（notify-once D6，全 additive）——extension 侧 watch 响应的
+ * 唯一权威形状。旧 runtime 象限 respond `null`（不识 watch action），由 extension
+ * 折叠 cancelled——null 不在本类型内，消费方须同时处理。
+ */
+interface SessionManagerWatchRespondPayload {
+    /** 分拣键 (sessionId, reason) 的 reason 腿（D3 两层模型：cancelled/orphaned → 仅
+     *  unregister；exited/deleted → 死亡新闻槽；completed/failed/stopped → 结果新闻） */
+    reason: SessionManagerWatchReason;
+    /**
+     * claim 所属子会话 id 回带——D3 槽键 (sessionId, deathSeq) / 分拣键 (sessionId,
+     * reason) / D9 文案 `<sid>` 的唯一数据源（收口腿闭包仅有父 sid，缺此字段则同父
+     * 多子 deathSeq 跨 child 碰撞）。claim 命中路径（settle/death/orphaned/二次校验）
+     * 恒带；fail-closed（查无 claim）无 claim 可回带 → 缺席——该路径 reason 恒
+     * 'cancelled'，extension 静默收口不消费 sessionId。
+     */
+    sessionId?: string;
+    /** death 批身份（per session 递增；同一死亡事件循环 respond 时 runtime 直供） */
+    deathSeq?: number;
+    /** settle 批身份（per session 递增；批身份 = settleSeq/deathSeq——同批身份才合一条 record） */
+    settleSeq?: number;
+    /** 本批兑现总笔数（同批每条应答携带同值）；death 侧 = 同 deathSeq 的 claim 数（D3 合批口径，runtime 直供，死亡/结果新闻正文消费 fulfills N） */
+    fulfillsN?: number;
+    /** death 应答携带：exit 腿诊断数据通路复刻（400 字截尾沿用现值），extension 文案构造消费 */
+    exitCode?: number | null;
+    stderrTail?: string;
+    /**
+     * 会话文件绝对路径（additive optional，notify-once D9）：通知正文 `Full transcript:`
+     * 指针行的唯一数据源（`~/.taiji/agent/sessions/.../<sid>.jsonl` 形态）。死亡/settle
+     * 应答携带（正文构造消费）；fail-closed 等无 claim 应答不携（该路径静默无文案）。
+     */
+    sessionFilePath?: string;
+}
+/**
+ * watch respond payload 运行时守卫（extension 读侧不信任外部格式——AGENTS 关键规则 5）：
+ * null（旧 runtime 象限）/ 非 record / reason 缺失、非 string 或词表外 / 可选 meta
+ * 类型不符 → false（可选字段缺席一律放行——含 sessionFilePath）。消费方对 false 与
+ * null 同路折叠静默 unregister（fail-safe：未知 reason 不得落 default 误标）。
+ */
+declare function isSessionManagerWatchRespondPayload(v: unknown): v is SessionManagerWatchRespondPayload;
 /** 错误响应形状（send 同步失败时 = { error, hint }；create 已成功时另附 sessionId）。
  * D8 单源化：交集扩展 alias——error/hint 单源于 core 的 ChannelErrorResult，sessionId
  * 为本协议独有扩展（runtime session-manager-handler 活构造：create 已成功但后续步骤
@@ -1382,6 +1493,13 @@ declare function collectActivePendingIds(entries: unknown[], opts?: CollectPendi
  * reopened → completed）——防新词落 default 被记为 completed 的误标（cancelled 同族
  * 事故先例：新枚举值漏映射静默落兜底）。
  *
+ * [notify-once D3 族映射] session-manager watch 应答的 4 个新 reason 同族接入：
+ * stopped→aborted（用户 UI 掐断含债权轮）、exited/deleted/orphaned→cancelled
+ * （终局死亡/删除/orphan 吸收态）。**不扩 MappedPendingStatus/PendingStatus 词表**——
+ * 四个新 reason 全仓零读方按 status 分流（countActiveFromEntries 只用 register−unregister
+ * 差集、notify-summary outcome 读 details 不读 entry.status），精确状态由通知正文与
+ * get_session_status 承载，高于 G2 感知线。
+ *
  * 返回值 MappedPendingStatus（本文件封闭字面量联合）：PendingStatus 枚举留在
  * pending-notifications（本包不引 extension 侧类型），本联合是其终态子集——消费方
  * 免 as 收窄直接赋值。
@@ -1392,4 +1510,4 @@ declare function collectActivePendingIds(entries: unknown[], opts?: CollectPendi
 type MappedPendingStatus = 'completed' | 'failed' | 'cancelled' | 'expired' | 'time_limited' | 'aborted';
 declare function mapReasonToStatus(reason: string): MappedPendingStatus;
 
-export { ASK_USER_MARKER, type AskUserAnswers, type AskUserOption, type AskUserQuestion, BRIDGE_MARKER, BRIDGE_METHODS, type BridgeErrorResponse, type BridgeInterceptResponse, type BridgeMethod, type BridgeRequest, type BridgeSyncPayload, type BridgeToolExecuteResponse, type ChannelErrorResult, type ChoiceQuestion, type CollectPendingIdsOptions, type DualWidgetContent, type ExecutionRecord, type FormAnswers, type FormOption, type FormQuestion, GUI_WIDGET_MARKER, type GuiComponent, type GuiComponentProps, type GuiComponentType, type GuiContext, type GuiRenderResult, HISTORY_LIMIT, INFLIGHT_REPORT_ACK, MS_PER_DAY, MS_PER_HOUR, MS_PER_MINUTE, MS_PER_SECOND, type MappedPendingStatus, type MarkerRpcOptions, type MarkerRpcResult, PENDING_REGISTER_ENTRY_TYPE, PENDING_UNREGISTER_ENTRY_TYPE, PLAN_REVIEW_MARKER, PROTOCOL_VERSION, type PendingEntriesScan, type PlanDocMeta, type PlanReviewComment, type PlanReviewDecision, type PlanReviewRequest, type PlanReviewResponse, type ReplayFoldOptions, SCHEDULE_CREATE_MARKER, SESSION_MANAGER_ACTIONS, SESSION_MANAGER_MARKER, SUBAGENTS_ENGINES_FILENAME, SUBAGENT_BG_NOTIFY_CUSTOM_TYPE, SUBAGENT_DIRECTIVE_CUSTOM_TYPE, SUBAGENT_INFLIGHT_MARKER, type ScheduleDraft, type ScheduleFormResult, type ScheduleKind, type ScheduleQuestion, type ScheduleSpec, type ScheduledTask, type SchedulerEntryLike, type SchedulerEntryOp, type SessionManagerAbortParams, type SessionManagerAbortResult, type SessionManagerAction, type SessionManagerCreateParams, type SessionManagerCreateResult, type SessionManagerErrorResult, type SessionManagerHistoryParams, type SessionManagerHistoryResult, type SessionManagerListParams, type SessionManagerListResult, type SessionManagerParams, type SessionManagerSendParams, type SessionManagerSendResult, type SessionManagerSessionSummary, type SessionManagerStatusParams, type SessionManagerStatusResult, type StatItem, type SubagentEngineConfigView, type SubagentEnginesFile, type SubagentInFlightReport, TASK_ENTRY_TYPE, type TaskKind, type TaskSnapshot, type TaskStatus, type TextQuestion, type TreeItem, type TreeItemIcon, UI_FORM_MARKER, type UiFormInteractOptions, type UiFormInteractResult, WORKFLOW_RESULT_CUSTOM_TYPE, type WidgetIconPathsRejection, type WidgetIconPathsValidation, type WidgetMeta, appendExecutionRecord, applyPendingDiff, callMarkerRpc, collectActivePendingIds, dateToOnceCron, extractGui, firstContentText, formatChannelErrorText, formatDuration, formatRelativeTime, formatSchedule, getAskUserAnswer, getAskUserOther, guiComponent, guiResult, guiSetWidget, isAskUserQuestion, isBridgeErrorResponse, isBridgeInterceptResponse, isBridgeSyncPayload, isBridgeToolExecuteResponse, isChannelErrorResult, isFormAnswers, isFormQuestion, isGuiCapable, isGuiComponent, isGuiRenderResult, isInFlightReportAck, isScheduleDraft, isScheduleFormResult, isSessionManagerAbortParams, isSessionManagerCreateParams, isSessionManagerHistoryParams, isSessionManagerListParams, isSessionManagerSendParams, isSessionManagerStatusParams, isSubagentInFlightReport, isSyncedTool, mapReasonToStatus, onceCronToDate, replayFoldEntries, scanPendingEntries, setWidgetDual, snapshotToTask, uiFormInteract, validateWidgetIconPaths };
+export { ASK_USER_MARKER, type AskUserAnswers, type AskUserOption, type AskUserQuestion, BRIDGE_MARKER, BRIDGE_METHODS, type BridgeErrorResponse, type BridgeInterceptResponse, type BridgeMethod, type BridgeRequest, type BridgeSyncPayload, type BridgeToolExecuteResponse, type ChannelErrorResult, type ChoiceQuestion, type CollectPendingIdsOptions, type DualWidgetContent, type ExecutionRecord, type FormAnswers, type FormOption, type FormQuestion, GUI_WIDGET_MARKER, type GuiComponent, type GuiComponentProps, type GuiComponentType, type GuiContext, type GuiRenderResult, HISTORY_LIMIT, INFLIGHT_REPORT_ACK, MS_PER_DAY, MS_PER_HOUR, MS_PER_MINUTE, MS_PER_SECOND, type MappedPendingStatus, type MarkerRpcOptions, type MarkerRpcResult, PENDING_REGISTER_ENTRY_TYPE, PENDING_UNREGISTER_ENTRY_TYPE, PLAN_REVIEW_MARKER, PROTOCOL_VERSION, type PendingEntriesScan, type PlanDocMeta, type PlanReviewComment, type PlanReviewDecision, type PlanReviewRequest, type PlanReviewResponse, type ReplayFoldOptions, SCHEDULE_CREATE_MARKER, SESSION_MANAGER_ACTIONS, SESSION_MANAGER_MARKER, SUBAGENTS_ENGINES_FILENAME, SUBAGENT_BG_NOTIFY_CUSTOM_TYPE, SUBAGENT_DIRECTIVE_CUSTOM_TYPE, SUBAGENT_INFLIGHT_MARKER, type ScheduleDraft, type ScheduleFormResult, type ScheduleKind, type ScheduleQuestion, type ScheduleSpec, type ScheduledTask, type SchedulerEntryLike, type SchedulerEntryOp, type SessionManagerAbortParams, type SessionManagerAbortResult, type SessionManagerAction, type SessionManagerCreateParams, type SessionManagerCreateResult, type SessionManagerErrorResult, type SessionManagerHistoryParams, type SessionManagerHistoryResult, type SessionManagerListParams, type SessionManagerListResult, type SessionManagerParams, type SessionManagerSendParams, type SessionManagerSendResult, type SessionManagerSessionSummary, type SessionManagerStatusParams, type SessionManagerStatusResult, type SessionManagerWatchParams, type SessionManagerWatchReason, type SessionManagerWatchRespondPayload, type StatItem, type SubagentEngineConfigView, type SubagentEnginesFile, type SubagentInFlightReport, TASK_ENTRY_TYPE, type TaskKind, type TaskSnapshot, type TaskStatus, type TextQuestion, type TreeItem, type TreeItemIcon, UI_FORM_MARKER, type UiFormInteractOptions, type UiFormInteractResult, WORKFLOW_RESULT_CUSTOM_TYPE, type WidgetIconPathsRejection, type WidgetIconPathsValidation, type WidgetMeta, appendExecutionRecord, applyPendingDiff, callMarkerRpc, collectActivePendingIds, dateToOnceCron, extractGui, firstContentText, formatChannelErrorText, formatDuration, formatRelativeTime, formatSchedule, getAskUserAnswer, getAskUserOther, guiComponent, guiResult, guiSetWidget, isAskUserQuestion, isBridgeErrorResponse, isBridgeInterceptResponse, isBridgeSyncPayload, isBridgeToolExecuteResponse, isChannelErrorResult, isFormAnswers, isFormQuestion, isGuiCapable, isGuiComponent, isGuiRenderResult, isInFlightReportAck, isScheduleDraft, isScheduleFormResult, isSessionManagerAbortParams, isSessionManagerCreateParams, isSessionManagerHistoryParams, isSessionManagerListParams, isSessionManagerNotifyId, isSessionManagerSendParams, isSessionManagerStatusParams, isSessionManagerWatchParams, isSessionManagerWatchRespondPayload, isSubagentInFlightReport, isSyncedTool, mapReasonToStatus, onceCronToDate, replayFoldEntries, scanPendingEntries, setWidgetDual, snapshotToTask, uiFormInteract, validateWidgetIconPaths };

package/dist/index.js

@@ -517,14 +517,27 @@ function isRecord(v) {
 function isOptionalString2(v) {
   return v === void 0 || typeof v === "string";
 }
+function isOptionalNumber(v) {
+  return v === void 0 || typeof v === "number";
+}
+function isOptionalNumberOrNull(v) {
+  return v === void 0 || v === null || typeof v === "number";
+}
+var NOTIFY_ID_PATTERN = /^sm-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+function isSessionManagerNotifyId(v) {
+  return typeof v === "string" && NOTIFY_ID_PATTERN.test(v);
+}
+function isOptionalNotifyId(v) {
+  return v === void 0 || typeof v === "string";
+}
 function isSessionIdParams(v) {
   return isRecord(v) && typeof v.sessionId === "string";
 }
 function isSessionManagerCreateParams(v) {
-  return isRecord(v) && isOptionalString2(v.cwd) && isOptionalString2(v.label) && isOptionalString2(v.prompt);
+  return isRecord(v) && isOptionalString2(v.cwd) && isOptionalString2(v.label) && isOptionalString2(v.prompt) && isOptionalNotifyId(v.notifyId);
 }
 function isSessionManagerSendParams(v) {
-  return isRecord(v) && typeof v.sessionId === "string" && typeof v.prompt === "string";
+  return isRecord(v) && typeof v.sessionId === "string" && typeof v.prompt === "string" && isOptionalNotifyId(v.notifyId);
 }
 function isSessionManagerHistoryParams(v) {
   return isRecord(v) && typeof v.sessionId === "string" && (v.tailTurns === void 0 || typeof v.tailTurns === "number");
@@ -538,10 +551,36 @@ function isSessionManagerAbortParams(v) {
 function isSessionManagerListParams(v) {
   return isRecord(v);
 }
+function isSessionManagerWatchParams(v) {
+  if (!isRecord(v)) return false;
+  const keys = Object.keys(v);
+  return keys.length === 1 && keys[0] === "notifyId" && isSessionManagerNotifyId(v.notifyId);
+}
+var WATCH_REASON_SET = /* @__PURE__ */ new Set([
+  "completed",
+  "failed",
+  "stopped",
+  "exited",
+  "deleted",
+  "cancelled",
+  "orphaned"
+]);
+function isSessionManagerWatchRespondPayload(v) {
+  if (!isRecord(v)) return false;
+  if (typeof v.reason !== "string" || !WATCH_REASON_SET.has(v.reason)) return false;
+  if (!isOptionalString2(v.sessionId)) return false;
+  if (!isOptionalNumber(v.deathSeq)) return false;
+  if (!isOptionalNumber(v.settleSeq)) return false;
+  if (!isOptionalNumber(v.fulfillsN)) return false;
+  if (!isOptionalNumberOrNull(v.exitCode)) return false;
+  if (!isOptionalString2(v.stderrTail)) return false;
+  if (!isOptionalString2(v.sessionFilePath)) return false;
+  return true;
+}
 
 // src/extensions/session-manager/marker.ts
 var SESSION_MANAGER_MARKER = "\0TAIJI_SESSION_MANAGER";
-var SESSION_MANAGER_ACTIONS = ["create", "send", "history", "status", "list", "abort"];
+var SESSION_MANAGER_ACTIONS = ["create", "send", "history", "status", "list", "abort", "watch"];
 
 // src/extensions/subagent-inflight/marker.ts
 var SUBAGENT_INFLIGHT_MARKER = "\0TAIJI_SUBAGENT_INFLIGHT";
@@ -633,31 +672,25 @@ function collectActivePendingIds(entries, opts) {
   }
   return ids;
 }
+var REASON_STATUS_MAP = {
+  completed: "completed",
+  failed: "failed",
+  cancelled: "cancelled",
+  expired: "expired",
+  time_limited: "time_limited",
+  budget_limited: "failed",
+  aborted: "aborted",
+  interrupted: "aborted",
+  "interrupted-by-restart": "aborted",
+  "interrupted-by-parent": "aborted",
+  reopened: "completed",
+  stopped: "aborted",
+  exited: "cancelled",
+  deleted: "cancelled",
+  orphaned: "cancelled"
+};
 function mapReasonToStatus(reason) {
-  switch (reason) {
-    case "completed":
-      return "completed";
-    case "failed":
-      return "failed";
-    case "cancelled":
-      return "cancelled";
-    case "expired":
-      return "expired";
-    case "time_limited":
-      return "time_limited";
-    case "budget_limited":
-      return "failed";
-    case "aborted":
-      return "aborted";
-    case "interrupted":
-    case "interrupted-by-restart":
-    case "interrupted-by-parent":
-      return "aborted";
-    case "reopened":
-      return "completed";
-    default:
-      return "completed";
-  }
+  return REASON_STATUS_MAP[reason] ?? "completed";
 }
 export {
   ASK_USER_MARKER,
@@ -725,8 +758,11 @@ export {
   isSessionManagerCreateParams,
   isSessionManagerHistoryParams,
   isSessionManagerListParams,
+  isSessionManagerNotifyId,
   isSessionManagerSendParams,
   isSessionManagerStatusParams,
+  isSessionManagerWatchParams,
+  isSessionManagerWatchRespondPayload,
   isSubagentInFlightReport,
   isSyncedTool,
   isTerminalBackgroundTaskState,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/extension-protocol",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Cross-layer pi extension contract package: dual-mode (TUI/GUI) rendering helpers, session/background-task/pending-entries protocols, and shared behavior primitives",
   "type": "module",
   "main": "dist/index.js",