@zhin.js/core 1.3.1 → 1.3.2

package/lib/built/rich-segments/markdown-to-text.d.ts

@@ -0,0 +1,4 @@
+/** 将 Markdown 转为可读纯文本（出站 text 降级用） */
+export declare function markdownToPlainText(md: string): string;
+export declare function markdownToHtmlForRender(md: string): string;
+//# sourceMappingURL=markdown-to-text.d.ts.map

package/lib/built/rich-segments/markdown-to-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-to-text.d.ts","sourceRoot":"","sources":["../../../src/built/rich-segments/markdown-to-text.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAkBtD;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAM1D"}

package/lib/built/rich-segments/markdown-to-text.js

@@ -0,0 +1,28 @@
+/** 将 Markdown 转为可读纯文本（出站 text 降级用） */
+export function markdownToPlainText(md) {
+    let text = md;
+    text = text.replace(/```[\s\S]*?```/g, (block) => {
+        const inner = block.replace(/^```[^\n]*\n?/, '').replace(/\n?```$/, '');
+        return inner.trim() ? `${inner.trim()}\n` : '';
+    });
+    text = text.replace(/`([^`]+)`/g, '$1');
+    text = text.replace(/!\[[^\]]*\]\([^)]*\)/g, '');
+    text = text.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1');
+    text = text.replace(/^#{1,6}\s+/gm, '');
+    text = text.replace(/^\s*>\s?/gm, '');
+    text = text.replace(/^\s*[-*+]\s+/gm, '');
+    text = text.replace(/\*\*([^*]+)\*\*/g, '$1');
+    text = text.replace(/__([^_]+)__/g, '$1');
+    text = text.replace(/\*([^*]+)\*/g, '$1');
+    text = text.replace(/_([^_]+)_/g, '$1');
+    text = text.replace(/~~([^~]+)~~/g, '$1');
+    return text.trim();
+}
+export function markdownToHtmlForRender(md) {
+    const escaped = md
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+    return `<pre style="white-space:pre-wrap;font-family:sans-serif;font-size:14px;line-height:1.5;padding:16px;">${escaped}</pre>`;
+}
+//# sourceMappingURL=markdown-to-text.js.map

package/lib/built/rich-segments/markdown-to-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-to-text.js","sourceRoot":"","sources":["../../../src/built/rich-segments/markdown-to-text.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAC5C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACxE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IACH,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IACpD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACtC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,EAAU;IAChD,MAAM,OAAO,GAAG,EAAE;SACf,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzB,OAAO,yGAAyG,OAAO,QAAQ,CAAC;AAClI,CAAC"}

package/lib/built/rich-segments/qrcode-segment.d.ts

@@ -0,0 +1,19 @@
+import type { MessageElement } from '../../types.js';
+import { type GenerateQrCodeOptions } from '../generated-qrcode.js';
+import { RichSegment } from './base.js';
+import type { RichSegmentRenderContext, RichSegmentRenderResult } from './types.js';
+export interface QrcodeSegmentData extends GenerateQrCodeOptions {
+    text: string;
+    /** process origin 模式终端渲染时使用 */
+    small?: boolean;
+}
+export declare function readQrcodeSegmentData(data: Record<string, unknown>): QrcodeSegmentData;
+export declare class QrcodeSegment extends RichSegment<QrcodeSegmentData> {
+    readonly segmentType: "qrcode";
+    readonly type: "qrcode";
+    render(mode: string, _ctx?: RichSegmentRenderContext): Promise<RichSegmentRenderResult>;
+}
+export declare function wrapQrcodeSegment(data: Record<string, unknown>): QrcodeSegment;
+/** process endpoint：origin qrcode 段 → 终端 ASCII + 文本占位 */
+export declare function interpretOriginQrcodeForProcess(content: MessageElement | string | (MessageElement | string)[]): Promise<MessageElement | string | (MessageElement | string)[]>;
+//# sourceMappingURL=qrcode-segment.d.ts.map

package/lib/built/rich-segments/qrcode-segment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrcode-segment.d.ts","sourceRoot":"","sources":["../../../src/built/rich-segments/qrcode-segment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGpF,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAkBtF;AAED,qBAAa,aAAc,SAAQ,WAAW,CAAC,iBAAiB,CAAC;IAC/D,QAAQ,CAAC,WAAW,EAAG,QAAQ,CAAU;IACzC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,wBAAwB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;CAmBpC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAE9E;AAED,yDAAyD;AACzD,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC,EAAE,GAC7D,OAAO,CAAC,cAAc,GAAG,MAAM,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC,EAAE,CAAC,CA0BhE"}

package/lib/built/rich-segments/qrcode-segment.js

@@ -0,0 +1,74 @@
+import { segment } from '../../utils.js';
+import { GeneratedQrCode } from '../generated-qrcode.js';
+import { RichSegment } from './base.js';
+import { RICH_SEGMENT_MODE } from './types.js';
+export function readQrcodeSegmentData(data) {
+    const text = typeof data.text === 'string' ? data.text : '';
+    if (!text) {
+        throw new Error('qrcode segment: missing data.text');
+    }
+    return {
+        text,
+        width: typeof data.width === 'number' ? data.width : undefined,
+        margin: typeof data.margin === 'number' ? data.margin : undefined,
+        errorCorrectionLevel: data.errorCorrectionLevel === 'L'
+            || data.errorCorrectionLevel === 'M'
+            || data.errorCorrectionLevel === 'Q'
+            || data.errorCorrectionLevel === 'H'
+            ? data.errorCorrectionLevel
+            : undefined,
+        small: data.small === true ? true : undefined,
+    };
+}
+export class QrcodeSegment extends RichSegment {
+    segmentType = 'qrcode';
+    type = 'qrcode';
+    async render(mode, _ctx) {
+        if (mode === RICH_SEGMENT_MODE.ORIGIN) {
+            return this.toJSON();
+        }
+        if (mode === RICH_SEGMENT_MODE.TEXT) {
+            return segment.text(`[二维码] ${this.data.text}`);
+        }
+        if (mode === RICH_SEGMENT_MODE.IMAGE) {
+            const qr = await GeneratedQrCode.generate(this.data.text, this.data);
+            return segment('image', {
+                url: qr.toDataUrl(),
+                base64: qr.toString('base64'),
+            });
+        }
+        return this.render(RICH_SEGMENT_MODE.TEXT, _ctx);
+    }
+}
+export function wrapQrcodeSegment(data) {
+    return new QrcodeSegment(readQrcodeSegmentData(data));
+}
+/** process endpoint：origin qrcode 段 → 终端 ASCII + 文本占位 */
+export async function interpretOriginQrcodeForProcess(content) {
+    const items = Array.isArray(content) ? content : [content];
+    const out = [];
+    let changed = false;
+    for (const item of items) {
+        if (typeof item === 'string') {
+            out.push(item);
+            continue;
+        }
+        if (item.type !== 'qrcode') {
+            out.push(item);
+            continue;
+        }
+        changed = true;
+        const payload = readQrcodeSegmentData(item.data ?? {});
+        const qr = await GeneratedQrCode.generate(payload.text, payload);
+        await qr.printToTerminal({ small: payload.small ?? true });
+        out.push(segment.text(`[二维码] ${payload.text}`));
+    }
+    if (!changed)
+        return content;
+    if (out.length === 0)
+        return segment.text('');
+    if (out.length === 1)
+        return out[0];
+    return out;
+}
+//# sourceMappingURL=qrcode-segment.js.map

package/lib/built/rich-segments/qrcode-segment.js.map

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

package/lib/built/rich-segments/registry.d.ts

@@ -0,0 +1,17 @@
+import type { OutboundRichSegmentPolicy, RichSegmentKindDefinition } from './types.js';
+export declare class RichSegmentRegistry {
+    #private;
+    register(definition: RichSegmentKindDefinition): void;
+    has(kind: string): boolean;
+    get(kind: string): RichSegmentKindDefinition | undefined;
+    list(): RichSegmentKindDefinition[];
+    buildDefaultPolicy(): OutboundRichSegmentPolicy;
+    resolveMode(policy: OutboundRichSegmentPolicy, kind: string): string;
+    wrap(kind: string, data: Record<string, unknown>): import("./types.js").RichSegmentLike;
+    /** 测试隔离：清空后需重新 register builtins */
+    clearForTests(): void;
+}
+export declare const RICH_SEGMENT_FALLBACK_MODE = "origin";
+export declare const richSegmentRegistry: RichSegmentRegistry;
+export declare function registerRichSegmentKind(definition: RichSegmentKindDefinition): void;
+//# sourceMappingURL=registry.d.ts.map

package/lib/built/rich-segments/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/built/rich-segments/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,qBAAa,mBAAmB;;IAG9B,QAAQ,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI;IAYrD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS;IAIxD,IAAI,IAAI,yBAAyB,EAAE;IAInC,kBAAkB,IAAI,yBAAyB;IAQ/C,WAAW,CAAC,MAAM,EAAE,yBAAyB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IASpE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQhD,oCAAoC;IACpC,aAAa,IAAI,IAAI;CAGtB;AAED,eAAO,MAAM,0BAA0B,WAAW,CAAC;AAEnD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAE7D,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,CAEnF"}

package/lib/built/rich-segments/registry.js

@@ -0,0 +1,53 @@
+export class RichSegmentRegistry {
+    #kinds = new Map();
+    register(definition) {
+        if (this.#kinds.has(definition.kind)) {
+            throw new Error(`Rich segment kind already registered: ${definition.kind}`);
+        }
+        if (!definition.modes.includes(definition.defaultMode)) {
+            throw new Error(`Rich segment ${definition.kind}: defaultMode "${definition.defaultMode}" not in modes`);
+        }
+        this.#kinds.set(definition.kind, definition);
+    }
+    has(kind) {
+        return this.#kinds.has(kind);
+    }
+    get(kind) {
+        return this.#kinds.get(kind);
+    }
+    list() {
+        return [...this.#kinds.values()];
+    }
+    buildDefaultPolicy() {
+        const policy = {};
+        for (const def of this.#kinds.values()) {
+            policy[def.kind] = def.defaultMode;
+        }
+        return policy;
+    }
+    resolveMode(policy, kind) {
+        const def = this.#kinds.get(kind);
+        const requested = policy[kind] ?? def?.defaultMode ?? RICH_SEGMENT_FALLBACK_MODE;
+        if (def && !def.modes.includes(requested)) {
+            return def.defaultMode;
+        }
+        return requested;
+    }
+    wrap(kind, data) {
+        const def = this.#kinds.get(kind);
+        if (!def) {
+            throw new Error(`Unknown rich segment kind: ${kind}`);
+        }
+        return def.wrap(data);
+    }
+    /** 测试隔离：清空后需重新 register builtins */
+    clearForTests() {
+        this.#kinds.clear();
+    }
+}
+export const RICH_SEGMENT_FALLBACK_MODE = 'origin';
+export const richSegmentRegistry = new RichSegmentRegistry();
+export function registerRichSegmentKind(definition) {
+    richSegmentRegistry.register(definition);
+}
+//# sourceMappingURL=registry.js.map

package/lib/built/rich-segments/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/built/rich-segments/registry.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,mBAAmB;IACrB,MAAM,GAAG,IAAI,GAAG,EAAqC,CAAC;IAE/D,QAAQ,CAAC,UAAqC;QAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,yCAAyC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CACb,gBAAgB,UAAU,CAAC,IAAI,kBAAkB,UAAU,CAAC,WAAW,gBAAgB,CACxF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,kBAAkB;QAChB,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,MAAiC,EAAE,IAAY;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,WAAW,IAAI,0BAA0B,CAAC;QACjF,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,OAAO,GAAG,CAAC,WAAW,CAAC;QACzB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,IAA6B;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,oCAAoC;IACpC,aAAa;QACX,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC;AAEnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAE7D,MAAM,UAAU,uBAAuB,CAAC,UAAqC;IAC3E,mBAAmB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC"}

package/lib/built/rich-segments/resolve.d.ts

@@ -0,0 +1,6 @@
+import type { SendContent } from '../../types.js';
+import type { OutboundRichSegmentPolicy, RichSegmentRenderContext } from './types.js';
+export declare function hasRichSegment(content: SendContent | undefined): boolean;
+/** 按 Adapter 出站策略在 renderSendMessage 首步统一渲染富媒体段 */
+export declare function resolveRichSegments(content: SendContent, policy: OutboundRichSegmentPolicy, ctx?: RichSegmentRenderContext): Promise<SendContent>;
+//# sourceMappingURL=resolve.d.ts.map

package/lib/built/rich-segments/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/built/rich-segments/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,KAAK,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AA8CtF,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAMxE;AAED,mDAAmD;AACnD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,yBAAyB,EACjC,GAAG,CAAC,EAAE,wBAAwB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAsCtB"}

package/lib/built/rich-segments/resolve.js

@@ -0,0 +1,88 @@
+import { isRichSegment, richSegmentKind } from './base.js';
+import { richSegmentRegistry } from './registry.js';
+import { RICH_SEGMENT_MODE } from './types.js';
+import { CONTENT_CHAIN_STAGE } from '@zhin.js/logger';
+function asArray(content) {
+    return Array.isArray(content) ? content : [content];
+}
+function packSegments(out) {
+    if (out.length === 0)
+        return { type: 'text', data: { text: '' } };
+    if (out.length === 1)
+        return out[0];
+    return out;
+}
+function appendRendered(out, rendered) {
+    if (Array.isArray(rendered)) {
+        out.push(...rendered);
+        return;
+    }
+    out.push(rendered);
+}
+function primarySegmentType(rendered) {
+    if (typeof rendered === 'string')
+        return 'text';
+    if (Array.isArray(rendered)) {
+        const first = rendered[0];
+        if (typeof first === 'string')
+            return 'text';
+        const t = first?.type;
+        return typeof t === 'string' ? t : 'unknown';
+    }
+    const t = rendered.type;
+    return typeof t === 'string' ? t : 'unknown';
+}
+function detectRichSegmentFallback(mode, renderedType) {
+    if (mode === RICH_SEGMENT_MODE.IMAGE && renderedType !== 'image')
+        return true;
+    if (mode === RICH_SEGMENT_MODE.AUDIO && renderedType !== 'audio')
+        return true;
+    if (mode === RICH_SEGMENT_MODE.FILE && renderedType !== 'file')
+        return true;
+    return false;
+}
+export function hasRichSegment(content) {
+    if (content == null)
+        return false;
+    return asArray(content).some((item) => {
+        if (typeof item === 'string')
+            return false;
+        return richSegmentKind(item) != null || isRichSegment(item);
+    });
+}
+/** 按 Adapter 出站策略在 renderSendMessage 首步统一渲染富媒体段 */
+export async function resolveRichSegments(content, policy, ctx) {
+    if (!hasRichSegment(content)) {
+        return content;
+    }
+    const items = asArray(content);
+    const out = [];
+    for (const item of items) {
+        if (typeof item === 'string') {
+            out.push(item);
+            continue;
+        }
+        const kind = isRichSegment(item) ? item.segmentType : richSegmentKind(item);
+        if (!kind || !richSegmentRegistry.has(kind)) {
+            out.push(item);
+            continue;
+        }
+        const rich = isRichSegment(item)
+            ? item
+            : richSegmentRegistry.wrap(kind, item.data ?? {});
+        const mode = richSegmentRegistry.resolveMode(policy, kind);
+        const rendered = await rich.render(mode, ctx);
+        const renderedType = primarySegmentType(rendered);
+        const fallback = detectRichSegmentFallback(mode, renderedType);
+        ctx?.logContentChain?.({
+            stage: CONTENT_CHAIN_STAGE.RICH_SEGMENT,
+            kind,
+            mode,
+            fallback,
+            result: renderedType,
+        });
+        appendRendered(out, rendered);
+    }
+    return packSegments(out);
+}
+//# sourceMappingURL=resolve.js.map

package/lib/built/rich-segments/resolve.js.map

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

package/lib/built/rich-segments/tts-segment.d.ts

@@ -0,0 +1,14 @@
+import { RichSegment } from './base.js';
+import type { RichSegmentRenderContext, RichSegmentRenderResult } from './types.js';
+export interface TtsSegmentData {
+    text: string;
+    voice?: string;
+    provider?: string;
+}
+export declare class TtsSegment extends RichSegment<TtsSegmentData> {
+    readonly segmentType: "tts";
+    readonly type: "tts";
+    render(mode: string, ctx?: RichSegmentRenderContext): Promise<RichSegmentRenderResult>;
+}
+export declare function wrapTtsSegment(data: Record<string, unknown>): TtsSegment;
+//# sourceMappingURL=tts-segment.d.ts.map

package/lib/built/rich-segments/tts-segment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-segment.d.ts","sourceRoot":"","sources":["../../../src/built/rich-segments/tts-segment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EAExB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,qBAAa,UAAW,SAAQ,WAAW,CAAC,cAAc,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAG,KAAK,CAAU;IACtC,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAEzB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAqC7F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAMxE"}

package/lib/built/rich-segments/tts-segment.js

@@ -0,0 +1,52 @@
+import { segment } from '../../utils.js';
+import { RichSegment } from './base.js';
+import { RICH_SEGMENT_MODE } from './types.js';
+async function resolveSpeechPipeline(ctx) {
+    if (!ctx?.resolveCapability)
+        return undefined;
+    return ctx.resolveCapability('speech');
+}
+export class TtsSegment extends RichSegment {
+    segmentType = 'tts';
+    type = 'tts';
+    async render(mode, ctx) {
+        if (mode === RICH_SEGMENT_MODE.ORIGIN) {
+            return this.toJSON();
+        }
+        const text = typeof this.data.text === 'string' ? this.data.text : '';
+        if (mode === RICH_SEGMENT_MODE.TEXT) {
+            return segment.text(text);
+        }
+        if (mode === RICH_SEGMENT_MODE.AUDIO) {
+            if (!text.trim()) {
+                return segment.text('');
+            }
+            const pipeline = await resolveSpeechPipeline(ctx);
+            if (!pipeline) {
+                return this.render(RICH_SEGMENT_MODE.TEXT, ctx);
+            }
+            try {
+                const result = await pipeline.synthesize({
+                    text,
+                    voice: typeof this.data.voice === 'string' ? this.data.voice : undefined,
+                    provider: typeof this.data.provider === 'string' ? this.data.provider : undefined,
+                });
+                const base64 = result.data.toString('base64');
+                const mime = result.format === 'wav' ? 'audio/wav' : 'audio/mpeg';
+                return segment('audio', { url: `data:${mime};base64,${base64}`, format: result.format });
+            }
+            catch {
+                return this.render(RICH_SEGMENT_MODE.TEXT, ctx);
+            }
+        }
+        return this.render(RICH_SEGMENT_MODE.TEXT, ctx);
+    }
+}
+export function wrapTtsSegment(data) {
+    return new TtsSegment({
+        text: String(data.text ?? ''),
+        voice: typeof data.voice === 'string' ? data.voice : undefined,
+        provider: typeof data.provider === 'string' ? data.provider : undefined,
+    });
+}
+//# sourceMappingURL=tts-segment.js.map

package/lib/built/rich-segments/tts-segment.js.map

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

package/lib/built/rich-segments/types.d.ts

@@ -0,0 +1,85 @@
+import type { MessageElement } from '../../types.js';
+import type { ContentChainLogFields } from '@zhin.js/logger';
+/** 内置 kind 常量（外部可增删，registry 为 SSOT） */
+export declare const BUILTIN_RICH_SEGMENT_KINDS: {
+    readonly QRCODE: "qrcode";
+    readonly HTML: "html";
+    readonly MARKDOWN: "markdown";
+    readonly TTS: "tts";
+};
+export type BuiltinRichSegmentKind = (typeof BUILTIN_RICH_SEGMENT_KINDS)[keyof typeof BUILTIN_RICH_SEGMENT_KINDS];
+/** 通用 mode 名；各 kind 在 registry 中声明支持的子集 */
+export declare const RICH_SEGMENT_MODE: {
+    readonly ORIGIN: "origin";
+    readonly TEXT: "text";
+    readonly IMAGE: "image";
+    readonly FILE: "file";
+    readonly URL: "url";
+    readonly AUDIO: "audio";
+    readonly VIDEO: "video";
+};
+export type RichSegmentMode = (typeof RICH_SEGMENT_MODE)[keyof typeof RICH_SEGMENT_MODE] | string;
+/** 任意已注册 kind → 渲染 mode */
+export type OutboundRichSegmentPolicy = Record<string, string>;
+/** @deprecated 使用 OutboundRichSegmentPolicy；保留别名便于迁移 */
+export type RichSegmentKind = string;
+export type RichRenderMode = string;
+/** html-renderer 可选包契约 */
+export interface HtmlRendererForRichSegment {
+    render(html: string, options?: {
+        width?: number;
+        format?: 'png';
+        backgroundColor?: string;
+    }): Promise<{
+        format: string;
+        data: Buffer | string;
+    }>;
+}
+/** speech 可选包契约（@zhin.js/speech） */
+export interface SpeechPipelineForRichSegment {
+    transcribe(input: {
+        data: Buffer;
+        mimeType?: string;
+    }): Promise<string>;
+    synthesize(input: {
+        text: string;
+        voice?: string;
+        format?: 'mp3' | 'wav';
+        speed?: number;
+        provider?: string;
+    }): Promise<{
+        data: Buffer;
+        format: 'mp3' | 'wav';
+    }>;
+}
+/** 未来 media-pipeline / ffmpeg 等 optional 包可复用同一 id */
+export type RichSegmentCapabilityId = 'html-renderer' | 'speech' | 'media-pipeline' | string;
+export interface RichSegmentRenderContext {
+    /** 按 id 懒加载能力（core 或 optional 包 register loader） */
+    resolveCapability: <T>(id: RichSegmentCapabilityId) => Promise<T | undefined>;
+    /** @deprecated 请用 resolveCapability('html-renderer') */
+    getHtmlRenderer?: () => Promise<HtmlRendererForRichSegment | undefined>;
+    /** 可选：rich_segment stage 结构化日志 */
+    logContentChain?: (fields: ContentChainLogFields) => void;
+    warn?: (message: string) => void;
+}
+export type RichSegmentRenderResult = MessageElement | MessageElement[];
+export interface RichSegmentLike {
+    readonly segmentType: string;
+    render(mode: string, ctx?: RichSegmentRenderContext): Promise<RichSegmentRenderResult>;
+}
+export interface RichSegmentKindDefinition {
+    kind: string;
+    /** policy 未指定时使用的 mode */
+    defaultMode: string;
+    /** 该 kind 支持的 mode 列表（policy 非法值会回退 defaultMode） */
+    modes: readonly string[];
+    wrap: (data: Record<string, unknown>) => RichSegmentLike;
+}
+export interface RichSegmentCapabilityLoaderOptions {
+    warn?: (message: string) => void;
+    getConfig?: () => Record<string, unknown> | undefined;
+    logContentChain?: RichSegmentRenderContext['logContentChain'];
+}
+export type RichSegmentCapabilityLoader = (options: RichSegmentCapabilityLoaderOptions) => Promise<unknown>;
+//# sourceMappingURL=types.d.ts.map

package/lib/built/rich-segments/types.d.ts.map

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

package/lib/built/rich-segments/types.js

@@ -0,0 +1,18 @@
+/** 内置 kind 常量（外部可增删，registry 为 SSOT） */
+export const BUILTIN_RICH_SEGMENT_KINDS = {
+    QRCODE: 'qrcode',
+    HTML: 'html',
+    MARKDOWN: 'markdown',
+    TTS: 'tts',
+};
+/** 通用 mode 名；各 kind 在 registry 中声明支持的子集 */
+export const RICH_SEGMENT_MODE = {
+    ORIGIN: 'origin',
+    TEXT: 'text',
+    IMAGE: 'image',
+    FILE: 'file',
+    URL: 'url',
+    AUDIO: 'audio',
+    VIDEO: 'video',
+};
+//# sourceMappingURL=types.js.map

package/lib/built/rich-segments/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/built/rich-segments/types.ts"],"names":[],"mappings":"AAGA,wCAAwC;AACxC,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,GAAG,EAAE,KAAK;CACF,CAAC;AAKX,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;CACN,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { Schema } from '@zhin.js/schema';
+import { Adapter } from '../adapter.js';
+import type { EndpointConfigRecord, EndpointManager, ProvisionContext } from './endpoint-manager.js';
+export declare class SchemaEndpointManager implements EndpointManager {
+    private readonly adapter;
+    private readonly schema;
+    constructor(adapter: Adapter, schema: 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>;
+}
+export declare function resolveEndpointManager(adapter: Adapter): EndpointManager | null;
+export declare function adapterSupportsProvision(adapter: Adapter): boolean;
+//# sourceMappingURL=schema-endpoint-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-endpoint-manager.d.ts","sourceRoot":"","sources":["../../src/built/schema-endpoint-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAU/B,qBAAa,qBAAsB,YAAW,eAAe;IAEzD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM;IAGjC,iBAAiB,IAAI,OAAO;IAI5B,aAAa,IAAI,oBAAoB,EAAE;IAIjC,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAYjE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAgBhF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGnD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAW/E;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGlE"}

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

@@ -0,0 +1,74 @@
+import { Prompt } from '../prompt.js';
+function readConfigEndpoints(root, context) {
+    const configService = root.inject('config');
+    const raw = configService?.getRaw(configService.primaryFile);
+    return (raw?.endpoints ?? []).filter((e) => e.context === context);
+}
+export class SchemaEndpointManager {
+    adapter;
+    schema;
+    constructor(adapter, schema) {
+        this.adapter = adapter;
+        this.schema = schema;
+    }
+    supportsProvision() {
+        return true;
+    }
+    listEndpoints() {
+        return readConfigEndpoints(this.adapter.plugin.root, String(this.adapter.name));
+    }
+    async addEndpoint(ctx) {
+        const prompt = new Prompt(this.adapter.plugin, ctx.message);
+        await ctx.onStatusUpdate(`请按提示填写 ${String(this.adapter.name)} endpoint 配置：`);
+        const name = await prompt.text('Endpoint 名称（zhin.config endpoints[].name）：');
+        const fields = await prompt.getValueWithSchema(this.schema);
+        return {
+            context: String(this.adapter.name),
+            name: name.trim(),
+            ...fields,
+        };
+    }
+    async editEndpoint(name, ctx) {
+        const existing = this.listEndpoints().find((e) => e.name === name);
+        if (!existing) {
+            throw new Error(`配置中不存在 ${String(this.adapter.name)}/${name}`);
+        }
+        await ctx.onStatusUpdate(`编辑 ${String(this.adapter.name)}/${name}，留空字段将保留原值。`);
+        const prompt = new Prompt(this.adapter.plugin, ctx.message);
+        const fields = await prompt.getValueWithSchema(this.schema);
+        return {
+            ...existing,
+            ...fields,
+            context: String(this.adapter.name),
+            name,
+        };
+    }
+    async removeEndpoint(name) {
+        return this.listEndpoints().some((e) => e.name === name);
+    }
+    async startEndpoint(name, ctx) {
+        const rec = this.listEndpoints().find((e) => e.name === name);
+        if (!rec)
+            throw new Error(`配置中不存在 ${String(this.adapter.name)}/${name}`);
+        await ctx.onStatusUpdate(`正在连接 ${String(this.adapter.name)}/${name}…`);
+    }
+    async stopEndpoint(name) {
+        return this.adapter.endpoints.has(name);
+    }
+}
+export function resolveEndpointManager(adapter) {
+    const custom = adapter.getEndpointManager?.();
+    if (custom)
+        return custom;
+    const schema = adapter.getEndpointConfigSchema?.() ??
+        adapter.constructor.endpointConfigSchema;
+    if (schema) {
+        return new SchemaEndpointManager(adapter, schema);
+    }
+    return null;
+}
+export function adapterSupportsProvision(adapter) {
+    const manager = resolveEndpointManager(adapter);
+    return manager?.supportsProvision() ?? false;
+}
+//# sourceMappingURL=schema-endpoint-manager.js.map