@downcity/agent 1.1.217 → 1.1.222

package/bin/session/SessionEventMapper.d.ts

@@ -1,32 +0,0 @@
-/**
- * Session 事件映射辅助。
- *
- * 关键点（中文）
- * - 把底层 AI SDK `UIMessageChunk` 归一到内部 `InternalUiChunkEvent`。
- * - 再把内部 chunk 事件转换为 `session.subscribe()` 可见的 Session 事件。
- */
-import type { UIMessageChunk } from "ai";
-import type { AgentSessionEvent } from "../types/sdk/AgentSessionEvent.js";
-import type { InternalUiChunkEvent } from "../types/sdk/InternalUiChunkEvent.js";
-/**
- * 把单个 UI chunk 映射为内部 chunk 事件。
- */
-export declare function mapUiMessageChunkToAgentEvent(chunk: UIMessageChunk): InternalUiChunkEvent | null;
-/**
- * 把内部 chunk 事件映射为 Session actor 事件。
- *
- * 关键点（中文）
- * - Session 级事件只保留 turn 维度所需的最小字段。
- * - `finish` 与通用 `error` 由 turn 生命周期统一表达，不在这里直接透出。
- */
-export declare function mapAgentEventToSessionEvent(params: {
-    /**
-     * 当前内部 chunk 事件。
-     */
-    event: InternalUiChunkEvent;
-    /**
-     * 当前 turn 标识。
-     */
-    turnId: string;
-}): AgentSessionEvent | null;
-//# sourceMappingURL=SessionEventMapper.d.ts.map

package/bin/session/SessionEventMapper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionEventMapper.d.ts","sourceRoot":"","sources":["../../src/session/SessionEventMapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAmBhF;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,cAAc,GACpB,oBAAoB,GAAG,IAAI,CA4D7B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD;;OAEG;IACH,KAAK,EAAE,oBAAoB,CAAC;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,iBAAiB,GAAG,IAAI,CAkC3B"}

package/bin/session/SessionEventMapper.js

@@ -1,131 +0,0 @@
-/**
- * Session 事件映射辅助。
- *
- * 关键点（中文）
- * - 把底层 AI SDK `UIMessageChunk` 归一到内部 `InternalUiChunkEvent`。
- * - 再把内部 chunk 事件转换为 `session.subscribe()` 可见的 Session 事件。
- */
-function toJsonValue(value) {
-    if (value === undefined)
-        return null;
-    if (value === null)
-        return null;
-    if (typeof value === "string" ||
-        typeof value === "number" ||
-        typeof value === "boolean") {
-        return value;
-    }
-    try {
-        return JSON.parse(JSON.stringify(value));
-    }
-    catch {
-        return String(value);
-    }
-}
-/**
- * 把单个 UI chunk 映射为内部 chunk 事件。
- */
-export function mapUiMessageChunkToAgentEvent(chunk) {
-    switch (chunk.type) {
-        case "text-delta":
-            return {
-                type: "text-delta",
-                text: chunk.delta,
-            };
-        case "reasoning-delta":
-            return {
-                type: "reasoning-delta",
-                text: chunk.delta,
-            };
-        case "tool-input-available":
-            return {
-                type: "tool-call",
-                toolCallId: chunk.toolCallId,
-                toolName: chunk.toolName,
-                args: toJsonValue(chunk.input),
-            };
-        case "tool-output-available":
-            return {
-                type: "tool-result",
-                toolCallId: chunk.toolCallId,
-                toolName: "unknown",
-                result: toJsonValue(chunk.output),
-            };
-        case "tool-output-error":
-            return {
-                type: "tool-error",
-                toolCallId: chunk.toolCallId,
-                toolName: "unknown",
-                error: chunk.errorText,
-            };
-        case "tool-input-error":
-            return {
-                type: "tool-error",
-                toolCallId: chunk.toolCallId,
-                toolName: chunk.toolName,
-                error: chunk.errorText,
-            };
-        case "finish":
-            return {
-                type: "finish",
-                ...(typeof chunk.finishReason === "string"
-                    ? { finishReason: chunk.finishReason }
-                    : {}),
-            };
-        case "error":
-            return {
-                type: "error",
-                error: chunk.errorText,
-            };
-        case "abort":
-            return {
-                type: "error",
-                error: String(chunk.reason || "execution aborted"),
-            };
-        default:
-            return null;
-    }
-}
-/**
- * 把内部 chunk 事件映射为 Session actor 事件。
- *
- * 关键点（中文）
- * - Session 级事件只保留 turn 维度所需的最小字段。
- * - `finish` 与通用 `error` 由 turn 生命周期统一表达，不在这里直接透出。
- */
-export function mapAgentEventToSessionEvent(params) {
-    const { event, turnId } = params;
-    switch (event.type) {
-        case "text-delta":
-            return {
-                type: "text-delta",
-                turnId,
-                text: event.text,
-            };
-        case "reasoning-delta":
-            return {
-                type: "reasoning-delta",
-                turnId,
-                text: event.text,
-            };
-        case "tool-call":
-            return {
-                type: "tool-call",
-                turnId,
-                toolCallId: event.toolCallId,
-                toolName: event.toolName,
-                args: event.args,
-            };
-        case "tool-result":
-            return {
-                type: "tool-result",
-                turnId,
-                toolCallId: event.toolCallId,
-                toolName: event.toolName,
-                result: event.result,
-            };
-        default:
-            return null;
-    }
-}
-//# sourceMappingURL=SessionEventMapper.js.map

package/bin/session/SessionEventMapper.js.map

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

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

@@ -1,100 +0,0 @@
-/**
- * SDK 内部 UI chunk 事件类型定义。
- *
- * 关键点（中文）
- * - 这是 Session 事件映射器的内部中间态，不从包根入口导出。
- * - 它只负责承接底层 AI SDK `UIMessageChunk`，再转成 `AgentSessionEvent`。
- */
-import type { JsonValue } from "../../types/common/Json.js";
-/**
- * SDK 内部 UI chunk 事件。
- */
-export type InternalUiChunkEvent = {
-    /**
-     * 文本增量事件。
-     */
-    type: "text-delta";
-    /**
-     * 当前追加的文本片段。
-     */
-    text: string;
-} | {
-    /**
-     * reasoning 增量事件。
-     */
-    type: "reasoning-delta";
-    /**
-     * 当前追加的 reasoning 文本片段。
-     */
-    text: string;
-} | {
-    /**
-     * 工具调用可用事件。
-     */
-    type: "tool-call";
-    /**
-     * 当前工具调用唯一标识。
-     */
-    toolCallId: string;
-    /**
-     * 工具名称。
-     */
-    toolName: string;
-    /**
-     * 工具输入参数。
-     */
-    args: JsonValue;
-} | {
-    /**
-     * 工具调用结果事件。
-     */
-    type: "tool-result";
-    /**
-     * 当前工具调用唯一标识。
-     */
-    toolCallId: string;
-    /**
-     * 工具名称。
-     */
-    toolName: string;
-    /**
-     * 工具输出结果。
-     */
-    result: JsonValue;
-} | {
-    /**
-     * 工具调用失败事件。
-     */
-    type: "tool-error";
-    /**
-     * 当前工具调用唯一标识。
-     */
-    toolCallId: string;
-    /**
-     * 工具名称。
-     */
-    toolName: string;
-    /**
-     * 错误文本。
-     */
-    error: string;
-} | {
-    /**
-     * 运行结束事件。
-     */
-    type: "finish";
-    /**
-     * 最终完成原因（若底层可提供）。
-     */
-    finishReason?: string;
-} | {
-    /**
-     * 运行错误事件。
-     */
-    type: "error";
-    /**
-     * 错误文本。
-     */
-    error: string;
-};
-//# sourceMappingURL=InternalUiChunkEvent.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"InternalUiChunkEvent.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/InternalUiChunkEvent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAClB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB,GACD;IACE;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB,GACD;IACE;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IACE;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/bin/types/sdk/InternalUiChunkEvent.js

@@ -1,9 +0,0 @@
-/**
- * SDK 内部 UI chunk 事件类型定义。
- *
- * 关键点（中文）
- * - 这是 Session 事件映射器的内部中间态，不从包根入口导出。
- * - 它只负责承接底层 AI SDK `UIMessageChunk`，再转成 `AgentSessionEvent`。
- */
-export {};
-//# sourceMappingURL=InternalUiChunkEvent.js.map

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

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

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

@@ -1,188 +0,0 @@
-/**
- * @file 验证 session.records 的 compact archive 分层读取语义。
- *
- * 关键点（中文）
- * - compact summary 是模型上下文消息，但不应作为用户可见 history item 返回。
- * - 调用方通过 previous_archive_id 再传入 archive_id，读取上一层被覆盖历史。
- * - history 分页字段使用 snake_case，保持 SDK 对外数据命名一致。
- */
-
-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 { Agent } from "../bin/index.js";
-
-function user_message(session_id, index) {
-  return {
-    id: `u:${index}`,
-    role: "user",
-    metadata: {
-      v: 1,
-      ts: index,
-      sessionId: session_id,
-      source: "ingress",
-    },
-    parts: [{ type: "text", text: `user ${index}` }],
-  };
-}
-
-function assistant_message(session_id, index) {
-  return {
-    id: `a:${index}`,
-    role: "assistant",
-    metadata: {
-      v: 1,
-      ts: index,
-      sessionId: session_id,
-      source: "egress",
-    },
-    parts: [{ type: "text", text: `assistant ${index}` }],
-  };
-}
-
-function compact_summary(session_id, archive_id, text) {
-  return {
-    id: `summary:${archive_id}`,
-    role: "assistant",
-    metadata: {
-      v: 1,
-      ts: 1000,
-      sessionId: session_id,
-      source: "compact",
-      kind: "summary",
-      archiveId: archive_id,
-      sourceRange: {
-        fromId: "start",
-        toId: "end",
-        count: 2,
-      },
-    },
-    parts: [{ type: "text", text }],
-  };
-}
-
-async function write_jsonl(file_path, messages) {
-  await fs.mkdir(path.dirname(file_path), { recursive: true });
-  await fs.writeFile(
-    file_path,
-    messages.map((message) => JSON.stringify(message)).join("\n") + "\n",
-    "utf8",
-  );
-}
-
-async function write_archive(file_path, session_id, messages) {
-  await fs.mkdir(path.dirname(file_path), { recursive: true });
-  await fs.writeFile(
-    file_path,
-    JSON.stringify(
-      {
-        v: 1,
-        sessionId: session_id,
-        archivedAt: Date.now(),
-        messages,
-      },
-      null,
-      2,
-    ),
-    "utf8",
-  );
-}
-
-test("session.records hides compact summary and reads archive layers by archive_id", async () => {
-  const agent_path = await fs.mkdtemp(
-    path.join(os.tmpdir(), "downcity-agent-history-archive-"),
-  );
-  const agent = new Agent({
-    id: "history_archive_agent",
-    path: agent_path,
-  });
-  const session = await agent.sessions.create({
-    sessionId: "history_archive_session",
-  });
-
-  const messages_dir = path.join(
-    agent_path,
-    ".downcity",
-    "agents",
-    encodeURIComponent("history_archive_agent"),
-    "sessions",
-    encodeURIComponent(session.id),
-    "messages",
-  );
-  const messages_path = path.join(messages_dir, "messages.jsonl");
-  const archive_dir = path.join(messages_dir, "archive");
-
-  try {
-    await write_jsonl(messages_path, [
-      compact_summary(session.id, "compact-B", "summary B"),
-      user_message(session.id, 31),
-      assistant_message(session.id, 32),
-    ]);
-    await write_archive(path.join(archive_dir, "compact-B.json"), session.id, [
-      compact_summary(session.id, "compact-A", "summary A"),
-      user_message(session.id, 16),
-      assistant_message(session.id, 17),
-    ]);
-    await write_archive(path.join(archive_dir, "compact-A.json"), session.id, [
-      user_message(session.id, 1),
-      assistant_message(session.id, 2),
-    ]);
-
-    const current_page = await session.records({
-      limit: 1,
-    });
-    assert.equal(current_page.total, 2);
-    assert.equal(current_page.has_more, true);
-    assert.equal(current_page.next_cursor, "1");
-    assert.equal(current_page.archive_id, undefined);
-    assert.equal(current_page.previous_archive_id, "compact-B");
-    assert.deepEqual(
-      current_page.items.map((message) => message.id),
-      ["u:31"],
-    );
-
-    const next_current_page = await session.records({
-      cursor: current_page.next_cursor,
-    });
-    assert.equal(next_current_page.has_more, false);
-    assert.deepEqual(
-      next_current_page.items.map((message) => message.id),
-      ["a:32"],
-    );
-
-    const previous_page = await session.records({
-      archive_id: current_page.previous_archive_id,
-    });
-    assert.equal(previous_page.archive_id, "compact-B");
-    assert.equal(previous_page.previous_archive_id, "compact-A");
-    assert.equal(previous_page.total, 2);
-    assert.deepEqual(
-      previous_page.items.map((message) => message.id),
-      ["u:16", "a:17"],
-    );
-
-    const oldest_page = await session.records({
-      archive_id: previous_page.previous_archive_id,
-    });
-    assert.equal(oldest_page.archive_id, "compact-A");
-    assert.equal(oldest_page.previous_archive_id, undefined);
-    assert.deepEqual(
-      oldest_page.items.map((message) => message.id),
-      ["u:1", "a:2"],
-    );
-
-    const timeline_page = await session.records({
-      view: "timeline",
-      archive_id: "compact-B",
-    });
-    assert.deepEqual(
-      timeline_page.items.map((event) => event.text),
-      ["user 16", "assistant 17"],
-    );
-  } finally {
-    await agent.dispose();
-  }
-});

package/src/session/SessionEventMapper.ts

@@ -1,148 +0,0 @@
-/**
- * Session 事件映射辅助。
- *
- * 关键点（中文）
- * - 把底层 AI SDK `UIMessageChunk` 归一到内部 `InternalUiChunkEvent`。
- * - 再把内部 chunk 事件转换为 `session.subscribe()` 可见的 Session 事件。
- */
-
-import type { UIMessageChunk } from "ai";
-import type { JsonValue } from "@/types/common/Json.js";
-import type { AgentSessionEvent } from "@/types/sdk/AgentSessionEvent.js";
-import type { InternalUiChunkEvent } from "@/types/sdk/InternalUiChunkEvent.js";
-
-function toJsonValue(value: unknown): JsonValue {
-  if (value === undefined) return null;
-  if (value === null) return null;
-  if (
-    typeof value === "string" ||
-    typeof value === "number" ||
-    typeof value === "boolean"
-  ) {
-    return value;
-  }
-  try {
-    return JSON.parse(JSON.stringify(value)) as JsonValue;
-  } catch {
-    return String(value);
-  }
-}
-
-/**
- * 把单个 UI chunk 映射为内部 chunk 事件。
- */
-export function mapUiMessageChunkToAgentEvent(
-  chunk: UIMessageChunk,
-): InternalUiChunkEvent | null {
-  switch (chunk.type) {
-    case "text-delta":
-      return {
-        type: "text-delta",
-        text: chunk.delta,
-      };
-    case "reasoning-delta":
-      return {
-        type: "reasoning-delta",
-        text: chunk.delta,
-      };
-    case "tool-input-available":
-      return {
-        type: "tool-call",
-        toolCallId: chunk.toolCallId,
-        toolName: chunk.toolName,
-        args: toJsonValue(chunk.input),
-      };
-    case "tool-output-available":
-      return {
-        type: "tool-result",
-        toolCallId: chunk.toolCallId,
-        toolName: "unknown",
-        result: toJsonValue(chunk.output),
-      };
-    case "tool-output-error":
-      return {
-        type: "tool-error",
-        toolCallId: chunk.toolCallId,
-        toolName: "unknown",
-        error: chunk.errorText,
-      };
-    case "tool-input-error":
-      return {
-        type: "tool-error",
-        toolCallId: chunk.toolCallId,
-        toolName: chunk.toolName,
-        error: chunk.errorText,
-      };
-    case "finish":
-      return {
-        type: "finish",
-        ...(typeof chunk.finishReason === "string"
-          ? { finishReason: chunk.finishReason }
-          : {}),
-      };
-    case "error":
-      return {
-        type: "error",
-        error: chunk.errorText,
-      };
-    case "abort":
-      return {
-        type: "error",
-        error: String(chunk.reason || "execution aborted"),
-      };
-    default:
-      return null;
-  }
-}
-
-/**
- * 把内部 chunk 事件映射为 Session actor 事件。
- *
- * 关键点（中文）
- * - Session 级事件只保留 turn 维度所需的最小字段。
- * - `finish` 与通用 `error` 由 turn 生命周期统一表达，不在这里直接透出。
- */
-export function mapAgentEventToSessionEvent(params: {
-  /**
-   * 当前内部 chunk 事件。
-   */
-  event: InternalUiChunkEvent;
-  /**
-   * 当前 turn 标识。
-   */
-  turnId: string;
-}): AgentSessionEvent | null {
-  const { event, turnId } = params;
-  switch (event.type) {
-    case "text-delta":
-      return {
-        type: "text-delta",
-        turnId,
-        text: event.text,
-      };
-    case "reasoning-delta":
-      return {
-        type: "reasoning-delta",
-        turnId,
-        text: event.text,
-      };
-    case "tool-call":
-      return {
-        type: "tool-call",
-        turnId,
-        toolCallId: event.toolCallId,
-        toolName: event.toolName,
-        args: event.args,
-      };
-    case "tool-result":
-      return {
-        type: "tool-result",
-        turnId,
-        toolCallId: event.toolCallId,
-        toolName: event.toolName,
-        result: event.result,
-      };
-    default:
-      return null;
-  }
-}