@downcity/plugins 1.0.4

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

@@ -0,0 +1,61 @@
+/**
+ * Workboard 结构化归一化工具。
+ *
+ * 关键点（中文）
+ * - 这里负责把内部运行事实投影成“对外模糊公开态”。
+ * - 所有会泄漏上下文的字段都必须在这里截断或抽象。
+ */
+import type { ControlSessionSummary } from "@downcity/agent/internal/runtime/server/http/control/types/ControlViewData.js";
+import type { PluginStateSnapshot } from "@downcity/agent/internal/plugin/types/PluginState.js";
+import type { TaskListResponse } from "../../task/types/TaskCommand.js";
+import type { WorkboardActivityItem, WorkboardAgentSummary, WorkboardSignalItem, WorkboardSummary } from "../../workboard/types/Workboard.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/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: ControlSessionSummary;
+    index: number;
+}): WorkboardActivityItem;
+/**
+ * 将近期 session 映射为对外安全活动项。
+ */
+export declare function toRecentActivity(params: {
+    item: ControlSessionSummary;
+    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;
+    plugins: PluginStateSnapshot[];
+    taskResult: TaskListResponse;
+}): WorkboardSignalItem[];
+//# sourceMappingURL=Normalizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Normalizer.d.ts","sourceRoot":"","sources":["../../../src/workboard/runtime/Normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+EAA+E,CAAC;AAC3H,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AA4DjG;;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,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,qBAAqB,CAYxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,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,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,UAAU,EAAE,gBAAgB,CAAC;CAC9B,GAAG,mBAAmB,EAAE,CA2BxB"}

package/bin/workboard/runtime/Normalizer.js

@@ -0,0 +1,172 @@
+/**
+ * Workboard 结构化归一化工具。
+ *
+ * 关键点（中文）
+ * - 这里负责把内部运行事实投影成“对外模糊公开态”。
+ * - 所有会泄漏上下文的字段都必须在这里截断或抽象。
+ */
+function toIsoString(timestamp) {
+    if (!timestamp || !Number.isFinite(timestamp)) {
+        return new Date().toISOString();
+    }
+    return new Date(timestamp).toISOString();
+}
+function buildHeadline(params) {
+    if (params.currentCount > 0 && params.degradedCount > 0) {
+        return "当前仍在展开，但节奏出现了一些波动";
+    }
+    if (params.currentCount > 1) {
+        return "当前呈现多线展开的状态";
+    }
+    if (params.currentCount === 1) {
+        return "当前呈现稳定展开的状态";
+    }
+    if (params.recentCount > 0) {
+        return "刚刚有过新的进展，现在进入短暂停留";
+    }
+    return "当前处于安静待命的状态";
+}
+function buildPosture(params) {
+    if (params.currentCount > 1)
+        return "多线展开";
+    if (params.currentCount === 1)
+        return "单线聚焦";
+    if (params.recentCount > 0)
+        return "短暂停留";
+    return "静候下一步";
+}
+function buildMomentum(params) {
+    if (params.currentCount > 1)
+        return "活跃展开";
+    if (params.currentCount === 1)
+        return "平稳延续";
+    if (params.recentCount > 2)
+        return "轻微起伏";
+    if (params.recentCount > 0)
+        return "余温未散";
+    return "安静";
+}
+function buildRunningSummary(item) {
+    const messageCount = typeof item.messageCount === "number" ? item.messageCount : 0;
+    if (messageCount >= 24)
+        return "正在延展一段较长的工作脉络，并持续生成新的内容。";
+    if (messageCount >= 8)
+        return "正在承接连续输入，逐步形成新的阶段结果。";
+    if (messageCount > 0)
+        return "正在回应当前输入，并把工作继续向前展开。";
+    return "当前处于活跃展开之中。";
+}
+function buildRecentSummary(item, index) {
+    const messageCount = typeof item.messageCount === "number" ? item.messageCount : 0;
+    if (index === 0 && messageCount > 0)
+        return "刚刚完成一段新的展开，正在短暂停留。";
+    if (messageCount >= 12)
+        return "近期完成了一次较长的内容延展。";
+    if (messageCount > 0)
+        return "近期完成了一次常规更新。";
+    return "近期出现了一次轻微变化。";
+}
+/**
+ * 构建 agent 顶部公开摘要。
+ */
+export function toWorkboardAgentSummary(params) {
+    const statusText = buildHeadline({
+        currentCount: params.currentCount,
+        recentCount: params.recentCount,
+        degradedCount: params.degradedCount,
+    });
+    return {
+        name: String(params.context.config.name || "").trim() || "agent",
+        running: true,
+        statusText,
+        collectedAt: params.collectedAt,
+    };
+}
+/**
+ * 将运行中的 session 映射为对外安全活动项。
+ */
+export function toRunningActivity(params) {
+    const title = params.index === 0 ? "当前主线" : `当前并行线 ${params.index + 1}`;
+    return {
+        id: `current:${params.index + 1}`,
+        kind: "focus",
+        title,
+        summary: buildRunningSummary(params.item),
+        status: "active",
+        updatedAt: toIsoString(params.item.updatedAt),
+        tags: ["public", "active"],
+    };
+}
+/**
+ * 将近期 session 映射为对外安全活动项。
+ */
+export function toRecentActivity(params) {
+    const title = params.index === 0 ? "最近一次更新" : `近期片段 ${params.index + 1}`;
+    return {
+        id: `recent:${params.index + 1}`,
+        kind: "progress",
+        title,
+        summary: buildRecentSummary(params.item, params.index),
+        status: params.index === 0 ? "steady" : "waiting",
+        updatedAt: toIsoString(params.item.updatedAt),
+        tags: ["public", "recent"],
+    };
+}
+/**
+ * 构建空闲占位项。
+ */
+export function buildIdleActivity(params) {
+    return {
+        id: "idle:standby",
+        kind: "idle",
+        title: "当前处于安静待命",
+        summary: params.recentCount > 0
+            ? "刚刚有过新的更新，现在等待下一次输入。"
+            : "当前没有明显变化，等待新的触发。",
+        status: "waiting",
+        updatedAt: params.updatedAt,
+        tags: ["public", "idle"],
+    };
+}
+/**
+ * 构建公开摘要。
+ */
+export function toWorkboardSummary(params) {
+    return {
+        headline: buildHeadline(params),
+        posture: buildPosture(params),
+        momentum: buildMomentum(params),
+        visibilityNote: "这里展示的是面向外部的概览状态，不包含内部上下文细节。",
+    };
+}
+/**
+ * 构建对外模糊信号。
+ */
+export function toWorkboardSignals(params) {
+    const degradedCount = params.plugins.filter((item) => item.state !== "running").length;
+    const taskCount = Array.isArray(params.taskResult.tasks) ? params.taskResult.tasks.length : 0;
+    return [
+        {
+            label: "状态节奏",
+            value: params.currentCount > 1
+                ? "多线展开"
+                : params.currentCount === 1
+                    ? "稳定展开"
+                    : params.recentCount > 0
+                        ? "轻微流动"
+                        : "安静待命",
+            tone: params.currentCount > 0 ? "accent" : "neutral",
+        },
+        {
+            label: "现场感受",
+            value: degradedCount > 0 ? "有些波动" : "整体平稳",
+            tone: degradedCount > 0 ? "warning" : "neutral",
+        },
+        {
+            label: "活跃温度",
+            value: taskCount > 0 || params.recentCount > 0 ? "仍有余温" : "较为安静",
+            tone: params.recentCount > 0 ? "accent" : "neutral",
+        },
+    ];
+}
+//# sourceMappingURL=Normalizer.js.map

package/bin/workboard/runtime/Normalizer.js.map

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

package/bin/workboard/runtime/Store.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Workboard 快照缓存。
+ *
+ * 关键点（中文）
+ * - 采用惰性启动 + 周期刷新，避免首次请求前就常驻占用资源。
+ * - route 与 action 共享同一份快照，确保 workboard 展示一致。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { WorkboardSnapshot } from "../../workboard/types/Workboard.js";
+type AgentContextResolver = () => AgentContext;
+/**
+ * Workboard 快照存储器。
+ */
+declare class WorkboardSnapshotStore {
+    private contextResolver;
+    private readonly intervalMs;
+    private latestSnapshot;
+    private refreshTimer;
+    private inflight;
+    constructor(params: {
+        contextResolver: AgentContextResolver;
+        intervalMs?: number;
+    });
+    /**
+     * 更新上下文 resolver。
+     */
+    setContextResolver(resolver: AgentContextResolver): void;
+    /**
+     * 读取当前快照。
+     */
+    readSnapshot(): Promise<WorkboardSnapshot>;
+    /**
+     * 立即刷新一次快照。
+     */
+    refresh(): Promise<WorkboardSnapshot>;
+    /**
+     * 惰性启动后台刷新。
+     */
+    private ensureStarted;
+}
+/**
+ * 读取共享 workboard 快照缓存。
+ */
+export declare function getWorkboardSnapshotStore(params: {
+    contextResolver: AgentContextResolver;
+}): WorkboardSnapshotStore;
+export {};
+//# sourceMappingURL=Store.d.ts.map

package/bin/workboard/runtime/Store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../../src/workboard/runtime/Store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,KAAK,oBAAoB,GAAG,MAAM,YAAY,CAAC;AAI/C;;GAEG;AACH,cAAM,sBAAsB;IAC1B,OAAO,CAAC,eAAe,CAAuB;IAE9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,cAAc,CAAkC;IAExD,OAAO,CAAC,YAAY,CAA+B;IAEnD,OAAO,CAAC,QAAQ,CAA2C;gBAE/C,MAAM,EAAE;QAClB,eAAe,EAAE,oBAAoB,CAAC;QACtC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAKD;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIxD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAQhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAiB3C;;OAEG;IACH,OAAO,CAAC,aAAa;CAWtB;AAID;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,eAAe,EAAE,oBAAoB,CAAC;CACvC,GAAG,sBAAsB,CAUzB"}

package/bin/workboard/runtime/Store.js

@@ -0,0 +1,84 @@
+/**
+ * Workboard 快照缓存。
+ *
+ * 关键点（中文）
+ * - 采用惰性启动 + 周期刷新，避免首次请求前就常驻占用资源。
+ * - route 与 action 共享同一份快照，确保 workboard 展示一致。
+ */
+import { collectWorkboardSnapshot } from "../../workboard/runtime/Collector.js";
+const DEFAULT_WORKBOARD_INTERVAL_MS = 5_000;
+/**
+ * Workboard 快照存储器。
+ */
+class WorkboardSnapshotStore {
+    contextResolver;
+    intervalMs;
+    latestSnapshot = null;
+    refreshTimer = null;
+    inflight = null;
+    constructor(params) {
+        this.contextResolver = params.contextResolver;
+        this.intervalMs = params.intervalMs || DEFAULT_WORKBOARD_INTERVAL_MS;
+    }
+    /**
+     * 更新上下文 resolver。
+     */
+    setContextResolver(resolver) {
+        this.contextResolver = resolver;
+    }
+    /**
+     * 读取当前快照。
+     */
+    async readSnapshot() {
+        this.ensureStarted();
+        if (this.latestSnapshot) {
+            return this.latestSnapshot;
+        }
+        return this.refresh();
+    }
+    /**
+     * 立即刷新一次快照。
+     */
+    async refresh() {
+        if (this.inflight) {
+            return this.inflight;
+        }
+        this.inflight = collectWorkboardSnapshot(this.contextResolver())
+            .then((snapshot) => {
+            this.latestSnapshot = snapshot;
+            return snapshot;
+        })
+            .finally(() => {
+            this.inflight = null;
+        });
+        return this.inflight;
+    }
+    /**
+     * 惰性启动后台刷新。
+     */
+    ensureStarted() {
+        if (this.refreshTimer) {
+            return;
+        }
+        void this.refresh();
+        this.refreshTimer = setInterval(() => {
+            void this.refresh();
+        }, this.intervalMs);
+        this.refreshTimer.unref?.();
+    }
+}
+let sharedStore = null;
+/**
+ * 读取共享 workboard 快照缓存。
+ */
+export function getWorkboardSnapshotStore(params) {
+    if (!sharedStore) {
+        sharedStore = new WorkboardSnapshotStore({
+            contextResolver: params.contextResolver,
+        });
+        return sharedStore;
+    }
+    sharedStore.setContextResolver(params.contextResolver);
+    return sharedStore;
+}
+//# sourceMappingURL=Store.js.map

package/bin/workboard/runtime/Store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.js","sourceRoot":"","sources":["../../../src/workboard/runtime/Store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAI5E,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAE5C;;GAEG;AACH,MAAM,sBAAsB;IAClB,eAAe,CAAuB;IAE7B,UAAU,CAAS;IAE5B,cAAc,GAA6B,IAAI,CAAC;IAEhD,YAAY,GAA0B,IAAI,CAAC;IAE3C,QAAQ,GAAsC,IAAI,CAAC;IAE3D,YAAY,MAGX;QACC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,6BAA6B,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAA8B;QAC/C,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,wBAAwB,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;aAC7D,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACjB,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;YAC/B,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC,CAAC,CAAC;QAEL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,aAAa;QACnB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;YACnC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC;IAC9B,CAAC;CACF;AAED,IAAI,WAAW,GAAkC,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAEzC;IACC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,IAAI,sBAAsB,CAAC;YACvC,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC,CAAC;QACH,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACvD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/bin/workboard/types/Workboard.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Workboard 插件类型定义。
+ *
+ * 关键点（中文）
+ * - workboard 是对外展示面板，类型只保留公开安全的模糊状态。
+ * - 不暴露 sessionId、路径、模型、service 名称、task 明细等内部信息。
+ */
+/**
+ * Workboard 活动类型。
+ */
+export type WorkboardActivityKind = "focus" | "progress" | "idle";
+/**
+ * Workboard 活动状态。
+ */
+export type WorkboardActivityStatus = "active" | "steady" | "waiting" | "issue";
+/**
+ * Workboard 信号语气。
+ */
+export type WorkboardSignalTone = "neutral" | "accent" | "warning";
+/**
+ * 单个公开活动项。
+ */
+export interface WorkboardActivityItem {
+    /**
+     * 活动稳定标识。
+     */
+    id: string;
+    /**
+     * 活动类型。
+     */
+    kind: WorkboardActivityKind;
+    /**
+     * 对外可展示的模糊标题。
+     */
+    title: string;
+    /**
+     * 对外可展示的模糊摘要。
+     */
+    summary: string;
+    /**
+     * 当前状态。
+     */
+    status: WorkboardActivityStatus;
+    /**
+     * 最近更新时间（ISO8601）。
+     */
+    updatedAt: string;
+    /**
+     * 对外安全标签。
+     */
+    tags: string[];
+}
+/**
+ * 单个公开信号项。
+ */
+export interface WorkboardSignalItem {
+    /**
+     * 信号名称。
+     */
+    label: string;
+    /**
+     * 信号值。
+     */
+    value: string;
+    /**
+     * 信号语气。
+     */
+    tone: WorkboardSignalTone;
+}
+/**
+ * 顶部公开摘要。
+ */
+export interface WorkboardSummary {
+    /**
+     * 对外 headline。
+     */
+    headline: string;
+    /**
+     * 当前姿态描述。
+     */
+    posture: string;
+    /**
+     * 当前动量描述。
+     */
+    momentum: string;
+    /**
+     * 可见性说明。
+     */
+    visibilityNote: string;
+}
+/**
+ * agent 公开摘要。
+ */
+export interface WorkboardAgentSummary {
+    /**
+     * agent 展示名称。
+     */
+    name: string;
+    /**
+     * 当前 agent 是否运行中。
+     */
+    running: boolean;
+    /**
+     * 顶部状态文案。
+     */
+    statusText: string;
+    /**
+     * 最近采集时间（ISO8601）。
+     */
+    collectedAt: string;
+}
+/**
+ * Workboard 快照。
+ */
+export interface WorkboardSnapshot {
+    /**
+     * agent 公开摘要。
+     */
+    agent: WorkboardAgentSummary;
+    /**
+     * 顶部公开摘要。
+     */
+    summary: WorkboardSummary;
+    /**
+     * 当前活动列表。
+     */
+    current: WorkboardActivityItem[];
+    /**
+     * 最近活动列表。
+     */
+    recent: WorkboardActivityItem[];
+    /**
+     * 模糊信号列表。
+     */
+    signals: WorkboardSignalItem[];
+}
+/**
+ * Workboard 快照响应。
+ */
+export interface WorkboardSnapshotResponse {
+    /**
+     * 请求是否成功。
+     */
+    success: boolean;
+    /**
+     * 当前快照。
+     */
+    snapshot: WorkboardSnapshot;
+}
+//# sourceMappingURL=Workboard.d.ts.map

package/bin/workboard/types/Workboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workboard.d.ts","sourceRoot":"","sources":["../../../src/workboard/types/Workboard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,qBAAqB,CAAC;IAC5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,uBAAuB,CAAC;IAChC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,KAAK,EAAE,qBAAqB,CAAC;IAC7B;;OAEG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;OAEG;IACH,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC;;OAEG;IACH,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC;;OAEG;IACH,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,QAAQ,EAAE,iBAAiB,CAAC;CAC7B"}

package/bin/workboard/types/Workboard.js

@@ -0,0 +1,9 @@
+/**
+ * Workboard 插件类型定义。
+ *
+ * 关键点（中文）
+ * - workboard 是对外展示面板，类型只保留公开安全的模糊状态。
+ * - 不暴露 sessionId、路径、模型、service 名称、task 明细等内部信息。
+ */
+export {};
+//# sourceMappingURL=Workboard.js.map

package/bin/workboard/types/Workboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workboard.js","sourceRoot":"","sources":["../../../src/workboard/types/Workboard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@downcity/plugins",
+  "version": "1.0.4",
+  "type": "module",
+  "description": "Downcity 内建 plugin 集合包",
+  "main": "./bin/index.js",
+  "types": "./bin/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./bin/index.js",
+      "types": "./bin/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.40.0",
+    "ai": "^6.0.57",
+    "better-sqlite3": "^11.10.0",
+    "commander": "^12.0.0",
+    "execa": "^9.5.0",
+    "fs-extra": "^11.2.0",
+    "js-yaml": "^4.1.0",
+    "node-cron": "^3.0.0",
+    "ws": "^8.18.3",
+    "zod": "^3.24.0",
+    "@downcity/agent": "^1.1.43"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/fs-extra": "^11.0.4",
+    "@types/js-yaml": "^4.0.0",
+    "@types/node": "^22.0.0",
+    "@types/node-cron": "^3.0.0",
+    "@types/ws": "^8.18.1",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "rm -rf bin tsconfig.tsbuildinfo && tsc && tsc-alias -f",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/BuiltinPlugins.ts

@@ -0,0 +1,53 @@
+/**
+ * BuiltinPlugins：Downcity 内建 plugin 实例工厂。
+ *
+ * 关键点（中文）
+ * - 本包只提供具体内建 plugin class 和默认集合创建能力。
+ * - 注册、目录视图、HTTP 装配、CLI action 执行都由 `@downcity/agent` 的通用能力处理。
+ * - 调用方需要完整内建集合时，显式调用 `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 { AuthPlugin } 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";
+import { TaskPlugin } from "@/task/TaskPlugin.js";
+import { MemoryPlugin } from "@/memory/MemoryPlugin.js";
+import { ShellPlugin } from "@/shell/ShellPlugin.js";
+
+/**
+ * 内建 plugin class 构造器。
+ */
+export type BuiltinPluginClass<T extends BasePlugin = BasePlugin> = new (
+  agent: AgentRuntime | null,
+) => T;
+
+/**
+ * 全部内建 plugin classes。
+ */
+export const BUILTIN_PLUGIN_CLASSES: BuiltinPluginClass[] = [
+  AuthPlugin,
+  SkillPlugin,
+  WebPlugin,
+  AsrPlugin,
+  TtsPlugin,
+  WorkboardPlugin,
+  ChatPlugin,
+  ContactPlugin,
+  TaskPlugin,
+  MemoryPlugin,
+  ShellPlugin,
+];
+
+/**
+ * 创建完整内建 plugin 实例集合。
+ */
+export function createBuiltinPlugins(agent: AgentRuntime | null = null): BasePlugin[] {
+  return BUILTIN_PLUGIN_CLASSES.map((PluginClass) => new PluginClass(agent));
+}