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

package/dist/plugin-entrypoint.js

@@ -0,0 +1,282 @@
+import { isPluginDeliveryInput } from '@clowder-ai/plugin-contract';
+import { definePluginModule } from '@clowder-ai/plugin-sdk';
+import { threadMappings } from './thread-mappings.js';
+import { createConnectorCommandBridge } from '@clowder-ai/plugin-sdk';
+import { definePlugin, defineDeliveryAction, requireConnectorOutboundDelivery, } from '@clowder-ai/plugin-sdk';
+import { createDingTalkConnectorRuntime, } from './runtime.js';
+import { renderTypedMediaNotice } from './media-notice.js';
+import { createInboundMediaSource, releaseInboundMedia, retainInboundMedia } from './inbound-media-source.js';
+import { createConnectorLifecycleAction } from './lifecycle-action.js';
+import { createReplySenderMap } from './reply-sender-map.js';
+import { connectorCommandFacts } from './command-ingress.js';
+const CONNECTOR_ID = 'dingtalk';
+const IDENTITY_ID = 'dingtalk-bot';
+function object(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function requireDelivery(candidate) {
+    if (!isPluginDeliveryInput(candidate) || candidate.kind !== 'message')
+        throw new TypeError('dingtalk requires a message delivery');
+    return structuredClone(candidate);
+}
+function title(value) {
+    const normalized = value.trim();
+    const candidate = normalized.length > 0 ? normalized : 'DingTalk conversation';
+    return candidate.length <= 200 ? candidate : candidate.slice(0, 200);
+}
+async function draft(context, message) {
+    const retained = await retainInboundMedia(context, CONNECTOR_ID, 'dingtalk-media', message.providerMessageId, (message.attachments ?? []).map(attachment => ({
+        type: attachment.type, platformKey: attachment.platformKey,
+        ...(attachment.fileName === undefined ? {} : { fileName: attachment.fileName }),
+        ...(attachment.duration === undefined ? {} : { duration: attachment.duration }),
+    })));
+    const messageDraft = {
+        idempotencyKey: message.providerMessageId,
+        sourceEventId: message.providerMessageId,
+        identity: IDENTITY_ID,
+        ...(message.sender === undefined ? {} : { sender: message.sender }),
+        payload: {
+            provenance: {
+                origin: {
+                    kind: 'external',
+                    connectorId: CONNECTOR_ID,
+                    sourceAddress: {
+                        connectorId: CONNECTOR_ID,
+                        chatId: message.externalConversationId,
+                        messageId: message.providerMessageId,
+                    },
+                },
+                epistemicStatus: 'observation',
+            },
+            elements: [
+                { elementId: 'text-1', kind: 'text', payload: { text: message.text } },
+                ...retained.elements,
+            ],
+        },
+    };
+    return { messageDraft, ownership: retained.ownership };
+}
+async function createMessageBridge(context, reply) {
+    const replySenders = createReplySenderMap(context);
+    const subscriptions = new Map();
+    const subscribe = (threadId) => {
+        const current = subscriptions.get(threadId);
+        if (current !== undefined)
+            return current;
+        let pending;
+        pending = context.messaging.subscribe(threadId, { contributionId: CONNECTOR_ID })
+            .catch((error) => {
+            if (subscriptions.get(threadId) === pending)
+                subscriptions.delete(threadId);
+            throw error;
+        });
+        subscriptions.set(threadId, pending);
+        return pending;
+    };
+    for (const binding of await threadMappings(context).listBindings())
+        await subscribe(binding.threadId);
+    const routeCommand = createConnectorCommandBridge(context, {
+        connectorId: CONNECTOR_ID, identityId: IDENTITY_ID, reply,
+        settle: async () => { },
+        async bindingChanged(change) {
+            if (change.threadId !== undefined)
+                await subscribe(change.threadId);
+            if (change.previousThreadId !== undefined && change.previousThreadId !== change.threadId &&
+                !(await threadMappings(context).listBindings()).some(binding => binding.threadId === change.previousThreadId)) {
+                await context.messaging.unsubscribe(change.previousThreadId);
+                subscriptions.delete(change.previousThreadId);
+            }
+        },
+    });
+    return {
+        async deliver(message) {
+            await routeCommand(connectorCommandFacts(message), async () => {
+                const thread = await threadMappings(context).ensureByKey(message.externalConversationId, {
+                    title: title(message.chatName ?? `DingTalk ${message.externalConversationId}`),
+                });
+                await subscribe(thread.id);
+                const prepared = await draft(context, message);
+                try {
+                    const sent = await context.messaging.send(thread.id, prepared.messageDraft);
+                    if (prepared.messageDraft.sender !== undefined) {
+                        try {
+                            await replySenders.record(sent.messageId, prepared.messageDraft.sender);
+                        }
+                        catch (error) {
+                            context.log('warn', 'DingTalk reply-sender mapping record failed', {
+                                errorName: error instanceof Error ? error.name : 'unknown',
+                            });
+                        }
+                    }
+                }
+                catch (error) {
+                    await releaseInboundMedia(context, prepared.ownership, error);
+                    throw error;
+                }
+            });
+        },
+        async outbound(candidate) {
+            const input = requireDelivery(candidate);
+            const bindings = (await threadMappings(context).listBindings()).filter(item => item.threadId === input.threadId);
+            if (bindings.length === 0)
+                throw new TypeError(`dingtalk thread ${input.threadId} has no provider binding`);
+            const text = input.envelope.payload.elements.flatMap((element) => {
+                if (element.kind === 'text')
+                    return [element.payload.text];
+                const notice = renderTypedMediaNotice(element, {
+                    elements: input.envelope.payload.elements,
+                    warnInvalid: elementId => context.log('warn', 'Invalid typed media notice ignored', { elementId }),
+                });
+                return notice === undefined ? [] : [notice];
+            }).join('\n\n');
+            const richBlocks = input.envelope.payload.elements
+                .filter(element => element.kind === 'rich_block')
+                .map(element => element.payload);
+            const media = input.envelope.payload.elements.flatMap((element) => {
+                if (element.kind !== 'media_ref' || !object(element.payload))
+                    return [];
+                const type = element.payload.type;
+                const reference = element.payload.reference;
+                if (!['image', 'file', 'audio', 'video'].includes(String(type)) || typeof reference !== 'string')
+                    return [];
+                return [{ type, reference, ...(typeof element.payload.fileName === 'string' ? { fileName: element.payload.fileName } : {}) }];
+            });
+            const displayName = input.presentation?.actor.displayName || input.envelope.actor.id;
+            const replyPrefix = input.envelope.actor.kind === 'cat' ? `【${displayName}🐱】\n` : '';
+            const replyToSender = await replySenders.resolve(input.envelope.replyTo);
+            // One thread can carry several provider bindings (the Host allows
+            // rebinding different external chats onto the same thread), so the
+            // same Host delivery fans out to every binding.
+            return {
+                replyPrefix,
+                inputs: bindings.map(binding => requireConnectorOutboundDelivery({
+                    deliveryId: input.deliveryId,
+                    externalConversationId: binding.key,
+                    presentation: {
+                        header: displayName,
+                        body: text,
+                        origin: input.envelope.actor.kind === 'cat' ? 'agent' : input.envelope.actor.kind === 'system' ? 'system' : 'direct',
+                    },
+                    ...(replyToSender === undefined ? {} : { metadata: { replyToSender } }),
+                    ...(richBlocks.length === 0 ? {} : { richBlocks }),
+                    ...(media.length === 0 ? {} : { media }),
+                })),
+            };
+        },
+    };
+}
+async function deliverOutbound(outbound, input, context, replyPrefix) {
+    const blocks = [...(input.richBlocks ?? [])];
+    if (blocks.length > 0) {
+        await outbound.sendRichMessage(input.externalConversationId, input.presentation.body, blocks, input.presentation.header, input.metadata);
+    }
+    else {
+        await outbound.sendFormattedReply(input.externalConversationId, {
+            ...input.presentation,
+            origin: input.presentation.origin === 'callback' ? 'callback' : 'direct',
+        }, input.metadata);
+    }
+    for (const media of input.media ?? []) {
+        if (media.type === 'video') {
+            await outbound.sendReply(input.externalConversationId, `${replyPrefix}⚠️ 视频附件暂不支持发送`, input.metadata);
+            continue;
+        }
+        if (!media.reference.startsWith('hmr_')) {
+            await outbound.sendReply(input.externalConversationId, `${replyPrefix}⚠️ 媒体不可用（旧引用无法读取）`, input.metadata);
+            continue;
+        }
+        try {
+            await outbound.sendMedia(input.externalConversationId, {
+                type: media.type,
+                content: context.streams.read(media.reference),
+                ...(media.fileName === undefined ? {} : { fileName: media.fileName }),
+            });
+        }
+        catch (error) {
+            context.log('warn', 'DingTalk outbound media delivery failed', {
+                mediaType: media.type,
+                errorName: error instanceof Error ? error.name : 'unknown',
+            });
+            await outbound.sendReply(input.externalConversationId, `${replyPrefix}${error instanceof RangeError ? '⚠️ 媒体过大，超过钉钉发送上限' : '⚠️ 媒体不可用（读取或上传失败）'}`, input.metadata);
+        }
+    }
+}
+export function createDingTalkPluginModule(createRuntime = createDingTalkConnectorRuntime) {
+    return definePluginModule((manifest) => definePlugin({
+        manifest,
+        activate: {
+            'dingtalk-messaging': async (context) => {
+                let runtime;
+                const bridge = await createMessageBridge(context, (input, result) => runtime.outbound.sendFormattedReply(input.chatId, { header: 'Clowder AI', body: result.response, origin: 'callback' }, { chatType: input.group ? 'group' : 'p2p', ...(input.group && input.senderId !== undefined ? { replyToSender: { id: input.senderId } } : {}) }));
+                const configure = async () => {
+                    await runtime?.stop();
+                    const appKey = await context.config.get('appKey');
+                    const appSecret = await context.secrets.get('appSecret');
+                    if (typeof appKey !== 'string')
+                        throw new TypeError('appKey must be a declared string');
+                    if (typeof appSecret !== 'string')
+                        throw new TypeError('appSecret must be a declared secret');
+                    runtime = createRuntime({
+                        config: { appKey, appSecret },
+                        host: { deliver: bridge.deliver },
+                        logger: { debug: (...args) => context.log('debug', String(args[0]), { args }), info: (...args) => context.log('info', String(args[0]), { args }), warn: (...args) => context.log('warn', String(args[0]), { args }), error: (...args) => context.log('error', String(args[0]), { args }) },
+                    });
+                    await runtime.start();
+                };
+                await configure();
+                const mediaSource = createInboundMediaSource(context, locator => runtime.outbound.downloadInboundMedia(locator));
+                const lifecycle = createConnectorLifecycleAction(context, {
+                    sendPlaceholder: (externalConversationId, text) => runtime.outbound.sendPlaceholder(externalConversationId, text),
+                    editPlaceholder: (externalConversationId, platformMessageId, text, phase) => runtime.outbound.editMessage(externalConversationId, platformMessageId, text, { bypassThrottle: phase === 'blocked' }),
+                    sendRecovery: (externalConversationId, text) => runtime.outbound.sendReply(externalConversationId, text),
+                    settle: async ({ platformMessageId, recoveryText }) => {
+                        if (platformMessageId !== undefined)
+                            await runtime.outbound.deleteMessage(platformMessageId, recoveryText);
+                    },
+                });
+                return {
+                    configRefresh: configure,
+                    streams: mediaSource,
+                    actions: {
+                        'dingtalk.outbound': defineDeliveryAction(async (candidate) => {
+                            if (candidate.kind === 'execution_status') {
+                                return lifecycle(candidate);
+                            }
+                            const { inputs, replyPrefix } = await bridge.outbound(candidate);
+                            // Per-binding isolation: one thread can fan out to several
+                            // provider bindings, and a failure on one chat must not block
+                            // or fail the others. A single binding keeps the old fail-fast
+                            // behavior so the Host redelivers; with several bindings the
+                            // action only rejects when every binding failed.
+                            let firstFailure;
+                            let delivered = 0;
+                            for (const input of inputs) {
+                                try {
+                                    await deliverOutbound(runtime.outbound, input, context, replyPrefix);
+                                    delivered += 1;
+                                }
+                                catch (error) {
+                                    if (firstFailure === undefined)
+                                        firstFailure = error;
+                                    context.log('warn', 'DingTalk outbound delivery to one binding failed', {
+                                        externalConversationId: input.externalConversationId,
+                                        errorName: error instanceof Error ? error.name : 'unknown',
+                                    });
+                                }
+                            }
+                            if (delivered === 0) {
+                                if (firstFailure !== undefined)
+                                    throw firstFailure;
+                                throw new Error('DingTalk outbound delivery failed for all bindings (provider did not report an error)');
+                            }
+                            return { deliveryId: candidate.deliveryId };
+                        }),
+                    },
+                    dispose: () => runtime.stop(),
+                };
+            },
+        },
+    }));
+}
+export default createDingTalkPluginModule();
+//# sourceMappingURL=plugin-entrypoint.js.map

package/dist/plugin-entrypoint.js.map

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

package/dist/reply-sender-map.d.ts

@@ -0,0 +1,10 @@
+import type { FeatureContext } from '@clowder-ai/plugin-sdk';
+export interface ReplySender {
+    readonly id: string;
+    readonly name?: string;
+}
+export declare function createReplySenderMap(context: FeatureContext): {
+    record(hostMessageId: string, replySender: ReplySender): Promise<void>;
+    resolve(hostMessageId: string | undefined): Promise<ReplySender | undefined>;
+};
+//# sourceMappingURL=reply-sender-map.d.ts.map

package/dist/reply-sender-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply-sender-map.d.ts","sourceRoot":"","sources":["../src/reply-sender-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AA0CD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc;0BAkD5B,MAAM,eAAe,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;2BAgB/C,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;EAmBrF"}

package/dist/reply-sender-map.js

@@ -0,0 +1,123 @@
+const KEY_PREFIX = 'reply-sender:';
+const ENTRY_TTL_MS = 24 * 60 * 60 * 1000;
+const SWEEP_EVERY_RECORDS = 50;
+const ENTRY_CAP = 2000;
+function object(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function errorName(error) {
+    return error instanceof Error ? error.name : 'unknown';
+}
+function parseEntry(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+    if (!object(parsed) || parsed.version !== 1 || typeof parsed.storedAt !== 'number')
+        return undefined;
+    const candidate = parsed.sender;
+    if (!object(candidate) || typeof candidate.id !== 'string' || candidate.id.length === 0)
+        return undefined;
+    return {
+        version: 1,
+        storedAt: parsed.storedAt,
+        sender: {
+            id: candidate.id,
+            ...(typeof candidate.name === 'string' ? { name: candidate.name } : {}),
+        },
+    };
+}
+export function createReplySenderMap(context) {
+    let recordedSinceSweep = 0;
+    let sweepInFlight = false;
+    const sweep = async () => {
+        let listed;
+        try {
+            listed = await context.storage.list();
+        }
+        catch (error) {
+            context.log('warn', 'Connector reply-sender mapping sweep failed', { errorName: errorName(error) });
+            return;
+        }
+        const now = Date.now();
+        const live = [];
+        for (const [key, item] of Object.entries(listed)) {
+            if (!key.startsWith(KEY_PREFIX))
+                continue;
+            const entry = parseEntry(item?.value);
+            if (entry === undefined || entry.storedAt + ENTRY_TTL_MS < now) {
+                await context.storage.delete(key).catch(() => undefined);
+                continue;
+            }
+            live.push({ key, storedAt: entry.storedAt });
+        }
+        live.sort((a, b) => a.storedAt - b.storedAt);
+        let overflow = live.length - (ENTRY_CAP - 1);
+        for (let index = 0; overflow > 0 && index < live.length; index += 1, overflow -= 1) {
+            await context.storage.delete(live[index].key).catch(() => undefined);
+        }
+    };
+    // Sweep single-flight in the background: recording stays on the inbound
+    // hot path and overlapping bursts never stack sweeps. sweep() already
+    // swallows and logs its own storage failures. context.log is intentionally
+    // NOT used here: log() runs assertActive() and throws
+    // FeatureContextRevokedError after stop/revoke, so a sweep racing feature
+    // shutdown would turn into an unhandled rejection; console.warn is the
+    // reviewer-sanctioned exception that stays callable past revocation.
+    const sweepInBackground = () => {
+        if (sweepInFlight)
+            return;
+        sweepInFlight = true;
+        void sweep()
+            .catch((error) => {
+            console.warn('Connector reply-sender mapping sweep failed', { errorName: errorName(error) });
+        })
+            .finally(() => {
+            sweepInFlight = false;
+        });
+    };
+    return {
+        async record(hostMessageId, replySender) {
+            const now = Date.now();
+            try {
+                await context.storage.set(`${KEY_PREFIX}${hostMessageId}`, JSON.stringify({ version: 1, sender: replySender, storedAt: now }));
+            }
+            catch (error) {
+                context.log('warn', 'Connector reply-sender mapping record failed', { errorName: errorName(error) });
+                return;
+            }
+            recordedSinceSweep += 1;
+            if (recordedSinceSweep < SWEEP_EVERY_RECORDS)
+                return;
+            recordedSinceSweep = 0;
+            sweepInBackground();
+        },
+        async resolve(hostMessageId) {
+            if (hostMessageId === undefined)
+                return undefined;
+            const key = `${KEY_PREFIX}${hostMessageId}`;
+            let stored;
+            try {
+                stored = await context.storage.get(key);
+            }
+            catch (error) {
+                context.log('warn', 'Connector reply-sender mapping lookup failed', { errorName: errorName(error) });
+                return undefined;
+            }
+            const entry = parseEntry(stored?.value);
+            if (entry === undefined)
+                return undefined;
+            if (entry.storedAt + ENTRY_TTL_MS < Date.now()) {
+                await context.storage.delete(key).catch(() => undefined);
+                return undefined;
+            }
+            return entry.sender;
+        },
+    };
+}
+//# sourceMappingURL=reply-sender-map.js.map

package/dist/reply-sender-map.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,68 @@
+import { DingTalkAdapter, type DingTalkAdapterOptions, type DingTalkInboundMessage } from './DingTalkAdapter.js';
+import type { ConnectorLogger } from './types.js';
+export interface DingTalkRuntimeConfig {
+    readonly appKey: string;
+    readonly appSecret: string;
+    readonly robotCode?: string;
+}
+export interface DingTalkInboundAttachment {
+    readonly type: 'image' | 'file' | 'audio';
+    readonly platformKey: string;
+    readonly fileName?: string;
+    readonly duration?: number;
+}
+/** Provider facts only; the Host resolves the authenticated connector binding. */
+export interface DingTalkHostInboundMessage {
+    readonly externalConversationId: string;
+    readonly providerConversationId: string;
+    readonly providerMessageId: string;
+    /** Provider sender identity for admission; independent of group reply attribution. */
+    readonly externalSenderId?: string;
+    readonly text: string;
+    readonly attachments?: readonly DingTalkInboundAttachment[];
+    readonly sender?: {
+        readonly id: string;
+        readonly name?: string;
+    };
+    readonly chatType: 'p2p' | 'group';
+    readonly chatName?: string;
+}
+export interface DingTalkRuntimeHost {
+    deliver(message: DingTalkHostInboundMessage): Promise<void>;
+}
+export interface DingTalkOutbound {
+    readonly connectorId: string;
+    sendReply(externalChatId: string, content: string, metadata?: Record<string, unknown>): Promise<void>;
+}
+export interface DingTalkRuntimeAdapter extends DingTalkOutbound {
+    startStream(handler: (message: DingTalkInboundMessage) => Promise<void>): Promise<void>;
+    stopStream(): Promise<void>;
+    isStreamLive(): boolean;
+    resolveSenderName(senderId: string): string | undefined;
+    resolveConversationTitle(chatId: string): string | undefined;
+}
+export interface DingTalkConnectorRuntime<Adapter extends DingTalkRuntimeAdapter = DingTalkAdapter> {
+    readonly outbound: Adapter;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export interface DingTalkConnectorRuntimeOptions<Adapter extends DingTalkRuntimeAdapter = DingTalkAdapter> {
+    readonly config: DingTalkRuntimeConfig;
+    readonly host: DingTalkRuntimeHost;
+    readonly logger: ConnectorLogger;
+    readonly createAdapter?: (config: DingTalkAdapterOptions, logger: ConnectorLogger) => Adapter;
+    /** Watchdog poll interval for provider stream liveness (default 15s). */
+    readonly streamWatchdogIntervalMs?: number;
+    /** Backoff base delay before reconnecting a stream the watchdog found dead (default 5s). */
+    readonly reconnectDelayMs?: number;
+    /** Backoff delay ceiling (default 60s). Exponential backoff doubles from the
+     * base delay with ±20% jitter until this cap. */
+    readonly reconnectMaxDelayMs?: number;
+}
+/**
+ * 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 declare function createDingTalkConnectorRuntime<Adapter extends DingTalkRuntimeAdapter = DingTalkAdapter>(options: DingTalkConnectorRuntimeOptions<Adapter>): DingTalkConnectorRuntime<Adapter>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

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