@downcity/agent 1.1.1

package/bin/plugins/web/runtime/Config.js

@@ -0,0 +1,79 @@
+/**
+ * Web Plugin 配置读写。
+ *
+ * 关键点（中文）
+ * - `web` 默认启用，不要求用户先在 `downcity.json` 写配置。
+ * - 只有当用户显式改动时，才把 `plugins.web` 持久化到项目配置。
+ */
+import { WEB_PLUGIN_DEFAULT_REPOSITORY_URL } from "../../../shared/types/WebPlugin.js";
+function toJsonObject(input) {
+    const out = {};
+    if (!input)
+        return out;
+    for (const [key, value] of Object.entries(input)) {
+        if (value === null ||
+            typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean") {
+            out[key] = value;
+            continue;
+        }
+        if (Array.isArray(value)) {
+            out[key] = value.filter((item) => item !== undefined);
+            continue;
+        }
+        if (value && typeof value === "object") {
+            out[key] = toJsonObject(value);
+        }
+    }
+    return out;
+}
+function readWebPluginRecord(context) {
+    const current = context.config.plugins?.web;
+    if (!current || typeof current !== "object" || Array.isArray(current)) {
+        return {};
+    }
+    return current;
+}
+/**
+ * 读取并归一化 web plugin 配置。
+ */
+export function readWebPluginConfig(context) {
+    const { enabled: _ignoredEnabled, ...current } = readWebPluginRecord(context);
+    return {
+        provider: current.provider === "agent-browser" || current.provider === "web-access"
+            ? current.provider
+            : "web-access",
+        injectPrompt: typeof current.injectPrompt === "boolean" ? current.injectPrompt : true,
+        repositoryUrl: typeof current.repositoryUrl === "string" && current.repositoryUrl.trim()
+            ? current.repositoryUrl.trim()
+            : WEB_PLUGIN_DEFAULT_REPOSITORY_URL,
+        ...(typeof current.sourceVersion === "string" && current.sourceVersion.trim()
+            ? { sourceVersion: current.sourceVersion.trim() }
+            : {}),
+        browserCommand: typeof current.browserCommand === "string" && current.browserCommand.trim()
+            ? current.browserCommand.trim()
+            : "agent-browser",
+        installScope: current.installScope === "project" || current.installScope === "user"
+            ? current.installScope
+            : "user",
+    };
+}
+/**
+ * 写入 web plugin 配置。
+ */
+export async function writeWebPluginConfig(params) {
+    if (!params.context.config.plugins) {
+        params.context.config.plugins = {};
+    }
+    const current = readWebPluginConfig(params.context);
+    const next = {
+        ...current,
+        ...params.value,
+    };
+    delete next.enabled;
+    params.context.config.plugins.web = toJsonObject(next);
+    await params.context.pluginConfig.persistProjectPlugins(params.context.config.plugins);
+    return readWebPluginConfig(params.context);
+}
+//# sourceMappingURL=Config.js.map

package/bin/plugins/web/runtime/Config.js.map

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

package/bin/plugins/web/runtime/Source.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Web Plugin 来源信息与兼容安装动作。
+ *
+ * 关键点（中文）
+ * - 这里不自建联网实现，只检查外部 provider 是否就绪，并记录少量配置。
+ */
+import type { JsonObject } from "../../../shared/types/Json.js";
+import type { PluginCommandContext } from "../../../shared/types/Plugin.js";
+import type { WebPluginDependencyCheckResult, WebPluginInstallInput } from "../../../shared/types/WebPlugin.js";
+/**
+ * 返回当前来源快照。
+ */
+export declare function inspectWebPluginDependency(context: PluginCommandContext): Promise<WebPluginDependencyCheckResult>;
+/**
+ * 兼容 install 动作。
+ */
+export declare function installWebPluginDependency(params: {
+    context: PluginCommandContext;
+    input?: WebPluginInstallInput;
+}): Promise<{
+    success: boolean;
+    message?: string;
+    details?: JsonObject;
+}>;
+/**
+ * doctor 结果与 inspect 一致。
+ */
+export declare function doctorWebPluginDependency(context: PluginCommandContext): Promise<WebPluginDependencyCheckResult>;
+//# sourceMappingURL=Source.d.ts.map

package/bin/plugins/web/runtime/Source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Source.d.ts","sourceRoot":"","sources":["../../../../src/plugins/web/runtime/Source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EACV,8BAA8B,EAC9B,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAoHrC;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,8BAA8B,CAAC,CA2CzC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB,CAAC,CA2DD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,8BAA8B,CAAC,CAEzC"}

package/bin/plugins/web/runtime/Source.js

@@ -0,0 +1,215 @@
+/**
+ * Web Plugin 来源信息与兼容安装动作。
+ *
+ * 关键点（中文）
+ * - 这里不自建联网实现，只检查外部 provider 是否就绪，并记录少量配置。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import fsp from "node:fs/promises";
+import { execa } from "execa";
+import fse from "fs-extra";
+import { readWebPluginConfig, writeWebPluginConfig } from "../../../plugins/web/runtime/Config.js";
+import { readFileSync } from "node:fs";
+const AGENT_BROWSER_PROMPT_FILE_URL = new URL("../PROMPT.agent-browser.txt", import.meta.url);
+function toJsonObject(input) {
+    const out = {};
+    if (!input)
+        return out;
+    for (const [key, value] of Object.entries(input)) {
+        if (value === null ||
+            typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean") {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+function resolveWebAccessSkillCandidates(projectRoot) {
+    const home = process.env.HOME || "";
+    return [
+        path.join(projectRoot, ".agents", "skills", "web-access", "SKILL.md"),
+        path.join(home, ".agents", "skills", "web-access", "SKILL.md"),
+        path.join(projectRoot, ".claude", "skills", "web-access", "SKILL.md"),
+        path.join(home, ".claude", "skills", "web-access", "SKILL.md"),
+    ].filter(Boolean);
+}
+function resolveManagedSkillRoot(projectRoot, scope) {
+    if (scope === "project") {
+        return path.join(projectRoot, ".agents", "skills");
+    }
+    return path.join(process.env.HOME || os.homedir(), ".agents", "skills");
+}
+function resolveManagedSkillDir(params) {
+    return path.join(resolveManagedSkillRoot(params.projectRoot, params.scope), params.provider);
+}
+function loadBundledAgentBrowserSkillText() {
+    try {
+        return readFileSync(AGENT_BROWSER_PROMPT_FILE_URL, "utf-8").trim();
+    }
+    catch {
+        return "# agent-browser\n";
+    }
+}
+async function ensureAgentBrowserSkillInstalled(params) {
+    const targetDir = resolveManagedSkillDir({
+        projectRoot: params.projectRoot,
+        scope: params.scope,
+        provider: "agent-browser",
+    });
+    const skillPath = path.join(targetDir, "SKILL.md");
+    if (fs.existsSync(skillPath)) {
+        return skillPath;
+    }
+    await fsp.mkdir(targetDir, { recursive: true });
+    await fsp.writeFile(`${skillPath}`, `${loadBundledAgentBrowserSkillText()}\n`, "utf-8");
+    return skillPath;
+}
+async function ensureWebAccessSkillInstalled(params) {
+    const targetDir = resolveManagedSkillDir({
+        projectRoot: params.projectRoot,
+        scope: params.scope,
+        provider: "web-access",
+    });
+    const skillPath = path.join(targetDir, "SKILL.md");
+    if (fs.existsSync(skillPath)) {
+        return skillPath;
+    }
+    const source = String(params.source || "").trim();
+    if (source && fs.existsSync(source)) {
+        await fse.copy(path.resolve(source), targetDir, {
+            overwrite: true,
+            errorOnExist: false,
+        });
+        return skillPath;
+    }
+    await fsp.mkdir(path.dirname(targetDir), { recursive: true });
+    await execa("git", ["clone", "--depth=1", "https://github.com/eze-is/web-access", targetDir], {
+        reject: true,
+    });
+    return skillPath;
+}
+async function checkAgentBrowserCommand(command) {
+    try {
+        await execa(command, ["--help"], {
+            reject: false,
+            timeout: 15_000,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 返回当前来源快照。
+ */
+export async function inspectWebPluginDependency(context) {
+    const config = readWebPluginConfig(context);
+    if (config.provider === "agent-browser") {
+        const available = await checkAgentBrowserCommand(config.browserCommand);
+        return {
+            available,
+            installed: available,
+            reasons: available
+                ? []
+                : [
+                    `agent-browser command is not available: ${config.browserCommand}`,
+                    "Install or expose the agent-browser CLI before using this provider.",
+                ],
+            details: {
+                provider: config.provider,
+                browserCommand: config.browserCommand,
+                source: "external-project",
+                installScope: config.installScope,
+            },
+        };
+    }
+    const candidates = resolveWebAccessSkillCandidates(context.rootPath);
+    const skillPath = candidates.find((item) => fs.existsSync(item));
+    const available = Boolean(skillPath);
+    return {
+        available,
+        installed: available,
+        reasons: available
+            ? []
+            : [
+                "web-access skill is not found.",
+                "Install https://github.com/eze-is/web-access into ~/.agents/skills/web-access or project .agents/skills/web-access.",
+            ],
+        details: {
+            provider: config.provider,
+            source: "external-project",
+            repositoryUrl: config.repositoryUrl,
+            installScope: config.installScope,
+            ...(config.sourceVersion ? { sourceVersion: config.sourceVersion } : {}),
+            ...(skillPath ? { skillPath } : { checkedPaths: candidates }),
+        },
+    };
+}
+/**
+ * 兼容 install 动作。
+ */
+export async function installWebPluginDependency(params) {
+    const currentConfig = readWebPluginConfig(params.context);
+    const installScope = params.input?.installScope === "project" || params.input?.installScope === "user"
+        ? params.input.installScope
+        : currentConfig.installScope;
+    const provider = params.input?.provider === "agent-browser" || params.input?.provider === "web-access"
+        ? params.input.provider
+        : currentConfig.provider;
+    const installedSkillPath = provider === "agent-browser"
+        ? await ensureAgentBrowserSkillInstalled({
+            projectRoot: params.context.rootPath,
+            scope: installScope,
+        })
+        : await ensureWebAccessSkillInstalled({
+            projectRoot: params.context.rootPath,
+            scope: installScope,
+            source: params.input?.repositoryUrl,
+        });
+    const nextConfig = await writeWebPluginConfig({
+        context: params.context,
+        value: {
+            provider,
+            injectPrompt: typeof params.input?.injectPrompt === "boolean"
+                ? params.input.injectPrompt
+                : true,
+            ...(typeof params.input?.repositoryUrl === "string" &&
+                params.input.repositoryUrl.trim()
+                ? { repositoryUrl: params.input.repositoryUrl.trim() }
+                : {}),
+            ...(typeof params.input?.sourceVersion === "string" &&
+                params.input.sourceVersion.trim()
+                ? { sourceVersion: params.input.sourceVersion.trim() }
+                : {}),
+            ...(typeof params.input?.browserCommand === "string" &&
+                params.input.browserCommand.trim()
+                ? { browserCommand: params.input.browserCommand.trim() }
+                : {}),
+            installScope,
+        },
+    });
+    return {
+        success: true,
+        message: "web provider installed and configured",
+        details: toJsonObject({
+            provider: nextConfig.provider,
+            injectPrompt: nextConfig.injectPrompt,
+            repositoryUrl: nextConfig.repositoryUrl,
+            sourceVersion: nextConfig.sourceVersion || "",
+            browserCommand: nextConfig.browserCommand,
+            installScope: nextConfig.installScope,
+            skillPath: installedSkillPath,
+        }),
+    };
+}
+/**
+ * doctor 结果与 inspect 一致。
+ */
+export async function doctorWebPluginDependency(context) {
+    return inspectWebPluginDependency(context);
+}
+//# sourceMappingURL=Source.js.map

package/bin/plugins/web/runtime/Source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Source.js","sourceRoot":"","sources":["../../../../src/plugins/web/runtime/Source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,GAAG,MAAM,kBAAkB,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,GAAG,MAAM,UAAU,CAAC;AAO3B,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE9F,SAAS,YAAY,CAAC,KAAiD;IACrE,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IACE,KAAK,KAAK,IAAI;YACd,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,+BAA+B,CAAC,WAAmB;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACpC,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC;QACrE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC;QAC9D,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC;QACrE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC;KAC/D,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,uBAAuB,CAAC,WAAmB,EAAE,KAAyB;IAC7E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,sBAAsB,CAAC,MAI/B;IACC,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,gCAAgC;IACvC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,6BAA6B,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,mBAAmB,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gCAAgC,CAAC,MAG/C;IACC,MAAM,SAAS,GAAG,sBAAsB,CAAC;QACvC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,eAAe;KAC1B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACnD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,SAAS,EAAE,EAAE,GAAG,gCAAgC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACxF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,6BAA6B,CAAC,MAI5C;IACC,MAAM,SAAS,GAAG,sBAAsB,CAAC;QACvC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACnD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,MAAM,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE;YAC9C,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,sCAAsC,EAAE,SAAS,CAAC,EAAE;QAC5F,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,OAAe;IACrD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE;YAC/B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAA6B;IAE7B,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACxE,OAAO;YACL,SAAS;YACT,SAAS,EAAE,SAAS;YACpB,OAAO,EAAE,SAAS;gBAChB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,2CAA2C,MAAM,CAAC,cAAc,EAAE;oBAClE,qEAAqE;iBACtE;YACL,OAAO,EAAE;gBACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,MAAM,EAAE,kBAAkB;gBAC1B,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,+BAA+B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,OAAO;QACL,SAAS;QACT,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,SAAS;YAChB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,gCAAgC;gBAChC,qHAAqH;aACtH;QACL,OAAO,EAAE;YACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,kBAAkB;YAC1B,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;SAC9D;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,MAGhD;IAKC,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,YAAY,GAChB,MAAM,CAAC,KAAK,EAAE,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM;QAC/E,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY;QAC3B,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC;IACjC,MAAM,QAAQ,GACZ,MAAM,CAAC,KAAK,EAAE,QAAQ,KAAK,eAAe,IAAI,MAAM,CAAC,KAAK,EAAE,QAAQ,KAAK,YAAY;QACnF,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ;QACvB,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC;IAE7B,MAAM,kBAAkB,GACtB,QAAQ,KAAK,eAAe;QAC1B,CAAC,CAAC,MAAM,gCAAgC,CAAC;YACrC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ;YACpC,KAAK,EAAE,YAAY;SACpB,CAAC;QACJ,CAAC,CAAC,MAAM,6BAA6B,CAAC;YAClC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ;YACpC,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,aAAa;SACpC,CAAC,CAAC;IAET,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC;QAC5C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE;YACL,QAAQ;YACR,YAAY,EACV,OAAO,MAAM,CAAC,KAAK,EAAE,YAAY,KAAK,SAAS;gBAC7C,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY;gBAC3B,CAAC,CAAC,IAAI;YACV,GAAG,CAAC,OAAO,MAAM,CAAC,KAAK,EAAE,aAAa,KAAK,QAAQ;gBACnD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE;gBAC/B,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE;gBACtD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,MAAM,CAAC,KAAK,EAAE,aAAa,KAAK,QAAQ;gBACnD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE;gBAC/B,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE;gBACtD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,MAAM,CAAC,KAAK,EAAE,cAAc,KAAK,QAAQ;gBACpD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE;gBAChC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE;gBACxD,CAAC,CAAC,EAAE,CAAC;YACP,YAAY;SACb;KACF,CAAC,CAAC;IACH,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,uCAAuC;QAChD,OAAO,EAAE,YAAY,CAAC;YACpB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,EAAE;YAC7C,cAAc,EAAE,UAAU,CAAC,cAAc;YACzC,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,SAAS,EAAE,kBAAkB;SAC9B,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAA6B;IAE7B,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Workboard Plugin。
+ *
+ * 关键点（中文）
+ * - workboard 是一个 runtime 观测面板插件，负责提供结构化工作快照。
+ * - 当前通过 plugin HTTP 注入暴露 `/api/workboard/snapshot`，供 console 代理与 UI 消费。
+ */
+import type { Plugin } from "../../shared/types/Plugin.js";
+/**
+ * Workboard 插件定义。
+ */
+export declare const workboardPlugin: Plugin;
+//# sourceMappingURL=Plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/workboard/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAKvD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAgE7B,CAAC"}

package/bin/plugins/workboard/Plugin.js

@@ -0,0 +1,71 @@
+/**
+ * Workboard Plugin。
+ *
+ * 关键点（中文）
+ * - workboard 是一个 runtime 观测面板插件，负责提供结构化工作快照。
+ * - 当前通过 plugin HTTP 注入暴露 `/api/workboard/snapshot`，供 console 代理与 UI 消费。
+ */
+import { isPluginEnabled } from "../../plugin/Activation.js";
+import { getWorkboardSnapshotStore } from "../../plugins/workboard/runtime/Store.js";
+/**
+ * Workboard 插件定义。
+ */
+export const workboardPlugin = {
+    name: "workboard",
+    title: "Workboard Snapshot",
+    description: "Collects structured runtime activity snapshots so console surfaces can show what the current agent is doing now and what it recently worked on.",
+    availability() {
+        if (!isPluginEnabled({ plugin: workboardPlugin })) {
+            return {
+                enabled: false,
+                available: false,
+                reasons: ["workboard plugin disabled in city config"],
+            };
+        }
+        return {
+            enabled: true,
+            available: true,
+            reasons: [],
+        };
+    },
+    http: {
+        runtime: {
+            authPolicies: [
+                {
+                    path: "/api/workboard/*",
+                    method: "GET",
+                    requireAuth: true,
+                    anyPermissions: ["agent.read"],
+                },
+            ],
+            register({ app, getContext }) {
+                app.get("/api/workboard/snapshot", async (c) => {
+                    try {
+                        const availability = await workboardPlugin.availability?.(getContext());
+                        if (availability && availability.available !== true) {
+                            return c.json({
+                                success: false,
+                                error: availability.reasons.join("; ") || "workboard unavailable",
+                            }, 503);
+                        }
+                        const snapshot = await getWorkboardSnapshotStore({
+                            contextResolver: getContext,
+                        }).readSnapshot();
+                        const payload = {
+                            success: true,
+                            snapshot,
+                        };
+                        return c.json(payload);
+                    }
+                    catch (error) {
+                        return c.json({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }, 500);
+                    }
+                });
+            },
+        },
+    },
+};
+//# sourceMappingURL=Plugin.js.map

package/bin/plugins/workboard/Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../../src/plugins/workboard/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAGjF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW;IACrC,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,iJAAiJ;IACnJ,YAAY;QACV,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;YAClD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,CAAC,0CAA0C,CAAC;aACtD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IACD,IAAI,EAAE;QACJ,OAAO,EAAE;YACP,YAAY,EAAE;gBACZ;oBACE,IAAI,EAAE,kBAAkB;oBACxB,MAAM,EAAE,KAAK;oBACb,WAAW,EAAE,IAAI;oBACjB,cAAc,EAAE,CAAC,YAAY,CAAC;iBAC/B;aACF;YACD,QAAQ,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE;gBAC1B,GAAG,CAAC,GAAG,CAAC,yBAAyB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;oBAC7C,IAAI,CAAC;wBACH,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;wBACxE,IAAI,YAAY,IAAI,YAAY,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;4BACpD,OAAO,CAAC,CAAC,IAAI,CACX;gCACE,OAAO,EAAE,KAAK;gCACd,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,uBAAuB;6BAClE,EACD,GAAG,CACJ,CAAC;wBACJ,CAAC;wBAED,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC;4BAC/C,eAAe,EAAE,UAAU;yBAC5B,CAAC,CAAC,YAAY,EAAE,CAAC;wBAClB,MAAM,OAAO,GAA8B;4BACzC,OAAO,EAAE,IAAI;4BACb,QAAQ;yBACT,CAAC;wBACF,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACzB,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,CAAC,IAAI,CACX;4BACE,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAC9D,EACD,GAAG,CACJ,CAAC;oBACJ,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;SACF;KACF;CACF,CAAC"}

package/bin/plugins/workboard/runtime/Collector.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Workboard 快照采集器。
+ *
+ * 关键点（中文）
+ * - 这里只做确定性采集，不引入 LLM 推理。
+ * - 内部仍聚合 session、task、service 三类运行事实，但最终只输出对外安全的模糊状态。
+ */
+import type { AgentContext } from "../../../types/agent/AgentContext.js";
+import type { WorkboardSnapshot } from "../../../plugins/workboard/types/Workboard.js";
+/**
+ * 采集当前 workboard 快照。
+ */
+export declare function collectWorkboardSnapshot(context: AgentContext): Promise<WorkboardSnapshot>;
+//# sourceMappingURL=Collector.d.ts.map

package/bin/plugins/workboard/runtime/Collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collector.d.ts","sourceRoot":"","sources":["../../../../src/plugins/workboard/runtime/Collector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAYhF;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAgD5B"}

package/bin/plugins/workboard/runtime/Collector.js

@@ -0,0 +1,62 @@
+/**
+ * Workboard 快照采集器。
+ *
+ * 关键点（中文）
+ * - 这里只做确定性采集，不引入 LLM 推理。
+ * - 内部仍聚合 session、task、service 三类运行事实，但最终只输出对外安全的模糊状态。
+ */
+import { listTaskDefinitions } from "../../../services/task/Action.js";
+import { listServiceStates } from "../../../service/Manager.js";
+import { listDashboardSessionSummaries } from "../../../http/dashboard/SessionSummaryStore.js";
+import { buildIdleActivity, toRecentActivity, toRunningActivity, toWorkboardAgentSummary, toWorkboardSignals, toWorkboardSummary, } from "../../../plugins/workboard/runtime/Normalizer.js";
+const WORKBOARD_RECENT_LIMIT = 8;
+/**
+ * 采集当前 workboard 快照。
+ */
+export async function collectWorkboardSnapshot(context) {
+    const collectedAt = new Date().toISOString();
+    const executingSessionIds = new Set(context.session.listExecutingSessionIds());
+    const sessions = await listDashboardSessionSummaries({
+        projectRoot: context.rootPath,
+        executionContext: context,
+        limit: WORKBOARD_RECENT_LIMIT + Math.max(executingSessionIds.size, 1),
+        executingSessionIds,
+    });
+    const services = listServiceStates();
+    const taskResult = await listTaskDefinitions({ projectRoot: context.rootPath });
+    const degradedCount = services.filter((item) => item.state !== "running").length;
+    const current = sessions
+        .filter((item) => item.executing === true)
+        .slice(0, 4)
+        .map((item, index) => toRunningActivity({ item, index }));
+    const recent = sessions
+        .filter((item) => item.executing !== true)
+        .slice(0, WORKBOARD_RECENT_LIMIT)
+        .map((item, index) => toRecentActivity({ item, index }));
+    const safeCurrent = current.length > 0
+        ? current
+        : [buildIdleActivity({ updatedAt: collectedAt, recentCount: recent.length })];
+    return {
+        agent: toWorkboardAgentSummary({
+            context,
+            collectedAt,
+            currentCount: current.length,
+            recentCount: recent.length,
+            degradedCount,
+        }),
+        summary: toWorkboardSummary({
+            currentCount: current.length,
+            recentCount: recent.length,
+            degradedCount,
+        }),
+        current: safeCurrent,
+        recent,
+        signals: toWorkboardSignals({
+            currentCount: current.length,
+            recentCount: recent.length,
+            services,
+            taskResult,
+        }),
+    };
+}
+//# sourceMappingURL=Collector.js.map

package/bin/plugins/workboard/runtime/Collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collector.js","sourceRoot":"","sources":["../../../../src/plugins/workboard/runtime/Collector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AAGxF,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,2CAA2C,CAAC;AAEnD,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAqB;IAErB,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAAC;QACnD,WAAW,EAAE,OAAO,CAAC,QAAQ;QAC7B,gBAAgB,EAAE,OAAO;QACzB,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,mBAAmB;KACpB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChF,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAEjF,MAAM,OAAO,GAAG,QAAQ;SACrB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;SACzC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,QAAQ;SACpB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;SACzC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC;SAChC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAE3D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;QACpC,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEhF,OAAO;QACL,KAAK,EAAE,uBAAuB,CAAC;YAC7B,OAAO;YACP,WAAW;YACX,YAAY,EAAE,OAAO,CAAC,MAAM;YAC5B,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,aAAa;SACd,CAAC;QACF,OAAO,EAAE,kBAAkB,CAAC;YAC1B,YAAY,EAAE,OAAO,CAAC,MAAM;YAC5B,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,aAAa;SACd,CAAC;QACF,OAAO,EAAE,WAAW;QACpB,MAAM;QACN,OAAO,EAAE,kBAAkB,CAAC;YAC1B,YAAY,EAAE,OAAO,CAAC,MAAM;YAC5B,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,QAAQ;YACR,UAAU;SACX,CAAC;KACH,CAAC;AACJ,CAAC"}

package/bin/plugins/workboard/runtime/Normalizer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Workboard 结构化归一化工具。
+ *
+ * 关键点（中文）
+ * - 这里负责把内部运行事实投影成“对外模糊公开态”。
+ * - 所有会泄漏上下文的字段都必须在这里截断或抽象。
+ */
+import type { DashboardSessionSummary } from "../../../shared/types/DashboardData.js";
+import type { ServiceStateSnapshot } from "../../../shared/types/ServiceState.js";
+import type { TaskListResponse } from "../../../services/task/types/TaskCommand.js";
+import type { WorkboardActivityItem, WorkboardAgentSummary, WorkboardSignalItem, WorkboardSummary } from "../../../plugins/workboard/types/Workboard.js";
+import type { AgentContext } from "../../../types/agent/AgentContext.js";
+/**
+ * 构建 agent 顶部公开摘要。
+ */
+export declare function toWorkboardAgentSummary(params: {
+    context: AgentContext;
+    collectedAt: string;
+    currentCount: number;
+    recentCount: number;
+    degradedCount: number;
+}): WorkboardAgentSummary;
+/**
+ * 将运行中的 session 映射为对外安全活动项。
+ */
+export declare function toRunningActivity(params: {
+    item: DashboardSessionSummary;
+    index: number;
+}): WorkboardActivityItem;
+/**
+ * 将近期 session 映射为对外安全活动项。
+ */
+export declare function toRecentActivity(params: {
+    item: DashboardSessionSummary;
+    index: number;
+}): WorkboardActivityItem;
+/**
+ * 构建空闲占位项。
+ */
+export declare function buildIdleActivity(params: {
+    updatedAt: string;
+    recentCount: number;
+}): WorkboardActivityItem;
+/**
+ * 构建公开摘要。
+ */
+export declare function toWorkboardSummary(params: {
+    currentCount: number;
+    recentCount: number;
+    degradedCount: number;
+}): WorkboardSummary;
+/**
+ * 构建对外模糊信号。
+ */
+export declare function toWorkboardSignals(params: {
+    currentCount: number;
+    recentCount: number;
+    services: ServiceStateSnapshot[];
+    taskResult: TaskListResponse;
+}): WorkboardSignalItem[];
+//# sourceMappingURL=Normalizer.d.ts.map

package/bin/plugins/workboard/runtime/Normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Normalizer.d.ts","sourceRoot":"","sources":["../../../../src/plugins/workboard/runtime/Normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA4DlE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,qBAAqB,CAaxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,qBAAqB,CAYxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,qBAAqB,CAYxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,qBAAqB,CAYxB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,gBAAgB,CAOnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,UAAU,EAAE,gBAAgB,CAAC;CAC9B,GAAG,mBAAmB,EAAE,CA2BxB"}