@zhin.js/core 1.3.1 → 1.3.2

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":"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"}

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

package/lib/built/introspection-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection-format.js","sourceRoot":"","sources":["../../src/built/introspection-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,UAAU,mBAAmB,CAAC,SAAwB;IAC1D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACvD,MAAM,KAAK,GAAG,CAAC,kBAAkB,GAAG,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;IAChE,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAClH,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,iBAAiB;QACjB,EAAE;QACF,kEAAkE;QAClE,qCAAqC;QACrC,mCAAmC;QACnC,oCAAoC;QACpC,mCAAmC;QACnC,2CAA2C;QAC3C,kBAAkB;QAClB,yCAAyC;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/lib/built/login-assist.d.ts

@@ -9,7 +9,7 @@
  *   endpoint.login.pending — 有新待办时触发，payload: PendingLoginTask
  */
 import type { Plugin } from '../plugin.js';
-export type LoginAssistType = 'qrcode' | 'sms' | 'slider' | 'device' | 'other';
+export type LoginAssistType = 'qrcode' | 'sms' | 'slider' | 'device' | 'auth' | 'other';
 export interface PendingLoginTaskPayload {
     /** 说明文案（如「请扫码登录」） */
     message?: string;

package/lib/built/login-assist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login-assist.d.ts","sourceRoot":"","sources":["../../src/built/login-assist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAM3C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,uBAAuB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAYD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,KAAK,CAAK;gBAEN,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACH,YAAY,CACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiB5C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAQpE;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,OAAO;IAQjD;;OAEG;IACH,WAAW,IAAI,gBAAgB,EAAE;IAIjC,OAAO,IAAI,IAAI;CAMhB;AAMD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,UAAU,QAAQ;YAChB,WAAW,EAAE,WAAW,CAAC;SAC1B;KACF;CACF"}
+{"version":3,"file":"login-assist.d.ts","sourceRoot":"","sources":["../../src/built/login-assist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAM3C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAExF,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,uBAAuB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAYD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,KAAK,CAAK;gBAEN,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACH,YAAY,CACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiB5C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAQpE;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,OAAO;IAQjD;;OAEG;IACH,WAAW,IAAI,gBAAgB,EAAE;IAIjC,OAAO,IAAI,IAAI;CAMhB;AAMD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,MAAM,CAAC;QACf,UAAU,QAAQ;YAChB,WAAW,EAAE,WAAW,CAAC;SAC1B;KACF;CACF"}

package/lib/built/management-command-guard.d.ts

@@ -0,0 +1,11 @@
+/**
+ * IM 运维 / Endpoint 管理斜杠命令：仅 master 或 trusted 可执行。
+ */
+import { resolveSenderRoles, type AITriggerConfig } from './ai-trigger.js';
+import type { Message } from '../message.js';
+import type { Plugin } from '../plugin.js';
+export declare const MANAGEMENT_COMMAND_DENIED = "\u26A0\uFE0F \u8BE5\u547D\u4EE4\u4EC5 Endpoint Owner\uFF08master\uFF09\u6216 trusted \u64CD\u4F5C\u5458\u53EF\u7528\u3002";
+export declare function resolveManagementCommandRoles(message: Message, root: Plugin, triggerConfig?: AITriggerConfig): ReturnType<typeof resolveSenderRoles>['roles'];
+/** 通过返回 null；拒绝返回用户可见提示文案 */
+export declare function rejectUnlessManagementOperator(message: Message, root: Plugin, triggerConfig?: AITriggerConfig): string | null;
+//# sourceMappingURL=management-command-guard.d.ts.map

package/lib/built/management-command-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-command-guard.d.ts","sourceRoot":"","sources":["../../src/built/management-command-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEL,kBAAkB,EAClB,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,eAAO,MAAM,yBAAyB,8HACY,CAAC;AAEnD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,eAAe,GAC9B,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAOhD;AAED,6BAA6B;AAC7B,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,eAAe,GAC9B,MAAM,GAAG,IAAI,CAMf"}

package/lib/built/management-command-guard.js

@@ -0,0 +1,21 @@
+/**
+ * IM 运维 / Endpoint 管理斜杠命令：仅 master 或 trusted 可执行。
+ */
+import { mergeAITriggerConfig, resolveSenderRoles, } from './ai-trigger.js';
+import { hasSenderRole } from './roles.js';
+export const MANAGEMENT_COMMAND_DENIED = '⚠️ 该命令仅 Endpoint Owner（master）或 trusted 操作员可用。';
+export function resolveManagementCommandRoles(message, root, triggerConfig) {
+    const cfg = mergeAITriggerConfig(triggerConfig ?? {});
+    const adapterInstance = root.inject(message.$adapter);
+    const endpointConfig = adapterInstance?.endpoints?.get(message.$endpoint)?.$config;
+    return resolveSenderRoles(message, cfg, endpointConfig).roles;
+}
+/** 通过返回 null；拒绝返回用户可见提示文案 */
+export function rejectUnlessManagementOperator(message, root, triggerConfig) {
+    const roles = resolveManagementCommandRoles(message, root, triggerConfig);
+    if (hasSenderRole(roles, 'trusted')) {
+        return null;
+    }
+    return MANAGEMENT_COMMAND_DENIED;
+}
+//# sourceMappingURL=management-command-guard.js.map

package/lib/built/management-command-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-command-guard.js","sourceRoot":"","sources":["../../src/built/management-command-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GAEnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3C,MAAM,CAAC,MAAM,yBAAyB,GACpC,gDAAgD,CAAC;AAEnD,MAAM,UAAU,6BAA6B,CAC3C,OAAgB,EAChB,IAAY,EACZ,aAA+B;IAE/B,MAAM,GAAG,GAAG,oBAAoB,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAEvC,CAAC;IACd,MAAM,cAAc,GAAG,eAAe,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IACnF,OAAO,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC;AAChE,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,8BAA8B,CAC5C,OAAgB,EAChB,IAAY,EACZ,aAA+B;IAE/B,MAAM,KAAK,GAAG,6BAA6B,CAAC,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;IAC1E,IAAI,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,yBAAyB,CAAC;AACnC,CAAC"}

package/lib/built/outbound-media-contract.d.ts

@@ -0,0 +1,23 @@
+import type { SendContent } from '../types.js';
+/**
+ * 出站两阶段契约（Adapter 实现参考）：
+ *
+ * 1. **resolveRichSegments**（Adapter.renderSendMessage 首步）
+ *    语义段（html / tts / qrcode / markdown）→ 标准 IM 段（image / audio / text）
+ *
+ * 2. **materializeOutboundMedia**（Endpoint.$sendMessage 前，各 adapter 可选）
+ *    标准段中的 base64 / 本地路径 → 平台 URL 或上传后的引用
+ */
+export interface OutboundMediaUploadContext {
+    /** 上传二进制，返回平台可发送的 URL */
+    uploadBuffer?(buffer: Buffer, mimeHint?: string): Promise<string>;
+    /** 上传本地文件路径 */
+    uploadFile?(filePath: string): Promise<string>;
+    outboundDir?: string;
+}
+export type OutboundMediaMaterializer = (content: SendContent, ctx: OutboundMediaUploadContext) => Promise<SendContent>;
+/** 契约测试：adapter 须声明 outboundRichSegmentPolicy */
+export declare function assertAdapterDeclaresRichSegmentPolicy(adapterClass: {
+    outboundRichSegmentPolicy?: Record<string, string>;
+}): void;
+//# sourceMappingURL=outbound-media-contract.d.ts.map

package/lib/built/outbound-media-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-media-contract.d.ts","sourceRoot":"","sources":["../../src/built/outbound-media-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;GAQG;AAEH,MAAM,WAAW,0BAA0B;IACzC,yBAAyB;IACzB,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,eAAe;IACf,UAAU,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,0BAA0B,KAC5B,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1B,iDAAiD;AACjD,wBAAgB,sCAAsC,CACpD,YAAY,EAAE;IAAE,yBAAyB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACnE,IAAI,CAQN"}

package/lib/built/outbound-media-contract.js

@@ -0,0 +1,11 @@
+/** 契约测试：adapter 须声明 outboundRichSegmentPolicy */
+export function assertAdapterDeclaresRichSegmentPolicy(adapterClass) {
+    if (!adapterClass.outboundRichSegmentPolicy) {
+        throw new Error('Adapter must declare static outboundRichSegmentPolicy');
+    }
+    const policy = adapterClass.outboundRichSegmentPolicy;
+    if (typeof policy !== 'object' || Object.keys(policy).length === 0) {
+        throw new Error('outboundRichSegmentPolicy must be a non-empty object');
+    }
+}
+//# sourceMappingURL=outbound-media-contract.js.map

package/lib/built/outbound-media-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-media-contract.js","sourceRoot":"","sources":["../../src/built/outbound-media-contract.ts"],"names":[],"mappings":"AAyBA,iDAAiD;AACjD,MAAM,UAAU,sCAAsC,CACpD,YAAoE;IAEpE,IAAI,CAAC,YAAY,CAAC,yBAAyB,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,yBAAyB,CAAC;IACtD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/lib/built/outbound-media-utils.d.ts

@@ -0,0 +1,10 @@
+import type { MessageElement, SendContent } from '../types.js';
+export declare function isRemoteUrl(value: string): boolean;
+/** 从 message 段 data 提取 base64 Buffer（data: URL / base64:// / raw base64） */
+export declare function extractBase64Buffer(data: Record<string, unknown>): Buffer | undefined;
+/** 解析本地文件路径（非 http(s) / base64） */
+export declare function resolveLocalMediaPath(data: Record<string, unknown>): string | undefined;
+export declare function asMessageElements(content: SendContent): MessageElement[];
+export declare function isMediaSegmentType(type: string): boolean;
+export declare function collectOutboundMediaKinds(content: SendContent | undefined): string[];
+//# sourceMappingURL=outbound-media-utils.d.ts.map

package/lib/built/outbound-media-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-media-utils.d.ts","sourceRoot":"","sources":["../../src/built/outbound-media-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAmBrF;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAUvF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CAUxE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,EAAE,CAUpF"}