agentmesh-ai 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentHub Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,247 @@
+# AgentHub
+
+**Shared memory & conversation protocol for AI coding agents.**
+
+You use Claude Code. Your teammate uses Cursor. Another uses Copilot. Your AIs have no idea what each other is doing. AgentHub fixes that.
+
+```
+npx agenthub init && npx agenthub setup
+```
+
+That's it. Your AI now shares knowledge with every other AI on the team.
+
+---
+
+## What It Does
+
+**Shared Memory** — Each AI automatically records what it learns (APIs, decisions, gotchas). Every other AI can read it.
+
+**Real-time Discussion** — When AIs need to align on something, they open a conversation space and discuss. Humans only step in for final decisions.
+
+**Team Consensus** — Important decisions require all humans to vote. No single person can override the team.
+
+---
+
+## Quick Start
+
+### 1. Initialize (30 seconds)
+
+```bash
+npx agenthub init
+```
+
+Answers a few questions, creates `.agenthub/` in your project.
+
+### 2. Configure your AI tool (1 minute)
+
+```bash
+npx agenthub setup
+```
+
+Auto-detects Claude Code, Cursor, Windsurf and writes their MCP config.
+
+### 3. Invite teammates
+
+```
+"Clone the repo and run: npx agenthub setup"
+```
+
+No accounts, no servers, no extra software.
+
+### 4. Start coding
+
+Your AI now automatically:
+- Reads shared memory before starting work
+- Records important knowledge after completing work
+- Alerts you when there's a discussion or vote waiting
+
+---
+
+## How It Works
+
+### Shared Memory
+
+Each AI writes to its own file. No Git conflicts, ever.
+
+```
+.agenthub/
+├── hub.yaml                    # Project info + agent registry
+├── memory/
+│   ├── alice-claude-code.yaml  # Alice's AI writes here
+│   ├── bob-cursor.yaml         # Bob's AI writes here
+│   └── carol-copilot.yaml     # Carol's AI writes here
+└── conversations/              # Discussion logs
+```
+
+When any AI reads memory, it sees a merged view of everyone's knowledge:
+
+```
+## User Service API 🔒
+Agent: alice-claude-code (Backend Developer)
+Status: protected
+
+POST /api/users       → register
+POST /api/auth/login  → login, returns JWT
+GET  /api/users/:id   → get user info
+
+---
+
+## UI Design System 📋
+Agent: bob-cursor (Frontend Developer)
+Status: proposal
+
+shadcn/ui, Indigo primary, 8px radius, 4px spacing
+```
+
+### Three Levels of Knowledge
+
+| Status | Meaning | Icon |
+|--------|---------|------|
+| `auto` | Routine facts (APIs, models) — recorded automatically | (none) |
+| `proposal` | Important decision, needs team confirmation | 📋 |
+| `protected` | Team consensus — cannot be overridden | 🔒 |
+
+### Real-time Discussion
+
+When your AI needs to discuss something with the team:
+
+```bash
+# One person starts the conversation space
+npx agenthub serve
+```
+
+Then any team member can say: *"Discuss database selection with the team"*
+
+The AI handles multi-round discussion automatically — you only trigger it once.
+
+### Team Voting
+
+For important decisions, every human must approve:
+
+1. AI presents options via an interactive form
+2. Each team member's AI asks their human to vote
+3. **All approve** → decision becomes protected
+4. **Anyone rejects** → discussion restarts with feedback
+
+---
+
+## Works With Everything
+
+| Tool | Integration | Experience |
+|------|-------------|------------|
+| Claude Code | MCP (native) | Automatic read/write/discuss |
+| Cursor | MCP (native) | Automatic read/write/discuss |
+| Windsurf | MCP (native) | Automatic read/write/discuss |
+| GitHub Copilot | Instructions file | AI reads .agenthub/ on request |
+| Any AI tool | Plain files | Human tells AI to read .agenthub/ |
+
+AgentHub doesn't call any AI API. It's a pure protocol layer — each tool uses its own intelligence.
+
+---
+
+## Use Cases
+
+### Solo Developer (Solves AI Amnesia)
+
+Your AI forgets everything between sessions. With AgentHub, it reads `.agenthub/memory/` and instantly recovers context.
+
+### Team Collaboration (Zero Communication Overhead)
+
+Alice writes the backend. Bob clones the repo — his AI already knows every API, every data model, every convention Alice established.
+
+### Handover (Better Than Any Document)
+
+Alice leaves the project. Her AI's memory file contains every decision, every gotcha, every "don't change this because..." — automatically accumulated over months.
+
+### New Project (AI-First Planning)
+
+Three people start a new project. They open a conversation space, their AIs discuss tech stack, architecture, conventions. Conclusions become protected memories. Everyone starts coding in sync.
+
+---
+
+## Safety
+
+### Secret Scanner
+
+Before any knowledge is shared, AgentHub scans for:
+- API keys (OpenAI, AWS, GitHub, Stripe)
+- Passwords and tokens
+- Private keys
+- Database connection strings
+- Internal URLs
+
+High-risk content is **blocked**. Medium-risk gets a **warning**.
+
+### Human-in-the-Loop
+
+- Routine knowledge: AI records automatically
+- Important proposals: AI asks human first
+- Team constraints: requires unanimous vote
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `npx agenthub init` | Create .agenthub/ directory |
+| `npx agenthub setup` | Auto-configure MCP for your AI tools |
+| `npx agenthub serve` | Start conversation space |
+| `npx agenthub status` | Show project memory status |
+| `npx agenthub memory` | View/search shared memory |
+| `npx agenthub memory -s "database"` | Search for specific info |
+
+---
+
+## MCP Tools (for AI)
+
+| Tool | What It Does |
+|------|-------------|
+| `read_memory` | Read all shared knowledge |
+| `write_memory` | Record new knowledge |
+| `search_memory` | Search by keyword |
+| `discuss` | Multi-round team discussion |
+| `start_meeting` | Check attendance, start meeting |
+| `escalate_to_human` | Team-wide vote on decisions |
+| `vote_on_decision` | Cast vote on pending decision |
+| `send_message` | Send single message |
+| `get_messages` | Read messages on a topic |
+| `save_to_memory` | Save discussion conclusion |
+| `list_conversations` | See who's online, what's being discussed |
+| `list_pending_decisions` | See what needs voting |
+
+---
+
+## Architecture
+
+```
+.agenthub/ (files)          Conversation Space (WebSocket)
+     │                              │
+     │  Shared Memory               │  Real-time Discussion
+     │  (Git-synced YAML)           │  (Optional, ephemeral)
+     │                              │
+     ├── read/write locally         ├── discuss, vote, meet
+     ├── sync via Git               ├── auto-sync memory on join
+     └── works offline              └── results saved to files
+```
+
+- **Files are the source of truth** — server is just a sync layer
+- **Server down?** Memory still works. Only real-time discussion needs it.
+- **No AI API calls** — AgentHub is a pure protocol, not a model provider
+
+---
+
+## Protocol Specifications
+
+For tool builders and contributors:
+
+- [Memory Format](docs/spec/memory-format.md) — `.agenthub/` file structure
+- [MCP Tools](docs/spec/mcp-tools.md) — tool definitions and parameters
+- [Conversation Protocol](docs/spec/conversation-protocol.md) — WebSocket messages
+- [Decision Protocol](docs/spec/decision-protocol.md) — voting and consensus rules
+
+---
+
+## License
+
+MIT

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAaA,wBAAsB,WAAW,kBAwHhC"}

package/dist/cli/commands/init.js

@@ -0,0 +1,134 @@
+/**
+ * agenthub init — Initialize .agenthub/ in the current project.
+ */
+import { join } from 'node:path';
+import { mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { writeYaml } from '../../utils/yaml.js';
+import { isGitRepo } from '../../utils/git.js';
+import { generateAgentId } from '../../utils/id.js';
+export async function initCommand() {
+    const cwd = process.cwd();
+    const agentHubDir = join(cwd, '.agenthub');
+    // Check if already initialized
+    if (existsSync(agentHubDir)) {
+        console.log(chalk.yellow('⚠️  .agenthub/ already exists in this directory.'));
+        const { proceed } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'proceed',
+                message: 'Reinitialize?',
+                default: false,
+            }]);
+        if (!proceed)
+            return;
+    }
+    console.log('');
+    // Check for git
+    const hasGit = isGitRepo(cwd);
+    if (hasGit) {
+        console.log(chalk.dim('  Git repository detected ✓'));
+    }
+    else {
+        console.log(chalk.dim('  No Git repo detected (memory sync requires Git)'));
+    }
+    console.log('');
+    // Ask questions
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'project',
+            message: 'Project name?',
+            default: getDefaultProjectName(cwd),
+        },
+        {
+            type: 'input',
+            name: 'displayName',
+            message: 'Your name?',
+        },
+        {
+            type: 'list',
+            name: 'role',
+            message: 'Your role?',
+            choices: [
+                'Backend Developer',
+                'Frontend Developer',
+                'Full Stack Developer',
+                'Mobile Developer',
+                'DevOps / Infrastructure',
+                'Designer',
+                'Other',
+            ],
+        },
+        {
+            type: 'list',
+            name: 'tool',
+            message: 'Your AI coding tool?',
+            choices: [
+                { name: 'Claude Code', value: 'claude-code' },
+                { name: 'Cursor', value: 'cursor' },
+                { name: 'GitHub Copilot', value: 'copilot' },
+                { name: 'Windsurf', value: 'windsurf' },
+                { name: 'Codex', value: 'codex' },
+                { name: 'Other', value: 'other' },
+            ],
+        },
+    ]);
+    const agentId = generateAgentId(answers.displayName, answers.tool);
+    const now = new Date().toISOString();
+    // Create directories
+    await mkdir(join(agentHubDir, 'memory'), { recursive: true });
+    await mkdir(join(agentHubDir, 'conversations'), { recursive: true });
+    // Create hub.yaml
+    const hub = {
+        project: answers.project,
+        created: now,
+        version: '1.0',
+        agents: [{
+                id: agentId,
+                display_name: answers.displayName,
+                role: answers.role,
+                tool: answers.tool,
+            }],
+    };
+    await writeYaml(join(agentHubDir, 'hub.yaml'), hub);
+    // Create agent memory file (empty, ready to be written to)
+    const memoryFile = {
+        agent: agentId,
+        role: answers.role,
+        tool: answers.tool,
+        last_active: now,
+        entries: [],
+    };
+    await writeYaml(join(agentHubDir, 'memory', `${agentId}.yaml`), memoryFile);
+    // Output
+    console.log('');
+    console.log(chalk.green('✅ Created .agenthub/'));
+    console.log('');
+    console.log(chalk.dim('   .agenthub/'));
+    console.log(chalk.dim('   ├── hub.yaml'));
+    console.log(chalk.dim('   ├── memory/'));
+    console.log(chalk.dim(`   │   └── ${agentId}.yaml`));
+    console.log(chalk.dim('   └── conversations/'));
+    console.log('');
+    console.log(`   Your Agent ID: ${chalk.cyan(agentId)}`);
+    console.log('');
+    console.log(chalk.dim('   Next steps:'));
+    console.log(`   1. Run ${chalk.cyan('npx agenthub setup')} to configure your AI tool`);
+    if (hasGit) {
+        console.log(`   2. ${chalk.cyan('git add .agenthub/ && git commit')} to share with teammates`);
+        console.log(`   3. Tell your teammates: ${chalk.cyan('"clone and run npx agenthub setup"')}`);
+    }
+    console.log('');
+}
+function getDefaultProjectName(cwd) {
+    try {
+        const pkg = require(join(cwd, 'package.json'));
+        return pkg.name || cwd.split(/[\\/]/).pop() || 'my-project';
+    }
+    catch {
+        return cwd.split(/[\\/]/).pop() || 'my-project';
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

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

package/dist/cli/commands/memory.d.ts

@@ -0,0 +1,8 @@
+interface MemoryOptions {
+    search?: string;
+    agent?: string;
+    tags?: string;
+}
+export declare function memoryCommand(options: MemoryOptions): Promise<void>;
+export {};
+//# sourceMappingURL=memory.d.ts.map

package/dist/cli/commands/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory.ts"],"names":[],"mappings":"AASA,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,iBAgCzD"}

package/dist/cli/commands/memory.js

@@ -0,0 +1,40 @@
+/**
+ * agenthub memory — View or search shared memory.
+ */
+import chalk from 'chalk';
+import { findAgentHubDir } from '../../utils/git.js';
+import { readAllAgentMemories } from '../../memory/reader.js';
+import { searchMemories } from '../../memory/searcher.js';
+import { mergeMemories, formatMergedMemories } from '../../memory/merge-view.js';
+export async function memoryCommand(options) {
+    const cwd = process.cwd();
+    const agentHubDir = findAgentHubDir(cwd);
+    if (!agentHubDir) {
+        console.log(chalk.red('❌ No .agenthub/ found. Run "npx agenthub init" first.'));
+        return;
+    }
+    const memories = await readAllAgentMemories(agentHubDir);
+    if (memories.length === 0) {
+        console.log(chalk.dim('\n  No shared memories found yet.\n'));
+        return;
+    }
+    if (options.search) {
+        // Search mode
+        const results = searchMemories(memories, options.search);
+        if (results.length === 0) {
+            console.log(chalk.dim(`\n  No results for "${options.search}".\n`));
+        }
+        else {
+            console.log(`\n  Found ${results.length} result(s) for "${options.search}":\n`);
+            console.log(formatMergedMemories(results));
+        }
+    }
+    else {
+        // List mode with optional filters
+        const tags = options.tags?.split(',').map(t => t.trim());
+        const merged = mergeMemories(memories, { tags, agent: options.agent });
+        console.log('');
+        console.log(formatMergedMemories(merged));
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/cli/commands/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/cli/commands/memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAQjF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAEzC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC,CAAC;QAChF,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAEzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,cAAc;QACd,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,MAAM,mBAAmB,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,kCAAkC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/cli/commands/serve.d.ts

@@ -0,0 +1,8 @@
+interface ServeOptions {
+    port?: string;
+    host?: string;
+    key?: string;
+}
+export declare function serveCommand(options: ServeOptions): Promise<void>;
+export {};
+//# sourceMappingURL=serve.d.ts.map

package/dist/cli/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/serve.ts"],"names":[],"mappings":"AASA,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,iBAmFvD"}

package/dist/cli/commands/serve.js

@@ -0,0 +1,90 @@
+/**
+ * agenthub serve — Start the conversation space server.
+ */
+import chalk from 'chalk';
+import { ConversationServer } from '../../conversation/server.js';
+import { saveConversation } from '../../conversation/recorder.js';
+import { findAgentHubDir } from '../../utils/git.js';
+import { networkInterfaces } from 'node:os';
+export async function serveCommand(options) {
+    const cwd = process.cwd();
+    const agentHubDir = findAgentHubDir(cwd);
+    if (!agentHubDir) {
+        console.log(chalk.red('❌ No .agenthub/ found. Run "npx agenthub init" first.'));
+        return;
+    }
+    const port = parseInt(options.port ?? '4800', 10);
+    const host = options.host ?? '0.0.0.0';
+    const server = new ConversationServer({ port, host, key: options.key });
+    // Event handlers
+    server.onAgentJoined = (agent) => {
+        console.log(chalk.green(`  ✅ ${agent.displayName} (${agent.role}) joined`));
+    };
+    server.onAgentLeft = (agentId) => {
+        console.log(chalk.dim(`  ← ${agentId} left`));
+    };
+    server.onMessage = (msg) => {
+        console.log(chalk.dim(`  💬 [${msg.topic}] ${msg.from.displayName}: ${msg.content.slice(0, 80)}${msg.content.length > 80 ? '...' : ''}`));
+    };
+    server.onConclusion = (conclusion) => {
+        console.log(chalk.cyan(`  📋 Conclusion on "${conclusion.topic}": ${conclusion.summary.slice(0, 80)}...`));
+    };
+    try {
+        await server.start();
+    }
+    catch (err) {
+        console.log(chalk.red(`❌ Failed to start server: ${err.message}`));
+        return;
+    }
+    const lanIp = getLanIp();
+    console.log('');
+    console.log(chalk.green('  🚀 Conversation space is running'));
+    console.log('');
+    console.log(`  Local:   ${chalk.cyan(`ws://localhost:${port}`)}`);
+    if (lanIp) {
+        console.log(`  Network: ${chalk.cyan(`ws://${lanIp}:${port}`)}`);
+    }
+    console.log(`  Key:     ${chalk.cyan(server.key)}`);
+    console.log('');
+    console.log(chalk.dim('  Share with teammates:'));
+    console.log(chalk.dim(`  Set these env vars in their MCP config:`));
+    console.log(chalk.dim(`    AGENTHUB_SERVER_URL=ws://${lanIp ?? 'localhost'}:${port}`));
+    console.log(chalk.dim(`    AGENTHUB_SERVER_KEY=${server.key}`));
+    console.log('');
+    console.log(chalk.dim('  Press Ctrl+C to stop'));
+    console.log('');
+    // Handle graceful shutdown
+    const shutdown = async () => {
+        console.log('');
+        console.log(chalk.dim('  Shutting down...'));
+        // Save conversation logs
+        const messages = server.allMessages;
+        const conclusions = server.allConclusions;
+        if (messages.length > 0) {
+            const topics = [...new Set(messages.map(m => m.topic))];
+            for (const topic of topics) {
+                const topicMessages = messages.filter(m => m.topic === topic);
+                const topicConclusions = conclusions.filter(c => c.topic === topic);
+                const filePath = await saveConversation(agentHubDir, topic, topicMessages, topicConclusions);
+                console.log(chalk.dim(`  📝 Saved: ${filePath}`));
+            }
+        }
+        await server.stop();
+        console.log(chalk.dim('  Done.'));
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+function getLanIp() {
+    const interfaces = networkInterfaces();
+    for (const name of Object.keys(interfaces)) {
+        for (const iface of interfaces[name] ?? []) {
+            if (iface.family === 'IPv4' && !iface.internal) {
+                return iface.address;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=serve.js.map

package/dist/cli/commands/serve.js.map

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

package/dist/cli/commands/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function setupCommand(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAkBA,wBAAsB,YAAY,kBAqHjC"}