@krischoichoi/channel-weixin 0.6.0

package/lib/messaging/dedup.js

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+const dedupRecordsSchema = z.array(z.object({
+    key: z.string(),
+    committedAt: z.number().finite(),
+}));
+/**
+ * Stable hash (FNV-1a-ish) used as the final fallback for a missing
+ * message_id/seq. Never the primary identity.
+ */
+export function stableHash(input) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < input.length; i += 1) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(36);
+}
+/** Compute a dedup identity for a raw iLink message. */
+export function dedupKey(raw) {
+    const msg = raw;
+    if (msg?.message_id !== undefined && msg.message_id !== null) {
+        return 'mid:' + String(msg.message_id);
+    }
+    if (msg?.seq !== undefined && msg.seq !== null) {
+        return 'seq:' + String(msg.seq);
+    }
+    // Final fallback — stable hash of the JSON shape.
+    return 'hash:' + stableHash(JSON.stringify(msg ?? {}));
+}
+/** Default cap on persistent dedup records (R1 recommends 1000..5000). */
+const MAX_RECORDS = 5000;
+/** In-memory two-phase dedup (tests / no persistence). */
+export class MemoryDedupStore {
+    seen = new Map();
+    windowMs;
+    now;
+    constructor(options) {
+        this.windowMs = options.windowMs;
+        this.now = options.now ?? Date.now;
+    }
+    async has(key) {
+        this.prune(this.now());
+        const last = this.seen.get(key);
+        return last !== undefined && this.now() - last < this.windowMs;
+    }
+    async commit(key) {
+        const now = this.now();
+        this.prune(now);
+        this.seen.set(key, now);
+    }
+    prune(now) {
+        for (const [key, ts] of this.seen) {
+            if (now - ts >= this.windowMs)
+                this.seen.delete(key);
+        }
+    }
+}
+/**
+ * Durable two-phase dedup store. Committed records survive a restart so a
+ * cursor crash-replay window never re-triggers the Agent. State is a JSON
+ * array of DedupRecord under weixin:dedup:<accountId>, loaded lazily and
+ * rewritten (pruned + capped) on each commit.
+ */
+export class PersistentDedupStore {
+    storage;
+    key;
+    windowMs;
+    now;
+    maxRecords;
+    records;
+    constructor(options) {
+        this.storage = options.storage;
+        this.key = 'weixin:dedup:' + (options.accountId ?? 'main');
+        this.windowMs = options.windowMs;
+        this.now = options.now ?? Date.now;
+        this.maxRecords = options.maxRecords ?? MAX_RECORDS;
+    }
+    async load() {
+        if (this.records)
+            return this.records;
+        const map = new Map();
+        const raw = await this.storage.get(this.key);
+        if (raw) {
+            try {
+                const parsedJson = JSON.parse(raw);
+                const parsed = dedupRecordsSchema.safeParse(parsedJson);
+                if (parsed.success) {
+                    for (const rec of parsed.data)
+                        map.set(rec.key, rec.committedAt);
+                }
+            }
+            catch {
+                // Corrupt dedup window -> start fresh (worst case: a replay re-emits,
+                // which is safer than dropping messages forever).
+            }
+        }
+        this.records = map;
+        return map;
+    }
+    async persist() {
+        const records = this.records ?? new Map();
+        const now = this.now();
+        const kept = [];
+        for (const [key, ts] of records) {
+            if (now - ts >= this.windowMs)
+                continue;
+            kept.push({ key, committedAt: ts });
+        }
+        kept.sort((a, b) => b.committedAt - a.committedAt);
+        const capped = kept.slice(0, this.maxRecords);
+        await this.storage.set(this.key, JSON.stringify(capped));
+        this.records = new Map(capped.map((r) => [r.key, r.committedAt]));
+    }
+    async has(key) {
+        const map = await this.load();
+        const last = map.get(key);
+        if (last === undefined)
+            return false;
+        return this.now() - last < this.windowMs;
+    }
+    async commit(key) {
+        const map = await this.load();
+        map.set(key, this.now());
+        await this.persist();
+    }
+}
+//# sourceMappingURL=dedup.js.map

package/lib/messaging/dedup.js.map

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

package/lib/messaging/mapper.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Classification: A — DSH pure mapping [keep].
+ *
+ * Pure iLink-message → Channel MessagePart mapping, no I/O, no platform
+ * algorithm. The official package's inbound mapper (messaging/inbound.js) is a
+ * different model surface (OpenClaw messages); DSH keeps its own neutral
+ * mapper for the Channel contract. Keep.
+ */
+/**
+ * Pure inbound mapper — an iLink {@link ILinkMessage} -> Channel
+ * {@link MessageReceived}. No I/O.
+ *
+ * Mapping rules (doc §21-22):
+ * - `message_id` -> `message.id` (fallback stable hash only when omitted).
+ * - `from_user_id` -> `sender.id` AND `conversation.id` (DM).
+ * - `create_time_ms` -> `createdAt`.
+ * - `item_list` -> `MessagePart[]` (TEXT -> text part; IMAGE/VOICE/FILE/VIDEO ->
+ *   media part when CDN fields are present, else unsupported placeholder).
+ */
+import type { MessagePart, MessageReceived } from '@krischoichoi/channel-core';
+import type { ILinkMessage, ILinkMessageItem, WeixinInboundMeta } from '../ilink/types.js';
+/** Map one item to a Channel MessagePart. */
+export declare function mapItem(item: ILinkMessageItem): MessagePart;
+/** Map one raw iLink message into a stable channel event. */
+export declare function mapInbound(raw: ILinkMessage, meta: WeixinInboundMeta): MessageReceived;
+//# sourceMappingURL=mapper.d.ts.map

package/lib/messaging/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/messaging/mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAEV,WAAW,EACX,eAAe,EAGhB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA0B3F,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CA4C3D;AAYD,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,GAAG,eAAe,CA6BtF"}

package/lib/messaging/mapper.js

@@ -0,0 +1,107 @@
+import { stableHash } from './dedup.js';
+import { formatQuotedContext } from './quote.js';
+/** Human label for common item types. */
+function itemTypeName(type) {
+    switch (type) {
+        case 1: return 'text';
+        case 2: return 'image';
+        case 3: return 'voice';
+        case 4: return 'file';
+        case 5: return 'video';
+        default: return 'unknown';
+    }
+}
+/** Whether a CDN media reference is present and downloadable. */
+function hasMedia(item) {
+    const media = item.image_item?.media ??
+        item.voice_item?.media ??
+        item.file_item?.media ??
+        item.video_item?.media;
+    return Boolean(media && (media.encrypt_query_param || media.full_url));
+}
+/** Map one item to a Channel MessagePart. */
+export function mapItem(item) {
+    switch (item.type) {
+        case 1: {
+            const text = item.text_item?.text ?? '';
+            if (!text)
+                return { type: 'unsupported', reason: 'empty text item' };
+            return { type: 'text', text };
+        }
+        case 2: {
+            const img = item.image_item;
+            if (img && hasMedia(item)) {
+                return {
+                    type: 'image',
+                    url: img.media?.full_url ?? img.url,
+                    mimeType: 'image/jpeg',
+                    alt: undefined,
+                };
+            }
+            return { type: 'unsupported', reason: 'image without downloadable CDN fields (WX5)' };
+        }
+        case 3: {
+            const voice = item.voice_item;
+            if (voice?.media && (voice.media.full_url || voice.media.encrypt_query_param)) {
+                return { type: 'audio', url: voice.media.full_url, durationMs: voice.playtime };
+            }
+            if (voice?.text)
+                return { type: 'text', text: voice.text };
+            return { type: 'unsupported', reason: 'voice without downloadable CDN fields (WX5)' };
+        }
+        case 4: {
+            const file = item.file_item;
+            if (file?.media && (file.media.full_url || file.media.encrypt_query_param)) {
+                return { type: 'file', url: file.media.full_url, name: file.file_name };
+            }
+            return { type: 'unsupported', reason: 'file without downloadable CDN fields (WX5)' };
+        }
+        case 5: {
+            const video = item.video_item;
+            if (video?.media && (video.media.full_url || video.media.encrypt_query_param)) {
+                return { type: 'video', url: video.media.full_url, durationMs: video.play_length };
+            }
+            return { type: 'unsupported', reason: 'video without downloadable CDN fields (WX5)' };
+        }
+        default:
+            return { type: 'unsupported', reason: `unknown weixin item type '${itemTypeName(item.type)}'` };
+    }
+}
+/** Map a wire item, preserving both quote context and voice transcription. */
+function mapItemParts(item) {
+    const quoted = formatQuotedContext(item.ref_msg);
+    const mapped = mapItem(item);
+    if (item.type === 3 && item.voice_item?.text && mapped.type === 'audio') {
+        return [...quoted, { type: 'text', text: item.voice_item.text }, mapped];
+    }
+    return [...quoted, mapped];
+}
+/** Map one raw iLink message into a stable channel event. */
+export function mapInbound(raw, meta) {
+    const from = (raw.from_user_id ?? 'unknown');
+    const conversationId = from;
+    const items = Array.isArray(raw.item_list) ? raw.item_list : [];
+    const parts = [];
+    for (const item of items) {
+        parts.push(...mapItemParts(item));
+    }
+    if (parts.length === 0)
+        parts.push({ type: 'unsupported', reason: 'empty item_list' });
+    const messageId = raw.message_id !== undefined && raw.message_id !== null
+        ? `wx-${String(raw.message_id)}`
+        : `wx-${stableHash(`${from}:${raw.create_time_ms ?? 0}:${raw.seq ?? ''}`)}`;
+    return {
+        type: 'message.received',
+        channel: meta.channel,
+        accountId: meta.accountId,
+        conversation: { id: conversationId, type: 'dm' },
+        sender: { id: from },
+        message: {
+            id: messageId,
+            content: parts,
+            createdAt: raw.create_time_ms ?? Date.now(),
+        },
+        raw,
+    };
+}
+//# sourceMappingURL=mapper.js.map

package/lib/messaging/mapper.js.map

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

package/lib/messaging/monitor.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Classification: A — DSH glue getUpdates loop [keep].
+ *
+ * DSH's receive loop (cursor + dedup + context-token capture + dispatch). The
+ * official monitor (monitor/monitor.js) is coupled to the OpenClaw channel
+ * lifecycle (PluginRuntime) and is not reusable host-neutrally. This loop is
+ * DSH orchestration, not a duplicated wire protocol. Keep; driven by
+ * upstream/tencent-upstream.ts startMonitor().
+ */
+/**
+ * WeixinMonitor — the getUpdates loop (doc §16-18).
+ *
+ * Flow per round:
+ *   load cursor -> getUpdates(cursor, timeout, signal)
+ *     -> for each msg: dedup.has -> capture context_token -> map
+ *        -> beforeEmit/hydrate -> sanitized log -> emit -> dedup.commit
+ *     -> THEN commit the new cursor
+ *
+ * R1 ordering guarantees:
+ *   - a message becomes a committed dedup entry ONLY after a successful emit,
+ *     so an emit failure replays it next round instead of dropping it forever;
+ *   - the cursor is persisted only after the whole round succeeded, and a
+ *     failed cursor write throws (CursorCommitError) so the loop retries
+ *     instead of diverging the in-memory cursor from the durable one.
+ *
+ * The next long-poll timeout is dynamically updated from the server's
+ * longpolling_timeout_ms. Reconnect uses exponential backoff per the
+ * reconnect config. On AbortSignal it exits cleanly. Notify lifecycle
+ * (notifystart/notifystop) is best-effort.
+ */
+import type { ChannelAdapterContext, MessagePart } from '@krischoichoi/channel-core';
+import type { ILinkClient } from '../ilink/client.js';
+import type { WeixinInboundMeta } from '../ilink/types.js';
+import type { SyncCursorStore } from '../storage/sync-cursor.js';
+import type { ContextTokenStore } from '../storage/context-token.js';
+import { type DedupStore } from './dedup.js';
+import { mapInbound } from './mapper.js';
+import { StaleTokenError } from '../ilink/errors.js';
+export interface MonitorReconnectConfig {
+    enabled: boolean;
+    baseDelayMs: number;
+    maxDelayMs: number;
+}
+/** Raised when the durable cursor write fails; the monitor loop retries. */
+export declare class CursorCommitError extends Error {
+    readonly cursor: string;
+    constructor(cursor: string, options?: ErrorOptions);
+}
+export interface WeixinMonitorOptions {
+    client: ILinkClient;
+    cursor: SyncCursorStore;
+    contextTokens: ContextTokenStore;
+    ctx: ChannelAdapterContext;
+    meta: WeixinInboundMeta;
+    /** Dispatch an inbound message event into the pipeline. Injectable for tests. */
+    emit?: (event: ReturnType<typeof mapInbound>) => Promise<void>;
+    /** Enrich mapped content before the summary is logged and the event emitted. */
+    beforeEmit?: (event: ReturnType<typeof mapInbound>) => Promise<void>;
+    reconnect: MonitorReconnectConfig;
+    /** Initial long-poll timeout. */
+    longPollTimeoutMs: number;
+    /** Dedup window in ms. */
+    dedupWindowMs: number;
+    /** Two-phase dedup store; defaults to a durable PersistentDedupStore. */
+    dedup?: DedupStore;
+    /** Injectable clock (tests). */
+    now?: () => number;
+    /** Called on health/connection transitions. */
+    onConnectionChange?: (state: 'connected' | 'reconnecting' | 'disconnected') => void;
+    /** Terminal credential invalidation; never enters the reconnect loop. */
+    onStaleToken?: (error: StaleTokenError) => void | Promise<void>;
+}
+export declare class WeixinMonitor {
+    private readonly client;
+    private readonly cursor;
+    private readonly contextTokens;
+    private readonly ctx;
+    private readonly meta;
+    private readonly emitMsg;
+    private readonly beforeEmit?;
+    private readonly reconnect;
+    private readonly dedup;
+    private readonly now;
+    private readonly onConnectionChange?;
+    private readonly onStaleToken?;
+    private running;
+    private loop?;
+    private nextLongPollTimeoutMs;
+    constructor(options: WeixinMonitorOptions);
+    /** Start the monitor loop. Best-effort notifystart first. */
+    start(): Promise<void>;
+    /** Abort the loop and best-effort notifystop. */
+    stop(): Promise<void>;
+    /** Wait for the current loop iteration to finish (used by tests/teardown). */
+    join(): Promise<void>;
+    private runLoop;
+    /**
+     * Persist the new cursor. The local cursor is advanced only after the
+     * durable write succeeds; on failure a CursorCommitError is thrown so the
+     * loop retries with the previous cursor instead of silently diverging.
+     */
+    private commitCursor;
+    private handleMessage;
+    /** Current long-poll timeout (dynamic). */
+    get longPollTimeout(): number;
+}
+/** Compact per-part summary for inbound message logs (debug diagnostics). */
+export declare function summarizeInboundParts(parts: readonly MessagePart[]): unknown[];
+//# sourceMappingURL=monitor.d.ts.map

package/lib/messaging/monitor.d.ts.map

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

package/lib/messaging/monitor.js

@@ -0,0 +1,234 @@
+import { PersistentDedupStore, dedupKey } from './dedup.js';
+import { mapInbound } from './mapper.js';
+import { StaleTokenError } from '../ilink/errors.js';
+/** Raised when the durable cursor write fails; the monitor loop retries. */
+export class CursorCommitError extends Error {
+    cursor;
+    constructor(cursor, options) {
+        super('failed to commit sync cursor', options);
+        this.name = 'CursorCommitError';
+        this.cursor = cursor;
+    }
+}
+export class WeixinMonitor {
+    client;
+    cursor;
+    contextTokens;
+    ctx;
+    meta;
+    emitMsg;
+    beforeEmit;
+    reconnect;
+    dedup;
+    now;
+    onConnectionChange;
+    onStaleToken;
+    running = false;
+    loop;
+    nextLongPollTimeoutMs;
+    constructor(options) {
+        this.client = options.client;
+        this.cursor = options.cursor;
+        this.contextTokens = options.contextTokens;
+        this.ctx = options.ctx;
+        this.meta = options.meta;
+        this.emitMsg = options.emit ?? ((event) => this.ctx.emit(event));
+        this.beforeEmit = options.beforeEmit;
+        this.reconnect = options.reconnect;
+        this.dedup = options.dedup ?? new PersistentDedupStore({
+            storage: options.ctx.storage,
+            accountId: options.meta.accountId,
+            windowMs: options.dedupWindowMs,
+            now: options.now ?? Date.now,
+        });
+        this.now = options.now ?? Date.now;
+        this.onConnectionChange = options.onConnectionChange;
+        this.onStaleToken = options.onStaleToken;
+        this.nextLongPollTimeoutMs = options.longPollTimeoutMs;
+    }
+    /** Start the monitor loop. Best-effort notifystart first. */
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        try {
+            await this.client.notifyStart();
+        }
+        catch {
+            // best effort
+        }
+        this.loop = this.runLoop(this.ctx.signal);
+    }
+    /** Abort the loop and best-effort notifystop. */
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        try {
+            await this.client.notifyStop();
+        }
+        catch {
+            // best effort
+        }
+    }
+    /** Wait for the current loop iteration to finish (used by tests/teardown). */
+    async join() {
+        if (this.loop)
+            await this.loop.catch(() => undefined);
+    }
+    async runLoop(signal) {
+        let attempt = 0;
+        let cursor = await this.cursor.load().catch(() => '');
+        this.onConnectionChange?.('connected');
+        while (this.running && !signal.aborted) {
+            try {
+                const result = await this.client.getUpdates({
+                    getUpdatesBuf: cursor,
+                    longPollTimeoutMs: this.nextLongPollTimeoutMs,
+                    signal,
+                });
+                const t = result.nextLongPollTimeoutMs;
+                if (typeof t === 'number' && t > 0) {
+                    this.nextLongPollTimeoutMs = t;
+                }
+                attempt = 0;
+                this.onConnectionChange?.('connected');
+                // Process each message; then commit the cursor AFTER the round.
+                if (result.msgs && result.msgs.length > 0) {
+                    for (const msg of result.msgs) {
+                        if (signal.aborted)
+                            break;
+                        await this.handleMessage(msg);
+                    }
+                    // Persist only after the inbound round is processed (§18 / R1).
+                    if (result.get_updates_buf !== undefined) {
+                        cursor = await this.commitCursor(result.get_updates_buf);
+                    }
+                }
+                // A client-side long-poll timeout is normal control flow; retry.
+            }
+            catch (error) {
+                if (signal.aborted || !this.running)
+                    break;
+                if (error instanceof StaleTokenError) {
+                    this.running = false;
+                    await this.onStaleToken?.(error);
+                    break;
+                }
+                this.onConnectionChange?.('reconnecting');
+                attempt += 1;
+                if (!this.reconnect.enabled)
+                    break;
+                const delay = Math.min(this.reconnect.baseDelayMs * 2 ** Math.min(attempt - 1, 8), this.reconnect.maxDelayMs);
+                this.ctx.logger.warn('[channel-weixin] getUpdates error; retry in ' + delay + 'ms', error);
+                await sleep(delay, signal);
+            }
+        }
+        this.onConnectionChange?.('disconnected');
+    }
+    /**
+     * Persist the new cursor. The local cursor is advanced only after the
+     * durable write succeeds; on failure a CursorCommitError is thrown so the
+     * loop retries with the previous cursor instead of silently diverging.
+     */
+    async commitCursor(next) {
+        try {
+            await this.cursor.set(next);
+        }
+        catch (error) {
+            throw new CursorCommitError(next, { cause: error });
+        }
+        return next;
+    }
+    async handleMessage(msg) {
+        const key = dedupKey(msg);
+        if (await this.dedup.has(key)) {
+            this.ctx.logger.debug("[channel-weixin] dropped duplicate message '" + key + "'");
+            return;
+        }
+        // Capture the latest peer reply context before emit (idempotent on replay).
+        if (msg.context_token && msg.from_user_id) {
+            await this.contextTokens.set(msg.from_user_id, msg.context_token);
+        }
+        const event = mapInbound(msg, this.meta);
+        await this.beforeEmit?.(event);
+        // The summary must precede ctx.emit so diagnostics survive downstream
+        // failures. It contains only stable identifiers and sanitized part facts.
+        this.ctx.logger.info(`[channel-weixin] inbound message ${event.message.id} from ${event.sender.id} in ${event.conversation.id}`, { parts: summarizeInboundParts(event.message.content) });
+        await this.emitMsg(event);
+        // Only after a successful emit is the message a committed dedup entry.
+        await this.dedup.commit(key);
+    }
+    /** Current long-poll timeout (dynamic). */
+    get longPollTimeout() {
+        return this.nextLongPollTimeoutMs;
+    }
+}
+/** Compact per-part summary for inbound message logs (debug diagnostics). */
+export function summarizeInboundParts(parts) {
+    return parts.map((part) => {
+        switch (part.type) {
+            case 'text':
+                return { type: 'text', length: part.text.length };
+            case 'image':
+                return {
+                    type: 'image',
+                    resourceRef: part.resourceRef,
+                    mimeType: part.mimeType,
+                    localDataBytes: part.localData?.byteLength,
+                    ingressFailure: part.ingressFailure,
+                };
+            case 'file':
+                return {
+                    type: 'file',
+                    name: part.name,
+                    size: part.size,
+                    mimeType: part.mimeType,
+                    localDataBytes: part.localData?.byteLength,
+                    ingressFailure: part.ingressFailure,
+                };
+            case 'audio':
+                return {
+                    type: 'audio',
+                    resourceRef: part.resourceRef,
+                    name: part.name,
+                    mimeType: part.mimeType,
+                    size: part.size,
+                    durationMs: part.durationMs,
+                    localDataBytes: part.localData?.byteLength,
+                    ingressFailure: part.ingressFailure,
+                };
+            case 'video':
+                return {
+                    type: 'video',
+                    resourceRef: part.resourceRef,
+                    name: part.name,
+                    mimeType: part.mimeType,
+                    size: part.size,
+                    durationMs: part.durationMs,
+                    localDataBytes: part.localData?.byteLength,
+                    ingressFailure: part.ingressFailure,
+                };
+            default:
+                return { type: part.type };
+        }
+    });
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=monitor.js.map

package/lib/messaging/monitor.js.map

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

package/lib/messaging/quote.d.ts

@@ -0,0 +1,9 @@
+import type { MessagePart } from '@krischoichoi/channel-core';
+import type { ILinkRefMessage } from '../ilink/types.js';
+/**
+ * Preserve a Weixin reference as explicit model-visible context. iLink does
+ * not expose a stable referenced Channel message id, so this must not create a
+ * synthetic replyTo relationship.
+ */
+export declare function formatQuotedContext(ref: ILinkRefMessage | undefined): MessagePart[];
+//# sourceMappingURL=quote.d.ts.map

package/lib/messaging/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../src/messaging/quote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,SAAS,GAAG,WAAW,EAAE,CAQnF"}