@delt/claude-alarm 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,196 @@
+/** Session status */
+type SessionStatus = 'idle' | 'working' | 'waiting_input';
+/** Session info tracked by the hub */
+interface SessionInfo {
+    id: string;
+    name: string;
+    status: SessionStatus;
+    connectedAt: number;
+    lastActivity: number;
+    cwd?: string;
+}
+/** Messages sent between channel server and hub */
+type ChannelMessage = {
+    type: 'register';
+    session: SessionInfo;
+} | {
+    type: 'status';
+    sessionId: string;
+    status: SessionStatus;
+} | {
+    type: 'notify';
+    sessionId: string;
+    title: string;
+    message: string;
+    level?: NotifyLevel;
+} | {
+    type: 'reply';
+    sessionId: string;
+    content: string;
+} | {
+    type: 'message_to_session';
+    sessionId: string;
+    content: string;
+} | {
+    type: 'sessions_list';
+    sessions: SessionInfo[];
+} | {
+    type: 'session_connected';
+    session: SessionInfo;
+} | {
+    type: 'session_disconnected';
+    sessionId: string;
+} | {
+    type: 'session_updated';
+    session: SessionInfo;
+} | {
+    type: 'notification';
+    sessionId: string;
+    title: string;
+    message: string;
+    level?: NotifyLevel;
+    timestamp: number;
+} | {
+    type: 'reply_from_session';
+    sessionId: string;
+    content: string;
+    timestamp: number;
+} | {
+    type: 'error';
+    message: string;
+};
+type NotifyLevel = 'info' | 'warning' | 'error' | 'success';
+/** Webhook configuration */
+interface WebhookConfig {
+    url: string;
+    events?: string[];
+    headers?: Record<string, string>;
+}
+/** App configuration stored in ~/.claude-alarm/config.json */
+interface AppConfig {
+    hub: {
+        host: string;
+        port: number;
+        token?: string;
+    };
+    notifications: {
+        desktop: boolean;
+        sound: boolean;
+    };
+    webhooks: WebhookConfig[];
+}
+/** Hub status response */
+interface HubStatus {
+    running: boolean;
+    pid?: number;
+    port?: number;
+    sessions?: number;
+    uptime?: number;
+}
+
+declare class HubServer {
+    private httpServer;
+    private wssChannel;
+    private wssDashboard;
+    private sessions;
+    private notifier;
+    private startTime;
+    private channelSockets;
+    private dashboardSockets;
+    private host;
+    private port;
+    private token?;
+    constructor(config?: Partial<AppConfig>);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleHttp;
+    private serveDashboard;
+    private handleApiSend;
+    private handleApiNotify;
+    private handleChannelConnection;
+    private handleChannelMessage;
+    private handleDashboardConnection;
+    private broadcastToDashboards;
+    private jsonResponse;
+    private isLocalRequest;
+    private readBody;
+}
+
+declare class HubClient {
+    private sessionId;
+    private sessionName;
+    private hubHost;
+    private hubPort;
+    private token?;
+    private ws;
+    private reconnectTimer;
+    private messageHandlers;
+    private queue;
+    private connected;
+    constructor(sessionId: string, sessionName: string, hubHost?: string, hubPort?: number, token?: string | undefined);
+    connect(): void;
+    send(msg: ChannelMessage): void;
+    onMessage(handler: (msg: ChannelMessage) => void): void;
+    disconnect(): void;
+    private scheduleReconnect;
+}
+
+declare class SessionManager {
+    private sessions;
+    register(session: SessionInfo): void;
+    unregister(sessionId: string): SessionInfo | undefined;
+    updateStatus(sessionId: string, status: SessionStatus): SessionInfo | undefined;
+    updateActivity(sessionId: string): void;
+    get(sessionId: string): SessionInfo | undefined;
+    getAll(): SessionInfo[];
+    count(): number;
+}
+
+declare class Notifier {
+    private webhooks;
+    private desktopEnabled;
+    private notificationSettingsOpened;
+    private dashboardUrl?;
+    configure(options: {
+        desktop?: boolean;
+        webhooks?: WebhookConfig[];
+        dashboardUrl?: string;
+    }): void;
+    notify(title: string, message: string, level?: NotifyLevel): Promise<void>;
+    private sendDesktop;
+    private checkWindowsNotifications;
+    private openNotificationSettings;
+    private sendWebhook;
+}
+
+declare function loadConfig(): AppConfig;
+declare function saveConfig(config: AppConfig): void;
+/**
+ * Add claude-alarm as an MCP channel server to .mcp.json
+ */
+declare function setupMcpConfig(targetDir?: string): string;
+
+/**
+ * Logger that writes to stderr only.
+ * CRITICAL: In MCP channel servers, stdout is used for the stdio protocol.
+ * Any console.log() would corrupt the protocol. Always use this logger.
+ */
+declare const logger: {
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    error(msg: string, ...args: unknown[]): void;
+    debug(msg: string, ...args: unknown[]): void;
+};
+
+declare const DEFAULT_HUB_HOST = "127.0.0.1";
+declare const DEFAULT_HUB_PORT = 7890;
+declare const CONFIG_DIR: string;
+declare const CONFIG_FILE: string;
+declare const PID_FILE: string;
+declare const LOG_FILE: string;
+declare const WS_PATH_CHANNEL = "/ws/channel";
+declare const WS_PATH_DASHBOARD = "/ws/dashboard";
+declare const CHANNEL_SERVER_NAME = "claude-alarm";
+declare const CHANNEL_SERVER_VERSION = "0.1.0";
+
+export { type AppConfig, CHANNEL_SERVER_NAME, CHANNEL_SERVER_VERSION, CONFIG_DIR, CONFIG_FILE, type ChannelMessage, DEFAULT_HUB_HOST, DEFAULT_HUB_PORT, HubClient, HubServer, type HubStatus, LOG_FILE, Notifier, type NotifyLevel, PID_FILE, type SessionInfo, SessionManager, type SessionStatus, WS_PATH_CHANNEL, WS_PATH_DASHBOARD, type WebhookConfig, loadConfig, logger, saveConfig, setupMcpConfig };