@downcity/agent 1.1.199 → 1.1.202

package/bin/agent/local/services/AgentSessionManager.d.ts.map

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

package/bin/agent/local/services/AgentSessionManager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentSessionManager.js","sourceRoot":"","sources":["../../../../src/agent/local/services/AgentSessionManager.ts"],"names":[],"mappings":"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"}

package/bin/executor/types/SessionMessages.d.ts

@@ -1,118 +0,0 @@
-/**
- * SessionMessage 类型定义。
- *
- * 关键点（中文）
- * - 这里统一描述 session 消息落盘格式与元信息结构。
- * - session 的唯一事实源是消息 JSONL，模型消息继续使用 AI SDK `UIMessage`。
- * - 这些类型会被 history Store、history Composer、compact、control UI、task runtime 共同复用。
- */
-import type { UIMessage } from "ai";
-import type { JsonObject } from "../../types/common/Json.js";
-import type { AgentSessionOperationRecord } from "../../types/sdk/AgentSessionOperation.js";
-/**
- * Session 消息：以 UIMessage[] 作为唯一事实源。
- *
- * 关键点（中文）
- * - 持久化存储在 `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/messages.jsonl`
- * - 默认只存 `role=user|assistant|operation`
- * - compact 会把更早消息压缩为一条 `assistant` 摘要消息
- * - operation 只用于 UI timeline，不进入 LLM 输入
- */
-export type SessionMessageKind = "normal" | "summary" | "operation";
-/**
- * Session 消息来源类型。
- *
- * 说明（中文）
- * - `ingress`：外部输入写入的 user 消息。
- * - `egress`：模型或 agent 输出写入的 assistant 消息。
- * - `compact`：由 compact 过程生成的摘要消息。
- */
-export type SessionMessageSource = "ingress" | "egress" | "compact" | "operation";
-/**
- * 入站消息细分类型。
- *
- * 说明（中文）
- * - 当前仅保留 `exec`，表示这条入站消息可触发一次 session 执行。
- */
-export type SessionIngressKind = "exec";
-/**
- * 摘要消息对应的原始消息范围。
- */
-export type SessionMessageSourceRangeV1 = {
-    /** 起始消息 ID。 */
-    fromId: string;
-    /** 结束消息 ID。 */
-    toId: string;
-    /** 被覆盖的原始消息数量。 */
-    count: number;
-};
-/**
- * Session 消息元信息。
- */
-export type SessionMetadataV1 = {
-    /** 元信息 schema 版本号。 */
-    v: 1;
-    /** 当前消息写入时的毫秒时间戳。 */
-    ts: number;
-    /** 当前消息所属的 session ID。 */
-    sessionId: string;
-    /** 当前消息是普通消息还是摘要消息。 */
-    kind?: SessionMessageKind;
-    /** 当前消息来自入站、出站还是 compact。 */
-    source?: SessionMessageSource;
-    /** compact 摘要对应的 archive 文件 ID，用于用户历史按层读取更早消息。 */
-    archiveId?: string;
-    /** compact 摘要所覆盖的原始消息范围。 */
-    sourceRange?: SessionMessageSourceRangeV1;
-    /**
-     * operation message 对应的结构化操作记录。
-     *
-     * 说明（中文）
-     * - 仅当 `kind=operation` 或 `source=operation` 时存在。
-     * - 该字段供前端恢复时间线状态，不会进入 LLM 输入。
-     */
-    operation?: AgentSessionOperationRecord;
-    /**
-     * 扩展元信息。
-     *
-     * 约定（中文）
-     * - 对 `source=ingress` 的 user 消息，可选写入 `extra.ingressKind`：
-     *   - `exec`：可触发 Session 执行的输入
-     */
-    extra?: JsonObject;
-};
-/**
- * 模型可消费的 Session UI 消息结构。
- */
-export type SessionModelMessageV1 = UIMessage<SessionMetadataV1>;
-/**
- * operation 角色的 Session 消息结构。
- *
- * 关键点（中文）
- * - `operation` 不是 AI SDK 原生模型 role。
- * - 它只存在于 JSONL history 与前端 timeline，进入 LLM 前必须过滤。
- */
-export type SessionOperationMessageV1 = Omit<SessionModelMessageV1, "role"> & {
-    /** 消息角色固定为 `operation`。 */
-    role: "operation";
-};
-/**
- * Session 持久化消息结构。
- */
-export type SessionMessageV1 = SessionModelMessageV1 | SessionOperationMessageV1;
-/**
- * user 角色的 Session 消息结构。
- */
-export type SessionUserMessageV1 = SessionMessageV1 & {
-    /** 消息角色固定为 `user`。 */
-    role: "user";
-};
-/**
- * 判断一条消息是否为 operation message。
- */
-export declare function isSessionOperationMessage(message: SessionMessageV1 | null | undefined): boolean;
-/**
- * 判断一条消息是否为模型可消费的 UIMessage。
- */
-export declare function isSessionModelMessage(message: SessionMessageV1 | null | undefined): message is SessionModelMessageV1;
-//# sourceMappingURL=SessionMessages.d.ts.map

package/bin/executor/types/SessionMessages.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionMessages.d.ts","sourceRoot":"","sources":["../../../src/executor/types/SessionMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAExF;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,QAAQ,GACR,SAAS,GACT,WAAW,CAAC;AAEhB;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sBAAsB;IACtB,CAAC,EAAE,CAAC,CAAC;IACL,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG;IAC5E,2BAA2B;IAC3B,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GAAG,yBAAyB,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IACpD,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAC3C,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAC3C,OAAO,IAAI,qBAAqB,CAGlC"}

package/bin/executor/types/SessionMessages.js

@@ -1,28 +0,0 @@
-/**
- * SessionMessage 类型定义。
- *
- * 关键点（中文）
- * - 这里统一描述 session 消息落盘格式与元信息结构。
- * - session 的唯一事实源是消息 JSONL，模型消息继续使用 AI SDK `UIMessage`。
- * - 这些类型会被 history Store、history Composer、compact、control UI、task runtime 共同复用。
- */
-/**
- * 判断一条消息是否为 operation message。
- */
-export function isSessionOperationMessage(message) {
-    if (!message || typeof message !== "object")
-        return false;
-    const metadata = (message.metadata || null);
-    return (message.role === "operation" ||
-        metadata?.kind === "operation" ||
-        metadata?.source === "operation");
-}
-/**
- * 判断一条消息是否为模型可消费的 UIMessage。
- */
-export function isSessionModelMessage(message) {
-    if (!message || typeof message !== "object")
-        return false;
-    return message.role !== "operation" && !isSessionOperationMessage(message);
-}
-//# sourceMappingURL=SessionMessages.js.map

package/bin/executor/types/SessionMessages.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionMessages.js","sourceRoot":"","sources":["../../../src/executor/types/SessionMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqHH;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAA4C;IAE5C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAA6B,CAAC;IACxE,OAAO,CACL,OAAO,CAAC,IAAI,KAAK,WAAW;QAC5B,QAAQ,EAAE,IAAI,KAAK,WAAW;QAC9B,QAAQ,EAAE,MAAM,KAAK,WAAW,CACjC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA4C;IAE5C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC"}

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

@@ -1,99 +0,0 @@
-/**
- * Agent Session operation 类型定义。
- *
- * 关键点（中文）
- * - operation 描述 session 内部正在发生的辅助操作，不代表 assistant 正文。
- * - operation 可以同时作为订阅事件发布，也可以作为 UIMessage 持久化到 JSONL。
- * - operation message 只用于前端时间线与调试，不应进入 LLM 输入。
- */
-import type { JsonValue } from "../../types/common/Json.js";
-/**
- * Session operation 当前状态。
- */
-export type AgentSessionOperationStatus = "started" | "progress" | "finished" | "skipped" | "failed";
-/**
- * Session operation 名称。
- *
- * 说明（中文）
- * - 内置名称用于 SDK 与前端约定常见辅助操作。
- * - 字符串扩展允许 plugin 或宿主运行时声明自己的 operation。
- */
-export type AgentSessionOperationName = "compacting" | "model-switching" | "history-forking" | (string & {});
-/**
- * Session operation 记录。
- */
-export interface AgentSessionOperationRecord {
-    /**
-     * 同一个 operation 生命周期内稳定复用的 ID。
-     */
-    operationId: string;
-    /**
-     * 当前 operation 名称。
-     */
-    name: AgentSessionOperationName;
-    /**
-     * 当前 operation 状态。
-     */
-    status: AgentSessionOperationStatus;
-    /**
-     * 当前 operation 关联的 turn 标识。
-     *
-     * 说明（中文）
-     * - turn 内触发的 operation 应写入该字段。
-     * - session 级 operation 可以省略。
-     */
-    turnId?: string;
-    /**
-     * 面向用户展示的短文本。
-     */
-    label?: string;
-    /**
-     * 机器可读原因。
-     *
-     * 示例（中文）
-     * - `under_budget`：未达到压缩阈值。
-     * - `summary_fallback`：摘要生成失败后使用降级摘要。
-     */
-    reason?: string;
-    /**
-     * 当前 operation 进度，范围 0 到 1。
-     *
-     * 说明（中文）
-     * - 无法估算进度时省略。
-     */
-    progress?: number;
-    /**
-     * operation 完成后产生的轻量结果。
-     */
-    result?: JsonValue;
-    /**
-     * operation 失败时的错误文本。
-     */
-    error?: string;
-    /**
-     * 是否建议前端展示。
-     *
-     * 说明（中文）
-     * - 默认视为 `true`。
-     * - 调试或审计类辅助事件可显式写入 `false`。
-     */
-    visible?: boolean;
-}
-/**
- * Session operation 订阅事件。
- */
-export interface AgentSessionOperationEvent extends AgentSessionOperationRecord {
-    /**
-     * 当前事件类型。
-     */
-    type: "operation";
-    /**
-     * 当前 session 唯一标识。
-     */
-    sessionId: string;
-}
-/**
- * Session operation 发布回调。
- */
-export type AgentSessionOperationCallback = (operation: AgentSessionOperationEvent) => Promise<void>;
-//# sourceMappingURL=AgentSessionOperation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"AgentSessionOperation.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionOperation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,2BAA2B,GACnC,SAAS,GACT,UAAU,GACV,UAAU,GACV,SAAS,GACT,QAAQ,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GACjC,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,yBAAyB,CAAC;IAEhC;;OAEG;IACH,MAAM,EAAE,2BAA2B,CAAC;IAEpC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,2BAA2B;IAC7E;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC1C,SAAS,EAAE,0BAA0B,KAClC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/types/sdk/AgentSessionOperation.js

@@ -1,10 +0,0 @@
-/**
- * Agent Session operation 类型定义。
- *
- * 关键点（中文）
- * - operation 描述 session 内部正在发生的辅助操作，不代表 assistant 正文。
- * - operation 可以同时作为订阅事件发布，也可以作为 UIMessage 持久化到 JSONL。
- * - operation message 只用于前端时间线与调试，不应进入 LLM 输入。
- */
-export {};
-//# sourceMappingURL=AgentSessionOperation.js.map

package/bin/types/sdk/AgentSessionOperation.js.map

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

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

@@ -1,197 +0,0 @@
-/**
- * @file 验证 operation message 的持久化、模型输入过滤与 timeline 投影。
- *
- * 关键点（中文）
- * - operation message 会作为 operation role 消息写入 JSONL。
- * - history composer 组装 LLM 输入时必须过滤 operation message。
- * - timeline view 可以把 operation message 投影成前端可识别的 operation 事件。
- */
-
-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/executor/store/history/jsonl/JsonlSessionHistoryStore.js";
-import { JsonlSessionHistoryComposer } from "../bin/executor/composer/history/jsonl/JsonlSessionHistoryComposer.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 () => {
-  const root_path = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-operation-message-"),
-  );
-  const session_id = "operation_session";
-  const store = new JsonlSessionHistoryStore({
-    rootPath: root_path,
-    agentId: "operation_agent",
-    sessionId: session_id,
-  });
-  const composer = new JsonlSessionHistoryComposer({ store });
-
-  await store.append(
-    store.userText({
-      text: "hello",
-      metadata: { sessionId: session_id },
-      id: "u:1",
-    }),
-  );
-  await store.append(
-    store.operation({
-      operation: {
-        operationId: "op-1",
-        name: "compacting",
-        status: "finished",
-        label: "Session history compacted",
-        turnId: "turn-1",
-      },
-      metadata: { sessionId: session_id },
-      id: "op:1",
-    }),
-  );
-  await store.append(
-    store.assistantText({
-      text: "world",
-      metadata: { sessionId: session_id },
-      id: "a:1",
-    }),
-  );
-
-  const persisted_messages = await store.list();
-  assert.equal(persisted_messages.length, 3);
-  assert.equal(persisted_messages[1].role, "operation");
-  assert.equal(persisted_messages[1].metadata.kind, "operation");
-  assert.equal(persisted_messages[1].metadata.operation.operationId, "op-1");
-
-  const model_messages = await composer.prepare({
-    query: "",
-    tools: {},
-    system: [],
-    model: {},
-    retryCount: 0,
-  });
-  assert.deepEqual(
-    model_messages.map((message) => message.id),
-    ["u:1", "a:1"],
-  );
-
-  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, "finished");
-  assert.equal(timeline_events[0].text, "Session history compacted");
-
-  const hidden_started_events = toSessionTimelineEvents(
-    store.operation({
-      operation: {
-        operationId: "op-started",
-        name: "compacting",
-        status: "started",
-        label: "Compacting session history",
-      },
-      metadata: { sessionId: session_id },
-      id: "op:started",
-    }),
-  );
-  assert.deepEqual(hidden_started_events, []);
-});
-
-test("session.set persists and publishes model-switching operations", async () => {
-  const agent_path = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-model-switching-"),
-  );
-  const agent = new Agent({
-    id: "model_switching_agent",
-    path: agent_path,
-  });
-  try {
-    const session = await agent.session_collection().create_session({
-      sessionId: "model_switching_session",
-    });
-    const events = [];
-    const unsubscribe = session.subscribe((event) => {
-      if (event.type === "operation") events.push(event);
-    });
-
-    await session.set({
-      model: {
-        modelId: "test-model",
-        provider: "test",
-      },
-    });
-    unsubscribe();
-
-    assert.deepEqual(
-      events.map((event) => `${event.name}:${event.status}`),
-      ["model-switching:started", "model-switching:finished"],
-    );
-
-    const history = await session.history({ view: "timeline" });
-    const operation_events = history.items.filter(
-      (item) => item.role === "operation",
-    );
-    assert.deepEqual(
-      operation_events.map((event) => `${event.operationName}:${event.operationStatus}`),
-      ["model-switching:finished"],
-    );
-  } finally {
-    await agent.dispose();
-  }
-});
-
-test("session.fork persists and publishes history-forking operations on source session", async () => {
-  const agent_path = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-history-forking-"),
-  );
-  const agent = new Agent({
-    id: "history_forking_agent",
-    path: agent_path,
-  });
-  try {
-    const session = await agent.session_collection().create_session({
-      sessionId: "history_forking_session",
-    });
-    await session.set({
-      model: {
-        modelId: "fork-test-model",
-        provider: "test",
-      },
-    });
-    await session.appendUserMessage({ text: "source message" });
-
-    const events = [];
-    const unsubscribe = session.subscribe((event) => {
-      if (event.type === "operation" && event.name === "history-forking") {
-        events.push(event);
-      }
-    });
-    const forked = await session.fork();
-    unsubscribe();
-
-    assert.deepEqual(
-      events.map((event) => `${event.name}:${event.status}`),
-      ["history-forking:started", "history-forking:finished"],
-    );
-    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",
-    );
-    assert.deepEqual(
-      source_fork_operations.map((event) => event.operationStatus),
-      ["finished"],
-    );
-
-    const forked_history = await forked.history({ view: "timeline" });
-    const forked_model_operations = forked_history.items.filter(
-      (item) => item.operationName === "model-switching",
-    );
-    assert.equal(forked_model_operations.length, 1);
-  } finally {
-    await agent.dispose();
-  }
-});

package/src/executor/types/SessionMessages.ts

@@ -1,148 +0,0 @@
-/**
- * SessionMessage 类型定义。
- *
- * 关键点（中文）
- * - 这里统一描述 session 消息落盘格式与元信息结构。
- * - session 的唯一事实源是消息 JSONL，模型消息继续使用 AI SDK `UIMessage`。
- * - 这些类型会被 history Store、history Composer、compact、control UI、task runtime 共同复用。
- */
-
-import type { UIMessage } from "ai";
-import type { JsonObject } from "@/types/common/Json.js";
-import type { AgentSessionOperationRecord } from "@/types/sdk/AgentSessionOperation.js";
-
-/**
- * Session 消息：以 UIMessage[] 作为唯一事实源。
- *
- * 关键点（中文）
- * - 持久化存储在 `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/messages.jsonl`
- * - 默认只存 `role=user|assistant|operation`
- * - compact 会把更早消息压缩为一条 `assistant` 摘要消息
- * - operation 只用于 UI timeline，不进入 LLM 输入
- */
-export type SessionMessageKind = "normal" | "summary" | "operation";
-
-/**
- * Session 消息来源类型。
- *
- * 说明（中文）
- * - `ingress`：外部输入写入的 user 消息。
- * - `egress`：模型或 agent 输出写入的 assistant 消息。
- * - `compact`：由 compact 过程生成的摘要消息。
- */
-export type SessionMessageSource =
-  | "ingress"
-  | "egress"
-  | "compact"
-  | "operation";
-
-/**
- * 入站消息细分类型。
- *
- * 说明（中文）
- * - 当前仅保留 `exec`，表示这条入站消息可触发一次 session 执行。
- */
-export type SessionIngressKind = "exec";
-
-/**
- * 摘要消息对应的原始消息范围。
- */
-export type SessionMessageSourceRangeV1 = {
-  /** 起始消息 ID。 */
-  fromId: string;
-  /** 结束消息 ID。 */
-  toId: string;
-  /** 被覆盖的原始消息数量。 */
-  count: number;
-};
-
-/**
- * Session 消息元信息。
- */
-export type SessionMetadataV1 = {
-  /** 元信息 schema 版本号。 */
-  v: 1;
-  /** 当前消息写入时的毫秒时间戳。 */
-  ts: number;
-  /** 当前消息所属的 session ID。 */
-  sessionId: string;
-  /** 当前消息是普通消息还是摘要消息。 */
-  kind?: SessionMessageKind;
-  /** 当前消息来自入站、出站还是 compact。 */
-  source?: SessionMessageSource;
-  /** compact 摘要对应的 archive 文件 ID，用于用户历史按层读取更早消息。 */
-  archiveId?: string;
-  /** compact 摘要所覆盖的原始消息范围。 */
-  sourceRange?: SessionMessageSourceRangeV1;
-  /**
-   * operation message 对应的结构化操作记录。
-   *
-   * 说明（中文）
-   * - 仅当 `kind=operation` 或 `source=operation` 时存在。
-   * - 该字段供前端恢复时间线状态，不会进入 LLM 输入。
-   */
-  operation?: AgentSessionOperationRecord;
-  /**
-   * 扩展元信息。
-   *
-   * 约定（中文）
-   * - 对 `source=ingress` 的 user 消息，可选写入 `extra.ingressKind`：
-   *   - `exec`：可触发 Session 执行的输入
-   */
-  extra?: JsonObject;
-};
-
-/**
- * 模型可消费的 Session UI 消息结构。
- */
-export type SessionModelMessageV1 = UIMessage<SessionMetadataV1>;
-
-/**
- * operation 角色的 Session 消息结构。
- *
- * 关键点（中文）
- * - `operation` 不是 AI SDK 原生模型 role。
- * - 它只存在于 JSONL history 与前端 timeline，进入 LLM 前必须过滤。
- */
-export type SessionOperationMessageV1 = Omit<SessionModelMessageV1, "role"> & {
-  /** 消息角色固定为 `operation`。 */
-  role: "operation";
-};
-
-/**
- * Session 持久化消息结构。
- */
-export type SessionMessageV1 = SessionModelMessageV1 | SessionOperationMessageV1;
-
-/**
- * user 角色的 Session 消息结构。
- */
-export type SessionUserMessageV1 = SessionMessageV1 & {
-  /** 消息角色固定为 `user`。 */
-  role: "user";
-};
-
-/**
- * 判断一条消息是否为 operation message。
- */
-export function isSessionOperationMessage(
-  message: SessionMessageV1 | null | undefined,
-): boolean {
-  if (!message || typeof message !== "object") return false;
-  const metadata = (message.metadata || null) as SessionMetadataV1 | null;
-  return (
-    message.role === "operation" ||
-    metadata?.kind === "operation" ||
-    metadata?.source === "operation"
-  );
-}
-
-/**
- * 判断一条消息是否为模型可消费的 UIMessage。
- */
-export function isSessionModelMessage(
-  message: SessionMessageV1 | null | undefined,
-): message is SessionModelMessageV1 {
-  if (!message || typeof message !== "object") return false;
-  return message.role !== "operation" && !isSessionOperationMessage(message);
-}