claudecode-omc 4.3.4

package/dist/notifications/formatter.js

@@ -0,0 +1,231 @@
+/**
+ * Notification Message Formatters
+ *
+ * Produces human-readable notification messages for each event type.
+ * Supports markdown (Discord/Telegram) and plain text (Slack/webhook) formats.
+ */
+import { basename } from "path";
+/**
+ * Format duration from milliseconds to human-readable string.
+ */
+function formatDuration(ms) {
+    if (!ms)
+        return "unknown";
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+/**
+ * Get project display name from path.
+ */
+function projectDisplay(payload) {
+    if (payload.projectName)
+        return payload.projectName;
+    if (payload.projectPath)
+        return basename(payload.projectPath);
+    return "unknown";
+}
+/**
+ * Build common footer with tmux and project info.
+ */
+function buildFooter(payload, markdown) {
+    const parts = [];
+    if (payload.tmuxSession) {
+        parts.push(markdown
+            ? `**tmux:** \`${payload.tmuxSession}\``
+            : `tmux: ${payload.tmuxSession}`);
+    }
+    parts.push(markdown
+        ? `**project:** \`${projectDisplay(payload)}\``
+        : `project: ${projectDisplay(payload)}`);
+    return parts.join(markdown ? " | " : " | ");
+}
+/**
+ * Format session-start notification message.
+ */
+export function formatSessionStart(payload) {
+    const time = new Date(payload.timestamp).toLocaleTimeString();
+    const project = projectDisplay(payload);
+    const lines = [
+        `# Session Started`,
+        "",
+        `**Session:** \`${payload.sessionId}\``,
+        `**Project:** \`${project}\``,
+        `**Time:** ${time}`,
+    ];
+    if (payload.tmuxSession) {
+        lines.push(`**tmux:** \`${payload.tmuxSession}\``);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format session-stop notification message.
+ * Sent when persistent mode blocks a stop (mode is still active).
+ */
+export function formatSessionStop(payload) {
+    const lines = [`# Session Continuing`, ""];
+    if (payload.activeMode) {
+        lines.push(`**Mode:** ${payload.activeMode}`);
+    }
+    if (payload.iteration != null && payload.maxIterations != null) {
+        lines.push(`**Iteration:** ${payload.iteration}/${payload.maxIterations}`);
+    }
+    if (payload.incompleteTasks != null && payload.incompleteTasks > 0) {
+        lines.push(`**Incomplete tasks:** ${payload.incompleteTasks}`);
+    }
+    lines.push("");
+    lines.push(buildFooter(payload, true));
+    return lines.join("\n");
+}
+/**
+ * Format session-end notification message.
+ * Full summary with duration, agents, modes, and context.
+ */
+export function formatSessionEnd(payload) {
+    const duration = formatDuration(payload.durationMs);
+    const lines = [
+        `# Session Ended`,
+        "",
+        `**Session:** \`${payload.sessionId}\``,
+        `**Duration:** ${duration}`,
+        `**Reason:** ${payload.reason || "unknown"}`,
+    ];
+    if (payload.agentsSpawned != null) {
+        lines.push(`**Agents:** ${payload.agentsCompleted ?? 0}/${payload.agentsSpawned} completed`);
+    }
+    if (payload.modesUsed && payload.modesUsed.length > 0) {
+        lines.push(`**Modes:** ${payload.modesUsed.join(", ")}`);
+    }
+    if (payload.contextSummary) {
+        lines.push("", `**Summary:** ${payload.contextSummary}`);
+    }
+    appendTmuxTail(lines, payload);
+    lines.push("");
+    lines.push(buildFooter(payload, true));
+    return lines.join("\n");
+}
+/**
+ * Format session-idle notification message.
+ * Sent when Claude stops and no persistent mode is blocking (truly idle).
+ */
+export function formatSessionIdle(payload) {
+    const lines = [`# Session Idle`, ""];
+    lines.push(`Claude has finished and is waiting for input.`);
+    lines.push("");
+    if (payload.reason) {
+        lines.push(`**Reason:** ${payload.reason}`);
+    }
+    if (payload.modesUsed && payload.modesUsed.length > 0) {
+        lines.push(`**Modes:** ${payload.modesUsed.join(", ")}`);
+    }
+    appendTmuxTail(lines, payload);
+    lines.push("");
+    lines.push(buildFooter(payload, true));
+    return lines.join("\n");
+}
+/** Matches ANSI escape sequences (CSI and two-character escapes). */
+const ANSI_ESCAPE_RE = /\x1b(?:[@-Z\\-_]|\[[0-9;]*[a-zA-Z])/g;
+/** Lines starting with these characters are OMC UI chrome, not output. */
+const UI_CHROME_RE = /^[●⎿✻·◼]/;
+/** Matches the "ctrl+o to expand" hint injected by OMC. */
+const CTRL_O_RE = /ctrl\+o to expand/i;
+/** Maximum number of meaningful lines to include in a notification. */
+const MAX_TAIL_LINES = 10;
+/**
+ * Parse raw tmux output into clean, human-readable lines.
+ * - Strips ANSI escape codes
+ * - Drops lines starting with OMC chrome characters (●, ⎿, ✻, ·, ◼)
+ * - Drops "ctrl+o to expand" hint lines
+ * - Returns at most 10 non-empty lines
+ */
+export function parseTmuxTail(raw) {
+    const meaningful = [];
+    for (const line of raw.split("\n")) {
+        const stripped = line.replace(ANSI_ESCAPE_RE, "");
+        const trimmed = stripped.trim();
+        if (!trimmed)
+            continue;
+        if (UI_CHROME_RE.test(trimmed))
+            continue;
+        if (CTRL_O_RE.test(trimmed))
+            continue;
+        meaningful.push(stripped.trimEnd());
+    }
+    return meaningful.slice(-MAX_TAIL_LINES).join("\n");
+}
+/**
+ * Append tmux tail content to a message if present in the payload.
+ */
+function appendTmuxTail(lines, payload) {
+    if (payload.tmuxTail) {
+        const parsed = parseTmuxTail(payload.tmuxTail);
+        if (parsed) {
+            lines.push("");
+            lines.push("**Recent output:**");
+            lines.push("```");
+            lines.push(parsed);
+            lines.push("```");
+        }
+    }
+}
+/**
+ * Format agent-call notification message.
+ * Sent when a new agent (Task) is spawned.
+ */
+export function formatAgentCall(payload) {
+    const lines = [`# Agent Spawned`, ""];
+    if (payload.agentName) {
+        lines.push(`**Agent:** \`${payload.agentName}\``);
+    }
+    if (payload.agentType) {
+        lines.push(`**Type:** \`${payload.agentType}\``);
+    }
+    lines.push("");
+    lines.push(buildFooter(payload, true));
+    return lines.join("\n");
+}
+/**
+ * Format ask-user-question notification message.
+ * Notifies the user that Claude is waiting for input.
+ */
+export function formatAskUserQuestion(payload) {
+    const lines = [`# Input Needed`, ""];
+    if (payload.question) {
+        lines.push(`**Question:** ${payload.question}`);
+        lines.push("");
+    }
+    lines.push(`Claude is waiting for your response.`);
+    lines.push("");
+    lines.push(buildFooter(payload, true));
+    return lines.join("\n");
+}
+/**
+ * Format notification message based on event type.
+ * Returns a markdown-formatted string suitable for Discord/Telegram.
+ */
+export function formatNotification(payload) {
+    switch (payload.event) {
+        case "session-start":
+            return formatSessionStart(payload);
+        case "session-stop":
+            return formatSessionStop(payload);
+        case "session-end":
+            return formatSessionEnd(payload);
+        case "session-idle":
+            return formatSessionIdle(payload);
+        case "ask-user-question":
+            return formatAskUserQuestion(payload);
+        case "agent-call":
+            return formatAgentCall(payload);
+        default:
+            return payload.message || `Event: ${payload.event}`;
+    }
+}
+//# sourceMappingURL=formatter.js.map

package/dist/notifications/formatter.js.map

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

package/dist/notifications/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Notification System - Public API
+ *
+ * Multi-platform lifecycle notifications for oh-my-claudecode.
+ * Sends notifications to Discord, Telegram, Slack, and generic webhooks
+ * on session lifecycle events.
+ *
+ * Usage:
+ *   import { notify } from '../notifications/index.js';
+ *   await notify('session-start', { sessionId, projectPath, ... });
+ */
+export type { NotificationEvent, NotificationPlatform, NotificationConfig, NotificationProfilesConfig, NotificationPayload, NotificationResult, DispatchResult, DiscordNotificationConfig, DiscordBotNotificationConfig, TelegramNotificationConfig, SlackNotificationConfig, WebhookNotificationConfig, EventNotificationConfig, } from "./types.js";
+export { dispatchNotifications, sendDiscord, sendDiscordBot, sendTelegram, sendSlack, sendWebhook, } from "./dispatcher.js";
+export { formatNotification, formatSessionStart, formatSessionStop, formatSessionEnd, formatSessionIdle, formatAskUserQuestion, formatAgentCall, } from "./formatter.js";
+export { getCurrentTmuxSession, getCurrentTmuxPaneId, getTeamTmuxSessions, formatTmuxInfo, } from "./tmux.js";
+export { getNotificationConfig, isEventEnabled, getEnabledPlatforms, getVerbosity, isEventAllowedByVerbosity, shouldIncludeTmuxTail, } from "./config.js";
+import type { NotificationEvent, NotificationPayload, DispatchResult } from "./types.js";
+/**
+ * High-level notification function.
+ *
+ * Reads config, checks if the event is enabled, formats the message,
+ * and dispatches to all configured platforms. Non-blocking, swallows errors.
+ *
+ * @param event - The notification event type
+ * @param data - Partial payload data (message will be auto-formatted if not provided)
+ * @returns DispatchResult or null if notifications are not configured/enabled
+ */
+export declare function notify(event: NotificationEvent, data: Partial<NotificationPayload> & {
+    sessionId: string;
+    profileName?: string;
+}): Promise<DispatchResult | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACf,MAAM,YAAY,CAAC;AAapB;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAC1B,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA6GhC"}

package/dist/notifications/index.js

@@ -0,0 +1,125 @@
+/**
+ * Notification System - Public API
+ *
+ * Multi-platform lifecycle notifications for oh-my-claudecode.
+ * Sends notifications to Discord, Telegram, Slack, and generic webhooks
+ * on session lifecycle events.
+ *
+ * Usage:
+ *   import { notify } from '../notifications/index.js';
+ *   await notify('session-start', { sessionId, projectPath, ... });
+ */
+export { dispatchNotifications, sendDiscord, sendDiscordBot, sendTelegram, sendSlack, sendWebhook, } from "./dispatcher.js";
+export { formatNotification, formatSessionStart, formatSessionStop, formatSessionEnd, formatSessionIdle, formatAskUserQuestion, formatAgentCall, } from "./formatter.js";
+export { getCurrentTmuxSession, getCurrentTmuxPaneId, getTeamTmuxSessions, formatTmuxInfo, } from "./tmux.js";
+export { getNotificationConfig, isEventEnabled, getEnabledPlatforms, getVerbosity, isEventAllowedByVerbosity, shouldIncludeTmuxTail, } from "./config.js";
+import { getNotificationConfig, isEventEnabled, getVerbosity, isEventAllowedByVerbosity, shouldIncludeTmuxTail, } from "./config.js";
+import { formatNotification } from "./formatter.js";
+import { dispatchNotifications } from "./dispatcher.js";
+import { getCurrentTmuxSession } from "./tmux.js";
+import { basename } from "path";
+/**
+ * High-level notification function.
+ *
+ * Reads config, checks if the event is enabled, formats the message,
+ * and dispatches to all configured platforms. Non-blocking, swallows errors.
+ *
+ * @param event - The notification event type
+ * @param data - Partial payload data (message will be auto-formatted if not provided)
+ * @returns DispatchResult or null if notifications are not configured/enabled
+ */
+export async function notify(event, data) {
+    // OMC_NOTIFY=0 suppresses all CCNotifier events (set by `omc --notify false`)
+    if (process.env.OMC_NOTIFY === '0') {
+        return null;
+    }
+    try {
+        const config = getNotificationConfig(data.profileName);
+        if (!config || !isEventEnabled(config, event)) {
+            return null;
+        }
+        // Verbosity filter (second gate after isEventEnabled)
+        const verbosity = getVerbosity(config);
+        if (!isEventAllowedByVerbosity(verbosity, event)) {
+            return null;
+        }
+        // Get tmux pane ID
+        const { getCurrentTmuxPaneId } = await import("./tmux.js");
+        // Build the full payload
+        const payload = {
+            event,
+            sessionId: data.sessionId,
+            message: "", // Will be formatted below
+            timestamp: data.timestamp || new Date().toISOString(),
+            tmuxSession: data.tmuxSession ?? getCurrentTmuxSession() ?? undefined,
+            tmuxPaneId: data.tmuxPaneId ?? getCurrentTmuxPaneId() ?? undefined,
+            projectPath: data.projectPath,
+            projectName: data.projectName ||
+                (data.projectPath ? basename(data.projectPath) : undefined),
+            modesUsed: data.modesUsed,
+            contextSummary: data.contextSummary,
+            durationMs: data.durationMs,
+            agentsSpawned: data.agentsSpawned,
+            agentsCompleted: data.agentsCompleted,
+            reason: data.reason,
+            activeMode: data.activeMode,
+            iteration: data.iteration,
+            maxIterations: data.maxIterations,
+            question: data.question,
+            incompleteTasks: data.incompleteTasks,
+            agentName: data.agentName,
+            agentType: data.agentType,
+        };
+        // Capture tmux tail for events that benefit from it
+        if (shouldIncludeTmuxTail(verbosity) &&
+            payload.tmuxPaneId &&
+            (event === "session-idle" || event === "session-end" || event === "session-stop")) {
+            try {
+                const { capturePaneContent } = await import("../features/rate-limit-wait/tmux-detector.js");
+                const tail = capturePaneContent(payload.tmuxPaneId, 15);
+                if (tail) {
+                    payload.tmuxTail = tail;
+                }
+            }
+            catch {
+                // Non-blocking: tmux capture is best-effort
+            }
+        }
+        // Format the message
+        payload.message = data.message || formatNotification(payload);
+        // Dispatch to all enabled platforms
+        const result = await dispatchNotifications(config, event, payload);
+        // NEW: Register message IDs for reply correlation
+        if (result.anySuccess && payload.tmuxPaneId) {
+            try {
+                const { registerMessage } = await import("./session-registry.js");
+                for (const r of result.results) {
+                    if (r.success &&
+                        r.messageId &&
+                        (r.platform === "discord-bot" || r.platform === "telegram")) {
+                        registerMessage({
+                            platform: r.platform,
+                            messageId: r.messageId,
+                            sessionId: payload.sessionId,
+                            tmuxPaneId: payload.tmuxPaneId,
+                            tmuxSessionName: payload.tmuxSession || "",
+                            event: payload.event,
+                            createdAt: new Date().toISOString(),
+                            projectPath: payload.projectPath,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Non-fatal: reply correlation is best-effort
+            }
+        }
+        return result;
+    }
+    catch (error) {
+        // Never let notification failures propagate to hooks
+        console.error("[notifications] Error:", error instanceof Error ? error.message : error);
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

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

package/dist/notifications/reply-listener.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Reply Listener Daemon
+ *
+ * Background daemon that polls Discord and Telegram for replies to notification messages,
+ * sanitizes input, verifies the target pane, and injects reply text via sendToPane().
+ *
+ * Security considerations:
+ * - State/PID/log files use restrictive permissions (0600)
+ * - Bot tokens stored in state file, NOT in environment variables
+ * - Two-layer input sanitization (sanitizeReplyInput + sanitizeForTmux)
+ * - Pane verification via analyzePaneContent before every injection
+ * - Authorization: only configured user IDs (Discord) / chat ID (Telegram) can inject
+ * - Rate limiting to prevent spam/abuse
+ *
+ * Follows the daemon pattern from src/features/rate-limit-wait/daemon.ts
+ */
+import type { ReplyConfig } from './types.js';
+/** Reply listener daemon state */
+export interface ReplyListenerState {
+    isRunning: boolean;
+    pid: number | null;
+    startedAt: string | null;
+    lastPollAt: string | null;
+    telegramLastUpdateId: number | null;
+    discordLastMessageId: string | null;
+    messagesInjected: number;
+    errors: number;
+    lastError?: string;
+}
+/** Daemon configuration (written to state file) */
+export interface ReplyListenerDaemonConfig extends ReplyConfig {
+    telegramBotToken?: string;
+    telegramChatId?: string;
+    discordBotToken?: string;
+    discordChannelId?: string;
+    /** Discord mention tag to include in injection feedback (e.g. "<@123456>") */
+    discordMention?: string;
+}
+/** Response from daemon operations */
+export interface DaemonResponse {
+    success: boolean;
+    message: string;
+    state?: ReplyListenerState;
+    error?: string;
+}
+/**
+ * Check if daemon is currently running
+ */
+export declare function isDaemonRunning(): boolean;
+/**
+ * Sanitize reply input from Discord/Telegram before tmux injection.
+ * Applied BEFORE sendToPane()'s own sanitizeForTmux().
+ *
+ * Defenses:
+ * - Newlines replaced with spaces (prevents multi-command injection)
+ * - Backticks escaped (prevents command substitution in some shells)
+ * - $() and ${} patterns escaped (prevents command substitution)
+ * - Backslashes escaped (prevents escape sequence injection)
+ * - Control characters stripped
+ */
+export declare function sanitizeReplyInput(text: string): string;
+/**
+ * Main daemon polling loop
+ */
+declare function pollLoop(): Promise<void>;
+/**
+ * Start the reply listener daemon.
+ *
+ * Forks a daemon process that derives its config from getNotificationConfig().
+ * OMC_* env vars are forwarded so the daemon can read both file and env config.
+ *
+ * Idempotent: if daemon is already running, returns success.
+ *
+ * @param config - Daemon config (used only for validation, daemon reads config independently)
+ */
+export declare function startReplyListener(_config: ReplyListenerDaemonConfig): DaemonResponse;
+/**
+ * Stop the reply listener daemon
+ */
+export declare function stopReplyListener(): DaemonResponse;
+/**
+ * Get daemon status
+ */
+export declare function getReplyListenerStatus(): DaemonResponse;
+export { pollLoop };
+//# sourceMappingURL=reply-listener.d.ts.map

package/dist/notifications/reply-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply-listener.d.ts","sourceRoot":"","sources":["../../src/notifications/reply-listener.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAwC9C,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAE5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAYzC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASvD;AAuZD;;GAEG;AACH,iBAAe,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAkFvC;AAMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,cAAc,CA2ErF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CA2ClD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,CAwBvD;AAGD,OAAO,EAAE,QAAQ,EAAE,CAAC"}