@downcity/agent 1.1.8 → 1.1.10

package/bin/plugin/builtins/web/runtime/Config.js

@@ -0,0 +1,79 @@
+/**
+ * Web Plugin 配置读写。
+ *
+ * 关键点（中文）
+ * - `web` 默认启用，不要求用户先在 `downcity.json` 写配置。
+ * - 只有当用户显式改动时，才把 `plugins.web` 持久化到项目配置。
+ */
+import { WEB_PLUGIN_DEFAULT_REPOSITORY_URL } from "../../../../plugin/builtins/web/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/plugin/builtins/web/runtime/Config.js.map

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

package/bin/plugin/builtins/web/runtime/Source.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Web Plugin 来源信息与兼容安装动作。
+ *
+ * 关键点（中文）
+ * - 这里不自建联网实现，只检查外部 provider 是否就绪，并记录少量配置。
+ */
+import type { JsonObject } from "../../../../utils/types/Json.js";
+import type { PluginCommandContext } from "../../../../plugin/types/Plugin.js";
+import type { WebPluginDependencyCheckResult, WebPluginInstallInput } from "../../../../plugin/builtins/web/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/plugin/builtins/web/runtime/Source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Source.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/web/runtime/Source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EACV,8BAA8B,EAC9B,qBAAqB,EACtB,MAAM,0CAA0C,CAAC;AA8GlD;;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/plugin/builtins/web/runtime/Source.js

@@ -0,0 +1,209 @@
+/**
+ * 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 "../../../../plugin/builtins/web/runtime/Config.js";
+import { AGENT_BROWSER_PROMPT } from "../../../../plugin/builtins/web/WebPromptAssets.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;
+        }
+    }
+    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() {
+    return AGENT_BROWSER_PROMPT || "# agent-browser";
+}
+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/plugin/builtins/web/runtime/Source.js.map

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

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

@@ -0,0 +1,133 @@
+/**
+ * Web Plugin 协议类型。
+ *
+ * 关键点（中文）
+ * - `web` plugin 只负责选择 provider、管理少量配置，并注入对应项目的提示词。
+ * - 联网能力本身由外部实现承担：`web-access` 或 `agent-browser`。
+ */
+import type { JsonValue } from "../../../../utils/types/Json.js";
+/**
+ * Web plugin 默认依赖仓库地址。
+ */
+export declare const WEB_PLUGIN_DEFAULT_REPOSITORY_URL = "https://github.com/eze-is/web-access";
+/**
+ * Web plugin provider。
+ */
+export type WebPluginProvider = "web-access" | "agent-browser";
+/**
+ * Web plugin 安装作用域。
+ */
+export type WebPluginInstallScope = "user" | "project";
+/**
+ * Web plugin 配置。
+ */
+export interface WebPluginConfig {
+    /**
+     * 兼容统一结构化配置约束的索引签名。
+     */
+    [key: string]: JsonValue | undefined;
+    /**
+     * 当前使用的 provider。
+     */
+    provider?: WebPluginProvider;
+    /**
+     * 是否向 agent 注入 provider 提示词。
+     */
+    injectPrompt?: boolean;
+    /**
+     * provider 来源仓库地址。
+     */
+    repositoryUrl?: string;
+    /**
+     * provider 版本标签或备注。
+     */
+    sourceVersion?: string;
+    /**
+     * agent-browser 命令名（可选）。
+     */
+    browserCommand?: string;
+    /**
+     * skill 安装作用域。
+     */
+    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;
+}
+//# sourceMappingURL=WebPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebPlugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;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"}

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

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

package/bin/plugin/builtins/workboard/Plugin.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin/builtins/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/plugin/builtins/workboard/Plugin.js

@@ -0,0 +1,71 @@
+/**
+ * Workboard Plugin。
+ *
+ * 关键点（中文）
+ * - workboard 是一个 runtime 观测面板插件，负责提供结构化工作快照。
+ * - 当前通过 plugin HTTP 注入暴露 `/api/workboard/snapshot`，供 console 代理与 UI 消费。
+ */
+import { isPluginEnabled } from "../../../plugin/core/Activation.js";
+import { getWorkboardSnapshotStore } from "../../../plugin/builtins/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(context) {
+        if (!isPluginEnabled({ plugin: workboardPlugin, context })) {
+            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/plugin/builtins/workboard/Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../../../src/plugin/builtins/workboard/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAGzF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW;IACrC,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,iJAAiJ;IACnJ,YAAY,CAAC,OAAO;QAClB,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3D,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/plugin/builtins/workboard/runtime/Collector.d.ts

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

package/bin/plugin/builtins/workboard/runtime/Collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collector.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/workboard/runtime/Collector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAYxF;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAgD5B"}

package/bin/plugin/builtins/workboard/runtime/Collector.js

@@ -0,0 +1,62 @@
+/**
+ * Workboard 快照采集器。
+ *
+ * 关键点（中文）
+ * - 这里只做确定性采集，不引入 LLM 推理。
+ * - 内部仍聚合 session、task、service 三类运行事实，但最终只输出对外安全的模糊状态。
+ */
+import { listTaskDefinitions } from "../../../../service/builtins/task/Action.js";
+import { listServiceStates } from "../../../../service/core/Manager.js";
+import { listControlSessionSummaries } from "../../../../host/http/control/SessionSummaryStore.js";
+import { buildIdleActivity, toRecentActivity, toRunningActivity, toWorkboardAgentSummary, toWorkboardSignals, toWorkboardSummary, } from "../../../../plugin/builtins/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 listControlSessionSummaries({
+        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