@downcity/plugins 1.0.52 → 1.0.57

package/bin/web/WebPromptAssets.d.ts

@@ -3,18 +3,10 @@
  *
  * 关键点（中文）
  * - prompt 文本真实来源是 `*.ts.txt` 文本文件。
- * - `agent-browser` prompt 仍会被安装流程复用为默认 SKILL.md 内容。
+ * - web plugin 只保留通用联网方法论，不再维护 provider 专属提示词。
  */
 /**
  * web plugin 基础 prompt。
  */
 export declare const WEB_PLUGIN_PROMPT: string;
-/**
- * web-access provider prompt。
- */
-export declare const WEB_ACCESS_PROMPT: string;
-/**
- * agent-browser provider prompt。
- */
-export declare const AGENT_BROWSER_PROMPT: string;
 //# sourceMappingURL=WebPromptAssets.d.ts.map

package/bin/web/WebPromptAssets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebPromptAssets.d.ts","sourceRoot":"","sources":["../../src/web/WebPromptAssets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAgC,CAAC"}
+{"version":3,"file":"WebPromptAssets.d.ts","sourceRoot":"","sources":["../../src/web/WebPromptAssets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAA6B,CAAC"}

package/bin/web/WebPromptAssets.js

@@ -3,21 +3,11 @@
  *
  * 关键点（中文）
  * - prompt 文本真实来源是 `*.ts.txt` 文本文件。
- * - `agent-browser` prompt 仍会被安装流程复用为默认 SKILL.md 内容。
+ * - web plugin 只保留通用联网方法论，不再维护 provider 专属提示词。
  */
-import agentBrowserPromptText from "../web/PROMPT.agent-browser.js";
 import webPluginPromptText from "../web/PROMPT.js";
-import webAccessPromptText from "../web/PROMPT.web-access.js";
 /**
  * web plugin 基础 prompt。
  */
 export const WEB_PLUGIN_PROMPT = webPluginPromptText.trim();
-/**
- * web-access provider prompt。
- */
-export const WEB_ACCESS_PROMPT = webAccessPromptText.trim();
-/**
- * agent-browser provider prompt。
- */
-export const AGENT_BROWSER_PROMPT = agentBrowserPromptText.trim();
 //# sourceMappingURL=WebPromptAssets.js.map

package/bin/web/WebPromptAssets.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebPromptAssets.js","sourceRoot":"","sources":["../../src/web/WebPromptAssets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,sBAAsB,MAAM,+BAA+B,CAAC;AACnE,OAAO,mBAAmB,MAAM,iBAAiB,CAAC;AAClD,OAAO,mBAAmB,MAAM,4BAA4B,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,IAAI,EAAE,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,IAAI,EAAE,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"WebPromptAssets.js","sourceRoot":"","sources":["../../src/web/WebPromptAssets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,mBAAmB,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,IAAI,EAAE,CAAC"}

package/bin/web/runtime/Install.d.ts

@@ -0,0 +1,19 @@
+/**
+ * WebPlugin 安装器。
+ *
+ * 关键点（中文）
+ * - install 只负责准备联网相关 skill / CLI 依赖，不写 provider 配置。
+ * - skill 安装复用 SkillPlugin 的 `npx skills` 通道，避免 web 自建 registry。
+ * - agent-browser 额外准备 npm CLI 包，因为其 skill 需要 `agent-browser` 命令可用。
+ */
+import type { JsonObject } from "@downcity/agent/internal/types/common/Json.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { WebPluginInstallPayload } from "../../web/types/WebPlugin.js";
+/**
+ * 执行 WebPlugin install action。
+ */
+export declare function installWebPluginTargets(params: {
+    context: AgentContext;
+    payload?: WebPluginInstallPayload | null;
+}): Promise<JsonObject>;
+//# sourceMappingURL=Install.d.ts.map

package/bin/web/runtime/Install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Install.d.ts","sourceRoot":"","sources":["../../../src/web/runtime/Install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,UAAU,EAEX,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAEjG,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,0BAA0B,CAAC;AAgLlC;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC1C,GAAG,OAAO,CAAC,UAAU,CAAC,CAoCtB"}

package/bin/web/runtime/Install.js

@@ -0,0 +1,178 @@
+/**
+ * WebPlugin 安装器。
+ *
+ * 关键点（中文）
+ * - install 只负责准备联网相关 skill / CLI 依赖，不写 provider 配置。
+ * - skill 安装复用 SkillPlugin 的 `npx skills` 通道，避免 web 自建 registry。
+ * - agent-browser 额外准备 npm CLI 包，因为其 skill 需要 `agent-browser` 命令可用。
+ */
+import { execa } from "execa";
+import fs from "node:fs";
+import path from "node:path";
+import { skillInstallCommand } from "../../skill/Command.js";
+/**
+ * 读取字符串字段。
+ */
+function read_string(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+/**
+ * 读取布尔字段。
+ */
+function read_boolean(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+/**
+ * 归一化安装目标。
+ */
+function resolve_install_target(value) {
+    const target = read_string(value);
+    if (target === "web-access" || target === "agent-browser" || target === "all") {
+        return target;
+    }
+    return "web-access";
+}
+/**
+ * 归一化安装作用域。
+ */
+function resolve_install_scope(value) {
+    const scope = read_string(value);
+    return scope === "project" ? "project" : "user";
+}
+/**
+ * 判断命令是否已经可用。
+ */
+async function command_exists(command) {
+    try {
+        const result = await execa(command, ["--help"], {
+            reject: false,
+            timeout: 15_000,
+        });
+        return (result.exitCode ?? 1) === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 执行 npm 包安装。
+ */
+async function install_npm_package(params) {
+    if (params.scope === "project") {
+        const package_manager = resolve_project_package_manager(params.root_path);
+        const args = package_manager === "pnpm"
+            ? ["add", "-D", params.package_name]
+            : package_manager === "yarn"
+                ? ["add", "-D", params.package_name]
+                : ["install", "--save-dev", params.package_name];
+        await execa(package_manager, args, {
+            cwd: params.root_path,
+            stdio: "inherit",
+        });
+        return;
+    }
+    await execa("npm", ["install", "-g", params.package_name], {
+        stdio: "inherit",
+    });
+}
+/**
+ * 根据锁文件推断项目包管理器。
+ */
+function resolve_project_package_manager(root_path) {
+    if (fs.existsSync(path.join(root_path, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (fs.existsSync(path.join(root_path, "yarn.lock")))
+        return "yarn";
+    return "npm";
+}
+/**
+ * 将步骤列表转成 JSON。
+ */
+function serialize_steps(steps) {
+    return steps.map((step) => ({
+        name: step.name,
+        success: step.success,
+        message: step.message,
+    }));
+}
+/**
+ * 安装 skill。
+ */
+async function install_skill(params) {
+    await skillInstallCommand(params.spec, {
+        global: params.scope === "user",
+        yes: params.yes,
+        agent: params.agent,
+    });
+    params.steps.push({
+        name: `${params.spec}:skill`,
+        success: true,
+        message: params.scope === "user"
+            ? `Installed ${params.spec} skill in user scope.`
+            : `Installed ${params.spec} skill in project scope.`,
+    });
+}
+/**
+ * 准备 agent-browser CLI。
+ */
+async function install_agent_browser_cli(params) {
+    if (await command_exists("agent-browser")) {
+        params.steps.push({
+            name: "agent-browser:cli",
+            success: true,
+            message: "agent-browser CLI is already available.",
+        });
+        return;
+    }
+    await install_npm_package({
+        root_path: params.context.rootPath,
+        package_name: "agent-browser",
+        scope: params.scope,
+    });
+    params.steps.push({
+        name: "agent-browser:cli",
+        success: true,
+        message: params.scope === "user"
+            ? "Installed agent-browser CLI globally with npm."
+            : "Installed agent-browser as a project devDependency.",
+    });
+}
+/**
+ * 执行 WebPlugin install action。
+ */
+export async function installWebPluginTargets(params) {
+    const payload = params.payload || {};
+    const target = resolve_install_target(payload.target);
+    const scope = resolve_install_scope(payload.scope);
+    const yes = read_boolean(payload.yes) ?? true;
+    const agent = read_string(payload.agent) || "claude-code";
+    const targets = target === "all" ? ["web-access", "agent-browser"] : [target];
+    const steps = [];
+    for (const item of targets) {
+        await install_skill({
+            spec: item,
+            scope,
+            yes,
+            agent,
+            steps,
+        });
+        if (item === "agent-browser") {
+            await install_agent_browser_cli({
+                context: params.context,
+                scope,
+                steps,
+            });
+        }
+    }
+    return {
+        target,
+        scope,
+        agent,
+        steps: serialize_steps(steps),
+        nextAction: "Use SkillPlugin lookup/list to inspect installed skills, then let the agent choose the concrete web path during task execution.",
+    };
+}
+//# sourceMappingURL=Install.js.map

package/bin/web/runtime/Install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Install.js","sourceRoot":"","sources":["../../../src/web/runtime/Install.ts"],"names":[],"mappings":"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"}

package/bin/web/types/WebPlugin.d.ts

@@ -1,133 +1,61 @@
 /**
- * Web Plugin 协议类型。
+ * WebPlugin 协议类型。
  *
  * 关键点（中文）
- * - `web` plugin 只负责选择 provider、管理少量配置，并注入对应项目的提示词。
- * - 联网能力本身由外部实现承担：`web-access` 或 `agent-browser`。
+ * - web plugin 只注入联网方法论，不维护 provider 运行态。
+ * - install action 仅用于准备联网相关 skill 与工具依赖。
+ * - target 表示要准备的联网能力，不表示 agent 运行时默认选择。
  */
 import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
 /**
- * Web plugin 默认依赖仓库地址。
+ * WebPlugin 可安装目标。
  */
-export declare const WEB_PLUGIN_DEFAULT_REPOSITORY_URL = "https://github.com/eze-is/web-access";
+export type WebPluginInstallTarget = "web-access" | "agent-browser" | "all";
 /**
- * Web plugin provider。
- */
-export type WebPluginProvider = "web-access" | "agent-browser";
-/**
- * Web plugin 安装作用域。
+ * WebPlugin 安装作用域。
  */
 export type WebPluginInstallScope = "user" | "project";
 /**
- * Web plugin 配置。
+ * WebPlugin install action 输入。
  */
-export interface WebPluginConfig {
-    /**
-     * 兼容统一结构化配置约束的索引签名。
-     */
-    [key: string]: JsonValue | undefined;
-    /**
-     * 当前使用的 provider。
-     */
-    provider?: WebPluginProvider;
+export interface WebPluginInstallPayload {
     /**
-     * 是否向 agent 注入 provider 提示词。
+     * 要准备的联网能力。
+     *
+     * 说明（中文）
+     * - `web-access`：安装 web-access skill。
+     * - `agent-browser`：安装 agent-browser skill，并准备 agent-browser CLI 包。
+     * - `all`：同时准备以上能力。
+     * - 默认值为 `web-access`，避免默认安装额外 CLI。
      */
-    injectPrompt?: boolean;
+    target?: WebPluginInstallTarget;
     /**
-     * provider 来源仓库地址。
+     * 安装作用域。
+     *
+     * 说明（中文）
+     * - `user`：安装到用户级 skill / npm 全局环境。
+     * - `project`：安装到当前项目级 skill / devDependency。
+     * - 默认值为 `user`，避免默认修改项目依赖。
      */
-    repositoryUrl?: string;
+    scope?: WebPluginInstallScope;
     /**
-     * provider 版本标签或备注。
+     * 是否跳过安装确认。
+     *
+     * 说明（中文）
+     * - 会透传给底层 skill installer。
+     * - 默认值为 `true`，适合 agent 自动执行。
      */
-    sourceVersion?: string;
+    yes?: boolean;
     /**
-     * agent-browser 命令名（可选）。
+     * skill installer 的目标 agent 名称。
+     *
+     * 说明（中文）
+     * - 默认使用 `claude-code`，与现有 SkillPlugin 安装行为保持一致。
      */
-    browserCommand?: string;
+    agent?: string;
     /**
-     * skill 安装作用域。
+     * 允许保留额外 JSON 字段，便于未来扩展安装器参数。
      */
-    installScope?: WebPluginInstallScope;
-}
-/**
- * 归一化后的 web plugin 配置。
- */
-export interface ResolvedWebPluginConfig {
-    /**
-     * 当前 provider。
-     */
-    provider: WebPluginProvider;
-    /**
-     * 是否注入 prompt。
-     */
-    injectPrompt: boolean;
-    /**
-     * 仓库地址。
-     */
-    repositoryUrl: string;
-    /**
-     * provider 版本标签（可选）。
-     */
-    sourceVersion?: string;
-    /**
-     * 浏览器命令。
-     */
-    browserCommand: string;
-    /**
-     * skill 安装作用域。
-     */
-    installScope: WebPluginInstallScope;
-}
-/**
- * web plugin setup/install 输入。
- */
-export interface WebPluginInstallInput {
-    /**
-     * provider。
-     */
-    provider?: WebPluginProvider;
-    /**
-     * 是否注入 prompt。
-     */
-    injectPrompt?: boolean;
-    /**
-     * 来源仓库地址。
-     */
-    repositoryUrl?: string;
-    /**
-     * 版本标签。
-     */
-    sourceVersion?: string;
-    /**
-     * 浏览器命令（可选）。
-     */
-    browserCommand?: string;
-    /**
-     * 安装作用域（可选）。
-     */
-    installScope?: WebPluginInstallScope;
-}
-/**
- * web plugin 依赖检查结果。
- */
-export interface WebPluginDependencyCheckResult {
-    /**
-     * 当前 provider 是否可用。
-     */
-    available: boolean;
-    /**
-     * 当前 provider 是否已就绪。
-     */
-    installed: boolean;
-    /**
-     * 不可用原因列表。
-     */
-    reasons: string[];
-    /**
-     * 结构化详情（可选）。
-     */
-    details?: JsonValue;
+    [key: string]: JsonValue | undefined;
 }
 //# sourceMappingURL=WebPlugin.d.ts.map

package/bin/web/types/WebPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebPlugin.d.ts","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,iCAAiC,yCACN,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,eAAe,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,YAAY,EAAE,qBAAqB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB"}
+{"version":3,"file":"WebPlugin.d.ts","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,eAAe,GAAG,KAAK,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACtC"}

package/bin/web/types/WebPlugin.js

@@ -1,12 +1,10 @@
 /**
- * Web Plugin 协议类型。
+ * WebPlugin 协议类型。
  *
  * 关键点（中文）
- * - `web` plugin 只负责选择 provider、管理少量配置，并注入对应项目的提示词。
- * - 联网能力本身由外部实现承担：`web-access` 或 `agent-browser`。
+ * - web plugin 只注入联网方法论，不维护 provider 运行态。
+ * - install action 仅用于准备联网相关 skill 与工具依赖。
+ * - target 表示要准备的联网能力，不表示 agent 运行时默认选择。
  */
-/**
- * Web plugin 默认依赖仓库地址。
- */
-export const WEB_PLUGIN_DEFAULT_REPOSITORY_URL = "https://github.com/eze-is/web-access";
+export {};
 //# sourceMappingURL=WebPlugin.js.map

package/bin/web/types/WebPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebPlugin.js","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAC5C,sCAAsC,CAAC"}
+{"version":3,"file":"WebPlugin.js","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/workboard/Plugin.d.ts

@@ -5,13 +5,12 @@
  * - workboard 是一个 runtime 观测面板插件，负责提供结构化工作快照。
  * - 当前同时通过 plugin action 与 HTTP 注入提供快照，供 Town RPC 与 Town HTTP gateway 复用。
  */
-import type { AgentRuntime } from "@downcity/agent/internal/types/runtime/agent/AgentRuntime.js";
 import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
 /**
  * WorkboardPlugin：运行态观测面板插件。
  */
 export declare class WorkboardPlugin extends BasePlugin {
     readonly name = "workboard";
-    constructor(agent?: AgentRuntime | null);
+    constructor();
 }
 //# sourceMappingURL=Plugin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/workboard/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAkGhF;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,eAAe;gBAEhB,KAAK,GAAE,YAAY,GAAG,IAAW;CAI9C"}
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/workboard/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAkGhF;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,eAAe;;CAM7B"}

package/bin/workboard/Plugin.js

@@ -95,8 +95,8 @@ function createWorkboardPluginDefinition(plugin) {
  */
 export class WorkboardPlugin extends BasePlugin {
     name = "workboard";
-    constructor(agent = null) {
-        super(agent);
+    constructor() {
+        super();
         Object.assign(this, createWorkboardPluginDefinition(this));
     }
 }

package/bin/workboard/Plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/workboard/Plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/workboard/Plugin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/plugins",
-  "version": "1.0.52",
+  "version": "1.0.57",
   "type": "module",
   "description": "Downcity 内建 plugin 集合包",
   "main": "./bin/index.js",
@@ -22,7 +22,7 @@
     "node-cron": "^4.2.1",
     "ws": "^8.21.0",
     "zod": "^4.4.3",
-    "@downcity/agent": "^1.1.101"
+    "@downcity/agent": "^1.1.105"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",

package/src/BuiltinPlugins.ts

@@ -7,13 +7,10 @@
  * - 调用方需要完整内建集合时，显式调用 `createBuiltinPlugins()` 并传给 Agent 或通用 helper。
  */
 
-import type { AgentRuntime } from "@downcity/agent/internal/types/runtime/agent/AgentRuntime.js";
 import type { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
 import { ChatAuthorizationPlugin } from "@/auth/Plugin.js";
 import { SkillPlugin } from "@/skill/Plugin.js";
 import { WebPlugin } from "@/web/Plugin.js";
-import { AsrPlugin } from "@/asr/Plugin.js";
-import { TtsPlugin } from "@/tts/Plugin.js";
 import { WorkboardPlugin } from "@/workboard/Plugin.js";
 import { ChatPlugin } from "@/chat/ChatPlugin.js";
 import { ContactPlugin } from "@/contact/ContactPlugin.js";
@@ -24,9 +21,7 @@ import { ShellPlugin } from "@/shell/ShellPlugin.js";
 /**
  * 内建 plugin class 构造器。
  */
-export type BuiltinPluginClass<T extends BasePlugin = BasePlugin> = new (
-  agent: AgentRuntime | null,
-) => T;
+export type BuiltinPluginClass<T extends BasePlugin = BasePlugin> = new () => T;
 
 /**
  * 全部内建 plugin classes。
@@ -35,8 +30,6 @@ export const BUILTIN_PLUGIN_CLASSES: BuiltinPluginClass[] = [
   ChatAuthorizationPlugin,
   SkillPlugin,
   WebPlugin,
-  AsrPlugin,
-  TtsPlugin,
   WorkboardPlugin,
   ChatPlugin,
   ContactPlugin,
@@ -48,6 +41,6 @@ export const BUILTIN_PLUGIN_CLASSES: BuiltinPluginClass[] = [
 /**
  * 创建完整内建 plugin 实例集合。
  */
-export function createBuiltinPlugins(agent: AgentRuntime | null = null): BasePlugin[] {
-  return BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass(agent));
+export function createBuiltinPlugins(): BasePlugin[] {
+  return BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass());
 }