agent-messenger 1.0.0 → 1.2.0

package/docs/content/docs/quick-start.mdx

@@ -0,0 +1,103 @@
+---
+title: Quick Start
+description: Get up and running with Agent Messenger in 30 seconds.
+icon: Rocket
+---
+
+## Installation
+
+```bash
+npm install -g agent-messenger
+```
+
+Or use your favorite package manager:
+
+```bash
+# Using pnpm
+pnpm add -g agent-messenger
+
+# Using yarn
+yarn global add agent-messenger
+
+# Using bun
+bun add -g agent-messenger
+```
+
+This installs three CLI tools:
+- `agent-slack` — Slack CLI
+- `agent-discord` — Discord CLI
+- `agent-teams` — Microsoft Teams CLI
+
+## Extract Credentials
+
+Agent Messenger automatically extracts tokens from your desktop apps. Make sure the app is installed and you're logged in.
+
+```bash
+# For Slack
+agent-slack auth extract
+
+# For Discord
+agent-discord auth extract
+
+# For Teams
+agent-teams auth extract
+```
+
+That's it. No OAuth flows. No API tokens. No configuration files.
+
+## Verify Setup
+
+Check that authentication worked:
+
+```bash
+agent-slack auth status
+```
+
+You should see your workspace name and user info.
+
+## Send Your First Message
+
+```bash
+# Get a snapshot of your workspace
+agent-slack snapshot --pretty
+
+# Send a message to a channel
+agent-slack message send general "Hello from the CLI!"
+```
+
+## Output Formats
+
+By default, all commands output compact JSON (perfect for AI agents):
+
+```bash
+agent-slack channel list
+# {"channels":[{"id":"C01234567","name":"general",...}]}
+```
+
+Add `--pretty` for human-readable output:
+
+```bash
+agent-slack channel list --pretty
+```
+
+## Multi-Workspace Support
+
+If you're logged into multiple workspaces:
+
+```bash
+# List all workspaces
+agent-slack workspace list
+
+# Switch to a different workspace
+agent-slack workspace switch <workspace-id>
+
+# Check current workspace
+agent-slack workspace current
+```
+
+## Next Steps
+
+- [Slack Reference](/docs/integrations/slack) - Full command reference
+- [Discord Reference](/docs/integrations/discord) - Full command reference
+- [Teams Reference](/docs/integrations/teams) - Full command reference
+- [Agent Skills](/docs/agent-skills) - Integrate with AI coding agents

package/docs/eslint.config.mjs

@@ -0,0 +1,30 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+import tailwindcss from "eslint-plugin-tailwindcss";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  {
+    plugins: {
+      tailwindcss,
+    },
+    rules: {
+      "tailwindcss/classnames-order": "warn",
+      "tailwindcss/no-custom-classname": "off",
+      "react-hooks/set-state-in-effect": "off",
+    },
+  },
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+    ".source/**",
+  ]),
+]);
+
+export default eslintConfig;

package/docs/next.config.ts

@@ -0,0 +1,10 @@
+import { createMDX } from 'fumadocs-mdx/next';
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+const withMDX = createMDX();
+
+export default withMDX(nextConfig);

package/docs/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "docs",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "biome check . && eslint .",
+    "format": "biome format --write ."
+  },
+  "dependencies": {
+    "@types/mdx": "^2.0.13",
+    "fumadocs-core": "^16.5.0",
+    "fumadocs-mdx": "^14.2.6",
+    "fumadocs-ui": "^16.5.0",
+    "lucide-react": "^0.563.0",
+    "next": "16.1.6",
+    "next-themes": "^0.4.6",
+    "react": "19.2.3",
+    "react-dom": "19.2.3"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.1.6",
+    "eslint-plugin-tailwindcss": "^4.0.0-beta.0",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  },
+  "ignoreScripts": [
+    "sharp",
+    "unrs-resolver"
+  ],
+  "trustedDependencies": [
+    "sharp",
+    "unrs-resolver"
+  ]
+}

package/docs/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/docs/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/docs/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/docs/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/docs/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/docs/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/docs/source.config.ts

@@ -0,0 +1,11 @@
+import { defineDocs, defineConfig } from 'fumadocs-mdx/config';
+
+export const { docs, meta } = defineDocs({
+  dir: 'content/docs',
+});
+
+export default defineConfig({
+  mdxOptions: {
+    providerImportSource: '@/mdx-components',
+  },
+});

package/docs/src/app/api/search/route.ts

@@ -0,0 +1,4 @@
+import { createFromSource } from 'fumadocs-core/search/server'
+import { source } from '@/lib/source'
+
+export const { GET } = createFromSource(source)

package/docs/src/app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,53 @@
+import { DocsBody, DocsPage } from 'fumadocs-ui/layouts/docs/page'
+import type { Metadata } from 'next'
+import { notFound } from 'next/navigation'
+
+import { source } from '@/lib/source'
+
+interface PageProps {
+  params: Promise<{
+    slug?: string[]
+  }>
+}
+
+export async function generateStaticParams() {
+  return source.generateParams()
+}
+
+export async function generateMetadata(props: PageProps): Promise<Metadata> {
+  const params = await props.params
+  const page = source.getPage(params.slug)
+
+  if (!page) {
+    return {}
+  }
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+  }
+}
+
+export default async function Page(props: PageProps) {
+  const params = await props.params
+  const page = source.getPage(params.slug)
+
+  if (!page) {
+    notFound()
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const { body: MDX, toc } = page.data as any
+
+  return (
+    <DocsPage toc={toc}>
+      <h1 className="text-3xl font-bold mb-2">{page.data.title}</h1>
+      {page.data.description && (
+        <p className="text-lg text-muted-foreground mb-6">{page.data.description}</p>
+      )}
+      <DocsBody>
+        <MDX />
+      </DocsBody>
+    </DocsPage>
+  )
+}

package/docs/src/app/docs/layout.tsx

@@ -0,0 +1,21 @@
+import { DocsLayout } from 'fumadocs-ui/layouts/docs'
+import type { ReactNode } from 'react'
+
+import { baseOptions } from '@/app/layout.config'
+import { source } from '@/lib/source'
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <DocsLayout
+      tree={source.getPageTree()}
+      {...baseOptions}
+      sidebar={{
+        enabled: true,
+        prefetch: true,
+        tabs: false,
+      }}
+    >
+      {children}
+    </DocsLayout>
+  )
+}

package/docs/src/app/globals.css

@@ -0,0 +1,10 @@
+@import "tailwindcss";
+@import "fumadocs-ui/css/neutral.css";
+@import "fumadocs-ui/css/preset.css";
+
+@source "../../../node_modules/fumadocs-ui/dist/**/*.js";
+
+@theme inline {
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}

package/docs/src/app/layout.config.tsx

@@ -0,0 +1,7 @@
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared'
+
+export const baseOptions: BaseLayoutProps = {
+  nav: {
+    title: 'Agent Messenger',
+  },
+}

package/docs/src/app/layout.tsx

@@ -0,0 +1,35 @@
+import { RootProvider } from 'fumadocs-ui/provider/next'
+import type { Metadata } from 'next'
+import { Geist, Geist_Mono } from 'next/font/google'
+import './globals.css'
+
+const geistSans = Geist({
+  variable: '--font-geist-sans',
+  subsets: ['latin'],
+})
+
+const geistMono = Geist_Mono({
+  variable: '--font-geist-mono',
+  subsets: ['latin'],
+})
+
+export const metadata: Metadata = {
+  title: 'Agent Messenger',
+  description: 'Give your AI agent the power to read and send messages',
+}
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode
+}>) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased flex flex-col min-h-screen`}
+      >
+        <RootProvider>{children}</RootProvider>
+      </body>
+    </html>
+  )
+}