@cogitator-ai/channels 0.2.1

package/README.md

@@ -0,0 +1,349 @@
+# @cogitator-ai/channels
+
+Connect Cogitator agents to messaging platforms. Gateway routes messages across channels, handles sessions, streaming, media, and middleware.
+
+## Install
+
+```bash
+pnpm add @cogitator-ai/channels
+
+# Then install the adapters you need:
+pnpm add grammy                    # Telegram
+pnpm add discord.js                # Discord
+pnpm add @slack/bolt               # Slack
+pnpm add @whiskeysockets/baileys   # WhatsApp
+pnpm add ws                        # WebChat
+```
+
+## Quick Start
+
+```typescript
+import { Cogitator, Agent } from '@cogitator-ai/core';
+import { Gateway, telegramChannel } from '@cogitator-ai/channels';
+
+const cogitator = new Cogitator({ llm: { defaultModel: 'google/gemini-2.5-flash' } });
+const agent = new Agent({ name: 'bot', instructions: 'You are a helpful assistant.' });
+
+const gateway = new Gateway({
+  cogitator,
+  agent,
+  channels: [telegramChannel({ token: process.env.TG_TOKEN! })],
+  stream: { flushInterval: 500, minChunkSize: 20 },
+});
+
+await gateway.start();
+```
+
+## Channels
+
+### Telegram
+
+**Get your token:** Open Telegram → search `@BotFather` → send `/newbot` → follow prompts → copy the token.
+
+```typescript
+import { telegramChannel } from '@cogitator-ai/channels';
+
+telegramChannel({ token: process.env.TG_TOKEN! });
+
+// Webhook mode (production):
+telegramChannel({
+  token: process.env.TG_TOKEN!,
+  webhook: { url: 'https://example.com/telegram', port: 8443 },
+});
+```
+
+Supports: text, photos (→ vision), voice (→ STT), documents, streaming via editText, emoji reactions, 4096 char limit.
+
+### Discord
+
+**Get your token:** [Discord Developer Portal](https://discord.com/developers/applications) → New Application → Bot → Reset Token → copy it. **Enable "Message Content Intent"** under Privileged Gateway Intents. Invite via OAuth2 URL Generator with `bot` scope + `Send Messages`, `Read Message History`, `Add Reactions` permissions.
+
+```typescript
+import { discordChannel } from '@cogitator-ai/channels';
+
+discordChannel({
+  token: process.env.DISCORD_TOKEN!,
+  mentionOnly: true, // only respond when @mentioned in servers
+});
+```
+
+Supports: DMs, server messages, streaming, reactions, auto-chunking (2000 char limit, code-block aware).
+
+### Slack
+
+**Get your tokens (3 total):**
+
+1. [api.slack.com/apps](https://api.slack.com/apps) → Create New App → From scratch
+2. Socket Mode → enable → generate App Token (`xapp-...`) → save as `SLACK_APP_TOKEN`
+3. OAuth & Permissions → add scopes: `chat:write`, `app_mentions:read`, `im:history`, `im:read`, `im:write`
+4. Event Subscriptions → enable → add: `message.im`, `app_mention`
+5. Install App → copy Bot Token (`xoxb-...`) → save as `SLACK_BOT_TOKEN`
+6. Basic Information → copy Signing Secret → save as `SLACK_SIGNING_SECRET`
+
+```typescript
+import { slackChannel } from '@cogitator-ai/channels';
+
+slackChannel({
+  token: process.env.SLACK_BOT_TOKEN!,
+  signingSecret: process.env.SLACK_SIGNING_SECRET!,
+  appToken: process.env.SLACK_APP_TOKEN!,
+});
+```
+
+Supports: DMs, channel messages (via @mention), Socket Mode (no public URL), streaming via chat.update.
+
+### WhatsApp
+
+No bot API — connects as a linked device to your WhatsApp account (like WhatsApp Web).
+
+```typescript
+import { whatsappChannel } from '@cogitator-ai/channels';
+
+whatsappChannel({
+  sessionPath: '.cogitator/whatsapp-session',
+  printQr: true,
+});
+```
+
+**First run:** QR code prints to terminal → scan from WhatsApp → Settings → Linked Devices. Session is saved for future restarts.
+
+Supports: 1-on-1 and group chats, typing indicators, auto-reconnect, WhatsApp-native markdown. No streaming (WhatsApp doesn't support editing).
+
+### WebChat
+
+WebSocket server for custom UIs, CLI tools, or any client.
+
+```typescript
+import { webchatChannel } from '@cogitator-ai/channels';
+
+webchatChannel({
+  port: 3100,
+  path: '/ws',
+  auth: (token) => token === process.env.WEBCHAT_SECRET,
+});
+```
+
+Connect: `ws://localhost:3100/ws?token=YOUR_SECRET`. Send `{"text": "Hello!"}`, receive `{"type": "message", "id": "...", "text": "..."}`.
+
+Supports: streaming (via edit messages), typing indicators, token auth, no message limit.
+
+## Platform Comparison
+
+| Feature            | Telegram     | Discord | Slack     | WhatsApp | WebChat   |
+| ------------------ | ------------ | ------- | --------- | -------- | --------- |
+| Streaming (edit)   | ✅           | ✅      | ✅        | ❌       | ✅        |
+| Reactions          | ✅           | ✅      | ❌        | ❌       | ❌        |
+| Typing indicator   | ✅           | ✅      | ⚠️        | ✅       | ✅        |
+| Photos → vision    | ✅           | ❌      | ❌        | ❌       | ❌        |
+| Voice → STT        | ✅           | ❌      | ❌        | ❌       | ❌        |
+| Max message length | 4096         | 2000    | ~4000     | ~65536   | unlimited |
+| Public URL needed  | webhook only | no      | HTTP only | no       | no        |
+
+## Gateway
+
+Routes incoming messages to your agent. Handles:
+
+- Session management (per-user, per-channel)
+- Streaming with `StreamBuffer` (chunked message editing)
+- Typing keep-alive (re-sends typing indicator every 4s)
+- Media processing (images → vision, voice → STT)
+- Middleware pipeline
+- Platform-specific markdown conversion
+- Status reactions, debouncing, envelope formatting, queue modes
+
+## Status Reactions
+
+Emoji progress indicators on the user's message:
+
+```typescript
+const gateway = new Gateway({
+  // ...
+  reactions: {
+    enabled: true,
+    emojis: { queued: '👀', thinking: '🤔', tool: '🔥', done: '👍', error: '😱' },
+    debounceMs: 700,
+    stallSoftMs: 10000,
+    stallHardMs: 30000,
+  },
+});
+```
+
+## Inbound Debouncing
+
+Merge rapid messages into a single LLM call:
+
+```typescript
+const gateway = new Gateway({
+  // ...
+  debounce: {
+    enabled: true,
+    delayMs: 1500,
+    byChannel: { discord: 2000 },
+  },
+});
+```
+
+## Envelope Formatting
+
+Wrap messages with context so the LLM knows who's talking, on which platform, and when:
+
+`[14:23 MSK | telegram | @alice | DM | +2m30s] Hello world`
+
+```typescript
+const gateway = new Gateway({
+  // ...
+  envelope: {
+    enabled: true,
+    includeTimestamp: true,
+    includeElapsed: true,
+    includeSender: true,
+    includeChannel: true,
+    includeChatType: true,
+    timezone: 'Europe/Moscow',
+  },
+});
+```
+
+## Queue Modes
+
+Control concurrent message handling per user:
+
+```typescript
+const gateway = new Gateway({
+  // ...
+  queueMode: 'sequential', // 'parallel' | 'sequential' | 'interrupt' | 'collect'
+});
+```
+
+- **parallel** — default, all messages processed immediately
+- **sequential** — FIFO per thread, wait for current to finish
+- **interrupt** — abort current, start new message
+- **collect** — buffer during processing, merge on idle
+
+## Formatting Pipeline
+
+Platform-specific markdown conversion applied automatically:
+
+- **Telegram** — `# headers` → bold, preserves code blocks
+- **Discord** — native Markdown, auto-chunks at 2000 chars with code block integrity
+- **Slack** — `**bold**` → `*bold*`, headers → bold
+- **WhatsApp** — `**bold**` → `*bold*`, `~~strike~~` → `~strike~`
+
+## Middleware
+
+```typescript
+import { rateLimit, ownerCommands, DmPolicyMiddleware, autoExtract } from '@cogitator-ai/channels';
+
+const gateway = new Gateway({
+  // ...
+  middleware: [
+    rateLimit({ maxPerMinute: 30 }),
+    ownerCommands({
+      ownerIds: { telegram: '123' },
+      commandLevels: { status: 'authorized', block: 'owner', help: 'public' },
+    }),
+    new DmPolicyMiddleware({
+      mode: 'pairing',
+      ownerIds: { telegram: '123' },
+      storePath: '~/.cogitator/dm-allowlist.json',
+      groupPolicy: 'open',
+    }),
+    autoExtract({ extractor }),
+  ],
+});
+```
+
+### DM Policy Modes
+
+- **open** — anyone can DM the bot
+- **allowlist** — only pre-approved users
+- **pairing** — unknown users get a code, owner approves via `/pair CODE`
+- **disabled** — DMs blocked entirely
+
+### Command Authorization Levels
+
+Commands have 3 access levels: `owner`, `authorized`, `public`. Owner-only commands (like `/block`, `/model`) can't be run by regular users even if they're approved.
+
+## Lifecycle Hooks
+
+Subscribe to events across the message lifecycle:
+
+```typescript
+import { createHookRegistry } from '@cogitator-ai/channels';
+
+const hooks = createHookRegistry();
+hooks.on('message:received', (e) => console.log('New message:', e));
+hooks.on('agent:after_run', (e) => console.log('Response:', e));
+hooks.on('agent:error', (e) => console.error('Agent failed:', e));
+
+const gateway = new Gateway({ /* ... */ hooks });
+```
+
+Available hooks: `message:received`, `message:sending`, `message:sent`, `agent:before_run`, `agent:after_run`, `agent:error`, `session:created`, `session:compacted`, `stream:started`, `stream:finished`.
+
+Errors in one handler don't affect others.
+
+## Media & STT
+
+Voice messages are transcribed automatically. STT provider is selected by available env vars (highest priority first):
+
+1. **Deepgram** — set `DEEPGRAM_API_KEY` (nova-3 model, fast and accurate)
+2. **Groq** — set `GROQ_API_KEY` (free tier available)
+3. **OpenAI** — set `OPENAI_API_KEY`
+4. **Local Whisper** — downloads ~75MB model on first use, runs offline (no API key needed)
+
+Images are passed to the LLM as vision input if the model supports it.
+
+## Scheduler
+
+```typescript
+import { HeartbeatScheduler, SimpleTimerStore } from '@cogitator-ai/channels';
+
+const store = new SimpleTimerStore({ persistPath: '.cogitator/timers.json' });
+const scheduler = new HeartbeatScheduler(store, {
+  onFire: (msg) => gateway.injectMessage(msg),
+  pollInterval: 30_000,
+  maxRetries: 5,
+  onRunComplete: (entry, status, error, durationMs) => {
+    console.log(`Job ${entry.id}: ${status} (${durationMs}ms)`);
+  },
+});
+scheduler.start();
+```
+
+Schedule types: `cron` (recurring), `recurring` (interval), `fixed` (one-shot). Error tracking with auto-backoff.
+
+```typescript
+await scheduler.listJobs();
+await scheduler.enableJob(id);
+await scheduler.disableJob(id);
+await scheduler.cancelJob(id);
+```
+
+## Environment Variables
+
+```bash
+# LLM Provider
+GOOGLE_API_KEY=...           # or ANTHROPIC_API_KEY, OPENAI_API_KEY
+
+# Telegram
+TG_TOKEN=7204891735:AAHr...
+
+# Discord
+DISCORD_TOKEN=MTI...
+
+# Slack (3 tokens)
+SLACK_BOT_TOKEN=xoxb-...
+SLACK_SIGNING_SECRET=...
+SLACK_APP_TOKEN=xapp-...
+
+# WhatsApp — no token, uses QR pairing
+
+# WebChat
+WEBCHAT_SECRET=your-secret
+
+# STT (optional, for voice messages — pick one)
+DEEPGRAM_API_KEY=...         # highest priority
+GROQ_API_KEY=...             # free tier
+OPENAI_API_KEY=...           # fallback
+```

package/dist/assistant-config.d.ts

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+export declare const AssistantConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    personality: z.ZodString;
+    llm: z.ZodObject<{
+        provider: z.ZodEnum<{
+            google: "google";
+            openai: "openai";
+            anthropic: "anthropic";
+            ollama: "ollama";
+        }>;
+        model: z.ZodString;
+    }, z.core.$strip>;
+    channels: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        telegram: z.ZodOptional<z.ZodObject<{
+            ownerIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        discord: z.ZodOptional<z.ZodObject<{
+            ownerIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        slack: z.ZodOptional<z.ZodObject<{
+            ownerIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    capabilities: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        webSearch: z.ZodOptional<z.ZodBoolean>;
+        fileSystem: z.ZodOptional<z.ZodObject<{
+            paths: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        github: z.ZodOptional<z.ZodBoolean>;
+        deviceTools: z.ZodOptional<z.ZodBoolean>;
+        browser: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            headless: z.ZodDefault<z.ZodBoolean>;
+            stealth: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>]>>;
+        scheduler: z.ZodOptional<z.ZodBoolean>;
+        rag: z.ZodOptional<z.ZodObject<{
+            paths: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        selfConfig: z.ZodOptional<z.ZodBoolean>;
+        selfTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>>;
+    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodArray<z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>>;
+    memory: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        adapter: z.ZodDefault<z.ZodEnum<{
+            sqlite: "sqlite";
+            postgres: "postgres";
+        }>>;
+        path: z.ZodOptional<z.ZodString>;
+        autoExtract: z.ZodDefault<z.ZodBoolean>;
+        knowledgeGraph: z.ZodDefault<z.ZodBoolean>;
+        compaction: z.ZodOptional<z.ZodObject<{
+            threshold: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    security: z.ZodOptional<z.ZodObject<{
+        dmPolicy: z.ZodDefault<z.ZodEnum<{
+            open: "open";
+            allowlist: "allowlist";
+            pairing: "pairing";
+            disabled: "disabled";
+        }>>;
+        allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        groupPolicy: z.ZodDefault<z.ZodEnum<{
+            open: "open";
+            allowlist: "allowlist";
+            disabled: "disabled";
+        }>>;
+        groupAllowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        storePath: z.ZodOptional<z.ZodString>;
+        commandAccess: z.ZodOptional<z.ZodObject<{
+            authorized: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            publicCommands: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    stream: z.ZodOptional<z.ZodObject<{
+        flushInterval: z.ZodDefault<z.ZodNumber>;
+        minChunkSize: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    rateLimit: z.ZodOptional<z.ZodObject<{
+        maxPerMinute: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AssistantConfigInput = z.input<typeof AssistantConfigSchema>;
+export type AssistantConfigOutput = z.output<typeof AssistantConfigSchema>;
+//# sourceMappingURL=assistant-config.d.ts.map

package/dist/assistant-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-config.d.ts","sourceRoot":"","sources":["../src/assistant-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/assistant-config.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+const McpServerSchema = z.object({
+    command: z.string(),
+    args: z.array(z.string()),
+    env: z.record(z.string(), z.string()).optional(),
+});
+const AssistantChannelsSchema = z.object({
+    telegram: z.object({ ownerIds: z.array(z.string()).optional() }).optional(),
+    discord: z.object({ ownerIds: z.array(z.string()).optional() }).optional(),
+    slack: z.object({ ownerIds: z.array(z.string()).optional() }).optional(),
+});
+const AssistantCapabilitiesSchema = z.object({
+    webSearch: z.boolean().optional(),
+    fileSystem: z.object({ paths: z.array(z.string()) }).optional(),
+    github: z.boolean().optional(),
+    deviceTools: z.boolean().optional(),
+    browser: z
+        .union([
+        z.boolean(),
+        z.object({
+            headless: z.boolean().default(true),
+            stealth: z.boolean().default(false),
+        }),
+    ])
+        .optional(),
+    scheduler: z.boolean().optional(),
+    rag: z.object({ paths: z.array(z.string()) }).optional(),
+    selfConfig: z.boolean().optional(),
+    selfTools: z
+        .union([
+        z.boolean(),
+        z.object({
+            path: z.string().optional(),
+        }),
+    ])
+        .optional(),
+});
+const AssistantMemorySchema = z.object({
+    adapter: z.enum(['sqlite', 'postgres']).default('sqlite'),
+    path: z.string().optional(),
+    autoExtract: z.boolean().default(true),
+    knowledgeGraph: z.boolean().default(true),
+    compaction: z.object({ threshold: z.number() }).optional(),
+});
+const CommandAccessSchema = z
+    .object({
+    authorized: z.array(z.string()).optional(),
+    publicCommands: z.array(z.string()).optional(),
+})
+    .optional();
+const SecuritySchema = z
+    .object({
+    dmPolicy: z.enum(['open', 'allowlist', 'pairing', 'disabled']).default('open'),
+    allowlist: z.array(z.string()).optional(),
+    groupPolicy: z.enum(['open', 'allowlist', 'disabled']).default('open'),
+    groupAllowlist: z.array(z.string()).optional(),
+    storePath: z.string().optional(),
+    commandAccess: CommandAccessSchema,
+})
+    .optional();
+export const AssistantConfigSchema = z.object({
+    name: z.string(),
+    personality: z.string(),
+    llm: z.object({
+        provider: z.enum(['google', 'openai', 'anthropic', 'ollama']),
+        model: z.string(),
+    }),
+    channels: AssistantChannelsSchema.optional().default({}),
+    capabilities: AssistantCapabilitiesSchema.optional().default({}),
+    mcpServers: z.record(z.string(), McpServerSchema).optional(),
+    memory: AssistantMemorySchema.optional().default({
+        adapter: 'sqlite',
+        autoExtract: true,
+        knowledgeGraph: true,
+    }),
+    security: SecuritySchema,
+    stream: z
+        .object({
+        flushInterval: z.number().default(600),
+        minChunkSize: z.number().default(30),
+    })
+        .optional(),
+    rateLimit: z
+        .object({
+        maxPerMinute: z.number().default(30),
+    })
+        .optional(),
+});
+//# sourceMappingURL=assistant-config.js.map

package/dist/assistant-config.js.map

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

package/dist/capabilities.d.ts

@@ -0,0 +1,14 @@
+export interface CapabilitiesInput {
+    tools: Array<{
+        name: string;
+        description: string;
+    }>;
+    channels: string[];
+    memoryStats?: {
+        entities: number;
+        relations: number;
+    };
+    scheduledTasks?: number;
+}
+export declare function generateCapabilitiesDoc(input: CapabilitiesInput): string;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA+BxE"}

package/dist/capabilities.js

@@ -0,0 +1,28 @@
+export function generateCapabilitiesDoc(input) {
+    const lines = ['# Assistant Capabilities', ''];
+    lines.push('## Available Tools', '');
+    for (const t of input.tools) {
+        lines.push(`- **${t.name}** — ${t.description}`);
+    }
+    lines.push('');
+    if (input.channels.length > 0) {
+        lines.push('## Connected Channels', '');
+        for (const ch of input.channels) {
+            lines.push(`- ${ch}`);
+        }
+        lines.push('');
+    }
+    if (input.memoryStats) {
+        lines.push('## Memory', '');
+        lines.push(`- ${input.memoryStats.entities} entities in knowledge graph`);
+        lines.push(`- ${input.memoryStats.relations} relations`);
+        lines.push('');
+    }
+    if (input.scheduledTasks !== undefined) {
+        lines.push('## Scheduled Tasks', '');
+        lines.push(`- ${input.scheduledTasks} active scheduled tasks`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC9D,MAAM,KAAK,GAAa,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAEzD,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;QACxC,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,WAAW,CAAC,QAAQ,8BAA8B,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,WAAW,CAAC,SAAS,YAAY,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,cAAc,yBAAyB,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/channels/discord.d.ts

@@ -0,0 +1,26 @@
+import type { Channel, ChannelMessage, ChannelType, Attachment, SendOptions } from '@cogitator-ai/types';
+export interface DiscordConfig {
+    token: string;
+    intents?: number[];
+    mentionOnly?: boolean;
+}
+export declare class DiscordChannel implements Channel {
+    private readonly config;
+    readonly type: ChannelType;
+    private handler;
+    private client;
+    private botUserId;
+    constructor(config: DiscordConfig);
+    onMessage(handler: (msg: ChannelMessage) => Promise<void>): void;
+    start(): Promise<void>;
+    private handleDiscordMessage;
+    stop(): Promise<void>;
+    sendText(channelId: string, text: string, options?: SendOptions): Promise<string>;
+    editText(channelId: string, messageId: string, text: string): Promise<void>;
+    sendFile(channelId: string, file: Attachment): Promise<void>;
+    sendTyping(channelId: string): Promise<void>;
+    deleteMessage(channelId: string, messageId: string): Promise<void>;
+    setReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
+}
+export declare function discordChannel(config: DiscordConfig): Channel;
+//# sourceMappingURL=discord.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discord.d.ts","sourceRoot":"","sources":["../../src/channels/discord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAuCD,qBAAa,cAAe,YAAW,OAAO;IAMhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAa;IACvC,OAAO,CAAC,OAAO,CAAyD;IACxE,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAAuB;gBAEX,MAAM,EAAE,aAAa;IAElD,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAoCd,oBAAoB;IA8B5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBjF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWtF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE7D"}