@phuetz/code-buddy 0.1.12 → 0.1.14

package/dist/channels/offline-queue.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Offline Queue
+ *
+ * Buffers outbound messages when a channel is disconnected.
+ * Messages can be drained and sent when the channel reconnects.
+ *
+ * Features:
+ * - FIFO message buffering
+ * - Configurable maximum queue size
+ * - Oldest messages dropped when queue is full
+ * - Drain returns all queued messages in order
+ */
+/**
+ * A queued message waiting to be delivered
+ */
+export interface QueuedMessage {
+    /** Target channel/conversation ID */
+    channelId: string;
+    /** Message content */
+    content: string;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+    /** Timestamp when the message was queued */
+    queuedAt: Date;
+}
+/**
+ * Buffers messages for later delivery when a channel is offline.
+ *
+ * Usage:
+ * ```typescript
+ * const queue = new OfflineQueue(50);
+ *
+ * // When disconnected, queue outgoing messages
+ * queue.enqueue({ channelId: '123', content: 'Hello' });
+ *
+ * // When reconnected, drain and send
+ * const messages = queue.drain();
+ * for (const msg of messages) {
+ *   await channel.send(msg);
+ * }
+ * ```
+ */
+export declare class OfflineQueue {
+    private readonly maxSize;
+    private queue;
+    /**
+     * @param maxSize - Maximum number of messages to buffer (default: 100).
+     *                  When exceeded, oldest messages are dropped.
+     */
+    constructor(maxSize?: number);
+    /**
+     * Queue a message for later delivery.
+     *
+     * @param message - The message to enqueue (channelId, content, optional metadata)
+     * @returns true if the message was queued, false if it replaced an older message
+     */
+    enqueue(message: {
+        channelId: string;
+        content: string;
+        metadata?: Record<string, unknown>;
+    }): boolean;
+    /**
+     * Drain all queued messages.
+     *
+     * Returns all queued messages in FIFO order and clears the queue.
+     */
+    drain(): QueuedMessage[];
+    /**
+     * Get the current queue size.
+     */
+    size(): number;
+    /**
+     * Clear all queued messages without returning them.
+     */
+    clear(): void;
+    /**
+     * Peek at the next message without removing it.
+     */
+    peek(): QueuedMessage | undefined;
+    /**
+     * Check if the queue is empty.
+     */
+    isEmpty(): boolean;
+    /**
+     * Check if the queue is full.
+     */
+    isFull(): boolean;
+    /**
+     * Get the maximum queue size.
+     */
+    getMaxSize(): number;
+}

package/dist/channels/offline-queue.js

@@ -0,0 +1,112 @@
+/**
+ * Offline Queue
+ *
+ * Buffers outbound messages when a channel is disconnected.
+ * Messages can be drained and sent when the channel reconnects.
+ *
+ * Features:
+ * - FIFO message buffering
+ * - Configurable maximum queue size
+ * - Oldest messages dropped when queue is full
+ * - Drain returns all queued messages in order
+ */
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Buffers messages for later delivery when a channel is offline.
+ *
+ * Usage:
+ * ```typescript
+ * const queue = new OfflineQueue(50);
+ *
+ * // When disconnected, queue outgoing messages
+ * queue.enqueue({ channelId: '123', content: 'Hello' });
+ *
+ * // When reconnected, drain and send
+ * const messages = queue.drain();
+ * for (const msg of messages) {
+ *   await channel.send(msg);
+ * }
+ * ```
+ */
+export class OfflineQueue {
+    maxSize;
+    queue = [];
+    /**
+     * @param maxSize - Maximum number of messages to buffer (default: 100).
+     *                  When exceeded, oldest messages are dropped.
+     */
+    constructor(maxSize = 100) {
+        this.maxSize = Math.max(1, maxSize);
+    }
+    /**
+     * Queue a message for later delivery.
+     *
+     * @param message - The message to enqueue (channelId, content, optional metadata)
+     * @returns true if the message was queued, false if it replaced an older message
+     */
+    enqueue(message) {
+        const entry = {
+            channelId: message.channelId,
+            content: message.content,
+            metadata: message.metadata,
+            queuedAt: new Date(),
+        };
+        if (this.queue.length >= this.maxSize) {
+            // Drop oldest message to make room
+            this.queue.shift();
+            this.queue.push(entry);
+            return false;
+        }
+        this.queue.push(entry);
+        return true;
+    }
+    /**
+     * Drain all queued messages.
+     *
+     * Returns all queued messages in FIFO order and clears the queue.
+     */
+    drain() {
+        const messages = this.queue;
+        this.queue = [];
+        return messages;
+    }
+    /**
+     * Get the current queue size.
+     */
+    size() {
+        return this.queue.length;
+    }
+    /**
+     * Clear all queued messages without returning them.
+     */
+    clear() {
+        this.queue = [];
+    }
+    /**
+     * Peek at the next message without removing it.
+     */
+    peek() {
+        return this.queue[0];
+    }
+    /**
+     * Check if the queue is empty.
+     */
+    isEmpty() {
+        return this.queue.length === 0;
+    }
+    /**
+     * Check if the queue is full.
+     */
+    isFull() {
+        return this.queue.length >= this.maxSize;
+    }
+    /**
+     * Get the maximum queue size.
+     */
+    getMaxSize() {
+        return this.maxSize;
+    }
+}
+//# sourceMappingURL=offline-queue.js.map

package/dist/channels/offline-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-queue.js","sourceRoot":"","sources":["../../src/channels/offline-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,YAAY;IACN,OAAO,CAAS;IACzB,KAAK,GAAoB,EAAE,CAAC;IAEpC;;;OAGG;IACH,YAAY,OAAO,GAAG,GAAG;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAIP;QACC,MAAM,KAAK,GAAkB;YAC3B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,mCAAmC;YACnC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/channels/reconnection-manager.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Reconnection Manager
+ *
+ * A shared reconnection utility with exponential backoff for channel adapters.
+ * Provides consistent reconnection behavior across all channel implementations.
+ *
+ * Features:
+ * - Exponential backoff with configurable multiplier
+ * - Random jitter to prevent thundering herd
+ * - Maximum retry limit with exhaustion detection
+ * - Event-based notification of state changes
+ * - Cancellation support for pending reconnections
+ */
+import { EventEmitter } from 'events';
+/**
+ * Configuration for reconnection behavior
+ */
+export interface ReconnectionConfig {
+    /** Maximum number of retry attempts before giving up (default: 10) */
+    maxRetries: number;
+    /** Initial delay in milliseconds before the first retry (default: 1000) */
+    initialDelayMs: number;
+    /** Maximum delay in milliseconds between retries (default: 60000) */
+    maxDelayMs: number;
+    /** Multiplier applied to delay after each retry (default: 2) */
+    backoffMultiplier: number;
+    /** Random jitter in milliseconds added to delay (default: 500) */
+    jitterMs: number;
+}
+/**
+ * Events emitted by the ReconnectionManager
+ */
+export interface ReconnectionEvents {
+    /** Emitted when a reconnection attempt is about to start */
+    reconnecting: (attempt: number, delayMs: number) => void;
+    /** Emitted when a reconnection attempt succeeds */
+    reconnected: (attempt: number) => void;
+    /** Emitted when all retry attempts are exhausted */
+    exhausted: (totalAttempts: number) => void;
+    /** Emitted when a reconnection attempt fails */
+    error: (error: Error, attempt: number) => void;
+}
+/**
+ * Manages reconnection attempts with exponential backoff for a named channel.
+ *
+ * Usage:
+ * ```typescript
+ * const reconnector = new ReconnectionManager('discord');
+ *
+ * // On connection loss
+ * reconnector.scheduleReconnect(async () => {
+ *   await channel.connect();
+ * });
+ *
+ * // On successful connection
+ * reconnector.onConnected();
+ *
+ * // On shutdown
+ * reconnector.cancel();
+ * ```
+ */
+export declare class ReconnectionManager extends EventEmitter {
+    private readonly name;
+    private readonly config;
+    private retryCount;
+    private pendingTimer;
+    private active;
+    constructor(name: string, config?: Partial<ReconnectionConfig>);
+    /**
+     * Schedule a reconnection attempt.
+     *
+     * Calculates the appropriate delay using exponential backoff with jitter
+     * and schedules the provided connect function. If max retries have been
+     * exceeded, emits the 'exhausted' event instead.
+     *
+     * @param connectFn - Async function that performs the connection attempt
+     */
+    scheduleReconnect(connectFn: () => Promise<void>): void;
+    /**
+     * Reset retry counter on successful connection.
+     *
+     * Call this when the channel has successfully connected
+     * (whether from an initial connect or a reconnection attempt).
+     */
+    onConnected(): void;
+    /**
+     * Check if maximum retries have been exceeded.
+     */
+    isExhausted(): boolean;
+    /**
+     * Get current retry count.
+     */
+    getRetryCount(): number;
+    /**
+     * Cancel any pending reconnection attempt.
+     */
+    cancel(): void;
+    /**
+     * Get the delay for the next retry attempt.
+     *
+     * Uses exponential backoff: initialDelay * multiplier^(retryCount-1)
+     * Capped at maxDelayMs. Adds random jitter.
+     */
+    getCurrentDelay(): number;
+    /**
+     * Check if a reconnection is currently pending.
+     */
+    isPending(): boolean;
+    /**
+     * Get the channel name this manager is for.
+     */
+    getName(): string;
+    /**
+     * Get the current configuration.
+     */
+    getConfig(): Readonly<ReconnectionConfig>;
+}

package/dist/channels/reconnection-manager.js

@@ -0,0 +1,171 @@
+/**
+ * Reconnection Manager
+ *
+ * A shared reconnection utility with exponential backoff for channel adapters.
+ * Provides consistent reconnection behavior across all channel implementations.
+ *
+ * Features:
+ * - Exponential backoff with configurable multiplier
+ * - Random jitter to prevent thundering herd
+ * - Maximum retry limit with exhaustion detection
+ * - Event-based notification of state changes
+ * - Cancellation support for pending reconnections
+ */
+import { EventEmitter } from 'events';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    maxRetries: 10,
+    initialDelayMs: 1000,
+    maxDelayMs: 60000,
+    backoffMultiplier: 2,
+    jitterMs: 500,
+};
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Manages reconnection attempts with exponential backoff for a named channel.
+ *
+ * Usage:
+ * ```typescript
+ * const reconnector = new ReconnectionManager('discord');
+ *
+ * // On connection loss
+ * reconnector.scheduleReconnect(async () => {
+ *   await channel.connect();
+ * });
+ *
+ * // On successful connection
+ * reconnector.onConnected();
+ *
+ * // On shutdown
+ * reconnector.cancel();
+ * ```
+ */
+export class ReconnectionManager extends EventEmitter {
+    name;
+    config;
+    retryCount = 0;
+    pendingTimer = null;
+    active = false;
+    constructor(name, config) {
+        super();
+        this.name = name;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Schedule a reconnection attempt.
+     *
+     * Calculates the appropriate delay using exponential backoff with jitter
+     * and schedules the provided connect function. If max retries have been
+     * exceeded, emits the 'exhausted' event instead.
+     *
+     * @param connectFn - Async function that performs the connection attempt
+     */
+    scheduleReconnect(connectFn) {
+        // Prevent concurrent reconnection schedules
+        if (this.active)
+            return;
+        if (this.isExhausted()) {
+            logger.debug(`${this.name}: reconnection exhausted after ${this.retryCount} attempts`);
+            this.emit('exhausted', this.retryCount);
+            return;
+        }
+        this.retryCount++;
+        const delay = this.getCurrentDelay();
+        this.active = true;
+        logger.debug(`${this.name}: scheduling reconnect attempt ${this.retryCount}/${this.config.maxRetries} in ${delay}ms`);
+        this.emit('reconnecting', this.retryCount, delay);
+        this.pendingTimer = setTimeout(async () => {
+            this.pendingTimer = null;
+            try {
+                await connectFn();
+                // If connectFn succeeds without throwing, emit reconnected
+                this.emit('reconnected', this.retryCount);
+                // Note: caller should call onConnected() to reset the state
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                logger.debug(`${this.name}: reconnect attempt ${this.retryCount} failed`, {
+                    error: error.message,
+                });
+                this.emit('error', error, this.retryCount);
+            }
+            finally {
+                this.active = false;
+            }
+        }, delay);
+    }
+    /**
+     * Reset retry counter on successful connection.
+     *
+     * Call this when the channel has successfully connected
+     * (whether from an initial connect or a reconnection attempt).
+     */
+    onConnected() {
+        this.retryCount = 0;
+        this.active = false;
+        if (this.pendingTimer) {
+            clearTimeout(this.pendingTimer);
+            this.pendingTimer = null;
+        }
+    }
+    /**
+     * Check if maximum retries have been exceeded.
+     */
+    isExhausted() {
+        return this.retryCount >= this.config.maxRetries;
+    }
+    /**
+     * Get current retry count.
+     */
+    getRetryCount() {
+        return this.retryCount;
+    }
+    /**
+     * Cancel any pending reconnection attempt.
+     */
+    cancel() {
+        this.active = false;
+        if (this.pendingTimer) {
+            clearTimeout(this.pendingTimer);
+            this.pendingTimer = null;
+        }
+    }
+    /**
+     * Get the delay for the next retry attempt.
+     *
+     * Uses exponential backoff: initialDelay * multiplier^(retryCount-1)
+     * Capped at maxDelayMs. Adds random jitter.
+     */
+    getCurrentDelay() {
+        const exponentialDelay = this.config.initialDelayMs *
+            Math.pow(this.config.backoffMultiplier, Math.max(0, this.retryCount - 1));
+        const cappedDelay = Math.min(exponentialDelay, this.config.maxDelayMs);
+        // Add random jitter: [0, jitterMs)
+        const jitter = Math.floor(Math.random() * this.config.jitterMs);
+        return cappedDelay + jitter;
+    }
+    /**
+     * Check if a reconnection is currently pending.
+     */
+    isPending() {
+        return this.active || this.pendingTimer !== null;
+    }
+    /**
+     * Get the channel name this manager is for.
+     */
+    getName() {
+        return this.name;
+    }
+    /**
+     * Get the current configuration.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=reconnection-manager.js.map

package/dist/channels/reconnection-manager.js.map

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

package/dist/channels/signal/index.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Signal Channel Adapter
+ *
+ * Signal integration via signal-cli REST API.
+ * Requires a running signal-cli-rest-api instance
+ * (https://github.com/bbernhard/signal-cli-rest-api).
+ *
+ * Supports text messages, attachments, group messaging,
+ * and message reactions via the REST API.
+ */
+import type { ChannelConfig, OutboundMessage, DeliveryResult } from '../index.js';
+import { BaseChannel } from '../index.js';
+/**
+ * Signal-specific configuration
+ */
+export interface SignalConfig extends ChannelConfig {
+    type: 'signal';
+    /** signal-cli REST API base URL (default: http://localhost:8080) */
+    apiUrl?: string;
+    /** Phone number registered with signal-cli (with country code, e.g. +1234567890) */
+    phoneNumber: string;
+    /** Polling interval in ms for receiving messages (default: 2000) */
+    pollInterval?: number;
+    /** Trust all known identities (skip safety number verification) */
+    trustAllIdentities?: boolean;
+}
+/**
+ * Signal message from the REST API
+ */
+export interface SignalMessage {
+    envelope: {
+        source?: string;
+        sourceNumber?: string;
+        sourceName?: string;
+        sourceUuid?: string;
+        timestamp?: number;
+        dataMessage?: {
+            timestamp?: number;
+            message?: string;
+            expiresInSeconds?: number;
+            groupInfo?: {
+                groupId: string;
+                type?: string;
+            };
+            attachments?: SignalAttachment[];
+            quote?: {
+                id: number;
+                author: string;
+                text: string;
+            };
+            reaction?: {
+                emoji: string;
+                targetAuthor: string;
+                targetSentTimestamp: number;
+                isRemove: boolean;
+            };
+            mentions?: Array<{
+                start: number;
+                length: number;
+                uuid: string;
+            }>;
+        };
+        typingMessage?: {
+            action: 'STARTED' | 'STOPPED';
+            timestamp: number;
+            groupId?: string;
+        };
+        receiptMessage?: {
+            type: 'DELIVERY' | 'READ';
+            timestamps: number[];
+        };
+        syncMessage?: {
+            sentMessage?: {
+                destination?: string;
+                timestamp?: number;
+                message?: string;
+                groupInfo?: {
+                    groupId: string;
+                };
+            };
+        };
+    };
+    account?: string;
+}
+/**
+ * Signal attachment
+ */
+export interface SignalAttachment {
+    contentType?: string;
+    filename?: string;
+    id?: string;
+    size?: number;
+    width?: number;
+    height?: number;
+    caption?: string;
+    voiceNote?: boolean;
+}
+/**
+ * Signal group info from the REST API
+ */
+export interface SignalGroup {
+    id: string;
+    name: string;
+    description?: string;
+    members: string[];
+    admins?: string[];
+    blocked?: boolean;
+}
+/**
+ * Signal channel via signal-cli REST API
+ */
+export declare class SignalChannel extends BaseChannel {
+    private pollTimer;
+    private polling;
+    private groupCache;
+    private reconnectionManager;
+    private consecutiveErrors;
+    constructor(config: SignalConfig);
+    private get signalConfig();
+    private get apiBase();
+    private get encodedNumber();
+    /**
+     * Make a request to the signal-cli REST API
+     */
+    private apiRequest;
+    /**
+     * Connect to Signal by verifying the phone number is registered
+     * and starting the message polling loop
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect: stop polling
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Send a Signal message
+     */
+    send(message: OutboundMessage): Promise<DeliveryResult>;
+    /**
+     * Send a typing indicator
+     */
+    sendTyping(recipient: string): Promise<void>;
+    /**
+     * React to a message with an emoji
+     */
+    react(recipient: string, targetAuthor: string, timestamp: number, emoji: string): Promise<void>;
+    /**
+     * List groups the registered number is a member of
+     */
+    listGroups(): Promise<SignalGroup[]>;
+    /**
+     * Start the message polling loop with reconnection support
+     */
+    private startPolling;
+    /**
+     * Stop polling
+     */
+    private stopPolling;
+    /**
+     * Handle a received Signal message
+     */
+    private handleIncoming;
+    /**
+     * Convert Signal attachments to MessageAttachment format
+     */
+    private convertAttachments;
+    /**
+     * Determine content type from a Signal data message
+     */
+    private determineContentType;
+    /**
+     * Map MIME type to ContentType
+     */
+    private mimeToContentType;
+    /**
+     * Check if an ID looks like a Signal group ID (base64)
+     */
+    private isGroupId;
+    /**
+     * Pre-load groups into the cache
+     */
+    private loadGroups;
+}
+export default SignalChannel;