@downcity/agent 1.1.198 → 1.1.200

package/bin/types/sdk/AgentSessionEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionEvent.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionEvent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentSessionEvent.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionEvent.ts"],"names":[],"mappings":"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"}

package/bin/types/sdk/AgentSessionTurn.d.ts

@@ -6,7 +6,7 @@
  * - 同一个 turn 可以吸收多条 prompt，因此多个 prompt 可能返回相同 `id` 的 turn handle。
  * - 增量过程继续通过 `session.subscribe()` 观察；turn handle 只负责等待最终完成结果。
  */
-import type { SessionMessageV1 } from "../../executor/types/SessionMessages.js";
+import type { SessionModelMessageV1 } from "../../executor/types/SessionMessages.js";
 /**
  * 单个 Session turn 的最终结果。
  */
@@ -30,7 +30,7 @@ export interface AgentSessionTurnResult {
      * - `turn.finished` 返回的结果以这条消息作为最终事实源。
      * - transport / runtime service 若需要读取最终结构化输出，应优先消费这里。
      */
-    assistantMessage?: SessionMessageV1;
+    assistantMessage?: SessionModelMessageV1;
     /**
      * 当前 turn 失败时的错误文本。
      */

package/bin/types/sdk/AgentSessionTurn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionTurn.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionTurn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;OAMG;IACH,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C"}
+{"version":3,"file":"AgentSessionTurn.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionTurn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IAEzC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;OAMG;IACH,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC3C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.198",
+  "version": "1.1.200",
   "type": "module",
   "description": "Downcity Agent 运行时 — 单 Agent 执行壳与本机 RPC 能力",
   "main": "./bin/index.js",
@@ -17,8 +17,8 @@
   },
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.48",
-    "@downcity/shell": "^0.1.68",
-    "@downcity/type": "0.1.101",
+    "@downcity/shell": "^0.1.69",
+    "@downcity/type": "0.1.102",
     "ai": "^6.0.193",
     "commander": "^15.0.0",
     "dotenv": "^17.4.2",

package/scripts/{session-operation-message.test.mjs → session-action-message.test.mjs}

@@ -1,10 +1,10 @@
 /**
- * @file 验证 operation message 的持久化、模型输入过滤与 timeline 投影。
+ * @file 验证 action message 的持久化、模型输入过滤与 timeline 投影。
  *
  * 关键点（中文）
- * - operation message 会作为 UIMessage 写入 JSONL。
- * - history composer 组装 LLM 输入时必须过滤 operation message。
- * - timeline view 可以把 operation message 投影成前端可识别的 operation 事件。
+ * - action message 会作为 `type=action` item 写入 JSONL。
+ * - 同一个 action id 会被更新为一条历史记录，不拆成 running/completed 多条。
+ * - history composer 组装 LLM 输入时必须过滤 action message。
  */
 
 import test from "node:test";
@@ -18,14 +18,14 @@ import { JsonlSessionHistoryComposer } from "../bin/executor/composer/history/js
 import { toSessionTimelineEvents } from "../bin/session/browse/Browse.js";
 import { Agent } from "../bin/index.js";
 
-test("operation message is persisted but filtered from LLM history", async () => {
+test("action message is upserted but filtered from LLM history", async () => {
   const root_path = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-operation-message-"),
+    path.join(os.tmpdir(), "downcity-agent-action-message-"),
   );
-  const session_id = "operation_session";
+  const session_id = "action_session";
   const store = new JsonlSessionHistoryStore({
     rootPath: root_path,
-    agentId: "operation_agent",
+    agentId: "action_agent",
     sessionId: session_id,
   });
   const composer = new JsonlSessionHistoryComposer({ store });
@@ -38,16 +38,26 @@ test("operation message is persisted but filtered from LLM history", async () =>
     }),
   );
   await store.append(
-    store.operation({
-      operation: {
-        operationId: "op-1",
-        name: "compacting",
-        status: "started",
-        label: "Compacting session history",
+    store.action({
+      action: {
+        id: "action:1",
+        title: "Compacting session history",
+        state: "running",
+        turnId: "turn-1",
+      },
+      metadata: { sessionId: session_id },
+    }),
+  );
+  await store.append(
+    store.action({
+      action: {
+        id: "action:1",
+        title: "Session history compacted",
+        description: "Compacted earlier messages.",
+        state: "completed",
         turnId: "turn-1",
       },
       metadata: { sessionId: session_id },
-      id: "op:1",
     }),
   );
   await store.append(
@@ -60,8 +70,10 @@ test("operation message is persisted but filtered from LLM history", async () =>
 
   const persisted_messages = await store.list();
   assert.equal(persisted_messages.length, 3);
-  assert.equal(persisted_messages[1].metadata.kind, "operation");
-  assert.equal(persisted_messages[1].metadata.operation.operationId, "op-1");
+  assert.equal(persisted_messages[1].type, "action");
+  assert.equal(persisted_messages[1].title, "Session history compacted");
+  assert.equal(persisted_messages[1].description, "Compacted earlier messages.");
+  assert.equal(persisted_messages[1].state, "completed");
 
   const model_messages = await composer.prepare({
     query: "",
@@ -77,14 +89,17 @@ test("operation message is persisted but filtered from LLM history", async () =>
 
   const timeline_events = toSessionTimelineEvents(persisted_messages[1]);
   assert.equal(timeline_events.length, 1);
-  assert.equal(timeline_events[0].role, "operation");
-  assert.equal(timeline_events[0].operationId, "op-1");
-  assert.equal(timeline_events[0].operationName, "compacting");
-  assert.equal(timeline_events[0].operationStatus, "started");
-  assert.equal(timeline_events[0].text, "Compacting session history");
+  assert.equal(timeline_events[0].role, "action");
+  assert.equal(timeline_events[0].actionTitle, "Session history compacted");
+  assert.equal(timeline_events[0].actionDescription, "Compacted earlier messages.");
+  assert.equal(timeline_events[0].actionState, "completed");
+  assert.equal(
+    timeline_events[0].text,
+    "Session history compacted\nCompacted earlier messages.",
+  );
 });
 
-test("session.set persists and publishes model-switching operations", async () => {
+test("session.set persists and publishes model-switching actions", async () => {
   const agent_path = await fs.mkdtemp(
     path.join(os.tmpdir(), "downcity-agent-model-switching-"),
   );
@@ -98,7 +113,7 @@ test("session.set persists and publishes model-switching operations", async () =
     });
     const events = [];
     const unsubscribe = session.subscribe((event) => {
-      if (event.type === "operation") events.push(event);
+      if (event.type === "action") events.push(event);
     });
 
     await session.set({
@@ -110,24 +125,25 @@ test("session.set persists and publishes model-switching operations", async () =
     unsubscribe();
 
     assert.deepEqual(
-      events.map((event) => `${event.name}:${event.status}`),
-      ["model-switching:started", "model-switching:finished"],
+      events.map((event) => `${event.title}:${event.state}`),
+      ["Switching session model:running", "Session model switched:completed"],
     );
+    assert.equal(new Set(events.map((event) => event.id)).size, 1);
 
     const history = await session.history({ view: "timeline" });
-    const operation_events = history.items.filter(
-      (item) => item.role === "operation",
+    const action_events = history.items.filter(
+      (item) => item.role === "action",
     );
     assert.deepEqual(
-      operation_events.map((event) => `${event.operationName}:${event.operationStatus}`),
-      ["model-switching:started", "model-switching:finished"],
+      action_events.map((event) => `${event.actionTitle}:${event.actionState}`),
+      ["Session model switched:completed"],
     );
   } finally {
     await agent.dispose();
   }
 });
 
-test("session.fork persists and publishes history-forking operations on source session", async () => {
+test("session.fork persists and publishes history-forking actions on source session", async () => {
   const agent_path = await fs.mkdtemp(
     path.join(os.tmpdir(), "downcity-agent-history-forking-"),
   );
@@ -149,7 +165,7 @@ test("session.fork persists and publishes history-forking operations on source s
 
     const events = [];
     const unsubscribe = session.subscribe((event) => {
-      if (event.type === "operation" && event.name === "history-forking") {
+      if (event.type === "action") {
         events.push(event);
       }
     });
@@ -157,25 +173,26 @@ test("session.fork persists and publishes history-forking operations on source s
     unsubscribe();
 
     assert.deepEqual(
-      events.map((event) => `${event.name}:${event.status}`),
-      ["history-forking:started", "history-forking:finished"],
+      events.map((event) => `${event.title}:${event.state}`),
+      ["Forking session history:running", "Session history forked:completed"],
     );
+    assert.equal(new Set(events.map((event) => event.id)).size, 1);
     assert.notEqual(forked.id, session.id);
 
     const source_history = await session.history({ view: "timeline" });
-    const source_fork_operations = source_history.items.filter(
-      (item) => item.operationName === "history-forking",
+    const source_fork_actions = source_history.items.filter(
+      (item) => item.role === "action" && item.actionTitle === "Session history forked",
     );
     assert.deepEqual(
-      source_fork_operations.map((event) => event.operationStatus),
-      ["started", "finished"],
+      source_fork_actions.map((event) => event.actionState),
+      ["completed"],
     );
 
     const forked_history = await forked.history({ view: "timeline" });
-    const forked_model_operations = forked_history.items.filter(
-      (item) => item.operationName === "model-switching",
+    const forked_model_actions = forked_history.items.filter(
+      (item) => item.role === "action" && item.actionTitle === "Session model switched",
     );
-    assert.equal(forked_model_operations.length, 2);
+    assert.equal(forked_model_actions.length, 1);
   } finally {
     await agent.dispose();
   }

package/src/executor/Executor.ts

@@ -28,7 +28,7 @@ import type { JsonObject } from "@/types/common/Json.js";
 import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
 import type { SessionExecutor } from "@/executor/types/SessionExecutor.js";
 import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
-import type { AgentSessionOperationRecord } from "@/types/sdk/AgentSessionOperation.js";
+import type { AgentSessionActionRecord } from "@/types/sdk/AgentSessionAction.js";
 import type {
   SessionExecuteInput,
   SessionRunResult,
@@ -362,7 +362,7 @@ export class Executor implements SessionExecutor {
     const composed_context = await this.contextComposer.compose(run_context);
     const tools = this.bind_run_scope_to_tools(composed_context.tools, run_context);
     const system = await this.systemComposer.resolve(run_context);
-    let compaction_operation_id = "";
+    let compaction_action_id = "";
 
     try {
       if (retry_count > 0) {
@@ -371,13 +371,13 @@ export class Executor implements SessionExecutor {
         });
       }
 
-      const emit_compaction_operation = async (
-        operation: AgentSessionOperationRecord,
+      const emit_compaction_action = async (
+        action: AgentSessionActionRecord,
       ): Promise<void> => {
-        if (operation.status === "started") {
-          compaction_operation_id = operation.operationId;
+        if (action.state === "running") {
+          compaction_action_id = action.id;
         }
-        await this.emitOperation(run_context, operation);
+        await this.emitAction(run_context, action);
       };
 
       await this.compactionComposer.run({
@@ -385,17 +385,16 @@ export class Executor implements SessionExecutor {
         model,
         system,
         retryCount: retry_count,
-        onOperation: emit_compaction_operation,
+        onAction: emit_compaction_action,
       });
     } catch (error) {
-      await this.emitOperation(run_context, {
-        operationId:
-          compaction_operation_id ||
+      await this.emitAction(run_context, {
+        id:
+          compaction_action_id ||
           `compacting:${this.sessionId}:failed:${Date.now()}:${generateId()}`,
-        name: "compacting",
-        status: "failed",
-        label: "Session history compact failed",
-        error: error instanceof Error ? error.message : String(error),
+        title: "Session history compact failed",
+        description: error instanceof Error ? error.message : String(error),
+        state: "failed",
         visible: false,
       });
       // 压缩失败不阻断主流程，继续使用当前历史消息执行。
@@ -492,8 +491,8 @@ export class Executor implements SessionExecutor {
       ...(typeof input?.onUiMessageChunkCallback === "function"
         ? { onUiMessageChunkCallback: input.onUiMessageChunkCallback }
         : {}),
-      ...(typeof input?.onOperationCallback === "function"
-        ? { onOperationCallback: input.onOperationCallback }
+      ...(typeof input?.onActionCallback === "function"
+        ? { onActionCallback: input.onActionCallback }
         : {}),
       ...(input?.abortSignal ? { abortSignal: input.abortSignal } : {}),
       injectedUserMessages: Array.isArray(input?.injectedUserMessages)
@@ -511,22 +510,22 @@ export class Executor implements SessionExecutor {
   }
 
   /**
-   * 发布一次 session operation。
+   * 发布一次 session action。
    */
-  private async emitOperation(
+  private async emitAction(
     run_context: SessionRunContext,
-    operation: AgentSessionOperationRecord,
+    action: AgentSessionActionRecord,
   ): Promise<void> {
-    if (typeof run_context.onOperationCallback !== "function") return;
-    const operation_id =
-      String(operation.operationId || "").trim() ||
-      `operation:${this.sessionId}:${Date.now()}:${generateId()}`;
-    await run_context.onOperationCallback({
-      type: "operation",
+    if (typeof run_context.onActionCallback !== "function") return;
+    const action_id =
+      String(action.id || "").trim() ||
+      `action:${this.sessionId}:${Date.now()}:${generateId()}`;
+    await run_context.onActionCallback({
+      type: "action",
       sessionId: run_context.sessionId || this.sessionId,
-      ...operation,
-      operationId: operation_id,
-      ...(run_context.turnId && !operation.turnId
+      ...action,
+      id: action_id,
+      ...(run_context.turnId && !action.turnId
         ? { turnId: run_context.turnId }
         : {}),
     });

package/src/executor/composer/compaction/SessionCompactionComposer.ts

@@ -8,7 +8,7 @@
 
 import type { LanguageModel, SystemModelMessage } from "ai";
 import type { SessionHistoryStore } from "@/executor/store/history/SessionHistoryStore.js";
-import type { AgentSessionOperationRecord } from "@/types/sdk/AgentSessionOperation.js";
+import type { AgentSessionActionRecord } from "@/types/sdk/AgentSessionAction.js";
 
 /**
  * compaction Composer 执行输入。
@@ -35,13 +35,13 @@ export type SessionCompactionInput = {
   retryCount: number;
 
   /**
-   * 可选 operation 发布回调。
+   * 可选 action 发布回调。
    *
    * 说明（中文）
-   * - 默认 compaction Composer 可在真正开始压缩时发布 `compacting`。
-   * - 回调由上层 Session 负责转成订阅事件与 operation message。
+   * - 默认 compaction Composer 可在真正开始压缩时发布 action。
+   * - 回调由上层 Session 负责转成订阅事件与 action message。
    */
-  onOperation?: (operation: AgentSessionOperationRecord) => Promise<void>;
+  onAction?: (action: AgentSessionActionRecord) => Promise<void>;
 };
 
 /**

package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionComposer.ts

@@ -79,7 +79,7 @@ export class JsonlSessionCompactionComposer implements SessionCompactionComposer
       maxInputTokensApprox: policy.maxInputTokensApprox,
       archiveOnCompact: policy.archiveOnCompact,
       compactRatio: policy.compactRatio,
-      ...(input.onOperation ? { onOperation: input.onOperation } : {}),
+      ...(input.onAction ? { onAction: input.onAction } : {}),
     });
   }
 

package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.ts

@@ -20,10 +20,14 @@ import { getLogger } from "@/utils/logger/Logger.js";
 import type {
   SessionMessageV1,
   SessionMetadataV1,
+  SessionModelMessageV1,
+} from "@/executor/types/SessionMessages.js";
+import {
+  isSessionActionMessage,
+  isSessionModelMessage,
 } from "@/executor/types/SessionMessages.js";
-import { isSessionOperationMessage } from "@/executor/types/SessionMessages.js";
 import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
-import type { AgentSessionOperationRecord } from "@/types/sdk/AgentSessionOperation.js";
+import type { AgentSessionActionRecord } from "@/types/sdk/AgentSessionAction.js";
 
 export type SessionCompactParams = {
   model: LanguageModel;
@@ -32,7 +36,7 @@ export type SessionCompactParams = {
   maxInputTokensApprox: number;
   archiveOnCompact: boolean;
   compactRatio: number;
-  onOperation?: (operation: AgentSessionOperationRecord) => Promise<void>;
+  onAction?: (action: AgentSessionActionRecord) => Promise<void>;
 };
 
 type SessionCompactDeps = {
@@ -63,17 +67,16 @@ export async function compactSessionMessagesIfNeeded(
   params: SessionCompactParams,
 ): Promise<{ compacted: boolean; reason?: string }> {
   const logger = getLogger(deps.rootPath, "info");
-  const operation_id = `compacting:${deps.sessionId}:${Date.now()}:${generateId()}`;
-  let operation_started = false;
+  const action_id = `compacting:${deps.sessionId}:${Date.now()}:${generateId()}`;
+  let action_started = false;
 
-  const publish_operation = async (
-    operation: Omit<AgentSessionOperationRecord, "operationId" | "name">,
+  const publish_action = async (
+    action: Omit<AgentSessionActionRecord, "id">,
   ): Promise<void> => {
-    if (typeof params.onOperation !== "function") return;
-    await params.onOperation({
-      operationId: operation_id,
-      name: "compacting",
-      ...operation,
+    if (typeof params.onAction !== "function") return;
+    await params.onAction({
+      id: action_id,
+      ...action,
     });
   };
 
@@ -81,12 +84,10 @@ export async function compactSessionMessagesIfNeeded(
   // phase 1：snapshot（短锁）
   // - 仅负责拿一致性快照，不做耗时的模型调用。
   // - 目的是把锁持有时间降到最低。
-  let snapshot: SessionMessageV1[] = [];
+  let snapshot: SessionModelMessageV1[] = [];
   let snapshotTailId = "";
   await deps.withWriteLock(async () => {
-    snapshot = (await deps.loadAll()).filter(
-      (message) => !isSessionOperationMessage(message),
-    );
+    snapshot = (await deps.loadAll()).filter(isSessionModelMessage);
     snapshotTailId =
       snapshot.length > 0
         ? String(snapshot[snapshot.length - 1].id || "")
@@ -118,11 +119,10 @@ export async function compactSessionMessagesIfNeeded(
   const older = snapshot.slice(0, compactCount);
   if (older.length === 0) return { compacted: false, reason: "nothing_to_compact" };
 
-  operation_started = true;
-  await publish_operation({
-    status: "started",
-    label: "Compacting session history",
-    progress: 0,
+  action_started = true;
+  await publish_action({
+    title: "Compacting session history",
+    state: "running",
   });
 
   const olderTextAll = extractPlainTextFromMessages(older);
@@ -163,11 +163,10 @@ export async function compactSessionMessagesIfNeeded(
       },
     );
     summary = "（系统自动压缩：摘要生成失败，已丢弃更早历史，仅保留最近对话。）";
-    await publish_operation({
-      status: "progress",
-      label: "Compacting session history",
-      reason: "summary_fallback",
-      progress: 0.5,
+    await publish_action({
+      title: "Compacting session history",
+      description: "Summary generation failed; using a fallback summary.",
+      state: "running",
     });
   }
 
@@ -191,7 +190,7 @@ export async function compactSessionMessagesIfNeeded(
     void snapshotTailId;
 
     const current_model_messages = current.filter(
-      (message) => !isSessionOperationMessage(message),
+      isSessionModelMessage,
     );
     const currentCompactCount = resolveCompactCount(
       current_model_messages.length,
@@ -242,15 +241,11 @@ export async function compactSessionMessagesIfNeeded(
     });
   });
 
-  if (operation_started) {
-    await publish_operation({
-      status: "finished",
-      label: "Session history compacted",
-      progress: 1,
-      result: {
-        archiveId,
-        compactedCount: older.length,
-      },
+  if (action_started) {
+    await publish_action({
+      title: "Session history compacted",
+      description: `Compacted ${String(older.length)} earlier messages into ${archiveId}.`,
+      state: "completed",
     });
   }
 
@@ -302,7 +297,7 @@ function estimateTokensApproxFromText(text: string): number {
  * - 统一把 user / assistant 内容线性化，作为 compact 摘要输入。
  * - tool 原始结构不会原样输出，避免把噪声日志喂给摘要模型。
  */
-function extractPlainTextFromMessages(messages: SessionMessageV1[]): string {
+function extractPlainTextFromMessages(messages: SessionModelMessageV1[]): string {
   const lines: string[] = [];
   for (const m of messages) {
     if (!m || typeof m !== "object") continue;

package/src/executor/composer/context/LocalSessionContextComposer.ts

@@ -12,7 +12,10 @@ import type {
   SessionContextComposer,
   SessionContextComposeResult,
 } from "@executor/composer/context/SessionContextComposer.js";
-import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type {
+  SessionMessageV1,
+  SessionModelMessageV1,
+} from "@/executor/types/SessionMessages.js";
 import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 import type { Tool } from "ai";
 import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
@@ -147,7 +150,7 @@ export class LocalSessionContextComposer implements SessionContextComposer {
   buildFallbackAssistantMessage(
     text: string,
     run_context: SessionRunContext,
-  ): SessionMessageV1 {
+  ): SessionModelMessageV1 {
     const sessionId = String(
       run_context.sessionId || this.sessionId || "",
     ).trim();

package/src/executor/composer/context/SessionContextComposer.ts

@@ -7,7 +7,10 @@
  */
 
 import type { ModelMessage, Tool } from "ai";
-import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type {
+  SessionMessageV1,
+  SessionModelMessageV1,
+} from "@/executor/types/SessionMessages.js";
 import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
 
@@ -76,5 +79,5 @@ export interface SessionContextComposer {
   buildFallbackAssistantMessage(
     text: string,
     run_context: SessionRunContext,
-  ): SessionMessageV1;
+  ): SessionModelMessageV1;
 }

package/src/executor/composer/history/jsonl/JsonlSessionHistoryComposer.ts

@@ -9,8 +9,10 @@
 
 import type { Tool } from "ai";
 import {
-  isSessionOperationMessage,
+  isSessionActionMessage,
+  isSessionModelMessage,
   type SessionMessageV1,
+  type SessionModelMessageV1,
 } from "@/executor/types/SessionMessages.js";
 import type { SessionHistoryStore } from "@/executor/store/history/SessionHistoryStore.js";
 import type {
@@ -49,7 +51,7 @@ export class JsonlSessionHistoryComposer implements SessionHistoryComposer {
     return tools && typeof tools === "object" ? { ...tools } : {};
   }
 
-  private readUserSessionMessageText(message: SessionMessageV1): string {
+  private readUserSessionMessageText(message: SessionModelMessageV1): string {
     if (!message || typeof message !== "object" || message.role !== "user") {
       return "";
     }
@@ -76,7 +78,7 @@ export class JsonlSessionHistoryComposer implements SessionHistoryComposer {
     for (let index = messages.length - 1; index >= 0; index -= 1) {
       const item = messages[index];
       if (!item || typeof item !== "object") continue;
-      if (item.role !== "user") continue;
+      if (!isSessionModelMessage(item) || item.role !== "user") continue;
       return this.readUserSessionMessageText(item) === target;
     }
     return false;
@@ -85,6 +87,8 @@ export class JsonlSessionHistoryComposer implements SessionHistoryComposer {
   private sanitizeMessages(messages: SessionMessageV1[]): SessionMessageV1[] {
     if (!Array.isArray(messages)) return [];
     return messages
+      .filter((message) => !isSessionActionMessage(message))
+      .filter(isSessionModelMessage)
       .map((message) => {
         const parts = Array.isArray(message.parts)
           ? message.parts.filter((part) => part && typeof part === "object")
@@ -94,7 +98,6 @@ export class JsonlSessionHistoryComposer implements SessionHistoryComposer {
           parts,
         };
       })
-      .filter((message) => !isSessionOperationMessage(message))
       .filter((message) => Array.isArray(message.parts) && message.parts.length > 0);
   }
 

package/src/executor/core-engine/CoreEngineRunner.ts

@@ -41,7 +41,10 @@ import type {
   SessionExecuteInput,
   SessionRunResult,
 } from "@/executor/types/SessionRun.js";
-import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type {
+  SessionMessageV1,
+  SessionModelMessageV1,
+} from "@/executor/types/SessionMessages.js";
 
 const TURN_STOPPED_MESSAGE = "Turn stopped";
 
@@ -61,9 +64,9 @@ function build_file_part_key(part: FileUIPart): string {
  * 把 tool/plugin 运行期产生的 file parts 并入最终 assistant UIMessage。
  */
 function mergePendingAssistantFileParts(
-  message: SessionMessageV1,
+  message: SessionModelMessageV1,
   parts: FileUIPart[],
-): SessionMessageV1 {
+): SessionModelMessageV1 {
   if (!Array.isArray(parts) || parts.length === 0) return message;
   const current_parts = Array.isArray(message.parts) ? message.parts : [];
   const seen = new Set<string>();
@@ -151,7 +154,7 @@ export class CoreEngineRunner {
       : [];
     const tools = input.execute_input.tools;
     let last_observed_stream_error: unknown = undefined;
-    let final_assistant_ui_message: SessionMessageV1 | null = null;
+    let final_assistant_ui_message: SessionModelMessageV1 | null = null;
 
     try {
       const message_state = await CoreEngineMessageState.create({