@downcity/agent 1.1.338 → 1.1.400

package/src/executor/messages/UIMessageTransformer.ts

@@ -1,152 +0,0 @@
-/**
- * UIMessage 解析辅助。
- *
- * 关键点（中文）
- * - 这些能力属于 runtime 执行结果处理，不属于 prompts 组装
- * - 用于提取最终 assistant 文本与工具调用摘要
- */
-
-import {
-  getToolName,
-  isTextUIPart,
-  isToolUIPart,
-  type UIMessage,
-} from "ai";
-import type { SessionUserMessagePart } from "@/types/sdk/AgentSessionPrompt.js";
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-
-type ToolNameReadablePart = Parameters<typeof getToolName>[0];
-type ToolCallSummary = {
-  tool: string;
-  input: JsonObject;
-  output: string;
-};
-
-type ToolPartCompatShape = {
-  type?: string;
-  state?: string;
-  input?: JsonValue;
-  output?: unknown;
-  errorText?: unknown;
-  error?: unknown;
-  approval?: {
-    reason?: unknown;
-  };
-};
-
-function toUiParts(message: UIMessage | null | undefined): Array<SessionUserMessagePart> {
-  return Array.isArray(message?.parts) ? message.parts : [];
-}
-
-function normalizeJsonValue(value: JsonValue | object | undefined): 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);
-  }
-}
-
-function toToolInput(rawInput: JsonValue | object | undefined): JsonObject {
-  const normalized = normalizeJsonValue(rawInput);
-  if (normalized && typeof normalized === "object" && !Array.isArray(normalized)) {
-    return normalized as JsonObject;
-  }
-  return { value: normalized };
-}
-
-function resolveToolName(part: ToolPartCompatShape, aiToolName?: string): string {
-  const fromAi = String(aiToolName || "").trim();
-  if (fromAi) return fromAi;
-
-  const rawType = typeof part.type === "string" ? part.type.trim() : "";
-  if (rawType.startsWith("tool-")) return rawType.slice("tool-".length);
-
-  return "";
-}
-
-function tryReadAiToolName(part: SessionUserMessagePart): string {
-  if (!isToolUIPart(part)) return "";
-  return String(getToolName(part as ToolNameReadablePart) || "").trim();
-}
-
-function extractToolOutput(part: ToolPartCompatShape): string {
-  const state = typeof part.state === "string" ? part.state.trim() : "";
-  const outputObj =
-    state === "output-available"
-      ? part.output
-      : state === "output-error"
-        ? { error: part.errorText ?? part.error ?? "tool_error" }
-        : state === "output-denied"
-          ? { error: "tool_denied", reason: part.approval?.reason }
-          : undefined;
-  if (outputObj === undefined) return "";
-  try {
-    return JSON.stringify(outputObj);
-  } catch {
-    return String(outputObj);
-  }
-}
-
-/**
- * 从 parts 数组中提取纯文本。
- */
-export function extract_text_from_parts(
-  parts: SessionUserMessagePart[] | null | undefined,
-): string {
-  if (!Array.isArray(parts)) return "";
-  return parts
-    .filter(isTextUIPart)
-    .map((part) => String(part.text ?? ""))
-    .join("\n")
-    .trim();
-}
-
-/**
- * 从 UIMessage 中提取纯文本。
- */
-export function extract_text_from_ui_message(
-  message: UIMessage | null | undefined,
-): string {
-  const parts = toUiParts(message);
-  return parts
-    .filter(isTextUIPart)
-    .map((part) => String(part.text ?? ""))
-    .join("\n")
-    .trim();
-}
-
-/**
- * 从 UIMessage 中提取 tool 调用记录。
- */
-export function extract_tool_calls_from_ui_message(
-  message: UIMessage | null | undefined,
-): ToolCallSummary[] {
-  const parts = toUiParts(message);
-  const out: ToolCallSummary[] = [];
-
-  for (const part of parts) {
-    const partObject = part as ToolPartCompatShape;
-    const toolUiPart = isToolUIPart(part) ? part : null;
-    if (!toolUiPart) continue;
-
-    const tool_name = resolveToolName(partObject, tryReadAiToolName(part));
-    if (!tool_name) continue;
-
-    const rawInput = (part as { input?: JsonValue }).input;
-    const input = toToolInput(rawInput);
-    const output = extractToolOutput(partObject);
-
-    out.push({
-      tool: tool_name,
-      input,
-      output,
-    });
-  }
-
-  return out;
-}

package/src/executor/messages/UserVisibleText.ts

@@ -1,75 +0,0 @@
-/**
- * 从 assistant message 中提取“用户可见文本”。
- *
- * 背景（中文，关键点）
- * - 在 tool-strict 模式下，模型的 `result.text` 可能为空
- * - 真实的“最终回复”往往由 `chat_send` 工具的 input.text 决定
- * - 因此需要一个稳定的、与 Agent 解耦的提取逻辑（属于 chat/egress 语义）
- */
-
-import {
-  is_session_message_record,
-  type SessionRecordV1,
-  type SessionMessageRecordV1,
-} from "@/executor/types/SessionRecords.js";
-import {
-  extract_text_from_ui_message,
-  extract_tool_calls_from_ui_message,
-} from "./UIMessageTransformer.js";
-
-/**
- * 生成真正应该落盘到 session 的 assistant message。
- *
- * 关键点（中文）
- * - session 正式历史应尽量保留 AI SDK 最终 assistant UIMessage。
- * - 运行中 step/tool 的中断恢复由 inflight 快照承担，不再通过跳过最终 message 收口。
- */
-export function resolve_assistant_message_for_persistence(
-  message: SessionRecordV1 | null | undefined,
-): SessionMessageRecordV1 | null {
-  if (!message || typeof message !== "object") return null;
-  if (!is_session_message_record(message)) return null;
-  return message;
-}
-
-/**
- * 提取策略（中文）
- * - 倒序扫描：优先使用最后一次 `chat_send`，与最终用户感知一致。
- * - 优先使用 chat_send 的 input.text（需结合 tool output 判断成功）。
- * - 若 tool output 为空/非 JSON，走 best-effort 采用 input.text。
- * - 若无 tool call，则回退到 message 文本内容。
- */
-export function pick_last_successful_chat_send_text(
-  message: SessionRecordV1 | null | undefined,
-): string {
-  if (!is_session_message_record(message)) return "";
-  const toolCalls = extract_tool_calls_from_ui_message(message);
-  // 关键点（中文）：优先从 chat_send 的 input.text 还原"用户可见回复"。
-  for (let i = toolCalls.length - 1; i >= 0; i -= 1) {
-    const tc = toolCalls[i];
-    if (!tc) continue;
-    if (String(tc.tool || "") !== "chat_send") continue;
-
-    const inputText = tc.input ? tc.input.text : undefined;
-    const text = (typeof inputText === "string" ? inputText : "").trim();
-    if (!text) continue;
-
-    const raw = String(tc.output || "").trim();
-    if (!raw) return text; // 无输出时 best-effort 认为成功
-
-    try {
-      const parsed = JSON.parse(raw);
-      if (
-        parsed &&
-        typeof parsed === "object" &&
-        (parsed as { success?: boolean }).success === true
-      ) {
-        return text;
-      }
-    } catch {
-      // unknown format：best-effort 使用 text
-      return text;
-    }
-  }
-  return extract_text_from_ui_message(message);
-}

package/src/executor/types/SessionRecords.ts

@@ -1,217 +0,0 @@
-/**
- * SessionRecord 类型定义。
- *
- * 关键点（中文）
- * - SessionMessage 是唯一持久化事实，record 只作为 Executor、Composer 和旧 UI 的内部投影。
- * - message record 继续使用 AI SDK `UIMessage`，action record 不属于 LLM 输入。
- * - 这些类型不定义 canonical Session 存储结构。
- */
-
-import type { UIMessage } from "ai";
-import type { JsonObject } from "@/types/common/Json.js";
-
-/**
- * Session message record 类别。
- *
- * 关键点（中文）
- * - User / Assistant SessionMessage 会在执行边界临时投影为 message record。
- * - Compact Summary 同样投影为一条内部 `assistant` record。
- * - action 只用于 UI timeline，不进入 LLM 输入
- */
-export type SessionMessageKind = "normal" | "summary";
-
-/**
- * Session 消息来源类型。
- *
- * 说明（中文）
- * - `ingress`：外部输入写入的 user 消息。
- * - `egress`：模型或 agent 输出写入的 assistant 消息。
- * - `compact`：由 compact 过程生成的摘要消息。
- */
-export type SessionMessageSource =
-  | "ingress"
-  | "egress"
-  | "compact";
-
-/**
- * 入站消息细分类型。
- *
- * 说明（中文）
- * - 当前仅保留 `exec`，表示这条入站消息可触发一次 session 执行。
- */
-export type SessionIngressKind = "exec";
-
-/**
- * 摘要消息对应的原始消息范围。
- */
-export type SessionMessageSourceRangeV1 = {
-  /** 起始消息 ID。 */
-  from_id: string;
-  /** 结束消息 ID。 */
-  to_id: string;
-  /** 被覆盖的原始消息数量。 */
-  count: number;
-};
-
-/**
- * Session 消息元信息。
- */
-export type SessionMetadataV1 = {
-  /** 元信息 schema 版本号。 */
-  v: 1;
-  /** 当前消息写入时的毫秒时间戳。 */
-  ts: number;
-  /** 当前消息所属的 session ID。 */
-  session_id: string;
-  /** 当前消息所属 turn。 */
-  turn_id?: string;
-  /** 当前消息是普通消息还是摘要消息。 */
-  kind?: SessionMessageKind;
-  /** 当前消息来自入站、出站还是 compact。 */
-  source?: SessionMessageSource;
-  /** compact 摘要对应的 archive 文件 ID，用于用户历史按层读取更早消息。 */
-  archive_id?: string;
-  /** compact 摘要所覆盖的原始消息范围。 */
-  source_range?: SessionMessageSourceRangeV1;
-  /**
-   * 扩展元信息。
-   *
-   * 约定（中文）
-   * - 对 `source=ingress` 的 user 消息，可选写入 `extra.ingressKind`：
-   *   - `exec`：可触发 Session 执行的输入
-   */
-  extra?: JsonObject;
-};
-
-/**
- * 大模型可消费的 Session message record。
- */
-export type SessionMessageRecordV1 = UIMessage<SessionMetadataV1>;
-
-/**
- * Session action 当前状态。
- */
-export type SessionActionStateV1 = "running" | "completed" | "failed";
-
-/**
- * action record 元信息。
- */
-export type SessionActionMetadataV1 = {
-  /** 元信息 schema 版本号。 */
-  v: 1;
-  /** 当前 action 写入时的毫秒时间戳。 */
-  ts: number;
-  /** 当前 action 所属的 session ID。 */
-  session_id: string;
-  /** 当前 action 关联的 turn 标识。 */
-  turn_id?: string;
-};
-
-/**
- * action 类型的 Session record 结构。
- *
- * 关键点（中文）
- * - `action` 不是 AI SDK 原生 message record。
- * - 它只存在于 session records 与前端 timeline，进入 LLM 前必须过滤。
- */
-export type SessionActionRecordV1 = {
-  /** record 类型固定为 `action`。 */
-  type: "action";
-  /** 同一个 action 生命周期内稳定复用的 ID。 */
-  id: string;
-  /** 当前 action 标题。 */
-  title: string;
-  /** 当前 action 描述。 */
-  description?: string;
-  /** 当前 action 状态。 */
-  state: SessionActionStateV1;
-  /** action 元信息。 */
-  metadata: SessionActionMetadataV1;
-};
-
-/**
- * 构造 action record 的输入结构。
- */
-export type SessionActionRecordInputV1 = {
-  /** 同一个 action 生命周期内稳定复用的 ID。 */
-  id?: string;
-  /** 当前 action 标题。 */
-  title: string;
-  /** 当前 action 描述。 */
-  description?: string;
-  /** 当前 action 状态。 */
-  state: SessionActionStateV1;
-  /** 当前 action 关联的 turn 标识。 */
-  turn_id?: string;
-  /** 可选 action 元信息覆盖。 */
-  metadata?: Partial<SessionActionMetadataV1>;
-};
-
-/**
- * Session 持久化 record 结构。
- *
- * 说明（中文）
- * - message record 是可进入 LLM 的 record。
- * - action record 是只给前端展示的 record，组装模型输入前必须过滤。
- */
-export type SessionRecordV1 = SessionMessageRecordV1 | SessionActionRecordV1;
-
-/**
- * user 角色的 Session message record。
- */
-export type SessionUserMessageV1 = SessionMessageRecordV1 & {
-  /** 消息角色固定为 `user`。 */
-  role: "user";
-};
-
-/**
- * 判断一条 record 是否为 action record。
- */
-export function is_session_action_record(
-  message: SessionRecordV1 | null | undefined,
-): message is SessionActionRecordV1 {
-  if (!message || typeof message !== "object") return false;
-  return (message as { type?: unknown }).type === "action";
-}
-
-/**
- * 从订阅事件构造 action record。
- */
-export function to_session_action_record(
-  action: SessionActionRecordInputV1 | SessionActionRecordV1,
-  session_id: string,
-): SessionActionRecordV1 {
-  const title = String(action.title || "").trim() || "Action";
-  const description = String(action.description || "").trim();
-  const id = String(action.id || "").trim() || `action:${session_id}:${Date.now()}`;
-  const metadata =
-    "metadata" in action && action.metadata && typeof action.metadata === "object"
-      ? action.metadata
-      : {};
-  const turn_id =
-    String(metadata.turn_id || "").trim() ||
-    ("turn_id" in action ? String(action.turn_id || "").trim() : "");
-  return {
-    type: "action",
-    id,
-    title,
-    ...(description ? { description } : {}),
-    state: action.state,
-    metadata: {
-      v: 1,
-      ts: typeof metadata.ts === "number" ? metadata.ts : Date.now(),
-      session_id: String(metadata.session_id || "").trim() || session_id,
-      ...(turn_id ? { turn_id: turn_id } : {}),
-    },
-  };
-}
-
-/**
- * 判断一条 record 是否为大模型可消费的 message record。
- */
-export function is_session_message_record(
-  message: SessionRecordV1 | null | undefined,
-): message is SessionMessageRecordV1 {
-  if (!message || typeof message !== "object") return false;
-  return !is_session_action_record(message);
-}

package/src/plugin/core/PluginActionRunner.ts

@@ -1,36 +0,0 @@
-/**
- * Plugin Action 解析与执行辅助。
- *
- * 关键点（中文）：Plugin 对外调用协议只有 Action，不再提供 command 兼容层。
- */
-
-import type { PluginContext } from "@/types/plugin/PluginContext.js";
-import type { PluginAction, PluginActionResult } from "@/types/plugin/PluginAction.js";
-import type { JsonValue } from "@/types/common/Json.js";
-
-/** 按名称解析一个 Plugin Action。 */
-export function resolve_plugin_action(
-  plugin: { actions?: Record<string, PluginAction<JsonValue, JsonValue>> },
-  action_name: string,
-): PluginAction<JsonValue, JsonValue> | null {
-  const key = String(action_name || "").trim();
-  return key ? plugin.actions?.[key] ?? null : null;
-}
-
-/** 通过当前 Plugin Registry 执行一个 Action。 */
-export async function invoke_plugin_action(params: {
-  /** Plugin 稳定名称。 */
-  plugin_name: string;
-  /** Action 稳定名称。 */
-  action_name: string;
-  /** 可选 JSON 输入。 */
-  payload?: JsonValue;
-  /** 当前 Agent Plugin Context。 */
-  context: PluginContext;
-}): Promise<PluginActionResult<JsonValue>> {
-  return await params.context.plugins.run_action({
-    plugin: params.plugin_name,
-    action: params.action_name,
-    payload: params.payload,
-  });
-}