@framers/agentos 0.1.27 → 0.1.29

package/dist/channels/adapters/BaseChannelAdapter.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @fileoverview Abstract base class for channel adapters.
+ *
+ * Provides common infrastructure that all concrete adapters share:
+ * - Connection state machine (disconnected -> connecting -> connected)
+ * - Retry logic with exponential back-off
+ * - Event handler registration and dispatch
+ * - Lifecycle management (initialize, shutdown, reconnect)
+ *
+ * Subclasses implement three abstract methods:
+ *   `doConnect()`, `doSendMessage()`, `doShutdown()`
+ *
+ * @module @framers/agentos/channels/adapters/BaseChannelAdapter
+ */
+import type { IChannelAdapter } from '../IChannelAdapter.js';
+import type { ChannelAuthConfig, ChannelCapability, ChannelConnectionInfo, ChannelConnectionStatus, ChannelEvent, ChannelEventHandler, ChannelEventType, ChannelPlatform, ChannelSendResult, MessageContent } from '../types.js';
+/** Options governing connection retry behaviour. */
+export interface RetryConfig {
+    /** Maximum number of retry attempts before giving up. Default: 5. */
+    maxRetries: number;
+    /** Initial delay in milliseconds before the first retry. Default: 1000. */
+    baseDelayMs: number;
+    /** Upper-bound delay in milliseconds. Default: 30_000. */
+    maxDelayMs: number;
+    /** Jitter factor (0-1) applied to each delay. Default: 0.25. */
+    jitterFactor: number;
+}
+/**
+ * Abstract base class that implements common {@link IChannelAdapter}
+ * behaviour. Concrete adapters (Telegram, Discord, IRC, ...) extend this
+ * class and implement the three abstract hooks:
+ *
+ * - `doConnect(auth)` -- establish the platform connection.
+ * - `doSendMessage(conversationId, content)` -- deliver a message.
+ * - `doShutdown()` -- tear down the platform connection.
+ *
+ * @typeParam TAuthParams - Shape of the platform-specific `params` object
+ *   inside {@link ChannelAuthConfig}. Defaults to `Record<string, string>`.
+ */
+export declare abstract class BaseChannelAdapter<TAuthParams extends Record<string, string | undefined> = Record<string, string>> implements IChannelAdapter {
+    abstract readonly platform: ChannelPlatform;
+    abstract readonly displayName: string;
+    abstract readonly capabilities: readonly ChannelCapability[];
+    protected status: ChannelConnectionStatus;
+    protected connectedSince: string | undefined;
+    protected errorMessage: string | undefined;
+    protected platformInfo: Record<string, unknown>;
+    /** Stored auth config so `reconnect()` can re-use it. */
+    protected auth: (ChannelAuthConfig & {
+        params?: TAuthParams;
+    }) | undefined;
+    protected readonly retryConfig: RetryConfig;
+    private retryCount;
+    private retryTimer;
+    private subscriptions;
+    constructor(retryConfig?: Partial<RetryConfig>);
+    /**
+     * Establish the platform connection using the supplied credentials.
+     * Called by {@link initialize} after state has been set to `connecting`.
+     * Must throw on failure — the base class handles retry and state changes.
+     */
+    protected abstract doConnect(auth: ChannelAuthConfig & {
+        params?: TAuthParams;
+    }): Promise<void>;
+    /**
+     * Deliver a message to the external platform.
+     * Called by {@link sendMessage} only when the adapter is `connected`.
+     */
+    protected abstract doSendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    /**
+     * Release platform resources (close WebSocket, stop polling, etc.).
+     * Called by {@link shutdown} before the state transitions to `disconnected`.
+     */
+    protected abstract doShutdown(): Promise<void>;
+    /**
+     * Initialize the adapter with auth credentials. If already connected this
+     * will shut down the existing connection first (idempotent).
+     */
+    initialize(auth: ChannelAuthConfig): Promise<void>;
+    /**
+     * Gracefully shut down the adapter and release all resources.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Manually trigger a reconnection attempt using stored credentials.
+     * Useful for UI-driven "reconnect" buttons.
+     */
+    reconnect(): Promise<void>;
+    getConnectionInfo(): ChannelConnectionInfo;
+    sendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    /**
+     * Default stub — platforms that support typing indicators should override.
+     */
+    sendTypingIndicator(_conversationId: string, _isTyping: boolean): Promise<void>;
+    /**
+     * Register an event handler. Returns an unsubscribe function.
+     */
+    on(handler: ChannelEventHandler, eventTypes?: ChannelEventType[]): () => void;
+    /**
+     * Emit an event to all matching subscribers.
+     * Subclasses call this when the platform SDK receives an inbound event.
+     */
+    protected emit(event: ChannelEvent): void;
+    /**
+     * Convenience helper: emit a `connection_change` event with the current
+     * status. Called automatically by {@link setStatus}.
+     */
+    protected emitConnectionChange(): void;
+    /**
+     * Check whether this adapter declares a specific capability.
+     */
+    protected hasCapability(cap: ChannelCapability): boolean;
+    /**
+     * Transition to a new connection status and emit an event.
+     */
+    protected setStatus(newStatus: ChannelConnectionStatus, error?: string): void;
+    /**
+     * Single connection attempt with automatic retry on failure.
+     */
+    private attemptConnect;
+    /**
+     * Calculate next retry delay using exponential back-off with jitter.
+     *
+     * delay = min(baseDelay * 2^(retryCount-1), maxDelay) * (1 +/- jitter)
+     */
+    private calculateBackoff;
+    private clearRetryState;
+    private sleep;
+}
+//# sourceMappingURL=BaseChannelAdapter.d.ts.map

package/dist/channels/adapters/BaseChannelAdapter.d.ts.map

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

package/dist/channels/adapters/BaseChannelAdapter.js

@@ -0,0 +1,257 @@
+/**
+ * @fileoverview Abstract base class for channel adapters.
+ *
+ * Provides common infrastructure that all concrete adapters share:
+ * - Connection state machine (disconnected -> connecting -> connected)
+ * - Retry logic with exponential back-off
+ * - Event handler registration and dispatch
+ * - Lifecycle management (initialize, shutdown, reconnect)
+ *
+ * Subclasses implement three abstract methods:
+ *   `doConnect()`, `doSendMessage()`, `doShutdown()`
+ *
+ * @module @framers/agentos/channels/adapters/BaseChannelAdapter
+ */
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 5,
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+    jitterFactor: 0.25,
+};
+// ============================================================================
+// BaseChannelAdapter
+// ============================================================================
+/**
+ * Abstract base class that implements common {@link IChannelAdapter}
+ * behaviour. Concrete adapters (Telegram, Discord, IRC, ...) extend this
+ * class and implement the three abstract hooks:
+ *
+ * - `doConnect(auth)` -- establish the platform connection.
+ * - `doSendMessage(conversationId, content)` -- deliver a message.
+ * - `doShutdown()` -- tear down the platform connection.
+ *
+ * @typeParam TAuthParams - Shape of the platform-specific `params` object
+ *   inside {@link ChannelAuthConfig}. Defaults to `Record<string, string>`.
+ */
+export class BaseChannelAdapter {
+    // ── Constructor ──
+    constructor(retryConfig) {
+        // ── Connection state ──
+        this.status = 'disconnected';
+        this.platformInfo = {};
+        this.retryCount = 0;
+        // ── Event subscriptions ──
+        this.subscriptions = new Set();
+        this.retryConfig = { ...DEFAULT_RETRY_CONFIG, ...retryConfig };
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // IChannelAdapter — Lifecycle
+    // ════════════════════════════════════════════════════════════════════════
+    /**
+     * Initialize the adapter with auth credentials. If already connected this
+     * will shut down the existing connection first (idempotent).
+     */
+    async initialize(auth) {
+        // Idempotency: tear down any previous connection
+        if (this.status === 'connected' || this.status === 'reconnecting') {
+            await this.shutdown();
+        }
+        this.auth = auth;
+        this.clearRetryState();
+        await this.attemptConnect();
+    }
+    /**
+     * Gracefully shut down the adapter and release all resources.
+     */
+    async shutdown() {
+        this.clearRetryState();
+        if (this.status === 'disconnected')
+            return;
+        try {
+            await this.doShutdown();
+        }
+        catch (err) {
+            // Best-effort shutdown — log and continue
+            console.error(`[${this.displayName}] Error during shutdown:`, err);
+        }
+        finally {
+            this.setStatus('disconnected');
+            this.connectedSince = undefined;
+        }
+    }
+    /**
+     * Manually trigger a reconnection attempt using stored credentials.
+     * Useful for UI-driven "reconnect" buttons.
+     */
+    async reconnect() {
+        if (!this.auth) {
+            throw new Error(`[${this.displayName}] Cannot reconnect — adapter has never been initialized.`);
+        }
+        if (this.status === 'connected') {
+            await this.shutdown();
+        }
+        this.clearRetryState();
+        await this.attemptConnect();
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // IChannelAdapter — Connection Info
+    // ════════════════════════════════════════════════════════════════════════
+    getConnectionInfo() {
+        return {
+            status: this.status,
+            connectedSince: this.connectedSince,
+            errorMessage: this.errorMessage,
+            platformInfo: { ...this.platformInfo },
+        };
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // IChannelAdapter — Outbound Messaging
+    // ════════════════════════════════════════════════════════════════════════
+    async sendMessage(conversationId, content) {
+        if (this.status !== 'connected') {
+            throw new Error(`[${this.displayName}] Cannot send message — adapter is ${this.status}, not connected.`);
+        }
+        return this.doSendMessage(conversationId, content);
+    }
+    /**
+     * Default stub — platforms that support typing indicators should override.
+     */
+    async sendTypingIndicator(_conversationId, _isTyping) {
+        // No-op by default. Subclasses override if capability is declared.
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // IChannelAdapter — Event Handling
+    // ════════════════════════════════════════════════════════════════════════
+    /**
+     * Register an event handler. Returns an unsubscribe function.
+     */
+    on(handler, eventTypes) {
+        const sub = { handler, eventTypes };
+        this.subscriptions.add(sub);
+        return () => {
+            this.subscriptions.delete(sub);
+        };
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // Protected helpers for subclasses
+    // ════════════════════════════════════════════════════════════════════════
+    /**
+     * Emit an event to all matching subscribers.
+     * Subclasses call this when the platform SDK receives an inbound event.
+     */
+    emit(event) {
+        for (const sub of this.subscriptions) {
+            // Filter by event types if the subscription specified a filter
+            if (sub.eventTypes && !sub.eventTypes.includes(event.type)) {
+                continue;
+            }
+            try {
+                // Fire-and-forget; errors in handlers should not crash the adapter
+                const result = sub.handler(event);
+                if (result && typeof result.catch === 'function') {
+                    result.catch((err) => {
+                        console.error(`[${this.displayName}] Unhandled error in event handler:`, err);
+                    });
+                }
+            }
+            catch (err) {
+                console.error(`[${this.displayName}] Synchronous error in event handler:`, err);
+            }
+        }
+    }
+    /**
+     * Convenience helper: emit a `connection_change` event with the current
+     * status. Called automatically by {@link setStatus}.
+     */
+    emitConnectionChange() {
+        this.emit({
+            type: 'connection_change',
+            platform: this.platform,
+            conversationId: '',
+            timestamp: new Date().toISOString(),
+            data: {
+                status: this.status,
+                errorMessage: this.errorMessage,
+            },
+        });
+    }
+    /**
+     * Check whether this adapter declares a specific capability.
+     */
+    hasCapability(cap) {
+        return this.capabilities.includes(cap);
+    }
+    /**
+     * Transition to a new connection status and emit an event.
+     */
+    setStatus(newStatus, error) {
+        const prev = this.status;
+        this.status = newStatus;
+        this.errorMessage = error;
+        if (newStatus === 'connected' && prev !== 'connected') {
+            this.connectedSince = new Date().toISOString();
+        }
+        this.emitConnectionChange();
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // Private — Connection and Retry Logic
+    // ════════════════════════════════════════════════════════════════════════
+    /**
+     * Single connection attempt with automatic retry on failure.
+     */
+    async attemptConnect() {
+        if (!this.auth)
+            return;
+        this.setStatus(this.retryCount === 0 ? 'connecting' : 'reconnecting');
+        try {
+            await this.doConnect(this.auth);
+            // Success
+            this.retryCount = 0;
+            this.setStatus('connected');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`[${this.displayName}] Connection attempt ${this.retryCount + 1} failed: ${message}`);
+            this.retryCount++;
+            if (this.retryCount > this.retryConfig.maxRetries) {
+                // Exhausted all retries
+                this.setStatus('error', `Failed after ${this.retryConfig.maxRetries} retries: ${message}`);
+                return;
+            }
+            // Schedule retry with exponential back-off + jitter
+            const delay = this.calculateBackoff();
+            console.warn(`[${this.displayName}] Retrying in ${delay}ms (attempt ${this.retryCount}/${this.retryConfig.maxRetries})...`);
+            await this.sleep(delay);
+            // Guard: shutdown may have been called while we were sleeping
+            if (this.status === 'disconnected')
+                return;
+            await this.attemptConnect();
+        }
+    }
+    /**
+     * Calculate next retry delay using exponential back-off with jitter.
+     *
+     * delay = min(baseDelay * 2^(retryCount-1), maxDelay) * (1 +/- jitter)
+     */
+    calculateBackoff() {
+        const { baseDelayMs, maxDelayMs, jitterFactor } = this.retryConfig;
+        const exponential = baseDelayMs * Math.pow(2, this.retryCount - 1);
+        const clamped = Math.min(exponential, maxDelayMs);
+        // Apply jitter: uniformly between (1-j)*clamped and (1+j)*clamped
+        const jitter = 1 + (Math.random() * 2 - 1) * jitterFactor;
+        return Math.round(clamped * jitter);
+    }
+    clearRetryState() {
+        this.retryCount = 0;
+        if (this.retryTimer) {
+            clearTimeout(this.retryTimer);
+            this.retryTimer = undefined;
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => {
+            this.retryTimer = setTimeout(resolve, ms);
+        });
+    }
+}
+//# sourceMappingURL=BaseChannelAdapter.js.map

package/dist/channels/adapters/BaseChannelAdapter.js.map

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

package/dist/channels/adapters/DiscordChannelAdapter.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Discord Channel Adapter for AgentOS.
+ *
+ * Wraps the `discord.js` npm package to connect agents to Discord servers.
+ * Supports rich messaging including text, embeds, images, video, audio,
+ * reactions, threads, mentions, buttons, and message management.
+ *
+ * **Dependencies**: Requires `discord.js` to be installed. The adapter
+ * uses a dynamic import so the package is only loaded at connection time,
+ * avoiding hard failures if it is not present.
+ *
+ * @example
+ * ```typescript
+ * const discord = new DiscordChannelAdapter();
+ * await discord.initialize({
+ *   platform: 'discord',
+ *   credential: 'DISCORD_BOT_TOKEN',
+ *   params: {
+ *     botToken: 'DISCORD_BOT_TOKEN',
+ *     applicationId: 'APP_ID',
+ *     guildId: 'OPTIONAL_GUILD_ID',
+ *   },
+ * });
+ * ```
+ *
+ * @module @framers/agentos/channels/adapters/DiscordChannelAdapter
+ */
+import type { ChannelAuthConfig, ChannelCapability, ChannelPlatform, ChannelSendResult, MessageContent } from '../types.js';
+import { BaseChannelAdapter } from './BaseChannelAdapter.js';
+/** Platform-specific parameters for Discord connections. */
+export interface DiscordAuthParams extends Record<string, string | undefined> {
+    /** Bot token. If provided, overrides credential. */
+    botToken?: string;
+    /** Discord application ID. */
+    applicationId?: string;
+    /** Optional guild (server) ID to scope interactions to a single guild. */
+    guildId?: string;
+    /** Comma-separated list of additional gateway intents. */
+    intents?: string;
+}
+/**
+ * Channel adapter for Discord using the discord.js SDK.
+ *
+ * Uses dynamic import so `discord.js` is only required at runtime when the
+ * adapter is actually initialized.
+ *
+ * Capabilities: text, rich_text, images, video, audio, embeds, reactions,
+ * threads, mentions, buttons, group_chat, channels, editing, deletion.
+ */
+export declare class DiscordChannelAdapter extends BaseChannelAdapter<DiscordAuthParams> {
+    readonly platform: ChannelPlatform;
+    readonly displayName = "Discord";
+    readonly capabilities: readonly ChannelCapability[];
+    /** The discord.js Client instance. */
+    private client;
+    /** discord.js module reference for building embeds, buttons, etc. */
+    private djs;
+    protected doConnect(auth: ChannelAuthConfig & {
+        params?: DiscordAuthParams;
+    }): Promise<void>;
+    protected doSendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    protected doShutdown(): Promise<void>;
+    editMessage(conversationId: string, messageId: string, content: MessageContent): Promise<void>;
+    deleteMessage(conversationId: string, messageId: string): Promise<void>;
+    addReaction(conversationId: string, messageId: string, emoji: string): Promise<void>;
+    sendTypingIndicator(conversationId: string, _isTyping: boolean): Promise<void>;
+    getConversationInfo(conversationId: string): Promise<{
+        name?: string;
+        memberCount?: number;
+        isGroup: boolean;
+        metadata?: Record<string, unknown>;
+    }>;
+    /**
+     * Wire up discord.js event handlers for inbound messages and interactions.
+     */
+    private wireEventHandlers;
+    /**
+     * Handle an inbound discord.js Message and emit a channel event.
+     */
+    private handleInboundMessage;
+    /**
+     * Build a discord.js message payload from MessageContent.
+     */
+    private buildMessagePayload;
+}
+//# sourceMappingURL=DiscordChannelAdapter.d.ts.map

package/dist/channels/adapters/DiscordChannelAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscordChannelAdapter.d.ts","sourceRoot":"","sources":["../../../src/channels/adapters/DiscordChannelAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAEjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,4DAA4D;AAC5D,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3E,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,kBAAkB,CAAC,iBAAiB,CAAC;IAC9E,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAa;IAC/C,QAAQ,CAAC,WAAW,aAAa;IACjC,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAexC;IAEX,sCAAsC;IAEtC,OAAO,CAAC,MAAM,CAAkB;IAEhC,qEAAqE;IAErE,OAAO,CAAC,GAAG,CAAkB;cAIb,SAAS,CACvB,IAAI,EAAE,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAE,GACvD,OAAO,CAAC,IAAI,CAAC;cA4FA,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;cA+Bb,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAerC,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC;IAeV,aAAa,CACjB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAYV,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAUV,mBAAmB,CACvB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,IAAI,CAAC;IAaV,mBAAmB,CACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAuBzG;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4GzB;;OAEG;IAEH,OAAO,CAAC,oBAAoB;IAmG5B;;OAEG;IAEH,OAAO,CAAC,mBAAmB;CAgH5B"}