@downcity/agent 1.1.200 → 1.1.202

package/bin/types/rpc/RpcProtocol.d.ts

@@ -6,7 +6,7 @@
  * - Client 与 Server 共享同一份 request/frame 类型，避免协议两边漂移。
  * - 字段名保持现有协议格式，兼容已发布的 downcity 托管 runtime 调用。
  */
-import type { AgentCreateSessionInput, AgentListSessionsInput, AgentArchiveSessionsInput, AgentSessionHistoryInput, AgentSessionSystemSnapshot } from "../../types/agent/AgentTypes.js";
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentArchiveSessionsInput, AgentSessionRecordsInput, AgentSessionSystemSnapshot } from "../../types/agent/AgentTypes.js";
 import type { AgentSessionEvent } from "../../types/sdk/AgentSessionEvent.js";
 import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
 import type { JsonValue } from "../../types/common/Json.js";
@@ -90,14 +90,14 @@ export type RpcRequest = {
 } | {
     /** 请求 id，用于匹配响应。 */
     id: string;
-    /** 读取 session history。 */
-    method: "sdk.sessions.history";
-    /** history 查询参数。 */
+    /** 读取 session records。 */
+    method: "sdk.sessions.records";
+    /** records 查询参数。 */
     params: {
         /** 目标 session id。 */
         sessionId: string;
-        /** history 分页与视图参数。 */
-        input?: AgentSessionHistoryInput;
+        /** records 分页与视图参数。 */
+        input?: AgentSessionRecordsInput;
     };
 } | {
     /** 请求 id，用于匹配响应。 */

package/bin/types/runtime/agent/AgentContext.d.ts

@@ -13,7 +13,7 @@ import type { DowncityConfig } from "../../../types/config/DowncityConfig.js";
 import type { JsonValue } from "../../../types/common/Json.js";
 import type { AgentPlugins } from "../../../plugin/types/Plugin.js";
 import type { Plugin } from "../../../types/plugin/PluginDefinition.js";
-import type { SessionMetadataV1, SessionMessageV1 } from "../../../executor/types/SessionMessages.js";
+import type { SessionMetadataV1, SessionRecordV1 } from "../../../executor/types/SessionRecords.js";
 import type { SessionRunInput, SessionRunResult } from "../../../executor/types/SessionRun.js";
 import type { SessionHistoryStore } from "../../../executor/store/history/SessionHistoryStore.js";
 import type { AgentSessionPromptInput } from "../../../types/sdk/AgentSessionPrompt.js";
@@ -113,7 +113,7 @@ export interface SessionPort {
      *
      * 关键点（中文）
      * - 只广播订阅之后产生的事件。
-     * - 历史消息仍通过 `getHistoryStore()` / SDK `history()` 读取。
+     * - session records 仍通过 `getHistoryStore()` / SDK `records()` 读取。
      */
     subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
     /**
@@ -121,7 +121,7 @@ export interface SessionPort {
      *
      * 关键点（中文）
      * - plugin runtime 用它把审批、外部进度等非模型 chunk 事件推送给订阅方。
-     * - 历史消息持久化仍由 appendUserMessage / appendAssistantMessage 负责。
+     * - 历史消息持久化仍由 append_user_message / append_assistant_message 负责。
      */
     publishEvent(event: AgentSessionEvent): void;
     /**
@@ -135,11 +135,11 @@ export interface SessionPort {
     /**
      * 追加一条 user 消息。
      */
-    appendUserMessage(params: {
+    append_user_message(params: {
         /**
          * 已构造好的完整消息。
          */
-        message?: SessionMessageV1 | null;
+        message?: SessionRecordV1 | null;
         /**
          * 兜底文本内容。
          */
@@ -152,11 +152,11 @@ export interface SessionPort {
     /**
      * 追加一条 assistant 消息。
      */
-    appendAssistantMessage(params: {
+    append_assistant_message(params: {
         /**
          * 已构造好的完整消息。
          */
-        message?: SessionMessageV1 | null;
+        message?: SessionRecordV1 | null;
         /**
          * 兜底文本内容。
          */

package/bin/types/runtime/agent/AgentContext.d.ts.map

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

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

@@ -1,65 +1,24 @@
 /**
- * Agent Session action 类型定义。
+ * Agent Session action 公开类型。
  *
  * 关键点（中文）
- * - action 描述 session 内部正在发生的辅助动作，不代表 assistant 正文。
- * - action 同时用于 `session.subscribe()` 实时事件与 JSONL history item。
- * - action 只服务前端状态展示与历史回放，不进入 LLM 输入。
+ * - action 是 session records 中的 `type: "action"` 记录。
+ * - 同一份结构同时用于 JSONL 持久化与 `session.subscribe()` 实时事件。
+ * - action 不进入 LLM 输入；组装模型消息前必须过滤。
  */
+import type { SessionActionRecordV1, SessionActionStateV1 } from "../../executor/types/SessionRecords.js";
 /**
  * Session action 当前状态。
  */
-export type AgentSessionActionState = "running" | "completed" | "failed";
+export type AgentSessionActionState = SessionActionStateV1;
 /**
  * Session action 记录。
  */
-export interface AgentSessionActionRecord {
-    /**
-     * 同一个 action 生命周期内稳定复用的 ID。
-     *
-     * 说明（中文）
-     * - 这是 history item envelope 字段，用于把同一个动作更新为一条记录。
-     * - 前端展示语义只依赖 `type/title/description/state`。
-     */
-    id: string;
-    /**
-     * 当前 action 标题。
-     */
-    title: string;
-    /**
-     * 当前 action 描述。
-     */
-    description?: string;
-    /**
-     * 当前 action 状态。
-     */
-    state: AgentSessionActionState;
-    /**
-     * 当前 action 关联的 turn 标识。
-     */
-    turnId?: string;
-    /**
-     * 是否建议前端展示。
-     *
-     * 说明（中文）
-     * - 默认视为 `true`。
-     * - 调试或审计类辅助事件可显式写入 `false`。
-     */
-    visible?: boolean;
-}
+export type AgentSessionActionRecord = SessionActionRecordV1;
 /**
  * Session action 订阅事件。
  */
-export interface AgentSessionActionEvent extends Omit<AgentSessionActionRecord, "visible"> {
-    /**
-     * 当前事件类型。
-     */
-    type: "action";
-    /**
-     * 当前 session 唯一标识。
-     */
-    sessionId: string;
-}
+export type AgentSessionActionEvent = SessionActionRecordV1;
 /**
  * Session action 发布回调。
  */

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

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionAction.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionAction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,uBAAuB,CAAC;IAE/B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBACf,SAAQ,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC;IACjD;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"AgentSessionAction.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionAction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/types/sdk/AgentSessionAction.js

@@ -1,10 +1,10 @@
 /**
- * Agent Session action 类型定义。
+ * Agent Session action 公开类型。
  *
  * 关键点（中文）
- * - action 描述 session 内部正在发生的辅助动作，不代表 assistant 正文。
- * - action 同时用于 `session.subscribe()` 实时事件与 JSONL history item。
- * - action 只服务前端状态展示与历史回放，不进入 LLM 输入。
+ * - action 是 session records 中的 `type: "action"` 记录。
+ * - 同一份结构同时用于 JSONL 持久化与 `session.subscribe()` 实时事件。
+ * - action 不进入 LLM 输入；组装模型消息前必须过滤。
  */
 export {};
 //# sourceMappingURL=AgentSessionAction.js.map

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

@@ -6,7 +6,7 @@
  * - 同一个 turn 可以吸收多条 prompt，因此多个 prompt 可能返回相同 `id` 的 turn handle。
  * - 增量过程继续通过 `session.subscribe()` 观察；turn handle 只负责等待最终完成结果。
  */
-import type { SessionModelMessageV1 } from "../../executor/types/SessionMessages.js";
+import type { SessionMessageRecordV1 } from "../../executor/types/SessionRecords.js";
 /**
  * 单个 Session turn 的最终结果。
  */
@@ -30,7 +30,7 @@ export interface AgentSessionTurnResult {
      * - `turn.finished` 返回的结果以这条消息作为最终事实源。
      * - transport / runtime service 若需要读取最终结构化输出，应优先消费这里。
      */
-    assistantMessage?: SessionModelMessageV1;
+    assistantMessage?: SessionMessageRecordV1;
     /**
      * 当前 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,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"}
+{"version":3,"file":"AgentSessionTurn.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionTurn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,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,sBAAsB,CAAC;IAE1C;;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.200",
+  "version": "1.1.202",
   "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.69",
-    "@downcity/type": "0.1.102",
+    "@downcity/shell": "^0.1.71",
+    "@downcity/type": "0.1.104",
     "ai": "^6.0.193",
     "commander": "^15.0.0",
     "dotenv": "^17.4.2",

package/scripts/agent-ready.test.mjs

@@ -144,7 +144,7 @@ test("session.prompt waits for agent background ready before model execution", a
   });
 
   try {
-    const session = await agent.session_collection().create_session({
+    const session = await agent.sessions.create({
       sessionId: "ready_session",
     });
     const prompt_promise = session.prompt({

package/scripts/city-model-tool-loop.test.mjs

@@ -14,6 +14,7 @@ import os from "node:os";
 import path from "node:path";
 import fs from "node:fs/promises";
 import { Agent } from "../bin/index.js";
+import { createAction, createPlugin } from "../bin/plugin/core/PluginActionFactory.js";
 import { City } from "../../city/bin/index.js";
 import { tool } from "ai";
 import { z } from "zod";
@@ -224,12 +225,13 @@ test("CityModel uses direct LanguageModel path and sends tool result back", asyn
 
   await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
 
+  let agent;
   try {
     const address = server.address();
     assert.ok(address && typeof address === "object");
     const city = new City({
       role: "user",
-      city_url: `http://127.0.0.1:${String(address.port)}`,
+      federation_url: `http://127.0.0.1:${String(address.port)}`,
       city_id: "city_demo",
       user_token: "ub_test",
     });
@@ -240,9 +242,25 @@ test("CityModel uses direct LanguageModel path and sends tool result back", asyn
     const agent_path = await fs.mkdtemp(
       path.join(os.tmpdir(), "downcity-agent-city-model-tool-loop-"),
     );
-    const agent = new Agent({
+    const skill_plugin = createPlugin({
+      name: "skill",
+      title: "Skill",
+      description: "Test skill plugin",
+      actions: {
+        lookup: createAction({
+          description: "Lookup a skill",
+          execute: async ({ input }) => ({
+            success: true,
+            data: { name: input.name },
+            message: "loaded",
+          }),
+        }),
+      },
+    });
+    agent = new Agent({
       id: "tool_loop_agent",
       path: agent_path,
+      plugins: [skill_plugin],
       tools: {
         ping: tool({
           description: "ping tool",
@@ -257,7 +275,7 @@ test("CityModel uses direct LanguageModel path and sends tool result back", asyn
       },
     });
 
-    const session = await agent.createSession();
+    const session = await agent.sessions.create();
     await session.set({ model });
     const turn = await session.prompt({ query: "please use the ping tool" });
     const result = await turn.finished;
@@ -266,8 +284,19 @@ test("CityModel uses direct LanguageModel path and sends tool result back", asyn
     assert.equal(tool_executed, true);
     assert.equal(stream_requests, 0);
     assert.equal(agent_requests.length, 2);
-    assert.equal(requests.every((request) => request?.city_id === "city_demo"), true);
     assert.equal(agent_requests[0]?.model, "mock-model");
+    const plugin_call_tool = agent_requests[0]?.tools?.find(
+      (item) => item?.type === "function" && item?.function?.name === "plugin_call",
+    );
+    assert.ok(plugin_call_tool);
+    const plugin_call_parameters = plugin_call_tool.function.parameters;
+    assert.equal(plugin_call_parameters.type, "object");
+    assert.deepEqual(plugin_call_parameters.required, ["plugin", "action"]);
+    assert.equal(plugin_call_parameters.additionalProperties, false);
+    assert.equal(
+      plugin_call_parameters.properties.payload.additionalProperties,
+      true,
+    );
 
     const second_request_messages = Array.isArray(agent_requests[1]?.messages)
       ? agent_requests[1].messages
@@ -278,6 +307,9 @@ test("CityModel uses direct LanguageModel path and sends tool result back", asyn
     assert.match(serialized_second_messages, /echoed/);
     assert.match(serialized_second_messages, /hello/);
   } finally {
+    if (agent) {
+      await agent.dispose();
+    }
     await new Promise((resolve, reject) => {
       server.close((error) => {
         if (error) {

package/scripts/plugin-tool-bridge.test.mjs

@@ -17,6 +17,7 @@ import {
   invokePluginReadTool,
 } from "../bin/executor/tools/plugin/PluginToolBridge.js";
 import { createPluginTools } from "../bin/executor/tools/plugin/PluginToolDefinition.js";
+import { plugin_call_input_schema } from "../bin/executor/tools/plugin/PluginToolSchemas.js";
 import { withSessionRunScope } from "../bin/executor/SessionRunScope.js";
 import { createAction, createPlugin } from "../bin/plugin/core/PluginActionFactory.js";
 import { createAgentPluginRegistry } from "../bin/agent/local/AgentPluginFactory.js";
@@ -32,6 +33,18 @@ function create_run_context(project_root) {
   };
 }
 
+test("plugin_call payload schema allows arbitrary object properties", async () => {
+  const plugin_call_schema = await plugin_call_input_schema.jsonSchema;
+  const payload_schema = plugin_call_schema.properties.payload;
+
+  assert.equal(plugin_call_schema.type, "object");
+  assert.deepEqual(plugin_call_schema.required, ["plugin", "action"]);
+  assert.equal(plugin_call_schema.additionalProperties, false);
+  assert.equal(payload_schema.type, "object");
+  assert.equal(payload_schema.additionalProperties, true);
+  assert.deepEqual(payload_schema.default, {});
+});
+
 test("invokePluginCallTool returns absolute paths for materialized file parts", async () => {
   const project_root = await fs.mkdtemp(
     path.join(os.tmpdir(), "downcity-agent-plugin-tool-files-"),

package/scripts/session-action-message.test.mjs

@@ -1,10 +1,10 @@
 /**
- * @file 验证 action message 的持久化、模型输入过滤与 timeline 投影。
+ * @file 验证 action record 的持久化、模型输入过滤与 timeline 投影。
  *
  * 关键点（中文）
- * - action message 会作为 `type=action` item 写入 JSONL。
+ * - action record 会作为 `type=action` item 写入 JSONL。
  * - 同一个 action id 会被更新为一条历史记录，不拆成 running/completed 多条。
- * - history composer 组装 LLM 输入时必须过滤 action message。
+ * - history composer 组装 LLM 输入时必须过滤 action record。
  */
 
 import test from "node:test";
@@ -18,7 +18,7 @@ import { JsonlSessionHistoryComposer } from "../bin/executor/composer/history/js
 import { toSessionTimelineEvents } from "../bin/session/browse/Browse.js";
 import { Agent } from "../bin/index.js";
 
-test("action message is upserted but filtered from LLM history", async () => {
+test("action record is upserted but filtered from LLM history", async () => {
   const root_path = await fs.mkdtemp(
     path.join(os.tmpdir(), "downcity-agent-action-message-"),
   );
@@ -30,29 +30,29 @@ test("action message is upserted but filtered from LLM history", async () => {
   });
   const composer = new JsonlSessionHistoryComposer({ store });
 
-  await store.append(
+  await store.write_record(
     store.userText({
       text: "hello",
       metadata: { sessionId: session_id },
       id: "u:1",
     }),
   );
-  await store.append(
+  await store.write_record(
     store.action({
       action: {
         id: "action:1",
-        title: "Compacting session history",
+        title: "Compacting session records",
         state: "running",
         turnId: "turn-1",
       },
       metadata: { sessionId: session_id },
     }),
   );
-  await store.append(
+  await store.write_record(
     store.action({
       action: {
         id: "action:1",
-        title: "Session history compacted",
+        title: "Session records compacted",
         description: "Compacted earlier messages.",
         state: "completed",
         turnId: "turn-1",
@@ -60,7 +60,7 @@ test("action message is upserted but filtered from LLM history", async () => {
       metadata: { sessionId: session_id },
     }),
   );
-  await store.append(
+  await store.write_record(
     store.assistantText({
       text: "world",
       metadata: { sessionId: session_id },
@@ -68,10 +68,10 @@ test("action message is upserted but filtered from LLM history", async () => {
     }),
   );
 
-  const persisted_messages = await store.list();
+  const persisted_messages = await store.list_records();
   assert.equal(persisted_messages.length, 3);
   assert.equal(persisted_messages[1].type, "action");
-  assert.equal(persisted_messages[1].title, "Session history compacted");
+  assert.equal(persisted_messages[1].title, "Session records compacted");
   assert.equal(persisted_messages[1].description, "Compacted earlier messages.");
   assert.equal(persisted_messages[1].state, "completed");
 
@@ -90,12 +90,12 @@ test("action message is upserted 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, "action");
-  assert.equal(timeline_events[0].actionTitle, "Session history compacted");
+  assert.equal(timeline_events[0].actionTitle, "Session records 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.",
+    "Session records compacted\nCompacted earlier messages.",
   );
 });
 
@@ -108,7 +108,7 @@ test("session.set persists and publishes model-switching actions", async () => {
     path: agent_path,
   });
   try {
-    const session = await agent.session_collection().create_session({
+    const session = await agent.sessions.create({
       sessionId: "model_switching_session",
     });
     const events = [];
@@ -130,8 +130,8 @@ test("session.set persists and publishes model-switching actions", async () => {
     );
     assert.equal(new Set(events.map((event) => event.id)).size, 1);
 
-    const history = await session.history({ view: "timeline" });
-    const action_events = history.items.filter(
+    const records = await session.records({ view: "timeline" });
+    const action_events = records.items.filter(
       (item) => item.role === "action",
     );
     assert.deepEqual(
@@ -152,7 +152,7 @@ test("session.fork persists and publishes history-forking actions on source sess
     path: agent_path,
   });
   try {
-    const session = await agent.session_collection().create_session({
+    const session = await agent.sessions.create({
       sessionId: "history_forking_session",
     });
     await session.set({
@@ -161,7 +161,7 @@ test("session.fork persists and publishes history-forking actions on source sess
         provider: "test",
       },
     });
-    await session.appendUserMessage({ text: "source message" });
+    await session.append_user_message({ text: "source message" });
 
     const events = [];
     const unsubscribe = session.subscribe((event) => {
@@ -174,22 +174,22 @@ test("session.fork persists and publishes history-forking actions on source sess
 
     assert.deepEqual(
       events.map((event) => `${event.title}:${event.state}`),
-      ["Forking session history:running", "Session history forked:completed"],
+      ["Forking session records:running", "Session records 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_actions = source_history.items.filter(
-      (item) => item.role === "action" && item.actionTitle === "Session history forked",
+    const source_records = await session.records({ view: "timeline" });
+    const source_fork_actions = source_records.items.filter(
+      (item) => item.role === "action" && item.actionTitle === "Session records forked",
     );
     assert.deepEqual(
       source_fork_actions.map((event) => event.actionState),
       ["completed"],
     );
 
-    const forked_history = await forked.history({ view: "timeline" });
-    const forked_model_actions = forked_history.items.filter(
+    const forked_records = await forked.records({ view: "timeline" });
+    const forked_model_actions = forked_records.items.filter(
       (item) => item.role === "action" && item.actionTitle === "Session model switched",
     );
     assert.equal(forked_model_actions.length, 1);

package/scripts/session-compaction-prompts.test.mjs

@@ -0,0 +1,97 @@
+/**
+ * @file 验证 session compact prompt 与文件操作 XML 记录。
+ *
+ * 关键点（中文）
+ * - compact prompt 必须保持结构化摘要格式稳定。
+ * - 迭代更新 prompt 需要携带 previous-summary 标签。
+ * - 文件操作 XML 由本地解析追加，不依赖模型复述工具日志。
+ */
+
+import test from "node:test";
+import assert from "node:assert/strict";
+
+import {
+  SESSION_COMPACTION_SYSTEM_PROMPT,
+  append_session_compaction_file_operations,
+  build_initial_session_compaction_prompt,
+  build_turn_prefix_session_compaction_prompt,
+  build_update_session_compaction_prompt,
+} from "../bin/executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.js";
+import {
+  collect_session_compaction_file_operations,
+  format_session_compaction_file_operations,
+} from "../bin/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.js";
+
+test("session compaction prompts preserve structured formats", () => {
+  assert.match(
+    SESSION_COMPACTION_SYSTEM_PROMPT,
+    /Do NOT continue the conversation/,
+  );
+
+  const initial_prompt = build_initial_session_compaction_prompt({
+    conversation_text: "user: 请修改 packages/agent/src/foo.ts",
+  });
+  assert.match(initial_prompt, /## Goal/);
+  assert.match(initial_prompt, /## Constraints & Preferences/);
+  assert.match(initial_prompt, /## Critical Context/);
+  assert.match(
+    initial_prompt,
+    /Keep each section concise\. Preserve exact file paths/,
+  );
+
+  const update_prompt = build_update_session_compaction_prompt({
+    previous_summary: "## Goal\n旧目标",
+    new_conversation_text: "assistant: 已完成一部分",
+  });
+  assert.match(update_prompt, /<previous-summary>\n## Goal\n旧目标\n<\/previous-summary>/);
+  assert.match(update_prompt, /PRESERVE all existing information/);
+  assert.match(update_prompt, /## Next Steps/);
+
+  const prefix_prompt = build_turn_prefix_session_compaction_prompt({
+    prefix_text: "user: 这个 turn 太长",
+  });
+  assert.match(prefix_prompt, /## Original Request/);
+  assert.match(prefix_prompt, /## Context for Suffix/);
+});
+
+test("session compaction file operations are appended as xml", () => {
+  const messages = [
+    {
+      id: "a:1",
+      role: "assistant",
+      parts: [
+        {
+          type: "tool-exec_command",
+          input: {
+            cmd: "sed -n '1,40p' packages/agent/src/foo.ts && rg -n compact packages/agent/src",
+          },
+          output: [
+            "*** Update File: packages/agent/src/bar.ts",
+            " M packages/agent/src/baz.ts",
+          ].join("\n"),
+        },
+      ],
+    },
+  ];
+
+  const operations = collect_session_compaction_file_operations(messages);
+  assert.deepEqual(operations.read_files, [
+    "packages/agent/src",
+    "packages/agent/src/foo.ts",
+  ]);
+  assert.deepEqual(operations.modified_files, [
+    "packages/agent/src/bar.ts",
+    "packages/agent/src/baz.ts",
+  ]);
+
+  const xml = format_session_compaction_file_operations(messages);
+  assert.match(xml, /<read-files>\npackages\/agent\/src/);
+  assert.match(xml, /<modified-files>\npackages\/agent\/src\/bar\.ts/);
+
+  const summary = append_session_compaction_file_operations({
+    summary: "## Goal\n完成 compact",
+    file_operations_xml: xml,
+  });
+  assert.match(summary, /## Goal\n完成 compact\n\n<read-files>/);
+  assert.match(summary, /<\/modified-files>$/);
+});