@adamancyzhang/claude-orchestrator 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,401 @@
+# Claude Orchestrator
+
+<p align="center">
+  <strong>Turn Claude Code instances into a multi-agent swarm — coordinated through ZooKeeper.</strong>
+  <br/>
+  <em><a href="README_zh.md">中文文档</a></em>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@adamancyzhang/claude-orchestrator"><img src="https://img.shields.io/npm/v/@adamancyzhang/claude-orchestrator?color=blue" alt="npm"></a>
+  <a href="https://github.com/adamancyzhang/claude-orchestrator-server"><img src="https://img.shields.io/github/license/adamancyzhang/claude-orchestrator-server" alt="license"></a>
+  <a href="https://pypi.org/project/claude-mcp-server/"><img src="https://img.shields.io/pypi/v/claude-mcp-server?color=yellow" alt="PyPI"></a>
+  <img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="python">
+  <img src="https://img.shields.io/badge/ZooKeeper-3.8%2B-orange" alt="zookeeper">
+</p>
+
+---
+
+## What is this?
+
+**Claude Orchestrator** lets you run multiple Claude Code instances that talk to each other — assign tasks, send messages, share context, and collaborate on real work. Think of it as giving each Claude Code instance a walkie-talkie and a shared kanban board, then watching them build together.
+
+Behind the scenes, ZooKeeper acts as the coordination backbone: ephemeral nodes for instance heartbeat, sequential nodes for FIFO task ordering, and watches for real-time change notification.
+
+```
+┌──────────────────────────────────────────────────────────┐
+│                    Claude Orchestrator                    │
+│                   (MCP Server :3100)                      │
+│                                                          │
+│  ┌──────────────┐  ┌──────────┐  ┌──────────────┐       │
+│  │   Registry   │  │   Tasks   │  │   Messages   │       │
+│  │  who's here? │  │  FIFO Q   │  │  P2P + cast  │       │
+│  └──────┬───────┘  └────┬─────┘  └──────┬───────┘       │
+│         └────────────────┼──────────────┘                │
+│                   ┌──────┴──────┐                        │
+│                   │  ZooKeeper  │                        │
+│                   └──────┬──────┘                        │
+│                   ┌──────┴──────┐                        │
+│                   │   Context   │                        │
+│                   │   KV Store  │                        │
+│                   └─────────────┘                        │
+└──────────────────────────────────────────────────────────┘
+         ▲                    ▲                    ▲
+         │                    │                    │
+    ┌────┴────┐          ┌────┴────┐          ┌────┴────┐
+    │  Tom    │          │ Jerry   │          │  Bob    │
+    │Architect│          │Developer│          │ Tester  │
+    └─────────┘          └─────────┘          └─────────┘
+```
+
+---
+
+## Quick Start
+
+### 1. Install the CLI
+
+```bash
+# One command, all platforms
+npm install -g @adamancyzhang/claude-orchestrator
+```
+
+Post-install downloads the right native binary for your OS (macOS/Linux, arm64/x64). If no prebuilt binary matches, `scripts/build-binary.sh` builds one locally.
+
+### 2. Start ZooKeeper
+
+```bash
+docker-compose up -d
+```
+
+### 3. Start the MCP Server
+
+```bash
+# From source
+pip install -e ".[dev]"
+python -m src.server
+# → Server listening on http://127.0.0.1:3100
+```
+
+### 4. Configure Claude Code
+
+In your project's `.claude/mcp.json` (or `~/.claude/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "orchestrator": {
+      "type": "http",
+      "url": "http://127.0.0.1:3100/mcp"
+    }
+  }
+}
+```
+
+### 5. Register & Go
+
+Open Claude Code, then:
+
+```
+I have an MCP tool called orchestrator. Call register_instance
+with name="Tom" and role="architect". Remember my instance_id.
+```
+
+Now open another terminal, start a second Claude Code instance, and register Jerry as a developer. They'll discover each other, pass tasks, and collaborate.
+
+---
+
+## How It Works
+
+### Four Modules, One ZooKeeper
+
+| Module | What it does | ZK magic |
+|--------|-------------|----------|
+| **Instance Registry** | Register, heartbeat, discover | Ephemeral nodes → auto-cleanup on disconnect |
+| **Task Queue** | Push → Claim → Complete | Sequential nodes for FIFO, ephemeral claims for atomic locks |
+| **Message Router** | P2P messages, broadcast, help requests | Persistent-sequential nodes, poll-based retrieval |
+| **Context Store** | Shared key-value storage | Persistent nodes, cross-instance visibility |
+
+### The MCP Tools
+
+Each Claude Code instance calls these tools to participate in the swarm:
+
+| # | Tool | What it does |
+|---|------|-------------|
+| 1 | `register_instance` | Join the swarm with a name and role |
+| 2 | `heartbeat` | Stay alive, optionally report what you're working on |
+| 3 | `list_instances` | See who's online right now |
+| 4 | `push_task` | Create a task (optionally assign to someone specific) |
+| 5 | `claim_task` | Grab the next task — atomic, no two instances can claim the same one |
+| 6 | `complete_task` | Mark a task done with results |
+| 7 | `list_tasks` | View tasks by status (pending / claimed / completed) |
+| 8 | `send_message` | DM another instance or broadcast to everyone |
+| 9 | `poll_messages` | Check your inbox |
+| 10 | `request_help` | Broadcast a question to the whole team |
+| 11 | `set_context` | Write a shared key-value entry |
+| 12 | `get_context` | Read a shared key-value entry |
+
+### Or Use the CLI Directly
+
+If you prefer the terminal over Claude Code:
+
+```bash
+# Register
+claude-orchestrator register --name Alice --role developer
+
+# See who's around
+claude-orchestrator list-instances
+
+# Push a task
+claude-orchestrator push-task --title "Add rate limiting" --priority 0
+
+# Claim the next task
+claude-orchestrator claim-task
+
+# Send a message
+claude-orchestrator send-message --to <instance-id> --content "How's PR #42 going?"
+
+# Check inbox
+claude-orchestrator poll-messages
+
+# Share context
+claude-orchestrator set-context --key "api_version" --value "v2.1"
+
+# Read shared context
+claude-orchestrator get-context --key "api_version"
+
+# Health check
+claude-orchestrator status
+```
+
+All CLI commands return JSON. Every command supports `--zk-hosts` (or `ZK_HOSTS` env var) for pointing at a remote ZooKeeper.
+
+---
+
+## Example Session
+
+Here's a real flow with two instances — Tom (Architect) and Jerry (Developer):
+
+**Tom registers:**
+```json
+{ "id": "a1b2c3d4...", "name": "Tom", "role": "architect", "status": "idle" }
+```
+
+**Jerry registers:**
+```json
+{ "id": "f6e5d4c3...", "name": "Jerry", "role": "developer", "status": "idle" }
+```
+
+**Tom lists instances:**
+```
+2 active instances:
+  [architect] Tom (a1b2c3d4...) status=idle
+  [developer] Jerry (f6e5d4c3...) status=idle
+```
+
+**Tom assigns work:**
+```
+push_task:
+  title: "Implement POST /api/auth/login"
+  description: "Email+password login, return JWT. Handle validation and errors."
+  priority: HIGH (0)
+  assignee: f6e5d4c3... (Jerry)
+```
+
+**Jerry claims it:**
+```
+claim_task → Got it! task-0000000000
+heartbeat current_task="task-0000000000"
+```
+
+**Jerry gets stuck and asks for help:**
+```
+request_help:
+  question: "What should the JWT expiry be? Access vs refresh token?"
+  context: "FastAPI + python-jose, ~100K DAU"
+```
+
+**Tom checks messages and replies:**
+```
+poll_messages → 1 new message from Jerry
+send_message to=Jerry: "15min access, 7d refresh. Use Redis blacklist for logout."
+```
+
+**Tom records the decision:**
+```
+set_context key="jwt_strategy" value="access:15min, refresh:7d, blacklist:redis"
+```
+
+**Jerry finishes:**
+```
+complete_task task_id="task-0000000000" result="PR #42 — implemented login endpoint with tests"
+```
+
+No polling required for task claiming — the atomic claim mechanism means Jerry always gets the right task. Messages are delivered instantly via ZooKeeper's persistent-sequential nodes.
+
+---
+
+## ZooKeeper Schema
+
+```
+/claude-orchestrator
+├── instances/
+│   ├── a1b2c3d4...    [EPHEMERAL] Tom's registration
+│   └── f6e5d4c3...    [EPHEMERAL] Jerry's registration
+├── tasks/
+│   ├── pending/
+│   │   ├── task-0000000000    [PERSISTENT_SEQUENTIAL]
+│   │   └── task-0000000001    [PERSISTENT_SEQUENTIAL]
+│   ├── claimed/
+│   │   └── f6e5d4c3-task-0000000000  [EPHEMERAL] ← atomic lock!
+│   └── completed/
+│       └── task-0000000000    [PERSISTENT]
+├── messages/
+│   ├── a1b2c3d4.../
+│   │   └── msg-0000000000    [PERSISTENT_SEQUENTIAL]
+│   └── f6e5d4c3.../
+│       └── msg-0000000000    [PERSISTENT_SEQUENTIAL]
+└── context/
+    └── jwt_strategy          [PERSISTENT]
+```
+
+**Key insight:** Ephemeral nodes mean crashed instances auto-unregister. Ephemeral claim nodes mean abandoned tasks auto-release. No deadlocks, no orphans. ZooKeeper handles the lifecycle.
+
+---
+
+## Installation & Development
+
+### Prerequisites
+
+- Python 3.12+
+- Docker (for ZooKeeper)
+- Node.js 18+ (for the npm CLI wrapper)
+- Claude Code (for the MCP integration)
+
+### From Source
+
+```bash
+git clone https://github.com/adamancyzhang/claude-orchestrator-server.git
+cd claude-orchestrator-server
+
+# Install Python dependencies
+pip install -e ".[dev]"
+
+# Start ZooKeeper
+docker-compose up -d
+
+# Run the server
+python -m src.server
+
+# Or use the CLI directly
+claude-orchestrator status
+```
+
+### Build a Standalone Binary
+
+```bash
+bash scripts/build-binary.sh
+# Output: dist/claude-orchestrator-{platform}-{arch}
+```
+
+The binary is a single file with zero dependencies — Python, ZooKeeper client, and all libraries bundled via PyInstaller.
+
+### Run Tests
+
+```bash
+# End-to-end MCP verification (requires running server + ZK)
+python tests/verify_mvp.py
+```
+
+---
+
+## Skills for Claude Code
+
+The repo includes Claude Code skills that make the orchestrator even easier to use:
+
+| Skill | What it does |
+|-------|-------------|
+| `claude-orchestrator` | Full CLI reference — all 12 commands with examples |
+| `orchestrator-register` | Guided registration flow |
+| `orchestrator-status` | Dashboard: health, instances, tasks |
+| `orchestrator-communicate` | Message patterns: poll, DM, broadcast |
+| `orchestrator-help` | Help-request workflow |
+| `orchestrator-agent` | Autonomous agent loop: check → claim → work → complete |
+
+---
+
+## Why ZooKeeper?
+
+| Concern | ZooKeeper answer |
+|---------|-----------------|
+| Instance lifecycle | Ephemeral nodes → auto-cleanup. No heartbeat polling needed. |
+| Task ordering | Sequential nodes → guaranteed FIFO. No race conditions. |
+| Claim atomicity | `create(path, ephemeral=True)` is atomic at the ZK level. Only one winner. |
+| Change notification | Built-in watches → push, not poll. |
+| Dependencies | One dependency (ZK) vs. Redis + Postgres combination. |
+
+Zero external database. All state lives in ZooKeeper. For archival beyond ZK's data limits, a lightweight SQLite log is the recommended addition.
+
+---
+
+## Roles
+
+| Role | Value | Typical behavior |
+|------|-------|-----------------|
+| Architect | `architect` | Sets standards, designs tasks, reviews results |
+| Developer | `developer` | Claims tasks, writes code, submits PRs |
+| Tester | `tester` | Claims test tasks, E2E verification |
+| General | `general` | Any role |
+
+---
+
+## Configuration Reference
+
+| Config | Where | Default |
+|--------|-------|---------|
+| ZK hosts | `--zk-hosts` flag or `ZK_HOSTS` env | `127.0.0.1:2181` |
+| Instance ID | `--instance-id` flag or `~/.claude-orchestrator/config.json` | auto-saved after `register` |
+| MCP server host | `src/server.py` | `127.0.0.1:3100` |
+
+---
+
+## Project Structure
+
+```
+├── src/
+│   ├── server.py          # FastMCP server — 12 tools
+│   ├── cli.py             # Click CLI — 12 commands
+│   ├── zk_client.py       # ZooKeeper CRUD + reconnect
+│   ├── registry.py        # Instance registration + heartbeat
+│   ├── task_queue.py      # Push → Claim → Complete
+│   ├── message_router.py  # Send → Poll → Request Help
+│   ├── context_store.py   # Get → Set shared KV
+│   └── models.py          # Pydantic data models
+├── bin/
+│   └── claude-orchestrator     # npm CLI entry (Node.js shim)
+├── scripts/
+│   ├── install.js              # npm postinstall — download binary
+│   ├── build-binary.sh         # PyInstaller packager
+│   ├── start-zk.sh             # Docker ZK launcher
+│   ├── start-server.sh         # Server launcher
+│   └── stop-all.sh             # Tear down
+├── skills/                     # Claude Code skills
+├── tests/
+│   └── verify_mvp.py           # E2E MCP verification
+├── docs/
+│   ├── prd/                    # Full spec + architecture
+│   └── operations-guide.md     # Step-by-step walkthrough (Chinese)
+├── docker-compose.yml          # ZooKeeper
+└── package.json                # npm package definition
+```
+
+---
+
+## License
+
+MIT — use it, fork it, ship it.
+
+---
+
+<p align="center">
+  <sub>Built with Python, ZooKeeper, and the MCP protocol. Orchestrate responsibly.</sub>
+</p>

package/bin/claude-orchestrator

@@ -1,20 +1,5 @@
 #!/usr/bin/env node
-const { spawnSync } = require("child_process");
-const path = require("path");
-const fs = require("fs");
-
-const binary = path.join(__dirname, "orchestrator-binary");
-
-if (!fs.existsSync(binary)) {
-  console.error(`Error: orchestrator-binary not found at ${binary}`);
-  console.error(
-    "Run 'node scripts/install.js' to download it, or build with 'bash scripts/build-binary.sh'"
-  );
+import("../dist/index.js").catch((err) => {
+  console.error(err);
   process.exit(1);
-}
-
-const result = spawnSync(binary, process.argv.slice(2), {
-  stdio: "inherit",
 });
-
-process.exit(result.status ?? 1);

package/dist/cli/commands.d.ts

@@ -0,0 +1,20 @@
+export declare function cmdStatus(zkHosts: string): Promise<void>;
+export declare function cmdRegister(zkHosts: string, instanceId: string | undefined, name: string, role: string): Promise<void>;
+export declare function cmdHeartbeat(zkHosts: string, cliInstanceId: string | undefined, currentTask?: string): Promise<void>;
+export declare function cmdListInstances(zkHosts: string): Promise<void>;
+export declare function cmdPushTask(zkHosts: string, cliInstanceId: string | undefined, title: string, description: string, priority: number, assignee?: string): Promise<void>;
+export declare function cmdClaimTask(zkHosts: string, cliInstanceId: string | undefined): Promise<void>;
+export declare function cmdCompleteTask(zkHosts: string, cliInstanceId: string | undefined, taskId: string, result: string): Promise<void>;
+export declare function cmdListTasks(zkHosts: string, statusFilter?: string): Promise<void>;
+export declare function cmdSendMessage(zkHosts: string, cliInstanceId: string | undefined, content: string, toInstance?: string, broadcast?: boolean): Promise<void>;
+export declare function cmdPollMessages(zkHosts: string, cliInstanceId: string | undefined): Promise<void>;
+export declare function cmdWaitForMessage(zkHosts: string, cliInstanceId: string | undefined, timeout: number): Promise<void>;
+export declare function cmdDismissMessage(zkHosts: string, cliInstanceId: string | undefined, messageId: string): Promise<void>;
+export declare function cmdRequestHelp(zkHosts: string, cliInstanceId: string | undefined, question: string, ctx?: string): Promise<void>;
+export declare function cmdSetContext(zkHosts: string, cliInstanceId: string | undefined, key: string, value: string): Promise<void>;
+export declare function cmdGetContext(zkHosts: string, key: string): Promise<void>;
+export declare function cmdDeleteContext(zkHosts: string, key: string): Promise<void>;
+export declare function cmdListContextKeys(zkHosts: string): Promise<void>;
+export declare function cmdWatchContext(zkHosts: string, key: string): Promise<void>;
+export declare function cmdWatchTasks(zkHosts: string): Promise<void>;
+export declare function cmdUnregister(zkHosts: string, cliInstanceId: string | undefined): Promise<void>;

package/dist/cli/commands.js

@@ -0,0 +1,192 @@
+import { ZkClient } from "../zk/client.js";
+import { InstanceRegistry } from "../modules/registry.js";
+import { TaskQueue } from "../modules/task-queue.js";
+import { MessageRouter } from "../modules/message-router.js";
+import { ContextStore } from "../modules/context-store.js";
+import { resolveInstanceId, saveInstanceId } from "../config.js";
+import { output } from "../utils/output.js";
+async function withZk(hosts, fn) {
+    const zk = new ZkClient(hosts);
+    await zk.connect();
+    const registry = new InstanceRegistry(zk);
+    const taskQueue = new TaskQueue(zk);
+    const messageRouter = new MessageRouter(zk);
+    const contextStore = new ContextStore(zk);
+    try {
+        return await fn({ zk, registry, taskQueue, messageRouter, contextStore });
+    }
+    finally {
+        await zk.disconnect();
+    }
+}
+export async function cmdStatus(zkHosts) {
+    await withZk(zkHosts, async ({ zk, registry }) => {
+        const connected = zk.connected;
+        const instances = await registry.listAll();
+        output({
+            status: connected ? "healthy" : "degraded",
+            zookeeper: connected ? "connected" : "disconnected",
+            instances_online: instances.length,
+        });
+    });
+}
+export async function cmdRegister(zkHosts, instanceId, name, role) {
+    await withZk(zkHosts, async ({ registry }) => {
+        const instance = await registry.register(name, role, instanceId);
+        saveInstanceId(instance.id);
+        output(instance);
+    });
+}
+export async function cmdHeartbeat(zkHosts, cliInstanceId, currentTask) {
+    await withZk(zkHosts, async ({ registry }) => {
+        const instanceId = resolveInstanceId(cliInstanceId);
+        await registry.heartbeat(instanceId, currentTask);
+        output({ status: "ok", instance_id: instanceId });
+    });
+}
+export async function cmdListInstances(zkHosts) {
+    await withZk(zkHosts, async ({ registry }) => {
+        const instances = await registry.listAll();
+        output(instances);
+    });
+}
+export async function cmdPushTask(zkHosts, cliInstanceId, title, description, priority, assignee) {
+    await withZk(zkHosts, async ({ taskQueue }) => {
+        const instanceId = cliInstanceId ?? "";
+        const task = await taskQueue.push(title, description, priority, instanceId, assignee);
+        output(task);
+    });
+}
+export async function cmdClaimTask(zkHosts, cliInstanceId) {
+    await withZk(zkHosts, async ({ taskQueue }) => {
+        const instanceId = resolveInstanceId(cliInstanceId);
+        const task = await taskQueue.claim(instanceId);
+        if (!task) {
+            output({ status: "no_tasks", message: "No pending tasks available." });
+        }
+        else {
+            output(task);
+        }
+    });
+}
+export async function cmdCompleteTask(zkHosts, cliInstanceId, taskId, result) {
+    await withZk(zkHosts, async ({ taskQueue }) => {
+        const instanceId = resolveInstanceId(cliInstanceId);
+        const task = await taskQueue.complete(instanceId, taskId, result);
+        output(task);
+    });
+}
+export async function cmdListTasks(zkHosts, statusFilter) {
+    await withZk(zkHosts, async ({ taskQueue }) => {
+        const tasks = await taskQueue.listTasks(statusFilter);
+        output(tasks);
+    });
+}
+export async function cmdSendMessage(zkHosts, cliInstanceId, content, toInstance, broadcast = false) {
+    await withZk(zkHosts, async ({ registry, messageRouter }) => {
+        const instanceId = resolveInstanceId(cliInstanceId);
+        const inst = await registry.get(instanceId);
+        const fromName = inst?.name ?? instanceId.slice(0, 8);
+        const messages = await messageRouter.send(instanceId, fromName, content, toInstance, broadcast);
+        const targets = messages.map((m) => m.to_instance);
+        output({ sent_to: targets, message_count: targets.length });
+    });
+}
+export async function cmdPollMessages(zkHosts, cliInstanceId) {
+    await withZk(zkHosts, async ({ messageRouter }) => {
+        const instanceId = resolveInstanceId(cliInstanceId);
+        const messages = await messageRouter.poll(instanceId);
+        output(messages);
+    });
+}
+export async function cmdWaitForMessage(zkHosts, cliInstanceId, timeout) {
+    await withZk(zkHosts, async ({ messageRouter }) => {
+        const instanceId = resolveInstanceId(cliInstanceId);
+        const messages = await messageRouter.waitForMessage(instanceId, timeout);
+        output(messages.length > 0 ? messages : { status: "timeout", message: "No messages received." });
+    });
+}
+export async function cmdDismissMessage(zkHosts, cliInstanceId, messageId) {
+    await withZk(zkHosts, async ({ messageRouter }) => {
+        const instanceId = resolveInstanceId(cliInstanceId);
+        await messageRouter.dismissMessage(instanceId, messageId);
+        output({ status: "dismissed", message_id: messageId });
+    });
+}
+export async function cmdRequestHelp(zkHosts, cliInstanceId, question, ctx) {
+    await withZk(zkHosts, async ({ registry, messageRouter }) => {
+        const instanceId = resolveInstanceId(cliInstanceId);
+        const inst = await registry.get(instanceId);
+        const fromName = inst?.name ?? instanceId.slice(0, 8);
+        const messages = await messageRouter.requestHelp(instanceId, fromName, question, ctx);
+        const targets = messages.map((m) => m.to_instance);
+        output({ sent_to: targets, message_count: targets.length });
+    });
+}
+export async function cmdSetContext(zkHosts, cliInstanceId, key, value) {
+    await withZk(zkHosts, async ({ contextStore }) => {
+        const instanceId = cliInstanceId ?? "";
+        const entry = await contextStore.set(key, value, instanceId);
+        output(entry);
+    });
+}
+export async function cmdGetContext(zkHosts, key) {
+    await withZk(zkHosts, async ({ contextStore }) => {
+        const value = await contextStore.get(key);
+        if (value === null) {
+            output({ key, value: null, status: "not_found" });
+        }
+        else {
+            output({ key, value });
+        }
+    });
+}
+export async function cmdDeleteContext(zkHosts, key) {
+    await withZk(zkHosts, async ({ contextStore }) => {
+        await contextStore.delete(key);
+        output({ key, status: "deleted" });
+    });
+}
+export async function cmdListContextKeys(zkHosts) {
+    await withZk(zkHosts, async ({ contextStore }) => {
+        const keys = await contextStore.listKeys();
+        output({ keys, count: keys.length });
+    });
+}
+export async function cmdWatchContext(zkHosts, key) {
+    await withZk(zkHosts, async ({ zk }) => {
+        const value = await zk.watchContextKey(key, (newData) => {
+            output({ key, value: newData?.value ?? null, event: "changed" });
+            process.exit(0);
+        });
+        if (value === null) {
+            output({ key, value: null, message: `Watching key '${key}' for changes... (Ctrl+C to stop)` });
+        }
+        else {
+            output({ key, value: value.value, message: `Watching key '${key}' for changes... (Ctrl+C to stop)` });
+        }
+        // Keep process alive waiting for watch callback
+        await new Promise(() => { });
+    });
+}
+export async function cmdWatchTasks(zkHosts) {
+    await withZk(zkHosts, async ({ zk }) => {
+        const children = await zk.watchPendingTasks((newChildren) => {
+            output({ event: "tasks_changed", pending_count: newChildren.length, tasks: newChildren });
+            process.exit(0);
+        });
+        output({
+            pending_count: children.length,
+            message: "Watching for new tasks... (Ctrl+C to stop)",
+        });
+        await new Promise(() => { });
+    });
+}
+export async function cmdUnregister(zkHosts, cliInstanceId) {
+    await withZk(zkHosts, async ({ registry }) => {
+        const instanceId = resolveInstanceId(cliInstanceId);
+        await registry.unregister(instanceId);
+        output({ status: "unregistered", instance_id: instanceId });
+    });
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+export interface Config {
+    zkHosts: string;
+    port: number;
+    host: string;
+    instanceId?: string;
+    serverMode: boolean;
+}
+export declare function loadConfig(cliOpts: {
+    zookeeper?: string;
+    port?: string;
+    host?: string;
+    instanceId?: string;
+    server?: boolean;
+}): Config;
+export declare function saveInstanceId(instanceId: string): void;
+export declare function loadInstanceId(): string | null;
+export declare function resolveInstanceId(cliInstanceId?: string): string;