@downcity/plugins 1.0.56 → 1.0.59

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);
+    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 ? { 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,62 @@
 /**
- * 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 名称。
+     *
+     * 说明（中文）
+     * - 留空时不向底层 skill installer 传递 `--agent`。
+     * - 只有需要显式指定 installer 目标时才传入。
      */
-    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;;;;;;OAMG;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

@@ -2,15 +2,35 @@
  * Workboard Plugin。
  *
  * 关键点（中文）
- * - workboard 是一个 runtime 观测面板插件，负责提供结构化工作快照。
- * - 当前同时通过 plugin action 与 HTTP 注入提供快照，供 Town RPC 与 Town HTTP gateway 复用。
+ * - workboard 是 runtime 观测面板插件，负责提供结构化工作快照。
+ * - plugin action 与 HTTP route 共享同一份快照读取逻辑。
+ * - 是否启用由是否注册该 plugin 决定，不再读取项目配置做二次开关。
  */
 import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
+import type { PluginActions, PluginHttpDefinition } from "@downcity/agent/internal/plugin/types/Plugin.js";
 /**
  * WorkboardPlugin：运行态观测面板插件。
  */
 export declare class WorkboardPlugin extends BasePlugin {
+    /**
+     * 当前 plugin 稳定名称。
+     */
     readonly name = "workboard";
-    constructor();
+    /**
+     * 插件标题。
+     */
+    readonly title = "Workboard Snapshot";
+    /**
+     * 插件说明。
+     */
+    readonly description = "Collects structured runtime activity snapshots so console surfaces can show what the current agent is doing now and what it recently worked on.";
+    /**
+     * Workboard 对外 action。
+     */
+    readonly actions: PluginActions;
+    /**
+     * Workboard HTTP route。
+     */
+    readonly http: PluginHttpDefinition;
 }
 //# 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,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAkGhF;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,eAAe;;CAM7B"}
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/workboard/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,iDAAiD,CAAC;AAqBzD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C;;OAEG;IACH,QAAQ,CAAC,IAAI,eAAe;IAE5B;;OAEG;IACH,QAAQ,CAAC,KAAK,wBAAwB;IAEtC;;OAEG;IACH,QAAQ,CAAC,WAAW,qJACgI;IAEpJ;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAY7B;IAEF;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CA0BjC;CACH"}