agent-messenger 1.0.0

package/dist/types/index.js

@@ -0,0 +1,92 @@
+/**
+ * Core type definitions for agent-slack
+ */
+import { z } from 'zod';
+// Zod validation schemas
+export const SlackChannelSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    is_private: z.boolean(),
+    is_archived: z.boolean(),
+    created: z.number(),
+    creator: z.string(),
+    topic: z
+        .object({
+        value: z.string(),
+        creator: z.string(),
+        last_set: z.number(),
+    })
+        .optional(),
+    purpose: z
+        .object({
+        value: z.string(),
+        creator: z.string(),
+        last_set: z.number(),
+    })
+        .optional(),
+});
+export const SlackMessageSchema = z.object({
+    ts: z.string(),
+    text: z.string(),
+    user: z.string().optional(),
+    username: z.string().optional(),
+    type: z.string(),
+    thread_ts: z.string().optional(),
+    reply_count: z.number().optional(),
+    replies: z
+        .array(z.object({
+        user: z.string(),
+        ts: z.string(),
+    }))
+        .optional(),
+    edited: z
+        .object({
+        user: z.string(),
+        ts: z.string(),
+    })
+        .optional(),
+});
+export const SlackUserSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    real_name: z.string(),
+    is_admin: z.boolean(),
+    is_owner: z.boolean(),
+    is_bot: z.boolean(),
+    is_app_user: z.boolean(),
+    profile: z
+        .object({
+        email: z.string().optional(),
+        phone: z.string().optional(),
+        title: z.string().optional(),
+        status_text: z.string().optional(),
+    })
+        .optional(),
+});
+export const SlackReactionSchema = z.object({
+    name: z.string(),
+    count: z.number(),
+    users: z.array(z.string()),
+});
+export const SlackFileSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    title: z.string(),
+    mimetype: z.string(),
+    size: z.number(),
+    url_private: z.string(),
+    created: z.number(),
+    user: z.string(),
+    channels: z.array(z.string()).optional(),
+});
+export const WorkspaceCredentialsSchema = z.object({
+    workspace_id: z.string(),
+    workspace_name: z.string(),
+    token: z.string(),
+    cookie: z.string(),
+});
+export const ConfigSchema = z.object({
+    current_workspace: z.string().nullable(),
+    workspaces: z.record(z.string(), WorkspaceCredentialsSchema),
+});
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA8FvB,yBAAyB;AACzB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC;SACL,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;SACD,QAAQ,EAAE;IACb,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;KACf,CAAC,CACH;SACA,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;KACf,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;IACxB,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACnC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC3B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC;CAC7D,CAAC,CAAA"}

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,2 @@
+export declare function handleError(error: Error): void;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAG9C"}

package/dist/utils/error-handler.js

@@ -0,0 +1,5 @@
+export function handleError(error) {
+    console.error(JSON.stringify({ error: error.message }));
+    process.exit(1);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,2 @@
+export declare function formatOutput(data: unknown, pretty?: boolean): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAEpE"}

package/dist/utils/output.js

@@ -0,0 +1,4 @@
+export function formatOutput(data, pretty) {
+    return pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,MAAgB;IAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AACtE,CAAC"}

package/docs/discord.md

@@ -0,0 +1,182 @@
+# Discord Integration
+
+Detailed documentation for Discord integration in agent-messenger.
+
+> **Note**: `agent-discord` is a convenient shortcut for `agent-messenger discord`.
+
+## Quick Start
+
+```bash
+# 1. Extract credentials from Discord desktop app (zero-config!)
+agent-discord auth extract
+
+# 2. Get guild snapshot
+agent-discord snapshot
+
+# 3. Send a message
+agent-discord message send <channel-id> "Hello from AI agent!"
+```
+
+## Authentication
+
+### Seamless Token Extraction
+
+agent-discord automatically extracts your Discord credentials from the desktop app:
+
+```bash
+agent-discord auth extract
+
+# Use --debug for troubleshooting
+agent-discord auth extract --debug
+```
+
+This command:
+- Auto-detects your platform (macOS/Linux/Windows)
+- Extracts Discord user token from the desktop app
+- Validates token against Discord API
+- Discovers ALL joined guilds (servers)
+- Stores credentials securely in `~/.config/agent-messenger/`
+
+### Authentication Commands
+
+```bash
+# Check auth status
+agent-discord auth status
+
+# Logout (clear stored credentials)
+agent-discord auth logout
+```
+
+## Guild Management
+
+Discord uses "guilds" (servers) instead of workspaces. You must select a guild before using most commands.
+
+```bash
+# List all guilds
+agent-discord guild list
+
+# Switch to a different guild
+agent-discord guild switch <guild-id>
+
+# Show current guild
+agent-discord guild current
+
+# Get guild info
+agent-discord guild info <guild-id>
+```
+
+## Commands
+
+### Message Commands
+
+```bash
+# Send a message
+agent-discord message send <channel-id> <content>
+agent-discord message send 123456789 "Hello world"
+
+# List messages
+agent-discord message list <channel-id>
+agent-discord message list 123456789 --limit 50
+
+# Get a specific message
+agent-discord message get <channel-id> <message-id>
+
+# Delete a message
+agent-discord message delete <channel-id> <message-id> --force
+```
+
+### Channel Commands
+
+```bash
+# List channels in current guild
+agent-discord channel list
+
+# Get channel info
+agent-discord channel info <channel-id>
+
+# Get channel message history
+agent-discord channel history <channel-id>
+agent-discord channel history 123456789 --limit 100
+```
+
+### User Commands
+
+```bash
+# List guild members
+agent-discord user list
+
+# Get user info
+agent-discord user info <user-id>
+
+# Get current authenticated user
+agent-discord user me
+```
+
+### Reaction Commands
+
+```bash
+# Add reaction
+agent-discord reaction add <channel-id> <message-id> <emoji>
+agent-discord reaction add 123456789 987654321 thumbsup
+
+# Remove reaction
+agent-discord reaction remove <channel-id> <message-id> <emoji>
+
+# List reactions on a message
+agent-discord reaction list <channel-id> <message-id>
+```
+
+### File Commands
+
+```bash
+# Upload file to channel
+agent-discord file upload <channel-id> <path>
+agent-discord file upload 123456789 ./report.pdf
+
+# List files in channel
+agent-discord file list <channel-id>
+
+# Get file info
+agent-discord file info <channel-id> <file-id>
+```
+
+### Snapshot Command
+
+Get comprehensive guild state for AI agents:
+
+```bash
+# Full snapshot (channels, members, recent messages)
+agent-discord snapshot
+
+# Filtered snapshots
+agent-discord snapshot --channels-only
+agent-discord snapshot --users-only
+
+# Limit messages per channel
+agent-discord snapshot --limit 10
+```
+
+## Global Options
+
+All commands support these options:
+
+```bash
+--pretty    # Pretty-print JSON output (default is compact JSON)
+--guild <id>  # Use specific guild (overrides current guild)
+```
+
+## Key Differences from Slack
+
+| Concept | Slack | Discord |
+|---------|-------|---------|
+| Server | Workspace | Guild |
+| Channel ID | Alphanumeric (C01234567) | Numeric snowflake (123456789012345678) |
+| Message ID | Timestamp (1234567890.123456) | Numeric snowflake (123456789012345678) |
+| User ID | Alphanumeric (U01234567) | Numeric snowflake (123456789012345678) |
+| Threads | Thread timestamps | Thread channels |
+
+## AI Agent Integration
+
+See `skills/agent-messenger/` directory for:
+- Complete skill documentation
+- Runnable templates

package/docs/slack.md

@@ -0,0 +1,160 @@
+# Slack Integration
+
+Detailed documentation for Slack integration in agent-messenger.
+
+> **Note**: `agent-slack` is a convenient shortcut for `agent-messenger slack`.
+
+## Quick Start
+
+```bash
+# 1. Extract credentials from Slack desktop app (zero-config!)
+agent-slack auth extract
+
+# 2. Get workspace snapshot
+agent-slack snapshot
+
+# 3. Send a message
+agent-slack message send general "Hello from AI agent!"
+```
+
+## Authentication
+
+### Seamless Token Extraction
+
+agent-slack automatically extracts your Slack credentials from the desktop app:
+
+```bash
+agent-slack auth extract
+
+# Use --debug for troubleshooting
+agent-slack auth extract --debug
+```
+
+This command:
+- Auto-detects your platform (macOS/Linux/Windows)
+- Supports both direct download and App Store versions on macOS
+- Extracts xoxc token and xoxd cookie
+- Validates tokens against Slack API
+- Discovers ALL logged-in workspaces
+- Stores credentials securely in `~/.config/agent-messenger/`
+
+### Multi-Workspace Management
+
+```bash
+# List all authenticated workspaces
+agent-slack workspace list
+
+# Switch to a different workspace
+agent-slack workspace switch <workspace-id>
+
+# Show current workspace
+agent-slack workspace current
+
+# Check auth status
+agent-slack auth status
+```
+
+## Commands
+
+### Message Commands
+
+```bash
+# Send a message
+agent-slack message send <channel> <text>
+agent-slack message send general "Hello world"
+
+# Send a threaded reply
+agent-slack message send general "Reply" --thread <ts>
+
+# List messages
+agent-slack message list <channel>
+agent-slack message list general --limit 50
+
+# Search messages across workspace
+agent-slack message search <query>
+agent-slack message search "project update" --limit 50
+
+# Update a message
+agent-slack message update <channel> <ts> <new-text>
+
+# Delete a message
+agent-slack message delete <channel> <ts> --force
+```
+
+### Channel Commands
+
+```bash
+# List channels (excludes archived by default)
+agent-slack channel list
+agent-slack channel list --type public
+agent-slack channel list --include-archived
+
+# Get channel info
+agent-slack channel info <channel>
+agent-slack channel info general
+```
+
+### User Commands
+
+```bash
+# List users
+agent-slack user list
+agent-slack user list --include-bots
+
+# Get user info
+agent-slack user info <user>
+
+# Get current user
+agent-slack user me
+```
+
+### Reaction Commands
+
+```bash
+# Add reaction
+agent-slack reaction add <channel> <ts> <emoji>
+agent-slack reaction add general 1234567890.123456 thumbsup
+
+# Remove reaction
+agent-slack reaction remove <channel> <ts> <emoji>
+
+# List reactions
+agent-slack reaction list <channel> <ts>
+```
+
+### File Commands
+
+```bash
+# Upload file
+agent-slack file upload <channel> <path>
+agent-slack file upload general ./report.pdf
+
+# List files
+agent-slack file list
+agent-slack file list --channel general
+
+# Get file info
+agent-slack file info <file-id>
+```
+
+### Snapshot Command
+
+Get comprehensive workspace state for AI agents:
+
+```bash
+# Full snapshot
+agent-slack snapshot
+
+# Filtered snapshots
+agent-slack snapshot --channels-only
+agent-slack snapshot --users-only
+
+# Limit messages per channel
+agent-slack snapshot --limit 10
+```
+
+## AI Agent Integration
+
+See `skills/agent-messenger/` directory for:
+- Complete skill documentation
+- Runnable templates

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "agent-messenger",
+  "version": "1.0.0",
+  "description": "Multi-platform messaging CLI for AI agents (Slack, Discord, Teams)",
+  "type": "module",
+  "module": "dist/cli.js",
+  "main": "dist/cli.js",
+  "bin": {
+    "agent-messenger": "./src/cli.ts",
+    "amsg": "./src/cli.ts",
+    "agent-slack": "./src/platforms/slack/cli.ts",
+    "agent-discord": "./src/platforms/discord/cli.ts"
+  },
+  "scripts": {
+    "build": "tsc && sed -i '' '1s|#!/usr/bin/env bun|#!/usr/bin/env node|' dist/cli.js",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "dev": "bun --hot ./dist/cli.js",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@slack/web-api": "^6.9.0",
+    "commander": "^11.1.0",
+    "zod": "^3.22.4",
+    "classic-level": "^1.3.0",
+    "better-sqlite3": "^9.2.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.13",
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/bun": "latest",
+    "@types/node": "^20.10.6",
+    "typescript": "^5.9.3"
+  }
+}