@multiplayer-app/cli 2.0.0 → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Multiplayer Software, Inc.
+
+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

@@ -1,77 +1,104 @@
 # @multiplayer-app/debugging-agent
 
-Multiplayer CLI — AI-powered debugging agent and release management tool.
+AI-powered debugging agent and release management CLI for [Multiplayer](https://multiplayer.app).
 
 ## Install
 
-```
+```sh
 npm install -g @multiplayer-app/debugging-agent
 ```
 
-## Usage
+## Commands
 
-```
-multiplayer [command] [options]
-```
-
-If no command is provided, the debugging agent starts in TUI mode.
+| Command | Description |
+|---------|-------------|
+| `multiplayer` | Start the debugging agent (TUI by default) |
+| `multiplayer releases create` | Register a release |
+| `multiplayer deployments create` | Register a deployment |
+| `multiplayer sourcemaps upload` | Upload sourcemap files |
 
 ---
 
 ## Debugging Agent
 
-Automatically resolves issues using AI. Connects to the Multiplayer backend and processes incoming issues in real time.
+Connects to the Multiplayer backend and automatically resolves incoming issues using AI.
 
-```
+```sh
 multiplayer [options]
 ```
 
-Options can be provided as flags, environment variables, or a `.multiplayer/config` profile file.
+Options are resolved in this order: **CLI flag → environment variable → config profile**.
 
 | Flag | Env var | Description |
 |------|---------|-------------|
 | `--api-key <key>` | `MULTIPLAYER_API_KEY` | Multiplayer API key |
 | `--dir <path>` | `MULTIPLAYER_DIR` | Project directory (must be a git repo) |
 | `--model <name>` | `AI_MODEL` | AI model (e.g. `claude-sonnet-4-6`, `gpt-4o`) |
-| `--model-key <key>` | `AI_API_KEY` | API key for the AI provider (not needed for Claude) |
-| `--model-url <url>` | `AI_BASE_URL` | Optional base URL for OpenAI-compatible APIs |
-| `--headless` | `MULTIPLAYER_HEADLESS=true` | Run without TUI, outputs structured JSON logs |
-| `--profile <name>` | `MULTIPLAYER_PROFILE` | Config profile to use (default: `default`) |
+| `--model-key <key>` | `AI_API_KEY` | AI provider API key (not required for Claude models) |
+| `--model-url <url>` | `AI_BASE_URL` | Base URL for OpenAI-compatible APIs |
+| `--headless` | `MULTIPLAYER_HEADLESS=true` | Run without TUI — outputs structured JSON logs |
+| `--profile <name>` | `MULTIPLAYER_PROFILE` | Config profile to load (default: `default`) |
 | `--name <name>` | `MULTIPLAYER_AGENT_NAME` | Agent name (defaults to hostname) |
-| `--max-concurrent <n>` | `MULTIPLAYER_MAX_CONCURRENT` | Max parallel issues (default: `2`) |
+| `--max-concurrent <n>` | `MULTIPLAYER_MAX_CONCURRENT` | Max issues resolved in parallel (default: `2`) |
 | `--no-git-branch` | `MULTIPLAYER_NO_GIT_BRANCH=true` | Work in current branch — no worktree, no push |
-| `--health-port <port>` | `MULTIPLAYER_HEALTH_PORT` | HTTP health check port (headless only) |
+| `--health-port <port>` | `MULTIPLAYER_HEALTH_PORT` | HTTP health check port (headless mode only) |
 | `--url <url>` | `MULTIPLAYER_URL` | Multiplayer API base URL |
 
 ### TUI mode (default)
 
-```
+An interactive terminal dashboard that shows active sessions and live logs.
+
+```sh
 multiplayer --api-key <key> --dir /path/to/repo --model claude-sonnet-4-6
 ```
 
 ### Headless mode
 
-```
+Outputs newline-delimited JSON logs — suitable for CI, containers, and log aggregators.
+
+```sh
 multiplayer --headless --api-key <key> --dir /path/to/repo --model claude-sonnet-4-6
 ```
 
+In headless mode, `SIGTERM` waits for active sessions to finish before exiting; `SIGINT` exits immediately.
+
 ### Config profiles
 
-Create a `.multiplayer/config` file in your project or home directory:
+Create a `.multiplayer/config` file in your project directory or home directory (`~/.multiplayer/config`). Uses INI format — the same as AWS credentials.
 
 ```ini
 [default]
-api_key = <your-api-key>
-dir = /path/to/repo
-model = claude-sonnet-4-6
+api_key    = <your-api-key>
+dir        = /path/to/repo
+model      = claude-sonnet-4-6
 max_concurrent = 2
+
+[staging]
+api_key    = <staging-api-key>
+dir        = /path/to/staging-repo
+model      = gpt-4o
+model_key  = <openai-api-key>
 ```
 
+All supported profile keys:
+
+| Key | Description |
+|-----|-------------|
+| `api_key` | Multiplayer API key |
+| `dir` | Project directory |
+| `model` | AI model name |
+| `model_key` | AI provider API key |
+| `model_url` | Base URL for OpenAI-compatible APIs |
+| `name` | Agent name |
+| `url` | Multiplayer API base URL |
+| `max_concurrent` | Max parallel issues |
+| `no_git_branch` | `true` to skip branch/worktree creation |
+
 ---
 
 ## Releases
 
-```
+```sh
 multiplayer releases create [options]
 ```
 
@@ -87,7 +114,7 @@ multiplayer releases create [options]
 
 **Example:**
 
-```
+```sh
 multiplayer releases create \
   --api-key $MULTIPLAYER_API_KEY \
   --service my-service \
@@ -100,7 +127,7 @@ multiplayer releases create \
 
 ## Deployments
 
-```
+```sh
 multiplayer deployments create [options]
 ```
 
@@ -108,13 +135,13 @@ multiplayer deployments create [options]
 |------|---------|-------------|
 | `--api-key <key>` | `MULTIPLAYER_API_KEY` | Multiplayer API key |
 | `--service <name>` | `SERVICE_NAME` | Service name |
-| `--release <version>` | `RELEASE` | Release version |
+| `--release <version>` | `VERSION` | Release version |
 | `--environment <name>` | `ENVIRONMENT` | Environment name |
 | `--base-url <url>` | `BASE_URL` | API base URL (optional) |
 
 **Example:**
 
-```
+```sh
 multiplayer deployments create \
   --api-key $MULTIPLAYER_API_KEY \
   --service my-service \
@@ -126,7 +153,7 @@ multiplayer deployments create \
 
 ## Sourcemaps
 
-```
+```sh
 multiplayer sourcemaps upload <directories...> [options]
 ```
 
@@ -139,7 +166,7 @@ multiplayer sourcemaps upload <directories...> [options]
 
 **Example:**
 
-```
+```sh
 multiplayer sourcemaps upload ./dist ./build \
   --api-key $MULTIPLAYER_API_KEY \
   --service my-service \

package/dist/index.js

@@ -148640,6 +148640,21 @@ var decodeApiKeyPayload = (apiKey) => {
     return {};
   }
 };
+var validateApiKey = async (url2, apiKey) => {
+  const payload = decodeApiKeyPayload(apiKey);
+  if (!payload.workspace || !payload.project || !payload.integration) {
+    throw new Error("Invalid API key");
+  }
+  const api = createApiService({ url: url2, apiKey });
+  const project = await api.fetchProject(payload.workspace, payload.project);
+  if (!project) {
+    throw new Error("API key validation failed: workspace or project not found");
+  }
+  return {
+    workspace: payload.workspace,
+    project: payload.project
+  };
+};
 
 // src/components/startup/ApiKeyStep.tsx
 function ApiKeyStep({ config, onComplete }) {
@@ -174950,7 +174965,7 @@ function RateLimitsStep({ config, onComplete }) {
 // src/components/startup/ConnectingStep.tsx
 var import_react29 = __toESM(require_react(), 1);
 function ConnectingStep({ config, onComplete, onBack }) {
-  const [status, setStatus] = import_react29.useState("checking-git");
+  const [status, setStatus] = import_react29.useState("checking-api-key");
   const [error3, setError] = import_react29.useState(null);
   const [runId, setRunId] = import_react29.useState(0);
   useKeyboard(({ name }) => {
@@ -174958,7 +174973,7 @@ function ConnectingStep({ config, onComplete, onBack }) {
       onBack?.();
     if (name === "return" && status === "error") {
       setError(null);
-      setStatus("checking-git");
+      setStatus("checking-api-key");
       setRunId((v2) => v2 + 1);
     }
   });
@@ -174966,6 +174981,10 @@ function ConnectingStep({ config, onComplete, onBack }) {
     let cancelled = false;
     const run = async () => {
       try {
+        if (cancelled)
+          return;
+        setStatus("checking-api-key");
+        await validateApiKey(config.url, config.apiKey);
         if (cancelled)
           return;
         setStatus("checking-git");
@@ -175000,8 +175019,12 @@ function ConnectingStep({ config, onComplete, onBack }) {
       cancelled = true;
     };
   }, [runId]);
-  const gitColor = status === "checking-git" ? "#f59e0b" : status === "error" && error3?.includes("git") ? "#ef4444" : "#10b981";
-  const gitSymbol = status === "checking-git" ? "\u25CC" : status === "error" && error3?.includes("git") ? "\u2715" : "\u2713";
+  const apiKeyPassed = status !== "checking-api-key" && !(status === "error" && !error3?.includes("git") && !error3?.includes("AI") && !error3?.includes("model"));
+  const apiKeyColor = status === "checking-api-key" ? "#f59e0b" : status === "error" && !apiKeyPassed ? "#ef4444" : "#10b981";
+  const apiKeySymbol = status === "checking-api-key" ? "\u25CC" : status === "error" && !apiKeyPassed ? "\u2715" : "\u2713";
+  const gitStarted = status !== "checking-api-key" && status !== "error" || status === "error" && (error3?.includes("git") || apiKeyPassed);
+  const gitColor = !gitStarted ? "#6b7280" : status === "checking-git" ? "#f59e0b" : status === "error" && error3?.includes("git") ? "#ef4444" : "#10b981";
+  const gitSymbol = !gitStarted ? "\xB7" : status === "checking-git" ? "\u25CC" : status === "error" && error3?.includes("git") ? "\u2715" : "\u2713";
   return /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("box", {
     flexDirection: "column",
     gap: 1,
@@ -175015,6 +175038,22 @@ function ConnectingStep({ config, onComplete, onBack }) {
         marginTop: 1,
         gap: 0,
         children: [
+          /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("box", {
+            gap: 2,
+            children: [
+              /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("text", {
+                fg: apiKeyColor,
+                children: apiKeySymbol
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("text", {
+                children: "API key"
+              }, undefined, false, undefined, this),
+              status === "checking-api-key" && /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("text", {
+                attributes: tuiAttrs({ dim: true }),
+                children: "validating..."
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
           /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("box", {
             gap: 2,
             children: [
@@ -175031,7 +175070,7 @@ function ConnectingStep({ config, onComplete, onBack }) {
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this),
-          status !== "checking-git" && /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("box", {
+          status !== "checking-api-key" && status !== "checking-git" && /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("box", {
             gap: 2,
             children: [
               /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("text", {
@@ -176665,9 +176704,22 @@ function iniToProfileConfig(raw) {
   return cfg;
 }
 function findConfigFile(projectDir) {
+  function ancestorCandidates(dir) {
+    const result = [];
+    let current = path12.resolve(dir);
+    const home = os4.homedir();
+    while (true) {
+      result.push(path12.join(current, ".multiplayer", "config"));
+      const parent = path12.dirname(current);
+      if (parent === current || current === home)
+        break;
+      current = parent;
+    }
+    return result;
+  }
   const candidates = [
     projectDir ? path12.join(projectDir, ".multiplayer", "config") : undefined,
-    path12.join(process.cwd(), ".multiplayer", "config"),
+    ...ancestorCandidates(process.cwd()),
     path12.join(os4.homedir(), ".multiplayer", "config")
   ].filter(Boolean);
   const seen = new Set;
@@ -176701,7 +176753,7 @@ function loadProfile(profileName, projectDir) {
 // src/cli/flags.ts
 function parseFlags(argv) {
   const program2 = new Command;
-  program2.name("multiplayer").description("Multiplayer debugging agent \u2014 automatically resolves issues using AI").version("0.0.1").option("--headless", "Run without TUI (structured log output, requires full config); also set via MULTIPLAYER_HEADLESS=true").option("--profile <name>", 'Config profile to use from .multiplayer/config (default: "default"); also set via MULTIPLAYER_PROFILE').option("--url <url>", "Multiplayer base API URL", API_URL).option("--api-key <key>", "Multiplayer API key").option("--name <name>", "Agent name (defaults to hostname)").option("--dir <path>", "Project directory (must be a git repo)").option("--model <name>", "AI model name (e.g. claude-sonnet-4-6, gpt-4o)").option("--model-key <key>", "API key for the AI provider").option("--model-url <url>", "Optional base URL for OpenAI-compatible APIs").option("--max-concurrent <n>", "Maximum number of issues to resolve in parallel", String(DEFAULT_MAX_CONCURRENT)).option("--no-git-branch", "Work in current branch \u2014 no worktree, no new branch, no push").option("--health-port <port>", "Port for HTTP health check endpoint (headless mode only); also set via MULTIPLAYER_HEALTH_PORT").exitOverride();
+  program2.name("multiplayer").description("Multiplayer debugging agent \u2014 automatically resolves issues using AI").version("0.0.1").option("--headless", "Run without TUI (structured log output, requires full config); also set via MULTIPLAYER_HEADLESS=true").option("--profile <name>", 'Config profile to use from .multiplayer/config (default: "default"); also set via MULTIPLAYER_PROFILE').option("--url <url>", "Multiplayer base API URL").option("--api-key <key>", "Multiplayer API key").option("--name <name>", "Agent name (defaults to hostname)").option("--dir <path>", "Project directory (must be a git repo)").option("--model <name>", "AI model name (e.g. claude-sonnet-4-6, gpt-4o)").option("--model-key <key>", "API key for the AI provider").option("--model-url <url>", "Optional base URL for OpenAI-compatible APIs").option("--max-concurrent <n>", "Maximum number of issues to resolve in parallel", String(DEFAULT_MAX_CONCURRENT)).option("--no-git-branch", "Work in current branch \u2014 no worktree, no new branch, no push").option("--health-port <port>", "Port for HTTP health check endpoint (headless mode only); also set via MULTIPLAYER_HEALTH_PORT").exitOverride();
   try {
     program2.parse(argv);
   } catch (err) {
@@ -177027,21 +177079,30 @@ if (firstArg && CLI_SUBCOMMANDS.has(firstArg)) {
 `);
     };
     logger2("info", `Using profile: ${profileName}`);
-    const controller = new RuntimeController(config, logger2);
-    if (healthPort) {
-      const healthServer = startHealthServer(healthPort, controller);
-      logger2("info", `Health server listening on port ${healthPort}`);
-      controller.on("quit", () => healthServer.close());
-    }
-    controller.on("quit", () => {
-      process.exit(0);
-    });
-    process.on("SIGTERM", () => {
-      logger2("info", "SIGTERM received \u2014 waiting for active sessions to complete");
-      controller.quit("after-current");
-    });
-    process.on("SIGINT", () => controller.quit("now"));
-    controller.connect();
+    (async () => {
+      try {
+        await validateApiKey(config.url, config.apiKey);
+      } catch (err) {
+        process.stderr.write(`API key validation failed: ${err.message}
+`);
+        process.exit(1);
+      }
+      const controller = new RuntimeController(config, logger2);
+      if (healthPort) {
+        const healthServer = startHealthServer(healthPort, controller);
+        logger2("info", `Health server listening on port ${healthPort}`);
+        controller.on("quit", () => healthServer.close());
+      }
+      controller.on("quit", () => {
+        process.exit(0);
+      });
+      process.on("SIGTERM", () => {
+        logger2("info", "SIGTERM received \u2014 waiting for active sessions to complete");
+        controller.quit("after-current");
+      });
+      process.on("SIGINT", () => controller.quit("now"));
+      controller.connect();
+    })();
   } else {
     (async () => {
       const renderer = await createCliRenderer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplayer-app/cli",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Multiplayer CLI",
   "main": "dist/index.js",
   "bin": {
@@ -11,8 +11,10 @@
     "start": "bun dist/index.js",
     "dev": "bun src/index.tsx",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src/**/*.ts --config eslint.config.js"
+    "lint": "eslint src/**/*.ts --config eslint.config.js",
+    "prepublish": "npm run build"
   },
+  "license": "MIT",
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.2.73",
     "@anthropic-ai/sdk": "^0.78.0",