@rithamnatani/agentmux 1.5.39

package/README.md

@@ -0,0 +1,440 @@
+# AgentMux MCP
+
+[![npm version](https://img.shields.io/npm/v/@rithamnatani/agentmux)](https://www.npmjs.com/package/@rithamnatani/agentmux)
+[![Tests](https://img.shields.io/github/actions/workflow/status/rithamnatani/agentmux/tests.yml?branch=main&label=tests)](https://github.com/rithamnatani/agentmux/actions/workflows/tests.yml)
+[![Scan](https://img.shields.io/github/actions/workflow/status/rithamnatani/agentmux/scan.yml?branch=main&label=security%20scan)](https://github.com/rithamnatani/agentmux/actions/workflows/scan.yml)
+[![GitHub release](https://img.shields.io/github/v/release/rithamnatani/agentmux)](https://github.com/rithamnatani/agentmux/releases/latest)
+[![Node](https://img.shields.io/node/v/@rithamnatani/agentmux)](https://www.npmjs.com/package/@rithamnatani/agentmux)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+**An MCP server that lets Claude, Gemini, Codex, and OpenCode call each other as tools.**
+
+```
+Claude:   "Hey Gemini, what do you think about this code?"
+Gemini:   "It's mass. Let me ask Codex for a second opinion."
+Codex:    "You're both wrong. Here's the fix."
+OpenCode: "I checked with three providers. They all agree with Codex."
+```
+
+---
+
+## One-Line Install (macOS / Linux)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/rithamnatani/agentmux/main/install.sh | bash
+```
+
+Detects which AI CLIs you have installed and configures AgentMux for them automatically.
+
+- Claude Code is configured to use a per-user local HTTP service on `127.0.0.1`
+- Gemini CLI, Codex CLI, and OpenCode keep using stdio/local config by default
+- The installer may update client config files on your behalf
+
+---
+
+## What It Does
+
+AgentMux sits between your AI clients and bridges them via the [Model Context Protocol](https://modelcontextprotocol.io/). Install it once, and whichever AI you're talking to gains the ability to call the others.
+
+- **Claude** can ask Gemini, Codex, OpenCode, or Cursor Agent for help
+- **Gemini** can delegate to Claude, Codex, OpenCode, or Cursor Agent
+- **Codex** can consult Claude, Gemini, OpenCode, or Cursor Agent
+- **OpenCode** can call Claude, Gemini, Codex, or Cursor Agent (across 75+ providers)
+- **Cursor** (via MCP) can call the other CLIs; Ask-Cursor is hidden there so the router never delegates back into the same host
+- Each client's own tools are hidden (no talking to yourself, that's weird)
+- Auto-detects which CLIs you have installed — only shows what's available
+
+---
+
+## Why AgentMux Exists
+
+AgentMux is a hard fork focused on using the AI subscriptions you already pay for as one coordinated coding system.
+
+Many developers have access to several capable CLIs at once: ChatGPT/Codex, Gemini, Claude, OpenCode provider accounts, Cursor, Copilot, or student plans. Switching between them by hand is slow and lossy. AgentMux lets one host act as the orchestrator while the other CLIs become callable subagents with isolated worktrees, recoverable run records, and tiered routing.
+
+The stdio install paths use `@latest`, so those clients pick up new releases automatically. Claude Code's managed HTTP service intentionally runs from a stable installed runtime instead of a transient `npx` cache; rerun the installer or `agentmux service refresh --configure-claude` after upgrading.
+
+The default tiers are intentionally only a starting point. Real setups differ by subscription, quota, client support, local credentials, and model availability, so the router can be overridden with a local JSON config.
+
+---
+
+## Prerequisites
+
+You need **Node.js >= 20** and at least **one** of these CLIs installed:
+
+| CLI | Install |
+|-----|---------|
+| [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) | `npm install -g @anthropic-ai/claude-code` |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` |
+| [Codex CLI](https://github.com/openai/codex) | `npm install -g @openai/codex` |
+| [OpenCode](https://opencode.ai) | `curl -fsSL https://opencode.ai/install | bash` |
+
+> AgentMux is most useful with two or more CLIs installed. With only one, the install still works, but there may be nothing to bridge yet.
+
+---
+
+## Manual Installation
+
+Prefer to install per-client yourself? Each command is one line.
+
+### Claude Code
+
+Recommended for Claude Code stability:
+
+```bash
+npm install -g @rithamnatani/agentmux
+agentmux service install --configure-claude
+```
+
+This installs a per-user background service that listens only on `127.0.0.1`, configures Claude Code to use AgentMux over HTTP, and keeps the underlying server alive even if Claude drops a stdio subprocess.
+
+The managed service installs as a per-user login/background service:
+
+- macOS: `launchd` LaunchAgent
+- Ubuntu/Debian: `systemd --user`
+- Windows: Scheduled Task at user logon
+
+Security model:
+
+- Listens only on `127.0.0.1`
+- Uses `Authorization: Bearer <token>` for every HTTP MCP request
+- Stores generated service artifacts in a user-owned service directory
+
+Operational notes:
+
+- `agentmux service install` refuses transient `npx` runtimes; use a global install or a stable local checkout
+- Generated service state includes an env file you can edit if your local AI CLIs require additional credentials or PATH entries
+- On Linux, the default `systemd --user` service follows your login session; enable `linger` yourself only if you intentionally want it to stay up after logout
+
+Legacy stdio installation is still available:
+
+```bash
+claude mcp add --scope user AgentMux -- npx -y @rithamnatani/agentmux@latest
+```
+
+<details>
+<summary>Claude Desktop (JSON config)</summary>
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS:
+
+```json
+{
+  "mcpServers": {
+    "AgentMux": {
+      "command": "npx",
+      "args": ["-y", "@rithamnatani/agentmux@latest"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop completely after saving.
+</details>
+
+---
+
+### Gemini CLI
+
+```bash
+gemini mcp add --scope user AgentMux npx -y @rithamnatani/agentmux@latest
+```
+
+<details>
+<summary>Manual config (~/.gemini/settings.json)</summary>
+
+```json
+{
+  "mcpServers": {
+    "AgentMux": {
+      "command": "npx",
+      "args": ["-y", "@rithamnatani/agentmux@latest"]
+    }
+  }
+}
+```
+</details>
+
+---
+
+### Codex CLI
+
+```bash
+codex mcp add AgentMux -- npx -y @rithamnatani/agentmux@latest
+```
+
+<details>
+<summary>Manual config (~/.codex/config.toml) or pass --mcp-config</summary>
+
+```bash
+codex --mcp-config mcp.json
+```
+
+Where `mcp.json` contains:
+
+```json
+{
+  "mcpServers": {
+    "AgentMux": {
+      "command": "npx",
+      "args": ["-y", "@rithamnatani/agentmux@latest"]
+    }
+  }
+}
+```
+</details>
+
+---
+
+### Cursor
+
+Use [Cursor MCP](https://cursor.com/docs/mcp) with a stdio server entry in **`~/.cursor/mcp.json`** (Linux/WSL global), **`%USERPROFILE%\.cursor\mcp.json`** (Windows global), or **`.cursor/mcp.json`** (project).
+
+**Local checkout** (this repo only; runs the code you just built—`${workspaceFolder}` is the opened project root):
+
+```json
+{
+  "mcpServers": {
+    "AgentMux": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["${workspaceFolder}/dist/index.js"]
+    }
+  }
+}
+```
+
+Run `npm run build` whenever you change TypeScript so `dist/index.js` stays in sync. This repo’s [`.cursor/mcp.json`](.cursor/mcp.json) points at a **local** `dist` build.
+
+**Windows Cursor (desktop app) + repo only in WSL:** you do **not** need to copy the tree onto NTFS for MCP to work. Put this in **`%USERPROFILE%\.cursor\mcp.json`** (for example `C:\Users\Admin\.cursor\mcp.json`) so the server starts inside WSL against your Linux checkout:
+
+```json
+{
+  "mcpServers": {
+    "AgentMux": {
+      "type": "stdio",
+      "command": "wsl.exe",
+      "args": ["-e", "node", "/home/rthm/dev/agentmux/dist/index.js"]
+    }
+  }
+}
+```
+
+Default WSL distro must have Node 20+, your CLIs, and a built `dist/` at that path (`wsl -e` runs non-interactively in the default distro).
+
+**Your own npm package (optional):** yes, the normal toolchain is `npm login`, change `"name"` in `package.json` to a scope you own (e.g. `@yourname/agentmux`), then `npm publish` from a clean `npm run build`. Cursor can then use `"command": "npx", "args": ["-y", "@yourname/agentmux@latest"]` on any machine without a git checkout. Publishing requires npm credentials; nothing here can log in for you.
+
+Node.js 20+ must be on your `PATH`. Install at least one other CLI (Gemini, Codex, OpenCode, Claude, …) so AgentMux registers bridge tools. When the MCP session is hosted by Cursor, **Ask-Cursor** is omitted from the tool list and the smart router skips Cursor-backed candidates so the agent does not spawn a nested Cursor run against itself.
+
+**Long-running tools (Ask-*, smart router tiers):** Cursor often enforces a short wait on plain `tools/call`. For the Cursor MCP client, AgentMux **automatically uses MCP task execution** (same as an explicit task request) so work continues in the background and the UI polls for completion instead of hitting that wall. Other hosts are unchanged unless you set `AGENTMUX_AUTO_TASK_CLIENTS` to a comma-separated list of `clientInfo.name` values (use `all` to opt every client in).
+
+**WSL vs Windows:** If the Cursor app runs on Windows but your CLIs live in WSL, the MCP subprocess must still reach `node`/`npx` and those binaries—point `command`/`args` at WSL (for example `wsl.exe` plus your Linux command) or open the folder as a [WSL remote workspace](https://cursor.com/docs) so stdio runs in Linux.
+
+**Router tiers:** AgentMux ships with default `Ask-Trivial`, `Ask-Low`, `Ask-Medium`, `Ask-High`, `Ask-Crucial`, and huge-context tiers, but those defaults are not meant to be universal. Set `AGENTMUX_ROUTER_CONFIG` to a JSON file to override any tier with the models and CLIs available in your own subscriptions.
+
+```json
+{
+  "medium": [
+    {
+      "label": "My OpenCode medium model",
+      "toolName": "Ask-OpenCode",
+      "backend": "opencode",
+      "model": "provider/model-name",
+      "extraArgs": { "variant": "xhigh" }
+    },
+    {
+      "label": "Gemini fallback",
+      "toolName": "Ask-Gemini",
+      "backend": "gemini",
+      "model": "gemini-3.1-pro-preview"
+    }
+  ]
+}
+```
+
+---
+
+### OpenCode
+
+OpenCode's `mcp add` command is interactive, so add AgentMux to `~/.config/opencode/opencode.json` directly:
+
+```json
+{
+  "mcp": {
+    "AgentMux": {
+      "type": "local",
+      "command": ["npx", "-y", "@rithamnatani/agentmux@latest"]
+    }
+  }
+}
+```
+
+If the file already exists, merge the `"AgentMux"` entry into the existing `"mcp"` object.
+
+---
+
+### Any Other MCP Client
+
+AgentMux supports both stdio and Streamable HTTP.
+
+For stdio-capable clients, point them at:
+
+```
+npx -y @rithamnatani/agentmux@latest
+```
+
+For a managed local HTTP service, install AgentMux globally and run:
+
+```bash
+agentmux service install
+```
+
+The service listens on `127.0.0.1` only and exposes `/mcp` plus `/health`.
+
+---
+
+## Available Tools
+
+Once connected, your AI client gains access to tools for the *other* CLIs (never its own):
+
+| Tool | Description |
+|------|-------------|
+| `List-Gemini-Models` | List available Gemini models and their strengths |
+| `Ask-Gemini` | Ask-Gemini a question or give it a task |
+| `Fetch-Chunk` | Retrieve chunked responses from Gemini |
+| `Gemini-Help` | Get Gemini CLI help info |
+| `List-Codex-Models` | List available Codex models |
+| `Ask-Codex` | Ask-Codex a question or give it a task |
+| `Codex-Help` | Get Codex CLI help info |
+| `List-Claude-Models` | List available Claude models |
+| `Ask-Claude` | Ask-Claude a question or give it a task |
+| `Claude-Help` | Get Claude Code CLI help info |
+| `List-OpenCode-Models` | List available OpenCode models from all configured providers |
+| `Ask-OpenCode` | Ask-OpenCode a question or give it a task |
+| `OpenCode-Help` | Get OpenCode CLI help info |
+
+---
+
+## Task-Capable Ask Tools
+
+The `Ask-*` tools still work as normal synchronous MCP tools, but they now also advertise optional task-based execution for MCP clients that support tasks.
+
+- Task-capable clients can run long `Ask-*` calls using MCP tasks to avoid long blocking tool requests
+- Older clients keep using the same `Ask-*` tools synchronously with no config changes
+- `List-*`, `*-Help`, and `Fetch-Chunk` remain normal synchronous tools
+
+---
+
+## Usage Examples
+
+Once installed, just talk naturally to your AI:
+
+```
+"Ask-Gemini what it thinks about this architecture"
+"Have Codex review this function for performance issues"
+"Get Claude's opinion on this error message"
+"Use OpenCode to get a second opinion from Llama"
+```
+
+Or get a second opinion on anything:
+
+```
+"I want three perspectives on how to refactor this module —
+ ask Gemini and Codex what they'd do differently"
+```
+
+---
+
+## How It Works
+
+```
+┌─────────────┐     MCP (stdio)      ┌──────────────┐     CLI calls    ┌─────────────┐
+│  Your AI    │ ◄──────────────────► │  AgentMux   │ ───────────────► │ Other AIs   │
+│  Client     │                      │   server     │                  │ (CLI tools) │
+└─────────────┘                      └──────────────┘                  └─────────────┘
+
+1. Your AI client connects to AgentMux via MCP
+2. AgentMux detects which CLIs are installed on your system
+3. It registers tools for the OTHER clients (hides tools for the calling client)
+4. When a tool is called, AgentMux executes the corresponding CLI command
+5. Results flow back through MCP to your AI client
+```
+
+For Claude Code, AgentMux can also run as a local background HTTP service:
+
+```
+┌─────────────┐     MCP (HTTP)       ┌──────────────┐     CLI calls    ┌─────────────┐
+│ Claude Code │ ◄──────────────────► │  AgentMux   │ ───────────────► │ Other AIs   │
+│   Client    │    127.0.0.1 only    │   service    │                  │ (CLI tools) │
+└─────────────┘                      └──────────────┘                  └─────────────┘
+```
+
+---
+
+## Troubleshooting
+
+**"No usable AI CLIs detected"**
+Make sure at least one other CLI is installed and on your PATH:
+```bash
+which gemini && which codex && which claude && which opencode
+```
+
+**No tools showing up?**
+If only your own CLI is installed, AgentMux hides it (no self-calls). Install a *different* CLI to enable cross-model collaboration.
+
+**MCP server not responding?**
+1. Check that Node.js >= 20 is installed
+2. Run `npx -y @rithamnatani/agentmux@latest` directly to see if the stdio server starts
+3. Restart your AI client completely
+
+**Claude Code disconnecting after successful calls?**
+Use the managed background service instead of the legacy stdio integration:
+
+```bash
+npm install -g @rithamnatani/agentmux
+agentmux service install --configure-claude
+agentmux service doctor
+```
+
+Helpful service commands:
+
+- `agentmux service status`
+- `agentmux service doctor`
+- `agentmux service logs`
+- `agentmux service refresh`
+- `agentmux service uninstall`
+
+**Need to tune timeouts or cleanup behavior?**
+AgentMux supports these optional environment variables:
+
+- `AGENTMUX_TRANSPORT` (`stdio` or `http`)
+- `AGENTMUX_ASK_TIMEOUT_MS`
+- `AGENTMUX_HELP_TIMEOUT_MS`
+- `AGENTMUX_CLI_DETECT_TIMEOUT_MS`
+- `AGENTMUX_KILL_GRACE_MS`
+- `AGENTMUX_HTTP_HOST` (defaults to `127.0.0.1`)
+- `AGENTMUX_HTTP_PORT` (defaults to `37420`)
+- `AGENTMUX_HTTP_PATH` (defaults to `/mcp`)
+- `AGENTMUX_HTTP_AUTH_TOKEN` (required for direct HTTP mode)
+- `AGENTMUX_HTTP_SESSION_IDLE_MS`
+- `AGENTMUX_LOG_PATH` (defaults to `~/.agentmux/logs/agentmux.log`)
+- `AGENTMUX_LOG_LEVEL` (`error`, `info`, or `debug`; defaults to `debug` for the file log)
+- `AGENTMUX_STDERR_LOG_LEVEL` (`silent`, `error`, `info`, or `debug`; defaults to `error`)
+- `AGENTMUX_SERVICE_ROOT_DIR`
+- `AGENTMUX_SERVICE_LOG_PATH`
+- `AGENTMUX_SERVICE_ENV_PATH`
+- `AGENTMUX_SERVICE_MANIFEST_PATH`
+- `AGENTMUX_ROUTER_CONFIG` (JSON file overriding router tier candidates)
+
+The server writes structured JSON-line logs to a single file destination, rotates them automatically for long-running service mode, and includes full prompt bodies for `Ask-*` requests so disconnects and crashes can be reconstructed after the fact.
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/rithamnatani/agentmux.git
+cd agentmux
+npm install
+npm run build
+npm run dev
+```

package/dist/clientFilter.d.ts

@@ -0,0 +1,5 @@
+import { UnifiedTool } from './tools/registry.js';
+export declare function getExcludedCategory(clientName: string | undefined): UnifiedTool['category'] | undefined;
+export declare function filterToolsForClient(tools: UnifiedTool[], clientName: string | undefined): UnifiedTool[];
+export declare function isToolBlockedForClient(tool: UnifiedTool | undefined, clientName: string | undefined): boolean;
+//# sourceMappingURL=clientFilter.d.ts.map

package/dist/clientFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientFilter.d.ts","sourceRoot":"","sources":["../src/clientFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiBlD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,SAAS,CAGvG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,EAAE,CAKxG;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI7G"}

package/dist/clientFilter.js

@@ -0,0 +1,31 @@
+/**
+ * Client-based tool filtering: hide a client's own tools
+ * (no point asking yourself for a second opinion).
+ */
+const CLIENT_EXCLUSIONS = {
+    'claude-code': 'claude',
+    'codex-mcp-client': 'codex',
+    'gemini-cli-mcp-client': 'gemini',
+    'opencode': 'opencode',
+    /** Cursor Agent MCP (`clientInfo.name` from initialize). */
+    'Cursor': 'cursor',
+    'cursor': 'cursor',
+};
+export function getExcludedCategory(clientName) {
+    if (!clientName)
+        return undefined;
+    return CLIENT_EXCLUSIONS[clientName] ?? CLIENT_EXCLUSIONS[clientName.toLowerCase()];
+}
+export function filterToolsForClient(tools, clientName) {
+    const excluded = getExcludedCategory(clientName);
+    if (!excluded)
+        return tools;
+    return tools.filter(t => t.category !== excluded);
+}
+export function isToolBlockedForClient(tool, clientName) {
+    if (!tool)
+        return false;
+    const excluded = getExcludedCategory(clientName);
+    return excluded !== undefined && tool.category === excluded;
+}
+//# sourceMappingURL=clientFilter.js.map

package/dist/clientFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientFilter.js","sourceRoot":"","sources":["../src/clientFilter.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,MAAM,iBAAiB,GAA4C;IACjE,aAAa,EAAa,QAAQ;IAClC,kBAAkB,EAAQ,OAAO;IACjC,uBAAuB,EAAG,QAAQ;IAClC,UAAU,EAAgB,UAAU;IACpC,4DAA4D;IAC5D,QAAQ,EAAkB,QAAQ;IAClC,QAAQ,EAAkB,QAAQ;CACnC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,UAA8B;IAChE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,iBAAiB,CAAC,UAAU,CAAC,IAAI,iBAAiB,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAoB,EAAE,UAA8B;IACvF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAA6B,EAAE,UAA8B;IAClG,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACjD,OAAO,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC;AAC9D,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,28 @@
+export type MultiCliLogLevel = 'error' | 'info' | 'debug';
+export type MultiCliStderrLogLevel = MultiCliLogLevel | 'silent';
+export type MultiCliTransport = 'stdio' | 'http';
+export interface MultiCliConfig {
+    transport: MultiCliTransport;
+    askTimeoutMs: number;
+    helpTimeoutMs: number;
+    cliDetectTimeoutMs: number;
+    killGraceMs: number;
+    taskTtlMs: number;
+    taskPollIntervalMs: number;
+    progressIdleHeartbeatMs: number;
+    progressThrottleMs: number;
+    httpHost: string;
+    httpPort: number;
+    httpPath: string;
+    httpAuthToken?: string;
+    httpSessionIdleMs: number;
+    logPath: string;
+    logLevel: MultiCliLogLevel;
+    stderrLogLevel: MultiCliStderrLogLevel;
+    serviceRootDir: string;
+    serviceLogPath: string;
+    serviceEnvPath: string;
+    serviceManifestPath: string;
+}
+export declare function loadConfig(env?: NodeJS.ProcessEnv): MultiCliConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAC1D,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;AAsBjD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,cAAc,EAAE,sBAAsB,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAmGD,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,cAAc,CAkD/E"}

package/dist/config.js

@@ -0,0 +1,112 @@
+import os from 'node:os';
+import path from 'node:path';
+function getDefaultServiceRootDir(platform = process.platform, env = process.env) {
+    switch (platform) {
+        case 'darwin':
+            return path.join(os.homedir(), 'Library', 'Application Support', 'AgentMux');
+        case 'win32':
+            return path.join(env.LOCALAPPDATA ?? path.join(os.homedir(), 'AppData', 'Local'), 'AgentMux');
+        default:
+            return path.join(env.XDG_CONFIG_HOME ?? path.join(os.homedir(), '.config'), 'agentmux');
+    }
+}
+const DEFAULTS = {
+    transport: 'stdio',
+    askTimeoutMs: 15 * 60 * 1000,
+    helpTimeoutMs: 30 * 1000,
+    cliDetectTimeoutMs: 5 * 1000,
+    killGraceMs: 5 * 1000,
+    taskTtlMs: 60 * 60 * 1000,
+    taskPollIntervalMs: 1000,
+    progressIdleHeartbeatMs: 10 * 1000,
+    progressThrottleMs: 1000,
+    httpHost: '127.0.0.1',
+    httpPort: 37420,
+    httpPath: '/mcp',
+    httpAuthToken: undefined,
+    httpSessionIdleMs: 30 * 60 * 1000,
+    logPath: path.join(os.homedir(), '.agentmux', 'logs', 'agentmux.log'),
+    logLevel: 'debug',
+    stderrLogLevel: 'error',
+    serviceRootDir: getDefaultServiceRootDir(),
+    serviceLogPath: path.join(getDefaultServiceRootDir(), 'logs', 'service.log'),
+    serviceEnvPath: path.join(getDefaultServiceRootDir(), 'env'),
+    serviceManifestPath: path.join(getDefaultServiceRootDir(), 'manifest.json'),
+};
+function parsePositiveInt(value, fallback) {
+    if (!value)
+        return fallback;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return fallback;
+    }
+    return parsed;
+}
+function parseLogLevel(value, fallback) {
+    switch (value) {
+        case 'error':
+        case 'info':
+        case 'debug':
+            return value;
+        default:
+            return fallback;
+    }
+}
+function parseTransport(value, fallback) {
+    switch (value) {
+        case 'stdio':
+        case 'http':
+            return value;
+        default:
+            return fallback;
+    }
+}
+function parseStderrLogLevel(value, fallback) {
+    switch (value) {
+        case 'error':
+        case 'info':
+        case 'debug':
+        case 'silent':
+            return value;
+        default:
+            return fallback;
+    }
+}
+function parseString(value, fallback) {
+    if (!value) {
+        return fallback;
+    }
+    const trimmed = value.trim();
+    return trimmed || fallback;
+}
+function normalizeHttpPath(value, fallback) {
+    const parsed = parseString(value, fallback);
+    return parsed.startsWith('/') ? parsed : `/${parsed}`;
+}
+export function loadConfig(env = process.env) {
+    const serviceRootDir = parseString(env.AGENTMUX_SERVICE_ROOT_DIR, DEFAULTS.serviceRootDir);
+    return {
+        transport: parseTransport(env.AGENTMUX_TRANSPORT, DEFAULTS.transport),
+        askTimeoutMs: parsePositiveInt(env.AGENTMUX_ASK_TIMEOUT_MS, DEFAULTS.askTimeoutMs),
+        helpTimeoutMs: parsePositiveInt(env.AGENTMUX_HELP_TIMEOUT_MS, DEFAULTS.helpTimeoutMs),
+        cliDetectTimeoutMs: parsePositiveInt(env.AGENTMUX_CLI_DETECT_TIMEOUT_MS, DEFAULTS.cliDetectTimeoutMs),
+        killGraceMs: parsePositiveInt(env.AGENTMUX_KILL_GRACE_MS, DEFAULTS.killGraceMs),
+        taskTtlMs: parsePositiveInt(env.AGENTMUX_TASK_TTL_MS, DEFAULTS.taskTtlMs),
+        taskPollIntervalMs: parsePositiveInt(env.AGENTMUX_TASK_POLL_INTERVAL_MS, DEFAULTS.taskPollIntervalMs),
+        progressIdleHeartbeatMs: parsePositiveInt(env.AGENTMUX_PROGRESS_IDLE_HEARTBEAT_MS, DEFAULTS.progressIdleHeartbeatMs),
+        progressThrottleMs: parsePositiveInt(env.AGENTMUX_PROGRESS_THROTTLE_MS, DEFAULTS.progressThrottleMs),
+        httpHost: parseString(env.AGENTMUX_HTTP_HOST, DEFAULTS.httpHost),
+        httpPort: parsePositiveInt(env.AGENTMUX_HTTP_PORT, DEFAULTS.httpPort),
+        httpPath: normalizeHttpPath(env.AGENTMUX_HTTP_PATH, DEFAULTS.httpPath),
+        httpAuthToken: env.AGENTMUX_HTTP_AUTH_TOKEN?.trim() || DEFAULTS.httpAuthToken,
+        httpSessionIdleMs: parsePositiveInt(env.AGENTMUX_HTTP_SESSION_IDLE_MS, DEFAULTS.httpSessionIdleMs),
+        logPath: parseString(env.AGENTMUX_LOG_PATH, DEFAULTS.logPath),
+        logLevel: parseLogLevel(env.AGENTMUX_LOG_LEVEL, DEFAULTS.logLevel),
+        stderrLogLevel: parseStderrLogLevel(env.AGENTMUX_STDERR_LOG_LEVEL, DEFAULTS.stderrLogLevel),
+        serviceRootDir,
+        serviceLogPath: parseString(env.AGENTMUX_SERVICE_LOG_PATH, path.join(serviceRootDir, 'logs', 'service.log')),
+        serviceEnvPath: parseString(env.AGENTMUX_SERVICE_ENV_PATH, path.join(serviceRootDir, 'env')),
+        serviceManifestPath: parseString(env.AGENTMUX_SERVICE_MANIFEST_PATH ?? env.AGENTMUX_SERVICE_RUNTIME_PATH, path.join(serviceRootDir, 'manifest.json')),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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