@proagentstore/cli 0.4.11 → 0.4.13

package/dist/browser-runner/coding/headless.js

@@ -33,9 +33,14 @@ export class HeadlessSession {
         this.cmdArgs = args;
         this.binName = (this.cmdBin.split("/").pop() || this.cmdBin) || "cli";
     }
-    /** True while the agent process is running. */
+    /** True while the agent process is running. NOTE: do NOT use `proc.killed` — Node sets
+     *  it true the instant a signal is DELIVERED, not when the process exits. interrupt()
+     *  SIGINTs to abort a turn while the process keeps running, so `killed` gave a false
+     *  "dead" → input() then spawned a SECOND process (orphaning the first). exitCode is
+     *  null while running and set on normal exit; signalCode is set when a signal actually
+     *  terminated it — together they're the real liveness signal. */
     get alive() {
-        return this.proc !== null && this.proc.exitCode === null && !this.proc.killed;
+        return this.proc !== null && this.proc.exitCode === null && this.proc.signalCode === null;
     }
     /** Idle = ready for the next instruction. */
     get ready() {
@@ -275,8 +280,12 @@ export function buildClaudeArgs(userArgs, resumeId) {
                 i++;
             continue;
         }
-        if (!args.includes(a))
-            args.push(a);
+        // Push every user token as-is. A previous `!args.includes(a)` dedup silently
+        // dropped a REPEATED flag token (e.g. the 2nd `--add-dir` in `--add-dir /a
+        // --add-dir /b`), which orphaned its value (`/b` became a stray positional).
+        // Our own structural flags are already protected via RESERVED_CLAUDE_FLAGS, so
+        // no dedup is needed here.
+        args.push(a);
     }
     if (!args.includes("--dangerously-skip-permissions"))
         args.push("--dangerously-skip-permissions");

package/dist/browser-runner/coding/runtime.js

@@ -54,7 +54,11 @@ export class CodingRuntime {
     snapshot(sessionId) {
         const session = this.require(sessionId);
         const alive = session.alive;
-        const pane = alive ? clip(session.snapshot()) : "";
+        // ALWAYS return the transcript — it holds the produced output AND the
+        // `[exited with code N]` / `[error]` lines recorded on exit. Blanking it when the
+        // process is dead lost exactly the output + failure reason the brain/console needs
+        // to diagnose a crash or read a one-shot CLI's final result.
+        const pane = clip(session.snapshot());
         return {
             sessionId,
             pane,

package/dist/browser-runner/index.js

@@ -67,9 +67,9 @@ if (!config.token && !LOOPBACK.has(config.host)) {
     process.exit(1);
 }
 const started = await startRunnerServer(config);
-process.stdout.write(`FAGS browser runtime listening at ${started.url}\n`);
+process.stdout.write(`ProAgentStore browser runtime listening at ${started.url}\n`);
 process.stdout.write(`Data dir: ${config.dataDir}\n`);
-process.stdout.write("Control plane: PAGS; runtime plane: FAGS; brain placement: PAGS; runner role: tool-executor\n");
+process.stdout.write("Control plane: PAGS; runtime plane: PAGS; brain placement: PAGS; runner role: tool-executor\n");
 if (config.token)
     process.stdout.write("Auth: bearer token required\n");
 if (config.instanceId)

package/dist/browser-runner/runner.js

@@ -74,10 +74,10 @@ export class LocalRunner {
     }
     capabilities() {
         return {
-            runtime: "fags-browser-runtime",
+            runtime: "pags-browser-runtime",
             brainPlacement: "pags",
             controlPlane: "pags",
-            runtimePlane: "fags",
+            runtimePlane: "pags",
             runnerRole: "tool-executor",
             capabilities: [...CAPABILITIES, ...CodingRuntime.capabilities()],
             taskTypes: ["echo", "browser.open", "job.apply_agent", ...CodingRuntime.taskTypes()],

package/dist/browser-runner/server.js

@@ -42,10 +42,10 @@ async function route(runner, req, res) {
     if ((req.method === "GET" || req.method === "POST") && path === "/health") {
         return json(res, 200, {
             ok: true,
-            service: "freeagentstore-browser-runtime",
+            service: "proagentstore-browser-runtime",
             brainPlacement: "pags",
             controlPlane: "pags",
-            runtimePlane: "fags",
+            runtimePlane: "pags",
             instanceId: runner.config.instanceId,
         });
     }

package/dist/index.js

@@ -932,9 +932,9 @@ function openRelaySocket(instanceId, wsBase, mintToken, localUrl, runnerToken, f
 }
 function createRunnerCommand() {
   const command = new Command6("runner").description(
-    "Manage the local FAGS browser runtime for ProAgentStore agents"
+    "Manage the local ProAgentStore browser runtime for ProAgentStore agents"
   );
-  command.command("start").description("Start the local FAGS browser runtime in the foreground").option("--host <host>", "Host to bind", "127.0.0.1").option("--port <port>", "Port to bind", "49171").option("--data-dir <path>", "Runner data directory").option("--token <token>", "Require this bearer token").option("--instance-id <id>", "Bind runner requests to a PAGS instance id").option("--headless", "Run Playwright headless").action(async (opts) => {
+  command.command("start").description("Start the local ProAgentStore browser runtime in the foreground").option("--host <host>", "Host to bind", "127.0.0.1").option("--port <port>", "Port to bind", "49171").option("--data-dir <path>", "Runner data directory").option("--token <token>", "Require this bearer token").option("--instance-id <id>", "Bind runner requests to a PAGS instance id").option("--headless", "Run Playwright headless").action(async (opts) => {
     await startRunnerForeground(opts);
   });
   command.command("connect <instanceIds...>").description("Start ONE local runtime, connect via WebSocket relay, and register it for every given PAGS instance").option("--host <host>", "Host to bind", "127.0.0.1").option("--port <port>", "Port to bind", "49171").option("--data-dir <path>", "Runner data directory").option("--token <token>", "Runner bearer token. Defaults to PAGS_RUNNER_TOKEN or a generated token").option("--headless", "Run Playwright headless").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--runner-version <version>", "Runner version").option("--force", "Take over from another connected machine").action(async (instanceIds, opts) => {
@@ -952,10 +952,14 @@ function createRunnerCommand() {
     });
     runner.stdout?.on("data", (data) => process.stdout.write(data));
     runner.stderr?.on("data", (data) => process.stderr.write(data));
+    let shuttingDown = false;
     runner.on("exit", (code) => {
-      if (code && code !== 0) writeError(`runner exited with code ${code}`);
+      if (shuttingDown) return;
+      writeError(`Local browser runtime exited unexpectedly${code ? ` (code ${code})` : ""}. Run \`pags up\` again to reconnect.`);
+      process.exit(code ?? 1);
     });
     const shutdown = () => {
+      shuttingDown = true;
       if (!runner.killed) runner.kill("SIGTERM");
     };
     process.once("SIGINT", () => {
@@ -968,7 +972,7 @@ function createRunnerCommand() {
     });
     try {
       await waitForLocalRunner({ url: localUrl, token: runnerToken, instanceId: primary });
-      writeLine(`Local FAGS runtime healthy at ${localUrl}`);
+      writeLine(`Local browser runtime healthy at ${localUrl}`);
       await connectViaRelay(instanceIds, localUrl, runnerToken, opts, Boolean(opts.force));
       await new Promise((resolvePromise) => {
         runner.on("exit", () => resolvePromise());
@@ -978,12 +982,12 @@ function createRunnerCommand() {
       throw error;
     }
   });
-  command.command("status").description("Check local FAGS runtime health and capabilities").option("--url <url>", "Runner URL").option("--token <token>", "Runner bearer token").option("--instance-id <id>", "PAGS instance id header").action(async (opts) => {
+  command.command("status").description("Check local browser runtime health and capabilities").option("--url <url>", "Runner URL").option("--token <token>", "Runner bearer token").option("--instance-id <id>", "PAGS instance id header").action(async (opts) => {
     const health = await requestRunner("GET", "/health", opts);
     const capabilities = await requestRunner("GET", "/capabilities", opts);
     writeLine(JSON.stringify({ health, capabilities }, null, 2));
   });
-  command.command("task").description("Create a local FAGS runtime task").requiredOption("--type <type>", "Task type, e.g. echo or browser.open").option("--url <url>", "Runner URL").option("--token <token>", "Runner bearer token").option("--instance-id <id>", "PAGS instance id header").option("--input <json>", "Task input JSON").option("--job-url <url>", "Shortcut input for browser.open").option("--approve", "Create task in needs_approval state").option("--approval-prompt <text>", "Approval prompt").action(
+  command.command("task").description("Create a local browser runtime task").requiredOption("--type <type>", "Task type, e.g. echo or browser.open").option("--url <url>", "Runner URL").option("--token <token>", "Runner bearer token").option("--instance-id <id>", "PAGS instance id header").option("--input <json>", "Task input JSON").option("--job-url <url>", "Shortcut input for browser.open").option("--approve", "Create task in needs_approval state").option("--approval-prompt <text>", "Approval prompt").action(
     async (opts) => {
       let input = {};
       if (opts.input) {
@@ -1004,7 +1008,7 @@ function createRunnerCommand() {
       writeLine(JSON.stringify(task, null, 2));
     }
   );
-  command.command("register <instanceId>").description("Register a local or managed FAGS runtime endpoint with a PAGS instance").requiredOption("--endpoint-url <url>", "FAGS runtime endpoint URL to store in PAGS").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--runner-token <token>", "FAGS runtime bearer token to store in PAGS").option("--url <url>", "Local FAGS runtime URL to probe for capabilities").option("--token <token>", "Local FAGS runtime bearer token for capability probe").option("--instance-id <id>", "PAGS instance id header for capability probe").option("--placement <placement>", "Runtime placement: local or managed", "local").option("--runner-version <version>", "Runner version").option("--capability <name>", "Runtime capability; repeatable", collectCapability, []).option("--probe", "Read capabilities from the FAGS runtime before registering").action(async (instanceId, opts) => {
+  command.command("register <instanceId>").description("Register a local or managed browser runtime endpoint with a PAGS instance").requiredOption("--endpoint-url <url>", "browser runtime endpoint URL to store in PAGS").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--runner-token <token>", "browser runtime bearer token to store in PAGS").option("--url <url>", "Local browser runtime URL to probe for capabilities").option("--token <token>", "Local browser runtime bearer token for capability probe").option("--instance-id <id>", "PAGS instance id header for capability probe").option("--placement <placement>", "Runtime placement: local or managed", "local").option("--runner-version <version>", "Runner version").option("--capability <name>", "Runtime capability; repeatable", collectCapability, []).option("--probe", "Read capabilities from the browser runtime before registering").action(async (instanceId, opts) => {
     let capabilities = opts.capability || [];
     if (opts.probe) {
       const data = await requestRunner("GET", "/capabilities", {
@@ -1018,7 +1022,7 @@ function createRunnerCommand() {
     const result = await requestPags("POST", `/v1/instances/${apiPathSegment(instanceId)}/runtime`, opts, body);
     writeLine(JSON.stringify(result, null, 2));
   });
-  command.command("runtime <instanceId>").description("Read the PAGS runtime registration for an instance").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--probe", "Ask PAGS to probe /health and /capabilities on the FAGS runtime").action(async (instanceId, opts) => {
+  command.command("runtime <instanceId>").description("Read the PAGS runtime registration for an instance").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--probe", "Ask PAGS to probe /health and /capabilities on the browser runtime").action(async (instanceId, opts) => {
     const path = opts.probe ? `/v1/instances/${apiPathSegment(instanceId)}/runtime/status` : `/v1/instances/${apiPathSegment(instanceId)}/runtime`;
     const result = await requestPags("GET", path, opts);
     writeLine(JSON.stringify(result, null, 2));
@@ -1027,7 +1031,7 @@ function createRunnerCommand() {
     const result = await requestPags("DELETE", `/v1/instances/${apiPathSegment(instanceId)}/runtime`, opts);
     writeLine(JSON.stringify(result, null, 2));
   });
-  command.command("run <instanceId>").description("Create a task through PAGS on an instance's registered FAGS runtime").requiredOption("--type <type>", "Task type, e.g. echo or browser.open").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--input <json>", "Task input JSON").option("--job-url <url>", "Shortcut input for browser.open").option("--approve", "Create task in needs_approval state").option("--approval-prompt <text>", "Approval prompt").action(
+  command.command("run <instanceId>").description("Create a task through PAGS on an instance's registered browser runtime").requiredOption("--type <type>", "Task type, e.g. echo or browser.open").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--input <json>", "Task input JSON").option("--job-url <url>", "Shortcut input for browser.open").option("--approve", "Create task in needs_approval state").option("--approval-prompt <text>", "Approval prompt").action(
     async (instanceId, opts) => {
       let input = {};
       if (opts.input) {
@@ -1048,7 +1052,7 @@ function createRunnerCommand() {
       writeLine(JSON.stringify(result, null, 2));
     }
   );
-  command.command("approve-task <instanceId> <taskId>").description("Approve a registered FAGS runtime task through PAGS").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").action(async (instanceId, taskId, opts) => {
+  command.command("approve-task <instanceId> <taskId>").description("Approve a registered browser runtime task through PAGS").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").action(async (instanceId, taskId, opts) => {
     const result = await requestPags(
       "POST",
       `/v1/instances/${apiPathSegment(instanceId)}/tasks/${apiPathSegment(taskId)}/approve`,
@@ -1056,7 +1060,7 @@ function createRunnerCommand() {
     );
     writeLine(JSON.stringify(result, null, 2));
   });
-  command.command("cancel-task <instanceId> <taskId>").description("Cancel a registered FAGS runtime task through PAGS").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").action(async (instanceId, taskId, opts) => {
+  command.command("cancel-task <instanceId> <taskId>").description("Cancel a registered browser runtime task through PAGS").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").action(async (instanceId, taskId, opts) => {
     const result = await requestPags(
       "POST",
       `/v1/instances/${apiPathSegment(instanceId)}/tasks/${apiPathSegment(taskId)}/cancel`,
@@ -1064,7 +1068,7 @@ function createRunnerCommand() {
     );
     writeLine(JSON.stringify(result, null, 2));
   });
-  command.command("task-events <instanceId>").description("Read registered FAGS runtime task events through PAGS").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--limit <n>", "Number of events", "50").action(async (instanceId, opts) => {
+  command.command("task-events <instanceId>").description("Read registered browser runtime task events through PAGS").option("--api-base <url>", "PAGS API base URL").option("--pags-token <token>", "PAGS session token. Defaults to PAGS_TOKEN").option("--limit <n>", "Number of events", "50").action(async (instanceId, opts) => {
     const result = await requestPags(
       "GET",
       `/v1/instances/${apiPathSegment(instanceId)}/task-events?limit=${Number(opts.limit) || 50}`,
@@ -1076,11 +1080,11 @@ function createRunnerCommand() {
     const task = await requestRunner("POST", `/tasks/${apiPathSegment(taskId)}/approve`, opts);
     writeLine(JSON.stringify(task, null, 2));
   });
-  command.command("cancel <taskId>").description("Cancel a local FAGS runtime task").option("--url <url>", "Runner URL").option("--token <token>", "Runner bearer token").option("--instance-id <id>", "PAGS instance id header").action(async (taskId, opts) => {
+  command.command("cancel <taskId>").description("Cancel a local browser runtime task").option("--url <url>", "Runner URL").option("--token <token>", "Runner bearer token").option("--instance-id <id>", "PAGS instance id header").action(async (taskId, opts) => {
     const task = await requestRunner("POST", `/tasks/${apiPathSegment(taskId)}/cancel`, opts);
     writeLine(JSON.stringify(task, null, 2));
   });
-  command.command("events").description("List recent FAGS runtime events").option("--url <url>", "Runner URL").option("--token <token>", "Runner bearer token").option("--instance-id <id>", "PAGS instance id header").option("--limit <n>", "Number of events", "50").action(async (opts) => {
+  command.command("events").description("List recent browser runtime events").option("--url <url>", "Runner URL").option("--token <token>", "Runner bearer token").option("--instance-id <id>", "PAGS instance id header").option("--limit <n>", "Number of events", "50").action(async (opts) => {
     const events = await requestRunner("GET", `/events?limit=${Number(opts.limit) || 50}`, opts);
     writeLine(JSON.stringify(events, null, 2));
   });
@@ -1289,7 +1293,7 @@ var upCommand = new Command7("up").description("Start the browser runner for all
         printStatus(state);
         continue;
       }
-      if (trimmed.includes("FAGS browser runtime listening")) {
+      if (trimmed.includes("browser runtime listening")) {
         state.runner = "online";
         state.lastEvent = "Runner started";
         printStatus(state);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proagentstore/cli",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "CLI for creating, publishing, and running ProAgentStore agents",
   "license": "MIT",
   "type": "module",