@aiden-ade/sandbox-agent 0.1.9 → 0.1.10

package/dist/index.cjs

@@ -11457,7 +11457,9 @@ async function setupDaemon(args) {
   const displayName = argValue(args, "--name") ?? (0, import_node_os.hostname)();
   const legacyLocalMachineId = argValue(args, "--legacy-local-machine-id") ?? process.env.AIDEN_LEGACY_LOCAL_MACHINE_ID;
   if (!setupToken && (!teamId || !token)) {
-    throw new Error("setup requires --setup-token <token> or --team <team-id> and --token <aiden PAT>");
+    throw new Error(
+      "setup requires the full command generated by Aiden: aiden-agent setup --api-url <api-url> --ws-url <ws-url> --setup-token <token>\nAlternatively, use browser authorization with: aiden-agent login --api-url <api-url> --ws-url <ws-url>"
+    );
   }
   const response = await fetch(`${apiUrl}/public/runtimes${setupToken ? "/register-with-setup-token" : ""}`, {
     method: "POST",
@@ -11708,9 +11710,20 @@ async function startDaemon(args) {
     res.writeHead(404, { "content-type": "application/json" }).end(JSON.stringify({ error: "Not found" }));
   });
   await new Promise((resolve2, reject) => {
-    localServer.once("error", reject);
+    const onError = (error) => {
+      clearInterval(heartbeat);
+      socket.disconnect();
+      if (error.code === "EADDRINUSE") {
+        reject(new Error(
+          `local daemon API port ${localApiPort} is already in use. Another aiden-agent daemon may already be running; use \`aiden-agent status\` or stop the existing daemon before starting a new one.`
+        ));
+        return;
+      }
+      reject(error);
+    };
+    localServer.once("error", onError);
     localServer.listen(localApiPort, "127.0.0.1", () => {
-      localServer.off("error", reject);
+      localServer.off("error", onError);
       const address = localServer.address();
       if (address && typeof address === "object") localApiPort = address.port;
       pushLog(`local_api listening port=${localApiPort}`);
@@ -11831,6 +11844,43 @@ async function printDoctor(args = []) {
   }, null, 2));
 }
 
+// src/cli-help.ts
+var HELP_TEXT = `Aiden agent CLI
+
+Usage:
+  aiden-agent <command> [options]
+
+Commands:
+  setup       Register this computer with a setup token from Aiden
+  login       Register this computer through browser authorization
+  daemon      Start the durable runtime daemon
+  status      Show local runtime configuration without secrets
+  doctor      Check local CLI capabilities
+  logout      Remove local runtime configuration
+  token       Rotate or revoke the configured runtime token
+  run-session Run a sandbox session from AIDEN_* environment variables
+
+Common flows:
+  aiden-agent setup --api-url <api-url> --ws-url <ws-url> --setup-token <token>
+  aiden-agent login --api-url <api-url> --ws-url <ws-url>
+  aiden-agent daemon
+`;
+function hasRunSessionEnv(env) {
+  return Boolean(
+    env.AIDEN_WS_URL && env.AIDEN_SESSION_ID && env.AIDEN_TASK_ID && env.AIDEN_SESSION_TOKEN && env.AIDEN_TASK !== void 0
+  );
+}
+function resolveCommand(args, env) {
+  const [command, ...commandArgs] = args;
+  if (!command) {
+    return { command: hasRunSessionEnv(env) ? "run-session" : "help", commandArgs: [] };
+  }
+  if (command === "help" || command === "--help" || command === "-h") {
+    return { command: "help", commandArgs };
+  }
+  return { command, commandArgs };
+}
+
 // src/index.ts
 async function runSessionFromEnv() {
   const wsUrl = process.env.AIDEN_WS_URL;
@@ -11877,7 +11927,11 @@ async function main() {
 `);
     return;
   }
-  const [command = "run-session", ...commandArgs] = process.argv.slice(2);
+  const { command, commandArgs } = resolveCommand(process.argv.slice(2), process.env);
+  if (command === "help") {
+    process.stdout.write(HELP_TEXT);
+    return;
+  }
   if (command === "setup") {
     await setupDaemon(commandArgs);
     return;
@@ -11914,7 +11968,9 @@ async function main() {
     await runSessionFromEnv();
     return;
   }
-  throw new Error(`Unknown command: ${command}`);
+  throw new Error(`Unknown command: ${command}
+
+${HELP_TEXT}`);
 }
 main().catch((error) => {
   console.error("[aiden-agent] Fatal error:", error instanceof Error ? error.message : error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiden-ade/sandbox-agent",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "type": "module",
   "bin": {
     "aiden-agent": "./dist/index.cjs"
@@ -11,21 +11,21 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit"
+  },
   "dependencies": {},
   "devDependencies": {
+    "@aiden/agent-core": "workspace:*",
+    "@aiden/shared": "workspace:*",
     "socket.io-client": "^4.8.0",
     "socket.io": "^4.8.0",
     "@types/node": "^22.0.0",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "typescript": "~5.9.3",
-    "@aiden/shared": "0.1.0",
-    "@aiden/agent-core": "0.1.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx src/index.ts",
-    "test": "vitest run",
-    "type-check": "tsc --noEmit"
+    "typescript": "~5.9.3"
   }
-}
+}