@nextclaw/channel-runtime 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/channel-runtime",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "private": false,
   "description": "Runtime implementations for NextClaw builtin channel plugins.",
   "type": "module",
@@ -29,7 +29,7 @@
     "undici": "^6.21.0",
     "ws": "^8.18.0",
     "socket.io-msgpack-parser": "^3.0.2",
-    "@nextclaw/core": "0.9.1"
+    "@nextclaw/core": "0.9.3"
   },
   "devDependencies": {
     "@types/mailparser": "^3.4.6",

package/dist/index.d.ts

@@ -1,349 +0,0 @@
-import { MessageBus, Config, SessionManager } from '@nextclaw/core';
-
-type InboundAttachmentErrorCode = "too_large" | "download_failed" | "http_error" | "invalid_payload";
-type InboundAttachment = {
-    id?: string;
-    name?: string;
-    path?: string;
-    url?: string;
-    mimeType?: string;
-    size?: number;
-    source?: string;
-    status?: "ready" | "remote-only";
-    errorCode?: InboundAttachmentErrorCode;
-};
-type OutboundMessage = {
-    channel: string;
-    chatId: string;
-    content: string;
-    replyTo?: string | null;
-    media: string[];
-    metadata: Record<string, unknown>;
-};
-
-declare abstract class BaseChannel<TConfig extends Record<string, unknown>> {
-    protected config: TConfig;
-    protected bus: MessageBus;
-    protected running: boolean;
-    constructor(config: TConfig, bus: MessageBus);
-    abstract get name(): string;
-    abstract start(): Promise<void>;
-    abstract stop(): Promise<void>;
-    abstract send(msg: OutboundMessage): Promise<void>;
-    handleControlMessage(_msg: OutboundMessage): Promise<boolean>;
-    isAllowed(senderId: string): boolean;
-    protected handleMessage(params: {
-        senderId: string;
-        chatId: string;
-        content: string;
-        attachments?: InboundAttachment[];
-        metadata?: Record<string, unknown>;
-    }): Promise<void>;
-    get isRunning(): boolean;
-}
-
-declare class DingTalkChannel extends BaseChannel<Config["channels"]["dingtalk"]> {
-    name: string;
-    private client;
-    private accessToken;
-    private tokenExpiry;
-    constructor(config: Config["channels"]["dingtalk"], bus: MessageBus);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    send(msg: OutboundMessage): Promise<void>;
-    private handleRobotMessage;
-    private getAccessToken;
-}
-
-declare class DiscordChannel extends BaseChannel<Config["channels"]["discord"]> {
-    private sessionManager?;
-    private coreConfig?;
-    name: string;
-    private client;
-    private readonly typingController;
-    private readonly commandRegistry;
-    constructor(config: Config["channels"]["discord"], bus: MessageBus, sessionManager?: SessionManager | undefined, coreConfig?: Config | undefined);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    handleControlMessage(msg: OutboundMessage): Promise<boolean>;
-    send(msg: OutboundMessage): Promise<void>;
-    private handleIncoming;
-    private handleInteraction;
-    private handleSlashCommand;
-    private replyInteraction;
-    private registerSlashCommands;
-    private buildSlashCommandPayloads;
-    private resolveProxyAgent;
-    private resolveAccountId;
-    private isAllowedByPolicy;
-    private resolveMentionState;
-    private resolveInboundAttachment;
-    private startTyping;
-    private stopTyping;
-}
-
-declare class EmailChannel extends BaseChannel<Config["channels"]["email"]> {
-    name: string;
-    private lastSubjectByChat;
-    private lastMessageIdByChat;
-    private processedUids;
-    private maxProcessedUids;
-    constructor(config: Config["channels"]["email"], bus: MessageBus);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    send(msg: OutboundMessage): Promise<void>;
-    private validateConfig;
-    private replySubject;
-    private fetchNewMessages;
-}
-
-declare class FeishuChannel extends BaseChannel<Config["channels"]["feishu"]> {
-    name: string;
-    private client;
-    private wsClient;
-    private processedMessageIds;
-    private processedSet;
-    constructor(config: Config["channels"]["feishu"], bus: MessageBus);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    send(msg: OutboundMessage): Promise<void>;
-    private handleIncoming;
-    private isDuplicate;
-    private addReaction;
-}
-
-declare class MochatChannel extends BaseChannel<Config["channels"]["mochat"]> {
-    name: string;
-    private socket;
-    private wsConnected;
-    private wsReady;
-    private stateDir;
-    private cursorPath;
-    private sessionCursor;
-    private cursorSaveTimer;
-    private sessionSet;
-    private panelSet;
-    private autoDiscoverSessions;
-    private autoDiscoverPanels;
-    private coldSessions;
-    private sessionByConverse;
-    private seenSet;
-    private seenQueue;
-    private delayStates;
-    private fallbackMode;
-    private sessionFallbackTasks;
-    private panelFallbackTasks;
-    private refreshTimer;
-    private targetLocks;
-    private refreshInFlight;
-    constructor(config: Config["channels"]["mochat"], bus: MessageBus);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    send(msg: OutboundMessage): Promise<void>;
-    private seedTargetsFromConfig;
-    private startSocketClient;
-    private subscribeAll;
-    private subscribeSessions;
-    private subscribePanels;
-    private socketCall;
-    private refreshLoopTick;
-    private refreshTargets;
-    private refreshSessionsDirectory;
-    private refreshPanels;
-    private ensureFallbackWorkers;
-    private stopFallbackWorkers;
-    private sessionWatchWorker;
-    private panelPollWorker;
-    private handleWatchPayload;
-    private processInboundEvent;
-    private rememberMessageId;
-    private enqueueDelayedEntry;
-    private flushDelayedEntries;
-    private dispatchEntries;
-    private cancelDelayTimers;
-    private handleNotifyChatMessage;
-    private handleNotifyInboxAppend;
-    private markSessionCursor;
-    private loadSessionCursors;
-    private saveSessionCursors;
-    private postJson;
-    private apiSend;
-}
-
-declare class QQChannel extends BaseChannel<Config["channels"]["qq"]> {
-    name: string;
-    private bot;
-    private processedIds;
-    private processedSet;
-    private senderNameCache;
-    private reconnectTimer;
-    private connectTask;
-    private reconnectAttempt;
-    private readonly reconnectBaseMs;
-    private readonly reconnectMaxMs;
-    constructor(config: Config["channels"]["qq"], bus: MessageBus);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    send(msg: OutboundMessage): Promise<void>;
-    private sendByMessageType;
-    private handleIncoming;
-    private resolveSenderName;
-    private decorateSpeakerPrefix;
-    private sanitizeSpeakerToken;
-    private extractDeclaredName;
-    private isDuplicate;
-    private sendWithTokenRetry;
-    private isTokenExpiredError;
-    private isDisallowedUrlParamError;
-    private toQqSafeText;
-    private extractBlockedUrlToken;
-    private tryConnect;
-    private connect;
-    private createBot;
-    private handleSessionDead;
-    private scheduleReconnect;
-    private clearReconnectTimer;
-    private teardownBot;
-    private safeStopBot;
-    private getBackoffDelayMs;
-    private formatError;
-}
-
-declare class SlackChannel extends BaseChannel<Config["channels"]["slack"]> {
-    name: string;
-    private webClient;
-    private socketClient;
-    private botUserId;
-    private botId;
-    constructor(config: Config["channels"]["slack"], bus: MessageBus);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    send(msg: OutboundMessage): Promise<void>;
-    private handleEvent;
-    private isAllowedInSlack;
-    private shouldRespondInChannel;
-    private stripBotMention;
-}
-
-declare class TelegramChannel extends BaseChannel<Config["channels"]["telegram"]> {
-    private sessionManager?;
-    name: string;
-    private bot;
-    private botUserId;
-    private botUsername;
-    private readonly typingController;
-    private readonly streamPreview;
-    private transcriber;
-    constructor(config: Config["channels"]["telegram"], bus: MessageBus, groqApiKey?: string, sessionManager?: SessionManager | undefined);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    handleControlMessage(msg: OutboundMessage): Promise<boolean>;
-    send(msg: OutboundMessage): Promise<void>;
-    private handleIncoming;
-    private dispatchToBus;
-    private startTyping;
-    private stopTyping;
-    private resolveAccountId;
-    private maybeAddAckReaction;
-    private isAllowedByPolicy;
-    private resolveMentionState;
-}
-
-declare class WeComChannel extends BaseChannel<Config["channels"]["wecom"]> {
-    name: string;
-    private server;
-    private accessToken;
-    private tokenExpiry;
-    private processedIds;
-    private processedSet;
-    constructor(config: Config["channels"]["wecom"], bus: MessageBus);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    send(msg: OutboundMessage): Promise<void>;
-    private handleCallbackRequest;
-    private handleVerificationRequest;
-    private handleInboundMessageRequest;
-    private verifySignature;
-    private getAccessToken;
-    private isDuplicate;
-}
-
-declare class WhatsAppChannel extends BaseChannel<Config["channels"]["whatsapp"]> {
-    name: string;
-    private ws;
-    private connected;
-    constructor(config: Config["channels"]["whatsapp"], bus: MessageBus);
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    send(msg: OutboundMessage): Promise<void>;
-    private handleBridgeMessage;
-}
-
-type BuiltinChannelCreateContext = {
-    config: Config;
-    bus: MessageBus;
-    sessionManager?: SessionManager;
-};
-type BuiltinChannelRuntime = {
-    id: BuiltinChannelId;
-    isEnabled: (config: Config) => boolean;
-    createChannel: (context: BuiltinChannelCreateContext) => unknown;
-};
-declare const BUILTIN_CHANNEL_RUNTIMES: {
-    readonly telegram: {
-        readonly id: "telegram";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => TelegramChannel;
-    };
-    readonly whatsapp: {
-        readonly id: "whatsapp";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => WhatsAppChannel;
-    };
-    readonly discord: {
-        readonly id: "discord";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => DiscordChannel;
-    };
-    readonly feishu: {
-        readonly id: "feishu";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => FeishuChannel;
-    };
-    readonly mochat: {
-        readonly id: "mochat";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => MochatChannel;
-    };
-    readonly dingtalk: {
-        readonly id: "dingtalk";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => DingTalkChannel;
-    };
-    readonly wecom: {
-        readonly id: "wecom";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => WeComChannel;
-    };
-    readonly email: {
-        readonly id: "email";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => EmailChannel;
-    };
-    readonly slack: {
-        readonly id: "slack";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => SlackChannel;
-    };
-    readonly qq: {
-        readonly id: "qq";
-        readonly isEnabled: (config: Config) => boolean;
-        readonly createChannel: (context: BuiltinChannelCreateContext) => QQChannel;
-    };
-};
-type BuiltinChannelId = keyof typeof BUILTIN_CHANNEL_RUNTIMES;
-declare const BUILTIN_CHANNEL_PLUGIN_IDS: BuiltinChannelId[];
-declare function listBuiltinChannelRuntimes(): BuiltinChannelRuntime[];
-declare function resolveBuiltinChannelRuntime(channelId: string): BuiltinChannelRuntime;
-
-export { BUILTIN_CHANNEL_PLUGIN_IDS, type BuiltinChannelId, type BuiltinChannelRuntime, DingTalkChannel, DiscordChannel, EmailChannel, FeishuChannel, MochatChannel, QQChannel, SlackChannel, TelegramChannel, WeComChannel, WhatsAppChannel, listBuiltinChannelRuntimes, resolveBuiltinChannelRuntime };