visionclaw 0.1.0

package/dist/channels/interface.d.ts

@@ -0,0 +1,45 @@
+import type { EventEmitter } from "node:events";
+/**
+ * Attachment on a command message (image, file, etc.)
+ */
+export interface MessageAttachment {
+    type: "image" | "file" | "audio" | "video";
+    url?: string;
+    localPath?: string;
+    base64?: string;
+    mimeType?: string;
+    filename?: string;
+}
+/**
+ * A normalized incoming message from any channel.
+ */
+export interface CommandMessage {
+    id: string;
+    channel: string;
+    sender: string;
+    text: string;
+    attachments: MessageAttachment[];
+    timestamp: string;
+    /** Raw channel-specific metadata */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Interface that all channel adapters must implement.
+ */
+export interface ChannelAdapter extends EventEmitter {
+    readonly name: string;
+    /** Start listening for messages */
+    start(): Promise<void>;
+    /** Stop listening and clean up */
+    stop(): Promise<void>;
+    /** Send a message to a recipient on this channel, optionally with attachments */
+    sendMessage(to: string, message: string, attachments?: MessageAttachment[]): Promise<void>;
+}
+/**
+ * Events emitted by channel adapters.
+ */
+export interface ChannelEvents {
+    message: (msg: CommandMessage) => void;
+    error: (err: Error) => void;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/channels/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/channels/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,mCAAmC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,kCAAkC;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,iFAAiF;IACjF,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;IACvC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7B"}

package/dist/channels/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/channels/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/channels/interface.ts"],"names":[],"mappings":""}

package/dist/channels/manager.d.ts

@@ -0,0 +1,36 @@
+import { EventEmitter } from "node:events";
+import type { VisionClawConfig } from "../config/types.js";
+import type { ChannelAdapter, MessageAttachment } from "./interface.js";
+import type { MessageQueue } from "./queue.js";
+/**
+ * Manages all enabled channel adapters.
+ * Routes incoming messages to the message queue and provides
+ * a unified sendMessage interface for the agent.
+ */
+export declare class ChannelManager extends EventEmitter {
+    private adapters;
+    private config;
+    private queue;
+    constructor(config: VisionClawConfig, queue: MessageQueue);
+    /**
+     * Register a channel adapter.
+     */
+    registerAdapter(adapter: ChannelAdapter): void;
+    /**
+     * Start all registered adapters.
+     */
+    startAll(): Promise<void>;
+    /**
+     * Send a message through a specific channel.
+     */
+    sendMessage(channel: string, to: string, message: string, attachments?: MessageAttachment[]): Promise<void>;
+    /**
+     * Get the names of all registered (started) adapters.
+     */
+    getEnabledChannels(): string[];
+    /**
+     * Stop all channel adapters.
+     */
+    stopAll(): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/channels/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/channels/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAkB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAAe;gBAEhB,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY;IAMzD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAa9C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C/B;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,iBAAiB,EAAE,GAChC,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAU/B"}

package/dist/channels/manager.js

@@ -0,0 +1,108 @@
+import { EventEmitter } from "node:events";
+import { logger } from "../logger.js";
+/**
+ * Manages all enabled channel adapters.
+ * Routes incoming messages to the message queue and provides
+ * a unified sendMessage interface for the agent.
+ */
+export class ChannelManager extends EventEmitter {
+    adapters = new Map();
+    config;
+    queue;
+    constructor(config, queue) {
+        super();
+        this.config = config;
+        this.queue = queue;
+    }
+    /**
+     * Register a channel adapter.
+     */
+    registerAdapter(adapter) {
+        this.adapters.set(adapter.name, adapter);
+        adapter.on("message", (msg) => {
+            this.queue.enqueue(msg);
+            this.emit("message", msg);
+        });
+        adapter.on("error", (err) => {
+            logger.err(`[Channel:${adapter.name}] Error: ${err.message}`);
+        });
+    }
+    /**
+     * Start all registered adapters.
+     */
+    async startAll() {
+        // Dynamically import and register adapters based on config
+        // Gmail is always enabled
+        try {
+            const { GmailAdapter } = await import("./gmail.js");
+            const gmail = new GmailAdapter(this.config);
+            this.registerAdapter(gmail);
+        }
+        catch (err) {
+            logger.warn(`Failed to load Gmail adapter: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Telegram
+        if (this.config.channels.telegram?.enabled) {
+            try {
+                const { TelegramAdapter } = await import("./telegram.js");
+                const telegram = new TelegramAdapter(this.config);
+                this.registerAdapter(telegram);
+            }
+            catch (err) {
+                logger.warn(`Failed to load Telegram adapter: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Discord
+        if (this.config.channels.discord?.enabled) {
+            try {
+                const { DiscordAdapter } = await import("./discord.js");
+                const discord = new DiscordAdapter(this.config);
+                this.registerAdapter(discord);
+            }
+            catch (err) {
+                logger.warn(`Failed to load Discord adapter: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Start all registered adapters
+        for (const [name, adapter] of this.adapters) {
+            try {
+                await adapter.start();
+                logger.channel(name, "Started");
+            }
+            catch (err) {
+                logger.err(`[Channel:${name}] Failed to start: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    /**
+     * Send a message through a specific channel.
+     */
+    async sendMessage(channel, to, message, attachments) {
+        const adapter = this.adapters.get(channel);
+        if (!adapter) {
+            throw new Error(`Channel "${channel}" not found or not enabled`);
+        }
+        await adapter.sendMessage(to, message, attachments);
+    }
+    /**
+     * Get the names of all registered (started) adapters.
+     */
+    getEnabledChannels() {
+        return Array.from(this.adapters.keys());
+    }
+    /**
+     * Stop all channel adapters.
+     */
+    async stopAll() {
+        for (const [name, adapter] of this.adapters) {
+            try {
+                await adapter.stop();
+                logger.channel(name, "Stopped");
+            }
+            catch (err) {
+                logger.err(`[Channel:${name}] Failed to stop: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/channels/manager.js.map

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

package/dist/channels/queue.d.ts

@@ -0,0 +1,17 @@
+import type { CommandMessage } from "./interface.js";
+/**
+ * Persistent message queue backed by SQLite.
+ * Incoming channel messages are enqueued here and dequeued by the agent loop.
+ */
+export declare class MessageQueue {
+    private db;
+    constructor(customDbPath?: string);
+    enqueue(msg: CommandMessage): void;
+    dequeue(): CommandMessage | null;
+    peek(): CommandMessage | null;
+    isEmpty(): boolean;
+    size(): number;
+    clear(): void;
+    close(): void;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/channels/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/channels/queue.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAgBrD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;gBAElB,YAAY,CAAC,EAAE,MAAM;IAkBjC,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAiBlC,OAAO,IAAI,cAAc,GAAG,IAAI;IAsBhC,IAAI,IAAI,cAAc,GAAG,IAAI;IAoB7B,OAAO,IAAI,OAAO;IAOlB,IAAI,IAAI,MAAM;IAOd,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;CAGd"}

package/dist/channels/queue.js

@@ -0,0 +1,85 @@
+import Database from "better-sqlite3";
+import path from "node:path";
+import { getConfigDir } from "../config/index.js";
+/**
+ * Persistent message queue backed by SQLite.
+ * Incoming channel messages are enqueued here and dequeued by the agent loop.
+ */
+export class MessageQueue {
+    db;
+    constructor(customDbPath) {
+        const dbPath = customDbPath ?? path.join(getConfigDir(), "queue.db");
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS messages (
+        id TEXT PRIMARY KEY,
+        channel TEXT NOT NULL,
+        sender TEXT NOT NULL,
+        text TEXT NOT NULL,
+        attachments TEXT NOT NULL DEFAULT '[]',
+        timestamp TEXT NOT NULL,
+        meta TEXT,
+        created_at INTEGER NOT NULL DEFAULT (unixepoch())
+      )
+    `);
+    }
+    enqueue(msg) {
+        this.db
+            .prepare(`INSERT OR IGNORE INTO messages (id, channel, sender, text, attachments, timestamp, meta)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`)
+            .run(msg.id, msg.channel, msg.sender, msg.text, JSON.stringify(msg.attachments), msg.timestamp, msg.meta ? JSON.stringify(msg.meta) : null);
+    }
+    dequeue() {
+        const row = this.db
+            .prepare(`SELECT * FROM messages ORDER BY created_at ASC LIMIT 1`)
+            .get();
+        if (!row)
+            return null;
+        this.db.prepare(`DELETE FROM messages WHERE id = ?`).run(row.id);
+        return {
+            id: row.id,
+            channel: row.channel,
+            sender: row.sender,
+            text: row.text,
+            attachments: JSON.parse(row.attachments),
+            timestamp: row.timestamp,
+            meta: row.meta ? JSON.parse(row.meta) : undefined,
+        };
+    }
+    peek() {
+        const row = this.db
+            .prepare(`SELECT * FROM messages ORDER BY created_at ASC LIMIT 1`)
+            .get();
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            channel: row.channel,
+            sender: row.sender,
+            text: row.text,
+            attachments: JSON.parse(row.attachments),
+            timestamp: row.timestamp,
+            meta: row.meta ? JSON.parse(row.meta) : undefined,
+        };
+    }
+    isEmpty() {
+        const row = this.db
+            .prepare(`SELECT COUNT(*) as count FROM messages`)
+            .get();
+        return row.count === 0;
+    }
+    size() {
+        const row = this.db
+            .prepare(`SELECT COUNT(*) as count FROM messages`)
+            .get();
+        return row.count;
+    }
+    clear() {
+        this.db.prepare(`DELETE FROM messages`).run();
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/channels/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/channels/queue.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAiBlD;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,EAAE,CAAoB;IAE9B,YAAY,YAAqB;QAC/B,MAAM,MAAM,GAAG,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;KAWZ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAmB;QACzB,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;sCAC8B,CAC/B;aACA,GAAG,CACF,GAAG,CAAC,EAAE,EACN,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,IAAI,EACR,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,EAC/B,GAAG,CAAC,SAAS,EACb,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAC3C,CAAC;IACN,CAAC;IAED,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CACN,wDAAwD,CACzD;aACA,GAAG,EAA4B,CAAC;QAEnC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEjE,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAkC;YACzE,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAA6B,CAAC,CAAC,CAAC,SAAS;SAC/E,CAAC;IACJ,CAAC;IAED,IAAI;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CACN,wDAAwD,CACzD;aACA,GAAG,EAA4B,CAAC;QAEnC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAkC;YACzE,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAA6B,CAAC,CAAC,CAAC,SAAS;SAC/E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,wCAAwC,CAAC;aACjD,GAAG,EAAc,CAAC;QACrB,OAAO,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,IAAI;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,wCAAwC,CAAC;aACjD,GAAG,EAAc,CAAC;QACrB,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,GAAG,EAAE,CAAC;IAChD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/channels/slack.d.ts

@@ -0,0 +1,17 @@
+import { EventEmitter } from "node:events";
+import type { VisionClawConfig } from "../config/types.js";
+import type { ChannelAdapter, MessageAttachment } from "./interface.js";
+/**
+ * Slack channel adapter using Bolt framework with Socket Mode.
+ * Supports multimodal inbound (file attachments) and outbound (images, files).
+ */
+export declare class SlackAdapter extends EventEmitter implements ChannelAdapter {
+    readonly name = "slack";
+    private config;
+    private app;
+    constructor(config: VisionClawConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendMessage(to: string, message: string, attachments?: MessageAttachment[]): Promise<void>;
+}
+//# sourceMappingURL=slack.d.ts.map

package/dist/channels/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/channels/slack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAkB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExF;;;GAGG;AACH,qBAAa,YAAa,SAAQ,YAAa,YAAW,cAAc;IACtE,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,GAAG,CAAoB;gBAEnB,MAAM,EAAE,gBAAgB;IAK9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2FtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,WAAW,CACf,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,iBAAiB,EAAE,GAChC,OAAO,CAAC,IAAI,CAAC;CAuCjB"}

package/dist/channels/slack.js

@@ -0,0 +1,142 @@
+import fs from "node:fs";
+import { EventEmitter } from "node:events";
+import { App } from "@slack/bolt";
+import { logger } from "../logger.js";
+import { uploadMedia } from "../files.js";
+/**
+ * Slack channel adapter using Bolt framework with Socket Mode.
+ * Supports multimodal inbound (file attachments) and outbound (images, files).
+ */
+export class SlackAdapter extends EventEmitter {
+    name = "slack";
+    config;
+    app = null;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    async start() {
+        const slackConfig = this.config.channels.slack;
+        if (!slackConfig)
+            throw new Error("Slack channel not configured");
+        if (!slackConfig.appToken || !slackConfig.botToken) {
+            throw new Error("Slack app token and bot token are required");
+        }
+        this.app = new App({
+            token: slackConfig.botToken,
+            appToken: slackConfig.appToken,
+            socketMode: true,
+        });
+        const botToken = slackConfig.botToken;
+        // Listen for messages mentioning the bot or DMs
+        this.app.message(async ({ message }) => {
+            // Type narrowing for message events with text
+            if (!("text" in message) || !message.text)
+                return;
+            if (!("user" in message) || !message.user)
+                return;
+            const commandMessage = {
+                id: `slack-${message.ts}-${message.channel}`,
+                channel: "slack",
+                sender: message.user,
+                text: message.text,
+                attachments: [],
+                timestamp: new Date(Number(message.ts) * 1000).toISOString(),
+                meta: {
+                    ts: message.ts,
+                    channelId: message.channel,
+                    threadTs: "thread_ts" in message ? message.thread_ts : undefined,
+                },
+            };
+            // Handle file attachments -- download and upload to S3
+            if ("files" in message && Array.isArray(message.files)) {
+                for (const file of message.files) {
+                    const mimeType = file.mimetype;
+                    const filename = file.name ?? "attachment";
+                    const privateUrl = file.url_private;
+                    let publicUrl;
+                    if (privateUrl) {
+                        try {
+                            // Download from Slack (requires bot token for auth)
+                            const response = await fetch(privateUrl, {
+                                headers: { Authorization: `Bearer ${botToken}` },
+                            });
+                            if (response.ok) {
+                                const arrayBuffer = await response.arrayBuffer();
+                                const buffer = Buffer.from(arrayBuffer);
+                                const s3Url = await uploadMedia(buffer, filename, mimeType);
+                                publicUrl = s3Url ?? undefined;
+                            }
+                        }
+                        catch (err) {
+                            logger.warn(`Slack: Failed to download file ${filename}: ${err instanceof Error ? err.message : String(err)}`);
+                        }
+                    }
+                    const type = mimeType.startsWith("image/")
+                        ? "image"
+                        : mimeType.startsWith("audio/")
+                            ? "audio"
+                            : mimeType.startsWith("video/")
+                                ? "video"
+                                : "file";
+                    commandMessage.attachments.push({
+                        type,
+                        url: publicUrl ?? privateUrl,
+                        filename,
+                        mimeType,
+                    });
+                }
+            }
+            this.emit("message", commandMessage);
+        });
+        this.app.error(async (error) => {
+            await Promise.resolve();
+            this.emit("error", new Error(`Slack error: ${error.message}`));
+        });
+        await this.app.start();
+    }
+    async stop() {
+        if (this.app) {
+            await this.app.stop();
+            this.app = null;
+        }
+    }
+    async sendMessage(to, message, attachments) {
+        if (!this.app) {
+            throw new Error("Slack app not started");
+        }
+        // Send text message
+        if (message.trim()) {
+            await this.app.client.chat.postMessage({
+                channel: to,
+                text: message,
+            });
+        }
+        // Send attachments
+        if (attachments && attachments.length > 0) {
+            for (const att of attachments) {
+                try {
+                    if (att.localPath && fs.existsSync(att.localPath)) {
+                        // Upload local file to Slack
+                        await this.app.client.files.uploadV2({
+                            channel_id: to,
+                            file: fs.createReadStream(att.localPath),
+                            filename: att.filename ?? att.localPath.split("/").pop() ?? "file",
+                        });
+                    }
+                    else if (att.url) {
+                        // Share URL as a message
+                        await this.app.client.chat.postMessage({
+                            channel: to,
+                            text: `[${att.type}: ${att.filename ?? "attachment"}] ${att.url}`,
+                        });
+                    }
+                }
+                catch (err) {
+                    logger.warn(`Slack: Failed to send ${att.type}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/channels/slack.js.map

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

package/dist/channels/sms.d.ts

@@ -0,0 +1,19 @@
+import { EventEmitter } from "node:events";
+import type { VisionClawConfig } from "../config/types.js";
+import type { ChannelAdapter } from "./interface.js";
+/**
+ * SMS channel adapter using the Twilio API.
+ * Requires a Twilio account and phone number.
+ * Runs a webhook server to receive incoming messages.
+ */
+export declare class SmsAdapter extends EventEmitter implements ChannelAdapter {
+    readonly name = "sms";
+    private config;
+    private server;
+    private port;
+    constructor(config: VisionClawConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendMessage(to: string, message: string): Promise<void>;
+}
+//# sourceMappingURL=sms.d.ts.map

package/dist/channels/sms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms.d.ts","sourceRoot":"","sources":["../../src/channels/sms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAErE;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,YAAa,YAAW,cAAc;IACpE,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAAQ;gBAER,MAAM,EAAE,gBAAgB;IAK9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB9D"}

package/dist/channels/sms.js

@@ -0,0 +1,111 @@
+import { EventEmitter } from "node:events";
+import http from "node:http";
+import { URL } from "node:url";
+import { logger } from "../logger.js";
+/**
+ * SMS channel adapter using the Twilio API.
+ * Requires a Twilio account and phone number.
+ * Runs a webhook server to receive incoming messages.
+ */
+export class SmsAdapter extends EventEmitter {
+    name = "sms";
+    config;
+    server = null;
+    port = 3002;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    async start() {
+        const smsConfig = this.config.channels.sms;
+        if (!smsConfig)
+            throw new Error("SMS channel not configured");
+        if (!smsConfig.twilioAccountSid ||
+            !smsConfig.twilioAuthToken ||
+            !smsConfig.twilioPhoneNumber) {
+            throw new Error("Twilio credentials are required for SMS");
+        }
+        this.server = http.createServer((req, res) => {
+            const url = new URL(req.url ?? "/", `http://localhost:${this.port}`);
+            // Twilio webhook for incoming SMS
+            if (req.method === "POST" && url.pathname === "/sms") {
+                let body = "";
+                req.on("data", (chunk) => (body += String(chunk)));
+                req.on("end", () => {
+                    try {
+                        const params = new URLSearchParams(body);
+                        const from = params.get("From") ?? "unknown";
+                        const text = params.get("Body") ?? "";
+                        const messageSid = params.get("MessageSid") ?? `sms-${Date.now()}`;
+                        if (text.trim()) {
+                            const commandMessage = {
+                                id: messageSid,
+                                channel: "sms",
+                                sender: from,
+                                text,
+                                attachments: [],
+                                timestamp: new Date().toISOString(),
+                                meta: {
+                                    messageSid,
+                                    from,
+                                    numMedia: params.get("NumMedia"),
+                                },
+                            };
+                            this.emit("message", commandMessage);
+                        }
+                    }
+                    catch (err) {
+                        logger.warn(`SMS: Error parsing webhook: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                    // Respond with empty TwiML
+                    res.writeHead(200, { "Content-Type": "text/xml" });
+                    res.end("<Response></Response>");
+                });
+                return;
+            }
+            res.writeHead(404);
+            res.end("Not found");
+        });
+        return new Promise((resolve) => {
+            const server = this.server;
+            if (server) {
+                server.listen(this.port, () => {
+                    logger.channel("sms", `Webhook listening on port ${this.port}`);
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    async stop() {
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => resolve());
+                this.server = null;
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    async sendMessage(to, message) {
+        const smsConfig = this.config.channels.sms;
+        if (!smsConfig)
+            throw new Error("Twilio not configured");
+        if (!smsConfig.twilioAccountSid ||
+            !smsConfig.twilioAuthToken ||
+            !smsConfig.twilioPhoneNumber) {
+            throw new Error("Twilio credentials are required");
+        }
+        const { default: twilio } = await import("twilio");
+        const client = twilio(smsConfig.twilioAccountSid, smsConfig.twilioAuthToken);
+        await client.messages.create({
+            body: message,
+            from: smsConfig.twilioPhoneNumber,
+            to,
+        });
+    }
+}
+//# sourceMappingURL=sms.js.map

package/dist/channels/sms.js.map

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