@nextclaw/channel-runtime 0.1.1

package/README.md

@@ -0,0 +1,9 @@
+# @nextclaw/channel-runtime
+
+Runtime implementations for NextClaw builtin channels.
+
+This package is consumed by channel plugin packages such as:
+
+- `@nextclaw/channel-plugin-telegram`
+- `@nextclaw/channel-plugin-discord`
+- `@nextclaw/channel-plugin-email`

package/dist/index.d.ts

@@ -0,0 +1,280 @@
+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>;
+    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"]> {
+    name: string;
+    private client;
+    private typingTasks;
+    constructor(config: Config["channels"]["discord"], bus: MessageBus);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(msg: OutboundMessage): Promise<void>;
+    private handleIncoming;
+    private resolveProxyAgent;
+    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;
+    constructor(config: Config["channels"]["qq"], bus: MessageBus);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(msg: OutboundMessage): Promise<void>;
+    private handleIncoming;
+    private isDuplicate;
+    private sendWithTokenRetry;
+    private isTokenExpiredError;
+}
+
+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 typingTasks;
+    private transcriber;
+    constructor(config: Config["channels"]["telegram"], bus: MessageBus, groqApiKey?: string, sessionManager?: SessionManager | undefined);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    send(msg: OutboundMessage): Promise<void>;
+    private handleIncoming;
+    private dispatchToBus;
+    private startTyping;
+    private stopTyping;
+}
+
+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 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, WhatsAppChannel, listBuiltinChannelRuntimes, resolveBuiltinChannelRuntime };