@proagentstore/cli 0.1.7 → 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

@@ -641,12 +641,12 @@ 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("connect <instanceId>").description("Start a local runner, 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 runtime probe after registration").action(async (instanceId, 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";
@@ -684,7 +684,7 @@ function createRunnerCommand() {
     });
     try {
       await waitForLocalRunner({ url: localUrl, token: runnerToken, instanceId });
-      writeLine(`Local runner healthy at ${localUrl}`);
+      writeLine(`Local FAGS runtime healthy at ${localUrl}`);
       const tunnelUrl = await new Promise((resolveTunnel, reject) => {
         let output = "";
         const cloudflared = clean(opts.cloudflared) || "cloudflared";
@@ -731,7 +731,7 @@ function createRunnerCommand() {
         );
         writeLine(JSON.stringify(status, null, 2));
       }
-      writeLine("Connected. Keep this process running while the agent uses your local browser.");
+      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());
@@ -741,12 +741,12 @@ function createRunnerCommand() {
       throw error;
     }
   });
-  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("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) {
@@ -767,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", {
@@ -781,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));
@@ -790,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) {
@@ -811,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`,
@@ -819,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`,
@@ -827,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}`,
@@ -839,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.7",
+	"version": "0.1.8",
 	"description": "CLI for creating, publishing, and running ProAgentStore agents",
 	"license": "MIT",
 	"type": "module",