@mininglamp-oss/cc-channel-octo 1.0.1

package/dist/octo/api.d.ts

@@ -0,0 +1,148 @@
+import { ChannelType, type MentionEntity, type SendMessageResult } from "./types.js";
+/**
+ * Generate a client-side idempotency key (UUID) for outbound messages.
+ *
+ * WuKongIM uses client_msg_no for server-side dedup — identical client_msg_no
+ * values result in only one stored message.
+ */
+export declare function generateClientMsgNo(): string;
+/**
+ * Parse JSON with int64 message_id protection.
+ * Converts 16+ digit numeric message_id values to strings before JSON.parse
+ * to prevent JavaScript precision loss for IDs exceeding Number.MAX_SAFE_INTEGER.
+ *
+ * Exported so other inbound paths parse Octo JSON with the same int64 safety as
+ * the REST client.
+ */
+export declare function parseOctoJson<T>(text: string): T;
+export declare function postJson<T>(apiUrl: string, botToken: string, path: string, payload: Record<string, unknown>, signal?: AbortSignal): Promise<T | undefined>;
+export declare function sendMessage(params: {
+    apiUrl: string;
+    botToken: string;
+    channelId: string;
+    channelType: ChannelType;
+    content: string;
+    mentionUids?: string[];
+    mentionEntities?: MentionEntity[];
+    mentionAll?: boolean;
+    replyMsgId?: string;
+    clientMsgNo?: string;
+    signal?: AbortSignal;
+}): Promise<SendMessageResult | undefined>;
+/**
+ * Get STS temporary credentials for direct COS upload.
+ * GET /v1/bot/upload/credentials?filename=<encoded>
+ *
+ * Returns short-lived (typically 1h) credentials scoped to a single key.
+ * cc only uses this to probe the media CDN host (see index.ts); actual uploads
+ * are performed by the agent's octo-cli skill, not by cc itself.
+ */
+export declare function getUploadCredentials(params: {
+    apiUrl: string;
+    botToken: string;
+    filename: string;
+    signal?: AbortSignal;
+}): Promise<{
+    bucket: string;
+    region: string;
+    key: string;
+    credentials: {
+        tmpSecretId: string;
+        tmpSecretKey: string;
+        sessionToken: string;
+    };
+    startTime: number;
+    expiredTime: number;
+    cdnBaseUrl?: string;
+}>;
+export declare function sendTyping(params: {
+    apiUrl: string;
+    botToken: string;
+    channelId: string;
+    channelType: ChannelType;
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function sendHeartbeat(params: {
+    apiUrl: string;
+    botToken: string;
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function registerBot(params: {
+    apiUrl: string;
+    botToken: string;
+    forceRefresh?: boolean;
+    agentPlatform?: string;
+    agentVersion?: string;
+    signal?: AbortSignal;
+}): Promise<{
+    robot_id: string;
+    im_token: string;
+    ws_url: string;
+    api_url: string;
+    owner_uid: string;
+    owner_channel_id: string;
+}>;
+export declare function sendReadReceipt(params: {
+    apiUrl: string;
+    botToken: string;
+    channelId: string;
+    channelType: ChannelType;
+    messageIds: string[];
+    signal?: AbortSignal;
+}): Promise<void>;
+export interface GroupMember {
+    uid: string;
+    name: string;
+    role: number;
+    robot?: number;
+    status?: number;
+    [key: string]: unknown;
+}
+export declare function getGroupMembers(params: {
+    apiUrl: string;
+    botToken: string;
+    groupNo: string;
+}): Promise<GroupMember[]>;
+export declare function fetchUserInfo(params: {
+    apiUrl: string;
+    botToken: string;
+    uid: string;
+}): Promise<{
+    uid: string;
+    name: string;
+    avatar?: string;
+} | null>;
+/** Historical message returned by /v1/bot/messages/sync. */
+export interface HistoricalMessage {
+    from_uid: string;
+    from_name?: string;
+    content?: string;
+    timestamp: number;
+    message_id?: string;
+    message_seq?: number;
+    /** Numeric MessageType (1=Text, 2=Image, 8=File, 14=RichText, etc.) */
+    type?: number;
+    url?: string;
+    name?: string;
+    /** Decoded full payload (server sends base64, we decode + JSON.parse). */
+    payload?: Record<string, unknown>;
+}
+/**
+ * Pull recent messages for a channel via the WuKongIM sync endpoint.
+ *
+ * Used by G4 to backfill conversation history when the local SQLite cache is
+ * empty or sparse (e.g. cold start, restored snapshot). The server payload is
+ * base64-encoded JSON; we decode it inline so callers get a clean object.
+ *
+ * Returns `[]` on any failure — the agent runs fine without history.
+ */
+export declare function getChannelMessages(params: {
+    apiUrl: string;
+    botToken: string;
+    channelId: string;
+    channelType: number;
+    limit?: number;
+    startMessageSeq?: number;
+    endMessageSeq?: number;
+    signal?: AbortSignal;
+}): Promise<HistoricalMessage[]>;

package/dist/octo/api.js

@@ -0,0 +1,320 @@
+// Forked from openclaw-channel-octo v1.0.13 (2026-06-04)
+// Source: https://github.com/Mininglamp-OSS/openclaw-channel-octo
+// Removed: COS upload, GROUP.md API, OBO, rich text, media, thread/group management,
+//          read receipts, bot groups list, group info, mention prefs, space members.
+import { MessageType, } from "./types.js";
+import { randomUUID } from "node:crypto";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Maximum base64-encoded payload length accepted from /v1/bot/messages/sync.
+ * D1/S7 (齐 P0-2): a malicious or buggy server could return a single payload
+ * of arbitrary size; Buffer.from(str, 'base64') allocates ~0.75 × input bytes
+ * synchronously. Cap at 256 KiB base64 ≈ 192 KiB decoded — well above any
+ * legitimate IM message payload.
+ */
+const MAX_HISTORICAL_PAYLOAD_BASE64_LEN = 256 * 1024;
+/**
+ * Generate a client-side idempotency key (UUID) for outbound messages.
+ *
+ * WuKongIM uses client_msg_no for server-side dedup — identical client_msg_no
+ * values result in only one stored message.
+ */
+export function generateClientMsgNo() {
+    return randomUUID();
+}
+const DEFAULT_HEADERS = {
+    "Content-Type": "application/json",
+};
+/**
+ * Parse JSON with int64 message_id protection.
+ * Converts 16+ digit numeric message_id values to strings before JSON.parse
+ * to prevent JavaScript precision loss for IDs exceeding Number.MAX_SAFE_INTEGER.
+ *
+ * Exported so other inbound paths parse Octo JSON with the same int64 safety as
+ * the REST client.
+ */
+export function parseOctoJson(text) {
+    const safeText = text.replace(/"message_id"\s*:\s*(\d{16,})/g, '"message_id":"$1"');
+    return JSON.parse(safeText);
+}
+export async function postJson(apiUrl, botToken, path, payload, signal) {
+    const url = `${apiUrl.replace(/\/+$/, "")}${path}`;
+    const effectiveSignal = signal ?? AbortSignal.timeout(DEFAULT_TIMEOUT_MS);
+    const response = await fetch(url, {
+        method: "POST",
+        headers: {
+            ...DEFAULT_HEADERS,
+            Authorization: `Bearer ${botToken}`,
+        },
+        body: JSON.stringify(payload),
+        signal: effectiveSignal,
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        throw new Error(`Octo API ${path} failed (${response.status}): ${text || response.statusText}`);
+    }
+    const text = await response.text();
+    if (!text)
+        return undefined;
+    try {
+        return parseOctoJson(text);
+    }
+    catch {
+        throw new Error(`Octo API ${path} returned invalid JSON: ${text.slice(0, 200)}`);
+    }
+}
+// ─── Message Sending ────────────────────────────────────────────────────────
+export async function sendMessage(params) {
+    const payload = {
+        type: MessageType.Text,
+        content: params.content,
+    };
+    if ((params.mentionUids && params.mentionUids.length > 0) ||
+        (params.mentionEntities && params.mentionEntities.length > 0) ||
+        params.mentionAll) {
+        const mention = {};
+        if (params.mentionUids && params.mentionUids.length > 0) {
+            mention.uids = params.mentionUids;
+        }
+        if (params.mentionEntities && params.mentionEntities.length > 0) {
+            mention.entities = params.mentionEntities;
+        }
+        if (params.mentionAll) {
+            mention.all = 1;
+        }
+        payload.mention = mention;
+    }
+    if (params.replyMsgId) {
+        payload.reply = { message_id: params.replyMsgId };
+    }
+    return await postJson(params.apiUrl, params.botToken, "/v1/bot/sendMessage", {
+        channel_id: params.channelId,
+        channel_type: params.channelType,
+        payload,
+        client_msg_no: params.clientMsgNo ?? generateClientMsgNo(),
+    }, params.signal);
+}
+/**
+ * Get STS temporary credentials for direct COS upload.
+ * GET /v1/bot/upload/credentials?filename=<encoded>
+ *
+ * Returns short-lived (typically 1h) credentials scoped to a single key.
+ * cc only uses this to probe the media CDN host (see index.ts); actual uploads
+ * are performed by the agent's octo-cli skill, not by cc itself.
+ */
+export async function getUploadCredentials(params) {
+    const base = params.apiUrl.replace(/\/+$/, "");
+    const url = `${base}/v1/bot/upload/credentials?filename=${encodeURIComponent(params.filename)}`;
+    const effectiveSignal = params.signal ?? AbortSignal.timeout(DEFAULT_TIMEOUT_MS);
+    const response = await fetch(url, {
+        method: "GET",
+        headers: { Authorization: `Bearer ${params.botToken}` },
+        signal: effectiveSignal,
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => "");
+        // P1 from PR#34 review: server may echo request headers (incl. Authorization
+        // bearer token) on some error responses. Cap at 200 chars and strip any
+        // "Authorization" / "Bearer" tokens defensively before surfacing.
+        const sanitized = text
+            .slice(0, 200)
+            .replace(/Bearer\s+\S+/gi, "Bearer ***")
+            .replace(/(authorization"?\s*[:=]\s*"?)[^"\s,}]+/gi, "$1***");
+        throw new Error(`Octo API /v1/bot/upload/credentials failed (${response.status}): ${sanitized || response.statusText}`);
+    }
+    const data = await response.json();
+    // Validate required fields to catch backend API changes early.
+    const missing = ['bucket', 'region', 'key', 'credentials'].filter(k => !data[k]);
+    if (missing.length > 0) {
+        throw new Error(`Octo API /v1/bot/upload/credentials returned incomplete response: missing ${missing.join(', ')}`);
+    }
+    const creds = data.credentials;
+    if (!creds.tmpSecretId || !creds.tmpSecretKey || !creds.sessionToken) {
+        throw new Error("Octo API /v1/bot/upload/credentials returned incomplete credentials");
+    }
+    return data;
+}
+// ─── Typing / Heartbeat ─────────────────────────────────────────────────────
+export async function sendTyping(params) {
+    await postJson(params.apiUrl, params.botToken, "/v1/bot/typing", {
+        channel_id: params.channelId,
+        channel_type: params.channelType,
+    }, params.signal);
+}
+export async function sendHeartbeat(params) {
+    await postJson(params.apiUrl, params.botToken, "/v1/bot/heartbeat", {}, params.signal);
+}
+// ─── Bot Registration ───────────────────────────────────────────────────────
+export async function registerBot(params) {
+    const path = params.forceRefresh
+        ? "/v1/bot/register?force_refresh=true"
+        : "/v1/bot/register";
+    const body = {};
+    if (params.agentPlatform)
+        body.agent_platform = params.agentPlatform;
+    if (params.agentVersion)
+        body.agent_version = params.agentVersion;
+    const result = await postJson(params.apiUrl, params.botToken, path, body, params.signal);
+    if (!result)
+        throw new Error("Octo bot registration returned empty response");
+    return result;
+}
+/**
+ * GET request helper with consistent error handling, timeout, and int64 protection.
+ */
+async function getJson(apiUrl, botToken, path, signal) {
+    const url = `${apiUrl.replace(/\/+$/, "")}${path}`;
+    const effectiveSignal = signal ?? AbortSignal.timeout(DEFAULT_TIMEOUT_MS);
+    const resp = await fetch(url, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${botToken}`,
+        },
+        signal: effectiveSignal,
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        throw new Error(`Octo API ${path} failed (${resp.status}): ${text || resp.statusText}`);
+    }
+    const text = await resp.text();
+    if (!text)
+        return {};
+    return parseOctoJson(text);
+}
+// ─── Read Receipt ──────────────────────────────────────────────────────────
+export async function sendReadReceipt(params) {
+    await postJson(params.apiUrl, params.botToken, '/v1/bot/readReceipt', {
+        channel_id: params.channelId,
+        channel_type: params.channelType,
+        message_ids: params.messageIds,
+    }, params.signal);
+}
+export async function getGroupMembers(params) {
+    const data = await getJson(params.apiUrl, params.botToken, `/v1/bot/groups/${params.groupNo}/members`);
+    const members = Array.isArray(data?.members)
+        ? data.members
+        : Array.isArray(data)
+            ? data
+            : [];
+    return members;
+}
+// ─── User Info ──────────────────────────────────────────────────────────────
+export async function fetchUserInfo(params) {
+    const url = `${params.apiUrl.replace(/\/+$/, "")}/v1/bot/user/info?uid=${encodeURIComponent(params.uid)}`;
+    try {
+        const resp = await fetch(url, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${params.botToken}` },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (resp.status === 404) {
+            return null;
+        }
+        if (!resp.ok) {
+            console.error(`octo: fetchUserInfo(${params.uid}) failed: ${resp.status}`);
+            return null;
+        }
+        const data = await resp.json();
+        if (data?.name) {
+            return { uid: data.uid ?? params.uid, name: data.name, avatar: data.avatar };
+        }
+        return null;
+    }
+    catch (err) {
+        console.error(`octo: fetchUserInfo(${params.uid}) error: ${String(err)}`);
+        return null;
+    }
+}
+/**
+ * Pull recent messages for a channel via the WuKongIM sync endpoint.
+ *
+ * Used by G4 to backfill conversation history when the local SQLite cache is
+ * empty or sparse (e.g. cold start, restored snapshot). The server payload is
+ * base64-encoded JSON; we decode it inline so callers get a clean object.
+ *
+ * Returns `[]` on any failure — the agent runs fine without history.
+ */
+export async function getChannelMessages(params) {
+    try {
+        const result = await postJson(params.apiUrl, params.botToken, '/v1/bot/messages/sync', {
+            channel_id: params.channelId,
+            channel_type: params.channelType,
+            limit: params.limit ?? 20,
+            start_message_seq: params.startMessageSeq ?? 0,
+            end_message_seq: params.endMessageSeq ?? 0,
+            pull_mode: 1, // 1 = pull newer messages
+        }, params.signal);
+        const messages = result?.messages ?? [];
+        // D1/S7 (齐 P0-2): client-side cap on returned message count. The server
+        // could return more than `limit` requested (bug or malice); we map +
+        // decode each item which is O(payload size) per message.
+        const cap = params.limit ?? 20;
+        const limited = messages.length > cap ? messages.slice(0, cap) : messages;
+        return limited.map((m) => {
+            let payload;
+            if (typeof m.payload === 'string') {
+                // D1/S7 (齐 P0-2): cap base64 payload size before decoding. A 100 MB
+                // base64 string would force Buffer.from to allocate ~75 MB synchronously.
+                // 256 KiB decoded ≈ 192 KiB binary, well above any legitimate IM payload.
+                if (m.payload.length > MAX_HISTORICAL_PAYLOAD_BASE64_LEN) {
+                    console.warn(`octo: getChannelMessages dropping oversized payload (${m.payload.length} base64 chars > ${MAX_HISTORICAL_PAYLOAD_BASE64_LEN})`);
+                }
+                else {
+                    try {
+                        payload = JSON.parse(Buffer.from(m.payload, 'base64').toString('utf-8'));
+                    }
+                    catch {
+                        // Leave payload undefined if decoding fails
+                    }
+                }
+            }
+            else if (m.payload && typeof m.payload === 'object') {
+                payload = m.payload;
+            }
+            return {
+                from_uid: String(m.from_uid ?? ''),
+                from_name: typeof m.from_name === 'string' ? m.from_name : undefined,
+                // C1 / P1.5 (Stage 6): WuKongIM /v1/bot/messages/sync ships per-message
+                // content / type / url / name INSIDE the base64-encoded payload, not at
+                // the top level. Without merging the decoded payload up, every Text
+                // history row had `content: undefined`, so seedHistoryFromApi treated
+                // every backfilled message as empty and skipped the placeholder branch
+                // — G4 backfill was effectively a no-op for Text.
+                //
+                // Strategy: prefer the top-level field when it is a usable string /
+                // number, otherwise fall back to the decoded payload field. We never
+                // overwrite a populated top-level value with a payload value, so this
+                // is a strict superset of the previous behavior.
+                content: typeof m.content === 'string' && m.content !== ''
+                    ? m.content
+                    : typeof payload?.content === 'string'
+                        ? payload.content
+                        : undefined,
+                timestamp: typeof m.timestamp === 'number' ? m.timestamp : 0,
+                message_id: typeof m.message_id === 'string' ? m.message_id : undefined,
+                message_seq: typeof m.message_seq === 'number' ? m.message_seq : undefined,
+                type: typeof m.type === 'number'
+                    ? m.type
+                    : typeof payload?.type === 'number'
+                        ? payload.type
+                        : undefined,
+                url: typeof m.url === 'string'
+                    ? m.url
+                    : typeof payload?.url === 'string'
+                        ? payload.url
+                        : undefined,
+                name: typeof m.name === 'string'
+                    ? m.name
+                    : typeof payload?.name === 'string'
+                        ? payload.name
+                        : undefined,
+                payload,
+            };
+        });
+    }
+    catch (err) {
+        console.error(`octo: getChannelMessages error: ${String(err)}`);
+        return [];
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/octo/api.js.map

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

package/dist/octo/socket.d.ts

@@ -0,0 +1,102 @@
+import { EventEmitter } from "events";
+import type { BotMessage } from "./types.js";
+export declare class Encoder {
+    private w;
+    writeByte(b: number): void;
+    writeBytes(b: number[]): void;
+    writeInt16(b: number): void;
+    writeInt32(b: number): void;
+    writeInt64(n: bigint): void;
+    writeString(s: string): void;
+    toUint8Array(): Uint8Array;
+}
+export declare class Decoder {
+    private data;
+    private offset;
+    constructor(data: Uint8Array);
+    /**
+     * Bounds guard: every reader calls this before touching the buffer so a
+     * truncated/malformed packet throws a typed error instead of silently reading
+     * `undefined` (which coerces to 0/NaN and produces corrupt parses — wrong
+     * messageID/seq → ack mismatch, message loss/dup). The packet-decode caller
+     * wraps decode in try/catch, so a throw cleanly rejects the bad packet.
+     */
+    private require;
+    readByte(): number;
+    readInt16(): number;
+    readInt32(): number;
+    readInt64String(): string;
+    readInt64BigInt(): bigint;
+    readString(): string;
+    readRemaining(): Uint8Array;
+    readVariableLength(): number;
+}
+interface WKSocketOptions {
+    wsUrl: string;
+    uid: string;
+    token: string;
+    onMessage: (msg: BotMessage) => void;
+    onConnected?: () => void;
+    onDisconnected?: () => void;
+    onError?: (err: Error) => void;
+}
+/**
+ * WuKongIM WebSocket client for bot connections.
+ *
+ * Implements the WuKongIM binary protocol directly over WebSocket,
+ * with per-instance DH key exchange, AES encryption, heartbeat,
+ * reconnect, and RECVACK.
+ *
+ * Each WKSocket instance maintains its own independent connection,
+ * enabling multiple bot accounts to run simultaneously.
+ */
+export declare class WKSocket extends EventEmitter {
+    private opts;
+    private ws;
+    private connected;
+    private needReconnect;
+    private reconnectTimer;
+    private heartTimer;
+    private pingRetryCount;
+    private readonly pingMaxRetry;
+    private reconnectAttempts;
+    private stableTimer;
+    private lastConnectTime;
+    private rapidDisconnectCount;
+    private aesKey;
+    private aesIV;
+    private dhPrivateKey;
+    private serverVersion;
+    private tempBuffer;
+    private decryptFailCounts;
+    constructor(opts: WKSocketOptions);
+    /** Connect to WuKongIM WebSocket */
+    connect(): void;
+    /** Gracefully disconnect */
+    disconnect(): void;
+    /** Disconnect and wait for the old WS to fully close before resolving. */
+    disconnectAndWait(timeoutMs?: number): Promise<void>;
+    private doConnect;
+    private scheduleReconnect;
+    stopReconnectTimer(): void;
+    private startStableTimer;
+    private clearStableTimer;
+    private restartHeart;
+    private stopHeart;
+    private sendRaw;
+    private handleRawData;
+    /**
+     * Parse ONE packet starting at `start` in `data`. Returns the number of bytes
+     * consumed, or 0 if the buffer does not yet hold a complete packet (caller
+     * should wait for more bytes). Reads via `start + offset` and slices only the
+     * single packet's bytes — never the whole buffer — so repeated calls over a
+     * large buffer stay O(n) total, not O(n²).
+     */
+    private unpackOne;
+    private onPong;
+    private onPacket;
+    private onConnack;
+    private onRecv;
+    private onDisconnect;
+}
+export {};