oh-my-codex 0.3.8 → 0.3.10

package/dist/notifications/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Notification System - Public API
+ *
+ * Multi-platform lifecycle notifications for oh-my-codex.
+ * Sends notifications to Discord, Telegram, Slack, and generic webhooks
+ * on session lifecycle events.
+ *
+ * Usage:
+ *   import { notifyLifecycle } from '../notifications/index.js';
+ *   await notifyLifecycle('session-start', { sessionId, projectPath, ... });
+ */
+export type { NotificationEvent, NotificationPlatform, FullNotificationConfig, FullNotificationPayload, NotificationResult, DispatchResult, DiscordNotificationConfig, DiscordBotNotificationConfig, TelegramNotificationConfig, SlackNotificationConfig, WebhookNotificationConfig, EventNotificationConfig, ReplyConfig, NotificationProfilesConfig, NotificationsBlock, } from "./types.js";
+export { dispatchNotifications, sendDiscord, sendDiscordBot, sendTelegram, sendSlack, sendWebhook, } from "./dispatcher.js";
+export { formatNotification, formatSessionStart, formatSessionStop, formatSessionEnd, formatSessionIdle, formatAskUserQuestion, } from "./formatter.js";
+export { getCurrentTmuxSession, getCurrentTmuxPaneId, getTeamTmuxSessions, formatTmuxInfo, } from "./tmux.js";
+export { getNotificationConfig, isEventEnabled, getEnabledPlatforms, getReplyConfig, getReplyListenerPlatformConfig, resolveProfileConfig, listProfiles, getActiveProfileName, } from "./config.js";
+export { registerMessage, loadAllMappings, lookupByMessageId, removeSession, removeMessagesByPane, pruneStale, } from "./session-registry.js";
+export type { SessionMapping } from "./session-registry.js";
+export { startReplyListener, stopReplyListener, getReplyListenerStatus, isDaemonRunning, sanitizeReplyInput, } from "./reply-listener.js";
+export { notify, loadNotificationConfig } from "./notifier.js";
+export type { NotificationConfig, NotificationPayload } from "./notifier.js";
+import type { NotificationEvent, FullNotificationPayload, DispatchResult } from "./types.js";
+/**
+ * High-level notification function for lifecycle events.
+ *
+ * Reads config, checks if the event is enabled, formats the message,
+ * and dispatches to all configured platforms. Non-blocking, swallows errors.
+ */
+export declare function notifyLifecycle(event: NotificationEvent, data: Partial<FullNotificationPayload> & {
+    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,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,WAAW,EACX,0BAA0B,EAC1B,kBAAkB,GACnB,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,GACtB,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,cAAc,EACd,8BAA8B,EAC9B,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,UAAU,GACX,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACf,MAAM,YAAY,CAAC;AAOpB;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC9D,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAuEhC"}

package/dist/notifications/index.js

@@ -0,0 +1,93 @@
+/**
+ * Notification System - Public API
+ *
+ * Multi-platform lifecycle notifications for oh-my-codex.
+ * Sends notifications to Discord, Telegram, Slack, and generic webhooks
+ * on session lifecycle events.
+ *
+ * Usage:
+ *   import { notifyLifecycle } from '../notifications/index.js';
+ *   await notifyLifecycle('session-start', { sessionId, projectPath, ... });
+ */
+export { dispatchNotifications, sendDiscord, sendDiscordBot, sendTelegram, sendSlack, sendWebhook, } from "./dispatcher.js";
+export { formatNotification, formatSessionStart, formatSessionStop, formatSessionEnd, formatSessionIdle, formatAskUserQuestion, } from "./formatter.js";
+export { getCurrentTmuxSession, getCurrentTmuxPaneId, getTeamTmuxSessions, formatTmuxInfo, } from "./tmux.js";
+export { getNotificationConfig, isEventEnabled, getEnabledPlatforms, getReplyConfig, getReplyListenerPlatformConfig, resolveProfileConfig, listProfiles, getActiveProfileName, } from "./config.js";
+export { registerMessage, loadAllMappings, lookupByMessageId, removeSession, removeMessagesByPane, pruneStale, } from "./session-registry.js";
+export { startReplyListener, stopReplyListener, getReplyListenerStatus, isDaemonRunning, sanitizeReplyInput, } from "./reply-listener.js";
+// Re-export the legacy notifier for backward compatibility
+export { notify, loadNotificationConfig } from "./notifier.js";
+import { getNotificationConfig, isEventEnabled } 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 for lifecycle events.
+ *
+ * Reads config, checks if the event is enabled, formats the message,
+ * and dispatches to all configured platforms. Non-blocking, swallows errors.
+ */
+export async function notifyLifecycle(event, data, profileName) {
+    try {
+        const config = getNotificationConfig(profileName);
+        if (!config || !isEventEnabled(config, event)) {
+            return null;
+        }
+        const { getCurrentTmuxPaneId } = await import("./tmux.js");
+        const payload = {
+            event,
+            sessionId: data.sessionId,
+            message: "",
+            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,
+        };
+        payload.message = data.message || formatNotification(payload);
+        const result = await dispatchNotifications(config, event, payload);
+        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) {
+        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,47 @@
+/**
+ * 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
+ */
+import type { ReplyConfig } from './types.js';
+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;
+}
+export interface ReplyListenerDaemonConfig extends ReplyConfig {
+    telegramBotToken?: string;
+    telegramChatId?: string;
+    discordBotToken?: string;
+    discordChannelId?: string;
+    discordMention?: string;
+}
+export interface DaemonResponse {
+    success: boolean;
+    message: string;
+    state?: ReplyListenerState;
+    error?: string;
+}
+export declare function isDaemonRunning(): boolean;
+export declare function sanitizeReplyInput(text: string): string;
+declare function pollLoop(): Promise<void>;
+export declare function startReplyListener(config: ReplyListenerDaemonConfig): DaemonResponse;
+export declare function stopReplyListener(): DaemonResponse;
+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;;;;;;;;;;;;;GAaG;AAoBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAyB9C,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,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,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;AAmHD,wBAAgB,eAAe,IAAI,OAAO,CAUzC;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASvD;AAwVD,iBAAe,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAyEvC;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,yBAAyB,GAAG,cAAc,CAwEpF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CA2ClD;AAED,wBAAgB,sBAAsB,IAAI,cAAc,CAwBvD;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}