@krischoichoi/channel-qq 0.6.0

package/lib/sdk-client.js

@@ -0,0 +1,312 @@
+/**
+ * DSH SDK port — the thin seam between the QQ adapter and the Tencent SDK.
+ *
+ * The adapter never touches `QQBot` directly; everything flows through
+ * `QQSdkClient`. Production wraps the real `QQBot` (`TencentQQSdkClient`);
+ * tests inject a `FakeQQSdkClient` so the entire adapter contract suite runs
+ * fully offline (no network, no real credentials).
+ */
+import { MediaFileType, QQBot, } from '@tencent-connect/qqbot-nodejs';
+import { ChannelSendError } from '@krischoichoi/channel-core';
+/**
+ * QQ Gateway intents the adapter actually consumes today (minimal-intent
+ * principle): `GROUP_AND_C2C` covers the C2C/group message events this adapter
+ * processes inbound, and `INTERACTION` covers the button `INTERACTION_CREATE`
+ * callbacks that drive `interaction.received`. The SDK defaults to
+ * `FULL_INTENTS` (guilids + members + guild messages + dm + group/c2c +
+ * interaction); requesting only what we use avoids `4914 INSUFFICIENT_INTENTS`
+ * / `4915 DISALLOWED_INTENTS` gateway rejections for privileges the bridge
+ * never exercises, and keeps the permission surface minimal. Bit values are
+ * verified from the pinned SDK (`dist/protocol/gateway/constants.js`):
+ * `GROUP_AND_C2C = 1 << 25`, `INTERACTION = 1 << 26`.
+ */
+export const QQ_MINIMAL_INTENTS = (1 << 25) | (1 << 26); // GROUP_AND_C2C | INTERACTION
+/** QQ inline-keyboard callback action (emits `INTERACTION_CREATE`). */
+export const QQ_BUTTON_ACTION_TYPE = 1;
+/** QQ inline-keyboard permission: any user may press. */
+export const QQ_BUTTON_PERMISSION_TYPE = 2;
+/** QQ button render style for the `primary` DSH action style. */
+export const QQ_BUTTON_STYLE_PRIMARY = 1;
+/** QQ button render style default. */
+export const QQ_BUTTON_STYLE_DEFAULT = 0;
+/** Bridge a DSH `ChannelLogger` (variadic) to the SDK `Logger` shape. */
+export function adaptLogger(logger) {
+    return {
+        info: (msg, meta) => logger.info(msg, meta),
+        error: (msg, meta) => logger.error(msg, meta),
+        warn: (msg, meta) => logger.warn(msg, meta),
+        debug: (msg, meta) => logger.debug(msg, meta),
+    };
+}
+/** Production `QQSdkClient`: wraps a real `QQBot` built from config. */
+export class TencentQQSdkClient {
+    bot;
+    constructor(config, logger, appSecret) {
+        this.bot = new QQBot({
+            appId: config.appId,
+            appSecret,
+            accountId: config.accountId,
+            markdownSupport: config.markdownSupport,
+            transport: 'websocket',
+            tokenPrefetch: 'sync',
+            // Minimal intent mask (GROUP_AND_C2C | INTERACTION) — never rely on the
+            // SDK `FULL_INTENTS` default (skill §6.2, P1). See QQ_MINIMAL_INTENTS.
+            intents: QQ_MINIMAL_INTENTS,
+            logger: adaptLogger(logger),
+        });
+    }
+    onReady(handler) {
+        this.bot.on('ready', () => handler());
+    }
+    onResumed(handler) {
+        this.bot.on('resumed', () => handler());
+    }
+    onError(handler) {
+        this.bot.on('error', (error) => handler(error));
+    }
+    onMessage(handler) {
+        this.bot.on('message', (_ctx, message) => handler(message));
+    }
+    onInteraction(handler) {
+        // The SDK dispatches the raw `InteractionEvent` as the second argument;
+        // the handler only sees the port slice the adapter needs.
+        this.bot.on('interaction', (_ctx, event) => handler(event));
+    }
+    start(signal) {
+        return this.bot.start(signal);
+    }
+    stop() {
+        this.bot.stop();
+    }
+    sendText(target, text) {
+        return this.bot.sendText(target, text);
+    }
+    sendMarkdownWithKeyboard(target, text, keyboard) {
+        // New QQ interactive messages are explicit Markdown messages. Do not use
+        // sendTextWithKeyboard(): that helper follows `markdownSupport` and emits
+        // msg_type=0 when the legacy config flag is false, in which case current
+        // QQ clients do not render the keyboard.
+        return this.bot.sendMarkdown(toSdkReplyTarget(target), text, { keyboard });
+    }
+    acknowledgeInteraction(id, code, data) {
+        return this.bot.acknowledgeInteraction(id, code, data);
+    }
+    async sendMedia(target, message) {
+        return this.bot.sendMedia({ target: toSdkReplyTarget(target), ...mediaOpts(message) });
+    }
+    openStream(target, options) {
+        return this.bot.openStream({
+            target: toSdkReplyTarget(target),
+            throttleMs: options.throttleMs,
+        });
+    }
+}
+/** Port `QQReplyTarget`/`QQStreamTarget` is structurally identical to the SDK
+ * `ReplyTarget`; narrow explicitly so the SDK methods accept it. */
+function toSdkReplyTarget(target) {
+    return { scope: target.scope, targetId: target.targetId, msgId: target.msgId };
+}
+export function mediaOpts(message) {
+    for (const part of message.parts ?? []) {
+        switch (part.type) {
+            case 'image':
+                if (part.url || part.dataUri || part.localData !== undefined) {
+                    return {
+                        fileType: MediaFileType.IMAGE,
+                        ...mediaSource(part),
+                        content: message.text,
+                    };
+                }
+                break;
+            case 'audio':
+                if (part.url || part.dataUri || part.localData !== undefined) {
+                    return { fileType: MediaFileType.VOICE, ...mediaSource(part) };
+                }
+                break;
+            case 'video':
+                if (part.url || part.dataUri || part.localData !== undefined) {
+                    return { fileType: MediaFileType.VIDEO, ...mediaSource(part) };
+                }
+                break;
+            case 'file':
+                if (part.url || part.dataUri || part.localData !== undefined) {
+                    return {
+                        fileType: MediaFileType.FILE,
+                        ...mediaSource(part),
+                        fileName: part.name,
+                        content: message.text,
+                    };
+                }
+                break;
+            default:
+                break;
+        }
+    }
+    // No resolvable media part — fall back to a FILE with no source (caller
+    // guarantees a media part; this branch is defensive only).
+    return { fileType: MediaFileType.FILE, content: message.text };
+}
+/**
+ * Resolve a media part to the SDK's single-source shape (`url` or `fileData`).
+ *
+ * Carrier precedence: trusted bytes in hand win, then an
+ * inline data URI, then a genuine `http(s)` `url`. `localData` /
+ * `dataUri` are both base64-encoded for the QQ `uploadMedia` `fileData`
+ * field — never sent as `url` (the QQ upload API fetches `url` over HTTP and
+ * cannot resolve inline/raw bytes). Only a real `http(s)` `url` is passed
+ * through as `url`.
+ */
+function mediaSource(part) {
+    if (part.localData !== undefined) {
+        return { fileData: Buffer.from(part.localData).toString('base64') };
+    }
+    if (part.dataUri) {
+        return { fileData: decodeDataUri(part.dataUri) };
+    }
+    return { url: part.url };
+}
+/**
+ * Decode a `data:<mime>;base64,<payload>` URI into the raw base64 payload the
+ * Tencent `uploadMedia` `fileData` field expects. Rejects non-base64 data URIs
+ * (the QQ upload API ingests raw base64, not arbitrary URL-encoded payloads).
+ */
+export function decodeDataUri(dataUri) {
+    const match = /^data:[^;,]*;base64,([\s\S]+)$/.exec(dataUri);
+    const payload = match?.[1];
+    if (!payload) {
+        throw new ChannelSendError('unsupported media data URI');
+    }
+    return payload;
+}
+/** Offline fake SDK client: records calls and exposes controllable emits. */
+export class FakeQQSdkClient {
+    readyHandlers = [];
+    resumedHandlers = [];
+    errorHandlers = [];
+    messageHandlers = [];
+    interactionHandlers = [];
+    started = false;
+    stopped = false;
+    /** If set, `start()` throws this error (never resolves). */
+    startError;
+    /** If true, `start()` resolves only when the signal aborts. */
+    hangStart = false;
+    /** If true, `start()` emits `ready` (then still resolves immediately). */
+    autoReady = false;
+    /** Last signal passed to `start()`. */
+    lastSignal;
+    textCalls = [];
+    keyboardCalls = [];
+    mediaCalls = [];
+    acknowledgeCalls = [];
+    streamCalls = [];
+    /** The live stream sessions opened so far (same order as `streamCalls`). */
+    streams = [];
+    /** If set, `sendText`/`sendMedia` reject with this error. */
+    sendError;
+    onReady(handler) {
+        this.readyHandlers.push(handler);
+    }
+    onResumed(handler) {
+        this.resumedHandlers.push(handler);
+    }
+    onError(handler) {
+        this.errorHandlers.push(handler);
+    }
+    onMessage(handler) {
+        this.messageHandlers.push(handler);
+    }
+    onInteraction(handler) {
+        this.interactionHandlers.push(handler);
+    }
+    async start(signal) {
+        this.started = true;
+        this.lastSignal = signal;
+        if (this.startError)
+            throw this.startError;
+        if (this.autoReady)
+            this.emitReady();
+        if (this.hangStart) {
+            await new Promise((resolve) => {
+                signal.addEventListener('abort', () => resolve(), { once: true });
+            });
+            return;
+        }
+    }
+    stop() {
+        this.stopped = true;
+        // Mirror the real SDK teardown: once stopped, no more events are
+        // dispatched to registered handlers.
+        this.readyHandlers = [];
+        this.resumedHandlers = [];
+        this.errorHandlers = [];
+        this.messageHandlers = [];
+        this.interactionHandlers = [];
+    }
+    async sendText(target, text) {
+        if (this.sendError)
+            throw this.sendError;
+        this.textCalls.push({ target, text });
+        return { id: `out-${this.textCalls.length}` };
+    }
+    async sendMarkdownWithKeyboard(target, text, keyboard) {
+        if (this.sendError)
+            throw this.sendError;
+        this.keyboardCalls.push({ target, text, keyboard, format: 'markdown' });
+        return { id: `out-kbd-${this.keyboardCalls.length}` };
+    }
+    async sendMedia(target, message) {
+        if (this.sendError)
+            throw this.sendError;
+        this.mediaCalls.push({ target, message });
+        return { upload: {}, message: { id: `out-media-${this.mediaCalls.length}` } };
+    }
+    async acknowledgeInteraction(id, code, data) {
+        this.acknowledgeCalls.push({ id, code, data });
+        return undefined;
+    }
+    openStream(target, options) {
+        this.streamCalls.push({ target, options });
+        const session = new FakeStreamSession();
+        this.streams.push(session);
+        return session;
+    }
+    // —— controllable emit helpers (tests) ——
+    emitReady() {
+        for (const h of this.readyHandlers)
+            h();
+    }
+    emitResumed() {
+        for (const h of this.resumedHandlers)
+            h();
+    }
+    emitError(error) {
+        for (const h of this.errorHandlers)
+            h(error);
+    }
+    emitMessage(message) {
+        for (const h of this.messageHandlers)
+            h(message);
+    }
+    emitInteraction(event) {
+        for (const h of this.interactionHandlers)
+            h(event);
+    }
+}
+/** Minimal offline `QQStreamSession` double for fake-client tests. */
+export class FakeStreamSession {
+    updates = [];
+    completed = false;
+    cancelled = false;
+    async update(fullText) {
+        this.updates.push(fullText);
+    }
+    async complete() {
+        this.completed = true;
+        return { id: 'stream-final', timestamp: Date.now() };
+    }
+    cancel() {
+        this.cancelled = true;
+    }
+}
+//# sourceMappingURL=sdk-client.js.map

package/lib/sdk-client.js.map

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

package/lib/streaming-reply.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `QQStreamingReply` — DSH `ReplyHandle` over a Tencent `StreamSession`.
+ *
+ * The Tencent stream API is **replace semantics**: `update(fullText)` always
+ * receives the full accumulated text (never a delta). This class accumulates
+ * deltas locally and forwards the monotonic full text on every change.
+ */
+import type { ReplyHandle, OutboundMessage } from '@krischoichoi/channel-core';
+import type { QQStreamSession } from './sdk-client.js';
+export declare class QQStreamingReply implements ReplyHandle {
+    private readonly stream;
+    private text;
+    constructor(stream: QQStreamSession);
+    append(delta: string): Promise<void>;
+    replace(message: OutboundMessage): Promise<void>;
+    finish(message?: OutboundMessage): Promise<void>;
+    fail(): Promise<void>;
+}
+//# sourceMappingURL=streaming-reply.d.ts.map

package/lib/streaming-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-reply.d.ts","sourceRoot":"","sources":["../src/streaming-reply.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,qBAAa,gBAAiB,YAAW,WAAW;IAGtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,IAAI,CAAM;gBAEW,MAAM,EAAE,eAAe;IAE9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD,MAAM,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/lib/streaming-reply.js

@@ -0,0 +1,26 @@
+export class QQStreamingReply {
+    stream;
+    text = '';
+    constructor(stream) {
+        this.stream = stream;
+    }
+    async append(delta) {
+        this.text += delta;
+        await this.stream.update(this.text);
+    }
+    async replace(message) {
+        this.text = message.text ?? '';
+        await this.stream.update(this.text);
+    }
+    async finish(message) {
+        if (message?.text !== undefined && message.text !== this.text) {
+            this.text = message.text;
+            await this.stream.update(this.text);
+        }
+        await this.stream.complete();
+    }
+    async fail() {
+        this.stream.cancel();
+    }
+}
+//# sourceMappingURL=streaming-reply.js.map

package/lib/streaming-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-reply.js","sourceRoot":"","sources":["../src/streaming-reply.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,gBAAgB;IAGE;IAFrB,IAAI,GAAG,EAAE,CAAC;IAElB,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QACnB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAwB;QACpC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAyB;QACpC,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YACzB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@krischoichoi/channel-qq",
+  "version": "0.6.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/krischoichoi/dsh-channels.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "QQ channel adapter for DeepSeek Harness (Tencent official SDK, native C2C streaming + buffered group)",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rimraf lib"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-credentials": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "~3.18.4",
+    "@tencent-connect/qqbot-nodejs": "1.0.4",
+    "@krischoichoi/channel-control": "workspace:*",
+    "@krischoichoi/channel-core": "workspace:*",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@krischoichoi/channel-testkit": "workspace:*",
+    "rimraf": "^6.0.0"
+  },
+  "license": "MIT"
+}