@krischoichoi/channel-qq 0.6.0

package/lib/definition.d.ts

@@ -0,0 +1,75 @@
+/**
+ * QQ ChannelDefinition for the universal Channel Control Plane (doc §14–§18,
+ * §29–§33, §47).
+ *
+ * Implements the shared `ChannelDefinition` contract so the control plane
+ * drives setup / configured-state / config-save / instantiation for QQ purely
+ * through this interface. The existing `appSecretRef` credential design is
+ * kept: config only carries the reference name; the real AppSecret is resolved
+ * through the injected credential seam at createAdapter() time and never
+ * enters config, logs or errors (QQ-R5).
+ *
+ * The definition is fully offline-testable: it depends only on the injected
+ * structural credential seam and the `QQAdapterDeps` seam (tests inject the
+ * `FakeQQSdkClient`).
+ *
+ * QQ Bot setup uses the official AppID/AppSecret flow. Optional CLI onboarding
+ * in the upstream plugin is outside this channel Web control-plane contract.
+ */
+import type { ChannelDefinition } from '@krischoichoi/channel-control';
+import type { QQConfig } from './config.js';
+import { type QQAdapterDeps } from './adapter.js';
+/**
+ * Structural credential seam the definition uses (mirrors channel-control's
+ * credentials/manager.ts). Deliberately NOT an import of `@deepseek-ai/dsh-credentials`
+ * — the definition is adapter-agnostic and the concrete provider is injected.
+ */
+export interface CredentialSeam {
+    resolve(ref: string): Promise<{
+        value: string;
+        source: string;
+    } | undefined>;
+    describe(ref: string): Promise<{
+        configured: boolean;
+        source?: string;
+        writable: boolean;
+    }>;
+    set(ref: string, value: string): Promise<void>;
+    unset(ref: string): Promise<void>;
+}
+/** Options for building the QQ definition. */
+export interface QQDefinitionOptions {
+    config: QQConfig;
+    /** Adapter construction deps (e.g. an injected `FakeQQSdkClient` in tests). */
+    deps: QQAdapterDeps;
+    /** The credential seam used to resolve/describe `appSecretRef`. */
+    credentials: CredentialSeam;
+    /** Durable store for the non-secret setup field when the host provides one. */
+    persistSetup?: (patch: Pick<QQConfig, 'appId'>) => Promise<void>;
+    /** Durable store for the enabled intent (doc §21) when the host provides one. */
+    persistEnabled?: (enabled: boolean) => Promise<void>;
+    /** Durable canonical owner identity learned from a platform-delivered C2C. */
+    resolveOwnerIdentity?: (accountId: string, appId: string) => Promise<string | undefined>;
+    persistOwnerIdentity?: (ownerId: string, accountId: string, appId: string) => Promise<void>;
+}
+/**
+ * Official QQ bot console — one-step entry straight to the QQ openclaw bot page
+ * (not the q.qq.com homepage). When the bot's appId is known the link deep-links
+ * to that bot (`?appid=`), mirroring the openclaw-toolkit desktop console.
+ */
+export declare const QQ_OPEN_PLATFORM_URL = "https://q.qq.com/qqbot/openclaw/";
+export declare function qqConsoleUrl(appId: string | undefined): string;
+/**
+ * Opaque, non-secret directory scope for one QQ AppID. It partitions observed
+ * group_openid identities when an operator replaces the Bot AppID while
+ * keeping the same local channel account. The value is never sent to the Web
+ * and never participates in ACL authorization.
+ */
+export declare function qqConversationScopeFingerprint(appId: string): string | undefined;
+/**
+ * Build the QQ `ChannelDefinition`. The returned definition reads from a
+ * mutable internal config snapshot (updated by saveConfig) so persisted patches
+ * are reflected by createAdapter() and getConfiguredState().
+ */
+export declare function createQQDefinition(options: QQDefinitionOptions): ChannelDefinition;
+//# sourceMappingURL=definition.d.ts.map

package/lib/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAEV,iBAAiB,EAIlB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;IAC7E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5F,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,QAAQ,CAAC;IACjB,+EAA+E;IAC/E,IAAI,EAAE,aAAa,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,cAAc,CAAC;IAC5B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,iFAAiF;IACjF,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzF,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7F;AAgCD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qCAAqC,CAAC;AAEvE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIhF;AAwCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,iBAAiB,CAiJlF"}

package/lib/definition.js

@@ -0,0 +1,232 @@
+import { ControlError } from '@krischoichoi/channel-control';
+import { createHash } from 'node:crypto';
+import { QQ_APP_SECRET_REF } from './config.js';
+import { QQAdapter } from './adapter.js';
+import { resolveVolatileConfig } from '@krischoichoi/channel-core';
+/**
+ * Non-secret config keys saveConfig() applies onto the internal config snapshot.
+ * Mirrors QQConfig but omits `enabled` / `appSecretRef` (the reference is
+ * wired at construction and never rewritten via saveConfig). Unknown keys in a
+ * patch are ignored — the control plane already rejects secret keys before the
+ * definition is reached (SECRET_FIELD_REJECTED).
+ */
+const SAVABLE_KEYS = [
+    'appId',
+    'markdownSupport',
+    'streaming',
+    'dedup',
+    'startupTimeoutMs',
+    'accountId',
+];
+/** Deep-ish clone of the mutable top-level config sub-objects. */
+function cloneSnapshot(config) {
+    // Harness 0.2.0: volatile fields arrive as `Volatile<T>` handles; unwrap
+    // them once so the snapshot (and everything reading it) sees plain values.
+    const plain = resolveVolatileConfig(config);
+    return {
+        ...plain,
+        streaming: { ...plain.streaming },
+        dedup: { ...plain.dedup },
+    };
+}
+/**
+ * Official QQ bot console — one-step entry straight to the QQ openclaw bot page
+ * (not the q.qq.com homepage). When the bot's appId is known the link deep-links
+ * to that bot (`?appid=`), mirroring the openclaw-toolkit desktop console.
+ */
+export const QQ_OPEN_PLATFORM_URL = 'https://q.qq.com/qqbot/openclaw/';
+export function qqConsoleUrl(appId) {
+    const id = appId?.trim();
+    return id ? `${QQ_OPEN_PLATFORM_URL}?appid=${encodeURIComponent(id)}` : QQ_OPEN_PLATFORM_URL;
+}
+/**
+ * Opaque, non-secret directory scope for one QQ AppID. It partitions observed
+ * group_openid identities when an operator replaces the Bot AppID while
+ * keeping the same local channel account. The value is never sent to the Web
+ * and never participates in ACL authorization.
+ */
+export function qqConversationScopeFingerprint(appId) {
+    const normalized = appId.trim();
+    if (!normalized)
+        return undefined;
+    return createHash('sha256').update(`qq-app:${normalized}`).digest('hex');
+}
+/** Validate + clamp one non-secret patch value onto the snapshot. */
+function applyPatch(snapshot, key, value) {
+    switch (key) {
+        case 'appId':
+            if (typeof value === 'string')
+                snapshot.appId = value;
+            return;
+        case 'markdownSupport':
+            if (typeof value === 'boolean')
+                snapshot.markdownSupport = value;
+            return;
+        case 'startupTimeoutMs':
+            if (typeof value === 'number' && Number.isFinite(value) && value > 0) {
+                snapshot.startupTimeoutMs = Math.floor(value);
+            }
+            return;
+        case 'accountId':
+            if (typeof value === 'string' && value)
+                snapshot.accountId = value;
+            return;
+        case 'streaming':
+            if (typeof value === 'object' && value !== null) {
+                const part = value;
+                if (typeof part?.enabled === 'boolean')
+                    snapshot.streaming.enabled = part.enabled;
+                if (typeof part?.throttleMs === 'number' && Number.isFinite(part.throttleMs)) {
+                    snapshot.streaming.throttleMs = Math.max(300, Math.floor(part.throttleMs));
+                }
+            }
+            return;
+        case 'dedup':
+            if (typeof value === 'object' && value !== null) {
+                const part = value;
+                if (typeof part?.enabled === 'boolean')
+                    snapshot.dedup.enabled = part.enabled;
+                if (typeof part?.windowMs === 'number' && Number.isFinite(part.windowMs)) {
+                    snapshot.dedup.windowMs = Math.max(0, Math.floor(part.windowMs));
+                }
+            }
+            return;
+    }
+}
+/**
+ * Build the QQ `ChannelDefinition`. The returned definition reads from a
+ * mutable internal config snapshot (updated by saveConfig) so persisted patches
+ * are reflected by createAdapter() and getConfiguredState().
+ */
+export function createQQDefinition(options) {
+    // Internal mutable config snapshot; saveConfig mutates it, createAdapter reads it.
+    const snapshot = cloneSnapshot(options.config);
+    const appSecretRef = snapshot.appSecretRef || QQ_APP_SECRET_REF;
+    // Static setup surface. The appSecret field's configured/writable flags are
+    // best-effort here (a synchronous property cannot await describe()); the
+    // authoritative dynamic state is reported by getConfiguredState().
+    const fields = [
+        {
+            name: 'appId',
+            kind: 'text',
+            secret: false,
+            configured: Boolean(snapshot.appId),
+            writable: true,
+        },
+        {
+            name: 'appSecret',
+            kind: 'secret',
+            secret: true,
+            configured: false,
+            writable: true,
+            ref: appSecretRef,
+        },
+    ];
+    const setup = {
+        fields,
+        authMethods: ['credentials'],
+        setupUrl: qqConsoleUrl(snapshot.appId),
+    };
+    const refreshSetup = () => {
+        setup.fields[0].configured = Boolean(snapshot.appId);
+        setup.setupUrl = qqConsoleUrl(snapshot.appId);
+    };
+    return {
+        id: 'qq',
+        get enabled() {
+            return snapshot.enabled;
+        },
+        async setEnabled(enabled) {
+            snapshot.enabled = enabled;
+            await options.persistEnabled?.(enabled);
+        },
+        setup,
+        autoStart: true,
+        // QQ platform restricts C2C private messages to the bot creator. The
+        // control plane materializes that narrow private grant; groups stay closed
+        // until the operator explicitly configures them.
+        access: {
+            directMessages: true,
+            groups: true,
+            // New QQ gateway distinguishes GROUP_AT_MESSAGE_CREATE from ordinary
+            // GROUP_MESSAGE_CREATE; the mapper publishes this as a strict boolean
+            // activation fact.
+            mentions: true,
+            // QQ platform restricts C2C to the bot creator, so the owner never
+            // claims locally; the control plane materializes that private grant.
+            ownerDiscovery: 'platform',
+            // QQ only exposes the canonical group_openid reliably. The Web lists
+            // group OpenIDs discovered from inbound events; it never asks operators
+            // to type a QQ group number or guesses an identity from one.
+            identityLabels: { user: 'QQ', group: 'QQ群' },
+            identity: {
+                conversation: {
+                    conversationDiscoverable: true,
+                },
+            },
+            defaults: { requireMention: true },
+        },
+        async getConfiguredState() {
+            const appId = Boolean(snapshot.appId);
+            let appSecret = {
+                configured: false,
+                writable: false,
+            };
+            if (appSecretRef) {
+                const described = await options.credentials.describe(appSecretRef);
+                appSecret = {
+                    configured: described.configured,
+                    writable: described.writable,
+                    source: described.source,
+                };
+            }
+            return {
+                configured: appId && appSecret.configured,
+                fields: {
+                    appId: { configured: appId, writable: true, value: snapshot.appId },
+                    appSecret: {
+                        configured: appSecret.configured,
+                        writable: appSecret.writable,
+                        source: appSecret.source,
+                    },
+                },
+            };
+        },
+        async saveConfig(patch) {
+            for (const key of Object.keys(patch)) {
+                if (SAVABLE_KEYS.includes(key)) {
+                    applyPatch(snapshot, key, patch[key]);
+                }
+                // Unknown (incl. secret) keys are ignored; the control plane already
+                // rejects secret field names before reaching the definition.
+            }
+            refreshSetup();
+            if (patch.appId !== undefined)
+                await options.persistSetup?.({ appId: snapshot.appId });
+        },
+        conversationScopeFingerprint: () => qqConversationScopeFingerprint(snapshot.appId),
+        snapshotConfig: () => cloneSnapshot(snapshot),
+        async restoreConfig(saved) {
+            const restored = cloneSnapshot(saved);
+            Object.assign(snapshot, restored);
+            snapshot.streaming = restored.streaming;
+            snapshot.dedup = restored.dedup;
+            refreshSetup();
+            await options.persistSetup?.({ appId: snapshot.appId });
+        },
+        async createAdapter() {
+            const credential = appSecretRef !== undefined ? await options.credentials.resolve(appSecretRef) : undefined;
+            if (!credential) {
+                // Stable machine-readable error; never echoes the secret, only the ref.
+                throw new ControlError('CONTROL_ERROR', `QQ credential "${appSecretRef}" is not configured`);
+            }
+            return new QQAdapter(snapshot, {
+                ...options.deps,
+                appSecret: credential.value,
+                onOwnerDiscovered: (ownerId) => options.persistOwnerIdentity?.(ownerId, snapshot.accountId, snapshot.appId),
+            });
+        },
+        resolveOwnerIdentity: async (accountId) => options.resolveOwnerIdentity?.(accountId, snapshot.appId),
+    };
+}
+//# sourceMappingURL=definition.js.map

package/lib/definition.js.map

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

package/lib/image-hydrator.d.ts

@@ -0,0 +1,13 @@
+/**
+ * One-version compatibility shim.
+ *
+ * The QQ inbound hydrator was renamed from `image-hydrator.ts` to
+ * `media-hydrator.ts` (it now covers image / file / audio / video). This entry
+ * re-exports the new implementation under the legacy names so existing imports
+ * of `hydrateImageParts` / `ImageHydratorOptions` keep working for one release.
+ *
+ * New code should import `hydrateMediaParts` / `MediaHydratorOptions` from
+ * `./media-hydrator.js`.
+ */
+export { hydrateMediaParts as hydrateImageParts, type MediaHydratorOptions as ImageHydratorOptions, } from './media-hydrator.js';
+//# sourceMappingURL=image-hydrator.d.ts.map

package/lib/image-hydrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-hydrator.d.ts","sourceRoot":"","sources":["../src/image-hydrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,iBAAiB,IAAI,iBAAiB,EACtC,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,MAAM,qBAAqB,CAAC"}

package/lib/image-hydrator.js

@@ -0,0 +1,13 @@
+/**
+ * One-version compatibility shim.
+ *
+ * The QQ inbound hydrator was renamed from `image-hydrator.ts` to
+ * `media-hydrator.ts` (it now covers image / file / audio / video). This entry
+ * re-exports the new implementation under the legacy names so existing imports
+ * of `hydrateImageParts` / `ImageHydratorOptions` keep working for one release.
+ *
+ * New code should import `hydrateMediaParts` / `MediaHydratorOptions` from
+ * `./media-hydrator.js`.
+ */
+export { hydrateMediaParts as hydrateImageParts, } from './media-hydrator.js';
+//# sourceMappingURL=image-hydrator.js.map

package/lib/image-hydrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-hydrator.js","sourceRoot":"","sources":["../src/image-hydrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,iBAAiB,IAAI,iBAAiB,GAEvC,MAAM,qBAAqB,CAAC"}

package/lib/inbound.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Inbound processing: dedup window + structured mapping + media hydration +
+ * emit.
+ *
+ * Input is the Tencent SDK's `QQBotInboundMessage`. Dedup keys on `messageId`
+ * (DSH keeps its own dedup policy; the SDK middleware chain is unused). Only
+ * `kind === 'c2c'` and `kind === 'group'` are accepted in V1 — anything else
+ * (guild/dm) is logged and dropped.
+ *
+ * Binary hydration runs AFTER mapping and dedup,
+ * BEFORE emit: every `image` (M2A), `file` (M7B), `audio` and `video` part
+ * with a genuine `http(s)` `url` is downloaded through the injectable
+ * `SecureRemoteMediaFetcher` and its bytes are placed on `localData`
+ * (file/audio/video parts also carry the hydrated byte length in `size`).
+ * A download failure never blocks text delivery — the part keeps its `url`
+ * and records a stable `ingressFailure` code.
+ */
+import type { ChannelAdapterContext } from '@krischoichoi/channel-core';
+import { SecureRemoteMediaFetcher } from '@krischoichoi/channel-core';
+import type { QQBotInboundMessage } from '@tencent-connect/qqbot-nodejs';
+import { type QQInboundMeta } from './mapper.js';
+import { type MediaHydratorOptions } from './media-hydrator.js';
+export interface InboundProcessorOptions {
+    ctx: ChannelAdapterContext;
+    meta: QQInboundMeta;
+    dedupEnabled: boolean;
+    dedupWindowMs: number;
+    /** Optional secure remote media fetcher (tests inject a fake; defaults to real). */
+    secureFetch?: SecureRemoteMediaFetcher;
+    /** Media hydration tuning (image / file / audio / video). */
+    mediaHydration?: MediaHydratorOptions;
+    /** @deprecated use mediaHydration. */
+    imageHydration?: MediaHydratorOptions;
+    /** Injectable clock (tests). */
+    now?: () => number;
+}
+export declare class InboundProcessor {
+    private readonly options;
+    private readonly now;
+    private readonly secureFetch;
+    private readonly mediaHydration;
+    /** messageId -> last-seen timestamp, pruned on every handle. */
+    private readonly seen;
+    constructor(options: InboundProcessorOptions);
+    /** Process one SDK inbound message; dedup, hydrate media, then emit. */
+    handle(raw: QQBotInboundMessage): Promise<void>;
+    private prune;
+}
+//# sourceMappingURL=inbound.d.ts.map

package/lib/inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../src/inbound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAgC,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AA+CtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAqB,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEnF,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,qBAAqB,CAAC;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,sCAAsC;IACtC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAOf,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;gBAErB,OAAO,EAAE,uBAAuB;IAM7D,wEAAwE;IAClE,MAAM,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCrD,OAAO,CAAC,KAAK;CAKd"}

package/lib/inbound.js

@@ -0,0 +1,98 @@
+import { SecureRemoteMediaFetcher } from '@krischoichoi/channel-core';
+/** Compact per-part summary for inbound message logs (debug diagnostics). */
+function summarizeParts(parts) {
+    return parts.map((part) => {
+        switch (part.type) {
+            case 'text':
+                return { type: 'text', text: part.text.slice(0, 80) };
+            case 'image':
+                return {
+                    type: 'image',
+                    url: part.url,
+                    resourceRef: part.resourceRef,
+                    mimeType: part.mimeType,
+                    localDataBytes: part.localData?.byteLength,
+                    ingressFailure: part.ingressFailure,
+                };
+            case 'file':
+                return {
+                    type: 'file',
+                    name: part.name,
+                    size: part.size,
+                    mimeType: part.mimeType,
+                    localDataBytes: part.localData?.byteLength,
+                    ingressFailure: part.ingressFailure,
+                };
+            case 'audio':
+                return {
+                    type: 'audio',
+                    durationMs: part.durationMs,
+                    mimeType: part.mimeType,
+                    localDataBytes: part.localData?.byteLength,
+                    ingressFailure: part.ingressFailure,
+                };
+            case 'video':
+                return {
+                    type: 'video',
+                    durationMs: part.durationMs,
+                    mimeType: part.mimeType,
+                    localDataBytes: part.localData?.byteLength,
+                    ingressFailure: part.ingressFailure,
+                };
+            default:
+                return { type: part.type };
+        }
+    });
+}
+import { mapInbound } from './mapper.js';
+import { hydrateMediaParts } from './media-hydrator.js';
+export class InboundProcessor {
+    options;
+    now;
+    secureFetch;
+    mediaHydration;
+    /** messageId -> last-seen timestamp, pruned on every handle. */
+    seen = new Map();
+    constructor(options) {
+        this.options = options;
+        this.now = options.now ?? Date.now;
+        this.secureFetch = options.secureFetch ?? new SecureRemoteMediaFetcher();
+        this.mediaHydration = options.mediaHydration ?? options.imageHydration ?? {};
+    }
+    /** Process one SDK inbound message; dedup, hydrate media, then emit. */
+    async handle(raw) {
+        if (raw.kind !== 'c2c' && raw.kind !== 'group') {
+            this.options.ctx.logger.debug(`[channel-qq] dropping unsupported inbound kind '${raw.kind}'`);
+            return;
+        }
+        const key = raw.messageId;
+        if (this.options.dedupEnabled) {
+            const now = this.now();
+            const last = this.seen.get(key);
+            if (last !== undefined && now - last < this.options.dedupWindowMs) {
+                this.options.ctx.logger.debug(`[channel-qq] dropped duplicate message '${key}'`);
+                return;
+            }
+            this.seen.set(key, now);
+            this.prune(now);
+        }
+        const event = mapInbound(raw, this.options.meta);
+        // Hydrate media bytes before emit so the harness attachment paths receive
+        // real bytes. Never throws; failures degrade the part.
+        await hydrateMediaParts(event.message.content, this.secureFetch, {
+            ...this.mediaHydration,
+            signal: this.options.ctx.signal,
+        });
+        // Inbound message log (debug diagnostics): visible in web:debug with
+        // DSH_CHANNELS_DEBUG=1, shows mapped parts incl. hydration result.
+        this.options.ctx.logger.info(`[channel-qq] inbound message ${event.message.id} from ${event.sender.id} in ${event.conversation.id}`, { parts: summarizeParts(event.message.content) });
+        await this.options.ctx.emit(event);
+    }
+    prune(now) {
+        for (const [key, ts] of this.seen) {
+            if (now - ts >= this.options.dedupWindowMs)
+                this.seen.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=inbound.js.map

package/lib/inbound.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @krischoichoi/channel-qq — QQ channel adapter for DeepSeek Harness.
+ *
+ * Maps the QQ platform (via the official Tencent SDK
+ * `@tencent-connect/qqbot-nodejs`) to the stable Channel Contract. The SDK
+ * owns Token acquisition/refresh, the WebSocket gateway, media upload and C2C
+ * streaming; DSH keeps its own dedup policy and reply routing.
+ *
+ * The adapter requires `ctx.channels` and `ctx.credentials`: the QQ AppSecret
+ * is resolved at startup through `ctx.credentials` (`appSecretRef`) and passed
+ * to the adapter as `deps.appSecret`. The secret value never enters the
+ * profile config — only its reference name does (v1.1 §7, QQ-R5).
+ *
+ * Since M2B, apply() is channel-control-aware (doc §25/§27/§47): when the
+ * universal Channel Control Plane (ctx.channelControl) is present it registers
+ * the QQ `ChannelDefinition` and lets the plane drive setup / credentials /
+ * auto-start. When channel-control is absent it falls back to the legacy
+ * headless mount — mounting ONLY when configured, and never throwing on an
+ * unconfigured channel.
+ *
+ * Streaming is target-aware: C2C with a triggering message id streams natively
+ * (replace-semantics full-text); groups are buffered and delivered once at
+ * `turn/end`.
+ */
+import { type Context } from '@deepseek-ai/cordis';
+import { Config, QQ_APP_SECRET_REF } from './config.js';
+import type { QQConfig, QQConfigLive } from './config.js';
+import { type QQAdapterDeps } from './adapter.js';
+export declare const name = "channel-qq";
+export declare const inject: string[];
+export { Config, QQ_APP_SECRET_REF };
+export type { QQConfig, QQConfigLive } from './config.js';
+export { QQAdapter, type QQAdapterDeps } from './adapter.js';
+export { createQQDefinition } from './definition.js';
+export type { CredentialSeam, QQDefinitionOptions } from './definition.js';
+export { TencentQQSdkClient, FakeQQSdkClient, FakeStreamSession, adaptLogger, mediaOpts, decodeDataUri, QQ_MINIMAL_INTENTS, QQ_BUTTON_ACTION_TYPE, QQ_BUTTON_PERMISSION_TYPE, QQ_BUTTON_STYLE_PRIMARY, QQ_BUTTON_STYLE_DEFAULT, type QQSdkClient, type QQReplyTarget, type QQStreamTarget, type QQStreamSession, type QQInteractionLike, type QQInlineKeyboardLike, type QQKeyboardButton, type MediaOptions, } from './sdk-client.js';
+export { InboundProcessor } from './inbound.js';
+export { hydrateMediaParts, type MediaHydratorOptions } from './media-hydrator.js';
+export { hydrateImageParts, type ImageHydratorOptions } from './image-hydrator.js';
+export { OutboundSender, toReplyTarget, toQqKeyboard } from './outbound.js';
+export { QQStreamingReply } from './streaming-reply.js';
+export { mapInbound, mapMessageParts, type QQInboundMeta } from './mapper.js';
+export { mapInteraction, type QQInteractionMapping, type QQInteractionDropReason } from './interaction-mapper.js';
+export { manifest, type QQManifest } from './manifest.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: QQConfig | QQConfigLive, deps?: QQAdapterDeps): 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAK7D,eAAO,MAAM,IAAI,eAAe,CAAC;AACjC,eAAO,MAAM,MAAM,EAAE,MAAM,EAAgC,CAAC;AAE5D,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;AACrC,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGnF,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,QAAQ,GAAG,YAAY,EAClC,IAAI,GAAE,aAAkB,GACvB,IAAI,CAuEN"}