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

package/dist/inbound-download.js

@@ -0,0 +1,70 @@
+const MEBIBYTE = 1024 * 1024;
+/** Host import is capped at 64 MiB; reject before an adapter buffers beyond it. */
+export const INBOUND_MEDIA_MAX_BYTES = 64 * MEBIBYTE;
+export const INBOUND_MEDIA_TIMEOUT_MS = 30_000;
+export class InboundMediaLimitError extends Error {
+    maxBytes;
+    constructor(maxBytes) {
+        super(`inbound media exceeds the plugin safety limit of ${maxBytes} bytes`);
+        this.maxBytes = maxBytes;
+        this.name = 'InboundMediaLimitError';
+    }
+}
+export async function collectBoundedInboundMedia(content, maxBytes = INBOUND_MEDIA_MAX_BYTES) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of content) {
+        total += chunk.byteLength;
+        if (total > maxBytes)
+            throw new InboundMediaLimitError(maxBytes);
+        chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks, total);
+}
+export async function fetchBoundedInboundMedia(fetchFn, input, init = {}, maxBytes = INBOUND_MEDIA_MAX_BYTES, timeoutMs = INBOUND_MEDIA_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(new Error('inbound media download timed out')), timeoutMs);
+    const signal = init.signal === null || init.signal === undefined
+        ? controller.signal
+        : AbortSignal.any([init.signal, controller.signal]);
+    try {
+        const response = await fetchFn(input, { ...init, signal });
+        if (!response.ok) {
+            await response.body?.cancel().catch(() => undefined);
+            return { response, bytes: Buffer.alloc(0) };
+        }
+        const contentLength = Number(response.headers.get('content-length'));
+        if (Number.isFinite(contentLength) && contentLength > maxBytes) {
+            controller.abort();
+            await response.body?.cancel().catch(() => undefined);
+            throw new InboundMediaLimitError(maxBytes);
+        }
+        if (response.body === null)
+            return { response, bytes: Buffer.alloc(0) };
+        const reader = response.body.getReader();
+        const chunks = [];
+        let total = 0;
+        try {
+            while (true) {
+                const item = await reader.read();
+                if (item.done)
+                    break;
+                total += item.value.byteLength;
+                if (total > maxBytes) {
+                    controller.abort();
+                    await reader.cancel().catch(() => undefined);
+                    throw new InboundMediaLimitError(maxBytes);
+                }
+                chunks.push(Buffer.from(item.value));
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        return { response, bytes: Buffer.concat(chunks, total) };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=inbound-download.js.map

package/dist/inbound-download.js.map

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

package/dist/inbound-media-source.d.ts

@@ -0,0 +1,25 @@
+import { type FeatureContext, type PluginMessagingDraft } from '@clowder-ai/plugin-sdk';
+export interface InboundMediaLocator {
+    readonly sourceEventId: string;
+    readonly type: 'image' | 'file' | 'audio' | 'video';
+    readonly platformKey: string;
+    readonly fileName?: string;
+    readonly duration?: number;
+}
+type DraftElement = PluginMessagingDraft['payload']['elements'][number];
+export interface InboundMediaOwnership {
+    readonly entries: readonly {
+        readonly reference: string;
+        readonly revision: number;
+    }[];
+}
+export interface RetainedInboundMedia {
+    readonly elements: readonly DraftElement[];
+    readonly ownership: InboundMediaOwnership;
+}
+export declare function privateMediaReference(connectorId: string, sourceEventId: string, elementId: string): string;
+export declare function retainInboundMedia(context: FeatureContext, connectorId: string, sourceId: string, sourceEventId: string, attachments: readonly Omit<InboundMediaLocator, 'sourceEventId'>[]): Promise<RetainedInboundMedia>;
+export declare function releaseInboundMedia(context: FeatureContext, ownership: InboundMediaOwnership, sendError?: unknown): Promise<void>;
+export declare function createInboundMediaSource(context: FeatureContext, download: (locator: InboundMediaLocator) => Promise<Uint8Array>): import('@clowder-ai/plugin-sdk').PluginStreams;
+export {};
+//# sourceMappingURL=inbound-media-source.d.ts.map

package/dist/inbound-media-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-media-source.d.ts","sourceRoot":"","sources":["../src/inbound-media-source.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD,KAAK,YAAY,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,EAAE,CAAC;CACL;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;CAC3C;AAkBD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3G;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,SAAS,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,EAAE,GACjE,OAAO,CAAC,oBAAoB,CAAC,CAuD/B;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,qBAAqB,EAChC,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,UAAU,CAAC,GAC9D,OAAO,wBAAwB,EAAE,aAAa,CAiBhD"}

package/dist/inbound-media-source.js

@@ -0,0 +1,111 @@
+import { createHash } from 'node:crypto';
+const STATE_PREFIX = 'media-source/';
+const stateKey = (reference) => `${STATE_PREFIX}${reference}`;
+const DEFINITIVE_SEND_REJECTION_CODES = new Set([
+    'VALIDATION', 'PERMISSION',
+]);
+function isLocator(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const candidate = value;
+    return typeof candidate.sourceEventId === 'string'
+        && ['image', 'file', 'audio', 'video'].includes(String(candidate.type))
+        && typeof candidate.platformKey === 'string';
+}
+function sameLocator(left, right) {
+    return left.sourceEventId === right.sourceEventId
+        && left.type === right.type
+        && left.platformKey === right.platformKey
+        && left.fileName === right.fileName
+        && left.duration === right.duration;
+}
+export function privateMediaReference(connectorId, sourceEventId, elementId) {
+    const digest = createHash('sha256').update(`${connectorId}\\0${sourceEventId}\\0${elementId}`).digest('hex');
+    return `pmr_${connectorId}_${digest}`;
+}
+export async function retainInboundMedia(context, connectorId, sourceId, sourceEventId, attachments) {
+    const retained = [];
+    try {
+        const elements = [];
+        for (const [index, attachment] of attachments.entries()) {
+            const elementId = `media-${index + 1}`;
+            const reference = privateMediaReference(connectorId, sourceEventId, elementId);
+            const locator = { sourceEventId, ...attachment };
+            const inserted = await context.storage.compareAndSet(stateKey(reference), null, locator);
+            if (inserted.applied) {
+                if (typeof inserted.revision !== 'number') {
+                    throw new Error('Inbound media state did not return a revision fence');
+                }
+                retained.push({ reference, revision: inserted.revision });
+            }
+            else {
+                const existing = await context.storage.get(stateKey(reference));
+                if (existing === undefined || !isLocator(existing.value) || !sameLocator(existing.value, locator)) {
+                    throw new Error('Inbound media reference conflicts with retained locator');
+                }
+            }
+            elements.push({
+                elementId,
+                kind: 'media_ref',
+                payload: {
+                    type: attachment.type, reference, sourceId,
+                    ...(attachment.fileName === undefined ? {} : { fileName: attachment.fileName }),
+                    ...(attachment.duration === undefined ? {} : { duration: attachment.duration }),
+                },
+            });
+        }
+        return { elements, ownership: { entries: retained } };
+    }
+    catch (error) {
+        const cleanup = await Promise.allSettled(retained.map(({ reference, revision }) => (context.storage.delete(stateKey(reference), revision))));
+        context.log('warn', 'Inbound media locator retention failed', {
+            connectorId,
+            sourceEventId,
+            attachmentCount: attachments.length,
+            cleanupFailed: cleanup.some(result => result.status === 'rejected'),
+            errorName: error instanceof Error ? error.name : 'unknown',
+        });
+        return {
+            elements: attachments.map((attachment, index) => ({
+                elementId: `media-${index + 1}`,
+                kind: 'media_unavailable',
+                payload: {
+                    type: attachment.type,
+                    reason: 'unavailable',
+                    ...(attachment.fileName === undefined ? {} : { fileName: attachment.fileName }),
+                },
+            })),
+            ownership: { entries: [] },
+        };
+    }
+}
+export async function releaseInboundMedia(context, ownership, sendError) {
+    if (sendError !== undefined) {
+        const code = sendError !== null && typeof sendError === 'object'
+            ? sendError.code
+            : undefined;
+        if (typeof code !== 'string' || !DEFINITIVE_SEND_REJECTION_CODES.has(code))
+            return;
+    }
+    await Promise.all(ownership.entries.map(({ reference, revision }) => (context.storage.delete(stateKey(reference), revision))));
+}
+export function createInboundMediaSource(context, download) {
+    return { read(reference, options = {}) {
+            return { async *[Symbol.asyncIterator]() {
+                    options.signal?.throwIfAborted();
+                    const entry = await context.storage.get(stateKey(reference));
+                    if (!entry || !isLocator(entry.value))
+                        throw new Error('plugin stream source is unavailable');
+                    const bytes = await download(entry.value);
+                    options.signal?.throwIfAborted();
+                    // Provider adapters retain their existing bounded download checks. No base64 materialization.
+                    for (let offset = 0; offset < bytes.length; offset += 524288) {
+                        options.signal?.throwIfAborted();
+                        // A retained iterator cannot outlive its current feature client.
+                        await context.storage.get(stateKey(reference));
+                        yield bytes.subarray(offset, Math.min(offset + 524288, bytes.length));
+                    }
+                } };
+        } };
+}
+//# sourceMappingURL=inbound-media-source.js.map

package/dist/inbound-media-source.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { computeSignature, decryptMessage, encryptMessage, WeComAgentAdapter, } from './WeComAgentAdapter.js';
+export type { WeComAgentAdapterOptions, WeComAgentAttachment, WeComAgentInboundMessage, } from './WeComAgentAdapter.js';
+export type { ConnectorLogger, MessageEnvelope } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { computeSignature, decryptMessage, encryptMessage, WeComAgentAdapter, } from './WeComAgentAdapter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,wBAAwB,CAAC"}

package/dist/media-notice.d.ts

@@ -0,0 +1,6 @@
+export interface TypedMediaNoticeOptions {
+    readonly elements?: readonly unknown[];
+    readonly warnInvalid?: (elementId: string) => void;
+}
+export declare function renderTypedMediaNotice(element: unknown, options?: TypedMediaNoticeOptions): string | undefined;
+//# sourceMappingURL=media-notice.d.ts.map

package/dist/media-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-notice.d.ts","sourceRoot":"","sources":["../src/media-notice.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAoBD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,uBAA4B,GACpC,MAAM,GAAG,SAAS,CAapB"}

package/dist/media-notice.js

@@ -0,0 +1,50 @@
+import { isMediaUnavailableMessageElement, isMediaWarningMessageElement, } from '@clowder-ai/plugin-sdk';
+const MEDIA_TYPE_LABEL = {
+    image: '图片',
+    file: '文件',
+    audio: '音频',
+    video: '视频',
+};
+const UNAVAILABLE_REASON_LABEL = {
+    source_expired: '来源已过期',
+    timeout: '处理超时',
+    unavailable: '无法获取',
+};
+const WARNING_STAGE_LABEL = {
+    transcription: '转写',
+    preview: '预览',
+};
+const WARNING_REASON_LABEL = {
+    timeout: '超时',
+    processing_failed: '处理失败',
+};
+function object(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function referencedMediaLabel(elements, mediaElementId) {
+    const referenced = elements.find((candidate) => (object(candidate) && candidate.elementId === mediaElementId && candidate.kind === 'media_ref'));
+    if (!object(referenced) || !object(referenced.payload))
+        return undefined;
+    if (typeof referenced.payload.fileName === 'string' && referenced.payload.fileName.trim() !== '') {
+        return referenced.payload.fileName;
+    }
+    const type = referenced.payload.type;
+    return typeof type === 'string' && type in MEDIA_TYPE_LABEL
+        ? MEDIA_TYPE_LABEL[type]
+        : undefined;
+}
+export function renderTypedMediaNotice(element, options = {}) {
+    if (isMediaUnavailableMessageElement(element)) {
+        const label = element.payload.fileName ?? MEDIA_TYPE_LABEL[element.payload.type];
+        return `⚠️ 媒体不可用：${label}（${UNAVAILABLE_REASON_LABEL[element.payload.reason]}）`;
+    }
+    if (isMediaWarningMessageElement(element)) {
+        const label = referencedMediaLabel(options.elements ?? [], element.payload.mediaElementId) ?? '媒体';
+        return `⚠️ 媒体处理警告：${label}（${WARNING_STAGE_LABEL[element.payload.stage]}${WARNING_REASON_LABEL[element.payload.reason]}）`;
+    }
+    if (object(element) && (element.kind === 'media_unavailable' || element.kind === 'media_warning')) {
+        options.warnInvalid?.(typeof element.elementId === 'string' ? element.elementId : 'unknown');
+    }
+    return undefined;
+}
+//# sourceMappingURL=media-notice.js.map

package/dist/media-notice.js.map

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

package/dist/plugin-entrypoint.d.ts

@@ -0,0 +1,7 @@
+import { WeComAgentAdapter } from './WeComAgentAdapter.js';
+import { type WeComAgentConnectorRuntime, type WeComAgentConnectorRuntimeOptions } from './runtime.js';
+type RuntimeFactory = (options: WeComAgentConnectorRuntimeOptions<WeComAgentAdapter>) => WeComAgentConnectorRuntime<WeComAgentAdapter>;
+export declare function createWeComAgentPluginModule(createRuntime?: RuntimeFactory): import("@clowder-ai/plugin-sdk").PluginModuleEntrypoint;
+declare const _default: import("@clowder-ai/plugin-sdk").PluginModuleEntrypoint;
+export default _default;
+//# sourceMappingURL=plugin-entrypoint.d.ts.map

package/dist/plugin-entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-entrypoint.d.ts","sourceRoot":"","sources":["../src/plugin-entrypoint.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,iCAAiC,EAIvC,MAAM,cAAc,CAAC;AAEtB,KAAK,cAAc,GAAG,CACpB,OAAO,EAAE,iCAAiC,CAAC,iBAAiB,CAAC,KAC1D,0BAA0B,CAAC,iBAAiB,CAAC,CAAC;AAmNnD,wBAAgB,4BAA4B,CAAC,aAAa,GAAE,cAAiD,2DA6E5G;;AAED,wBAA8C"}

package/dist/plugin-entrypoint.js

@@ -0,0 +1,292 @@
+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 { renderTypedMediaNotice } from './media-notice.js';
+import { createInboundMediaSource, releaseInboundMedia, retainInboundMedia } from './inbound-media-source.js';
+import { createReplySenderMap } from './reply-sender-map.js';
+import { connectorCommandFacts } from './command-ingress.js';
+import { renderAllRichBlocksPlaintext } from './rich-block-plaintext.js';
+import { createWeComAgentConnectorRuntime, requireWeComAgentWebhookInput, } from './runtime.js';
+const CONNECTOR_ID = 'wecom-agent';
+const IDENTITY_ID = 'wecom-agent';
+function object(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function requireDelivery(candidate) {
+    if (!isPluginDeliveryInput(candidate) || candidate.kind !== 'message')
+        throw new TypeError('wecom-agent requires a message delivery');
+    return structuredClone(candidate);
+}
+async function draft(context, message) {
+    const retained = await retainInboundMedia(context, CONNECTOR_ID, 'wecom-agent-media', message.providerMessageId, (message.attachments ?? []).map(attachment => ({
+        type: attachment.type, platformKey: attachment.platformKey,
+        ...(attachment.fileName === undefined ? {} : { fileName: attachment.fileName }),
+    })));
+    const messageDraft = {
+        idempotencyKey: message.providerMessageId,
+        sourceEventId: message.providerMessageId,
+        identity: IDENTITY_ID,
+        sender: { id: message.externalSenderId },
+        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: `WeCom ${message.externalConversationId}`.slice(0, 200) });
+                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', 'WeCom agent 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(`wecom-agent 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 }),
+                })),
+            };
+        },
+    };
+}
+function forwardedWebhookInput(candidate) {
+    if (!object(candidate) || !object(candidate.request)) {
+        throw new TypeError('wecom-agent webhook action requires a forwarded request');
+    }
+    if (Object.keys(candidate).some(key => key !== 'request')) {
+        throw new TypeError('wecom-agent webhook action contains an unsupported field');
+    }
+    const request = candidate.request;
+    if ((request.method !== 'GET' && request.method !== 'POST') || request.path !== 'connectors/wecom-agent') {
+        throw new TypeError('wecom-agent webhook request must match the declared GET or POST path');
+    }
+    return requireWeComAgentWebhookInput({ body: request.body, query: request.query });
+}
+function webhookHttpResponse(result) {
+    switch (result.kind) {
+        case 'challenge': return { status: 200, headers: { 'content-type': 'text/plain' }, body: result.response };
+        case 'processed': return { status: 200, headers: {}, body: { ok: true, messageId: result.messageId } };
+        case 'skipped': return { status: 200, headers: {}, body: { ok: true, skipped: result.reason } };
+        case 'error': return { status: result.status, headers: {}, body: { error: result.message } };
+        default: throw new TypeError('wecom-agent webhook runtime returned an invalid result');
+    }
+}
+async function deliverOutbound(outbound, input, context, replyPrefix) {
+    const blocks = [...(input.richBlocks ?? [])];
+    if (blocks.length > 0) {
+        const text = [input.presentation.subtitle, input.presentation.body, input.presentation.footer]
+            .filter((value) => value !== undefined && value.length > 0)
+            .join('\n\n');
+        await outbound.sendReply(input.externalConversationId, replyPrefix + text + '\n\n' + renderAllRichBlocksPlaintext(blocks));
+    }
+    else {
+        await outbound.sendFormattedReply(input.externalConversationId, {
+            header: input.presentation.header,
+            body: input.presentation.body,
+            origin: input.presentation.origin === 'callback' ? 'callback' : 'direct',
+            ...(input.presentation.subtitle === undefined ? {} : { subtitle: input.presentation.subtitle }),
+            ...(input.presentation.footer === undefined ? {} : { footer: input.presentation.footer }),
+        });
+    }
+    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', 'WeCom agent outbound media delivery failed', {
+                mediaType: media.type,
+                errorName: error instanceof Error ? error.name : 'unknown',
+            });
+            await outbound.sendReply(input.externalConversationId, `${replyPrefix}${error instanceof RangeError || (error instanceof Error && error.name === 'ProviderMediaLimitError')
+                ? '⚠️ 媒体过大，超过企业微信发送上限'
+                : '⚠️ 媒体不可用（读取或上传失败）'}`, input.metadata);
+        }
+    }
+}
+export function createWeComAgentPluginModule(createRuntime = createWeComAgentConnectorRuntime) {
+    return definePluginModule((manifest) => definePlugin({
+        manifest,
+        activate: {
+            'wecom-agent-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' }));
+                const configure = async () => {
+                    await runtime?.stop();
+                    const [corpId, agentId, agentSecret, callbackToken, encodingAesKey] = await Promise.all([
+                        context.config.get('corpId'),
+                        context.config.get('agentId'),
+                        context.secrets.get('agentSecret'),
+                        context.secrets.get('callbackToken'),
+                        context.secrets.get('encodingAesKey'),
+                    ]);
+                    if (typeof corpId !== 'string')
+                        throw new TypeError('corpId must be a declared string');
+                    if (typeof agentId !== 'string')
+                        throw new TypeError('agentId must be a declared string');
+                    if (typeof agentSecret !== 'string')
+                        throw new TypeError('agentSecret must be a declared secret');
+                    if (typeof callbackToken !== 'string')
+                        throw new TypeError('callbackToken must be a declared secret');
+                    if (typeof encodingAesKey !== 'string')
+                        throw new TypeError('encodingAesKey must be a declared secret');
+                    runtime = createRuntime({
+                        config: { corpId, agentId, agentSecret, callbackToken, encodingAesKey },
+                        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.downloadMedia(locator.platformKey));
+                return {
+                    configRefresh: configure,
+                    streams: mediaSource,
+                    actions: {
+                        'wecom-agent.outbound': defineDeliveryAction(async (candidate) => {
+                            if (candidate.kind === 'execution_status') {
+                                return { deliveryId: candidate.deliveryId };
+                            }
+                            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', 'WeCom agent 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('WeCom agent outbound delivery failed for all bindings (provider did not report an error)');
+                            }
+                            return { deliveryId: candidate.deliveryId };
+                        }),
+                        'wecom-agent.webhook': async (candidate) => webhookHttpResponse(await runtime.handleWebhook(forwardedWebhookInput(candidate))),
+                    },
+                    dispose: () => runtime.stop(),
+                };
+            },
+        },
+    }));
+}
+export default createWeComAgentPluginModule();
+//# sourceMappingURL=plugin-entrypoint.js.map