@proagentstore/cli 0.1.8 → 0.1.9

package/dist/chunk-LNY7MNUC.js

@@ -0,0 +1,423 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/commands/runner.ts
+import { spawn } from "child_process";
+import { randomUUID } from "crypto";
+import { existsSync } from "fs";
+import { resolve } from "path";
+import { fileURLToPath } from "url";
+import { Command } from "commander";
+
+// src/output.ts
+function writeLine(message = "") {
+  process.stdout.write(`${message}
+`);
+}
+function writeError(message = "") {
+  process.stderr.write(`${message}
+`);
+}
+
+// src/commands/runner.ts
+var runnerCommand = createRunnerCommand();
+function runnerBaseUrl(url) {
+  return (clean(url) || clean(process.env.PAGS_RUNNER_URL) || "http://127.0.0.1:49171").replace(/\/$/, "");
+}
+function pagsApiBase(url) {
+  return (clean(url) || clean(process.env.PAGS_API_BASE) || "https://api.proagentstore.online").replace(/\/$/, "");
+}
+function pagsHeaders(token) {
+  const resolved = clean(token) || clean(process.env.PAGS_TOKEN);
+  return resolved ? { Authorization: `Bearer ${resolved}` } : {};
+}
+function runnerHeaders(token) {
+  const resolved = clean(token) || clean(process.env.PAGS_RUNNER_TOKEN);
+  return resolved ? { Authorization: `Bearer ${resolved}` } : {};
+}
+function runnerRequestHeaders(opts) {
+  const resolved = clean(opts.token) || clean(process.env.PAGS_RUNNER_TOKEN);
+  const headers = resolved ? { Authorization: `Bearer ${resolved}` } : {};
+  const instanceId = clean(opts.instanceId) || clean(process.env.PAGS_INSTANCE_ID);
+  if (instanceId) headers["X-PAGS-Instance-Id"] = instanceId;
+  return headers;
+}
+function apiPathSegment(value) {
+  return encodeURIComponent(value);
+}
+function buildRunnerArgs(opts) {
+  const args = [];
+  if (clean(opts.host)) args.push("--host", clean(opts.host));
+  if (clean(opts.port)) args.push("--port", clean(opts.port));
+  if (clean(opts.dataDir)) args.push("--data-dir", clean(opts.dataDir));
+  if (clean(opts.token)) args.push("--token", clean(opts.token));
+  if (clean(opts.instanceId)) args.push("--instance-id", clean(opts.instanceId));
+  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,
+    token: clean(opts.runnerToken) || clean(opts.token) || clean(process.env.PAGS_RUNNER_TOKEN),
+    placement: opts.placement === "managed" ? "managed" : "local",
+    capabilities,
+    runnerVersion: clean(opts.runnerVersion) || ""
+  };
+}
+function clean(value) {
+  const trimmed = value?.trim();
+  return trimmed || void 0;
+}
+function findWorkspaceRoot() {
+  let dir = process.cwd();
+  for (let i = 0; i < 8; i++) {
+    if (existsSync(resolve(dir, "pnpm-workspace.yaml"))) return dir;
+    const parent = resolve(dir, "..");
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return process.cwd();
+}
+function bundledRunnerPath() {
+  return fileURLToPath(new URL("./browser-runner/index.js", import.meta.url));
+}
+function runnerSpawnSpec(opts) {
+  const root = findWorkspaceRoot();
+  const localPackage = resolve(root, "packages", "browser-runner", "src", "index.ts");
+  const bundledPackage = bundledRunnerPath();
+  const runnerArgs = buildRunnerArgs(opts);
+  let cwd = root;
+  let command = "pags-browser-runner";
+  let args = runnerArgs;
+  if (existsSync(localPackage)) {
+    command = "pnpm";
+    args = ["--filter", "@proagentstore/browser-runner", "dev", "--", ...runnerArgs];
+  } else if (existsSync(bundledPackage)) {
+    cwd = process.cwd();
+    command = process.execPath;
+    args = [bundledPackage, ...runnerArgs];
+  }
+  return { command, args, cwd };
+}
+function startRunnerForeground(opts) {
+  const spec = runnerSpawnSpec(opts);
+  return new Promise((resolvePromise, reject) => {
+    const child = spawn(spec.command, spec.args, {
+      cwd: spec.cwd,
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code && code !== 0) reject(new Error(`runner exited with code ${code}`));
+      else resolvePromise();
+    });
+  });
+}
+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)
+  };
+  if (body !== void 0) headers["Content-Type"] = "application/json";
+  const res = await fetch(`${runnerBaseUrl(opts.url)}${path}`, {
+    method,
+    headers,
+    body: body === void 0 ? void 0 : JSON.stringify(body)
+  });
+  const { text, data } = await readResponse(res);
+  if (!res.ok) {
+    const message = responseErrorMessage(data, text, res.statusText);
+    throw new Error(`${res.status} ${message}`);
+  }
+  return data;
+}
+async function requestPags(method, path, opts, body) {
+  const headers = {
+    ...pagsHeaders(opts.pagsToken)
+  };
+  if (!headers.Authorization) {
+    throw new Error("PAGS token required. Set PAGS_TOKEN or pass --pags-token.");
+  }
+  if (body !== void 0) headers["Content-Type"] = "application/json";
+  const res = await fetch(`${pagsApiBase(opts.apiBase)}${path}`, {
+    method,
+    headers,
+    body: body === void 0 ? void 0 : JSON.stringify(body)
+  });
+  const { text, data } = await readResponse(res);
+  if (!res.ok) {
+    const message = responseErrorMessage(data, text, res.statusText);
+    throw new Error(`${res.status} ${message}`);
+  }
+  return data;
+}
+async function readResponse(res) {
+  const text = await res.text();
+  if (!text) return { text, data: {} };
+  try {
+    return { text, data: JSON.parse(text) };
+  } catch {
+    return { text, data: {} };
+  }
+}
+function responseErrorMessage(data, text, statusText) {
+  return typeof data.error === "string" ? data.error : text || statusText;
+}
+function collectCapability(value, previous = []) {
+  return [...previous, value];
+}
+function createRunnerCommand() {
+  const command = new Command("runner").description(
+    "Manage the local FAGS 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) => {
+    await startRunnerForeground(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 = spawn(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 = spawn(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 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) {
+        try {
+          input = JSON.parse(opts.input);
+        } catch {
+          writeError("--input must be valid JSON");
+          process.exit(1);
+        }
+      }
+      if (opts.jobUrl) input.url = opts.jobUrl;
+      const task = await requestRunner("POST", "/tasks", opts, {
+        type: opts.type,
+        input,
+        requiresApproval: Boolean(opts.approve),
+        approvalPrompt: opts.approvalPrompt
+      });
+      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) => {
+    let capabilities = opts.capability || [];
+    if (opts.probe) {
+      const data = await requestRunner("GET", "/capabilities", {
+        url: opts.url || opts.endpointUrl,
+        token: opts.token || opts.runnerToken,
+        instanceId: opts.instanceId || instanceId
+      });
+      capabilities = Array.isArray(data.capabilities) ? data.capabilities.filter((item) => typeof item === "string") : capabilities;
+    }
+    const body = buildRuntimeRegistrationBody(opts, capabilities);
+    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) => {
+    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));
+  });
+  command.command("unregister <instanceId>").description("Remove 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").action(async (instanceId, opts) => {
+    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(
+    async (instanceId, opts) => {
+      let input = {};
+      if (opts.input) {
+        try {
+          input = JSON.parse(opts.input);
+        } catch {
+          writeError("--input must be valid JSON");
+          process.exit(1);
+        }
+      }
+      if (opts.jobUrl) input.url = opts.jobUrl;
+      const result = await requestPags("POST", `/v1/instances/${apiPathSegment(instanceId)}/tasks`, opts, {
+        type: opts.type,
+        input,
+        requiresApproval: Boolean(opts.approve),
+        approvalPrompt: opts.approvalPrompt
+      });
+      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) => {
+    const result = await requestPags(
+      "POST",
+      `/v1/instances/${apiPathSegment(instanceId)}/tasks/${apiPathSegment(taskId)}/approve`,
+      opts
+    );
+    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) => {
+    const result = await requestPags(
+      "POST",
+      `/v1/instances/${apiPathSegment(instanceId)}/tasks/${apiPathSegment(taskId)}/cancel`,
+      opts
+    );
+    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) => {
+    const result = await requestPags(
+      "GET",
+      `/v1/instances/${apiPathSegment(instanceId)}/task-events?limit=${Number(opts.limit) || 50}`,
+      opts
+    );
+    writeLine(JSON.stringify(result, null, 2));
+  });
+  command.command("approve <taskId>").description("Approve a task waiting on human approval").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)}/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) => {
+    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) => {
+    const events = await requestRunner("GET", `/events?limit=${Number(opts.limit) || 50}`, opts);
+    writeLine(JSON.stringify(events, null, 2));
+  });
+  return command;
+}
+
+export {
+  __require,
+  writeLine,
+  writeError,
+  runnerCommand,
+  runnerBaseUrl,
+  pagsApiBase,
+  pagsHeaders,
+  runnerHeaders,
+  runnerRequestHeaders,
+  apiPathSegment,
+  buildRunnerArgs,
+  buildCloudflaredArgs,
+  parseCloudflaredTunnelUrl,
+  buildRuntimeRegistrationBody,
+  bundledRunnerPath,
+  requestRunner,
+  requestPags,
+  createRunnerCommand
+};