@downcity/plugins 1.0.254 → 1.0.280

package/bin/builtin/BuiltinPluginReadmes.d.ts

@@ -0,0 +1,14 @@
+/** Downcity 官方 Plugin 的用户说明内容。 */
+/** 官方 Plugin 在宿主 Overview 中展示的 Markdown 说明。 */
+export declare const BUILTIN_PLUGIN_READMES: {
+    readonly skill: "# Skill Catalog And Loader\n\nDiscovers skills available to the Agent, reads their instructions, and adds guidance for selecting the right skill during a task.\n\n## What it provides\n\n- Lists and inspects installed skills.\n- Loads skill instructions only when they are relevant.\n- Keeps skill discovery separate from the Agent definition.";
+    readonly workboard: "# Workboard Snapshot\n\nCollects structured snapshots of Agent runtime activity so work can be inspected and presented consistently.\n\nThe Plugin owns snapshot collection and normalization; it does not change how an Agent executes a task.";
+    readonly contact: "# Contact\n\nManages trusted relationships with remote Agents and provides the actions required to exchange messages and shared information.\n\nContact state is stored in the current Agent's private Plugin data directory.";
+    readonly task: "# Task\n\nCreates and manages reusable Agent tasks, trigger definitions, and execution records.\n\nTasks remain Agent-owned runtime resources and can be scheduled or invoked through the Plugin's actions.";
+    readonly chat: "# Chat\n\nConnects an Agent to external conversations through Telegram, Feishu / Lark, and QQ.\n\n## Profiles and Channels\n\n- Each Profile contains one complete Chat configuration.\n- A Channel type can appear once in the same Profile.\n- Credentials stay in Plugin configuration and are not copied into `agent.json`.";
+    readonly memory: "# Memory\n\nProvides provider-neutral long-term memory with recall, revision, and deletion capabilities.\n\nMemory data belongs to the current Agent and is stored in that Agent's private Plugin runtime directory.";
+    readonly web: "# Web\n\nProvides web search, document reading, and optional browser sessions to an Agent.\n\nUse Profiles to isolate provider endpoints, credentials, and browser settings for different environments.";
+    readonly image: "# Image\n\nDiscovers available image models, generates images, and returns structured result metadata.\n\nUse Profiles to keep image service endpoints and credentials separate between environments.";
+    readonly sound: "# Sound\n\nDiscovers speech models and provides automatic speech recognition and text-to-speech actions.\n\nUse Profiles to isolate speech service endpoints, models, and credentials.";
+};
+//# sourceMappingURL=BuiltinPluginReadmes.d.ts.map

package/bin/builtin/BuiltinPluginReadmes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuiltinPluginReadmes.d.ts","sourceRoot":"","sources":["../../src/builtin/BuiltinPluginReadmes.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB;;;;;;;;;;CAsDzB,CAAC"}

package/bin/builtin/BuiltinPluginReadmes.js

@@ -0,0 +1,58 @@
+/** Downcity 官方 Plugin 的用户说明内容。 */
+/** 官方 Plugin 在宿主 Overview 中展示的 Markdown 说明。 */
+export const BUILTIN_PLUGIN_READMES = {
+    skill: `# Skill Catalog And Loader
+
+Discovers skills available to the Agent, reads their instructions, and adds guidance for selecting the right skill during a task.
+
+## What it provides
+
+- Lists and inspects installed skills.
+- Loads skill instructions only when they are relevant.
+- Keeps skill discovery separate from the Agent definition.`,
+    workboard: `# Workboard Snapshot
+
+Collects structured snapshots of Agent runtime activity so work can be inspected and presented consistently.
+
+The Plugin owns snapshot collection and normalization; it does not change how an Agent executes a task.`,
+    contact: `# Contact
+
+Manages trusted relationships with remote Agents and provides the actions required to exchange messages and shared information.
+
+Contact state is stored in the current Agent's private Plugin data directory.`,
+    task: `# Task
+
+Creates and manages reusable Agent tasks, trigger definitions, and execution records.
+
+Tasks remain Agent-owned runtime resources and can be scheduled or invoked through the Plugin's actions.`,
+    chat: `# Chat
+
+Connects an Agent to external conversations through Telegram, Feishu / Lark, and QQ.
+
+## Profiles and Channels
+
+- Each Profile contains one complete Chat configuration.
+- A Channel type can appear once in the same Profile.
+- Credentials stay in Plugin configuration and are not copied into \`agent.json\`.`,
+    memory: `# Memory
+
+Provides provider-neutral long-term memory with recall, revision, and deletion capabilities.
+
+Memory data belongs to the current Agent and is stored in that Agent's private Plugin runtime directory.`,
+    web: `# Web
+
+Provides web search, document reading, and optional browser sessions to an Agent.
+
+Use Profiles to isolate provider endpoints, credentials, and browser settings for different environments.`,
+    image: `# Image
+
+Discovers available image models, generates images, and returns structured result metadata.
+
+Use Profiles to keep image service endpoints and credentials separate between environments.`,
+    sound: `# Sound
+
+Discovers speech models and provides automatic speech recognition and text-to-speech actions.
+
+Use Profiles to isolate speech service endpoints, models, and credentials.`,
+};
+//# sourceMappingURL=BuiltinPluginReadmes.js.map

package/bin/builtin/BuiltinPluginReadmes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuiltinPluginReadmes.js","sourceRoot":"","sources":["../../src/builtin/BuiltinPluginReadmes.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE;;;;;;;;4DAQmD;IAC1D,SAAS,EAAE;;;;wGAI2F;IACtG,OAAO,EAAE;;;;8EAImE;IAC5E,IAAI,EAAE;;;;yGAIiG;IACvG,IAAI,EAAE;;;;;;;;mFAQ2E;IACjF,MAAM,EAAE;;;;yGAI+F;IACvG,GAAG,EAAE;;;;0GAImG;IACxG,KAAK,EAAE;;;;4FAImF;IAC1F,KAAK,EAAE;;;;2EAIkE;CACjE,CAAC"}

package/bin/builtin/BuiltinPluginTypes.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Downcity 官方 Plugin 注册集合。
+ *
+ * 本模块负责把官方 Plugin 按应用配置装配成 Agent 独享实例。应用提供
+ * Embassy 服务，Plugin 自身只持有明确的服务接口。
+ */
+import type { Plugin } from "@downcity/agent";
+import type { PluginHostContext } from "@downcity/agent";
+import type { PluginMainModule } from "@downcity/plugin";
+/** 官方 Plugin definition 的最小结构协议。 */
+export interface BuiltinPluginDefinition {
+    /** Plugin 的稳定 ID。 */
+    id: string;
+    /** Plugin 的用户可见标题。 */
+    title: string;
+    /** Plugin 的用途说明。 */
+    description: string;
+    /** 宿主 Overview 展示的完整 Markdown 用户说明。 */
+    readme: string;
+    /** 官方 Plugin 是否提供 Agent 能力。 */
+    has_agent: boolean;
+    /** 官方 Plugin 是否提供宿主 main。 */
+    has_main: boolean;
+    /** 官方 Plugin 是否提供唯一 Mainview。 */
+    has_renderer: boolean;
+}
+/** 官方 Plugin 注册协议。 */
+export interface BuiltinPluginRegistration {
+    /** Plugin 的唯一静态定义。 */
+    readonly definition: BuiltinPluginDefinition;
+    /** 使用 City 读取的 Profile 创建一个 Agent 独享的 Plugin 实例。 */
+    create_agent(context: PluginHostContext): Plugin | Promise<Plugin>;
+    /** 可选的宿主 main 生命周期对象。 */
+    main?: PluginMainModule;
+}
+/** 创建官方 Plugin 注册集合所需的宿主能力。 */
+export interface BuiltinPluginRegistrationsOptions {
+    /** Contact Plugin 对外报告的 HTTP 地址。 */
+    contact_http?: {
+        /** HTTP 监听地址。 */
+        host?: string;
+        /** HTTP 监听端口。 */
+        port?: number;
+    };
+}
+/** 创建 Downcity 官方 Plugin 注册集合。 */
+export declare function create_builtin_plugin_registrations(options: BuiltinPluginRegistrationsOptions): BuiltinPluginRegistration[];
+//# sourceMappingURL=BuiltinPluginTypes.d.ts.map

package/bin/builtin/BuiltinPluginTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuiltinPluginTypes.d.ts","sourceRoot":"","sources":["../../src/builtin/BuiltinPluginTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA6BzD,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IAEX,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IAEnB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAElB,iCAAiC;IACjC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,sBAAsB;AACtB,MAAM,WAAW,yBAAyB;IACxC,sBAAsB;IACtB,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,oDAAoD;IACpD,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnE,yBAAyB;IACzB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CAEzB;AAED,+BAA+B;AAC/B,MAAM,WAAW,iCAAiC;IAChD,oCAAoC;IACpC,YAAY,CAAC,EAAE;QACb,iBAAiB;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,iBAAiB;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CAEH;AAED,kCAAkC;AAClC,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,iCAAiC,GACzC,yBAAyB,EAAE,CAiH7B"}

package/bin/builtin/BuiltinPluginTypes.js

@@ -0,0 +1,161 @@
+/**
+ * Downcity 官方 Plugin 注册集合。
+ *
+ * 本模块负责把官方 Plugin 按应用配置装配成 Agent 独享实例。应用提供
+ * Embassy 服务，Plugin 自身只持有明确的服务接口。
+ */
+import { CHAT_PLUGIN_MAIN } from "../chat/main/ChatPluginMain.js";
+import { IMAGE_PLUGIN_SETTINGS, SOUND_PLUGIN_SETTINGS, WEB_PLUGIN_SETTINGS, } from "../builtin/PluginSettingsDefinitions.js";
+import { create_plugin_settings_main } from "../builtin/main/PluginSettingsMain.js";
+import { BUILTIN_PLUGIN_READMES } from "../builtin/BuiltinPluginReadmes.js";
+import { ChatPlugin, } from "../chat.js";
+import { FeishuChannel, QqChannel, TelegramChannel } from "../chat.js";
+import { ContactPlugin } from "../contact.js";
+import { ImagePlugin } from "../image.js";
+import { MemoryPlugin, } from "../memory.js";
+import { SkillPlugin } from "../skill.js";
+import { SoundPlugin } from "../sound.js";
+import { TaskPlugin } from "../task.js";
+import { WebPlugin, } from "../web.js";
+import { WorkboardPlugin } from "../workboard.js";
+/** 创建 Downcity 官方 Plugin 注册集合。 */
+export function create_builtin_plugin_registrations(options) {
+    return [
+        simple_registration("skill", "Skill Catalog And Loader", "Lists and reads local skills, and injects discovery guidance.", BUILTIN_PLUGIN_READMES.skill, () => new SkillPlugin()),
+        simple_registration("workboard", "Workboard Snapshot", "Collects structured Agent runtime activity snapshots.", BUILTIN_PLUGIN_READMES.workboard, () => new WorkboardPlugin()),
+        simple_registration("contact", "Contact", "Manages trusted relationships and exchanges with remote Agents.", BUILTIN_PLUGIN_READMES.contact, () => new ContactPlugin({
+            host: options.contact_http?.host,
+            port: options.contact_http?.port,
+        })),
+        simple_registration("task", "Task", "Manages reusable tasks and their trigger runtime.", BUILTIN_PLUGIN_READMES.task, () => new TaskPlugin()),
+        {
+            definition: {
+                id: "chat",
+                title: "Chat",
+                description: "Connects Agents to Telegram, Feishu, and QQ channels.",
+                readme: BUILTIN_PLUGIN_READMES.chat,
+                has_agent: true,
+                has_main: true,
+                has_renderer: true,
+            },
+            main: CHAT_PLUGIN_MAIN,
+            create_agent(context) {
+                const config = context.profile;
+                return new ChatPlugin({
+                    queue: config.queue,
+                    channels: create_chat_channels(config.channels ?? []),
+                });
+            },
+        },
+        {
+            definition: {
+                id: "memory",
+                title: "Memory",
+                description: "Provides provider-neutral long-term memory, recall, revision, and deletion.",
+                readme: BUILTIN_PLUGIN_READMES.memory,
+                has_agent: true,
+                has_main: false,
+                has_renderer: false,
+            },
+            create_agent(context) {
+                return new MemoryPlugin({ root_path: context.data_path });
+            },
+        },
+        {
+            definition: {
+                id: "web",
+                title: "Web",
+                description: "Provides web search, document reading, and optional browser sessions.",
+                readme: BUILTIN_PLUGIN_READMES.web,
+                has_agent: true,
+                has_main: true,
+                has_renderer: true,
+            },
+            main: create_plugin_settings_main(WEB_PLUGIN_SETTINGS),
+            create_agent(context) {
+                const config = context.profile;
+                return new WebPlugin(config);
+            },
+        },
+        {
+            definition: {
+                id: "image",
+                title: "Image",
+                description: "Discovers image models, generates images, and reads results.",
+                readme: BUILTIN_PLUGIN_READMES.image,
+                has_agent: true,
+                has_main: true,
+                has_renderer: true,
+            },
+            main: create_plugin_settings_main(IMAGE_PLUGIN_SETTINGS),
+            create_agent: (context) => new ImagePlugin({
+                ...context.profile,
+            }),
+        },
+        {
+            definition: {
+                id: "sound",
+                title: "Sound",
+                description: "Discovers speech models and provides ASR and TTS.",
+                readme: BUILTIN_PLUGIN_READMES.sound,
+                has_agent: true,
+                has_main: true,
+                has_renderer: true,
+            },
+            main: create_plugin_settings_main(SOUND_PLUGIN_SETTINGS),
+            create_agent: (context) => new SoundPlugin({
+                ...context.profile,
+            }),
+        },
+    ];
+}
+/** 获取并适配官方 ImagePlugin 所需的 Embassy 图片服务。 */
+/** 创建没有配置协议的简单注册。 */
+function simple_registration(id, title, description, readme, create_agent) {
+    return {
+        definition: {
+            id,
+            title,
+            description,
+            readme,
+            has_agent: true,
+            has_main: false,
+            has_renderer: false,
+        },
+        create_agent,
+    };
+}
+/** 创建 Chat Resource 对应的运行渠道。 */
+function create_chat_channels(configs) {
+    const channel_types = new Set();
+    return configs.map((config) => {
+        if (channel_types.has(config.type)) {
+            throw new Error(`Chat Plugin channel type is duplicated: ${config.type}`);
+        }
+        channel_types.add(config.type);
+        if (config.type === "telegram") {
+            return new TelegramChannel({
+                id: config.id,
+                name: config.name,
+                bot_token: config.bot_token,
+            });
+        }
+        if (config.type === "feishu") {
+            return new FeishuChannel({
+                id: config.id,
+                name: config.name,
+                app_id: config.app_id,
+                app_secret: config.app_secret,
+                domain: config.domain,
+            });
+        }
+        return new QqChannel({
+            id: config.id,
+            name: config.name,
+            app_id: config.app_id,
+            app_secret: config.app_secret,
+            sandbox: config.sandbox,
+        });
+    });
+}
+//# sourceMappingURL=BuiltinPluginTypes.js.map

package/bin/builtin/BuiltinPluginTypes.js.map

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

package/bin/builtin/PluginSettingsDefinitions.d.ts

@@ -0,0 +1,9 @@
+/** Web、Image 与 Sound Plugin 自己拥有的设置 Mainview 字段定义。 */
+import type { PluginSettingsDefinition } from "../builtin/types/PluginSettings.js";
+/** Web Plugin Profile 设置。 */
+export declare const WEB_PLUGIN_SETTINGS: PluginSettingsDefinition;
+/** Image Plugin Profile 设置。 */
+export declare const IMAGE_PLUGIN_SETTINGS: PluginSettingsDefinition;
+/** Sound Plugin Profile 设置。 */
+export declare const SOUND_PLUGIN_SETTINGS: PluginSettingsDefinition;
+//# sourceMappingURL=PluginSettingsDefinitions.d.ts.map

package/bin/builtin/PluginSettingsDefinitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsDefinitions.d.ts","sourceRoot":"","sources":["../../src/builtin/PluginSettingsDefinitions.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAElF,6BAA6B;AAC7B,eAAO,MAAM,mBAAmB,EAAE,wBAgBjC,CAAC;AAEF,+BAA+B;AAC/B,eAAO,MAAM,qBAAqB,EAAE,wBAMnC,CAAC;AAEF,+BAA+B;AAC/B,eAAO,MAAM,qBAAqB,EAAE,wBAWnC,CAAC"}

package/bin/builtin/PluginSettingsDefinitions.js

@@ -0,0 +1,41 @@
+/** Web、Image 与 Sound Plugin 自己拥有的设置 Mainview 字段定义。 */
+/** Web Plugin Profile 设置。 */
+export const WEB_PLUGIN_SETTINGS = {
+    title: "Web",
+    description: "配置浏览器连接与页面观察默认值。未填写 CDP 地址时仍可使用搜索和文档读取。",
+    fields: [
+        {
+            key: "browser",
+            label: "Browser provider",
+            description: "当前支持 Playwright CDP 连接。",
+            type: "select",
+            options: [{ value: "playwright", label: "Playwright" }],
+        },
+        { key: "cdp_url", label: "CDP endpoint", description: "现有浏览器的 HTTP 或 WebSocket 调试地址。", type: "string" },
+        { key: "default_url", label: "Default URL", description: "浏览器 Session 没有指定地址时打开的页面。", type: "string" },
+        { key: "timeout_ms", label: "Operation timeout (ms)", type: "number", minimum: 1000, maximum: 60000 },
+        { key: "max_observation_chars", label: "Observation character limit", type: "number", minimum: 1, maximum: 100000 },
+    ],
+};
+/** Image Plugin Profile 设置。 */
+export const IMAGE_PLUGIN_SETTINGS = {
+    title: "Image",
+    description: "选择图像生成请求没有显式指定模型时使用的默认模型。",
+    fields: [
+        { key: "default_model", label: "Default image model", type: "string" },
+    ],
+};
+/** Sound Plugin Profile 设置。 */
+export const SOUND_PLUGIN_SETTINGS = {
+    title: "Sound",
+    description: "配置语音识别和语音合成的默认行为。",
+    fields: [
+        { key: "default_asr_model", label: "Default ASR model", type: "string" },
+        { key: "default_tts_model", label: "Default TTS model", type: "string" },
+        { key: "auto_asr", label: "Automatic transcription", description: "收到音频输入后自动执行语音识别。", type: "boolean" },
+        { key: "language", label: "Default language", type: "string" },
+        { key: "voice", label: "Default voice", type: "string" },
+        { key: "format", label: "Default audio format", type: "string" },
+    ],
+};
+//# sourceMappingURL=PluginSettingsDefinitions.js.map

package/bin/builtin/PluginSettingsDefinitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsDefinitions.js","sourceRoot":"","sources":["../../src/builtin/PluginSettingsDefinitions.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAItD,6BAA6B;AAC7B,MAAM,CAAC,MAAM,mBAAmB,GAA6B;IAC3D,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,yCAAyC;IACtD,MAAM,EAAE;QACN;YACE,GAAG,EAAE,SAAS;YACd,KAAK,EAAE,kBAAkB;YACzB,WAAW,EAAE,yBAAyB;YACtC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;SACxD;QACD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,+BAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvG,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,2BAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtG,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;QACrG,EAAE,GAAG,EAAE,uBAAuB,EAAE,KAAK,EAAE,6BAA6B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE;KACpH;CACF,CAAC;AAEF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,qBAAqB,GAA6B;IAC7D,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,2BAA2B;IACxC,MAAM,EAAE;QACN,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE;KACvE;CACF,CAAC;AAEF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,qBAAqB,GAA6B;IAC7D,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,mBAAmB;IAChC,MAAM,EAAE;QACN,EAAE,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxE,EAAE,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,yBAAyB,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE;QACvG,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9D,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxD,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE;KACjE;CACF,CAAC"}

package/bin/builtin/main/PluginSettingsMain.d.ts

@@ -0,0 +1,6 @@
+/** 官方简单设置 Plugin 的 main action 实现。 */
+import { type PluginMainModule } from "@downcity/plugin";
+import type { PluginSettingsDefinition } from "../../builtin/types/PluginSettings.js";
+/** 为一个字段集合创建 Profile 读取和保存 action。 */
+export declare function create_plugin_settings_main(definition: PluginSettingsDefinition): PluginMainModule;
+//# sourceMappingURL=PluginSettingsMain.d.ts.map

package/bin/builtin/main/PluginSettingsMain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsMain.d.ts","sourceRoot":"","sources":["../../../src/builtin/main/PluginSettingsMain.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAEV,wBAAwB,EACzB,MAAM,mCAAmC,CAAC;AAE3C,sCAAsC;AACtC,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,wBAAwB,GACnC,gBAAgB,CAiBlB"}

package/bin/builtin/main/PluginSettingsMain.js

@@ -0,0 +1,65 @@
+/** 官方简单设置 Plugin 的 main action 实现。 */
+import { define_plugin_main, } from "@downcity/plugin";
+/** 为一个字段集合创建 Profile 读取和保存 action。 */
+export function create_plugin_settings_main(definition) {
+    return define_plugin_main({
+        activate({ plugin }) {
+            plugin.action({
+                id: "profile.read",
+                run: async (_input, context) => await context.config.get(),
+            });
+            plugin.action({
+                id: "profile.save",
+                run: async (input, context) => {
+                    const config = normalize_settings(input, definition.fields);
+                    await context.config.set(config);
+                    return config;
+                },
+            });
+        },
+    });
+}
+/** 按 Plugin 自己声明的字段校验并规范化配置。 */
+function normalize_settings(input, fields) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        throw new Error("Plugin Profile config must be an object");
+    }
+    const source = input;
+    const result = {};
+    for (const field of fields) {
+        const value = source[field.key];
+        if (value === undefined || value === "")
+            continue;
+        if (field.type === "boolean") {
+            if (typeof value !== "boolean")
+                throw invalid_field(field.key);
+            result[field.key] = value;
+            continue;
+        }
+        if (field.type === "number") {
+            if (typeof value !== "number" || !Number.isFinite(value))
+                throw invalid_field(field.key);
+            if (field.minimum !== undefined && value < field.minimum)
+                throw invalid_field(field.key);
+            if (field.maximum !== undefined && value > field.maximum)
+                throw invalid_field(field.key);
+            result[field.key] = value;
+            continue;
+        }
+        if (typeof value !== "string")
+            throw invalid_field(field.key);
+        const normalized = value.trim();
+        if (!normalized)
+            continue;
+        if (field.type === "select" && !field.options?.some((item) => item.value === normalized)) {
+            throw invalid_field(field.key);
+        }
+        result[field.key] = normalized;
+    }
+    return result;
+}
+/** 创建稳定的字段校验错误。 */
+function invalid_field(key) {
+    return new Error(`Invalid Plugin Profile field: ${key}`);
+}
+//# sourceMappingURL=PluginSettingsMain.js.map

package/bin/builtin/main/PluginSettingsMain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsMain.js","sourceRoot":"","sources":["../../../src/builtin/main/PluginSettingsMain.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,kBAAkB,GAInB,MAAM,kBAAkB,CAAC;AAM1B,sCAAsC;AACtC,MAAM,UAAU,2BAA2B,CACzC,UAAoC;IAEpC,OAAO,kBAAkB,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,EAAE;YACjB,MAAM,CAAC,MAAM,CAAC;gBACZ,EAAE,EAAE,cAAc;gBAClB,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE;aAC3D,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC;gBACZ,EAAE,EAAE,cAAc;gBAClB,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBAC5B,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;oBAC5D,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBACjC,OAAO,MAAM,CAAC;gBAChB,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,gCAAgC;AAChC,SAAS,kBAAkB,CACzB,KAAkC,EAClC,MAAqC;IAErC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,MAAM,GAAG,KAAyB,CAAC;IACzC,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,MAAM,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/D,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACzF,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO;gBAAE,MAAM,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACzF,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO;gBAAE,MAAM,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACzF,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;YACzF,MAAM,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mBAAmB;AACnB,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/bin/builtin/renderer/PluginSettingsRenderer.d.ts

@@ -0,0 +1,6 @@
+/** 官方简单设置 Plugin 的统一 React Mainview 生成器。 */
+import { type PluginRendererComponent } from "@downcity/plugin/react";
+import type { PluginSettingsDefinition } from "../../builtin/types/PluginSettings.js";
+/** 根据具体 Plugin 的字段声明创建使用宿主 UI Components 的 Mainview。 */
+export declare function create_plugin_settings_renderer(definition: PluginSettingsDefinition): PluginRendererComponent;
+//# sourceMappingURL=PluginSettingsRenderer.d.ts.map

package/bin/builtin/renderer/PluginSettingsRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsRenderer.d.ts","sourceRoot":"","sources":["../../../src/builtin/renderer/PluginSettingsRenderer.tsx"],"names":[],"mappings":"AAAA,4CAA4C;AAI5C,OAAO,EAEL,KAAK,uBAAuB,EAE7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAsB,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAEtG,wDAAwD;AACxD,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,wBAAwB,GACnC,uBAAuB,CA+DzB"}

package/bin/builtin/renderer/PluginSettingsRenderer.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** 官方简单设置 Plugin 的统一 React Mainview 生成器。 */
+import { useCallback, useEffect, useState } from "react";
+import { define_plugin_renderer, } from "@downcity/plugin/react";
+/** 根据具体 Plugin 的字段声明创建使用宿主 UI Components 的 Mainview。 */
+export function create_plugin_settings_renderer(definition) {
+    return define_plugin_renderer(function PluginSettingsRenderer({ plugin, ui }) {
+        const { Button, Callout, Group, Input, LoadingState, Page, Row, Select, Switch, Toolbar } = ui.components;
+        const [draft, set_draft] = useState();
+        const [loading, set_loading] = useState(true);
+        const [saving, set_saving] = useState(false);
+        const [error, set_error] = useState("");
+        const load = useCallback(async () => {
+            set_loading(true);
+            set_error("");
+            try {
+                set_draft(await plugin.invoke("profile.read"));
+            }
+            catch (reason) {
+                set_error(to_error_message(reason));
+            }
+            finally {
+                set_loading(false);
+            }
+        }, [plugin]);
+        useEffect(() => { void load(); }, [load]);
+        const set_field = (field, value) => {
+            set_draft((current) => {
+                const next = { ...(current ?? {}) };
+                if (value === undefined || value === "")
+                    delete next[field.key];
+                else
+                    next[field.key] = value;
+                return next;
+            });
+        };
+        const save = async () => {
+            if (!draft)
+                return;
+            set_saving(true);
+            set_error("");
+            try {
+                const saved = await plugin.invoke("profile.save", draft);
+                set_draft(saved);
+                ui.toast({ type: "success", message: "Profile 已保存" });
+            }
+            catch (reason) {
+                const message = to_error_message(reason);
+                set_error(message);
+                ui.toast({ type: "error", message });
+            }
+            finally {
+                set_saving(false);
+            }
+        };
+        if (loading && !draft)
+            return _jsx(LoadingState, { label: "\u6B63\u5728\u8BFB\u53D6 Profile\u2026" });
+        return _jsxs(Page, { children: [_jsx(Toolbar, { actions: _jsx(Button, { variant: "primary", disabled: !draft || saving, on_click: () => void save(), children: saving ? "保存中…" : "保存" }) }), error ? _jsx(Callout, { tone: "danger", children: error }) : null, _jsx(Group, { children: definition.fields.map((field) => _jsx(Row, { label: field.label, description: field.description, trailing: _jsx(SettingControl, { field: field, value: draft?.[field.key], set_value: (value) => set_field(field, value), components: { Input, Select, Switch } }) }, field.key)) })] });
+    });
+}
+/** 根据字段类型选择宿主表单控件。 */
+function SettingControl({ field, value, set_value, components }) {
+    const { Input, Select, Switch } = components;
+    if (field.type === "boolean") {
+        return _jsx(Switch, { checked: value === true, on_checked_change: set_value, aria_label: field.label });
+    }
+    if (field.type === "select") {
+        return _jsx(Select, { value: typeof value === "string" ? value : "", options: field.options ?? [], on_value_change: set_value });
+    }
+    return _jsx(Input, { type: field.type === "number" ? "number" : "text", value: typeof value === "string" || typeof value === "number" ? String(value) : "", minimum: field.minimum, maximum: field.maximum, on_value_change: (next_value) => set_value(field.type === "number" ? next_value === "" ? undefined : Number(next_value) : next_value) });
+}
+/** 把未知失败转换为用户可见消息。 */
+function to_error_message(reason) {
+    return reason instanceof Error ? reason.message : String(reason);
+}
+//# sourceMappingURL=PluginSettingsRenderer.js.map

package/bin/builtin/renderer/PluginSettingsRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsRenderer.js","sourceRoot":"","sources":["../../../src/builtin/renderer/PluginSettingsRenderer.tsx"],"names":[],"mappings":"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"}

package/bin/builtin/types/PluginSettings.d.ts

@@ -0,0 +1,35 @@
+/** 官方 Plugin 设置 Mainview 的内部声明类型。 */
+/** 简单设置字段支持的值类型。 */
+export type PluginSettingFieldType = "string" | "number" | "boolean" | "select";
+/** 一个由具体 Plugin 声明的设置字段。 */
+export interface PluginSettingField {
+    /** Profile 配置中的稳定字段名。 */
+    readonly key: string;
+    /** Mainview 展示名称。 */
+    readonly label: string;
+    /** 可选的用户说明。 */
+    readonly description?: string;
+    /** 字段值类型。 */
+    readonly type: PluginSettingFieldType;
+    /** 数字字段允许的最小值。 */
+    readonly minimum?: number;
+    /** 数字字段允许的最大值。 */
+    readonly maximum?: number;
+    /** select 字段允许的稳定选项。 */
+    readonly options?: readonly {
+        /** 保存到配置的值。 */
+        readonly value: string;
+        /** Mainview 展示文本。 */
+        readonly label: string;
+    }[];
+}
+/** 一个简单设置 Mainview 的完整定义。 */
+export interface PluginSettingsDefinition {
+    /** Mainview 标题。 */
+    readonly title: string;
+    /** Mainview 说明。 */
+    readonly description: string;
+    /** Plugin 自己拥有的全部配置字段。 */
+    readonly fields: readonly PluginSettingField[];
+}
+//# sourceMappingURL=PluginSettings.d.ts.map

package/bin/builtin/types/PluginSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettings.d.ts","sourceRoot":"","sources":["../../../src/builtin/types/PluginSettings.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,oBAAoB;AACpB,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhF,4BAA4B;AAC5B,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,eAAe;IACf,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,aAAa;IACb,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IAEtC,kBAAkB;IAClB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,wBAAwB;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;QAC1B,eAAe;QACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAEvB,qBAAqB;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,EAAE,CAAC;CACL;AAED,6BAA6B;AAC7B,MAAM,WAAW,wBAAwB;IACvC,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,mBAAmB;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAChD"}

package/bin/builtin/types/PluginSettings.js

@@ -0,0 +1,3 @@
+/** 官方 Plugin 设置 Mainview 的内部声明类型。 */
+export {};
+//# sourceMappingURL=PluginSettings.js.map

package/bin/builtin/types/PluginSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettings.js","sourceRoot":"","sources":["../../../src/builtin/types/PluginSettings.ts"],"names":[],"mappings":"AAAA,qCAAqC"}