@clowder-ai/connector-dingtalk 0.0.0-stage → 0.1.0-alpha.5

package/dist/runtime.js

@@ -0,0 +1,167 @@
+import { DingTalkAdapter, } from './DingTalkAdapter.js';
+function required(value, key) {
+    const normalized = value.trim();
+    if (normalized.length === 0)
+        throw new TypeError(`${key} must be a non-empty declared value`);
+    return normalized;
+}
+function hostMessage(adapter, message) {
+    const attachments = message.attachments
+        ?.filter(attachment => attachment.downloadCode !== undefined)
+        .map(attachment => ({
+        type: attachment.type,
+        platformKey: attachment.downloadCode,
+        ...(attachment.fileName === undefined ? {} : { fileName: attachment.fileName }),
+        ...(attachment.duration === undefined ? {} : { duration: attachment.duration }),
+    }));
+    const senderName = message.senderNick ?? adapter.resolveSenderName(message.senderId);
+    const chatName = message.conversationTitle ?? adapter.resolveConversationTitle(message.chatId);
+    const sender = message.chatType === 'group' && message.senderId !== 'unknown'
+        ? { id: message.senderId, ...(senderName === undefined ? {} : { name: senderName }) }
+        : undefined;
+    return {
+        externalConversationId: message.chatId,
+        providerConversationId: message.conversationId,
+        providerMessageId: message.messageId,
+        ...(message.senderId === 'unknown' || message.senderId.trim() === '' ? {} : { externalSenderId: message.senderId }),
+        text: message.text,
+        chatType: message.chatType,
+        ...(attachments === undefined ? {} : { attachments }),
+        ...(sender === undefined ? {} : { sender }),
+        ...(chatName === undefined ? {} : { chatName }),
+    };
+}
+/**
+ * Composes DingTalk provider I/O from explicit manifest-declared values.
+ * Binding lookup, admission, wake policy, retry, and settlement remain Host
+ * responsibilities and are intentionally absent from the delivered payload.
+ */
+export function createDingTalkConnectorRuntime(options) {
+    const config = {
+        appKey: required(options.config.appKey, 'appKey'),
+        appSecret: required(options.config.appSecret, 'appSecret'),
+        ...(options.config.robotCode === undefined ? {} : { robotCode: options.config.robotCode }),
+    };
+    const createAdapter = options.createAdapter ?? ((value, logger) => new DingTalkAdapter(logger, value));
+    const outbound = createAdapter(config, options.logger);
+    let state = 'idle';
+    let startPromise;
+    let stopPromise;
+    let watchdogTimer;
+    let reconnectTimer;
+    const watchdogIntervalMs = options.streamWatchdogIntervalMs ?? 15_000;
+    const reconnectBaseDelayMs = options.reconnectDelayMs ?? 5_000;
+    const reconnectMaxDelayMs = options.reconnectMaxDelayMs ?? 60_000;
+    let reconnectAttempts = 0;
+    const nextBackoffMs = () => {
+        const exponential = Math.min(reconnectBaseDelayMs * 2 ** reconnectAttempts, reconnectMaxDelayMs);
+        reconnectAttempts += 1;
+        return Math.round(exponential * (0.8 + Math.random() * 0.4));
+    };
+    const deliverIfRunning = async (message) => {
+        if (state !== 'running')
+            return;
+        await options.host.deliver(hostMessage(outbound, message));
+    };
+    // G1: the SDK retries a dropped or revoked-credential stream silently, so
+    // the runtime polls the client truth (connected && registered) and owns
+    // reconnect supervision: dead stream → state exits 'running' → error log →
+    // backoff → drain + fresh startStream, until stop().
+    const scheduleReconnect = (reason) => {
+        if (state === 'stopped' || reconnectTimer !== undefined)
+            return;
+        const delayMs = nextBackoffMs();
+        options.logger.error(`[DingTalkRuntime] ${reason}; reconnecting in ${delayMs}ms`);
+        reconnectTimer = setTimeout(() => {
+            reconnectTimer = undefined;
+            if (state !== 'idle')
+                return; // stop() or a fresh start() superseded it
+            state = 'starting';
+            startPromise = outbound.stopStream()
+                .catch(() => undefined)
+                .then(() => outbound.startStream(deliverIfRunning))
+                .then(() => {
+                if (state !== 'stopped') {
+                    reconnectAttempts = 0;
+                    armWatchdog();
+                    state = 'running';
+                    options.logger.info('[DingTalkRuntime] Provider stream started');
+                }
+            })
+                .catch((error) => {
+                // Timer-context rejection: never rethrow (unhandled rejection);
+                // log and reschedule the backoff instead.
+                if (state === 'stopped')
+                    return;
+                state = 'idle';
+                startPromise = undefined;
+                options.logger.error({ error }, '[DingTalkRuntime] Reconnect attempt failed');
+                scheduleReconnect('reconnect attempt failed');
+            });
+        }, delayMs);
+    };
+    const armWatchdog = () => {
+        // Armed only on transitions into 'running': arming at the top of start()
+        // leaks the interval for the process lifetime when startStream rejects
+        // (the interval keeps the event loop alive even though the runtime
+        // never left 'idle').
+        if (watchdogTimer !== undefined)
+            return;
+        watchdogTimer = setInterval(onWatchdog, watchdogIntervalMs);
+    };
+    const onWatchdog = () => {
+        if (state !== 'running' || outbound.isStreamLive())
+            return;
+        state = 'idle'; // no live inbound during reconnect
+        startPromise = undefined;
+        scheduleReconnect('provider stream is not live (connected/registered dropped)');
+    };
+    return {
+        outbound,
+        start() {
+            if (state === 'stopped')
+                return Promise.reject(new Error('DingTalk connector runtime has been stopped'));
+            if (startPromise !== undefined)
+                return startPromise;
+            state = 'starting';
+            startPromise = outbound
+                .startStream(deliverIfRunning)
+                .then(() => {
+                if (state !== 'stopped') {
+                    reconnectAttempts = 0;
+                    armWatchdog();
+                    state = 'running';
+                    options.logger.info('[DingTalkRuntime] Provider stream started');
+                }
+            })
+                .catch((error) => {
+                if (state !== 'stopped') {
+                    state = 'idle';
+                    startPromise = undefined;
+                }
+                throw error;
+            });
+            return startPromise;
+        },
+        stop() {
+            if (stopPromise !== undefined)
+                return stopPromise;
+            if (watchdogTimer !== undefined) {
+                clearInterval(watchdogTimer);
+                watchdogTimer = undefined;
+            }
+            if (reconnectTimer !== undefined) {
+                clearTimeout(reconnectTimer);
+                reconnectTimer = undefined;
+            }
+            if (state === 'idle') {
+                state = 'stopped';
+                return Promise.resolve();
+            }
+            state = 'stopped';
+            stopPromise = outbound.stopStream();
+            return stopPromise;
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAC;AAuE9B,SAAS,QAAQ,CAAC,KAAa,EAAE,GAA2B;IAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,GAAG,qCAAqC,CAAC,CAAC;IAC9F,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAClB,OAA+B,EAC/B,OAA+B;IAE/B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW;QACrC,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,KAAK,SAAS,CAAC;SAC5D,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,WAAW,EAAE,UAAU,CAAC,YAAa;QACrC,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;QAC/E,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;KAChF,CAAC,CAAC,CAAC;IACN,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrF,MAAM,QAAQ,GAAG,OAAO,CAAC,iBAAiB,IAAI,OAAO,CAAC,wBAAwB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/F,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC3E,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE;QACrF,CAAC,CAAC,SAAS,CAAC;IACd,OAAO;QACL,sBAAsB,EAAE,OAAO,CAAC,MAAM;QACtC,sBAAsB,EAAE,OAAO,CAAC,cAAc;QAC9C,iBAAiB,EAAE,OAAO,CAAC,SAAS;QACpC,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACrD,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3C,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAiD;IAEjD,MAAM,MAAM,GAA2B;QACrC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;QACjD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC;QAC1D,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;KAC3F,CAAC;IACF,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,KAA6B,EAAE,MAAuB,EAAE,EAAE,CACzG,IAAI,eAAe,CAAC,MAAM,EAAE,KAAK,CAClC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,KAAK,GAAgD,MAAM,CAAC;IAChE,IAAI,YAAuC,CAAC;IAC5C,IAAI,WAAsC,CAAC;IAC3C,IAAI,aAAyD,CAAC;IAC9D,IAAI,cAAyD,CAAC;IAC9D,MAAM,kBAAkB,GAAG,OAAO,CAAC,wBAAwB,IAAI,MAAM,CAAC;IACtE,MAAM,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,IAAI,KAAK,CAAC;IAC/D,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,MAAM,CAAC;IAClE,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,MAAM,aAAa,GAAG,GAAW,EAAE;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,IAAI,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;QACjG,iBAAiB,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC;IACF,MAAM,gBAAgB,GAAG,KAAK,EAAE,OAA+B,EAAE,EAAE;QACjE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC;IAEF,0EAA0E;IAC1E,wEAAwE;IACxE,2EAA2E;IAC3E,qDAAqD;IACrD,MAAM,iBAAiB,GAAG,CAAC,MAAc,EAAQ,EAAE;QACjD,IAAI,KAAK,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS;YAAE,OAAO;QAChE,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,MAAM,qBAAqB,OAAO,IAAI,CAAC,CAAC;QAClF,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;YAC/B,cAAc,GAAG,SAAS,CAAC;YAC3B,IAAI,KAAK,KAAK,MAAM;gBAAE,OAAO,CAAC,0CAA0C;YACxE,KAAK,GAAG,UAAU,CAAC;YACnB,YAAY,GAAG,QAAQ,CAAC,UAAU,EAAE;iBACjC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;iBACtB,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;iBAClD,IAAI,CAAC,GAAG,EAAE;gBACT,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,iBAAiB,GAAG,CAAC,CAAC;oBACtB,WAAW,EAAE,CAAC;oBACd,KAAK,GAAG,SAAS,CAAC;oBAClB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,gEAAgE;gBAChE,0CAA0C;gBAC1C,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO;gBAChC,KAAK,GAAG,MAAM,CAAC;gBACf,YAAY,GAAG,SAAS,CAAC;gBACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,4CAA4C,CAAC,CAAC;gBAC9E,iBAAiB,CAAC,0BAA0B,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACP,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,yEAAyE;QACzE,uEAAuE;QACvE,mEAAmE;QACnE,sBAAsB;QACtB,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO;QACxC,aAAa,GAAG,WAAW,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IAC9D,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,YAAY,EAAE;YAAE,OAAO;QAC3D,KAAK,GAAG,MAAM,CAAC,CAAC,mCAAmC;QACnD,YAAY,GAAG,SAAS,CAAC;QACzB,iBAAiB,CAAC,4DAA4D,CAAC,CAAC;IAClF,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,KAAK;YACH,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC,CAAC;YACzG,IAAI,YAAY,KAAK,SAAS;gBAAE,OAAO,YAAY,CAAC;YACpD,KAAK,GAAG,UAAU,CAAC;YACnB,YAAY,GAAG,QAAQ;iBACpB,WAAW,CAAC,gBAAgB,CAAC;iBAC7B,IAAI,CAAC,GAAG,EAAE;gBACT,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,iBAAiB,GAAG,CAAC,CAAC;oBACtB,WAAW,EAAE,CAAC;oBACd,KAAK,GAAG,SAAS,CAAC;oBAClB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,KAAK,GAAG,MAAM,CAAC;oBACf,YAAY,GAAG,SAAS,CAAC;gBAC3B,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;YACL,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IAAI;YACF,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO,WAAW,CAAC;YAClD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChC,aAAa,CAAC,aAAa,CAAC,CAAC;gBAC7B,aAAa,GAAG,SAAS,CAAC;YAC5B,CAAC;YACD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjC,YAAY,CAAC,cAAc,CAAC,CAAC;gBAC7B,cAAc,GAAG,SAAS,CAAC;YAC7B,CAAC;YACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,KAAK,GAAG,SAAS,CAAC;gBAClB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;YACD,KAAK,GAAG,SAAS,CAAC;YAClB,WAAW,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;YACpC,OAAO,WAAW,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/thread-mappings.d.ts

@@ -0,0 +1,46 @@
+import type { FeatureContext } from '@clowder-ai/plugin-sdk';
+type Mapping = {
+    readonly key: string;
+    readonly threadId: string;
+    readonly createdAt: number;
+};
+type Creation = {
+    readonly title: string;
+    readonly parentThreadId?: string;
+    readonly participants?: readonly string[];
+};
+export declare function threadMappings(context: FeatureContext): {
+    findByKey: (name: string) => Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary | null>;
+    bind: (name: string, threadId: string) => Promise<boolean | Mapping>;
+    unbind: (name: string) => Promise<boolean | Mapping>;
+    listBindings: () => Promise<Mapping[]>;
+    ensureByKey: (name: string, input: Creation) => Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+    ensureSystemThread: () => Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+    get(threadId: string): Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary | null>;
+    list(options?: {
+        readonly limit?: number;
+        readonly before?: {
+            readonly lastActiveAt: number;
+            readonly id: string;
+        };
+    }): Promise<readonly import("@clowder-ai/plugin-sdk").PluginThreadSummary[]>;
+    readMessages(threadId: string, options: {
+        readonly before?: {
+            readonly timestamp: number;
+            readonly id: string;
+        };
+        readonly limit: number;
+    }): Promise<readonly import("@clowder-ai/plugin-sdk").PluginThreadMessage[]>;
+    getCats(threadId: string): Promise<import("@clowder-ai/plugin-sdk").PluginThreadCats>;
+    addParticipants(input: {
+        readonly threadId: string;
+        readonly catIds: readonly string[];
+    }): Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+    create(input: import("@clowder-ai/plugin-sdk").PluginThreadCreateInput): Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+    update(threadId: string, patch: {
+        readonly title?: string;
+        readonly preferredCats?: readonly string[];
+    }): Promise<import("@clowder-ai/plugin-sdk").PluginThreadSummary>;
+};
+export {};
+//# sourceMappingURL=thread-mappings.d.ts.map

package/dist/thread-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-mappings.d.ts","sourceRoot":"","sources":["../src/thread-mappings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,KAAK,OAAO,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/F,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AA+CxH,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc;sBA/B1B,MAAM;iBAwBjB,MAAM,YAAY,MAAM;mBACtB,MAAM;;wBAVD,MAAM,SAAS,QAAQ;;;;sBAkBT,CAAC;uBAAiC,CAAC;;;;;;uBAG2M,CAAC;;;;;;;;;;;;;sBAA2f,CAAC;8BAAwC,CAAC;;EADzzB"}

package/dist/thread-mappings.js

@@ -0,0 +1,62 @@
+const contexts = new WeakMap();
+/** Package-owned external-conversation mapping. Host receives ordinary thread calls only. */
+function createMappings(context) {
+    const key = 'thread-mappings.v1';
+    let tail = Promise.resolve();
+    const serialize = (run) => {
+        const next = tail.then(run, run);
+        tail = next.catch(() => { });
+        return next;
+    };
+    const read = async () => {
+        const stored = await context.storage.get(key);
+        const rows = stored?.value ?? [];
+        if (!Array.isArray(rows) || rows.some(row => !row || typeof row.key !== 'string' || typeof row.threadId !== 'string' || typeof row.createdAt !== 'number'))
+            throw new Error('Invalid plugin thread mappings');
+        return { stored, rows: rows };
+    };
+    const find = async (name) => {
+        const { rows } = await read();
+        const row = rows.find(row => row.key === name);
+        return row ? context.threads.get(row.threadId) : null;
+    };
+    const save = async (name, threadId) => {
+        const { stored, rows } = await read();
+        const next = rows.filter(row => row.key !== name);
+        if (threadId !== null) {
+            if (!await context.threads.get(threadId))
+                throw new Error('Thread unavailable');
+            next.push({ key: name, threadId, createdAt: Date.now() });
+        }
+        const result = await context.storage.compareAndSet(key, stored?.revision ?? null, next);
+        if (!result.applied)
+            throw new Error('Plugin thread mappings changed concurrently');
+        return threadId === null ? rows.length !== next.length : next.find(row => row.key === name);
+    };
+    const ensure = (name, input) => serialize(async () => {
+        const existing = await find(name);
+        if (existing)
+            return existing;
+        const thread = await context.threads.create(input);
+        await save(name, thread.id);
+        return thread;
+    });
+    return {
+        ...context.threads,
+        findByKey: find,
+        bind: (name, threadId) => serialize(() => save(name, threadId)),
+        unbind: (name) => serialize(() => save(name, null)),
+        listBindings: async () => (await read()).rows,
+        ensureByKey: ensure,
+        ensureSystemThread: () => ensure('command-audit', { title: '连接器命令记录' }),
+    };
+}
+export function threadMappings(context) {
+    let value = contexts.get(context);
+    if (!value) {
+        value = createMappings(context);
+        contexts.set(context, value);
+    }
+    return value;
+}
+//# sourceMappingURL=thread-mappings.js.map

package/dist/thread-mappings.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+export type ConnectorLogMethod = (...args: readonly unknown[]) => void;
+export interface ConnectorLogger {
+    info: ConnectorLogMethod;
+    warn: ConnectorLogMethod;
+    error: ConnectorLogMethod;
+    debug?: ConnectorLogMethod;
+}
+export type RichBlock = Readonly<Record<string, unknown>>;
+export interface MessageEnvelope {
+    header: string;
+    body: string;
+    origin: 'direct' | 'callback';
+    subtitle?: string;
+    footer?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,KAAK,IAAI,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

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

package/dist/types.js.map

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