@downcity/plugins 1.0.173 → 1.0.193

package/src/web/PROMPT.ts

@@ -3,7 +3,7 @@
  * 源文件：由同路径 `*.ts.txt` 生成。
  */
 
-// Source: src/web/PROMPT.ts.txt
-const TEXT_MODULE_CONTENT = "# Web Plugin\n\nThis plugin injects general web-access methodology. It does not choose a provider and does not guarantee that any specific web tool exists.\n\nIf web-related dependencies are needed, use the `web` plugin's `install` action to install capabilities such as `web-access`, `agent-browser`, or related skill/CLI dependencies. Installation only prepares capabilities; it does not mean the runtime must use a specific provider.\n\nWhen a task needs internet access, verification, webpage reading, webpage interaction, or browser use, choose the path based on the currently available tools, skills, and user goal.\n\n## General Principles\n\n- Goal-driven: think like a human. Define the success criteria first, then choose the starting point most likely to reach them directly.\n- Evidence at every step: each result is evidence. When a path stops making progress, switch methods instead of repeatedly retrying the wrong approach.\n- Prefer primary sources: search engines are for discovery. Conclusions should usually trace back to official sites, official platforms, original pages, official docs, or source code.\n- Stop when done: once the goal is reached, do not spend extra steps just to look more complete.\n- Capability self-check: do not assume that a web skill or tool exists. Prefer capabilities explicitly available in the current system/tool list or in already looked-up skills.\n\n## Tool Selection\n\n- To discover sources or map keyword context: prefer currently available search tools or web-access-style skills.\n- For a known URL where you need page text or a direct answer: prefer currently available fetch/read tools.\n- For a known URL where you need raw HTML, meta tags, JSON-LD, or similar structured content: prefer currently available HTTP/curl/shell capabilities.\n- For logged-in state, dynamic rendering, site navigation, complex interactions, or anti-bot pages: prefer currently available browser, Chrome, agent-browser, or computer-use capabilities.\n- Jina-style markdown preprocessing may help for article-like pages and save tokens, but do not blindly trust it for dashboards, product pages, or complex layouts.\n\n## Browser Strategy\n\n- Once in the browser layer, understand the page structure before choosing the next action.\n- Programmatic methods are faster but more likely to trigger anti-bot behavior. GUI interaction is slower but more deterministic. If programmatic access is blocked, fall back to GUI.\n- Prefer links generated by the page itself. Do not manually guess or trim internal URL parameters.\n- Operate only tabs you created. Do not disturb the user's existing tabs. Close tabs you created when the task is done.\n- When encountering a login wall, first decide whether it actually blocks the goal. Ask the user to log in only when the target cannot be reached otherwise.\n\n## Parallelism And Verification\n\n- Independent research targets may be split and run in parallel. Targets with dependencies should not be parallelized blindly.\n- Verification tasks should return to primary sources. Do not use multiple secondary reports to circularly confirm each other.\n\n## Relationship To Skills And Tools\n\n- If the current environment has a `web-access` skill, web search, scraping, and verification tasks may prefer its instructions.\n- If the current environment has `agent-browser`, browser, or Chrome capabilities, dynamic pages and logged-in tasks may prefer them.\n- If necessary web capability is missing, state that directly. Do not pretend you have accessed the web.\n\n## Available Action\n\n- `install`: prepare web-related skill/CLI dependencies.\n\nExample:\n\n```ts\nplugin_call({\n  plugin: \"web\",\n  action: \"install\",\n  payload: {\n    target: \"agent-browser\",\n    scope: \"user\",\n  },\n});\n```\n";
+// Source: src/web/PROMPT.ts
+const TEXT_MODULE_CONTENT = "# Web Plugin\n\nThis plugin injects general web-access methodology. It does not choose a provider and does not guarantee that any specific web tool exists.\n\nIf web-related dependencies are needed, use the `web` plugin's `install` action to receive instructions for capabilities such as `web-access` and `agent-browser`. The action never executes commands, accesses the network, installs dependencies, or changes files. Follow the returned prompt with the available plugin and Shell capabilities.\n\nWhen a task needs internet access, verification, webpage reading, webpage interaction, or browser use, choose the path based on the currently available tools, skills, and user goal.\n\n## General Principles\n\n- Goal-driven: think like a human. Define the success criteria first, then choose the starting point most likely to reach them directly.\n- Evidence at every step: each result is evidence. When a path stops making progress, switch methods instead of repeatedly retrying the wrong approach.\n- Prefer primary sources: search engines are for discovery. Conclusions should usually trace back to official sites, official platforms, original pages, official docs, or source code.\n- Stop when done: once the goal is reached, do not spend extra steps just to look more complete.\n- Capability self-check: do not assume that a web skill or tool exists. Prefer capabilities explicitly available in the current system/tool list or in already looked-up skills.\n\n## Tool Selection\n\n- To discover sources or map keyword context: prefer currently available search tools or web-access-style skills.\n- For a known URL where you need page text or a direct answer: prefer currently available fetch/read tools.\n- For a known URL where you need raw HTML, meta tags, JSON-LD, or similar structured content: prefer currently available HTTP/curl/shell capabilities.\n- For logged-in state, dynamic rendering, site navigation, complex interactions, or anti-bot pages: prefer currently available browser, Chrome, agent-browser, or computer-use capabilities.\n- Jina-style markdown preprocessing may help for article-like pages and save tokens, but do not blindly trust it for dashboards, product pages, or complex layouts.\n\n## Browser Strategy\n\n- Once in the browser layer, understand the page structure before choosing the next action.\n- Programmatic methods are faster but more likely to trigger anti-bot behavior. GUI interaction is slower but more deterministic. If programmatic access is blocked, fall back to GUI.\n- Prefer links generated by the page itself. Do not manually guess or trim internal URL parameters.\n- Operate only tabs you created. Do not disturb the user's existing tabs. Close tabs you created when the task is done.\n- When encountering a login wall, first decide whether it actually blocks the goal. Ask the user to log in only when the target cannot be reached otherwise.\n\n## Parallelism And Verification\n\n- Independent research targets may be split and run in parallel. Targets with dependencies should not be parallelized blindly.\n- Verification tasks should return to primary sources. Do not use multiple secondary reports to circularly confirm each other.\n\n## Relationship To Skills And Tools\n\n- If the current environment has a `web-access` skill, web search, scraping, and verification tasks may prefer its instructions.\n- If the current environment has `agent-browser`, browser, or Chrome capabilities, dynamic pages and logged-in tasks may prefer them.\n- If necessary web capability is missing, state that directly. Do not pretend you have accessed the web.\n\n## Available Action\n\n- `install`: return installation instructions for web-related Skills and CLIs without executing them.\n\nExample:\n\n```ts\nplugin_call({\n  plugin: \"web\",\n  action: \"install\",\n  payload: {\n    target: \"agent-browser\",\n    scope: \"user\",\n  },\n});\n```\n\nAfter calling `install`, follow `data.prompt`. Skill installation is delegated to the `skill.install` instruction action so that the active SkillPlugin scan roots remain the source of truth. After running the instructed Shell commands, verify Skills with `skill.list` and read them with `skill.lookup`.\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/web/PROMPT.ts.txt

@@ -2,7 +2,7 @@
 
 This plugin injects general web-access methodology. It does not choose a provider and does not guarantee that any specific web tool exists.
 
-If web-related dependencies are needed, use the `web` plugin's `install` action to install capabilities such as `web-access`, `agent-browser`, or related skill/CLI dependencies. Installation only prepares capabilities; it does not mean the runtime must use a specific provider.
+If web-related dependencies are needed, use the `web` plugin's `install` action to receive instructions for capabilities such as `web-access` and `agent-browser`. The action never executes commands, accesses the network, installs dependencies, or changes files. Follow the returned prompt with the available plugin and Shell capabilities.
 
 When a task needs internet access, verification, webpage reading, webpage interaction, or browser use, choose the path based on the currently available tools, skills, and user goal.
 
@@ -43,7 +43,7 @@ When a task needs internet access, verification, webpage reading, webpage intera
 
 ## Available Action
 
-- `install`: prepare web-related skill/CLI dependencies.
+- `install`: return installation instructions for web-related Skills and CLIs without executing them.
 
 Example:
 
@@ -57,3 +57,5 @@ plugin_call({
   },
 });
 ```
+
+After calling `install`, follow `data.prompt`. Skill installation is delegated to the `skill.install` instruction action so that the active SkillPlugin scan roots remain the source of truth. After running the instructed Shell commands, verify Skills with `skill.list` and read them with `skill.lookup`.

package/src/web/Plugin.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - web plugin 不选择 provider，也不持久化 provider 运行态。
- * - install action 只负责准备联网相关 skill / CLI 依赖。
+ * - install action 只返回联网能力安装提示，不执行命令或修改文件。
  * - 它只通过 `system()` 注入联网研究与浏览器使用方法论。
  * - 具体执行能力由当前 agent 已注册的 tools、skills 或外部 plugin 决定。
  */
@@ -12,13 +12,11 @@ import { BasePlugin } from "@downcity/agent";
 import { createAction } from "@downcity/agent";
 import { z } from "zod";
 import type { AgentContext } from "@downcity/agent";
-import type {
-  JsonObject,
-  JsonValue,
-} from "@downcity/agent";
+import type { JsonObject, JsonValue, PluginActionResult } from "@downcity/agent";
 import { WEB_PLUGIN_PROMPT } from "@/web/WebPromptAssets.js";
-import { installWebPluginTargets } from "@/web/runtime/Install.js";
+import { render_web_install_prompt } from "@/web/runtime/Prompt.js";
 import type { WebPluginInstallPayload } from "@/web/types/WebPlugin.js";
+import { WEB_PLUGIN_ACTIONS } from "@/web/types/WebPlugin.js";
 
 /**
  * 读取字符串选项。
@@ -33,17 +31,6 @@ function get_string_opt(
   return trimmed || undefined;
 }
 
-/**
- * 读取布尔选项。
- */
-function get_boolean_opt(
-  opts: Record<string, JsonValue>,
-  key: string,
-): boolean | undefined {
-  const value = opts[key];
-  return typeof value === "boolean" ? value : undefined;
-}
-
 /**
  * 读取安装目标。
  */
@@ -88,64 +75,17 @@ export class WebPlugin extends BasePlugin {
   readonly description =
     "Injects web research and browser-use methodology for agents.";
 
-  /**
-   * setup 面板：只准备联网相关依赖，不做 provider 配置。
-   */
-  readonly setup = {
-    mode: "install" as const,
-    title: "Install web capabilities",
-    description:
-      "安装 web-access、agent-browser 等联网相关 skill / CLI 依赖；不改变 agent 的运行时默认选择。",
-    fields: [
-      {
-        key: "target",
-        label: "联网能力",
-        type: "select" as const,
-        required: true,
-        options: [
-          {
-            label: "web-access",
-            value: "web-access",
-            hint: "通用搜索、抓取与资料核实 skill",
-          },
-          {
-            label: "agent-browser",
-            value: "agent-browser",
-            hint: "浏览器自动化 skill，并准备 agent-browser CLI",
-          },
-          {
-            label: "全部",
-            value: "all",
-            hint: "同时准备 web-access 和 agent-browser",
-          },
-        ],
-      },
-      {
-        key: "scope",
-        label: "安装位置",
-        type: "select" as const,
-        required: true,
-        options: [
-          { label: "用户目录", value: "user", hint: "用户级 skill / 全局 CLI" },
-          { label: "项目目录", value: "project", hint: "项目级 skill / devDependency" },
-        ],
-      },
-    ],
-    primaryAction: "install",
-  };
-
   /**
    * WebPlugin 对外 action。
    */
   readonly actions = {
-    install: createAction({
-      description: "Install web-related skill / CLI dependencies (web-access, agent-browser).",
+    [WEB_PLUGIN_ACTIONS.install]: createAction({
+      description:
+        "Return instructions for installing web-related Skills and CLIs. This action does not install anything.",
       input_schema: {
         zod: z.object({
           target: z.enum(["web-access", "agent-browser", "all"]).optional(),
           scope: z.enum(["user", "project"]).optional(),
-          yes: z.boolean().optional(),
-          agent: z.string().optional(),
         }),
         json_schema: {
           type: "object",
@@ -153,32 +93,29 @@ export class WebPlugin extends BasePlugin {
             target: {
               type: "string",
               enum: ["web-access", "agent-browser", "all"],
-              description: "Web capability to install.",
+              description: "Web capability to receive installation instructions for.",
             },
             scope: {
               type: "string",
               enum: ["user", "project"],
-              description: "Installation scope.",
+              description: "Installation scope for the agent-browser CLI.",
             },
-            yes: { type: "boolean", description: "Skip confirmation." },
-            agent: { type: "string", description: "Target agent for skill installer." },
           },
         },
       },
       examples: [
         {
-          title: "Install all web capabilities for user",
+          title: "Get user-level installation instructions for all web capabilities",
           payload: { target: "all", scope: "user" },
         },
       ],
       command: {
-        description: "Install web-related skill / CLI dependencies.",
+        description:
+          "Return web capability installation instructions without executing them.",
         configure(command) {
           command
             .option("--target <target>", "web-access、agent-browser 或 all")
-            .option("--scope <scope>", "安装位置：user 或 project")
-            .option("-y, --yes", "跳过确认（默认 true）", true)
-            .option("--agent <agent>", "skill installer 目标 agent");
+            .option("--scope <scope>", "agent-browser CLI 安装位置：user 或 project");
         },
         mapInput({ opts }): JsonObject {
           return {
@@ -188,25 +125,18 @@ export class WebPlugin extends BasePlugin {
             ...(get_install_scope_opt(opts)
               ? { scope: get_install_scope_opt(opts) }
               : {}),
-            ...(typeof get_boolean_opt(opts, "yes") === "boolean"
-              ? { yes: get_boolean_opt(opts, "yes") }
-              : {}),
-            ...(get_string_opt(opts, "agent") ? { agent: get_string_opt(opts, "agent") } : {}),
           } satisfies JsonObject;
         },
       },
-      execute: async ({ context, input }) => {
-        const data = await installWebPluginTargets({
-          context,
-          payload:
-            input && typeof input === "object" && !Array.isArray(input)
-              ? (input as WebPluginInstallPayload)
-              : undefined,
-        });
+      execute({ input }): PluginActionResult<JsonObject> {
+        const result = render_web_install_prompt(
+          input as WebPluginInstallPayload | undefined,
+        );
         return {
           success: true,
-          data,
-          message: "web dependencies installed",
+          data: result,
+          message:
+            "Web capability installation instructions ready; no commands were executed and no files were changed.",
         };
       },
     }),

package/src/web/runtime/Prompt.ts

@@ -0,0 +1,99 @@
+/**
+ * WebPlugin 安装提示词渲染器。
+ *
+ * 关键点（中文）
+ * - 只生成 Agent 可执行的操作说明，不执行命令、访问网络或修改文件。
+ * - Skill 安装委托给 SkillPlugin，避免重复维护扫描根与安装位置规则。
+ * - agent-browser CLI 仅根据请求的作用域提供 Shell 命令候选。
+ */
+
+import type {
+  WebPluginInstallInstructions,
+  WebPluginInstallPayload,
+  WebPluginInstallScope,
+  WebPluginInstallTarget,
+} from "@/web/types/WebPlugin.js";
+
+/**
+ * 归一化联网能力目标。
+ */
+function resolve_install_target(
+  target: WebPluginInstallPayload["target"],
+): WebPluginInstallTarget {
+  return target === "agent-browser" || target === "all"
+    ? target
+    : "web-access";
+}
+
+/**
+ * 归一化 CLI 安装作用域。
+ */
+function resolve_install_scope(
+  scope: WebPluginInstallPayload["scope"],
+): WebPluginInstallScope {
+  return scope === "project" ? "project" : "user";
+}
+
+/**
+ * 渲染单个 Skill 的安装工作流。
+ */
+function render_skill_install_step(skill_name: string): string {
+  return [
+    `- Call \`plugin_call({ plugin: "skill", action: "install", payload: { spec: "${skill_name}" } })\`.`,
+    "  Follow the returned scan-aware Shell instructions. The WebPlugin has not installed this Skill.",
+  ].join("\n");
+}
+
+/**
+ * 渲染 agent-browser CLI 的安装提示。
+ */
+function render_agent_browser_cli_step(scope: WebPluginInstallScope): string {
+  if (scope === "project") {
+    return [
+      "- Inspect the project lockfile and use its existing package manager to install `agent-browser` as a devDependency:",
+      "  - pnpm: `pnpm add -D agent-browser`",
+      "  - npm: `npm install -D agent-browser`",
+      "  - yarn: `yarn add -D agent-browser`",
+      "- Verify the project-local CLI with the matching package-manager command, for example `pnpm exec agent-browser --help`.",
+    ].join("\n");
+  }
+
+  return [
+    "- Install the CLI globally with `npm install -g agent-browser`.",
+    "- Verify it with `agent-browser --help`.",
+  ].join("\n");
+}
+
+/**
+ * 生成 web install action 返回的纯提示词。
+ */
+export function render_web_install_prompt(
+  payload: WebPluginInstallPayload | null | undefined,
+): WebPluginInstallInstructions {
+  const target = resolve_install_target(payload?.target);
+  const scope = resolve_install_scope(payload?.scope);
+  const skill_names =
+    target === "all" ? ["web-access", "agent-browser"] : [target];
+  const skill_steps = skill_names.map(render_skill_install_step).join("\n");
+  const cli_steps =
+    target === "agent-browser" || target === "all"
+      ? ["", "## agent-browser CLI", render_agent_browser_cli_step(scope)]
+      : [];
+
+  const prompt = [
+    "# Install Web Capabilities Instructions",
+    "",
+    "This action only returns instructions. It has not executed commands, accessed the network, installed dependencies, or changed files.",
+    "",
+    "## Skills",
+    skill_steps,
+    ...cli_steps,
+    "",
+    "## Verification",
+    "After completing the Shell steps, call `plugin_call({ plugin: \"skill\", action: \"list\", payload: {} })` and confirm every requested Skill is discoverable.",
+    "Call `skill.lookup` for each installed Skill before using it.",
+    "If the `skill` plugin is unavailable, configure it before installing a Skill; do not guess an unscanned destination.",
+  ].join("\n");
+
+  return { kind: "instructions", target, scope, prompt };
+}

package/src/web/types/WebPlugin.ts

@@ -3,63 +3,76 @@
  *
  * 关键点（中文）
  * - web plugin 只注入联网方法论，不维护 provider 运行态。
- * - install action 仅用于准备联网相关 skill 与工具依赖。
- * - target 表示要准备的联网能力，不表示 agent 运行时默认选择。
+ * - install action 只返回安装提示，不执行命令或修改文件。
+ * - target 表示需要安装说明的联网能力，不表示 agent 运行时默认选择。
  */
 
-import type { JsonValue } from "@downcity/agent";
+import type { JsonObject } from "@downcity/agent";
 
 /**
- * WebPlugin 可安装目标。
+ * WebPlugin action 名称常量。
+ */
+export const WEB_PLUGIN_ACTIONS = {
+  /**
+   * 返回联网能力的安装操作提示。
+   */
+  install: "install",
+} as const;
+
+/**
+ * WebPlugin 安装提示目标。
  */
 export type WebPluginInstallTarget = "web-access" | "agent-browser" | "all";
 
 /**
- * WebPlugin 安装作用域。
+ * agent-browser CLI 安装作用域。
  */
 export type WebPluginInstallScope = "user" | "project";
 
 /**
- * WebPlugin install action 输入。
+ * WebPlugin install 提示 action 输入。
  */
 export interface WebPluginInstallPayload {
   /**
-   * 要准备的联网能力。
+   * 需要获取安装说明的联网能力。
    *
    * 说明（中文）
-   * - `web-access`：安装 web-access skill。
-   * - `agent-browser`：安装 agent-browser skill，并准备 agent-browser CLI 包。
-   * - `all`：同时准备以上能力。
-   * - 默认值为 `web-access`，避免默认安装额外 CLI。
+   * - `web-access`：返回 web-access Skill 的安装工作流。
+   * - `agent-browser`：返回 agent-browser Skill 与 CLI 的安装工作流。
+   * - `all`：返回以上全部能力的安装工作流。
+   * - 默认值为 `web-access`。
    */
   target?: WebPluginInstallTarget;
   /**
-   * 安装作用域。
+   * agent-browser CLI 的安装作用域。
    *
    * 说明（中文）
-   * - `user`：安装到用户级 skill / npm 全局环境。
-   * - `project`：安装到当前项目级 skill / devDependency。
-   * - 默认值为 `user`，避免默认修改项目依赖。
+   * - `user`：提示 Agent 将 CLI 安装到 npm 全局环境。
+   * - `project`：提示 Agent 使用项目已有的包管理器安装 devDependency。
+   * - Skill 安装位置由 SkillPlugin 的扫描配置决定，不受此字段控制。
+   * - 默认值为 `user`。
    */
   scope?: WebPluginInstallScope;
+}
+
+/**
+ * WebPlugin install action 返回的安装提示数据。
+ */
+export interface WebPluginInstallInstructions extends JsonObject {
   /**
-   * 是否跳过安装确认。
-   *
-   * 说明（中文）
-   * - 会透传给底层 skill installer。
-   * - 默认值为 `true`，适合 agent 自动执行。
+   * 标识当前结果只包含操作说明。
    */
-  yes?: boolean;
+  kind: "instructions";
   /**
-   * skill installer 的目标 agent 名称。
-   *
-   * 说明（中文）
-   * - 留空时不向底层 skill installer 传递 `--agent`。
-   * - 只有需要显式指定 installer 目标时才传入。
+   * 已归一化的联网能力目标。
+   */
+  target: WebPluginInstallTarget;
+  /**
+   * 已归一化的 agent-browser CLI 安装作用域。
    */
-  agent?: string;
+  scope: WebPluginInstallScope;
   /**
-   * 允许保留额外 JSON 字段，便于未来扩展安装器参数。
+   * 提供给 Agent 执行的完整安装说明。
    */
-  [key: string]: JsonValue | undefined;
+  prompt: string;
 }

package/src/workboard/runtime/Collector.ts

@@ -29,7 +29,7 @@ export async function collectWorkboardSnapshot(
   context: AgentContext,
 ): Promise<WorkboardSnapshot> {
   const collectedAt = new Date().toISOString();
-  const executingSessionIds = new Set(context.session.listExecutingSessionIds());
+  const executingSessionIds = new Set(context.sessions.list_executing_session_ids());
   const sessions = await listWorkboardSessionSummaries({
     context,
     limit: WORKBOARD_RECENT_LIMIT + Math.max(executingSessionIds.size, 1),

package/src/workboard/runtime/Normalizer.ts

@@ -92,7 +92,7 @@ export function toWorkboardAgentSummary(params: {
   });
 
   return {
-    name: String(params.context.config.id || "").trim() || "agent",
+    name: String(params.context.agent_id || "").trim() || "agent",
     running: true,
     statusText,
     collectedAt: params.collectedAt,

package/src/workboard/runtime/SessionSummary.ts

@@ -6,8 +6,6 @@
  * - 这里只读取消息数量、更新时间与执行中状态，不暴露消息内容。
  */
 
-import fs from "fs-extra";
-import path from "node:path";
 import type { AgentContext } from "@downcity/agent";
 
 /**
@@ -49,44 +47,15 @@ export async function listWorkboardSessionSummaries(params: {
    */
   executingSessionIds?: Set<string>;
 }): Promise<WorkboardSessionSummary[]> {
-  const root_dir = params.context.paths.getDowncitySessionRootDirPath();
-  if (!(await fs.pathExists(root_dir))) return [];
-
-  const entries = await fs.readdir(root_dir, { withFileTypes: true });
-  const items: WorkboardSessionSummary[] = [];
-
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const session_id = decodeMaybe(entry.name);
-    if (!session_id) continue;
-    const messages_path = path.join(
-      params.context.paths.getDowncitySessionDirPath(session_id),
-      "messages",
-      "messages.jsonl",
-    );
-    const stat = await fs.stat(messages_path).catch(() => null);
-    items.push({
-      sessionId: session_id,
-      messageCount: await countJsonlLines(messages_path),
-      ...(stat ? { updatedAt: stat.mtimeMs } : {}),
-      ...(params.executingSessionIds?.has(session_id) ? { executing: true } : {}),
-    });
-  }
-
-  items.sort((a, b) => (b.updatedAt || 0) - (a.updatedAt || 0));
-  return items.slice(0, Math.max(1, params.limit));
-}
-
-async function countJsonlLines(file_path: string): Promise<number> {
-  const raw = await fs.readFile(file_path, "utf-8").catch(() => "");
-  if (!raw) return 0;
-  return raw.split("\n").filter((line) => line.trim()).length;
-}
-
-function decodeMaybe(value: string): string {
-  try {
-    return decodeURIComponent(String(value || "")).trim();
-  } catch {
-    return String(value || "").trim();
-  }
+  const page = await params.context.sessions.list({
+    limit: Math.max(1, params.limit),
+  });
+  return page.items.map((item) => ({
+    sessionId: item.sessionId,
+    messageCount: item.messageCount,
+    ...(typeof item.updatedAt === "number" ? { updatedAt: item.updatedAt } : {}),
+    ...(item.executing || params.executingSessionIds?.has(item.sessionId)
+      ? { executing: true }
+      : {}),
+  }));
 }

package/bin/asr/Plugin.d.ts

@@ -1,63 +0,0 @@
-/**
- * AsrPlugin：语音转写插件。
- *
- * 关键点（中文）
- * - ASR 能力通过 constructor 注入，推荐传入 `city.ai.asr`。
- * - plugin 不负责本地模型、Python 依赖、provider 或项目配置。
- * - `auto: true` 时会在 chat 入站阶段自动转写 voice/audio 附件，并把结果写入正文。
- */
-import { BasePlugin } from "@downcity/agent";
-import type { AgentContext } from "@downcity/agent";
-import type { JsonObject, JsonValue } from "@downcity/agent";
-import type { AsrPluginOptions } from "../asr/types/AsrPlugin.js";
-/**
- * Agent ASR 插件。
- */
-export declare class AsrPlugin extends BasePlugin {
-    /**
-     * 当前 plugin 稳定名称。
-     */
-    readonly name: string;
-    /**
-     * 插件标题。
-     */
-    readonly title: string;
-    /**
-     * 插件说明。
-     */
-    readonly description: string;
-    private readonly asr;
-    private readonly auto;
-    private readonly language?;
-    constructor(options: AsrPluginOptions);
-    /**
-     * ASR 插件给模型的使用说明。
-     */
-    system(_context: AgentContext): string;
-    /**
-     * 执行一次 ASR 转写。
-     */
-    private transcribe;
-    /**
-     * 自动增强 chat 入站消息。
-     */
-    private auto_transcribe_inbound;
-    /**
-     * pipeline / action 扩展点。
-     */
-    readonly hooks: {
-        pipeline: {
-            "chat.augmentInbound": (({ context, value }: {
-                context: AgentContext;
-                value: JsonValue;
-            }) => Promise<JsonValue>)[];
-        };
-    };
-    /**
-     * 显式 action 集合。
-     */
-    readonly actions: {
-        transcribe: import("@downcity/agent").PluginAction<JsonValue, JsonObject>;
-    };
-}
-//# sourceMappingURL=Plugin.d.ts.map

package/bin/asr/Plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/asr/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACV,MAAM,iBAAiB,CAAC;AAMzB,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,0BAA0B,CAAC;AAoGlC;;GAEG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA0B;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,OAAO,EAAE,gBAAgB;IAsBrC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM;IA4BtC;;OAEG;YACW,UAAU;IAQxB;;OAEG;YACW,uBAAuB;IAqCrC;;OAEG;IACH,QAAQ,CAAC,KAAK;;yDAGmB;gBAAE,OAAO,EAAE,YAAY,CAAC;gBAAC,KAAK,EAAE,SAAS,CAAA;aAAE;;MAK1E;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO;;MAkDd;CACH"}