@downcity/agent 1.1.96 → 1.1.99

package/scripts/linux-bubblewrap-sandbox.test.mjs

@@ -19,26 +19,29 @@ async function createSandboxFixture() {
   const projectRoot = path.join(root, "project");
   const writablePath = path.join(projectRoot, ".downcity");
   const shellDir = path.join(writablePath, "shell", "sh_test");
-  const shellHomeDir = path.join(shellDir, "sandbox", "home");
-  const shellTmpDir = path.join(shellDir, "sandbox", "tmp");
+  const sandboxDir = path.join(projectRoot, ".downcity", "sandbox");
+  const tmpDir = path.join(sandboxDir, "tmp");
+  const cacheDir = path.join(sandboxDir, ".cache");
 
-  await fs.mkdir(shellHomeDir, { recursive: true });
-  await fs.mkdir(shellTmpDir, { recursive: true });
+  await fs.mkdir(shellDir, { recursive: true });
+  await fs.mkdir(tmpDir, { recursive: true });
+  await fs.mkdir(cacheDir, { recursive: true });
 
   return {
     root,
     projectRoot,
     writablePath,
     shellDir,
-    shellHomeDir,
-    shellTmpDir,
+    sandboxDir,
+    tmpDir,
+    cacheDir,
   };
 }
 
 function createParams(fixture, overrides = {}) {
   return {
-    shellId: "sh_test",
-    shellDir: fixture.shellDir,
+    executionId: "sh_test",
+    executionDir: fixture.shellDir,
     cmd: "printf hello",
     cwd: fixture.projectRoot,
     actualCwd: fixture.projectRoot,
@@ -52,12 +55,14 @@ function createParams(fixture, overrides = {}) {
     config: {
       backend: "linux-bubblewrap",
       rootPath: fixture.projectRoot,
+      sandboxDir: fixture.sandboxDir,
+      homeDir: fixture.sandboxDir,
+      tmpDir: fixture.tmpDir,
+      cacheDir: fixture.cacheDir,
       envAllowlist: ["PATH", "LANG"],
-      writablePaths: [fixture.writablePath],
+      writablePaths: [fixture.projectRoot, fixture.sandboxDir],
       networkMode: "off",
     },
-    shellHomeDir: fixture.shellHomeDir,
-    shellTmpDir: fixture.shellTmpDir,
     ...overrides,
   };
 }
@@ -96,9 +101,9 @@ test("Linux bubblewrap args isolate network and overlay writable project paths",
     assert.equal(hasArg(args, "--die-with-parent"), true);
     assert.equal(hasArg(args, "--unshare-pid"), true);
     assert.equal(hasArg(args, "--unshare-net"), true);
-    assert.equal(hasOptionPair(args, "--ro-bind", fixture.projectRoot), true);
-    assert.equal(hasOptionPair(args, "--bind", fixture.writablePath), true);
-    assert.equal(hasOptionPair(args, "--bind", fixture.projectRoot), false);
+    assert.equal(hasOptionPair(args, "--bind", fixture.projectRoot), true);
+    assert.equal(hasOptionPair(args, "--bind", fixture.sandboxDir), false);
+    assert.equal(hasOptionPair(args, "--ro-bind", fixture.projectRoot), false);
     assert.equal(hasOptionValue(args, "--dir", fixture.writablePath), false);
     assert.deepEqual(args.slice(-5), [
       "--chdir",
@@ -119,6 +124,10 @@ test("Linux bubblewrap args keep root writable when sandbox writablePaths includ
       config: {
         backend: "linux-bubblewrap",
         rootPath: fixture.projectRoot,
+        sandboxDir: fixture.sandboxDir,
+        homeDir: fixture.sandboxDir,
+        tmpDir: fixture.tmpDir,
+        cacheDir: fixture.cacheDir,
         envAllowlist: ["PATH"],
         writablePaths: [fixture.projectRoot],
         networkMode: "full",

package/src/executor/composer/system/default/assets/core.prompt.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/executor/composer/system/default/assets/core.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "你拥有且仅拥有当前项目 {{project_path}} 的使用权和修改权。当前年份是 {{current_year}} 年。\n1. `.downcity/` 是 Downcity 的运行时数据目录（通常不需要你手动读取/修改；系统会自动写入与注入）。结构与逻辑如下：\n   - `.downcity/agents/<agentId>/sessions/` 是会话消息。\n   - `.downcity/memory/` 是中长期记忆。\n   - `.downcity/profile/Primary.md`、`.downcity/profile/other.md`：全局 profile 记忆；存在时会自动作为 system prompt 注入。\n   - `.downcity/public/`：对外静态资源目录，通过 `GET /downcity/public/<path>` 访问；用于给外部访问的路径。不要存放敏感信息，Town Agent HTTP gateway 会把 `.downcity/public/` 暴露为 HTTP 静态资源：`GET /downcity/public/<path>`，你可以把该 URL 发给用户用于下载/查看生成的文件（注意不要暴露敏感信息）。\n   - `.downcity/logs/<YYYY-MM-DD>.jsonl`：运行日志（JSONL）；用于排查问题，避免把原始日志整段贴给用户。\n   - `.downcity/.cache/`：幂等/去重缓存（ingress/egress）；不要手动改。\n   - `.downcity/.debug/`：调试产物（Town 托管进程 pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。\n   - `.downcity/data/`：小型持久化数据（预留）。\n   - `.downcity/task/`：Task 目录。\n2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。\n\n# 最重要\n【关于命令执行工具】（重要）\n- 短命令、一次性命令优先使用 `shell_exec`。\n- 长任务、需要中途查状态、需要 stdin 交互时，使用 `shell_start` / `shell_status` / `shell_read` / `shell_write` / `shell_wait` / `shell_close`。\n- 先用 `shell_start` 启动命令并拿到 `shell_id`。\n- `shell_id` 是 shell 会话标识；它不是 chat `session_id`。\n- 长任务期间，优先使用 `shell_status` 查询进度，或使用 `shell_wait` 等待状态变化；不要自己写高频空轮询循环。\n- 只有在确实需要原始增量输出时，才使用 `shell_read` 按 `from_cursor` 继续读取。\n- 需要向进程 stdin 输入内容时，使用 `shell_write`。\n- 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。\n- 不要把原始超长 shell 输出直接转发给用户，应先总结。\n\n# 默认决策与澄清\n- 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。\n- 只有当“缺失信息会实质改变结果”时才追问；例如：会影响日期/对象/金额/账户/发送目标，或会触发不可逆、高风险、涉隐私操作。\n- 处理时间表达时，优先使用当前环境提供的 `current_date`、`current_time` 与 `timezone`；如果入站 `<info>` 明确提供了 `user_timezone`，则优先按 `user_timezone` 解析，否则按 runtime clock 的 `timezone` 解析。像“今天/明天/下午两点/提前两小时”这类表达，应先解析为绝对时间，再执行，并在回复里明确写出绝对日期时间。\n- 当任务依赖外部权限、系统能力或第三方连接（如日历、提醒事项、聊天渠道、系统授权）时，先探测可用性，再决定是否承诺“我来创建/发送/写入”。\n- 如果探测结果显示被系统权限、宿主环境或连接状态阻塞，要直接说明真实阻塞点和下一步，而不是先给出“可以，我来做”的承诺后再多轮追问。\n- 若已经有足够信息可以一次完成多个低风险默认动作，应直接完成，并在结果里简短说明采用了哪些默认假设。\n\n# 很重要\n\n安全与边界\n- 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。\n- 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。\n- `town keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `town keys` 获取明文。\n";
+const TEXT_MODULE_CONTENT = "你拥有且仅拥有当前项目 {{project_path}} 的使用权和修改权。当前年份是 {{current_year}} 年。\n1. `.downcity/` 是 Downcity 的运行时数据目录（通常不需要你手动读取/修改；系统会自动写入与注入）。结构与逻辑如下：\n   - `.downcity/agents/<agentId>/sessions/` 是会话消息。\n   - `.downcity/memory/` 是中长期记忆。\n   - `.downcity/profile/Primary.md`、`.downcity/profile/other.md`：全局 profile 记忆；存在时会自动作为 system prompt 注入。\n   - `.downcity/public/`：对外静态资源目录，通过 `GET /downcity/public/<path>` 访问；用于给外部访问的路径。不要存放敏感信息，Town Agent HTTP gateway 会把 `.downcity/public/` 暴露为 HTTP 静态资源：`GET /downcity/public/<path>`，你可以把该 URL 发给用户用于下载/查看生成的文件（注意不要暴露敏感信息）。\n   - `.downcity/logs/<YYYY-MM-DD>.jsonl`：运行日志（JSONL）；用于排查问题，避免把原始日志整段贴给用户。\n   - `.downcity/.cache/`：幂等/去重缓存（ingress/egress）；不要手动改。\n   - `.downcity/.debug/`：调试产物（Town 托管进程 pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。\n   - `.downcity/data/`：小型持久化数据（预留）。\n   - `.downcity/task/`：Task 目录。\n   - `.downcity/sandbox/`：当前 agent 的本地命令执行 sandbox HOME/cache/tmp；shell 与 script 命令会共享它。\n2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。\n\n# 最重要\n【关于命令执行工具】（重要）\n- 短命令、一次性命令优先使用 `shell_exec`。\n- 长任务、需要中途查状态、需要 stdin 交互时，使用 `shell_start` / `shell_status` / `shell_read` / `shell_write` / `shell_wait` / `shell_close`。\n- 先用 `shell_start` 启动命令并拿到 `shell_id`。\n- `shell_id` 是 shell 会话标识；它不是 chat `session_id`。\n- 长任务期间，优先使用 `shell_status` 查询进度，或使用 `shell_wait` 等待状态变化；不要自己写高频空轮询循环。\n- 只有在确实需要原始增量输出时，才使用 `shell_read` 按 `from_cursor` 继续读取。\n- 需要向进程 stdin 输入内容时，使用 `shell_write`。\n- 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。\n- 不要把原始超长 shell 输出直接转发给用户，应先总结。\n- shell 命令默认在当前 agent 的 sandbox 中执行：项目目录可读写，网络可用，HOME 指向 `.downcity/sandbox/`，真实用户 HOME 与系统目录不可写。\n- 安装 Python 依赖时优先使用项目内 `.venv`，不要使用 `pip install --user`。\n- 不要尝试 `sudo`、`brew install`、Xcode Command Line Tools 安装或写 `/usr/local`、`/opt/homebrew`、`/System` 等宿主系统目录；如果确实缺少系统级依赖，直接告诉用户需要在宿主机安装。\n- 下载模型、工具缓存、临时状态应自然落在 `.downcity/sandbox/` 或项目目录中，不要假设可复用真实用户缓存。\n\n# 默认决策与澄清\n- 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。\n- 只有当“缺失信息会实质改变结果”时才追问；例如：会影响日期/对象/金额/账户/发送目标，或会触发不可逆、高风险、涉隐私操作。\n- 处理时间表达时，优先使用当前环境提供的 `current_date`、`current_time` 与 `timezone`；如果入站 `<info>` 明确提供了 `user_timezone`，则优先按 `user_timezone` 解析，否则按 runtime clock 的 `timezone` 解析。像“今天/明天/下午两点/提前两小时”这类表达，应先解析为绝对时间，再执行，并在回复里明确写出绝对日期时间。\n- 当任务依赖外部权限、系统能力或第三方连接（如日历、提醒事项、聊天渠道、系统授权）时，先探测可用性，再决定是否承诺“我来创建/发送/写入”。\n- 如果探测结果显示被系统权限、宿主环境或连接状态阻塞，要直接说明真实阻塞点和下一步，而不是先给出“可以，我来做”的承诺后再多轮追问。\n- 若已经有足够信息可以一次完成多个低风险默认动作，应直接完成，并在结果里简短说明采用了哪些默认假设。\n\n# 很重要\n\n安全与边界\n- 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。\n- 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。\n- `town keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `town keys` 获取明文。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/executor/composer/system/default/assets/core.prompt.ts.txt

@@ -9,6 +9,7 @@
    - `.downcity/.debug/`：调试产物（Town 托管进程 pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。
    - `.downcity/data/`：小型持久化数据（预留）。
    - `.downcity/task/`：Task 目录。
+   - `.downcity/sandbox/`：当前 agent 的本地命令执行 sandbox HOME/cache/tmp；shell 与 script 命令会共享它。
 2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。
 
 # 最重要
@@ -22,6 +23,10 @@
 - 需要向进程 stdin 输入内容时，使用 `shell_write`。
 - 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。
 - 不要把原始超长 shell 输出直接转发给用户，应先总结。
+- shell 命令默认在当前 agent 的 sandbox 中执行：项目目录可读写，网络可用，HOME 指向 `.downcity/sandbox/`，真实用户 HOME 与系统目录不可写。
+- 安装 Python 依赖时优先使用项目内 `.venv`，不要使用 `pip install --user`。
+- 不要尝试 `sudo`、`brew install`、Xcode Command Line Tools 安装或写 `/usr/local`、`/opt/homebrew`、`/System` 等宿主系统目录；如果确实缺少系统级依赖，直接告诉用户需要在宿主机安装。
+- 下载模型、工具缓存、临时状态应自然落在 `.downcity/sandbox/` 或项目目录中，不要假设可复用真实用户缓存。
 
 # 默认决策与澄清
 - 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。

package/src/executor/tools/shell/ShellToolBridge.ts

@@ -211,6 +211,13 @@ export function flattenShellActionResponse(params: {
     status: shell.status,
     cmd: shell.cmd,
     cwd: shell.cwd,
+    sandboxed: shell.sandboxed === true,
+    sandbox_backend: shell.sandboxBackend || null,
+    sandbox_network_mode: shell.sandboxNetworkMode || null,
+    sandbox_dir: shell.sandboxDir || null,
+    sandbox_home_dir: shell.sandboxHomeDir || null,
+    sandbox_tmp_dir: shell.sandboxTmpDir || null,
+    sandbox_cache_dir: shell.sandboxCacheDir || null,
     pid: typeof shell.pid === "number" ? shell.pid : null,
     version: shell.version,
     started_at: shell.startedAt,
@@ -255,6 +262,13 @@ export function flattenShellExecResponse(params: {
     status: shell.status,
     cmd: shell.cmd,
     cwd: shell.cwd,
+    sandboxed: shell.sandboxed === true,
+    sandbox_backend: shell.sandboxBackend || null,
+    sandbox_network_mode: shell.sandboxNetworkMode || null,
+    sandbox_dir: shell.sandboxDir || null,
+    sandbox_home_dir: shell.sandboxHomeDir || null,
+    sandbox_tmp_dir: shell.sandboxTmpDir || null,
+    sandbox_cache_dir: shell.sandboxCacheDir || null,
     exit_code: typeof shell.exitCode === "number" ? shell.exitCode : null,
     output: chunk?.output || "",
     original_chars: chunk?.originalChars ?? 0,

package/src/executor/tools/shell/types/ShellPlugin.ts

@@ -54,6 +54,14 @@ export type ShellSessionSnapshot = {
   sandboxBackend?: string;
   /** 当前 shell 采用的 sandbox 网络模式。 */
   sandboxNetworkMode?: "off" | "restricted" | "full";
+  /** 当前 agent 级 sandbox 的持久目录。 */
+  sandboxDir?: string;
+  /** 当前 shell 在 sandbox 中使用的 HOME。 */
+  sandboxHomeDir?: string;
+  /** 当前 shell 在 sandbox 中使用的临时目录。 */
+  sandboxTmpDir?: string;
+  /** 当前 shell 在 sandbox 中使用的 XDG cache 目录。 */
+  sandboxCacheDir?: string;
   /** 当前 shell 状态。 */
   status: ShellSessionStatus;
   /** 子进程 pid；若尚未创建成功则为空。 */

package/src/index.ts

@@ -229,13 +229,8 @@ export type {
   ImagePluginContent,
   ImagePluginFileContent,
   ImagePluginInput,
-  ImagePluginJobCreateResult,
-  ImagePluginJobResult,
-  ImagePluginJobStatus,
-  ImagePluginJobStatusResult,
   ImagePluginMessage,
   ImagePluginOptions,
-  ImagePluginResult,
   ImagePluginTextContent,
 } from "./types/plugin/ImagePlugin.js";
 

package/src/plugin/core/ImagePlugin.ts

@@ -2,19 +2,15 @@
  * ImagePlugin：Agent 内置图片生成插件。
  *
  * 关键点（中文）
- * - 插件只负责把外部 image 函数暴露为 agent 可调用 action。
- * - 具体模型、Provider、鉴权与上游协议由调用方传入的 image 函数处理。
+ * - 对 Agent 只暴露同步体验的 `generate` action。
+ * - City / provider 的图片能力通过单个 image 函数注入。
  * - action 返回 AI SDK UIMessage，后续由 plugin tool bridge 抽取 file parts 写回 assistant 消息。
  */
 
-import crypto from "node:crypto";
 import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
 import type { JsonObject, JsonValue } from "@/types/common/Json.js";
 import type {
   ImagePluginInput,
-  ImagePluginJobCreateResult,
-  ImagePluginJobResult,
-  ImagePluginJobStatusResult,
   ImagePluginOptions,
   ImagePluginResult,
 } from "@/types/plugin/ImagePlugin.js";
@@ -24,39 +20,6 @@ const DEFAULT_IMAGE_PLUGIN_NAME = "image";
 const DEFAULT_IMAGE_PLUGIN_TITLE = "Image";
 const DEFAULT_IMAGE_PLUGIN_DESCRIPTION =
   "Generate images and return them as assistant file parts.";
-const DEFAULT_WAIT_TIMEOUT_MS = 60_000;
-const DEFAULT_POLL_INTERVAL_MS = 3_000;
-
-type LocalImageJobRecord = {
-  /**
-   * 图片任务唯一 ID。
-   */
-  job_id: string;
-  /**
-   * 当前任务状态。
-   */
-  status: "queued" | "running" | "succeeded" | "failed";
-  /**
-   * 成功时的图片结果。
-   */
-  result?: ImagePluginResult;
-  /**
-   * 失败时的错误信息。
-   */
-  error?: string;
-  /**
-   * 人类可读状态说明。
-   */
-  message?: string;
-  /**
-   * 任务创建时间。
-   */
-  created_at: string;
-  /**
-   * 任务更新时间。
-   */
-  updated_at: string;
-};
 
 /**
  * 判断值是否为普通对象。
@@ -77,45 +40,17 @@ function normalize_image_payload(payload: JsonValue | undefined): ImagePluginInp
   return { ...record } as ImagePluginInput;
 }
 
-function normalize_job_id_payload(payload: JsonValue | undefined): { job_id: string } {
-  const record = to_record(payload ?? {});
-  const job_id = String(record?.job_id || "").trim();
-  if (!job_id) {
-    throw new TypeError("ImagePlugin job action requires job_id");
-  }
-  return { job_id };
-}
-
 /**
  * 校验 image 函数返回的 UIMessage。
  */
 function normalize_image_result(result: ImagePluginResult): ImagePluginResult {
   const record = to_record(result);
   if (!record || !Array.isArray(record.parts)) {
-    throw new TypeError("ImagePlugin image function must return an AI SDK UIMessage");
+    throw new TypeError("ImagePlugin image provider must return an AI SDK UIMessage");
   }
   return result;
 }
 
-/**
- * 归一化任务状态查询结果，确保 status action 不携带图片结果。
- */
-function normalize_job_status_result(
-  result: ImagePluginJobStatusResult,
-): ImagePluginJobStatusResult {
-  return {
-    job_id: result.job_id,
-    status: result.status,
-    ...(result.message ? { message: result.message } : {}),
-    ...(result.error ? { error: result.error } : {}),
-    ...(typeof result.poll_after_ms === "number"
-      ? { poll_after_ms: result.poll_after_ms }
-      : {}),
-    ...(result.created_at ? { created_at: result.created_at } : {}),
-    ...(result.updated_at ? { updated_at: result.updated_at } : {}),
-  };
-}
-
 /**
  * Agent 图片生成插件。
  */
@@ -135,13 +70,7 @@ export class ImagePlugin extends BasePlugin {
    */
   readonly description: string;
 
-  private readonly image: ImagePluginOptions["image"];
-  private readonly create_job?: ImagePluginOptions["create"];
-  private readonly read_job_status?: ImagePluginOptions["status"];
-  private readonly read_job_result?: ImagePluginOptions["result"];
-  private readonly wait_timeout_ms: number;
-  private readonly poll_interval_ms: number;
-  private readonly local_jobs = new Map<string, LocalImageJobRecord>();
+  private readonly image: NonNullable<ImagePluginOptions["image"]>;
 
   constructor(options: ImagePluginOptions) {
     super();
@@ -149,23 +78,8 @@ export class ImagePlugin extends BasePlugin {
     if (!name) {
       throw new Error("ImagePlugin requires a non-empty name");
     }
-    const has_custom_job_api = Boolean(
-      options.create || options.status || options.result,
-    );
-    if (
-      has_custom_job_api &&
-      (typeof options.create !== "function" ||
-        typeof options.status !== "function" ||
-        typeof options.result !== "function")
-    ) {
-      throw new Error(
-        "ImagePlugin custom job API requires create, status, and result functions",
-      );
-    }
-    if (!has_custom_job_api && typeof options.image !== "function") {
-      throw new Error(
-        "ImagePlugin requires either image(input) or create/status/result functions",
-      );
+    if (typeof options.image !== "function") {
+      throw new Error("ImagePlugin requires an image function");
     }
     this.name = name;
     this.title = String(options.title || DEFAULT_IMAGE_PLUGIN_TITLE).trim();
@@ -173,17 +87,6 @@ export class ImagePlugin extends BasePlugin {
       options.description || DEFAULT_IMAGE_PLUGIN_DESCRIPTION,
     ).trim();
     this.image = options.image;
-    this.create_job = options.create;
-    this.read_job_status = options.status;
-    this.read_job_result = options.result;
-    this.wait_timeout_ms =
-      typeof options.wait_timeout_ms === "number" && options.wait_timeout_ms > 0
-        ? options.wait_timeout_ms
-        : DEFAULT_WAIT_TIMEOUT_MS;
-    this.poll_interval_ms =
-      typeof options.poll_interval_ms === "number" && options.poll_interval_ms > 0
-        ? options.poll_interval_ms
-        : DEFAULT_POLL_INTERVAL_MS;
   }
 
   /**
@@ -191,202 +94,26 @@ export class ImagePlugin extends BasePlugin {
    */
   system(_context: AgentContext): string {
     return [
-      "Image generation is available through the plugin_call tool as an observable job workflow.",
-      `Call plugin "${this.name}" action "create" when the user asks to create, render, draw, or edit an image.`,
-      `Then call plugin "${this.name}" action "status" with { job_id } to inspect progress.`,
-      `When status is succeeded, call plugin "${this.name}" action "result" with { job_id } to attach the generated files.`,
-      "Use action \"generate\" only as a compatibility shortcut when you explicitly need to wait for completion.",
-      "Pass a JSON payload with prompt, optional size/aspect_ratio/quality/n, and optional provider_options to create/generate.",
+      "Image generation is available through the plugin_call tool.",
+      `Call plugin "${this.name}" action "generate" when the user asks to create, render, draw, or edit an image.`,
+      "Pass a JSON payload with prompt, optional size/aspect_ratio/quality/n, and optional provider_options.",
+      "The generated image files will be attached to the final assistant message automatically.",
     ].join("\n");
   }
 
-  private create_local_job(input: ImagePluginInput): ImagePluginJobCreateResult {
-    if (typeof this.image !== "function") {
-      throw new Error("ImagePlugin local image job requires image(input)");
-    }
-    const now = new Date().toISOString();
-    const job_id = `img_${crypto.randomUUID()}`;
-    const record: LocalImageJobRecord = {
-      job_id,
-      status: "running",
-      message: "image job is running",
-      created_at: now,
-      updated_at: now,
-    };
-    this.local_jobs.set(job_id, record);
-
-    void this.run_local_job(record, input, this.image);
-
-    return {
-      job_id,
-      status: record.status,
-      message: record.message,
-      poll_after_ms: this.poll_interval_ms,
-      created_at: record.created_at,
-      updated_at: record.updated_at,
-    };
-  }
-
-  private async run_local_job(
-    record: LocalImageJobRecord,
-    input: ImagePluginInput,
-    image: NonNullable<ImagePluginOptions["image"]>,
-  ): Promise<void> {
-    try {
-      const message = normalize_image_result(await image(input));
-      record.status = "succeeded";
-      record.result = message;
-      record.message = "image job succeeded";
-      record.updated_at = new Date().toISOString();
-    } catch (error) {
-      record.status = "failed";
-      record.error = String(error);
-      record.message = "image job failed";
-      record.updated_at = new Date().toISOString();
-    }
-  }
-
-  private read_local_job(job_id: string): LocalImageJobRecord {
-    const record = this.local_jobs.get(job_id);
-    if (!record) {
-      throw new Error(`Unknown image job: ${job_id}`);
-    }
-    return record;
-  }
-
-  private serialize_local_status(record: LocalImageJobRecord): ImagePluginJobStatusResult {
-    return {
-      job_id: record.job_id,
-      status: record.status,
-      ...(record.message ? { message: record.message } : {}),
-      ...(record.error ? { error: record.error } : {}),
-      ...(record.status === "running" || record.status === "queued"
-        ? { poll_after_ms: this.poll_interval_ms }
-        : {}),
-      created_at: record.created_at,
-      updated_at: record.updated_at,
-    };
-  }
-
-  private serialize_local_result(record: LocalImageJobRecord): ImagePluginJobResult {
-    return {
-      job_id: record.job_id,
-      status: record.status,
-      ...(record.result ? { result: record.result } : {}),
-      ...(record.error ? { error: record.error } : {}),
-      ...(record.message ? { message: record.message } : {}),
-      created_at: record.created_at,
-      updated_at: record.updated_at,
-    };
-  }
-
-  private async wait_for_job(job_id: string): Promise<ImagePluginResult> {
-    const deadline = Date.now() + this.wait_timeout_ms;
-    while (Date.now() <= deadline) {
-      const result = this.read_job_result
-        ? await this.read_job_result({ job_id })
-        : this.serialize_local_result(this.read_local_job(job_id));
-      if (result.status === "succeeded" && result.result) {
-        return normalize_image_result(result.result);
-      }
-      if (result.status === "failed") {
-        throw new Error(result.error || result.message || "image job failed");
-      }
-      await new Promise((resolve) => setTimeout(resolve, this.poll_interval_ms));
-    }
-    throw new Error(`image job timed out: ${job_id}`);
+  private async generate_image(input: ImagePluginInput): Promise<ImagePluginResult> {
+    return normalize_image_result(await this.image(input));
   }
 
   /**
    * 显式 action 集合。
    */
   readonly actions = {
-    create: {
-      execute: async ({ payload }: { payload: JsonValue }) => {
-        try {
-          const input = normalize_image_payload(payload);
-          const result = this.create_job
-            ? await this.create_job(input)
-            : this.create_local_job(input);
-          return {
-            success: true,
-            data: result as unknown as JsonObject,
-            message: result.message || "image job created",
-          };
-        } catch (error) {
-          return {
-            success: false,
-            error: String(error),
-            message: String(error),
-          };
-        }
-      },
-    },
-    status: {
-      execute: async ({ payload }: { payload: JsonValue }) => {
-        try {
-          const input = normalize_job_id_payload(payload);
-          const result = this.read_job_status
-            ? normalize_job_status_result(await this.read_job_status(input))
-            : this.serialize_local_status(this.read_local_job(input.job_id));
-          return {
-            success: true,
-            data: result as unknown as JsonObject,
-            message: result.message || `image job ${result.status}`,
-          };
-        } catch (error) {
-          return {
-            success: false,
-            error: String(error),
-            message: String(error),
-          };
-        }
-      },
-    },
-    result: {
-      execute: async ({ payload }: { payload: JsonValue }) => {
-        try {
-          const input = normalize_job_id_payload(payload);
-          const result = this.read_job_result
-            ? await this.read_job_result(input)
-            : this.serialize_local_result(this.read_local_job(input.job_id));
-          if (result.status === "succeeded" && result.result) {
-            return {
-              success: true,
-              data: result.result as unknown as JsonObject,
-              message: result.message || "image job succeeded",
-            };
-          }
-          if (result.status === "failed") {
-            return {
-              success: false,
-              data: result as unknown as JsonObject,
-              error: result.error || result.message || "image job failed",
-              message: result.message || "image job failed",
-            };
-          }
-          return {
-            success: true,
-            data: result as unknown as JsonObject,
-            message: result.message || `image job ${result.status}`,
-          };
-        } catch (error) {
-          return {
-            success: false,
-            error: String(error),
-            message: String(error),
-          };
-        }
-      },
-    },
     generate: {
       execute: async ({ payload }: { payload: JsonValue }) => {
         try {
           const input = normalize_image_payload(payload);
-          const job = this.create_job
-            ? await this.create_job(input)
-            : this.create_local_job(input);
-          const message = await this.wait_for_job(job.job_id);
+          const message = await this.generate_image(input);
           return {
             success: true,
             data: message as unknown as JsonObject,