@zhin.js/core 1.3.0 → 1.3.2

package/lib/built/endpoint-commands.js

@@ -0,0 +1,102 @@
+/**
+ * IM Endpoint 管理与 /endpoints 内省命令（@zhin.js/core）
+ */
+import { Adapter } from '../adapter.js';
+import { MessageCommand } from '../command.js';
+import { rejectUnlessManagementOperator } from './management-command-guard.js';
+import { createEndpointLifecycleService } from './endpoint-lifecycle-service.js';
+import { endpointHelpText, formatEndpointsList } from './introspection-format.js';
+function collectRuntimeEndpoints(root) {
+    const rows = [];
+    for (const adapterName of root.adapters) {
+        const adapter = root.inject(adapterName);
+        if (!(adapter instanceof Adapter))
+            continue;
+        for (const [endpointId, endpoint] of adapter.endpoints.entries()) {
+            rows.push({
+                adapter: String(adapterName),
+                name: endpointId,
+                online: !!endpoint.$connected,
+            });
+        }
+    }
+    return rows;
+}
+export function registerEndpointManagementCommands(plugin, commandService) {
+    const root = plugin.root;
+    const disposers = [];
+    const service = () => createEndpointLifecycleService(root);
+    const guard = (message) => {
+        const ai = root.inject('ai');
+        return rejectUnlessManagementOperator(message, root, ai?.getTriggerConfig?.());
+    };
+    const register = (pattern, desc, handler) => {
+        const cmd = new MessageCommand(pattern)
+            .desc(desc)
+            .action(async (message, match) => {
+            const denied = guard(message);
+            if (denied)
+                return denied;
+            try {
+                return await handler(message, match);
+            }
+            catch (err) {
+                return `❌ ${err instanceof Error ? err.message : String(err)}`;
+            }
+        });
+        commandService.add(cmd, plugin.name);
+        disposers.push(() => commandService.remove(cmd));
+    };
+    register('/endpoint help', 'Endpoint 管理帮助', () => endpointHelpText());
+    register('/endpoint add [adapter:word]', '添加 Endpoint', async (message, match) => {
+        const adapterKey = typeof match?.params?.adapter === 'string' ? match.params.adapter.trim() : '';
+        if (!adapterKey) {
+            const list = service().listProvisionableAdapters();
+            if (list.length === 0) {
+                return '当前没有支持运行时添加的适配器（需 EndpointManager 或 endpointConfigSchema）。';
+            }
+            return [
+                '可用适配器：',
+                ...list.map((a) => `  • ${a}  — /endpoint add ${a}`),
+            ].join('\n');
+        }
+        const result = await service().add(adapterKey, message);
+        return result.message;
+    });
+    register('/endpoint remove <adapter:word> <name:word>', '从配置移除 Endpoint', async (_message, match) => {
+        const adapterKey = String(match?.params?.adapter ?? '');
+        const name = String(match?.params?.name ?? '');
+        const result = await service().remove(adapterKey, name);
+        return result.message;
+    });
+    register('/endpoint edit <adapter:word> <name:word>', '编辑 Endpoint 配置', async (message, match) => {
+        const adapterKey = String(match?.params?.adapter ?? '');
+        const name = String(match?.params?.name ?? '');
+        const result = await service().edit(adapterKey, name, message);
+        return result.message;
+    });
+    register('/endpoint start <adapter:word> <name:word>', '连接 Endpoint', async (message, match) => {
+        const adapterKey = String(match?.params?.adapter ?? '');
+        const name = String(match?.params?.name ?? '');
+        const result = await service().start(adapterKey, name, message);
+        return result.message;
+    });
+    register('/endpoint stop <adapter:word> <name:word>', '断开 Endpoint（保留配置）', async (_message, match) => {
+        const adapterKey = String(match?.params?.adapter ?? '');
+        const name = String(match?.params?.name ?? '');
+        const result = await service().stop(adapterKey, name);
+        return result.message;
+    });
+    register('/endpoint cancel', '取消进行中的 Endpoint 添加/绑定', () => {
+        if (!service().cancelProvision()) {
+            return '当前没有进行中的 Endpoint 绑定流程。';
+        }
+        return '已取消 Endpoint 绑定流程。';
+    });
+    register('/endpoints', '列出各适配器下的 Endpoint 及在线状态', () => formatEndpointsList(collectRuntimeEndpoints(root)));
+    return () => {
+        for (const d of disposers)
+            d();
+    };
+}
+//# sourceMappingURL=endpoint-commands.js.map

package/lib/built/endpoint-commands.js.map

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

package/lib/built/endpoint-lifecycle-service.d.ts

@@ -0,0 +1,27 @@
+import { Adapter } from '../adapter.js';
+import type { Endpoint } from '../endpoint.js';
+import type { Message } from '../message.js';
+import type { Plugin } from '../plugin.js';
+import type { EndpointConfigRecord, EndpointManager } from './endpoint-manager.js';
+export interface EndpointLifecycleResult {
+    message: string;
+    config?: EndpointConfigRecord;
+}
+export declare class EndpointLifecycleService {
+    private readonly root;
+    constructor(root: Plugin);
+    resolveAdapter(adapterKey: string): Adapter;
+    resolveManager(adapterKey: string): EndpointManager;
+    listProvisionableAdapters(): string[];
+    persistEndpoints(endpoints: EndpointConfigRecord[]): Promise<void>;
+    connectConfig(adapter: Adapter, config: EndpointConfigRecord): Promise<Endpoint>;
+    disconnectRuntime(adapter: Adapter, name: string): Promise<boolean>;
+    add(adapterKey: string, message: Message, initialReply?: string): Promise<EndpointLifecycleResult>;
+    edit(adapterKey: string, name: string, message: Message): Promise<EndpointLifecycleResult>;
+    remove(adapterKey: string, name: string): Promise<EndpointLifecycleResult>;
+    start(adapterKey: string, name: string, message: Message): Promise<EndpointLifecycleResult>;
+    stop(adapterKey: string, name: string): Promise<EndpointLifecycleResult>;
+    cancelProvision(): boolean;
+}
+export declare function createEndpointLifecycleService(root: Plugin): EndpointLifecycleService;
+//# sourceMappingURL=endpoint-lifecycle-service.d.ts.map

package/lib/built/endpoint-lifecycle-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-lifecycle-service.d.ts","sourceRoot":"","sources":["../../src/built/endpoint-lifecycle-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAkDD,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEzC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAQ3C,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAWnD,yBAAyB,IAAI,MAAM,EAAE;IAW/B,gBAAgB,CAAC,SAAS,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlE,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAchF,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUnE,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAqClG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmC1F,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAqB1E,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmB3F,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAW9E,eAAe,IAAI,OAAO;CAS3B;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAErF"}

package/lib/built/endpoint-lifecycle-service.js

@@ -0,0 +1,219 @@
+import { Adapter } from '../adapter.js';
+import { segment } from '../utils.js';
+import { connectEndpointInstance, disconnectEndpointInstance } from './connect-endpoint-instance.js';
+import { adapterSupportsProvision, resolveEndpointManager } from './schema-endpoint-manager.js';
+function getConfigService(root) {
+    const configService = root.inject('config');
+    if (!configService?.primaryFile) {
+        throw new Error('配置服务不可用');
+    }
+    const loader = configService.configs.get(configService.primaryFile);
+    if (!loader) {
+        throw new Error('配置文件未加载');
+    }
+    return configService;
+}
+function readAllEndpoints(root) {
+    const configService = getConfigService(root);
+    const raw = configService.getRaw(configService.primaryFile);
+    return [...(raw?.endpoints ?? [])];
+}
+function assertUniqueName(endpoints, context, name, replaceIndex) {
+    const conflict = endpoints.findIndex((e) => e.context === context && e.name === name);
+    if (conflict >= 0 && conflict !== replaceIndex) {
+        throw new Error(`zhin.config 中已存在 ${context}/${name}`);
+    }
+}
+function buildProvisionContext(root, message) {
+    return {
+        message,
+        root,
+        onStatusUpdate: async (status, extra) => {
+            if (message.$reply) {
+                let content = status;
+                if (extra?.qrcode && typeof extra.qrcode === 'string') {
+                    content = [segment.qrcode(extra.qrcode), segment.text(status)];
+                }
+                await message.$reply(content);
+            }
+        },
+    };
+}
+export class EndpointLifecycleService {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    resolveAdapter(adapterKey) {
+        const adapter = this.root.inject(adapterKey);
+        if (!(adapter instanceof Adapter)) {
+            throw new Error(`适配器 ${adapterKey} 未安装或未就绪`);
+        }
+        return adapter;
+    }
+    resolveManager(adapterKey) {
+        const adapter = this.resolveAdapter(adapterKey);
+        const manager = resolveEndpointManager(adapter);
+        if (!manager) {
+            throw new Error(`适配器 ${adapterKey} 不支持运行时 Endpoint 管理（无 EndpointManager 且未声明 endpointConfigSchema）`);
+        }
+        return manager;
+    }
+    listProvisionableAdapters() {
+        return this.root.adapters.filter((name) => {
+            try {
+                const adapter = this.resolveAdapter(String(name));
+                return adapterSupportsProvision(adapter);
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    async persistEndpoints(endpoints) {
+        const configService = getConfigService(this.root);
+        const loader = configService.configs.get(configService.primaryFile);
+        loader.patchKey('endpoints', endpoints);
+        loader.load();
+    }
+    async connectConfig(adapter, config) {
+        const name = config.name;
+        if (adapter.endpoints.has(name)) {
+            throw new Error(`Endpoint ${name} 已在线，请先 /endpoint stop ${String(adapter.name)} ${name}`);
+        }
+        const endpoint = await connectEndpointInstance({
+            plugin: this.root,
+            adapter,
+            config: config,
+        });
+        adapter.endpoints.set(endpoint.$id, endpoint);
+        return endpoint;
+    }
+    async disconnectRuntime(adapter, name) {
+        const endpoint = adapter.endpoints.get(name);
+        if (!endpoint)
+            return false;
+        if (endpoint.$connected) {
+            await disconnectEndpointInstance(this.root, adapter, endpoint);
+        }
+        adapter.endpoints.delete(name);
+        return true;
+    }
+    async add(adapterKey, message, initialReply) {
+        const adapter = this.resolveAdapter(adapterKey);
+        const manager = this.resolveManager(adapterKey);
+        const ctx = buildProvisionContext(this.root, message);
+        const config = await manager.addEndpoint(ctx);
+        if (!config.context)
+            config.context = adapterKey;
+        if (!config.name?.trim()) {
+            throw new Error('Endpoint 名称不能为空');
+        }
+        const endpoints = readAllEndpoints(this.root);
+        assertUniqueName(endpoints, config.context, config.name);
+        endpoints.push(config);
+        await this.persistEndpoints(endpoints);
+        try {
+            await this.connectConfig(adapter, config);
+        }
+        catch (err) {
+            const needsRestart = adapter.getEndpointNeedsRestart?.() ??
+                adapter.constructor.endpointNeedsRestart;
+            const hint = needsRestart
+                ? '配置已写入，请重启进程后连接。'
+                : `配置已写入，可用 /endpoint start ${adapterKey} ${config.name} 重试。`;
+            throw new Error(`${err instanceof Error ? err.message : String(err)}（${hint}）`);
+        }
+        const prefix = initialReply ? `${initialReply}\n` : '';
+        return {
+            message: `${prefix}✅ 已添加并连接 endpoint \`${config.name}\`（${adapterKey}），已写入 zhin.config。`,
+            config,
+        };
+    }
+    async edit(adapterKey, name, message) {
+        const adapter = this.resolveAdapter(adapterKey);
+        const manager = this.resolveManager(adapterKey);
+        const endpoints = readAllEndpoints(this.root);
+        const index = endpoints.findIndex((e) => e.context === adapterKey && e.name === name);
+        if (index < 0) {
+            throw new Error(`zhin.config 中不存在 ${adapterKey}/${name}`);
+        }
+        if (adapter.endpoints.has(name)) {
+            await this.disconnectRuntime(adapter, name);
+        }
+        const ctx = buildProvisionContext(this.root, message);
+        const updated = await manager.editEndpoint(name, ctx);
+        updated.context = adapterKey;
+        updated.name = name;
+        endpoints[index] = updated;
+        await this.persistEndpoints(endpoints);
+        try {
+            await this.connectConfig(adapter, updated);
+        }
+        catch (err) {
+            throw new Error(`配置已更新，但连接失败：${err instanceof Error ? err.message : String(err)}。` +
+                `可用 /endpoint start ${adapterKey} ${name} 重试。`);
+        }
+        return {
+            message: `✅ 已更新并连接 endpoint \`${name}\`（${adapterKey}）。`,
+            config: updated,
+        };
+    }
+    async remove(adapterKey, name) {
+        const adapter = this.resolveAdapter(adapterKey);
+        const manager = this.resolveManager(adapterKey);
+        await this.stop(adapterKey, name);
+        const ok = await manager.removeEndpoint(name);
+        if (!ok) {
+            throw new Error(`无法移除 ${adapterKey}/${name}`);
+        }
+        const endpoints = readAllEndpoints(this.root);
+        const next = endpoints.filter((e) => !(e.context === adapterKey && e.name === name));
+        if (next.length === endpoints.length) {
+            throw new Error(`zhin.config 中不存在 ${adapterKey}/${name}`);
+        }
+        await this.persistEndpoints(next);
+        return { message: `✅ 已从配置移除 endpoint \`${name}\`（${adapterKey}）。` };
+    }
+    async start(adapterKey, name, message) {
+        const adapter = this.resolveAdapter(adapterKey);
+        const manager = this.resolveManager(adapterKey);
+        const endpoints = readAllEndpoints(this.root);
+        const config = endpoints.find((e) => e.context === adapterKey && e.name === name);
+        if (!config) {
+            throw new Error(`zhin.config 中不存在 ${adapterKey}/${name}`);
+        }
+        if (adapter.endpoints.has(name)) {
+            return { message: `Endpoint ${adapterKey}/${name} 已在线。` };
+        }
+        const ctx = buildProvisionContext(this.root, message);
+        await manager.startEndpoint(name, ctx);
+        await this.connectConfig(adapter, config);
+        return { message: `✅ 已连接 endpoint \`${name}\`（${adapterKey}）。`, config };
+    }
+    async stop(adapterKey, name) {
+        const adapter = this.resolveAdapter(adapterKey);
+        const manager = this.resolveManager(adapterKey);
+        const stopped = await this.disconnectRuntime(adapter, name);
+        await manager.stopEndpoint(name);
+        if (!stopped) {
+            return { message: `Endpoint ${adapterKey}/${name} 当前未在线。` };
+        }
+        return { message: `✅ 已断开 endpoint \`${name}\`（${adapterKey}），配置仍保留。` };
+    }
+    cancelProvision() {
+        for (const adapterName of this.root.adapters) {
+            const adapter = this.root.inject(adapterName);
+            if (!(adapter instanceof Adapter))
+                continue;
+            const manager = resolveEndpointManager(adapter);
+            if (manager?.cancelProvision?.())
+                return true;
+        }
+        return false;
+    }
+}
+export function createEndpointLifecycleService(root) {
+    return new EndpointLifecycleService(root);
+}
+//# sourceMappingURL=endpoint-lifecycle-service.js.map

package/lib/built/endpoint-lifecycle-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-lifecycle-service.js","sourceRoot":"","sources":["../../src/built/endpoint-lifecycle-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAMrG,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAOhG,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAA8B,CAAC;IACzE,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAyC,aAAa,CAAC,WAAW,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,gBAAgB,CACvB,SAAiC,EACjC,OAAe,EACf,IAAY,EACZ,YAAqB;IAErB,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAChD,CAAC;IACF,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY,EAAE,OAAgB;IAC3D,OAAO;QACL,OAAO;QACP,IAAI;QACJ,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;YACtC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,IAAI,OAAO,GAAgB,MAAM,CAAC;gBAClC,IAAI,KAAK,EAAE,MAAM,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACtD,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;gBACjE,CAAC;gBACD,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,cAAc,CAAC,UAAkB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,OAAO,YAAY,OAAO,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,OAAO,UAAU,UAAU,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,cAAc,CAAC,UAAkB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,OAAO,UAAU,kEAAkE,CACpF,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,yBAAyB;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACxC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAClD,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC;YAC3C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,SAAiC;QACtD,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW,CAAE,CAAC;QACrE,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAgB,EAAE,MAA4B;QAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,0BAA0B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC;YAC7C,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,OAAO;YACP,MAAM,EAAE,MAAiC;SAC1C,CAAC,CAAC;QACH,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAiB,CAAC,CAAC;QACvD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAAgB,EAAE,IAAY;QACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,0BAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,UAAkB,EAAE,OAAgB,EAAE,YAAqB;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,UAAU,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,gBAAgB,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,OAAO,CAAC,uBAAuB,EAAE,EAAE;gBACrD,OAAO,CAAC,WAAmE,CAAC,oBAAoB,CAAC;YACpG,MAAM,IAAI,GAAG,YAAY;gBACvB,CAAC,CAAC,iBAAiB;gBACnB,CAAC,CAAC,4BAA4B,UAAU,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC;YAChE,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAC/D,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO;YACL,OAAO,EACL,GAAG,MAAM,uBAAuB,MAAM,CAAC,IAAI,MAAM,UAAU,oBAAoB;YACjF,MAAM;SACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,IAAY,EAAE,OAAgB;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtF,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,CAAC,OAAO,GAAG,UAAU,CAAC;QAC7B,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;QAC3B,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,eAAe,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG;gBAChE,sBAAsB,UAAU,IAAI,IAAI,MAAM,CACjD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,uBAAuB,IAAI,MAAM,UAAU,IAAI;YACxD,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,IAAY;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAEhD,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAElC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,QAAQ,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;QACrF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAElC,OAAO,EAAE,OAAO,EAAE,uBAAuB,IAAI,MAAM,UAAU,IAAI,EAAE,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,UAAkB,EAAE,IAAY,EAAE,OAAgB;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,YAAY,UAAU,IAAI,IAAI,OAAO,EAAE,CAAC;QAC5D,CAAC;QAED,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE1C,OAAO,EAAE,OAAO,EAAE,oBAAoB,IAAI,MAAM,UAAU,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,IAAY;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,YAAY,UAAU,IAAI,IAAI,SAAS,EAAE,CAAC;QAC9D,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,oBAAoB,IAAI,MAAM,UAAU,UAAU,EAAE,CAAC;IACzE,CAAC;IAED,eAAe;QACb,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,CAAC,OAAO,YAAY,OAAO,CAAC;gBAAE,SAAS;YAC5C,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,OAAO,EAAE,eAAe,EAAE,EAAE;gBAAE,OAAO,IAAI,CAAC;QAChD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/lib/built/endpoint-manager.d.ts

@@ -0,0 +1,35 @@
+import type { Schema } from '@zhin.js/schema';
+import type { Message } from '../message.js';
+import type { Plugin } from '../plugin.js';
+/** zhin.config.endpoints[] 单条记录 */
+export type EndpointConfigRecord = Record<string, unknown> & {
+    context: string;
+    name: string;
+};
+export type EndpointStatusExtra = Record<string, unknown>;
+export interface ProvisionContext {
+    message: Message;
+    root: Plugin;
+    /** 长连接 / 扫码 / 登录进度回调（由 core 转发到 message.$reply） */
+    onStatusUpdate: (status: string, extra?: EndpointStatusExtra) => void | Promise<void>;
+}
+export interface EndpointManager {
+    /** 是否支持运行时 add（含 schema 通用或自定义） */
+    supportsProvision(): boolean;
+    listEndpoints(): EndpointConfigRecord[];
+    addEndpoint(ctx: ProvisionContext): Promise<EndpointConfigRecord>;
+    editEndpoint(name: string, ctx: ProvisionContext): Promise<EndpointConfigRecord>;
+    removeEndpoint(name: string): Promise<boolean>;
+    startEndpoint(name: string, ctx: ProvisionContext): Promise<void>;
+    stopEndpoint(name: string): Promise<boolean>;
+    /** 取消进行中的 add/edit 交互（如 QQ 扫码）；无则返回 false */
+    cancelProvision?(): boolean;
+}
+export interface EndpointManagerClass {
+    new (adapter: import('../adapter.js').Adapter): EndpointManager;
+    /** 热连接失败时是否建议重启进程 */
+    readonly needsRestart?: boolean;
+    /** 通用 schema 驱动 add/edit 时使用 */
+    readonly endpointConfigSchema?: Schema;
+}
+//# sourceMappingURL=endpoint-manager.d.ts.map

package/lib/built/endpoint-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-manager.d.ts","sourceRoot":"","sources":["../../src/built/endpoint-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,mCAAmC;AACnC,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvF;AAED,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,iBAAiB,IAAI,OAAO,CAAC;IAC7B,aAAa,IAAI,oBAAoB,EAAE,CAAC;IACxC,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,6CAA6C;IAC7C,eAAe,CAAC,IAAI,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,OAAO,EAAE,OAAO,eAAe,EAAE,OAAO,GAAG,eAAe,CAAC;IAChE,qBAAqB;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,gCAAgC;IAChC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC"}

package/lib/built/endpoint-manager.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=endpoint-manager.js.map

package/lib/built/endpoint-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-manager.js","sourceRoot":"","sources":["../../src/built/endpoint-manager.ts"],"names":[],"mappings":""}

package/lib/built/generated-qrcode.d.ts

@@ -0,0 +1,25 @@
+export interface GenerateQrCodeOptions {
+    width?: number;
+    margin?: number;
+    errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
+}
+export interface PrintQrCodeTerminalOptions {
+    small?: boolean;
+}
+/** 二维码实例：一次 generate，多种输出 */
+export declare class GeneratedQrCode {
+    #private;
+    private constructor();
+    static generate(text: string, options?: GenerateQrCodeOptions): Promise<GeneratedQrCode>;
+    /** data URL，含 `data:image/png;base64,...` 前缀 */
+    toDataUrl(): string;
+    /**
+     * encoding === 'base64' → 纯 base64 载荷（无 data: 前缀）
+     */
+    toString(encoding: 'base64'): string;
+    /** 输出 ASCII 二维码到 process.stdout */
+    printToTerminal(options?: PrintQrCodeTerminalOptions): Promise<void>;
+}
+/** 便捷别名 */
+export declare const generateQrCode: typeof GeneratedQrCode.generate;
+//# sourceMappingURL=generated-qrcode.d.ts.map

package/lib/built/generated-qrcode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-qrcode.d.ts","sourceRoot":"","sources":["../../src/built/generated-qrcode.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,6BAA6B;AAC7B,qBAAa,eAAe;;IAI1B,OAAO;WAKM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,eAAe,CAAC;IASlG,gDAAgD;IAChD,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAWpC,mCAAmC;IAC7B,eAAe,CAAC,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;CAO/E;AAED,WAAW;AACX,eAAO,MAAM,cAAc,iCAAiD,CAAC"}

package/lib/built/generated-qrcode.js

@@ -0,0 +1,46 @@
+import QRCode from 'qrcode';
+/** 二维码实例：一次 generate，多种输出 */
+export class GeneratedQrCode {
+    #text;
+    #dataUrl;
+    constructor(text, dataUrl) {
+        this.#text = text;
+        this.#dataUrl = dataUrl;
+    }
+    static async generate(text, options = {}) {
+        const dataUrl = await QRCode.toDataURL(text, {
+            width: options.width ?? 280,
+            margin: options.margin ?? 2,
+            errorCorrectionLevel: options.errorCorrectionLevel ?? 'M',
+        });
+        return new GeneratedQrCode(text, dataUrl);
+    }
+    /** data URL，含 `data:image/png;base64,...` 前缀 */
+    toDataUrl() {
+        return this.#dataUrl;
+    }
+    /**
+     * encoding === 'base64' → 纯 base64 载荷（无 data: 前缀）
+     */
+    toString(encoding) {
+        if (encoding !== 'base64') {
+            throw new Error(`GeneratedQrCode.toString: unsupported encoding "${encoding}"`);
+        }
+        const prefix = 'data:image/png;base64,';
+        if (!this.#dataUrl.startsWith(prefix)) {
+            throw new Error('GeneratedQrCode.toString: unexpected data URL format');
+        }
+        return this.#dataUrl.slice(prefix.length);
+    }
+    /** 输出 ASCII 二维码到 process.stdout */
+    async printToTerminal(options = {}) {
+        const terminalText = await QRCode.toString(this.#text, {
+            type: 'terminal',
+            small: options.small ?? true,
+        });
+        process.stdout.write(`${terminalText}\n`);
+    }
+}
+/** 便捷别名 */
+export const generateQrCode = GeneratedQrCode.generate.bind(GeneratedQrCode);
+//# sourceMappingURL=generated-qrcode.js.map

package/lib/built/generated-qrcode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-qrcode.js","sourceRoot":"","sources":["../../src/built/generated-qrcode.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAY5B,6BAA6B;AAC7B,MAAM,OAAO,eAAe;IACjB,KAAK,CAAS;IACd,QAAQ,CAAS;IAE1B,YAAoB,IAAY,EAAE,OAAe;QAC/C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,UAAiC,EAAE;QACrE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;YAC3C,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG;YAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;YAC3B,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,GAAG;SAC1D,CAAC,CAAC;QACH,OAAO,IAAI,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,gDAAgD;IAChD,SAAS;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAkB;QACzB,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,mDAAmD,QAAQ,GAAG,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,MAAM,GAAG,wBAAwB,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,eAAe,CAAC,UAAsC,EAAE;QAC5D,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE;YACrD,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;SAC7B,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,IAAI,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,WAAW;AACX,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC"}

package/lib/built/html-renderer-loader.d.ts

@@ -0,0 +1,12 @@
+import type { HtmlRendererForRichSegment } from './rich-segments/types.js';
+/** 动态 import 时使用的包名（与 @zhin.js/html-renderer package.json 一致） */
+export declare const HTML_RENDERER_PACKAGE = "@zhin.js/html-renderer";
+export interface LoadHtmlRendererOptions {
+    getConfig?: () => Record<string, unknown> | undefined;
+    warn?: (message: string) => void;
+}
+/** 动态加载 @zhin.js/html-renderer；未安装时 warn 一次并返回 undefined */
+export declare function loadHtmlRenderer(opts?: LoadHtmlRendererOptions): Promise<HtmlRendererForRichSegment | undefined>;
+/** 测试用：重置加载缓存 */
+export declare function resetHtmlRendererLoaderForTests(): void;
+//# sourceMappingURL=html-renderer-loader.d.ts.map

package/lib/built/html-renderer-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-renderer-loader.d.ts","sourceRoot":"","sources":["../../src/built/html-renderer-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE3E,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACtD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAKD,4DAA4D;AAC5D,wBAAsB,gBAAgB,CACpC,IAAI,CAAC,EAAE,uBAAuB,GAC7B,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAmBjD;AAED,iBAAiB;AACjB,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD"}

package/lib/built/html-renderer-loader.js

@@ -0,0 +1,29 @@
+/** 动态 import 时使用的包名（与 @zhin.js/html-renderer package.json 一致） */
+export const HTML_RENDERER_PACKAGE = '@zhin.js/html-renderer';
+let cached;
+let warned = false;
+/** 动态加载 @zhin.js/html-renderer；未安装时 warn 一次并返回 undefined */
+export async function loadHtmlRenderer(opts) {
+    if (cached !== undefined) {
+        return cached ?? undefined;
+    }
+    try {
+        const mod = await import(HTML_RENDERER_PACKAGE);
+        cached = mod.createHtmlRenderer(opts?.getConfig?.() ?? {});
+        return cached;
+    }
+    catch {
+        if (!warned) {
+            warned = true;
+            opts?.warn?.(`未安装 ${HTML_RENDERER_PACKAGE}，html/markdown=>image 已降级为 text。安装: pnpm add ${HTML_RENDERER_PACKAGE}`);
+        }
+        cached = null;
+        return undefined;
+    }
+}
+/** 测试用：重置加载缓存 */
+export function resetHtmlRendererLoaderForTests() {
+    cached = undefined;
+    warned = false;
+}
+//# sourceMappingURL=html-renderer-loader.js.map

package/lib/built/html-renderer-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-renderer-loader.js","sourceRoot":"","sources":["../../src/built/html-renderer-loader.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAO9D,IAAI,MAAqD,CAAC;AAC1D,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAA8B;IAE9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,IAAI,SAAS,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAA+B,CAAC;QACzF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,EAAE,IAAI,EAAE,CACV,OAAO,qBAAqB,gDAAgD,qBAAqB,EAAE,CACpG,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,IAAI,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,+BAA+B;IAC7C,MAAM,GAAG,SAAS,CAAC;IACnB,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC"}

package/lib/built/html-segment-fallback.d.ts

@@ -1,5 +1,6 @@
 /**
- * 出站 `html` 消息段兜底：未装 html-renderer 或转图失败时，自动剥离为 text 段。
+ * 出站 `html` 消息段兜底：等价于 Adapter policy `html:'text'`。
+ * 出站渲染首选 `resolveRichSegments`（renderSendMessage 首步）。
  */
 import type { Plugin } from '../plugin.js';
 import type { SendContent } from '../types.js';

package/lib/built/html-segment-fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-segment-fallback.d.ts","sourceRoot":"","sources":["../../src/built/html-segment-fallback.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAkB,WAAW,EAAe,MAAM,aAAa,CAAC;AAc5E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAkB1E;AAED,mDAAmD;AACnD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAYtE"}
+{"version":3,"file":"html-segment-fallback.d.ts","sourceRoot":"","sources":["../../src/built/html-segment-fallback.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAkB,WAAW,EAAe,MAAM,aAAa,CAAC;AAc5E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAkB1E;AAED,mDAAmD;AACnD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAYtE"}

package/lib/built/html-segment-fallback.js.map

@@ -1 +1 @@
-{"version":3,"file":"html-segment-fallback.js","sourceRoot":"","sources":["../../src/built/html-segment-fallback.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,SAAS,OAAO,CAAC,OAAoB;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,sBAAsB,CAAC,IAA6B;IAC3D,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC5E,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAoB;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAgC,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACrD,IAAI,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAE,CAAC;IACrC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,2BAA2B,CAAC,MAAc;IACxD,MAAM,OAAO,GAAG,CAAC,OAAoB,EAAe,EAAE;QACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,OAAO,IAAI,IAAI;YAAE,OAAO,OAAO,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;YAC7E,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,EAAE,CAAC;IACpE,CAAC,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"html-segment-fallback.js","sourceRoot":"","sources":["../../src/built/html-segment-fallback.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,SAAS,OAAO,CAAC,OAAoB;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,sBAAsB,CAAC,IAA6B;IAC3D,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC5E,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAoB;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAgC,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACrD,IAAI,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAE,CAAC;IACrC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,2BAA2B,CAAC,MAAc;IACxD,MAAM,OAAO,GAAG,CAAC,OAAoB,EAAe,EAAE;QACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,OAAO,IAAI,IAAI;YAAE,OAAO,OAAO,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;YAC7E,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,EAAE,CAAC;IACpE,CAAC,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC"}

package/lib/built/introspection-format.d.ts

@@ -0,0 +1,11 @@
+/**
+ * IM 内省指令格式化（/cmd、/endpoints 等）
+ */
+export interface EndpointRow {
+    adapter: string;
+    name: string;
+    online: boolean;
+}
+export declare function formatEndpointsList(endpoints: EndpointRow[]): string;
+export declare function endpointHelpText(): string;
+//# sourceMappingURL=introspection-format.d.ts.map

package/lib/built/introspection-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection-format.d.ts","sourceRoot":"","sources":["../../src/built/introspection-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,CAQpE;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAazC"}

package/lib/built/introspection-format.js

@@ -0,0 +1,28 @@
+/**
+ * IM 内省指令格式化（/cmd、/endpoints 等）
+ */
+export function formatEndpointsList(endpoints) {
+    if (endpoints.length === 0)
+        return '🤖 暂无 Endpoint 实例';
+    const lines = ['🤖 Endpoint 列表 (' + endpoints.length + ')', ''];
+    for (const b of [...endpoints].sort((a, c) => a.adapter.localeCompare(c.adapter) || a.name.localeCompare(c.name))) {
+        const mark = b.online ? '● online' : '○ offline';
+        lines.push(`  ${mark}  ${b.adapter}/${b.name}`);
+    }
+    return lines.join('\n');
+}
+export function endpointHelpText() {
+    return [
+        'Endpoint 运行时管理：',
+        '',
+        '  /endpoint add [adapter]   — 添加 endpoint（adapter 交互或 schema 向导）',
+        '  /endpoint remove <adapter> <name>',
+        '  /endpoint edit <adapter> <name>',
+        '  /endpoint start <adapter> <name>',
+        '  /endpoint stop <adapter> <name>',
+        '  /endpoint cancel          — 取消进行中的添加/绑定',
+        '  /endpoint help',
+        '  /endpoints                — 查看运行时在线状态',
+    ].join('\n');
+}
+//# sourceMappingURL=introspection-format.js.map