agent-messenger 1.0.0 → 1.2.0

package/dist/src/shared/utils/derived-key-cache.d.ts

@@ -0,0 +1,20 @@
+export type Platform = 'slack' | 'discord' | 'teams';
+/**
+ * Caches derived encryption keys to avoid repeated macOS Keychain prompts.
+ *
+ * The derived key (PBKDF2 output) is stored, NOT the keychain password.
+ * This is safe because:
+ * 1. The derived key can only decrypt app-specific local storage
+ * 2. It's stored with 600 permissions (owner read/write only)
+ * 3. If the app updates its encryption, cached key becomes invalid and we re-prompt once
+ */
+export declare class DerivedKeyCache {
+    private cacheDir;
+    constructor(cacheDir?: string);
+    private getKeyPath;
+    get(platform: Platform): Promise<Buffer | null>;
+    set(platform: Platform, key: Buffer): Promise<void>;
+    clear(platform: Platform): Promise<void>;
+    clearAll(): Promise<void>;
+}
+//# sourceMappingURL=derived-key-cache.d.ts.map

package/dist/src/shared/utils/derived-key-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived-key-cache.d.ts","sourceRoot":"","sources":["../../../../src/shared/utils/derived-key-cache.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;AAEpD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,QAAQ,CAAC,EAAE,MAAM;IAI7B,OAAO,CAAC,UAAU;IAIZ,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAe/C,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}

package/dist/src/shared/utils/derived-key-cache.js

@@ -0,0 +1,52 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Caches derived encryption keys to avoid repeated macOS Keychain prompts.
+ *
+ * The derived key (PBKDF2 output) is stored, NOT the keychain password.
+ * This is safe because:
+ * 1. The derived key can only decrypt app-specific local storage
+ * 2. It's stored with 600 permissions (owner read/write only)
+ * 3. If the app updates its encryption, cached key becomes invalid and we re-prompt once
+ */
+export class DerivedKeyCache {
+    cacheDir;
+    constructor(cacheDir) {
+        this.cacheDir = cacheDir ?? join(homedir(), '.config', 'agent-messenger', '.derived-keys');
+    }
+    getKeyPath(platform) {
+        return join(this.cacheDir, `${platform}.key`);
+    }
+    async get(platform) {
+        const keyPath = this.getKeyPath(platform);
+        if (!existsSync(keyPath)) {
+            return null;
+        }
+        try {
+            const content = await readFile(keyPath);
+            return content;
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(platform, key) {
+        await mkdir(this.cacheDir, { recursive: true, mode: 0o700 });
+        const keyPath = this.getKeyPath(platform);
+        await writeFile(keyPath, key, { mode: 0o600 });
+    }
+    async clear(platform) {
+        const keyPath = this.getKeyPath(platform);
+        if (existsSync(keyPath)) {
+            await rm(keyPath);
+        }
+    }
+    async clearAll() {
+        if (existsSync(this.cacheDir)) {
+            await rm(this.cacheDir, { recursive: true });
+        }
+    }
+}
+//# sourceMappingURL=derived-key-cache.js.map

package/dist/src/shared/utils/derived-key-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived-key-cache.js","sourceRoot":"","sources":["../../../../src/shared/utils/derived-key-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAQ;IAExB,YAAY,QAAiB;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAA;IAC5F,CAAC;IAEO,UAAU,CAAC,QAAkB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,MAAM,CAAC,CAAA;IAC/C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAkB;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QAEzC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAA;YACvC,OAAO,OAAO,CAAA;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAkB,EAAE,GAAW;QACvC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAE5D,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QACzC,MAAM,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAkB;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QAEzC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,OAAO,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;CACF"}

package/docs/README.md

@@ -0,0 +1,113 @@
+# Agent Messenger Documentation Website
+
+A modern documentation site for Agent Messenger built with [Next.js](https://nextjs.org), [Fumadocs](https://fumadocs.vercel.app/), and [Tailwind CSS](https://tailwindcss.com/).
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js 18+ or Bun
+- Bun package manager (recommended)
+
+### Installation
+
+```bash
+# Install dependencies
+bun install
+```
+
+### Development
+
+```bash
+# Start the development server
+bun run dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) in your browser to see the documentation site.
+
+The site includes:
+- **Landing page** with hero section, features, and quick start guide
+- **Documentation pages** with sidebar navigation
+- **Search functionality** for finding documentation
+- **Dark/light theme toggle** for user preference
+- **Mobile responsive design** for all devices
+- **SEO optimized** with meta tags and structured data
+
+### Building
+
+```bash
+# Build for production
+bun run build
+
+# Preview production build
+bun run start
+```
+
+### Code Quality
+
+```bash
+# Run linting and formatting checks
+bun run lint
+
+# Format code automatically
+bun run format
+```
+
+## Project Structure
+
+```
+src/
+├── app/
+│   ├── page.tsx              # Landing page
+│   ├── layout.tsx            # Root layout with theme provider
+│   ├── layout.config.tsx     # Navigation configuration
+│   ├── globals.css           # Global styles
+│   └── docs/
+│       ├── layout.tsx        # Docs layout with sidebar
+│       └── [[...slug]]/
+│           └── page.tsx      # Dynamic documentation pages
+├── lib/
+│   └── source.ts            # Fumadocs source configuration
+└── content/
+    └── docs/                # MDX documentation files
+```
+
+## Documentation
+
+Documentation pages are written in MDX format and located in `src/content/docs/`. Each page includes:
+- Front matter with title, description, and optional icon
+- Markdown content with syntax highlighting
+- Automatic table of contents generation
+
+### Adding New Documentation
+
+1. Create a new `.mdx` file in `src/content/docs/`
+2. Add front matter with title and description
+3. Write your content in Markdown
+4. The page will automatically appear in the sidebar navigation
+
+## Technologies
+
+- **Framework**: [Next.js 16](https://nextjs.org/) with App Router
+- **Documentation**: [Fumadocs](https://fumadocs.vercel.app/) for MDX support and search
+- **Styling**: [Tailwind CSS v4](https://tailwindcss.com/) with dark mode support
+- **Fonts**: [Geist](https://vercel.com/font) font family
+- **Linting**: [Biome](https://biomejs.dev/) for code quality
+- **Package Manager**: [Bun](https://bun.sh/)
+
+## Features
+
+- ✨ **Modern Design** - Clean, professional landing page with hero section
+- 🌙 **Dark Mode** - Built-in theme toggle with system preference detection
+- 🔍 **Search** - Full-text search across all documentation pages
+- 📱 **Responsive** - Mobile-first design that works on all devices
+- ♿ **Accessible** - WCAG compliant with proper ARIA labels
+- 🚀 **Fast** - Static site generation for optimal performance
+- 📊 **SEO** - Optimized meta tags and structured data
+
+## Resources
+
+- [Fumadocs Documentation](https://fumadocs.vercel.app/)
+- [Next.js Documentation](https://nextjs.org/docs)
+- [Tailwind CSS Documentation](https://tailwindcss.com/docs)
+- [MDX Documentation](https://mdxjs.com/)

package/docs/biome.json

@@ -0,0 +1,8 @@
+{
+  "extends": ["../biome.json"],
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  }
+}