@proagentstore/cli 0.1.6 → 0.1.8

package/dist/browser-runner/index.js

@@ -25,7 +25,7 @@ function configFromArgs() {
     };
 }
 if (flag("--help") || flag("-h")) {
-    process.stdout.write(`ProAgentStore browser runner
+    process.stdout.write(`FreeAgentStore browser runtime for ProAgentStore
 
 Usage:
   pags-browser-runner [--host 127.0.0.1] [--port 49171] [--data-dir path] [--token token] [--instance-id id] [--headless]
@@ -44,9 +44,9 @@ Endpoints:
 }
 const config = configFromArgs();
 const started = await startRunnerServer(config);
-process.stdout.write(`PAGS browser runner listening at ${started.url}\n`);
+process.stdout.write(`FAGS browser runtime listening at ${started.url}\n`);
 process.stdout.write(`Data dir: ${config.dataDir}\n`);
-process.stdout.write(`Brain placement: PAGS; runner role: tool-executor\n`);
+process.stdout.write("Control plane: PAGS; runtime plane: FAGS; 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

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

package/dist/browser-runner/server.js

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

package/dist/index.js

@@ -472,6 +472,7 @@ var publishCommand = new Command4("publish").description("Publish an agent to Pr
 
 // src/commands/runner.ts
 import { spawn as spawn2 } from "child_process";
+import { randomUUID } from "crypto";
 import { existsSync as existsSync4 } from "fs";
 import { resolve as resolve4 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
@@ -507,6 +508,12 @@ function buildRunnerArgs(opts) {
   if (opts.headless) args.push("--headless");
   return args;
 }
+function buildCloudflaredArgs(localUrl) {
+  return ["tunnel", "--url", localUrl];
+}
+function parseCloudflaredTunnelUrl(text) {
+  return text.match(/https:\/\/[a-z0-9-]+\.trycloudflare\.com/i)?.[0] || null;
+}
 function buildRuntimeRegistrationBody(opts, capabilities = []) {
   return {
     endpointUrl: clean(opts.endpointUrl) || opts.endpointUrl,
@@ -533,7 +540,7 @@ function findWorkspaceRoot() {
 function bundledRunnerPath() {
   return fileURLToPath2(new URL("./browser-runner/index.js", import.meta.url));
 }
-function startRunnerForeground(opts) {
+function runnerSpawnSpec(opts) {
   const root = findWorkspaceRoot();
   const localPackage = resolve4(root, "packages", "browser-runner", "src", "index.ts");
   const bundledPackage = bundledRunnerPath();
@@ -549,9 +556,13 @@ function startRunnerForeground(opts) {
     command = process.execPath;
     args = [bundledPackage, ...runnerArgs];
   }
+  return { command, args, cwd };
+}
+function startRunnerForeground(opts) {
+  const spec = runnerSpawnSpec(opts);
   return new Promise((resolvePromise, reject) => {
-    const child = spawn2(command, args, {
-      cwd,
+    const child = spawn2(spec.command, spec.args, {
+      cwd: spec.cwd,
       stdio: "inherit",
       shell: process.platform === "win32"
     });
@@ -562,6 +573,20 @@ function startRunnerForeground(opts) {
     });
   });
 }
+async function waitForLocalRunner(opts, timeoutMs = 15e3) {
+  const started = Date.now();
+  let lastError;
+  while (Date.now() - started < timeoutMs) {
+    try {
+      await requestRunner("GET", "/health", opts);
+      return;
+    } catch (error) {
+      lastError = error;
+      await new Promise((resolvePromise) => setTimeout(resolvePromise, 500));
+    }
+  }
+  throw new Error(`runner did not become healthy: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+}
 async function requestRunner(method, path, opts, body) {
   const headers = {
     ...runnerRequestHeaders(opts)
@@ -616,17 +641,112 @@ function collectCapability(value, previous = []) {
 }
 function createRunnerCommand() {
   const command = new Command5("runner").description(
-    "Manage a local ProAgentStore browser runner"
+    "Manage the local FAGS browser runtime for ProAgentStore agents"
   );
-  command.command("start").description("Start the local browser runner 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 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) => {
     await startRunnerForeground(opts);
   });
-  command.command("status").description("Check local runner 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("connect <instanceId>").description("Start the local FAGS runtime, open a Cloudflare quick tunnel, and register it with PAGS").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("--cloudflared <path>", "cloudflared executable", "cloudflared").option("--runner-version <version>", "Runner version").option("--skip-probe", "Skip PAGS FAGS-runtime probe after registration").action(async (instanceId, opts) => {
+    const runnerToken = clean(opts.token) || clean(process.env.PAGS_RUNNER_TOKEN) || `pags_runner_${randomUUID()}`;
+    const host = clean(opts.host) || "127.0.0.1";
+    const port = clean(opts.port) || "49171";
+    const localUrl = `http://${host}:${port}`;
+    const runnerOpts = {
+      ...opts,
+      host,
+      port,
+      token: runnerToken,
+      instanceId
+    };
+    const spec = runnerSpawnSpec(runnerOpts);
+    const runner = spawn2(spec.command, spec.args, {
+      cwd: spec.cwd,
+      stdio: ["ignore", "pipe", "pipe"],
+      shell: process.platform === "win32"
+    });
+    runner.stdout?.on("data", (data) => process.stdout.write(data));
+    runner.stderr?.on("data", (data) => process.stderr.write(data));
+    runner.on("exit", (code) => {
+      if (code && code !== 0) writeError(`runner exited with code ${code}`);
+    });
+    let tunnel = null;
+    const shutdown = () => {
+      if (tunnel && !tunnel.killed) tunnel.kill("SIGTERM");
+      if (!runner.killed) runner.kill("SIGTERM");
+    };
+    process.once("SIGINT", () => {
+      shutdown();
+      process.exit(0);
+    });
+    process.once("SIGTERM", () => {
+      shutdown();
+      process.exit(0);
+    });
+    try {
+      await waitForLocalRunner({ url: localUrl, token: runnerToken, instanceId });
+      writeLine(`Local FAGS runtime healthy at ${localUrl}`);
+      const tunnelUrl = await new Promise((resolveTunnel, reject) => {
+        let output = "";
+        const cloudflared = clean(opts.cloudflared) || "cloudflared";
+        tunnel = spawn2(cloudflared, buildCloudflaredArgs(localUrl), {
+          stdio: ["ignore", "pipe", "pipe"],
+          shell: process.platform === "win32"
+        });
+        const onData = (data) => {
+          const text = data.toString("utf-8");
+          output += text;
+          process.stderr.write(text);
+          const parsed = parseCloudflaredTunnelUrl(output);
+          if (parsed) resolveTunnel(parsed);
+        };
+        tunnel.stdout?.on("data", onData);
+        tunnel.stderr?.on("data", onData);
+        tunnel.on("error", reject);
+        tunnel.on("exit", (code) => {
+          if (code && code !== 0) reject(new Error(`cloudflared exited with code ${code}`));
+        });
+        setTimeout(() => reject(new Error("timed out waiting for cloudflared tunnel URL")), 45e3).unref();
+      });
+      writeLine(`Tunnel ready: ${tunnelUrl}`);
+      await waitForLocalRunner({ url: tunnelUrl, token: runnerToken, instanceId }, 3e4);
+      writeLine("Tunnel health check passed");
+      const capabilities = await requestRunner("GET", "/capabilities", {
+        url: tunnelUrl,
+        token: runnerToken,
+        instanceId
+      });
+      const result = await requestPags("POST", `/v1/instances/${apiPathSegment(instanceId)}/runtime`, opts, {
+        endpointUrl: tunnelUrl,
+        token: runnerToken,
+        placement: "local",
+        capabilities: Array.isArray(capabilities.capabilities) ? capabilities.capabilities.filter((item) => typeof item === "string") : [],
+        runnerVersion: clean(opts.runnerVersion) || ""
+      });
+      writeLine(JSON.stringify(result, null, 2));
+      if (!opts.skipProbe) {
+        const status = await requestPags(
+          "GET",
+          `/v1/instances/${apiPathSegment(instanceId)}/runtime/status`,
+          opts
+        );
+        writeLine(JSON.stringify(status, null, 2));
+      }
+      writeLine("Connected. Keep this process running while the agent uses your FAGS browser runtime.");
+      await new Promise((resolvePromise) => {
+        runner.on("exit", () => resolvePromise());
+        tunnel?.on("exit", () => resolvePromise());
+      });
+    } catch (error) {
+      shutdown();
+      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) => {
     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 runner 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 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(
     async (opts) => {
       let input = {};
       if (opts.input) {
@@ -647,7 +767,7 @@ function createRunnerCommand() {
       writeLine(JSON.stringify(task, null, 2));
     }
   );
-  command.command("register <instanceId>").description("Register a local or managed runner endpoint with a PAGS instance").requiredOption("--endpoint-url <url>", "Runner 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>", "Runner bearer token to store in PAGS").option("--url <url>", "Local runner URL to probe for capabilities").option("--token <token>", "Local runner 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 runner before registering").action(async (instanceId, opts) => {
+  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) => {
     let capabilities = opts.capability || [];
     if (opts.probe) {
       const data = await requestRunner("GET", "/capabilities", {
@@ -661,7 +781,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 runner").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 FAGS 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));
@@ -670,7 +790,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 runner").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 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(
     async (instanceId, opts) => {
       let input = {};
       if (opts.input) {
@@ -691,7 +811,7 @@ function createRunnerCommand() {
       writeLine(JSON.stringify(result, null, 2));
     }
   );
-  command.command("approve-task <instanceId> <taskId>").description("Approve a registered-runner 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 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) => {
     const result = await requestPags(
       "POST",
       `/v1/instances/${apiPathSegment(instanceId)}/tasks/${apiPathSegment(taskId)}/approve`,
@@ -699,7 +819,7 @@ function createRunnerCommand() {
     );
     writeLine(JSON.stringify(result, null, 2));
   });
-  command.command("cancel-task <instanceId> <taskId>").description("Cancel a registered-runner 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 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) => {
     const result = await requestPags(
       "POST",
       `/v1/instances/${apiPathSegment(instanceId)}/tasks/${apiPathSegment(taskId)}/cancel`,
@@ -707,7 +827,7 @@ function createRunnerCommand() {
     );
     writeLine(JSON.stringify(result, null, 2));
   });
-  command.command("task-events <instanceId>").description("Read registered-runner 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 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) => {
     const result = await requestPags(
       "GET",
       `/v1/instances/${apiPathSegment(instanceId)}/task-events?limit=${Number(opts.limit) || 50}`,
@@ -719,11 +839,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 runner 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 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) => {
     const task = await requestRunner("POST", `/tasks/${apiPathSegment(taskId)}/cancel`, opts);
     writeLine(JSON.stringify(task, null, 2));
   });
-  command.command("events").description("List recent runner 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 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) => {
     const events = await requestRunner("GET", `/events?limit=${Number(opts.limit) || 50}`, opts);
     writeLine(JSON.stringify(events, null, 2));
   });

package/package.json

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