@downcity/agent 1.1.287 → 1.1.310

package/src/executor/tools/plugin/PluginToolBridge.ts

@@ -1,212 +0,0 @@
-/**
- * Plugin tool 运行时桥接。
- *
- * 关键点（中文）
- * - tool 层不直接持有 agent 或 plugin registry，只通过装配期注入的 AgentPlugins 调用 action。
- * - 如果 action 返回 AI SDK UIMessage，则抽取 file parts 并入最终 assistant 消息。
- * - 返回给模型的 tool result 只保留短摘要和本地绝对路径，避免 data URL 等大内容污染上下文。
- */
-
-import path from "node:path";
-import type { FileUIPart } from "ai";
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-import type {
-  PluginCallInput,
-  PluginCallToolFileResult,
-  PluginCallToolResult,
-  PluginReadInput,
-  PluginReadToolResult,
-} from "@/executor/tools/plugin/types/PluginTool.js";
-import type {
-  InvokePluginCallToolOptions,
-  InvokePluginReadToolOptions,
-} from "@/types/plugin/PluginToolRuntime.js";
-import {
-  materializeAssistantFileParts,
-  resolveAgentFilePath,
-} from "@executor/messages/AssistantFileResource.js";
-
-/**
- * 判断值是否为普通对象。
- */
-function to_json_object(value: unknown): JsonObject | null {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-  return value as JsonObject;
-}
-
-/**
- * 判断 UI part 是否为 file part。
- */
-function is_file_part(value: unknown): value is FileUIPart {
-  const record = to_json_object(value);
-  if (!record) return false;
-  return (
-    record.type === "file" &&
-    typeof record.mediaType === "string" &&
-    typeof record.url === "string"
-  );
-}
-
-/**
- * 从 action data 中抽取可落盘的 assistant file parts。
- */
-function extract_assistant_file_parts(data: JsonValue | undefined): FileUIPart[] {
-  const message = to_json_object(data);
-  const parts: unknown[] = Array.isArray(message?.parts) ? message.parts : [];
-  return parts.filter(is_file_part);
-}
-
-/**
- * 解析当前项目根目录，保持与 assistant 文件落盘逻辑一致。
- */
-function resolve_project_root(project_root: string | undefined): string {
-  const raw = String(project_root || "").trim();
-  return path.resolve(raw || process.cwd());
-}
-
-/**
- * 构建返回给模型和用户可见的文件摘要。
- */
-function summarize_materialized_files(
-  parts: FileUIPart[],
-  project_root: string,
-): PluginCallToolFileResult[] {
-  return parts.map((part, index) => {
-    const relative_path = String(part.url || "");
-    return {
-      index,
-      media_type: part.mediaType,
-      filename: typeof part.filename === "string" ? part.filename : "",
-      relative_path,
-      path: resolveAgentFilePath({
-        projectRoot: project_root,
-        filePath: relative_path,
-      }),
-    };
-  });
-}
-
-/**
- * 生成给模型读取的短摘要。
- */
-function summarize_action_data(data: JsonValue | undefined): JsonObject | undefined {
-  const message = to_json_object(data);
-  const parts: unknown[] = Array.isArray(message?.parts) ? message.parts : [];
-  if (parts.length > 0) {
-    return undefined;
-  }
-  if (data === undefined) return {};
-  return {
-    kind: "json",
-    value: data,
-  };
-}
-
-/**
- * 调用 plugin action 并桥接最终 assistant file parts。
- */
-export async function invokePluginCallTool(
-  params: InvokePluginCallToolOptions,
-): Promise<PluginCallToolResult> {
-  const input: PluginCallInput = params.input;
-  const plugin = String(input.plugin || "").trim();
-  const action = String(input.action || "").trim();
-  const payload = to_json_object(input.payload ?? {}) ?? {};
-  if (!plugin) {
-    return {
-      success: false,
-      plugin,
-      action,
-      assistant_file_count: 0,
-      message: "plugin is required",
-      error: "plugin is required",
-    };
-  }
-  if (!action) {
-    return {
-      success: false,
-      plugin,
-      action,
-      assistant_file_count: 0,
-      message: "action is required",
-      error: "action is required",
-    };
-  }
-
-  try {
-    const run_context = params.run_context;
-    const plugins = run_context.agentPlugins || params.plugins;
-    const result = await plugins.runAction({
-      plugin,
-      action,
-      payload,
-      run_context,
-    });
-    const project_root = resolve_project_root(run_context.projectRoot);
-    const raw_file_parts = result.success
-      ? extract_assistant_file_parts(result.data)
-      : [];
-    const file_parts =
-      raw_file_parts.length > 0
-        ? await materializeAssistantFileParts({
-            projectRoot: project_root,
-            parts: raw_file_parts,
-          })
-        : [];
-    const files = summarize_materialized_files(file_parts, project_root);
-    if (file_parts.length > 0) {
-      run_context.pendingAssistantFileParts.push(...file_parts);
-    }
-    const data = summarize_action_data(result.data);
-    return {
-      success: result.success,
-      plugin,
-      action,
-      assistant_file_count: file_parts.length,
-      ...(files.length > 0 ? { files } : {}),
-      message:
-        String(result.message || result.error || "").trim() ||
-        (result.success ? "plugin action completed" : "plugin action failed"),
-      ...(result.error ? { error: result.error } : {}),
-      ...(data === undefined ? {} : { data }),
-    };
-  } catch (error) {
-    return {
-      success: false,
-      plugin,
-      action,
-      assistant_file_count: 0,
-      message: String(error),
-      error: String(error),
-    };
-  }
-}
-
-/**
- * 读取 plugin / action metadata。
- */
-export async function invokePluginReadTool(
-  params: InvokePluginReadToolOptions,
-): Promise<PluginReadToolResult> {
-  const input: PluginReadInput = params.input;
-  try {
-    const plugins = params.run_context.agentPlugins || params.plugins;
-    const data = plugins.read({
-      plugin: typeof input.plugin === "string" ? input.plugin : undefined,
-      action: typeof input.action === "string" ? input.action : undefined,
-    });
-    return {
-      success: true,
-      message: "plugin metadata read",
-      data: data as unknown as JsonObject,
-    };
-  } catch (error) {
-    return {
-      success: false,
-      message: String(error),
-      data: {
-        error: String(error),
-      },
-    };
-  }
-}

package/src/executor/types/SessionExecutor.ts

@@ -1,34 +0,0 @@
-/**
- * SessionExecutor 抽象类型。
- *
- * 关键点（中文）
- * - 统一表达“某个 session 的实际执行器”。
- * - 当前只有 api 执行模式。
- */
-
-import type { SessionRunInput, SessionRunResult } from "@/executor/types/SessionRun.js";
-
-/**
- * 单个 session 执行器接口。
- */
-export interface SessionExecutor {
-  /**
-   * 执行一次 session run。
-   */
-  run(input: SessionRunInput): Promise<SessionRunResult>;
-
-  /**
-   * 请求取消当前正在执行的 turn。
-   *
-   * 关键点（中文）
-   * - `session.stop()` 会调用这里终止当前模型流与 tool-loop。
-   * - 返回 `true` 表示本次请求已发出；`false` 表示当前没有可取消的 turn。
-   */
-  stop(): boolean;
-
-  /**
-   * 释放执行器持有的资源。
-   *
-   * 说明（中文）
-   */
-}

package/src/plugin/core/PluginCommand.ts

@@ -1,230 +0,0 @@
-/**
- * PluginCommand：通用 plugin action CLI 注册器。
- *
- * 关键点（中文）
- * - 这里只把调用方传入的 plugin actions 挂到 commander。
- * - 是否传入某类 plugin 由宿主决定，agent 不内置任何 plugin 清单。
- */
-
-import path from "node:path";
-import type { Command } from "commander";
-import type { JsonObject, JsonValue } from "@/types/common/Json.js";
-import type { Plugin } from "@/types/plugin/PluginDefinition.js";
-import type { PluginAction } from "@/types/plugin/PluginAction.js";
-import { runLocalPluginAction } from "@/plugin/core/PluginLocalExecution.js";
-import { printResult } from "@/utils/cli/CliOutput.js";
-
-type PluginCliBridgeOptions = {
-  /**
-   * 项目根目录。
-   */
-  path?: string;
-  /**
-   * 是否以 JSON 输出。
-   */
-  json?: boolean;
-};
-
-function resolveProjectRoot(pathInput?: string): string {
-  return path.resolve(String(pathInput || "."));
-}
-
-function toJsonValue(input: unknown): JsonValue | undefined {
-  if (input === null) return null;
-  if (typeof input === "string") return input;
-  if (typeof input === "number") {
-    return Number.isFinite(input) ? input : undefined;
-  }
-  if (typeof input === "boolean") return input;
-  if (Array.isArray(input)) {
-    const values: JsonValue[] = [];
-    for (const item of input) {
-      const value = toJsonValue(item);
-      if (value === undefined) continue;
-      values.push(value);
-    }
-    return values;
-  }
-  if (typeof input === "object" && input) {
-    const output: JsonObject = {};
-    for (const [key, value] of Object.entries(
-      input as Record<string, unknown>,
-    )) {
-      const normalized = toJsonValue(value);
-      if (normalized === undefined) continue;
-      output[key] = normalized;
-    }
-    return output;
-  }
-  return undefined;
-}
-
-function toPluginActionCommandOpts(
-  options: Record<string, unknown>,
-): Record<string, JsonValue> {
-  const reservedKeys = new Set(["path", "host", "port", "token", "json"]);
-  const normalized: Record<string, JsonValue> = {};
-  for (const [key, value] of Object.entries(options)) {
-    if (reservedKeys.has(key)) continue;
-    const nextValue = toJsonValue(value);
-    if (nextValue === undefined) continue;
-    normalized[key] = nextValue;
-  }
-  return normalized;
-}
-
-function toPluginCliBridgeOptions(
-  options: Record<string, unknown>,
-): PluginCliBridgeOptions {
-  return {
-    path: typeof options.path === "string" ? options.path : ".",
-    json: options.json !== false,
-  };
-}
-
-function flattenPluginActionCommandArgs(values: unknown[]): string[] {
-  const out: string[] = [];
-  const pushValue = (value: unknown): void => {
-    if (value === undefined || value === null) return;
-    if (Array.isArray(value)) {
-      for (const item of value) pushValue(item);
-      return;
-    }
-    const text = String(value).trim();
-    if (!text) return;
-    out.push(text);
-  };
-  for (const value of values) pushValue(value);
-  return out;
-}
-
-function isCommanderCommandLike(value: unknown): value is Command {
-  return Boolean(
-    value &&
-      typeof value === "object" &&
-      typeof (value as { opts?: unknown }).opts === "function",
-  );
-}
-
-function isPlainOptionsObject(
-  value: unknown,
-): value is Record<string, unknown> {
-  return Boolean(
-    value &&
-      typeof value === "object" &&
-      !Array.isArray(value) &&
-      typeof (value as { opts?: unknown }).opts !== "function",
-  );
-}
-
-function registerPluginActionCommand(params: {
-  program: Command;
-  plugins: Plugin[];
-  plugin: Plugin;
-  actionName: string;
-  action: PluginAction<JsonValue, JsonValue>;
-}): void {
-  const commandSpec = params.action.command;
-  if (!commandSpec) return;
-
-  const pluginCommand =
-    params.program.commands.find((item) => item.name() === params.plugin.name) ||
-    params.program
-      .command(params.plugin.name)
-      .description(`${params.plugin.name} plugin actions`)
-      .helpOption("--help", "display help for command");
-
-  const actionCommand = pluginCommand
-    .command(params.actionName)
-    .description(commandSpec.description)
-    .helpOption("--help", "display help for command")
-    .option("--path <path>", "项目根目录（默认当前目录）", ".")
-    .option("--json [enabled]", "以 JSON 输出", true);
-
-  commandSpec.configure?.(actionCommand);
-
-  actionCommand.action(async (...rawArgs: unknown[]) => {
-    const last = rawArgs.at(-1);
-    const commandLike = isCommanderCommandLike(last) ? last : null;
-    const positionalArgs = commandLike
-      ? flattenPluginActionCommandArgs(
-          Array.isArray(commandLike.processedArgs)
-            ? (commandLike.processedArgs as unknown[])
-            : [],
-        )
-      : (() => {
-          const fallbackLast = rawArgs.at(-1);
-          const fallbackPositional = isPlainOptionsObject(fallbackLast)
-            ? rawArgs.slice(0, -1)
-            : rawArgs;
-          return flattenPluginActionCommandArgs(fallbackPositional);
-        })();
-    const allOptions = commandLike
-      ? ((commandLike.opts() as Record<string, unknown>) || {})
-      : (() => {
-          const fallbackLast = rawArgs.at(-1);
-          return isPlainOptionsObject(fallbackLast) ? fallbackLast : {};
-        })();
-    const actionOptions = toPluginActionCommandOpts(allOptions);
-    const bridgeOptions = toPluginCliBridgeOptions(allOptions);
-
-    let payload: JsonValue;
-    try {
-      payload = await commandSpec.mapInput({
-        args: positionalArgs,
-        opts: actionOptions,
-      });
-    } catch (error) {
-      printResult({
-        asJson: bridgeOptions.json,
-        success: false,
-        title: `${params.plugin.name}.${params.actionName} failed`,
-        payload: {
-          error: `Failed to parse command input: ${String(error)}`,
-        },
-      });
-      return;
-    }
-
-    const local = await runLocalPluginAction({
-      plugins: params.plugins,
-      projectRoot: resolveProjectRoot(bridgeOptions.path),
-      pluginName: params.plugin.name,
-      actionName: params.actionName,
-      payload,
-    });
-    printResult({
-      asJson: bridgeOptions.json,
-      success: Boolean(local.success),
-      title: local.success
-        ? `${params.plugin.name}.${params.actionName} ok`
-        : `${params.plugin.name}.${params.actionName} failed`,
-      payload: {
-        ...(local.data !== undefined ? { data: local.data } : {}),
-        ...(local.message ? { message: local.message } : {}),
-        ...(local.error ? { error: local.error } : {}),
-      },
-    });
-  });
-}
-
-/**
- * 注册指定 plugin 集合的 action CLI 命令。
- */
-export function registerPluginActionCommandsForCli(params: {
-  program: Command;
-  plugins: Iterable<Plugin>;
-}): void {
-  const plugins = [...params.plugins];
-  for (const plugin of plugins) {
-    for (const [actionName, action] of Object.entries(plugin.actions || {})) {
-      registerPluginActionCommand({
-        program: params.program,
-        plugins,
-        plugin,
-        actionName,
-        action,
-      });
-    }
-  }
-}

package/src/plugin/core/PluginCommandRequest.ts

@@ -1,93 +0,0 @@
-/**
- * PluginCommandRequest：统一 plugin runtime command 请求解析模块。
- *
- * 关键点（中文）
- * - 统一收口 downcity gateway command 入口的请求体解析。
- * - plugin runtime 远程调用统一走 runtime command 协议，不再让 action 自带 HTTP route。
- * - ActionSchedule 参数（`schedule` / `delay` / `time`）也在这里一次性归一化。
- */
-
-import type { JsonValue } from "@/types/common/Json.js";
-import type { PluginActionScheduleInput } from "@/plugin/types/ActionSchedule.js";
-import {
-  normalizeRunAtMsOrThrow,
-  parseActionScheduleRunAtMsOrThrow,
-} from "@/plugin/core/ActionScheduleTime.js";
-
-type JsonRecord = Record<string, unknown>;
-
-/**
- * 统一 plugin runtime command 请求体。
- */
-export type PluginCommandRequestBody = {
-  /**
-   * 目标 plugin 名称。
-   */
-  pluginName: string;
-  /**
-   * 目标 command / action 名称。
-   */
-  command: string;
-  /**
-   * 结构化 payload。
-   */
-  payload?: JsonValue;
-  /**
-   * 可选调度信息。
-   */
-  schedule?: PluginActionScheduleInput;
-};
-
-function isJsonRecord(value: unknown): value is JsonRecord {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-
-/**
- * 从统一请求体中提取调度输入。
- */
-function readScheduleInput(
-  body: JsonRecord,
-): PluginActionScheduleInput | undefined {
-  const nestedSchedule = isJsonRecord(body.schedule) ? body.schedule : undefined;
-  const nestedRunAtMs = nestedSchedule?.runAtMs;
-  const topLevelDelay = body.delayMs ?? body.delay;
-  const topLevelTime = body.sendAtMs ?? body.sendAt ?? body.time;
-
-  if (body.schedule !== undefined && !nestedSchedule) {
-    throw new Error("schedule must be an object");
-  }
-  if (nestedRunAtMs !== undefined && (topLevelDelay !== undefined || topLevelTime !== undefined)) {
-    throw new Error("`schedule.runAtMs` cannot be used together with `delay/time`.");
-  }
-  if (nestedRunAtMs !== undefined) {
-    return {
-      runAtMs: normalizeRunAtMsOrThrow(
-        nestedRunAtMs as string | number | undefined,
-        "schedule.runAtMs",
-      ),
-    };
-  }
-
-  const runAtMs = parseActionScheduleRunAtMsOrThrow({
-    delay: topLevelDelay as string | number | undefined,
-    time: topLevelTime as string | number | undefined,
-  });
-  if (typeof runAtMs !== "number") return undefined;
-  return { runAtMs };
-}
-
-/**
- * 解析统一 plugin runtime command 请求体。
- */
-export function parsePluginCommandRequestBody(
-  rawBody: JsonValue | undefined,
-): PluginCommandRequestBody {
-  const body = isJsonRecord(rawBody) ? rawBody : {};
-  const schedule = readScheduleInput(body);
-  return {
-    pluginName: String(body.pluginName || "").trim(),
-    command: String(body.command || "").trim(),
-    ...(body.payload !== undefined ? { payload: body.payload as JsonValue } : {}),
-    ...(schedule ? { schedule } : {}),
-  };
-}