@framers/agentos 0.1.26 → 0.1.28

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

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview IRC Channel Adapter for AgentOS.
+ *
+ * Wraps the `irc-framework` npm package to connect agents to IRC servers.
+ * IRC was recently added to OpenClaw upstream — this adapter provides
+ * first-class support for the protocol within the channel system.
+ *
+ * **Dependencies**: Requires `irc-framework` 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 irc = new IRCChannelAdapter();
+ * await irc.initialize({
+ *   platform: 'irc',
+ *   credential: 'AgentNick',          // used as nickname
+ *   params: {
+ *     host: 'irc.libera.chat',
+ *     port: '6697',                    // TLS by default
+ *     channels: '#agentos,#wunderland',
+ *     realname: 'Wunderland Agent',
+ *     password: '',                     // server password (optional)
+ *   },
+ * });
+ * ```
+ *
+ * @module @framers/agentos/channels/adapters/IRCChannelAdapter
+ */
+import type { ChannelAuthConfig, ChannelCapability, ChannelPlatform, ChannelSendResult, MessageContent } from '../types.js';
+import { BaseChannelAdapter } from './BaseChannelAdapter.js';
+/** Platform-specific parameters for IRC connections. */
+export interface IRCAuthParams extends Record<string, string | undefined> {
+    /** IRC server hostname. */
+    host: string;
+    /** Server port (default: '6697' for TLS). */
+    port?: string;
+    /** Comma-separated list of channels to auto-join. */
+    channels?: string;
+    /** GECOS / real-name field. */
+    realname?: string;
+    /** Server password (not NickServ — use credential for that). */
+    password?: string;
+    /** Whether to use TLS. Default: 'true'. */
+    tls?: string;
+}
+/**
+ * Channel adapter for Internet Relay Chat (IRC).
+ *
+ * Uses the `irc-framework` package via dynamic import so that the
+ * dependency is optional — it is only required at runtime when the
+ * adapter is actually initialized.
+ *
+ * Capabilities: `text`, `group_chat`, `channels`, `mentions`.
+ * IRC does not natively support rich text, images, reactions, threads,
+ * typing indicators, or message editing/deletion.
+ */
+export declare class IRCChannelAdapter extends BaseChannelAdapter<IRCAuthParams> {
+    readonly platform: ChannelPlatform;
+    readonly displayName = "IRC";
+    readonly capabilities: readonly ChannelCapability[];
+    /** The irc-framework Client instance. Typed as `any` because the
+     *  package is dynamically imported and may not be installed. */
+    private client;
+    /** Channels the bot has joined, keyed by lowercase name. */
+    private joinedChannels;
+    protected doConnect(auth: ChannelAuthConfig & {
+        params?: IRCAuthParams;
+    }): Promise<void>;
+    protected doSendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    protected doShutdown(): Promise<void>;
+    /**
+     * Join an additional IRC channel at runtime.
+     */
+    joinChannel(channel: string): void;
+    /**
+     * Part (leave) an IRC channel.
+     */
+    partChannel(channel: string, reason?: string): void;
+    /**
+     * Get the set of channels the bot is currently in.
+     */
+    getJoinedChannels(): string[];
+    private handleIrcMessage;
+}
+//# sourceMappingURL=IRCChannelAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IRCChannelAdapter.d.ts","sourceRoot":"","sources":["../../../src/channels/adapters/IRCChannelAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAEjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,wDAAwD;AACxD,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACvE,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,kBAAkB,CAAC,aAAa,CAAC;IACtE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAS;IAC3C,QAAQ,CAAC,WAAW,SAAS;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAKxC;IAEX;oEACgE;IAEhE,OAAO,CAAC,MAAM,CAAkB;IAEhC,4DAA4D;IAC5D,OAAO,CAAC,cAAc,CAA0B;cAIhC,SAAS,CACvB,IAAI,EAAE,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,aAAa,CAAA;KAAE,GACnD,OAAO,CAAC,IAAI,CAAC;cA0GA,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;cAyCb,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOlC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAQnD;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAO7B,OAAO,CAAC,gBAAgB;CA4BzB"}

package/dist/channels/adapters/IRCChannelAdapter.js

@@ -0,0 +1,253 @@
+/**
+ * @fileoverview IRC Channel Adapter for AgentOS.
+ *
+ * Wraps the `irc-framework` npm package to connect agents to IRC servers.
+ * IRC was recently added to OpenClaw upstream — this adapter provides
+ * first-class support for the protocol within the channel system.
+ *
+ * **Dependencies**: Requires `irc-framework` 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 irc = new IRCChannelAdapter();
+ * await irc.initialize({
+ *   platform: 'irc',
+ *   credential: 'AgentNick',          // used as nickname
+ *   params: {
+ *     host: 'irc.libera.chat',
+ *     port: '6697',                    // TLS by default
+ *     channels: '#agentos,#wunderland',
+ *     realname: 'Wunderland Agent',
+ *     password: '',                     // server password (optional)
+ *   },
+ * });
+ * ```
+ *
+ * @module @framers/agentos/channels/adapters/IRCChannelAdapter
+ */
+import { BaseChannelAdapter } from './BaseChannelAdapter.js';
+// ============================================================================
+// IRCChannelAdapter
+// ============================================================================
+/**
+ * Channel adapter for Internet Relay Chat (IRC).
+ *
+ * Uses the `irc-framework` package via dynamic import so that the
+ * dependency is optional — it is only required at runtime when the
+ * adapter is actually initialized.
+ *
+ * Capabilities: `text`, `group_chat`, `channels`, `mentions`.
+ * IRC does not natively support rich text, images, reactions, threads,
+ * typing indicators, or message editing/deletion.
+ */
+export class IRCChannelAdapter extends BaseChannelAdapter {
+    constructor() {
+        super(...arguments);
+        this.platform = 'irc';
+        this.displayName = 'IRC';
+        this.capabilities = [
+            'text',
+            'group_chat',
+            'channels',
+            'mentions',
+        ];
+        /** Channels the bot has joined, keyed by lowercase name. */
+        this.joinedChannels = new Set();
+    }
+    // ── Abstract hook implementations ──
+    async doConnect(auth) {
+        // Dynamic import — fails gracefully if irc-framework is not installed
+        let IrcFramework; // eslint-disable-line @typescript-eslint/no-explicit-any
+        try {
+            IrcFramework = await import('irc-framework');
+        }
+        catch {
+            throw new Error('The "irc-framework" package is required for the IRC adapter. ' +
+                'Install it with: npm install irc-framework');
+        }
+        const params = auth.params ?? {};
+        const host = params.host;
+        if (!host) {
+            throw new Error('IRC auth params must include "host".');
+        }
+        const nick = auth.credential;
+        if (!nick) {
+            throw new Error('IRC credential (nickname) is required.');
+        }
+        const port = parseInt(params.port ?? '6697', 10);
+        const useTls = (params.tls ?? 'true') !== 'false';
+        const channelsToJoin = (params.channels ?? '')
+            .split(',')
+            .map((c) => c.trim())
+            .filter(Boolean);
+        // Create the IRC client
+        const Client = IrcFramework.Client ?? IrcFramework.default?.Client ?? IrcFramework;
+        this.client = new Client();
+        // Wrap the connection in a promise so we can await it
+        await new Promise((resolve, reject) => {
+            const connectTimeout = setTimeout(() => {
+                reject(new Error(`IRC connection to ${host}:${port} timed out after 30s`));
+            }, 30000);
+            this.client.on('registered', () => {
+                clearTimeout(connectTimeout);
+                // Auto-join requested channels
+                for (const channel of channelsToJoin) {
+                    this.client.join(channel);
+                }
+                resolve();
+            });
+            this.client.on('error', (err) => {
+                clearTimeout(connectTimeout);
+                reject(err);
+            });
+            this.client.on('close', () => {
+                if (this.status === 'connected') {
+                    // Unexpected disconnect — trigger reconnect via base class
+                    this.setStatus('reconnecting', 'Connection closed unexpectedly');
+                    this.reconnect().catch((e) => {
+                        console.error(`[IRC] Reconnect failed:`, e);
+                    });
+                }
+            });
+            // Wire up inbound message events
+            this.client.on('privmsg', (event) => {
+                this.handleIrcMessage(event);
+            });
+            // Track channel joins
+            this.client.on('join', (event) => {
+                if (event.nick === nick) {
+                    this.joinedChannels.add(event.channel.toLowerCase());
+                }
+            });
+            // Track channel parts
+            this.client.on('part', (event) => {
+                if (event.nick === nick) {
+                    this.joinedChannels.delete(event.channel.toLowerCase());
+                }
+            });
+            this.client.connect({
+                host,
+                port,
+                nick,
+                gecos: params.realname ?? `AgentOS IRC (${nick})`,
+                password: params.password || undefined,
+                tls: useTls,
+                auto_reconnect: false, // We handle reconnection in BaseChannelAdapter
+            });
+        });
+        // Populate platform info
+        this.platformInfo = {
+            nick,
+            host,
+            port,
+            tls: useTls,
+            channels: channelsToJoin,
+        };
+    }
+    async doSendMessage(conversationId, content) {
+        if (!this.client) {
+            throw new Error('[IRC] Client is not connected.');
+        }
+        // Extract text from content blocks (IRC only supports plain text)
+        const textParts = [];
+        for (const block of content.blocks) {
+            if (block.type === 'text') {
+                textParts.push(block.text);
+            }
+            else if (block.type === 'image' || block.type === 'video' || block.type === 'document') {
+                // For media blocks, send the URL as a fallback
+                const url = 'url' in block ? block.url : undefined;
+                if (url) {
+                    const caption = 'caption' in block && block.caption ? `${block.caption}: ` : '';
+                    textParts.push(`${caption}${url}`);
+                }
+            }
+        }
+        const fullText = textParts.join('\n');
+        if (!fullText) {
+            throw new Error('[IRC] Cannot send empty message.');
+        }
+        // IRC messages have a ~512-byte line limit; split into multiple lines
+        const lines = fullText.split('\n');
+        for (const line of lines) {
+            if (line.trim()) {
+                this.client.say(conversationId, line);
+            }
+        }
+        // IRC does not provide message IDs; generate a synthetic one
+        const syntheticId = `irc-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        return {
+            messageId: syntheticId,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async doShutdown() {
+        if (this.client) {
+            try {
+                this.client.quit('AgentOS shutting down');
+            }
+            catch {
+                // Best effort — connection may already be dead
+            }
+            this.client = undefined;
+        }
+        this.joinedChannels.clear();
+    }
+    // ── IRC-specific helpers ──
+    /**
+     * Join an additional IRC channel at runtime.
+     */
+    joinChannel(channel) {
+        if (!this.client || this.status !== 'connected') {
+            throw new Error('[IRC] Cannot join channel — not connected.');
+        }
+        this.client.join(channel);
+    }
+    /**
+     * Part (leave) an IRC channel.
+     */
+    partChannel(channel, reason) {
+        if (!this.client || this.status !== 'connected') {
+            throw new Error('[IRC] Cannot part channel — not connected.');
+        }
+        this.client.part(channel, reason ?? '');
+        this.joinedChannels.delete(channel.toLowerCase());
+    }
+    /**
+     * Get the set of channels the bot is currently in.
+     */
+    getJoinedChannels() {
+        return [...this.joinedChannels];
+    }
+    // ── Private ──
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    handleIrcMessage(event) {
+        const isChannel = event.target?.startsWith('#') || event.target?.startsWith('&');
+        const conversationId = event.target ?? event.nick ?? 'unknown';
+        const message = {
+            messageId: `irc-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            platform: 'irc',
+            conversationId,
+            conversationType: isChannel ? 'channel' : 'direct',
+            sender: {
+                id: event.nick ?? 'unknown',
+                displayName: event.nick,
+                username: event.nick,
+            },
+            content: [{ type: 'text', text: event.message ?? '' }],
+            text: event.message ?? '',
+            timestamp: new Date().toISOString(),
+            rawEvent: event,
+        };
+        this.emit({
+            type: 'message',
+            platform: 'irc',
+            conversationId,
+            timestamp: message.timestamp,
+            data: message,
+        });
+    }
+}
+//# sourceMappingURL=IRCChannelAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IRCChannelAdapter.js","sourceRoot":"","sources":["../../../src/channels/adapters/IRCChannelAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAUH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAsB7D,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAkB,SAAQ,kBAAiC;IAAxE;;QACW,aAAQ,GAAoB,KAAK,CAAC;QAClC,gBAAW,GAAG,KAAK,CAAC;QACpB,iBAAY,GAAiC;YACpD,MAAM;YACN,YAAY;YACZ,UAAU;YACV,UAAU;SACF,CAAC;QAOX,4DAA4D;QACpD,mBAAc,GAAgB,IAAI,GAAG,EAAE,CAAC;IAqOlD,CAAC;IAnOC,sCAAsC;IAE5B,KAAK,CAAC,SAAS,CACvB,IAAoD;QAEpD,sEAAsE;QACtE,IAAI,YAAiB,CAAC,CAAC,yDAAyD;QAChF,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,+DAA+D;gBAC7D,4CAA4C,CAC/C,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAK,EAAoB,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,KAAK,OAAO,CAAC;QAClD,MAAM,cAAc,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;aAC3C,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,CAAC;QAEnB,wBAAwB;QACxB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,MAAM,IAAI,YAAY,CAAC;QACnF,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAE3B,sDAAsD;QACtD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;gBACrC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,IAAI,IAAI,IAAI,sBAAsB,CAAC,CAAC,CAAC;YAC7E,CAAC,EAAE,KAAM,CAAC,CAAC;YAEX,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;gBAChC,YAAY,CAAC,cAAc,CAAC,CAAC;gBAE7B,+BAA+B;gBAC/B,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;oBACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5B,CAAC;gBAED,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;gBACrC,YAAY,CAAC,cAAc,CAAC,CAAC;gBAC7B,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAChC,2DAA2D;oBAC3D,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,gCAAgC,CAAC,CAAC;oBACjE,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;wBAC3B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC;oBAC9C,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,iCAAiC;YACjC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAU,EAAE,EAAE;gBACvC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;YAEH,sBAAsB;YACtB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAU,EAAE,EAAE;gBACpC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBACxB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,sBAAsB;YACtB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAU,EAAE,EAAE;gBACpC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBACxB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;gBAClB,IAAI;gBACJ,IAAI;gBACJ,IAAI;gBACJ,KAAK,EAAE,MAAM,CAAC,QAAQ,IAAI,gBAAgB,IAAI,GAAG;gBACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS;gBACtC,GAAG,EAAE,MAAM;gBACX,cAAc,EAAE,KAAK,EAAE,+CAA+C;aACvE,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,yBAAyB;QACzB,IAAI,CAAC,YAAY,GAAG;YAClB,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,GAAG,EAAE,MAAM;YACX,QAAQ,EAAE,cAAc;SACzB,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,aAAa,CAC3B,cAAsB,EACtB,OAAuB;QAEvB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,kEAAkE;QAClE,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACzF,+CAA+C;gBAC/C,MAAM,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnD,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,OAAO,GAAG,SAAS,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChF,SAAS,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,sEAAsE;QACtE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,6DAA6D;QAC7D,MAAM,WAAW,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAClF,OAAO;YACL,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,UAAU;QACxB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,+CAA+C;YACjD,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,6BAA6B;IAE7B;;OAEG;IACH,WAAW,CAAC,OAAe;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAe,EAAE,MAAe;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAED,gBAAgB;IAEhB,8DAA8D;IACtD,gBAAgB,CAAC,KAAU;QACjC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;QACjF,MAAM,cAAc,GAAW,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;QAEvE,MAAM,OAAO,GAAmB;YAC9B,SAAS,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YACxE,QAAQ,EAAE,KAAK;YACf,cAAc;YACd,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAClD,MAAM,EAAE;gBACN,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,SAAS;gBAC3B,WAAW,EAAE,KAAK,CAAC,IAAI;gBACvB,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB;YACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACtD,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,KAAK;SAChB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,KAAK;YACf,cAAc;YACd,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview Reddit Channel Adapter for AgentOS.
+ *
+ * Wraps the Reddit API (via `snoowrap`) to allow agents to submit
+ * posts, comments, and interact with subreddits. Uses dynamic import
+ * so that `snoowrap` is only loaded at connection time.
+ *
+ * Reddit's API has strict rate limits (60 requests per minute for
+ * OAuth apps). The adapter tracks and respects these limits with a
+ * request queue.
+ *
+ * **Dependencies**: Requires `snoowrap` to be installed.
+ *
+ * @example
+ * ```typescript
+ * const reddit = new RedditChannelAdapter();
+ * await reddit.initialize({
+ *   platform: 'reddit',
+ *   credential: '<client_id>',
+ *   params: {
+ *     clientSecret: 'your-client-secret',
+ *     username: 'bot_username',
+ *     password: 'bot_password',
+ *     userAgent: 'agentos:v1.0 (by /u/your_username)',
+ *   },
+ * });
+ * ```
+ *
+ * @module @framers/agentos/channels/adapters/RedditChannelAdapter
+ */
+import type { ChannelAuthConfig, ChannelCapability, ChannelPlatform, ChannelSendResult, MessageContent } from '../types.js';
+import { BaseChannelAdapter } from './BaseChannelAdapter.js';
+/** Platform-specific authentication parameters for Reddit. */
+export interface RedditAuthParams extends Record<string, string | undefined> {
+    /** OAuth2 client secret. */
+    clientSecret: string;
+    /** Reddit account username for the bot. */
+    username: string;
+    /** Reddit account password for the bot. */
+    password: string;
+    /** User-Agent string (required by Reddit API TOS). */
+    userAgent: string;
+}
+/**
+ * Channel adapter for Reddit.
+ *
+ * Uses the `snoowrap` package via dynamic import so the dependency
+ * is optional. Falls back to raw `fetch` against the Reddit OAuth2
+ * API if snoowrap is unavailable.
+ *
+ * Capabilities: `text`, `rich_text`, `images`, `video`, `reactions`,
+ * `threads`, `group_chat`, `hashtags`, `polls`.
+ *
+ * Conversation ID mapping:
+ * - Subreddit post: `r/<subreddit>` or `post:<thing_id>`
+ * - Comment reply: `comment:<thing_id>`
+ * - Direct message: `dm:<username>`
+ */
+export declare class RedditChannelAdapter extends BaseChannelAdapter<RedditAuthParams> {
+    readonly platform: ChannelPlatform;
+    readonly displayName = "Reddit";
+    readonly capabilities: readonly ChannelCapability[];
+    private client;
+    /** Whether we're using snoowrap or raw fetch. */
+    private usingSnoowrap;
+    /** OAuth2 access token for raw fetch fallback. */
+    private accessToken;
+    private tokenExpiresAt;
+    private storedAuth;
+    /** Authenticated user info. */
+    private authenticatedUser;
+    /** Rate-limit: requests remaining in the current window. */
+    private rateLimitRemaining;
+    private rateLimitResetAt;
+    /** Polling interval for inbox messages. */
+    private pollTimer;
+    private lastInboxTimestamp;
+    protected doConnect(auth: ChannelAuthConfig & {
+        params?: RedditAuthParams;
+    }): Promise<void>;
+    protected doSendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    protected doShutdown(): Promise<void>;
+    /**
+     * Submit a new post to a subreddit.
+     */
+    submitPost(subreddit: string, content: MessageContent): Promise<ChannelSendResult>;
+    /**
+     * Upvote a post or comment.
+     */
+    upvote(thingId: string): Promise<void>;
+    /**
+     * Downvote a post or comment.
+     */
+    downvote(thingId: string): Promise<void>;
+    /**
+     * Get information about the authenticated user.
+     */
+    getAuthenticatedUser(): {
+        name: string;
+        id: string;
+    } | undefined;
+    private submitPostSnoowrap;
+    private replyToComment;
+    private replyToPost;
+    private sendPrivateMessage;
+    private authenticateRaw;
+    private ensureAccessToken;
+    private redditApiRequest;
+    private submitPostRaw;
+    private startPolling;
+    private stopPolling;
+    private pollInbox;
+    private extractText;
+    /**
+     * Extract the first line as a title. Reddit requires titles for posts.
+     */
+    private extractTitle;
+    /**
+     * Extract everything after the first line as the body.
+     */
+    private extractBody;
+}
+//# sourceMappingURL=RedditChannelAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RedditChannelAdapter.d.ts","sourceRoot":"","sources":["../../../src/channels/adapters/RedditChannelAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;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,8DAA8D;AAC9D,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1E,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAqB,SAAQ,kBAAkB,CAAC,gBAAgB,CAAC;IAC5E,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAY;IAC9C,QAAQ,CAAC,WAAW,YAAY;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAUxC;IAGX,OAAO,CAAC,MAAM,CAAkB;IAEhC,iDAAiD;IACjD,OAAO,CAAC,aAAa,CAAS;IAE9B,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAkE;IAEpF,+BAA+B;IAC/B,OAAO,CAAC,iBAAiB,CAA2C;IAEpE,4DAA4D;IAC5D,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,gBAAgB,CAAK;IAE7B,2CAA2C;IAC3C,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,kBAAkB,CAAK;cAIf,SAAS,CACvB,IAAI,EAAE,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,gBAAgB,CAAA;KAAE,GACtD,OAAO,CAAC,IAAI,CAAC;cAmEA,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;cAsBb,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3C;;OAEG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAc7B;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9C;;OAEG;IACH,oBAAoB,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;YAMlD,kBAAkB;YAgDlB,cAAc;YA4Bd,WAAW;YA4BX,kBAAkB;YA8BlB,eAAe;YAwCf,iBAAiB;YAcjB,gBAAgB;YAwDhB,aAAa;IA+B3B,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;YAOL,SAAS;IAwDvB,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,WAAW;CAKpB"}