@krischoichoi/channel-weixin 0.6.0

package/lib/ilink/types.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Classification: C — duplicate protocol wire types [@deprecated upstream-gap].
+ *
+ * iLink message / media / QR wire shapes self-maintained. The official
+ * @tencent-weixin/openclaw-weixin has equivalent internal enums and types, but
+ * its package is OpenClaw-coupled. These are therefore DSH-side structural
+ * mirrors used by the mapper and send paths, kept as an explicit upstream-gap
+ * until Tencent exports a host-neutral API.
+ */
+/**
+ * Tencent Weixin iLink wire types.
+ *
+ * Ported from the upstream Tencent/openclaw-weixin proto mirror. Bytes fields
+ * (context buffer, media AES keys) are base64 strings in JSON.
+ */
+import type { ChannelId } from '@krischoichoi/channel-core';
+/** Common request metadata attached to every iLink CGI request. */
+export interface ILinkBaseInfo {
+    channel_version?: string;
+    /** Self-declared identity of the bot/app, UA-style `Name/Version`. */
+    bot_agent?: string;
+}
+/** Enum values for `message_type`. */
+export declare const MESSAGE_TYPE_USER = 1;
+export declare const MESSAGE_TYPE_BOT = 2;
+/** Enum values for `message_state`. */
+export declare const MESSAGE_STATE_NEW = 0;
+export declare const MESSAGE_STATE_GENERATING = 1;
+export declare const MESSAGE_STATE_FINISH = 2;
+/** Enum values for `item_list[*].type`. */
+export declare const MESSAGE_ITEM_TYPE_NONE = 0;
+export declare const MESSAGE_ITEM_TYPE_TEXT = 1;
+export declare const MESSAGE_ITEM_TYPE_IMAGE = 2;
+export declare const MESSAGE_ITEM_TYPE_VOICE = 3;
+export declare const MESSAGE_ITEM_TYPE_FILE = 4;
+export declare const MESSAGE_ITEM_TYPE_VIDEO = 5;
+/** CDN media reference; Tencent outbound uses base64 of the ASCII hex AES key. */
+export interface ILinkCDNMedia {
+    /** Encrypted download query parameter for the CDN URL. */
+    encrypt_query_param?: string;
+    /** Base64 key payload (32-char ASCII hex for Tencent 2.4.6 outbound). */
+    aes_key?: string;
+    /** 0 = only file id encrypted, 1 = thumbnail/mid image info packaged. */
+    encrypt_type?: number;
+    /** Full download URL (server-returned). */
+    full_url?: string;
+}
+export interface ILinkTextItem {
+    text?: string;
+}
+export interface ILinkImageItem {
+    media?: ILinkCDNMedia;
+    thumb_media?: ILinkCDNMedia;
+    /** Raw AES-128 key as hex string (16 bytes); preferred for inbound decryption. */
+    aeskey?: string;
+    url?: string;
+    mid_size?: number;
+    thumb_size?: number;
+}
+export interface ILinkVoiceItem {
+    media?: ILinkCDNMedia;
+    /** 1=pcm 2=adpcm 3=feature 4=speex 5=amr 6=silk 7=mp3 8=ogg-speex. */
+    encode_type?: number;
+    bits_per_sample?: number;
+    sample_rate?: number;
+    /** Voice length in ms. */
+    playtime?: number;
+    /** Voice transcription text. */
+    text?: string;
+}
+export interface ILinkFileItem {
+    media?: ILinkCDNMedia;
+    file_name?: string;
+    md5?: string;
+    len?: string;
+}
+export interface ILinkVideoItem {
+    media?: ILinkCDNMedia;
+    video_size?: number;
+    play_length?: number;
+    video_md5?: string;
+    thumb_media?: ILinkCDNMedia;
+    thumb_size?: number;
+}
+export interface ILinkRefMessage {
+    message_item?: ILinkMessageItem;
+    title?: string;
+}
+/** One item inside `item_list`. */
+export interface ILinkMessageItem {
+    type?: number;
+    create_time_ms?: number;
+    update_time_ms?: number;
+    is_completed?: boolean;
+    msg_id?: string;
+    ref_msg?: ILinkRefMessage;
+    text_item?: ILinkTextItem;
+    image_item?: ILinkImageItem;
+    voice_item?: ILinkVoiceItem;
+    file_item?: ILinkFileItem;
+    video_item?: ILinkVideoItem;
+    tool_call_start_item?: {
+        tool_name?: string;
+        tool_call_id?: string;
+    };
+    tool_call_result_item?: {
+        tool_name?: string;
+        tool_call_id?: string;
+        status?: string;
+    };
+}
+/** Unified inbound message delivered by `getUpdates`. */
+export interface ILinkMessage {
+    seq?: number;
+    message_id?: number;
+    from_user_id?: string;
+    to_user_id?: string;
+    client_id?: string;
+    create_time_ms?: number;
+    update_time_ms?: number;
+    session_id?: string;
+    group_id?: string;
+    message_type?: number;
+    message_state?: number;
+    item_list?: ILinkMessageItem[];
+    context_token?: string;
+    run_id?: string;
+}
+/** `getUpdates` request body. */
+export interface ILinkGetUpdatesRequest {
+    /** Full context buffer cached locally; send `''` when none. */
+    get_updates_buf?: string;
+    base_info: ILinkBaseInfo;
+}
+/** `getUpdates` response. */
+export interface ILinkGetUpdatesResponse {
+    ret?: number;
+    /** Server error code (e.g. -14 = session stale token). */
+    errcode?: number;
+    errmsg?: string;
+    msgs?: ILinkMessage[];
+    /** Full context buffer to cache locally and send on the next request. */
+    get_updates_buf?: string;
+    /** Server-suggested timeout (ms) for the next getUpdates long-poll. */
+    longpolling_timeout_ms?: number;
+}
+/** `sendmessage` request wrapping a single message. */
+export interface ILinkSendMessageRequest {
+    msg?: ILinkMessage;
+    base_info?: ILinkBaseInfo;
+}
+export interface ILinkSendMessageResponse {
+    ret?: number;
+    errmsg?: string;
+}
+/** `getconfig` request+response. */
+export interface ILinkGetConfigRequest {
+    ilink_user_id?: string;
+    context_token?: string;
+    base_info?: ILinkBaseInfo;
+}
+export interface ILinkGetConfigResponse {
+    ret?: number;
+    errmsg?: string;
+    /** Base64-encoded typing ticket for `sendtyping`. */
+    typing_ticket?: string;
+}
+/**
+ * Typing status sent to `sendtyping`:
+ * 1 = typing (default), 2 = cancel typing.
+ */
+export declare const TYPING_STATUS_TYPING = 1;
+export declare const TYPING_STATUS_CANCEL = 2;
+export interface ILinkSendTypingRequest {
+    ilink_user_id?: string;
+    typing_ticket?: string;
+    status?: number;
+    base_info?: ILinkBaseInfo;
+}
+export interface ILinkSendTypingResponse {
+    ret?: number;
+    errmsg?: string;
+}
+/** `get_bot_qrcode` response. */
+export interface ILinkQrCodeResponse {
+    qrcode: string;
+    qrcode_img_content: string;
+}
+/** QR login status state machine (full upstream fidelity kept). */
+export type ILinkQrStatus = 'wait' | 'scaned' | 'confirmed' | 'expired' | 'need_verifycode' | 'verify_code_blocked' | 'scaned_but_redirect' | 'binded_redirect';
+/** `get_qrcode_status` response. */
+export interface ILinkQrStatusResponse {
+    status?: ILinkQrStatus;
+    /** Bot token issued on `confirmed`. NEVER logged. */
+    bot_token?: string;
+    /** Remote bot identity issued on `confirmed`. */
+    ilink_bot_id?: string;
+    /** Effective API base URL on `confirmed`. */
+    baseurl?: string;
+    /** Weixin user id of the person who scanned. */
+    ilink_user_id?: string;
+    /** New host to redirect polling to on `scaned_but_redirect`. */
+    redirect_host?: string;
+}
+/** `getuploadurl` request/response (WX5 media scaffold). */
+export interface ILinkGetUploadUrlRequest {
+    filekey?: string;
+    media_type?: number;
+    to_user_id?: string;
+    rawsize?: number;
+    rawfilemd5?: string;
+    filesize?: number;
+    thumb_rawsize?: number;
+    thumb_rawfilemd5?: string;
+    thumb_filesize?: number;
+    no_need_thumb?: boolean;
+    aeskey?: string;
+    base_info?: ILinkBaseInfo;
+}
+export interface ILinkGetUploadUrlResponse {
+    upload_param?: string;
+    thumb_upload_param?: string;
+    upload_full_url?: string;
+}
+/** Notify lifecycle responses. */
+export interface ILinkNotifyResponse {
+    ret?: number;
+    errmsg?: string;
+}
+/** Inbound metadata attached when mapping an iLink message. */
+export interface WeixinInboundMeta {
+    channel: ChannelId;
+    accountId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/ilink/types.d.ts.map

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

package/lib/ilink/types.js

@@ -0,0 +1,21 @@
+/** Enum values for `message_type`. */
+export const MESSAGE_TYPE_USER = 1;
+export const MESSAGE_TYPE_BOT = 2;
+/** Enum values for `message_state`. */
+export const MESSAGE_STATE_NEW = 0;
+export const MESSAGE_STATE_GENERATING = 1;
+export const MESSAGE_STATE_FINISH = 2;
+/** Enum values for `item_list[*].type`. */
+export const MESSAGE_ITEM_TYPE_NONE = 0;
+export const MESSAGE_ITEM_TYPE_TEXT = 1;
+export const MESSAGE_ITEM_TYPE_IMAGE = 2;
+export const MESSAGE_ITEM_TYPE_VOICE = 3;
+export const MESSAGE_ITEM_TYPE_FILE = 4;
+export const MESSAGE_ITEM_TYPE_VIDEO = 5;
+/**
+ * Typing status sent to `sendtyping`:
+ * 1 = typing (default), 2 = cancel typing.
+ */
+export const TYPING_STATUS_TYPING = 1;
+export const TYPING_STATUS_CANCEL = 2;
+//# sourceMappingURL=types.js.map

package/lib/ilink/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ilink/types.ts"],"names":[],"mappings":"AAwBA,sCAAsC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,uCAAuC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AA6IzC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @krischoichoi/channel-weixin — direct Tencent Weixin iLink channel adapter.
+ *
+ * Replaces the old self-hosted HTTP gateway client with a direct iLink client
+ * (QR login, getUpdates long-poll, sendmessage). Streaming is `buffered`.
+ */
+import { type Context } from '@deepseek-ai/cordis';
+import type { WeixinConfig, WeixinConfigLive } from './config.js';
+import { Config } from './config.js';
+import { type WeixinAdapterDeps } from './adapter.js';
+export declare const name = "channel-weixin";
+export declare const inject: string[];
+export { Config };
+export type { WeixinConfigLive } from './config.js';
+export { WeixinAdapter, type WeixinAdapterDeps } from './adapter.js';
+export { createWeixinDefinition, type WeixinDefinitionOptions, } from './definition.js';
+export { ILinkClient, type ILinkClientOptions } from './ilink/client.js';
+export { buildHeaders, buildWechatUin, encodeClientVersion, clientVersionFromString, type BuildHeadersOptions, } from './ilink/headers.js';
+export { buildBaseInfo } from './ilink/base-info.js';
+export { ILinkError, StaleTokenError, ILinkTimeoutError, ILinkAbortError, ILinkSendError, redactMessage, normalizeILinkError, } from './ilink/errors.js';
+export { WeixinQrAuth, toChannelState, type WeixinQrAuthInternalState, } from './auth/login.js';
+export { AccountCredentialStore, redactCredential, type WeixinAccountCredential, } from './auth/account-store.js';
+export { SyncCursorStore } from './storage/sync-cursor.js';
+export { ContextTokenStore } from './storage/context-token.js';
+export { MemoryDedupStore, PersistentDedupStore, dedupKey, stableHash, type DedupStore, type DedupRecord, type DedupOptions, } from './messaging/dedup.js';
+export { mapInbound, mapItem } from './messaging/mapper.js';
+export { WeixinMonitor, CursorCommitError, type WeixinMonitorOptions } from './messaging/monitor.js';
+export { OutboundSender, buildSendTextPayload, type OutboundSenderOptions } from './messaging/send.js';
+export { TypingController, type TypingControllerOptions } from './messaging/typing.js';
+export { formatQuotedContext } from './messaging/quote.js';
+export { transcodeSilkVoice, SILK_ENCODE_TYPE, DEFAULT_SILK_SAMPLE_RATE, type SilkTranscodeOptions, type SilkTranscodeResult, } from './media/silk-transcode.js';
+export { WeixinConfigManager, type WeixinConfigManagerOptions } from './upstream/config-manager.js';
+export { FetchTransport, type HttpTransport, type HttpRequestInit } from './transport.js';
+export { manifest, type WeixinManifest } from './manifest.js';
+export { createWeixinUpstream, TencentWeixinUpstream, UpstreamCapabilityError, type WeixinUpstream, type WeixinUpstreamHostEnv, type WeixinQrTicket, type WeixinQrAuthPoll, type WeixinAuthCredential, type WeixinMediaRef, type WeixinDownloadResult, type WeixinTextParams, type WeixinImageParams, type WeixinFileParams, type WeixinVideoParams, type WeixinSendResult, } from './upstream/index.js';
+export { aes128Decrypt } from './media/decrypt.js';
+export { aes128Encrypt } from './media/encrypt.js';
+export { downloadMedia, resolveDownloadUrl, type DownloadedMedia, type DownloadMediaOptions, } from './media/download.js';
+export { uploadMedia, buildUploadUrlRequest, aesEcbPaddedSize, WX5_MEDIA_TYPE_IMAGE, WX5_MEDIA_TYPE_VIDEO, WX5_MEDIA_TYPE_FILE, WX5_MEDIA_TYPE_VOICE, type UploadedMedia, type UploadMediaOptions, } from './media/upload.js';
+export { sendMedia, buildSendMediaPayload, type SendMediaOptions, } from './media/send-media.js';
+export type { ILinkBaseInfo, ILinkCDNMedia, ILinkMessage, ILinkMessageItem, ILinkGetUpdatesRequest, ILinkGetUpdatesResponse, ILinkSendMessageRequest, ILinkSendMessageResponse, ILinkQrCodeResponse, ILinkQrStatus, ILinkQrStatusResponse, ILinkGetConfigRequest, ILinkGetConfigResponse, ILinkGetUploadUrlRequest, ILinkGetUploadUrlResponse, ILinkSendTypingRequest, ILinkSendTypingResponse, ILinkNotifyResponse, WeixinInboundMeta, } from './ilink/types.js';
+/**
+ * Entry plugin apply. Accepts both the activation-time live shape (volatile
+ * fields resolve to `Volatile<T>` handles under Harness 0.2.0) and a plain
+ * snapshot (tests / programmatic mounting); plain fields pass through
+ * `resolveVolatileConfig` untouched. The shape is validated by Schemastery at
+ * the Loader boundary via the attached `Config` schema.
+ */
+export declare function apply(ctx: Context, rawConfig: WeixinConfig | WeixinConfigLive, deps?: WeixinAdapterDeps): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

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

package/lib/index.js

@@ -0,0 +1,91 @@
+/**
+ * @krischoichoi/channel-weixin — direct Tencent Weixin iLink channel adapter.
+ *
+ * Replaces the old self-hosted HTTP gateway client with a direct iLink client
+ * (QR login, getUpdates long-poll, sendmessage). Streaming is `buffered`.
+ */
+import {} from '@deepseek-ai/cordis';
+import { mountChannelAdapter, resolveVolatileConfig, resolveVolatileValue } from '@krischoichoi/channel-core';
+import { Config } from './config.js';
+import { WeixinAdapter } from './adapter.js';
+import { createWeixinDefinition } from './definition.js';
+import { AccountCredentialStore } from './auth/account-store.js';
+export const name = 'channel-weixin';
+export const inject = ['channels'];
+// Adapter mounting uses the shared transactional `mountChannelAdapter`
+// from @krischoichoi/channel-core (doc section 5): register -> start; on start error
+// abort + best-effort stop + unregister + rethrow; on unload abort + stop + unregister.
+export { Config };
+export { WeixinAdapter } from './adapter.js';
+export { createWeixinDefinition, } from './definition.js';
+export { ILinkClient } from './ilink/client.js';
+export { buildHeaders, buildWechatUin, encodeClientVersion, clientVersionFromString, } from './ilink/headers.js';
+export { buildBaseInfo } from './ilink/base-info.js';
+export { ILinkError, StaleTokenError, ILinkTimeoutError, ILinkAbortError, ILinkSendError, redactMessage, normalizeILinkError, } from './ilink/errors.js';
+export { WeixinQrAuth, toChannelState, } from './auth/login.js';
+export { AccountCredentialStore, redactCredential, } from './auth/account-store.js';
+export { SyncCursorStore } from './storage/sync-cursor.js';
+export { ContextTokenStore } from './storage/context-token.js';
+export { MemoryDedupStore, PersistentDedupStore, dedupKey, stableHash, } from './messaging/dedup.js';
+export { mapInbound, mapItem } from './messaging/mapper.js';
+export { WeixinMonitor, CursorCommitError } from './messaging/monitor.js';
+export { OutboundSender, buildSendTextPayload } from './messaging/send.js';
+export { TypingController } from './messaging/typing.js';
+export { formatQuotedContext } from './messaging/quote.js';
+export { transcodeSilkVoice, SILK_ENCODE_TYPE, DEFAULT_SILK_SAMPLE_RATE, } from './media/silk-transcode.js';
+export { WeixinConfigManager } from './upstream/config-manager.js';
+export { FetchTransport } from './transport.js';
+export { manifest } from './manifest.js';
+export { createWeixinUpstream, TencentWeixinUpstream, UpstreamCapabilityError, } from './upstream/index.js';
+// WX5 media.
+export { aes128Decrypt } from './media/decrypt.js';
+export { aes128Encrypt } from './media/encrypt.js';
+export { downloadMedia, resolveDownloadUrl, } from './media/download.js';
+export { uploadMedia, buildUploadUrlRequest, aesEcbPaddedSize, WX5_MEDIA_TYPE_IMAGE, WX5_MEDIA_TYPE_VIDEO, WX5_MEDIA_TYPE_FILE, WX5_MEDIA_TYPE_VOICE, } from './media/upload.js';
+export { sendMedia, buildSendMediaPayload, } from './media/send-media.js';
+/**
+ * Entry plugin apply. Accepts both the activation-time live shape (volatile
+ * fields resolve to `Volatile<T>` handles under Harness 0.2.0) and a plain
+ * snapshot (tests / programmatic mounting); plain fields pass through
+ * `resolveVolatileConfig` untouched. The shape is validated by Schemastery at
+ * the Loader boundary via the attached `Config` schema.
+ */
+export function apply(ctx, rawConfig, deps = {}) {
+    const config = resolveVolatileConfig(rawConfig);
+    const control = ctx.get('channelControl');
+    if (control) {
+        // Control-plane entry (doc §43): register the definition EVEN when
+        // disabled — the control plane auto-starts it (autoStart) and a disabled
+        // definition must stay visible so the Web control plane can re-enable it
+        // later (doc §19/§20). The M1 QR flow is driven through the mounted adapter.
+        const settings = ctx.get('settings');
+        // Weixin owner auto-discovery: the control plane never reads
+        // weixin credential storage; a closure here maps the stored scanning
+        // user's canonical id out of the platform's own AccountCredentialStore.
+        const resolveOwnerIdentity = async (accountId) => {
+            const store = new AccountCredentialStore({
+                secrets: ctx.channels.resources.secrets,
+                storage: ctx.channels.resources.storage,
+                accountId,
+            });
+            const credential = await store.load();
+            return credential?.userId;
+        };
+        control.definitions.register(createWeixinDefinition({
+            config,
+            deps,
+            getAdapter: () => control.runtime?.adapter('weixin'),
+            persistEnabled: (enabled) => settings?.update('channels-weixin', { enabled }) ?? Promise.resolve(),
+            resolveOwnerIdentity,
+        }));
+        return;
+    }
+    // Legacy headless/standalone path (no channel-control): mount as today.
+    // There is no directory/control surface to re-enable a disabled channel, so
+    // the config `enabled` gate still applies (doc §20).
+    if (!resolveVolatileValue(config.enabled))
+        return;
+    const adapter = new WeixinAdapter(config, deps);
+    mountChannelAdapter(ctx, adapter, (signal) => ctx.channels.createAdapterContext({ channelId: 'weixin', signal }));
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/manifest.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Upstream strategy, per plan §39:
+ *   'official-sdk'                  — consume the official SDK as-is.
+ *   'official-host-neutral-subpath' — consume official host-neutral primitives
+ *                                     via a single vendor-compat deep-import
+ *                                     boundary; composed orchestration stays a
+ *                                     thin shim (upstream-gap).
+ *   'minimal-official-api-port'     — only the minimum official API ported.
+ */
+export type UpstreamStrategy = 'official-sdk' | 'official-host-neutral-subpath' | 'minimal-official-api-port' | 'source-port';
+export interface WeixinUpstreamManifest {
+    reference: string;
+    /**
+     * Exact upstream version the adapter was verified against. The 'pending'
+     * placeholder is filled ONLY after the live platform gate passes (real
+     * Weixin iLink live verification); before then it must stay pending.
+     */
+    testedVersion: string;
+    /**
+     * Exact Tencent/openclaw-weixin commit SHA the adapter was verified against.
+     * Filled ONLY after the live gate passes (same live-verification rule).
+     */
+    testedCommit?: string;
+    /**
+     * Range of upstream versions supported. Currently '*', which must NOT be kept
+     * long-term: after live verification, pin the verified commit/range here.
+     */
+    versionRange: string;
+    strategy: UpstreamStrategy;
+    protocol: 'weixin-ilink';
+    /** Official npm package that provides the protocol (plan §39). */
+    packageName: string;
+    /** npm package source repository (plan §39). */
+    sourceRepository: string;
+    /** Contract fixtures directory (plan §39). */
+    contractFixtures: readonly string[];
+}
+export interface WeixinManifest {
+    id: 'weixin';
+    adapterVersion: string;
+    upstream: WeixinUpstreamManifest;
+    sdk: undefined;
+    /**
+     * Compatibility state of this adapter against the real Weixin iLink platform.
+     *
+     * - 'experimental': default BEFORE the live platform gate passes — real-Weixin
+     *   live verification is still pending, so claiming 'tested' would be false.
+     * - 'tested': only after the live gate passes and the real values are recorded
+     *   in `upstream.testedVersion` / `upstream.testedCommit`.
+     */
+    status: 'experimental' | 'tested';
+}
+export declare const manifest: WeixinManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/lib/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,+BAA+B,GAC/B,2BAA2B,GAC3B,aAAa,CAAC;AAElB,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,QAAQ,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,GAAG,EAAE,SAAS,CAAC;IACf;;;;;;;OAOG;IACH,MAAM,EAAE,cAAc,GAAG,QAAQ,CAAC;CACnC;AAED,eAAO,MAAM,QAAQ,EAAE,cAqBtB,CAAC"}

package/lib/manifest.js

@@ -0,0 +1,32 @@
+/**
+ * Weixin upstream compatibility manifest (doc section 35 + plan §39).
+ *
+ * Structural shape matched to `AdapterManifest` so `channels doctor` and the
+ * channel-compat governance read it without a package dependency. Tencent's
+ * published plugin is OpenClaw-coupled, so this adapter is an explicit
+ * source-port/upstream-gap until Tencent publishes a host-neutral package.
+ */
+import pkg from '../package.json' with { type: 'json' };
+export const manifest = {
+    id: 'weixin',
+    adapterVersion: pkg.version,
+    upstream: {
+        reference: 'Tencent/openclaw-weixin (source reference; OpenClaw-coupled upstream-gap)',
+        // Exact pinned upstream package version consumed via vendor-compat (plan §17/§39).
+        testedVersion: '<pending-live-verification>',
+        // Placeholder — filled ONLY after the live platform gate passes (see doc R6).
+        testedCommit: '<pending-live-verification>',
+        // NOTE: must be pinned to the verified commit/range after live verification —
+        // do NOT keep versionRange: '*' long-term (doc R6 "不要保留 versionRange: '*' 长期").
+        versionRange: '*',
+        strategy: 'source-port',
+        protocol: 'weixin-ilink',
+        // (plan §39) official upstream contract.
+        packageName: '@tencent-weixin/openclaw-weixin',
+        sourceRepository: 'Tencent/openclaw-weixin',
+        contractFixtures: ['fixtures/upstream/weixin/2.4.6/'],
+    },
+    sdk: undefined,
+    status: 'experimental',
+};
+//# sourceMappingURL=manifest.js.map

package/lib/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AA6DxD,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACtC,EAAE,EAAE,QAAQ;IACZ,cAAc,EAAE,GAAG,CAAC,OAAO;IAC3B,QAAQ,EAAE;QACR,SAAS,EAAE,2EAA2E;QACtF,mFAAmF;QACnF,aAAa,EAAE,6BAA6B;QAC5C,8EAA8E;QAC9E,YAAY,EAAE,6BAA6B;QAC3C,8EAA8E;QAC9E,gFAAgF;QAChF,YAAY,EAAE,GAAG;QACjB,QAAQ,EAAE,aAAa;QACvB,QAAQ,EAAE,cAAc;QACxB,yCAAyC;QACzC,WAAW,EAAE,iCAAiC;QAC9C,gBAAgB,EAAE,yBAAyB;QAC3C,gBAAgB,EAAE,CAAC,iCAAiC,CAAC;KACtD;IACD,GAAG,EAAE,SAAS;IACd,MAAM,EAAE,cAAc;CACvB,CAAC"}

package/lib/media/decrypt.d.ts

@@ -0,0 +1,3 @@
+/** AES-128-ECB decrypt (PKCS#7 padding). `key` may be 16 raw bytes or hex. */
+export declare function aes128Decrypt(ciphertext: Buffer, key: Buffer | string): Buffer;
+//# sourceMappingURL=decrypt.d.ts.map

package/lib/media/decrypt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decrypt.d.ts","sourceRoot":"","sources":["../../src/media/decrypt.ts"],"names":[],"mappings":"AAQA,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAK9E"}

package/lib/media/decrypt.js

@@ -0,0 +1,16 @@
+/**
+ * WX5 media — AES-128-ECB decrypt.
+ *
+ * Tencent's published plugin is OpenClaw-coupled and cannot be used as a DSH
+ * runtime dependency. This small source-port intentionally uses Node crypto.
+ */
+import { createDecipheriv } from 'node:crypto';
+/** AES-128-ECB decrypt (PKCS#7 padding). `key` may be 16 raw bytes or hex. */
+export function aes128Decrypt(ciphertext, key) {
+    const keyBuf = typeof key === 'string' ? Buffer.from(key, 'hex') : key;
+    if (keyBuf.length !== 16)
+        throw new Error('aes128Decrypt: AES-128 key must be 16 bytes');
+    const decipher = createDecipheriv('aes-128-ecb', keyBuf, null);
+    return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+}
+//# sourceMappingURL=decrypt.js.map

package/lib/media/decrypt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decrypt.js","sourceRoot":"","sources":["../../src/media/decrypt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,GAAoB;IACpE,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACvE,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACzF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/lib/media/download.d.ts

@@ -0,0 +1,22 @@
+import type { ILinkCDNMedia } from '../ilink/types.js';
+export interface DownloadedMedia {
+    /** Decrypted plaintext bytes. */
+    data: Buffer;
+    mimeType?: string;
+}
+export interface DownloadMediaOptions {
+    cdnBaseUrl: string;
+    /** Optional AES-128 key (hex, 16 bytes) to decrypt after download. */
+    aesKey?: string;
+    /** Optional base64 AES key from the CDN media reference. */
+    aesKeyBase64?: string;
+    /** Optional MIME type (known from item metadata). */
+    mimeType?: string;
+    /** Injectable fetch for tests; defaults to globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+}
+/** Resolve the CDN download URL for a media reference. */
+export declare function resolveDownloadUrl(media: ILinkCDNMedia, cdnBaseUrl: string): string | undefined;
+/** Download an iLink CDN media reference and AES-decrypt the body. */
+export declare function downloadMedia(media: ILinkCDNMedia, opts: DownloadMediaOptions): Promise<DownloadedMedia>;
+//# sourceMappingURL=download.d.ts.map

package/lib/media/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/media/download.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK/F;AAED,sEAAsE;AACtE,wBAAsB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgB9G"}

package/lib/media/download.js

@@ -0,0 +1,62 @@
+/**
+ * Classification: C — duplicate media download orchestration [@deprecated upstream-gap].
+ *
+ * CDN download + AES decrypt for inbound media. The official composed flow
+ * cdn/pic-decrypt.js is OpenClaw coupled (imports util/logger). The developer
+ * AES remains a small local source-port because the Tencent plugin is coupled
+ * to OpenClaw. The URL
+ * resolution here (legacy <cdnBaseUrl>/<encrypt_query_param>) is DSH glue kept
+ * for the verified CDN path (official buildCdnDownloadUrl uses a different URL
+ * form). Marked upstream-gap for the orchestration; DO NOT delete wholesale.
+ */
+/**
+ * WX5 media — CDN download (WX5.1 Image).
+ *
+ * Resolves the download URL from `full_url` (server-returned) or the CDN base
+ * URL + `encrypt_query_param`, fetches the raw body, then AES-128-ECB decrypts
+ * it. The AES key source is resolved in priority order:
+ *   1. `aesKey`      — hex (16 bytes) as surfaced on the message item
+ *                      (`image_item.aeskey`); preferred per the wire comment.
+ *   2. `media.aes_key` — base64-encoded bytes (JSON transport convention).
+ */
+import { aes128Decrypt } from './decrypt.js';
+/** Resolve the CDN download URL for a media reference. */
+export function resolveDownloadUrl(media, cdnBaseUrl) {
+    if (media.full_url)
+        return media.full_url;
+    const base = cdnBaseUrl.replace(/\/+$/, '');
+    if (media.encrypt_query_param)
+        return `${base}/${media.encrypt_query_param}`;
+    return undefined;
+}
+/** Download an iLink CDN media reference and AES-decrypt the body. */
+export async function downloadMedia(media, opts) {
+    const url = resolveDownloadUrl(media, opts.cdnBaseUrl);
+    if (!url) {
+        throw new Error('downloadMedia: no full_url or encrypt_query_param to resolve a CDN URL');
+    }
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new Error(`downloadMedia: http ${response.status} on CDN url`);
+    }
+    const body = Buffer.from(await response.arrayBuffer());
+    const key = opts.aesKey ?? opts.aesKeyBase64 ?? media.aes_key ? decodeAesKey(opts, media) : undefined;
+    if (!key) {
+        return { data: body, mimeType: opts.mimeType };
+    }
+    return { data: aes128Decrypt(body, key), mimeType: opts.mimeType };
+}
+/**
+ * Decode the AES key honoring the two wire forms: hex (item `aeskey`) and
+ * base64 (CDN `aes_key`). `aesKey` (hex) is preferred when present.
+ */
+function decodeAesKey(opts, media) {
+    if (opts.aesKey)
+        return opts.aesKey;
+    const base64 = opts.aesKeyBase64 ?? media.aes_key;
+    if (base64)
+        return Buffer.from(base64, 'base64');
+    throw new Error('downloadMedia: no AES key to decrypt');
+}
+//# sourceMappingURL=download.js.map