@downcity/agent 1.1.73 → 1.1.79

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

@@ -0,0 +1,323 @@
+/**
+ * Agent RPC 协议类型。
+ *
+ * 关键点（中文）
+ * - 该文件只描述本机 RPC 的线协议，不包含 socket 或业务执行逻辑。
+ * - Client 与 Server 共享同一份 request/frame 类型，避免协议两边漂移。
+ * - 字段名保持现有协议格式，兼容已发布的 Town 托管 runtime 调用。
+ */
+import type { AgentCreateSessionInput, AgentListSessionsInput, AgentSessionHistoryInput, 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";
+import type { PluginStateControlAction } from "../../plugin/types/Plugin.js";
+/**
+ * RPC 请求。
+ *
+ * 关键点（中文）
+ * - `sdk.*` 面向 RemoteAgent 的稳定会话 SDK。
+ * - `internal.*` 面向 Town 本机管理通道。
+ */
+export type RpcRequest = {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 列出 session。 */
+    method: "sdk.sessions.list";
+    /** 列表过滤与分页参数。 */
+    params?: AgentListSessionsInput;
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 创建 session。 */
+    method: "sdk.sessions.create";
+    /** 创建参数。 */
+    params?: AgentCreateSessionInput;
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 读取 session 信息。 */
+    method: "sdk.sessions.get";
+    /** 目标 session 参数。 */
+    params: {
+        /** 目标 session id。 */
+        sessionId: string;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 向 session 发送 prompt。 */
+    method: "sdk.sessions.prompt";
+    /** prompt 参数。 */
+    params: {
+        /** 目标 session id。 */
+        sessionId: string;
+        /** SDK prompt 输入。 */
+        input: AgentSessionPromptInput;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 读取 session history。 */
+    method: "sdk.sessions.history";
+    /** history 查询参数。 */
+    params: {
+        /** 目标 session id。 */
+        sessionId: string;
+        /** history 分页与视图参数。 */
+        input?: AgentSessionHistoryInput;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 读取 session system snapshot。 */
+    method: "sdk.sessions.system";
+    /** 目标 session 参数。 */
+    params: {
+        /** 目标 session id。 */
+        sessionId: string;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 分叉 session。 */
+    method: "sdk.sessions.fork";
+    /** 分叉参数。 */
+    params: {
+        /** 源 session id。 */
+        sessionId: string;
+        /** 可选源消息 id。 */
+        messageId?: string;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 订阅 session 事件。 */
+    method: "sdk.sessions.subscribe";
+    /** 订阅参数。 */
+    params: {
+        /** 目标 session id。 */
+        sessionId: string;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 取消 session 事件订阅。 */
+    method: "sdk.sessions.unsubscribe";
+    /** 取消订阅参数。 */
+    params: {
+        /** 当前订阅 id。 */
+        subscriptionId: string;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 读取 Agent 内部状态。 */
+    method: "internal.status.get";
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 清空 session messages。 */
+    method: "internal.sessions.clear_messages";
+    /** 目标 session 参数。 */
+    params: {
+        /** 目标 session id。 */
+        sessionId: string;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 清空 chat history。 */
+    method: "internal.sessions.clear_chat_history";
+    /** 目标 session 参数。 */
+    params: {
+        /** 目标 session id。 */
+        sessionId: string;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 解析 session system prompt。 */
+    method: "internal.sessions.resolve_system_prompt";
+    /** 目标 session 参数。 */
+    params: {
+        /** 目标 session id。 */
+        sessionId: string;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 列出 plugin catalog。 */
+    method: "internal.plugins.catalog";
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 列出 plugin 状态。 */
+    method: "internal.plugins.list";
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 控制 plugin 生命周期。 */
+    method: "internal.plugins.control";
+    /** plugin 控制参数。 */
+    params: {
+        /** plugin 名称。 */
+        pluginName: string;
+        /** 控制动作。 */
+        action: PluginStateControlAction;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 执行 plugin command。 */
+    method: "internal.plugins.command";
+    /** plugin command 参数。 */
+    params: {
+        /** plugin 名称。 */
+        pluginName: string;
+        /** command 名称。 */
+        command: string;
+        /** command payload。 */
+        payload?: JsonValue;
+        /** 可选调度 payload。 */
+        schedule?: JsonValue;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 检查 plugin 可用性。 */
+    method: "internal.plugins.availability";
+    /** plugin 参数。 */
+    params: {
+        /** plugin 名称。 */
+        pluginName: string;
+    };
+} | {
+    /** 请求 id，用于匹配响应。 */
+    id: string;
+    /** 执行 plugin action。 */
+    method: "internal.plugins.action";
+    /** plugin action 参数。 */
+    params: {
+        /** plugin 名称。 */
+        pluginName: string;
+        /** action 名称。 */
+        actionName: string;
+        /** action payload。 */
+        payload?: JsonValue;
+    };
+};
+/**
+ * RPC 成功响应帧。
+ */
+export interface RpcSuccessFrame {
+    /** 请求 id。 */
+    id: string;
+    /** 成功标记。 */
+    success: true;
+    /** 响应数据。 */
+    data?: unknown;
+}
+/**
+ * RPC 失败响应帧。
+ */
+export interface RpcErrorFrame {
+    /** 请求 id。 */
+    id: string;
+    /** 失败标记。 */
+    success: false;
+    /** 错误信息。 */
+    error: string;
+}
+/**
+ * RPC 普通响应帧。
+ */
+export type RpcResponseFrame = RpcSuccessFrame | RpcErrorFrame;
+/**
+ * RPC 订阅 ready 帧。
+ */
+export interface RpcReadyFrame {
+    /** 帧类型。 */
+    type: "ready";
+    /** 当前订阅 id。 */
+    subscriptionId: string;
+}
+/**
+ * RPC 事件帧。
+ */
+export interface RpcEventFrame {
+    /** 帧类型。 */
+    type: "event";
+    /** 当前订阅 id。 */
+    subscriptionId: string;
+    /** session 事件。 */
+    event: AgentSessionEvent;
+}
+/**
+ * RPC server 可写帧。
+ */
+export type RpcServerFrame = RpcSuccessFrame | RpcErrorFrame | RpcEventFrame;
+/**
+ * RPC client 可读帧。
+ */
+export type RpcClientFrame = RpcResponseFrame | RpcReadyFrame | RpcEventFrame;
+/**
+ * RPC endpoint。
+ */
+export interface RpcClientEndpoint {
+    /** RPC host。 */
+    host: string;
+    /** RPC port。 */
+    port: number;
+}
+/**
+ * RPC Session 订阅句柄。
+ */
+export interface RpcSessionSubscription {
+    /** 当前订阅 id。 */
+    subscription_id: string;
+    /** 取消订阅。 */
+    unsubscribe(): Promise<void>;
+}
+/**
+ * RPC system prompt 分段条目。
+ */
+export interface RpcSystemPromptSectionItem {
+    /** 消息序号。 */
+    index: number;
+    /** system message 文本内容。 */
+    content: string;
+}
+/**
+ * RPC system prompt 分段。
+ */
+export interface RpcSystemPromptSection {
+    /** 分段稳定 key。 */
+    key: string;
+    /** 分段展示标题。 */
+    title: string;
+    /** 分段内消息条目。 */
+    items: RpcSystemPromptSectionItem[];
+}
+/**
+ * RPC system prompt 响应。
+ */
+export interface RpcSystemPromptPayload {
+    /** 请求是否成功。 */
+    success?: boolean;
+    /** 当前 session id。 */
+    sessionId: string;
+    /** system message 总数。 */
+    totalMessages: number;
+    /** system message 总字符数。 */
+    totalChars: number;
+    /** system message 分段。 */
+    sections: RpcSystemPromptSection[];
+}
+/**
+ * RPC session system snapshot 响应。
+ */
+export interface RpcSessionSystemResult {
+    /** system snapshot。 */
+    system: AgentSessionSystemSnapshot;
+}
+//# sourceMappingURL=RpcProtocol.d.ts.map

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

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

package/bin/types/rpc/RpcProtocol.js

@@ -0,0 +1,10 @@
+/**
+ * Agent RPC 协议类型。
+ *
+ * 关键点（中文）
+ * - 该文件只描述本机 RPC 的线协议，不包含 socket 或业务执行逻辑。
+ * - Client 与 Server 共享同一份 request/frame 类型，避免协议两边漂移。
+ * - 字段名保持现有协议格式，兼容已发布的 Town 托管 runtime 调用。
+ */
+export {};
+//# sourceMappingURL=RpcProtocol.js.map

package/bin/types/rpc/RpcProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcProtocol.js","sourceRoot":"","sources":["../../../src/types/rpc/RpcProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

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

@@ -12,7 +12,7 @@
 import type { LanguageModel } from "ai";
 import type { Logger } from "../../../utils/logger/Logger.js";
 import type { AgentRuntime } from "../../../types/runtime/agent/AgentRuntime.js";
-import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../../types/runtime/host/AgentHost.js";
+import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../../types/agent/AgentRuntimeAssembly.js";
 import type { DowncityConfig } from "../../../types/config/DowncityConfig.js";
 import type { JsonValue } from "../../../types/common/Json.js";
 import type { PluginPort } from "../../../plugin/types/Plugin.js";

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/runtime/agent/AgentRuntime.d.ts

@@ -11,7 +11,7 @@
  */
 import type { Logger } from "../../../utils/logger/Logger.js";
 import type { DowncityConfig } from "../../../types/config/DowncityConfig.js";
-import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../../types/runtime/host/AgentHost.js";
+import type { AgentPathRuntime, AgentPluginConfigRuntime } from "../../../types/agent/AgentRuntimeAssembly.js";
 import type { BasePlugin } from "../../../plugin/core/BasePlugin.js";
 import type { SessionPort } from "../../../types/runtime/agent/AgentContext.js";
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/agent/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,gBAAgB,CAAC;IACxB;;OAEG;IACH,YAAY,EAAE,wBAAwB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3C;;OAEG;IACH,uBAAuB,IAAI,MAAM,EAAE,CAAC;IACpC;;OAEG;IACH,wBAAwB,IAAI,MAAM,CAAC;IACnC;;OAEG;IACH,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC1C"}
+{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../../../src/types/runtime/agent/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,gBAAgB,CAAC;IACxB;;OAEG;IACH,YAAY,EAAE,wBAAwB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3C;;OAEG;IACH,uBAAuB,IAAI,MAAM,EAAE,CAAC;IACpC;;OAEG;IACH,wBAAwB,IAAI,MAAM,CAAC;IACnC;;OAEG;IACH,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC1C"}

package/bin/types/runtime/platform/Platform.d.ts

@@ -23,7 +23,7 @@ export interface PlatformAgentOption {
      */
     projectRoot: string;
     /**
-     * 当前 daemon 是否存活。
+     * 当前 Town 托管的 Agent 进程是否存活。
      */
     running: boolean;
     /**
@@ -51,11 +51,11 @@ export interface PlatformAgentOption {
      */
     stoppedAt?: string;
     /**
-     * 当前读取到的 daemon pid（仅 running=true 时有值）。
+     * 当前读取到的 Town 托管进程 pid（仅 running=true 时有值）。
      */
     daemonPid?: number;
     /**
-     * daemon 日志路径（用于排障展示）。
+     * Town 托管进程日志路径（用于排障展示）。
      */
     logPath?: string;
     /**
@@ -141,7 +141,7 @@ export interface PlatformAgentDirectoryInspection {
     /** 该目录是否已出现在 managed agent registry 中。 */
     knownAgent: boolean;
     /**
-     * 若已登记，当前 daemon 是否运行中。
+     * 若已登记，当前 Town 托管进程是否运行中。
      */
     running: boolean;
     /**
@@ -297,7 +297,7 @@ export interface ManagedAgentRegistryEntry {
      */
     projectRoot: string;
     /**
-     * registry 最近一次记录的 daemon pid。
+     * registry 最近一次记录的 Town 托管进程 pid。
      */
     pid: number;
     /**
@@ -347,7 +347,7 @@ export interface ManagedAgentProcessView {
      */
     registeredPid: number;
     /**
-     * 当前实际存活的 daemon pid。
+     * 当前实际存活的 Town 托管进程 pid。
      */
     daemonPid: number;
     /**
@@ -363,7 +363,7 @@ export interface ManagedAgentProcessView {
      */
     updatedAt: string;
     /**
-     * daemon 日志文件路径。
+     * Town 托管进程日志文件路径。
      */
     logPath: string;
 }

package/bin/types/runtime/platform/PlatformGateway.d.ts

@@ -1,5 +1,5 @@
 /**
- * 平台控制面读取 agent 项目与 daemon 状态时使用的宽松类型。
+ * 平台控制面读取 agent 项目配置与 runtime 状态时使用的宽松类型。
  *
  * 关键点（中文）
  * - 仅承载平台 gateway / control plane 内部使用的结构化类型。

package/bin/types/runtime/platform/PlatformGateway.js

@@ -1,5 +1,5 @@
 /**
- * 平台控制面读取 agent 项目与 daemon 状态时使用的宽松类型。
+ * 平台控制面读取 agent 项目配置与 runtime 状态时使用的宽松类型。
  *
  * 关键点（中文）
  * - 仅承载平台 gateway / control plane 内部使用的结构化类型。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.73",
+  "version": "1.1.79",
   "type": "module",
   "description": "Downcity Agent 运行时 — 单 Agent 执行壳与本机 RPC 能力",
   "main": "./bin/index.js",
@@ -29,7 +29,7 @@
     "node-cron": "^4.2.1",
     "ws": "^8.21.0",
     "zod": "^4.4.3",
-    "@downcity/type": "0.1.15"
+    "@downcity/type": "0.1.20"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",

package/scripts/session-history-inflight.test.mjs

@@ -0,0 +1,146 @@
+/**
+ * @file 验证 session history 会把运行中的 assistant 收敛到 inflight 快照，并在完成后写回正式历史。
+ *
+ * 关键点（中文）
+ * - 直接覆盖 JSONL history store 的落盘语义，确保运行中不中断丢失过程。
+ * - `messages.jsonl` 仍保持一轮一条 assistant 的正式历史语义。
+ * - 运行中快照放在 `inflight.json`，浏览层读取时也应可见。
+ */
+
+import test from "node:test";
+import assert from "node:assert/strict";
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs/promises";
+
+import { JsonlSessionHistoryStore } from "../bin/index.js";
+
+function create_assistant_message(parts) {
+  return {
+    id: "a:test:final",
+    role: "assistant",
+    metadata: {
+      v: 1,
+      ts: Date.now(),
+      sessionId: "session_test",
+      source: "egress",
+      kind: "normal",
+    },
+    parts,
+  };
+}
+
+test("JsonlSessionHistoryStore exposes inflight assistant during execution and finalizes it into history", async () => {
+  const root_path = await fs.mkdtemp(
+    path.join(os.tmpdir(), "downcity-agent-history-inflight-"),
+  );
+
+  const store = new JsonlSessionHistoryStore({
+    rootPath: root_path,
+    agentId: "official",
+    sessionId: "session_test",
+  });
+
+  await store.append(
+    store.userText({
+      text: "write to document",
+      metadata: {
+        sessionId: "session_test",
+      },
+    }),
+  );
+
+  await store.writeInflight(
+    create_assistant_message([
+      { type: "step-start" },
+      { type: "text", text: "Let me inspect the document.", state: "done" },
+      {
+        type: "tool-exec_command",
+        toolCallId: "call_1",
+        input: { cmd: "cat demo.mdx" },
+        state: "output-available",
+        output: { success: true, output: "# demo" },
+      },
+    ]),
+  );
+
+  const during_run = await store.list();
+  assert.equal(during_run.length, 2);
+  assert.equal(during_run[1]?.role, "assistant");
+  assert.deepEqual(
+    during_run[1]?.parts.map((part) => part.type),
+    ["step-start", "text", "tool-exec_command"],
+  );
+
+  await store.finalizeInflight(
+    create_assistant_message([
+      { type: "text", text: "Done writing.", state: "done" },
+    ]),
+  );
+
+  const after_finish = await store.list();
+  assert.equal(after_finish.length, 2);
+  assert.deepEqual(
+    after_finish[1]?.parts.map((part) => part.type),
+    ["step-start", "text", "tool-exec_command", "text"],
+  );
+
+  const inflight_path = path.join(
+    root_path,
+    ".downcity",
+    "agents",
+    "official",
+    "sessions",
+    "session_test",
+    "messages",
+    "inflight.json",
+  );
+  const inflight_exists = await fs
+    .access(inflight_path)
+    .then(() => true)
+    .catch(() => false);
+  assert.equal(inflight_exists, false);
+});
+
+test("Appending a new user message flushes stale inflight assistant before the new turn", async () => {
+  const root_path = await fs.mkdtemp(
+    path.join(os.tmpdir(), "downcity-agent-history-flush-"),
+  );
+
+  const store = new JsonlSessionHistoryStore({
+    rootPath: root_path,
+    agentId: "official",
+    sessionId: "session_flush_test",
+  });
+
+  await store.append(
+    store.userText({
+      text: "first",
+      metadata: {
+        sessionId: "session_flush_test",
+      },
+    }),
+  );
+
+  await store.writeInflight(
+    create_assistant_message([
+      { type: "step-start" },
+      { type: "text", text: "partial assistant", state: "done" },
+    ]),
+  );
+
+  await store.append(
+    store.userText({
+      text: "second",
+      metadata: {
+        sessionId: "session_flush_test",
+      },
+    }),
+  );
+
+  const messages = await store.list();
+  assert.equal(messages.length, 3);
+  assert.equal(messages[0]?.role, "user");
+  assert.equal(messages[1]?.role, "assistant");
+  assert.equal(messages[2]?.role, "user");
+});