@zhushanwen/extension-protocol 0.17.0 → 0.18.0

package/README.md

@@ -7,9 +7,15 @@ pi extension 跨层契约包：类型 + helper 函数 + 共享行为原语，零
 - `core/` —— 通用协议层（所有 extension 共用：`GuiComponent` + 布局原语 + 传输编码 + 双模 widget helper）
 - `extensions/` —— 有运行时定制逻辑的 extension（marker + helper）
   - `ask-user/` —— 富交互（select 通道 + marker）
+  - `plan/` —— plan 生命周期状态机 + 审阅回传值域契约 + 旧 entry legacy 读取（纯函数零 pi 依赖，扩展 / runtime / renderer 三层共用）
+  - `scheduler/` —— scheduler 任务条目契约 + entry 重放折叠（replayFoldEntries）+ 时间格式化（纯契约与纯函数，零 pi/node 依赖）
+  - `scheduler-create/` —— scheduler 创建确认共享资产（ScheduleDraft / ScheduleFormResult 类型 + 形状与时间折叠守卫 + marker）
   - `session-manager/` —— agent-managed session 嵌套 `{action, params}` 契约（select 通道 + marker）
-  - `plugin-bridge/` —— plugin system bridge（插件工具/事件/拦截经 select 通道 + marker 桥接）
   - `subagent-engine/` —— 引擎可发现性（`engines.json` 状态文件 + 引擎配置视图）
+  - `subagent-inflight/` —— subagent 在途聚合上报（绝对计数报告 + marker，select 通道）
+  - `subagent-notify/` —— subagent-workflow 通知通道 customType 常量唯一来源（workflow 结果 / 后台通知 / subagent 指令三类）
+  - `ui-form/` —— 统一提问表单协议（ask-user / scheduler / plan 三方提问统一入口：类型 + marker + 交互 helper + 守卫）
+  - 完整子协议清单以 `src/index.ts` 导出为准
 - `pending-entries` —— pending 事件流差集核心（register 去重 + unregister 抵消，纯算法）
 - `background-task` —— base-tool-enhance 后台任务 `registry.json` 文件契约
 - 子出口 `@zhushanwen/extension-protocol/background-task` —— 后台任务行为原语（进程处置 / registry 文件 IO / output tail，含 node 内建依赖，不进 index 桶出口）

package/dist/index.d.ts

@@ -392,18 +392,18 @@ declare function firstContentText(result: {
 /**
  * select+marker 通道 RPC 原语（D8）。
  *
- * 三消费方（plugin-bridge / session-manager / subagent-workflow inflight-reporter）
- * 此前各自手写「ctx.ui.select(marker, [payload], opts) + 失败折叠 + JSON 检测」传输核，
+ * 消费方（session-manager / subagent-workflow inflight-reporter）各自手写过
+ * 「ctx.ui.select(marker, [payload], opts) + 失败折叠 + JSON 检测」传输核，
  * 形态同构、留痕/超时策略各异。本原语只收敛传输核与失败折叠契约，真差异留在调用方：
  *
  * - 判别结果而非抛错（调用方统一按 reason 折叠 isError / 重试）；
  * - 回包只做 JSON 合法性检测（`non-json` 判别 + 留痕），parsed 结果的消费留调用方——
- *   value 恒 raw string（session-manager raw 透传 / plugin-bridge 各形状守卫 / inflight
- *   ack 全等匹配，三态回包消费是真差异，不进原语）；
+ *   value 恒 raw string（session-manager raw 透传 / inflight ack 全等匹配，回包消费
+ *   是真差异，不进原语）；
  * - payload 调用方已序列化（原语不 stringify——各协议序列化形状各异：嵌套
- *   {action,params} / BridgeRequest / 快照帧，不引入内部 stringify 异常面）；
- * - mode 门控留调用方（三方现状各异：plugin-bridge 在 callBridge 内 / inflight 在
- *   attachSession 处 / session-manager 无门控——四态 reason 无 non-rpc 语义）；
+ *   {action,params} / 快照帧，不引入内部 stringify 异常面）；
+ * - mode 门控留调用方（inflight 在 attachSession 处 / session-manager 无门控——
+ *   四态 reason 无 non-rpc 语义）；
  * - `ui.select` 缺席（非 GUI ctx）由调用方前置判定（沿 ask-user askUserInteract 的
  *   `isGuiCapable(ctx) && ctx.ui?.select` 先例）；误用即 throw 明确错误。
  *
@@ -427,9 +427,9 @@ interface MarkerRpcOptions {
      * 日志策略（级别 / 前缀 / 防刷屏）归调用方——真差异保留。 */
     log?: (msg: string, detail?: object) => void;
 }
-/** 错误回包底层形状：select+marker 通道各协议（plugin-bridge / session-manager）
+/** 错误回包底层形状：select+marker 通道各协议（session-manager）
  * runtime 侧异常折叠的共用单源（不裸 reject，error 闭环走同一回包通道）。
- * BridgeErrorResponse / SessionManagerErrorResult 是本形状的 alias（D8 单源化）。 */
+ * SessionManagerErrorResult 是本形状的 alias（D8 单源化）。 */
 interface ChannelErrorResult {
     error: string;
     hint?: string;
@@ -1429,8 +1429,7 @@ interface SubagentInFlightReport {
     inFlight: number;
     /**
      * 上报所属 session（ctx.sessionManager.getSessionId()）。pi 延迟写入窗口内可能取
-     * 不到（plugin-bridge getSessionId 同款防御）——缺席时消费方按无法归属丢弃整帧
-     * （不镜像），不视为协议错误。
+     * 不到——缺席时消费方按无法归属丢弃整帧（不镜像），不视为协议错误。
      */
     sessionId?: string;
     /** 产生时点（ms epoch，pi 进程内取值）。诊断/乱序排查用，消费方不依赖其单调性。 */
@@ -1468,6 +1467,92 @@ declare function isInFlightReportAck(v: unknown): v is typeof INFLIGHT_REPORT_AC
  */
 declare const SUBAGENT_INFLIGHT_MARKER = "\0TAIJI_SUBAGENT_INFLIGHT";
 
+/**
+ * journal 事件推送的类型定义（event-push-channel 协议面）。
+ *
+ * 契约两端：
+ *   - 写侧（生产）：@zhushanwen/pi-subagent-workflow 壳层（src/host/journal-reporter.ts）
+ *     监听 subagent-core 的 journal 落盘出口回调（notifyJournalAppended），经 select
+ *     通道带回执推送；
+ *   - 读侧（消费）：taiji runtime event-adapter 的 marker 路由分支 → journal-report-router
+ *     → SessionEventProjection（applyJournalReport：seq 缺口判定 → 缺口触发本地补读 → fold）。
+ *
+ * 语义锚点（设计 §3.3）：推送报告只携带事件本体（事件信封自带 seq），不另设水位协商
+ * ——消费方 per 文件持两个水位（字节偏移 = 补读起点、已折叠最大 seq = 去重判据），
+ * 重复投递由域 fold 的 seq 单调检查构造性幂等。确认回执 = runtime 同步 fold 应用后
+ * resolve（回执 = 「已应用」而非「已接收」）。
+ */
+/** journal 两域（单 marker 载荷判别字段——设计 §3.4 D2：两域推送方/接收方/通道语义同构，不拆双 marker）。 */
+type SubagentJournalDomain = 'run' | 'record';
+/**
+ * 单条 journal 事件（run 域 = run journal 行 / record 域 = record 事件行——域内
+ * 词表校验归读侧与文件行同一解析器，本层只校验跨域共同信封）。
+ */
+interface SubagentJournalEvent {
+    /** 事件类型（域词表成员资格由读侧按域校验）。 */
+    type: string;
+    /** 事件时点（ms epoch；信封必填）。 */
+    ts: number;
+    /**
+     * journal 行序号（写入方 JsonlEventStream.append 统一分配）。缺省 = W1 前存量
+     * 无 seq 行（设计 §3.3 兼容条款：无 seq 事件不参与缺口判定，fold 按状态机语义幂等）。
+     */
+    seq?: number;
+    /** 域内载荷字段原样透传（写侧 = 刚落盘的行对象，无二次塑形）。 */
+    [key: string]: unknown;
+}
+/**
+ * 单帧 journal 事件报告（pi 进程 → runtime，经 select 通道，title = SUBAGENT_JOURNAL_MARKER，
+ * options = [JSON.stringify(本形状)]）。单帧只覆盖一个文件（fileKey 单数——设计 §3.4：
+ * fileKey = runId 或 sa-id；多文件积压由写侧按组逐帧发送）。
+ */
+interface SubagentJournalReport {
+    /** 事件所属域（run / record 判别）。 */
+    domain: SubagentJournalDomain;
+    /** 文件键：run 域 = runId，record 域 = record id（sa-id）。 */
+    fileKey: string;
+    /** 本帧事件（写入序；写侧落盘提交点之后的增量批次）。 */
+    events: SubagentJournalEvent[];
+    /**
+     * 上报所属 session（ctx.sessionManager.getSessionId()）。pi 延迟写入窗口内可能取
+     * 不到——缺席时消费方按无法归属丢弃整帧（不 fold 不 ack），不视为协议错误
+     * （归属权威 = 连接的 sessionId，本字段只作在场性判据——inflight 同款先例）。
+     */
+    sessionId?: string;
+    /** 产生时点（ms epoch，pi 进程内取值）。诊断/乱序排查用，消费方不依赖其单调性。 */
+    emittedAt: number;
+}
+/**
+ * select 通道的确认回包（runtime event-adapter 处理完帧后 resolve 给 pi 侧的
+ * JSON 字符串）。回执语义 = 「已应用」（runtime 同步完成 fold 应用后 resolve，
+ * 设计 §3.4 D7 生效回执）——写侧非本字符串即未确认：首败 warn 留证 + 缓冲丢弃
+ * 不重推（完整性由消费方 seq 缺口补读收敛，设计 §3.3 D5）。
+ */
+declare const JOURNAL_REPORT_ACK: "{\"ack\":true}";
+/**
+ * SubagentJournalReport 形状守卫：domain 落两域词表、fileKey 非空串、events 逐条
+ * 过信封守卫、sessionId 缺席或 string。event-adapter 路由分支消费；非法帧返回
+ * false（调用方丢弃，不 fold 不 ack）。
+ */
+declare function isSubagentJournalReport(v: unknown): v is SubagentJournalReport;
+/** 确认回包形状守卫（pi 侧 reporter 消费——非本字符串即未确认）。 */
+declare function isJournalReportAck(v: unknown): v is typeof JOURNAL_REPORT_ACK;
+
+/**
+ * journal 事件推送的 title marker。runtime event-adapter 检测此 marker 区分
+ * journal 事件报告与普通 select；pi 侧壳层（@zhushanwen/pi-subagent-workflow 的
+ * host/journal-reporter）经同一 marker 以带回执语义推送 SubagentJournalReport
+ * 帧（单一来源，两端口径必然一致）。
+ *
+ * NUL 前缀确保不会与 extension 正常的 select title 冲突。
+ * 与 SUBAGENT_INFLIGHT_MARKER / ASK_USER_MARKER / SESSION_MANAGER_MARKER 同理。
+ *
+ * 设计权威源：.tmp/tech-design/event-push-channel.md §3.1/§3.4（journal 写入方
+ * subagent-core 在落盘提交点经本 marker 通道把新事件批量推给 runtime，通道数量
+ * = 1 个，载荷内 domain 字段判别 run/record 两域）。
+ */
+declare const SUBAGENT_JOURNAL_MARKER = "\0TAIJI_SUBAGENT_JOURNAL";
+
 /**
  * subagent-workflow 通知通道的 custom_message customType 词表（单源）。
  *
@@ -1500,99 +1585,6 @@ declare const SUBAGENT_BG_NOTIFY_CUSTOM_TYPE: "subagent-bg-notify";
  *  上下文 + renderer 定向气泡）。shared parseSubagentDirective / runtime display 覆写消费。 */
 declare const SUBAGENT_DIRECTIVE_CUSTOM_TYPE: "subagent-directive";
 
-/**
- * plugin-bridge 请求的 title marker。runtime event-adapter 和 pi 侧
- * bridge extension（@zhushanwen/pi-plugin-bridge）双端消费此 marker，
- * 在 select 通道上区分 bridge 帧与普通 select（单一来源，两端口径必然一致）。
- *
- * NUL 前缀确保不会与 extension 正常的 select title 冲突。
- * 与 ASK_USER_MARKER / SESSION_MANAGER_MARKER / GUI_WIDGET_MARKER 同理。
- */
-declare const BRIDGE_MARKER = "\0TAIJI_BRIDGE";
-/**
- * 协议 v2 的 4 个 method 运行时集合（与 BridgeMethod 类型同源——types.ts 从此派生）。
- * event-adapter 用它校验 marker 帧的 method 合法性，
- * 非法值折叠为 'bridge:malformed' 哨兵（handler 回 malformed 错误，不静默丢弃）。
- */
-declare const BRIDGE_METHODS: readonly ["bridge:sync", "bridge:tool_execute", "bridge:event", "bridge:intercept"];
-
-/**
- * plugin-bridge 协议 v2 的类型定义。
- *
- * select + BRIDGE_MARKER 通道上的请求/回包形状，pi 侧 bridge extension
- * （序列化发送方）与 runtime bridge-handler（解析与回包方）共用。
- * 向后不兼容旧 bridge:* method 承载（旧链路本来就不通，改名无收益）。
- * marker 检测后按 method 分发到对应 handler 分支。
- */
-
-/** 协议 v2 的 4 个 method（从 BRIDGE_METHODS 集合派生，值与类型同源） */
-type BridgeMethod = (typeof BRIDGE_METHODS)[number];
-/** bridge 请求的统一形状（pi bridge extension → runtime via select 通道） */
-interface BridgeRequest {
-    method: BridgeMethod;
-    /** tool_execute 专属：工具名 */
-    toolName?: string;
-    /** tool_execute 专属：工具调用 id */
-    toolCallId?: string;
-    /** tool_execute 专属：工具入参 */
-    params?: Record<string, unknown>;
-    /** 发起请求的 session（tool_execute/event/intercept 携带，供 runtime 按 session 路由
-     * 防跨 session 串台；bridge:sync 全局快照请求不带） */
-    sessionId?: string;
-    /** event / intercept 专属：pi 原生事件名 */
-    eventName?: string;
-    /** event / intercept 专属：事件负载 */
-    data?: unknown;
-}
-/** tool_execute 回包：插件工具执行结果 */
-interface BridgeToolExecuteResponse {
-    content: string;
-    isError?: boolean;
-}
-/** sync 回包：工具清单快照（pi 侧命令发现不走本协议，另走 getCommands 通路） */
-interface BridgeSyncPayload {
-    tools: Array<{
-        name: string;
-        description: string;
-        parameters: Record<string, unknown>;
-    }>;
-    success: true;
-}
-/** intercept 回包：before_agent_start 拦截决策（bridge 侧把 injectedMessages 映射为单条 CustomMessage） */
-interface BridgeInterceptResponse {
-    blocked?: boolean;
-    reason?: string;
-    injectedMessages: unknown[];
-}
-/** 错误回包：runtime 侧异常折叠（不裸 reject；bridge 侧解析后以 isError 返回）。
- * D8 单源化：底层形状 alias 到 core 的 ChannelErrorResult（导出名与文件位置不变，
- * public API 零破坏）。 */
-type BridgeErrorResponse = ChannelErrorResult;
-
-/**
- * plugin-bridge 回包形状守卫族（D11 自 extensions/taiji/plugin-bridge index.ts 零改动迁入）。
- *
- * 「marker + types + 守卫」同住惯例（session-manager / subagent-inflight 先例）：
- * 回包形状的运行时检测与类型定义同源维护。当前唯一消费方 = pi 侧 bridge
- * extension；runtime bridge-handler 的 5 处 `as string` 断言是后续批次的第二
- * 消费方（换校验的铺路，设计 D11 登记项）。
- *
- * isRecord 为模块内私有副本（排数组严版——与 subagent-inflight / session-manager
- * 副本同款同义）：protocol 不依赖 extensions 层的 ext-guards（分层边界裁决，D3
- * 明确排除），包内三份私有副本并存是裁决下的既有惯例，语义必须一致。
- *
- * 设计权威源：docs/architecture/ext-simplify-17-shared-extraction.md §3.3 D11。
- */
-
-/** runtime 错误闭环形状 {error, hint?}（设计 §3.3-D1：不裸 reject）——检测逻辑单源于
- * core 的 isChannelErrorResult（D8），本名保留为守卫族整体成员（D11 迁移） */
-declare function isBridgeErrorResponse(v: unknown): v is BridgeErrorResponse;
-declare function isBridgeToolExecuteResponse(v: unknown): v is BridgeToolExecuteResponse;
-declare function isBridgeSyncPayload(v: unknown): v is BridgeSyncPayload;
-declare function isBridgeInterceptResponse(v: unknown): v is BridgeInterceptResponse;
-/** sync 清单里的单个工具条目（parameters 顶层必须 type:'object'——OpenAI 兼容红线） */
-declare function isSyncedTool(v: unknown): v is BridgeSyncPayload['tools'][number];
-
 /**
  * 子代理引擎契约（U7 引擎可发现性 + GUI 引擎选择）。
  *
@@ -1705,4 +1697,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_LIFECYCLE_EVENTS, PLAN_LIFECYCLE_STATES, PLAN_REVIEW_MARKER, PLAN_SELF_REVIEW_MAX_BYTES, PLAN_STATE_CUSTOM_TYPE, PROTOCOL_VERSION, type PendingEntriesScan, type PlanDocMeta, type PlanLifecycleEvent, type PlanLifecycleState, type PlanPhase, type PlanReviewComment, type PlanReviewDecision, type PlanReviewRequest, type PlanReviewResponse, type PlanReviewResponseEnvelope, type PlanTransitionResult, 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, derivePhase, extractGui, firstContentText, formatChannelErrorText, formatDuration, formatRelativeTime, formatSchedule, getAskUserAnswer, getAskUserOther, guiComponent, guiResult, guiSetWidget, isAskUserQuestion, isBridgeErrorResponse, isBridgeInterceptResponse, isBridgeSyncPayload, isBridgeToolExecuteResponse, isChannelErrorResult, isFormAnswers, isFormQuestion, isGuiCapable, isGuiComponent, isGuiRenderResult, isInFlightReportAck, isPlanReviewRequest, isPlanReviewResponse, isScheduleDraft, isScheduleFormResult, isSessionManagerAbortParams, isSessionManagerCreateParams, isSessionManagerHistoryParams, isSessionManagerListParams, isSessionManagerNotifyId, isSessionManagerSendParams, isSessionManagerStatusParams, isSessionManagerWatchParams, isSessionManagerWatchRespondPayload, isSubagentInFlightReport, isSyncedTool, mapReasonToStatus, onceCronToDate, parsePlanReviewResponse, readLifecycleState, readResumeHint, replayFoldEntries, scanPendingEntries, setWidgetDual, snapshotToTask, transition, truncateSelfReview, uiFormInteract, validateWidgetIconPaths };
+export { ASK_USER_MARKER, type AskUserAnswers, type AskUserOption, type AskUserQuestion, 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, JOURNAL_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_LIFECYCLE_EVENTS, PLAN_LIFECYCLE_STATES, PLAN_REVIEW_MARKER, PLAN_SELF_REVIEW_MAX_BYTES, PLAN_STATE_CUSTOM_TYPE, PROTOCOL_VERSION, type PendingEntriesScan, type PlanDocMeta, type PlanLifecycleEvent, type PlanLifecycleState, type PlanPhase, type PlanReviewComment, type PlanReviewDecision, type PlanReviewRequest, type PlanReviewResponse, type PlanReviewResponseEnvelope, type PlanTransitionResult, 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, SUBAGENT_JOURNAL_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, type SubagentJournalDomain, type SubagentJournalEvent, type SubagentJournalReport, 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, derivePhase, extractGui, firstContentText, formatChannelErrorText, formatDuration, formatRelativeTime, formatSchedule, getAskUserAnswer, getAskUserOther, guiComponent, guiResult, guiSetWidget, isAskUserQuestion, isChannelErrorResult, isFormAnswers, isFormQuestion, isGuiCapable, isGuiComponent, isGuiRenderResult, isInFlightReportAck, isJournalReportAck, isPlanReviewRequest, isPlanReviewResponse, isScheduleDraft, isScheduleFormResult, isSessionManagerAbortParams, isSessionManagerCreateParams, isSessionManagerHistoryParams, isSessionManagerListParams, isSessionManagerNotifyId, isSessionManagerSendParams, isSessionManagerStatusParams, isSessionManagerWatchParams, isSessionManagerWatchRespondPayload, isSubagentInFlightReport, isSubagentJournalReport, mapReasonToStatus, onceCronToDate, parsePlanReviewResponse, readLifecycleState, readResumeHint, replayFoldEntries, scanPendingEntries, setWidgetDual, snapshotToTask, transition, truncateSelfReview, uiFormInteract, validateWidgetIconPaths };

package/dist/index.js

@@ -752,35 +752,44 @@ function isInFlightReportAck(v) {
   return v === INFLIGHT_REPORT_ACK;
 }
 
-// src/extensions/subagent-notify/custom-types.ts
-var WORKFLOW_RESULT_CUSTOM_TYPE = "workflow-result";
-var SUBAGENT_BG_NOTIFY_CUSTOM_TYPE = "subagent-bg-notify";
-var SUBAGENT_DIRECTIVE_CUSTOM_TYPE = "subagent-directive";
-
-// src/extensions/plugin-bridge/marker.ts
-var BRIDGE_MARKER = "\0TAIJI_BRIDGE";
-var BRIDGE_METHODS = ["bridge:sync", "bridge:tool_execute", "bridge:event", "bridge:intercept"];
+// src/extensions/subagent-journal/marker.ts
+var SUBAGENT_JOURNAL_MARKER = "\0TAIJI_SUBAGENT_JOURNAL";
 
-// src/extensions/plugin-bridge/guards.ts
+// src/extensions/subagent-journal/types.ts
+var JOURNAL_REPORT_ACK = '{"ack":true}';
 function isRecord3(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
-function isBridgeErrorResponse(v) {
-  return isChannelErrorResult(v);
-}
-function isBridgeToolExecuteResponse(v) {
-  return isRecord3(v) && typeof v.content === "string" && (v.isError === void 0 || typeof v.isError === "boolean");
-}
-function isBridgeSyncPayload(v) {
-  return isRecord3(v) && v.success === true && Array.isArray(v.tools);
+function isSubagentJournalEvent(v) {
+  if (!isRecord3(v)) return false;
+  if (typeof v.type !== "string" || v.type === "") return false;
+  if (typeof v.ts !== "number" || !Number.isFinite(v.ts)) return false;
+  if (v.seq !== void 0 && (typeof v.seq !== "number" || !Number.isSafeInteger(v.seq) || v.seq < 1)) {
+    return false;
+  }
+  return true;
 }
-function isBridgeInterceptResponse(v) {
-  return isRecord3(v) && Array.isArray(v.injectedMessages);
+function isSubagentJournalReport(v) {
+  if (!isRecord3(v)) return false;
+  if (v.domain !== "run" && v.domain !== "record") return false;
+  if (typeof v.fileKey !== "string" || v.fileKey === "") return false;
+  if (!Array.isArray(v.events)) return false;
+  for (const event of v.events) {
+    if (!isSubagentJournalEvent(event)) return false;
+  }
+  if (typeof v.emittedAt !== "number") return false;
+  if (v.sessionId !== void 0 && typeof v.sessionId !== "string") return false;
+  return true;
 }
-function isSyncedTool(v) {
-  return isRecord3(v) && typeof v.name === "string" && typeof v.description === "string" && isRecord3(v.parameters) && v.parameters.type === "object";
+function isJournalReportAck(v) {
+  return v === JOURNAL_REPORT_ACK;
 }
 
+// src/extensions/subagent-notify/custom-types.ts
+var WORKFLOW_RESULT_CUSTOM_TYPE = "workflow-result";
+var SUBAGENT_BG_NOTIFY_CUSTOM_TYPE = "subagent-bg-notify";
+var SUBAGENT_DIRECTIVE_CUSTOM_TYPE = "subagent-directive";
+
 // src/extensions/subagent-engine/contract.ts
 var SUBAGENTS_ENGINES_FILENAME = "engines.json";
 
@@ -849,11 +858,10 @@ export {
   BACKGROUND_TASK_REGISTRY_FILENAME,
   BACKGROUND_TASK_REGISTRY_VERSION,
   BASE_TOOL_ENHANCE_DIRNAME,
-  BRIDGE_MARKER,
-  BRIDGE_METHODS,
   GUI_WIDGET_MARKER,
   HISTORY_LIMIT,
   INFLIGHT_REPORT_ACK,
+  JOURNAL_REPORT_ACK,
   MAX_TERMINAL_REGISTRY_ENTRIES,
   MS_PER_DAY,
   MS_PER_HOUR,
@@ -874,6 +882,7 @@ export {
   SUBAGENT_BG_NOTIFY_CUSTOM_TYPE,
   SUBAGENT_DIRECTIVE_CUSTOM_TYPE,
   SUBAGENT_INFLIGHT_MARKER,
+  SUBAGENT_JOURNAL_MARKER,
   TASK_ENTRY_TYPE,
   UI_FORM_MARKER,
   WORKFLOW_RESULT_CUSTOM_TYPE,
@@ -897,10 +906,6 @@ export {
   isActiveBackgroundTaskState,
   isAskUserQuestion,
   isBackgroundTaskRegistryEntry,
-  isBridgeErrorResponse,
-  isBridgeInterceptResponse,
-  isBridgeSyncPayload,
-  isBridgeToolExecuteResponse,
   isChannelErrorResult,
   isFormAnswers,
   isFormQuestion,
@@ -908,6 +913,7 @@ export {
   isGuiComponent,
   isGuiRenderResult,
   isInFlightReportAck,
+  isJournalReportAck,
   isPlanReviewRequest,
   isPlanReviewResponse,
   isScheduleDraft,
@@ -922,7 +928,7 @@ export {
   isSessionManagerWatchParams,
   isSessionManagerWatchRespondPayload,
   isSubagentInFlightReport,
-  isSyncedTool,
+  isSubagentJournalReport,
   isTerminalBackgroundTaskState,
   mapReasonToStatus,
   onceCronToDate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/extension-protocol",
-  "version": "0.17.0",
+  "version": "0.18.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",