@downcity/agent 1.1.338 → 1.1.400

package/scripts/openai-responses-continuation.test.mjs

@@ -1,78 +0,0 @@
-/**
- * @file 验证 Session 使用完整工具事务续接 OpenAI Responses。
- */
-
-import test from "node:test";
-import assert from "node:assert/strict";
-import { createOpenAI } from "@ai-sdk/openai";
-import { convertToModelMessages } from "ai";
-
-/** 捕获 AI SDK 在指定 store 策略下生成的 Responses 请求体。 */
-async function capture_request_body(store) {
-  let request_body;
-  const openai = createOpenAI({
-    apiKey: "test-api-key",
-    fetch: async (_url, init) => {
-      request_body = JSON.parse(String(init.body));
-      throw new Error("request captured");
-    },
-  });
-  const messages = await convertToModelMessages([{
-    role: "assistant",
-    parts: [{
-      type: "dynamic-tool",
-      toolName: "lookup",
-      toolCallId: "call_1",
-      state: "output-available",
-      input: { q: "x" },
-      output: "ok",
-      callProviderMetadata: { openai: { itemId: "fc_1" } },
-    }],
-  }]);
-
-  await assert.rejects(
-    openai.responses("gpt-5").doGenerate({
-      prompt: messages,
-      providerOptions: { openai: { store } },
-    }),
-    /request captured/,
-  );
-  return request_body;
-}
-
-test("Responses store=false 发送完整 function_call", async () => {
-  const request_body = await capture_request_body(false);
-  assert.deepEqual(request_body.input, [
-    {
-      type: "function_call",
-      call_id: "call_1",
-      name: "lookup",
-      arguments: "{\"q\":\"x\"}",
-      id: "fc_1",
-    },
-    {
-      type: "function_call_output",
-      call_id: "call_1",
-      output: "ok",
-    },
-  ]);
-  assert.equal(
-    request_body.input.some((item) => item.type === "item_reference"),
-    false,
-  );
-});
-
-test("Responses store=true 使用已存储 item_reference", async () => {
-  const request_body = await capture_request_body(true);
-  assert.deepEqual(request_body.input, [
-    {
-      type: "item_reference",
-      id: "fc_1",
-    },
-    {
-      type: "function_call_output",
-      call_id: "call_1",
-      output: "ok",
-    },
-  ]);
-});

package/src/agent/AgentState.ts

@@ -1,96 +0,0 @@
-/**
- * AgentState：本地 Agent 长期运行状态与生命周期。
- *
- * 职责说明（中文）
- * - 统一连接 PluginRegistry 与 PluginContext。
- * - 持有 Plugin lifecycle 与 ActionSchedule 的启动状态。
- * - Agent 构造完成后立即开始启动，调用方通过 `ready()` 等待。
- * - Agent 释放时统一停止 ActionSchedule 与 Plugin lifecycle。
- * - RPC / HTTP 等 transport 不属于 AgentState，由上游宿主独立管理。
- */
-
-import type { PluginContext } from "@/types/plugin/PluginContext.js";
-import type { PluginRegistry } from "@/plugin/core/PluginRegistry.js";
-import type { AgentStateOptions } from "@/types/agent/AgentState.js";
-import {
-  start_action_schedule_runtime,
-  type ActionScheduleRuntimeHandle,
-} from "@/plugin/core/ActionScheduleRuntime.js";
-
-/**
- * 本地 Agent 长期运行状态。
- */
-export class AgentState {
-  /** 当前 Agent 共用的执行上下文。 */
-  private readonly context: PluginContext;
-
-  /** 当前 Agent 唯一的 PluginRegistry 实例。 */
-  private readonly plugins: PluginRegistry;
-
-  /** Plugin lifecycle 与 ActionSchedule 的唯一启动 Promise。 */
-  private readonly ready_promise: Promise<void>;
-
-  /** Plugin lifecycle 是否已经完成启动流程。 */
-  private plugins_started = false;
-
-  /** 当前 Agent 持有的 ActionSchedule 轮询运行时。 */
-  private action_schedule_runtime: ActionScheduleRuntimeHandle | null = null;
-
-  constructor(options: AgentStateOptions) {
-    this.context = options.context;
-    this.plugins = options.plugins;
-    this.plugins.bind_context(this.context);
-    this.ready_promise = this.start_runtime();
-  }
-
-  /**
-   * 等待当前 Agent 持有的长期运行时启动完成。
-   */
-  async ready(): Promise<void> {
-    await this.ready_promise;
-  }
-
-  /**
-   * 释放当前 Agent 持有的长期运行时对象。
-   */
-  async dispose(): Promise<void> {
-    await this.ready_promise.catch(() => undefined);
-    this.action_schedule_runtime?.stop();
-    this.action_schedule_runtime = null;
-    if (this.plugins_started) {
-      await this.context.plugins.unregister_all();
-      this.plugins_started = false;
-    }
-  }
-
-  /**
-   * 启动 Plugin lifecycle 与 ActionSchedule。
-   *
-   * 关键点（中文）
-   * - Plugin lifecycle 先启动，避免到期任务调用未就绪的 Plugin。
-   * - 单个 Plugin 启动失败由 PluginRegistry 隔离，只记录错误并继续启动 Agent。
-   * - ActionSchedule 启动失败不阻断 Agent ready。
-   */
-  private async start_runtime(): Promise<void> {
-    const snapshots = await this.plugins.start_all();
-    this.plugins_started = true;
-    for (const item of snapshots) {
-      if (item.status === "error") {
-        this.context.logger.error(
-          `Plugin start failed: ${item.name} - ${item.last_error || "unknown error"}`,
-        );
-      }
-    }
-
-    try {
-      this.action_schedule_runtime = await start_action_schedule_runtime(
-        this.context,
-      );
-    } catch (error) {
-      this.context.logger.error(
-        `ActionSchedule start failed: ${String(error)}`,
-      );
-    }
-  }
-
-}

package/src/executor/core-engine/CoreEngineUiStreamCollector.ts

@@ -1,136 +0,0 @@
-/**
- * Session UI stream 最终消息收敛器。
- *
- * 关键点（中文）
- * - 必须完整消费 AI SDK UI stream，才能稳定触发 `onFinish`。
- * - 优先使用结构化 `responseMessage`；缺失时才回退到纯文本。
- * - UI chunk 回调负责上层 canonical message 写入，失败必须终止本轮收敛。
- */
-
-import type { streamText } from "ai";
-import type { Logger } from "@/utils/logger/Logger.js";
-import type { JsonObject } from "@/types/common/Json.js";
-import type { SessionMessageRecordV1 } from "@/executor/types/SessionRecords.js";
-import type { SessionUiMessageChunkCallback } from "@/types/session/SessionExecution.js";
-import { generate_id } from "@/utils/Id.js";
-import {
-  summarize_ui_message_for_debug,
-  to_inline_preview,
-} from "@executor/core-engine/CoreEngineSignals.js";
-
-/**
- * 收敛 UI stream 中的最终 assistant 消息。
- */
-export async function collect_final_assistant_message_from_ui_stream(params: {
-  /**
-   * 当前 `streamText` 执行结果。
-   */
-  result: ReturnType<typeof streamText>;
-  /**
-   * 当前 session_id，用于日志关联。
-   */
-  session_id: string;
-  /**
-   * 当前日志器。
-   */
-  logger: Logger;
-  /**
-   * 构造 fallback assistant 消息的工厂函数。
-   */
-  buildFallbackAssistantMessage: (text: string) => SessionMessageRecordV1;
-  /** 当前 Turn 已收敛的 Assistant 消息；原生审批恢复时用于重建已有 Tool Part。 */
-  original_messages?: SessionMessageRecordV1[];
-  /**
-   * UI stream chunk 回调。
-   */
-  on_ui_message_chunk_callback?: SessionUiMessageChunkCallback;
-  /**
-   * 当前 turn 的取消信号。
-   *
-   * 关键点（中文）
-   * - stop 触发后，UI stream 可能在 onFinish 前中断。
-   * - 此时仍应尽量用已经收到的 text delta 构造可持久化 assistant 消息。
-   */
-  abort_signal?: AbortSignal;
-}): Promise<SessionMessageRecordV1> {
-  let streamedAssistantMessage: SessionMessageRecordV1 | null = null;
-  let uiFinishSummary: JsonObject | null = null;
-  let streamed_text = "";
-  let callback_failed = false;
-
-  const uiStream = params.result.toUIMessageStream<SessionMessageRecordV1>({
-    // 关键点（中文）：SDK stream 需要 reasoning 旁路事件时可直接消费；最终落盘仍由 responseMessage 收敛。
-    originalMessages: params.original_messages,
-    generateMessageId: () => `a:${params.session_id}:${generate_id()}`,
-    messageMetadata: ({ part }) => {
-      if (part.type !== "start" && part.type !== "finish") return undefined;
-      return {
-        v: 1,
-        ts: Date.now(),
-        session_id: params.session_id,
-        source: "egress",
-        kind: "normal",
-      };
-    },
-    sendReasoning: true,
-    sendSources: false,
-    onFinish: (event) => {
-      streamedAssistantMessage = event.responseMessage ?? null;
-      uiFinishSummary = {
-        isContinuation: event.isContinuation,
-        isAborted: event.isAborted,
-        finishReason:
-          typeof event.finishReason === "string" ? event.finishReason : null,
-        ...summarize_ui_message_for_debug(event.responseMessage),
-      };
-    },
-  });
-
-  try {
-    for await (const chunk of uiStream) {
-      if (chunk.type === "text-delta") {
-        streamed_text += String(chunk.delta || "");
-      }
-      if (typeof params.on_ui_message_chunk_callback !== "function") continue;
-      try {
-        await params.on_ui_message_chunk_callback(chunk);
-      } catch (error) {
-        callback_failed = true;
-        throw error;
-      }
-    }
-  } catch (error) {
-    if (callback_failed || !params.abort_signal?.aborted) {
-      throw error;
-    }
-  }
-
-  await params.logger.log("info", "[agent] ui.finish", {
-    session_id: params.session_id,
-    ...(uiFinishSummary || {
-      responseMessageMissing: true,
-    }),
-  });
-
-  if (streamedAssistantMessage) return streamedAssistantMessage;
-
-  let assistantText = "";
-  try {
-    assistantText = String((await params.result.text) ?? "").trim();
-  } catch {
-    assistantText = "";
-  }
-  if (!assistantText) {
-    assistantText = streamed_text.trim();
-  }
-
-  await params.logger.log("warn", "[agent] final.message.fallback", {
-    session_id: params.session_id,
-    assistantTextLength: assistantText.length,
-    assistantTextPreview: to_inline_preview(assistantText),
-  });
-
-  return params.buildFallbackAssistantMessage(
-    assistantText || "Execution completed",
-  );
-}

package/src/executor/messages/SessionMessageCodec.ts

@@ -1,106 +0,0 @@
-/**
- * SessionMessageCodec：session message 与模型 message 的转换模块。
- *
- * 关键点（中文）
- * - 只负责消息筛选与模型消息转换。
- * - 附件注入下沉到 `SessionAttachmentMapper`。
- * - 日志提取与输出下沉到 `SessionMessageLog`。
- */
-
-import {
-  convertToModelMessages,
-  type ModelMessage,
-  type Tool,
-  type ToolSet,
-} from "ai";
-import {
-  is_session_message_record,
-  type SessionRecordV1,
-} from "@/executor/types/SessionRecords.js";
-import {
-  hydrate_file_url_parts_for_model,
-  inject_file_parts_from_attachments,
-} from "@executor/messages/SessionAttachmentMapper.js";
-
-/**
- * 过滤 Step 检查点返回的有效 User 消息。
- *
- * 关键点（中文）
- * - 用途：从运行期注入与 Session Queue 中挑出可并入推理上下文的 User 消息。
- * - 输入：任意 SessionRecordV1[]（可能混有 assistant/tool/action/空消息）。
- * - 输出：包含非空文本或任意其他 UI Part 的 User 消息数组。
- */
-export function pick_merged_user_messages(
-  messages: SessionRecordV1[],
-): SessionRecordV1[] {
-  // 如果不是数组，直接返回空数组，避免后续 filter 报错。
-  if (!Array.isArray(messages)) return [];
-
-  // 逐条过滤消息。
-  return messages.filter((message) => {
-    // 防御 1：消息必须是对象。
-    if (!is_session_message_record(message)) return false;
-
-    // 防御 2：只接受 user 角色。
-    if (message.role !== "user") return false;
-
-    // 防御 3：parts 必须是数组。
-    if (!Array.isArray(message.parts)) return false;
-
-    // 空文本不单独构成输入；File、Data 等非文本 Part 本身就是有效内容。
-    return message.parts.some((part) =>
-      part.type !== "text" || String(part.text ?? "").trim().length > 0
-    );
-  });
-}
-
-/**
- * 将 context 消息转换为模型消息。
- *
- * 关键点（中文）
- * - 用途：把 UIMessage 语义层数据转成模型可消费的 ModelMessage[]。
- * - 输入：context 消息数组 + 可用工具集合。
- * - 输出：可直接喂给 streamText 的 messages。
- */
-export async function to_model_messages(
-  messages: SessionRecordV1[],
-  tools: Record<string, Tool>,
-  project_root?: string,
-): Promise<ModelMessage[]> {
-  // 空输入快速返回，避免调用转换器的额外开销。
-  if (!Array.isArray(messages) || messages.length === 0) return [];
-
-  // action record 只服务前端时间线，不能传入模型。
-  const model_messages = messages.filter(is_session_message_record);
-  if (model_messages.length === 0) return [];
-
-  // 第一步（中文）：在 user 消息上注入 file parts（多模态附件）。
-  const enrichedMessages = await inject_file_parts_from_attachments(
-    model_messages,
-    project_root,
-  );
-
-  // 第二步（中文）：把历史里的本地文件 URL 在内存中 hydrate 成模型可消费的 data URL。
-  const hydratedMessages = await hydrate_file_url_parts_for_model(
-    enrichedMessages,
-    project_root,
-  );
-
-  // 第三步（中文）：转换前先剔除 UI 层 id 字段，仅保留模型需要的数据结构。
-  const input = hydratedMessages.map((message) => {
-    // 解构去掉 id。
-    const { id: _id, ...rest } = message;
-
-    // 返回剩余字段。
-    return rest;
-  });
-
-  // 调用 ai-sdk 的转换函数。
-  const converted_messages = await convertToModelMessages(input, {
-    // 如果当前轮有工具，就把工具注入转换选项。
-    ...(tools && Object.keys(tools).length > 0 ? { tools: tools as ToolSet } : {}),
-    // 忽略历史里的不完整工具调用，提升容错性。
-    ignoreIncompleteToolCalls: true,
-  });
-  return converted_messages;
-}

package/src/executor/messages/SessionStepEventMapper.ts

@@ -1,191 +0,0 @@
-/**
- * SessionStepEventMapper：把单个 step 结果转成 assistant parts。
- *
- * 关键点（中文）
- * - 运行过程仍然要持久化，但收口到同一条 assistant UIMessage。
- * - 工具结果使用 AI SDK v6 UI tool part 格式，和官方 UIMessage 语义保持一致。
- * - 每个 step 前插入 `step-start`，便于在 UI 中保留多 step 边界。
- */
-
-import type { SessionMessageRecordV1 } from "@/executor/types/SessionRecords.js";
-
-type UnknownRecord = Record<string, unknown>;
-
-function toRecord(value: unknown): UnknownRecord | null {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-  return value as UnknownRecord;
-}
-
-function resolveToolName(value: unknown): string {
-  const record = toRecord(value);
-  if (!record) return "";
-  const tool_name =
-    typeof record.toolName === "string"
-      ? record.toolName
-      : typeof record.tool === "string"
-        ? record.tool
-        : typeof record.name === "string"
-          ? record.name
-          : "";
-  return String(tool_name || "").trim();
-}
-
-function resolveToolCallId(value: unknown): string {
-  const record = toRecord(value);
-  if (!record) return "";
-  const toolCallId =
-    typeof record.toolCallId === "string"
-      ? record.toolCallId
-      : typeof record.id === "string"
-        ? record.id
-        : "";
-  return String(toolCallId || "").trim();
-}
-
-function resolveToolCallInput(value: unknown): unknown {
-  const record = toRecord(value);
-  if (!record) return undefined;
-  if ("input" in record) return record.input;
-  if ("rawInput" in record) return record.rawInput;
-  if ("arguments" in record) return record.arguments;
-  if ("args" in record) return record.args;
-  return undefined;
-}
-
-function resolveToolResultPayload(value: unknown): unknown {
-  const record = toRecord(value);
-  if (!record) return undefined;
-  if ("result" in record) return record.result;
-  if ("output" in record) return record.output;
-  if ("errorText" in record) return record.errorText;
-  if ("error" in record) return record.error;
-  return undefined;
-}
-
-function resolveToolResultErrorText(value: unknown): string | undefined {
-  const record = toRecord(value);
-  if (!record) return undefined;
-  if (typeof record.errorText === "string" && record.errorText.trim()) {
-    return record.errorText.trim();
-  }
-  if (typeof record.error === "string" && record.error.trim()) {
-    return record.error.trim();
-  }
-  if (record.error instanceof Error && record.error.message.trim()) {
-    return record.error.message.trim();
-  }
-  return undefined;
-}
-
-function mapToolResultsByCallId(toolResults: unknown[]): Map<string, unknown> {
-  const out = new Map<string, unknown>();
-  for (const toolResult of toolResults) {
-    const toolCallId = resolveToolCallId(toolResult);
-    if (!toolCallId) continue;
-    out.set(toolCallId, toolResult);
-  }
-  return out;
-}
-
-function resolveAcpEventType(value: unknown): string {
-  const record = toRecord(value);
-  const type = typeof record?.type === "string" ? record.type : "";
-  return type.trim();
-}
-
-function resolveAcpEventData(value: unknown): unknown {
-  const record = toRecord(value);
-  if (!record) return value;
-  if ("data" in record) return record.data;
-  return record;
-}
-
-function toDataPartType(type: string): string {
-  return `data-acp-${type.replace(/_/g, "-")}`;
-}
-
-/**
- * 从 step_result 提取按顺序写入同一条 assistant message 的 parts。
- */
-export function build_session_step_parts(params: {
-  step_index: number;
-  step_result?: unknown;
-  text: string;
-  visibility?: "visible" | "internal";
-}): SessionMessageRecordV1["parts"] {
-  const out: SessionMessageRecordV1["parts"] = [];
-  const stepRecord = toRecord(params.step_result) || {};
-  const toolCalls = Array.isArray(stepRecord.toolCalls) ? stepRecord.toolCalls : [];
-  const toolResults = Array.isArray(stepRecord.toolResults)
-    ? stepRecord.toolResults
-    : [];
-  const toolResultsByCallId = mapToolResultsByCallId(toolResults);
-  const acpEvents = Array.isArray(stepRecord.acpEvents)
-    ? stepRecord.acpEvents
-    : [];
-
-  const text = String(params.text || "").trim();
-  const has_structured_output =
-    Boolean(text) || toolCalls.length > 0 || acpEvents.length > 0;
-  if (!has_structured_output) return [];
-
-  out.push({ type: "step-start" });
-
-  if (text) {
-    const isInternal = params.visibility === "internal";
-    out.push(
-      isInternal
-        ? {
-            type: "reasoning",
-            text,
-            state: "done",
-          }
-        : {
-            type: "text",
-            text,
-            state: "done",
-          },
-    );
-  }
-
-  for (let index = 0; index < toolCalls.length; index += 1) {
-    const toolCall = toolCalls[index];
-    const tool_name = resolveToolName(toolCall) || "unknown_tool";
-    const toolCallId = resolveToolCallId(toolCall);
-    const input = resolveToolCallInput(toolCall);
-    const toolResult = toolCallId ? toolResultsByCallId.get(toolCallId) : undefined;
-    if (!toolResult) continue;
-    const output = resolveToolResultPayload(toolResult);
-    const errorText = resolveToolResultErrorText(toolResult);
-    out.push(
-      {
-        type: `tool-${tool_name}`,
-        ...(toolCallId ? { toolCallId } : {}),
-        ...(input !== undefined ? { input } : {}),
-        ...(errorText
-          ? {
-              state: "output-error",
-              errorText,
-            }
-          : {
-              state: "output-available",
-              output,
-            }),
-      } as SessionMessageRecordV1["parts"][number],
-    );
-  }
-
-  for (let index = 0; index < acpEvents.length; index += 1) {
-    const acpEvent = acpEvents[index];
-    const type = resolveAcpEventType(acpEvent);
-    if (!type) continue;
-    out.push(
-      {
-        type: toDataPartType(type),
-        data: resolveAcpEventData(acpEvent),
-      } as SessionMessageRecordV1["parts"][number],
-    );
-  }
-
-  return out;
-}