@agentproto/adapter-browser 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jeremy André and agentproto contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,164 @@
+interface BrowserAdapterHandle {
+    /** Stable identifier — "camofox" | "bureau" | "chromium" */
+    id: string;
+    name: string;
+    description: string;
+    defaultPort: number;
+    /** Path used for health probing, e.g. "/health" */
+    healthPath: string;
+    /**
+     * Where this adapter runs.  Defaults to "local" when absent.
+     * MVP: each adapter declares exactly one location.
+     */
+    location?: "local" | "cloud";
+    /**
+     * How to obtain / install the underlying binary or service.
+     * Informational for now; T9 will wire these into `ensure`.
+     */
+    install?: BrowserAdapterInstall[];
+    /**
+     * Post-install configuration prompts.  Structurally compatible with the
+     * prompt-arm of AIP-45 `AgentCliSetupStep` (type-import not taken to keep
+     * this package dep-free of `@agentproto/driver-agent-cli`).
+     *
+     * Note: `persist.env` here is a SUBSET of the `env` arm of the AIP-45 union
+     * (`{ env: string }`).  The union also supports `secret_slug` and `cmd` arms
+     * which are not represented here.  Extend toward the full union if those
+     * variants become necessary rather than adding a single-line Extract<>.
+     */
+    config?: BrowserAdapterConfigStep[];
+    /**
+     * Platform constraints.  Mirrors `AgentCliRequires` from AIP-45 but
+     * redeclared here to avoid the dep (same rationale as `config`).
+     */
+    requires?: BrowserAdapterRequires;
+    /**
+     * Typed runtime knobs.  Mirrors `AgentCliOption` (minimal subset).
+     * Not wired into `ensure` until T9.
+     */
+    options?: BrowserAdapterOption[];
+    /**
+     * Ensure the service is up and return a live instance descriptor.
+     * Idempotent: if already healthy, returns immediately with wasAlreadyRunning: true.
+     */
+    ensure(opts: BrowserAdapterStartOptions): Promise<BrowserAdapterInstance>;
+}
+/**
+ * One entry in `BrowserAdapterHandle.install`.
+ *
+ * - "path"      — binary already on the system at a known path (or on PATH).
+ * - "download"  — fetch a release archive and extract a binary.
+ * - "curl"      — pipe through a shell installer script.
+ * - "vendored"  — shipped inside this monorepo / npm package.
+ * - "cloud"     — adapter is a remote URL, not a local process.
+ */
+interface BrowserAdapterInstall {
+    method: "path" | "download" | "curl" | "vendored" | "cloud";
+    /** For "download" / "curl" / "cloud" — the source URL. */
+    url?: string;
+    /** Optional SHA-256 hex digest to verify a downloaded artifact. */
+    verify_sha256?: string;
+    /** For "cloud" — env-var name that holds the auth token (e.g. "BROWSER_SERVICE_KEY"). */
+    secret?: string;
+}
+/**
+ * One post-install configuration prompt.
+ *
+ * Structurally matches the "prompt" arm of AIP-45 `AgentCliSetupStep`.
+ * `persist.env` is the only persist form supported here (MVP): the captured
+ * value is injected as an env var on every subsequent `ensure` call (T9).
+ */
+interface BrowserAdapterConfigStep {
+    id: string;
+    kind: "prompt";
+    prompt: string;
+    description?: string;
+    type?: "text" | "select" | "boolean" | "secret";
+    default?: string;
+    options?: string[];
+    /** Where the captured value lands so `ensure` can reuse it. */
+    persist?: {
+        /** Env-var name to inject on every spawn. */
+        env: string;
+    };
+}
+/** Platform constraints for this adapter. */
+interface BrowserAdapterRequires {
+    /**
+     * Hard OS constraint: the adapter is **unavailable** on platforms not listed
+     * here (Node `process.platform` values, e.g. `"linux"`).  Absence means the
+     * adapter is available everywhere.
+     */
+    os?: string[];
+    /** Allowed CPU architectures (Node `process.arch` values). */
+    arch?: string[];
+    /**
+     * OS platforms on which the **native launcher path** (e.g. launchd plist) is
+     * available.  This is NOT a hard availability constraint — the adapter still
+     * works on other platforms when a `SERVE_CMD` env var or `opts.launchCmd`
+     * override is provided.  Absence means no platform-specific native launcher.
+     */
+    nativeLaunchOs?: string[];
+}
+/** Minimal subset of AIP-45 `AgentCliOption` — typed runtime knob. */
+interface BrowserAdapterOption {
+    id: string;
+    type: "boolean" | "integer" | "string" | "enum";
+    description?: string;
+    /** Required when type === "enum". */
+    enum?: string[];
+    default?: boolean | number | string;
+    /** Env vars to merge when the option is active. */
+    env?: Record<string, string>;
+}
+interface BrowserAdapterStartOptions {
+    port?: number;
+    /** For adapters that depend on Camofox (e.g. bureau): override the Camofox port (default 9377). */
+    camofoxPort?: number;
+    /** Override the launch command (shell string). Takes precedence over env vars. */
+    launchCmd?: string;
+    /** Additional env vars forwarded to the spawned process. */
+    env?: Record<string, string>;
+    timeoutMs?: number;
+    log?: (s: string) => void;
+    /**
+     * Where to run the adapter.  Defaults to `handle.location ?? "local"`.
+     * - `"local"` — spawn the process on the current machine (existing behaviour).
+     * - `"cloud"` — health-check a remote endpoint; no process is spawned.
+     *   Requires `baseUrl` to be set.
+     */
+    location?: "local" | "cloud";
+    /**
+     * Base URL of the remote service when `location === "cloud"`.
+     * Example: `"https://browser-service.example.com"`.
+     * Required (and only used) when `location === "cloud"`.
+     */
+    baseUrl?: string;
+}
+interface BrowserAdapterInstance {
+    id: string;
+    port: number;
+    baseUrl: string;
+    /**
+     * PID of the spawned process. May be `undefined` when the service is managed
+     * externally (e.g. launchd) — do NOT use this to kill the process in that case.
+     */
+    pid?: number;
+    wasAlreadyRunning: boolean;
+    /**
+     * Best-effort stop. Sends SIGTERM to `pid` if known; otherwise a no-op
+     * (externally-managed services must be stopped via their own manager).
+     */
+    stop(): Promise<void>;
+}
+
+declare const camofoxAdapter: BrowserAdapterHandle;
+
+declare const bureauAdapter: BrowserAdapterHandle;
+
+declare const chromiumAdapter: BrowserAdapterHandle;
+
+declare const browserAdapters: Record<string, BrowserAdapterHandle>;
+declare function getBrowserAdapter(id: string): BrowserAdapterHandle | undefined;
+
+export { type BrowserAdapterHandle, type BrowserAdapterInstance, type BrowserAdapterStartOptions, browserAdapters, bureauAdapter, camofoxAdapter, chromiumAdapter, getBrowserAdapter };

package/dist/index.mjs

@@ -0,0 +1,307 @@
+import { platform, homedir } from 'os';
+import { spawn } from 'child_process';
+import { join } from 'path';
+import { readFile } from 'fs/promises';
+import { ensureBrowserProcess } from '@agentproto/browser-process';
+
+/**
+ * @agentproto/adapter-browser v0.1.0-alpha
+ * Browser service adapters — Camofox + Bureau process handles.
+ */
+
+async function loadPersistedEnv(adapterId) {
+  const base = process.env["AGENTPROTO_HOME"] ?? join(homedir(), ".agentproto");
+  const ledgerPath = join(base, "browser-adapters", `${adapterId}.json`);
+  try {
+    const raw = await readFile(ledgerPath, "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed.envValues ?? {};
+  } catch {
+    return {};
+  }
+}
+function makeStop(pid, processGroup) {
+  return async () => {
+    if (!pid) return;
+    if (processGroup) {
+      try {
+        process.kill(-pid, "SIGTERM");
+        return;
+      } catch {
+      }
+    }
+    try {
+      process.kill(pid, "SIGTERM");
+    } catch {
+    }
+  };
+}
+async function resolveLaunch(cfg) {
+  const { handle, opts, label } = cfg;
+  const port = opts.port ?? handle.defaultPort;
+  const timeoutMs = opts.timeoutMs ?? 6e4;
+  const log = opts.log;
+  const location = opts.location ?? handle.location ?? "local";
+  const persistedEnv = await loadPersistedEnv(handle.id);
+  const resolvedExtraEnv = typeof cfg.extraEnv === "function" ? cfg.extraEnv(port) : cfg.extraEnv;
+  if (location === "cloud") {
+    const cloudBase = opts.baseUrl;
+    if (!cloudBase) {
+      throw new Error(
+        `[${label}] location="cloud" requires opts.baseUrl (the remote service base URL).`
+      );
+    }
+    const healthUrl = cloudBase.replace(/\/$/, "") + handle.healthPath;
+    log?.(`[${label}] cloud mode \u2014 health-checking ${healthUrl}`);
+    const result2 = await ensureBrowserProcess({
+      kind: handle.id,
+      healthUrl,
+      launch: () => null,
+      timeoutMs,
+      intervalMs: 1e3,
+      log
+    });
+    return {
+      id: handle.id,
+      port,
+      baseUrl: result2.baseUrl,
+      pid: void 0,
+      wasAlreadyRunning: result2.wasAlreadyRunning,
+      stop: async () => {
+      }
+    };
+  }
+  const result = await ensureBrowserProcess({
+    kind: handle.id,
+    healthUrl: `http://127.0.0.1:${port}${handle.healthPath}`,
+    launch() {
+      const cmd = cfg.resolveLocalCmd();
+      if (!cmd) {
+        const nativePlatforms = handle.requires?.nativeLaunchOs;
+        const platformHint = nativePlatforms && !nativePlatforms.includes(platform()) ? ` (native launcher only available on ${nativePlatforms.join(", ")}; set the relevant SERVE_CMD env var on ${platform()} or pass opts.launchCmd)` : "";
+        throw new Error(
+          `[${label}] service is not running on :${port} and no launch command is available.${platformHint}`
+        );
+      }
+      log?.(`[${label}] starting: ${[cmd.file, ...cmd.args].join(" ")}`);
+      if (cmd.isLaunchctl) {
+        spawn(cmd.file, cmd.args, {
+          detached: true,
+          stdio: "ignore",
+          env: { ...process.env, ...persistedEnv, ...opts.env, ...resolvedExtraEnv }
+        }).unref();
+        return null;
+      }
+      const child = spawn(cmd.file, cmd.args, {
+        detached: true,
+        stdio: "ignore",
+        env: { ...process.env, ...persistedEnv, ...opts.env, ...resolvedExtraEnv },
+        ...cmd.cwd ? { cwd: cmd.cwd } : {}
+      });
+      child.unref();
+      return child;
+    },
+    timeoutMs,
+    intervalMs: 1e3,
+    log
+  });
+  return {
+    id: handle.id,
+    port,
+    baseUrl: result.baseUrl,
+    pid: result.pid,
+    wasAlreadyRunning: result.wasAlreadyRunning,
+    stop: makeStop(result.pid, cfg.killProcessGroup ?? false)
+  };
+}
+
+// src/adapters/camofox.ts
+function resolveCmd(launchCmd, env) {
+  if (launchCmd) return { file: "/bin/sh", args: ["-c", launchCmd] };
+  const envCmd = env?.CAMOFOX_SERVE_CMD ?? process.env.CAMOFOX_SERVE_CMD;
+  if (envCmd) return { file: "/bin/sh", args: ["-c", envCmd] };
+  if (platform() === "darwin")
+    return { file: "launchctl", args: ["start", "com.agentik.camofox"], isLaunchctl: true };
+  return null;
+}
+var camofoxAdapter = {
+  id: "camofox",
+  name: "Camofox (stealth Firefox headless)",
+  description: "Camofox headless stealth Firefox REST API on :9377. Exposes /sessions, /tabs, and /health. Required dependency for the bureau adapter.",
+  defaultPort: 9377,
+  healthPath: "/health",
+  location: "local",
+  install: [
+    {
+      method: "vendored"
+      // Shipped via the agentik launchd plist on macOS; on other platforms
+      // install camofox separately and point CAMOFOX_SERVE_CMD at it.
+    }
+  ],
+  requires: {
+    // nativeLaunchOs ≠ hard constraint: the adapter is available on all
+    // platforms.  This field only signals that the built-in launchd path
+    // (com.agentik.camofox) exists on macOS; elsewhere CAMOFOX_SERVE_CMD
+    // or opts.launchCmd must be provided.
+    nativeLaunchOs: ["darwin"]
+  },
+  config: [
+    {
+      id: "camofox-serve-cmd",
+      kind: "prompt",
+      prompt: "Shell command to start camofox (leave blank on macOS when using the com.agentik.camofox launchd plist)",
+      description: "Required on non-macOS hosts.  On macOS this overrides the default `launchctl start com.agentik.camofox` path.",
+      type: "text",
+      persist: { env: "CAMOFOX_SERVE_CMD" }
+    }
+  ],
+  async ensure(opts) {
+    return resolveLaunch({
+      handle: this,
+      opts,
+      label: "camofox",
+      resolveLocalCmd: () => resolveCmd(opts.launchCmd, opts.env)
+    });
+  }
+};
+
+// src/adapters/bureau.ts
+function resolveBureauCmd(launchCmd, env) {
+  const cmd = launchCmd ?? env?.BUREAU_SERVE_CMD ?? process.env.BUREAU_SERVE_CMD;
+  if (cmd) return { file: "/bin/sh", args: ["-c", cmd] };
+  return { file: "bureau", args: ["serve"] };
+}
+var bureauAdapter = {
+  id: "bureau",
+  name: "Bureau (Camofox + MCP capability server)",
+  description: "Bureau capability server on :8830. Orchestrates Camofox headless first, then spawns bureau serve which exposes browser tools as MCP-over-HTTP.",
+  defaultPort: 8830,
+  healthPath: "/health",
+  location: "local",
+  install: [
+    {
+      method: "path"
+      // `bureau` CLI must be on PATH (e.g. installed via `npm i -g @agentik/bureau`
+      // or linked from the monorepo workspace bin).
+    }
+  ],
+  config: [
+    // bureau inherits camofox's CAMOFOX_SERVE_CMD implicitly — camofoxAdapter.ensure
+    // is called first inside `ensure` and reads that env var itself.
+    {
+      id: "bureau-serve-cmd",
+      kind: "prompt",
+      prompt: "Shell command to start bureau (leave blank to use `bureau serve` on PATH)",
+      type: "text",
+      persist: { env: "BUREAU_SERVE_CMD" }
+    },
+    {
+      id: "bureau-port",
+      kind: "prompt",
+      prompt: "Port bureau should listen on",
+      type: "text",
+      default: "8830",
+      persist: { env: "BUREAU_PORT" }
+    }
+  ],
+  async ensure(opts) {
+    const timeoutMs = opts.timeoutMs ?? 6e4;
+    const log = opts.log;
+    const cam = await camofoxAdapter.ensure({
+      port: opts.camofoxPort ?? 9377,
+      launchCmd: void 0,
+      env: opts.env,
+      timeoutMs,
+      log
+    });
+    return resolveLaunch({
+      handle: this,
+      opts,
+      label: "bureau",
+      resolveLocalCmd: () => resolveBureauCmd(opts.launchCmd, opts.env),
+      // PORT must reflect the resolved port — extraEnv receives it as a factory arg.
+      extraEnv: (port) => ({
+        CAMOFOX_URL: cam.baseUrl,
+        PORT: String(port)
+      })
+    });
+  }
+};
+
+// src/adapters/chromium.ts
+function resolveCmd2(launchCmd, env, log) {
+  if (launchCmd) return { file: "/bin/sh", args: ["-c", launchCmd] };
+  const envCmd = env?.CHROMIUM_SERVE_CMD ?? process.env.CHROMIUM_SERVE_CMD;
+  if (envCmd) return { file: "/bin/sh", args: ["-c", envCmd] };
+  const cwd = resolveCwd(env, log);
+  return { file: "/bin/sh", args: ["-c", "pnpm --filter=@browser/service start"], cwd };
+}
+function resolveCwd(env, log) {
+  const explicit = env?.CHROMIUM_SERVE_CWD ?? process.env.CHROMIUM_SERVE_CWD;
+  if (explicit) return explicit;
+  log?.(
+    "[chromium] warning: CHROMIUM_SERVE_CWD is not set; relying on daemon cwd for `pnpm --filter=@browser/service start`. Set CHROMIUM_SERVE_CWD or run the daemon from the repo root, or override with CHROMIUM_SERVE_CMD."
+  );
+  return void 0;
+}
+var chromiumAdapter = {
+  id: "chromium",
+  name: "Chromium Browser Service",
+  description: "Heavy Chromium webservice (projects/browser/apps/service) on :3200. Exposes /healthz, /readyz, REST session routes, and a CDP WebSocket proxy.",
+  defaultPort: 3200,
+  healthPath: "/healthz",
+  location: "local",
+  install: [
+    {
+      method: "path"
+      // Local: `pnpm --filter=@browser/service start` from the monorepo root,
+      // or set CHROMIUM_SERVE_CMD / CHROMIUM_SERVE_CWD to point at a custom launcher.
+      // Cloud variant (future — not yet wired into ensure):
+      //   method: "cloud", url: process.env.BROWSER_SERVICE_URL, secret: "BROWSER_SERVICE_KEY"
+    }
+  ],
+  config: [
+    {
+      id: "chromium-serve-cmd",
+      kind: "prompt",
+      prompt: "Shell command to start the browser service (default: pnpm --filter=@browser/service start)",
+      description: "Override CHROMIUM_SERVE_CMD.  When blank, the default pnpm filter command is used and CHROMIUM_SERVE_CWD must point to the monorepo root.",
+      type: "text",
+      persist: { env: "CHROMIUM_SERVE_CMD" }
+    },
+    {
+      id: "chromium-serve-cwd",
+      kind: "prompt",
+      prompt: "Working directory for the browser service (monorepo root required for the pnpm filter command)",
+      type: "text",
+      persist: { env: "CHROMIUM_SERVE_CWD" }
+    }
+    // Future cloud step (T9+):
+    // { id: "chromium-cloud-url",   kind: "prompt", prompt: "Remote browser-service URL", type: "text",   persist: { env: "BROWSER_SERVICE_URL" } },
+    // { id: "chromium-cloud-token", kind: "prompt", prompt: "X-Internal-Key token",        type: "secret", persist: { env: "BROWSER_SERVICE_KEY" } },
+  ],
+  async ensure(opts) {
+    return resolveLaunch({
+      handle: this,
+      opts,
+      label: "chromium",
+      resolveLocalCmd: () => resolveCmd2(opts.launchCmd, opts.env, opts.log),
+      // Kill the whole process group so the pnpm-forked node child is not orphaned.
+      killProcessGroup: true
+    });
+  }
+};
+
+// src/index.ts
+var browserAdapters = {
+  camofox: camofoxAdapter,
+  bureau: bureauAdapter,
+  chromium: chromiumAdapter
+};
+function getBrowserAdapter(id) {
+  return browserAdapters[id];
+}
+
+export { browserAdapters, bureauAdapter, camofoxAdapter, chromiumAdapter, getBrowserAdapter };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/resolve-launch.ts","../src/adapters/camofox.ts","../src/adapters/bureau.ts","../src/adapters/chromium.ts","../src/index.ts"],"names":["result","platform","resolveCmd"],"mappings":"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","file":"index.mjs","sourcesContent":["import { spawn } from \"node:child_process\"\nimport { platform, homedir } from \"node:os\"\nimport { join } from \"node:path\"\nimport { readFile } from \"node:fs/promises\"\nimport { ensureBrowserProcess } from \"@agentproto/browser-process\"\nimport type { BrowserAdapterHandle, BrowserAdapterStartOptions, BrowserAdapterInstance } from \"../types.js\"\n\n// ── Persisted config ledger ───────────────────────────────────────────────────\n\n/**\n * Best-effort read of the persisted env values written by\n * `agentproto browser install`.  Returns `{}` on any read/parse failure.\n *\n * Path: `$AGENTPROTO_HOME/browser-adapters/<adapterId>.json`\n * (same convention as the CLI's `browserAdapterLedgerPath()`).\n */\nasync function loadPersistedEnv(adapterId: string): Promise<Record<string, string>> {\n  const base = process.env[\"AGENTPROTO_HOME\"] ?? join(homedir(), \".agentproto\")\n  const ledgerPath = join(base, \"browser-adapters\", `${adapterId}.json`)\n  try {\n    const raw = await readFile(ledgerPath, \"utf8\")\n    const parsed = JSON.parse(raw) as { envValues?: Record<string, string> }\n    return parsed.envValues ?? {}\n  } catch {\n    return {}\n  }\n}\n\n// ─── Config ───────────────────────────────────────────────────────────────────\n\nexport interface ResolveLaunchConfig {\n  handle: Pick<BrowserAdapterHandle, \"id\" | \"defaultPort\" | \"healthPath\" | \"location\" | \"requires\">\n  opts: BrowserAdapterStartOptions\n  /**\n   * Short label used in log and error messages (e.g. \"camofox\", \"bureau\").\n   * Typically matches `handle.id`.\n   */\n  label: string\n  /**\n   * Returns the local launch command, or `null` when no command is resolvable.\n   * The returned object may carry `isLaunchctl: true` for launchers (like\n   * launchctl) that exit immediately and are not the real managed process — in\n   * that case the child is spawned for its side-effect only and `pid` stays\n   * undefined in the resulting instance.\n   * `cwd` is forwarded to the spawned child when present.\n   */\n  resolveLocalCmd(): {\n    file: string\n    args: string[]\n    isLaunchctl?: boolean\n    cwd?: string\n  } | null\n  /**\n   * Extra env vars merged into the spawned process env (after `opts.env`).\n   * Accepts either a plain record or a factory that receives the resolved port\n   * (useful when the port must be baked into an env var like `PORT`).\n   */\n  extraEnv?: Record<string, string> | ((port: number) => Record<string, string>)\n  /**\n   * When `true`, stop() sends SIGTERM to the whole process group (`-pid`),\n   * falling back to the direct pid on failure.  Use for adapters that spawn\n   * through `sh -c` and need to terminate pnpm-forked child processes.\n   * Default: false (direct-pid SIGTERM only).\n   */\n  killProcessGroup?: boolean\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction makeStop(pid: number | undefined, processGroup: boolean): () => Promise<void> {\n  return async () => {\n    if (!pid) return\n    if (processGroup) {\n      try {\n        process.kill(-pid, \"SIGTERM\")\n        return\n      } catch {\n        // group already gone — fall through to direct pid\n      }\n    }\n    try {\n      process.kill(pid, \"SIGTERM\")\n    } catch {\n      // process may have already exited — ignore\n    }\n  }\n}\n\n// ─── Core ─────────────────────────────────────────────────────────────────────\n\n/**\n * Shared launch/health-check logic for all three browser adapters.\n *\n * Two execution paths:\n * - **local**  — resolves a launch command and spawns a detached child process,\n *   then polls health (existing behaviour, unchanged).\n * - **cloud**  — health-checks `opts.baseUrl` directly; no process is spawned.\n */\nexport async function resolveLaunch(cfg: ResolveLaunchConfig): Promise<BrowserAdapterInstance> {\n  const { handle, opts, label } = cfg\n  const port = opts.port ?? handle.defaultPort\n  const timeoutMs = opts.timeoutMs ?? 60_000\n  const log = opts.log\n  const location = opts.location ?? handle.location ?? \"local\"\n\n  // Persisted config from `agentproto browser install` — merged as lowest-priority\n  // env so that opts.env (explicit caller overrides) always wins.\n  const persistedEnv = await loadPersistedEnv(handle.id)\n\n  const resolvedExtraEnv =\n    typeof cfg.extraEnv === \"function\" ? cfg.extraEnv(port) : cfg.extraEnv\n\n  // ── Cloud path ──────────────────────────────────────────────────────────────\n  if (location === \"cloud\") {\n    const cloudBase = opts.baseUrl\n    if (!cloudBase) {\n      throw new Error(\n        `[${label}] location=\"cloud\" requires opts.baseUrl (the remote service base URL).`\n      )\n    }\n    const healthUrl = cloudBase.replace(/\\/$/, \"\") + handle.healthPath\n    log?.(`[${label}] cloud mode — health-checking ${healthUrl}`)\n    const result = await ensureBrowserProcess({\n      kind: handle.id,\n      healthUrl,\n      launch: () => null,\n      timeoutMs,\n      intervalMs: 1000,\n      log,\n    })\n    return {\n      id: handle.id,\n      port,\n      baseUrl: result.baseUrl,\n      pid: undefined,\n      wasAlreadyRunning: result.wasAlreadyRunning,\n      stop: async () => {},\n    }\n  }\n\n  // ── Local path ──────────────────────────────────────────────────────────────\n  const result = await ensureBrowserProcess({\n    kind: handle.id,\n    healthUrl: `http://127.0.0.1:${port}${handle.healthPath}`,\n    launch() {\n      const cmd = cfg.resolveLocalCmd()\n      if (!cmd) {\n        const nativePlatforms = handle.requires?.nativeLaunchOs\n        const platformHint =\n          nativePlatforms && !nativePlatforms.includes(platform())\n            ? ` (native launcher only available on ${nativePlatforms.join(\", \")}; ` +\n              `set the relevant SERVE_CMD env var on ${platform()} or pass opts.launchCmd)`\n            : \"\"\n        throw new Error(\n          `[${label}] service is not running on :${port} and no launch command is available.${platformHint}`\n        )\n      }\n      log?.(`[${label}] starting: ${[cmd.file, ...cmd.args].join(\" \")}`)\n      if (cmd.isLaunchctl) {\n        // Launcher exits immediately — spawn for side-effect only; pid stays undefined.\n        spawn(cmd.file, cmd.args, {\n          detached: true,\n          stdio: \"ignore\",\n          env: { ...process.env, ...persistedEnv, ...opts.env, ...resolvedExtraEnv },\n        }).unref()\n        return null\n      }\n      const child = spawn(cmd.file, cmd.args, {\n        detached: true,\n        stdio: \"ignore\",\n        env: { ...process.env, ...persistedEnv, ...opts.env, ...resolvedExtraEnv },\n        ...(cmd.cwd ? { cwd: cmd.cwd } : {}),\n      })\n      child.unref()\n      return child\n    },\n    timeoutMs,\n    intervalMs: 1000,\n    log,\n  })\n\n  return {\n    id: handle.id,\n    port,\n    baseUrl: result.baseUrl,\n    pid: result.pid,\n    wasAlreadyRunning: result.wasAlreadyRunning,\n    stop: makeStop(result.pid, cfg.killProcessGroup ?? false),\n  }\n}\n","import { platform } from \"node:os\"\nimport type { BrowserAdapterHandle, BrowserAdapterStartOptions, BrowserAdapterInstance } from \"../types.js\"\nimport { resolveLaunch } from \"../lib/resolve-launch.js\"\n\nfunction resolveCmd(\n  launchCmd: string | undefined,\n  env: Record<string, string> | undefined\n): { file: string; args: string[]; isLaunchctl?: boolean } | null {\n  if (launchCmd) return { file: \"/bin/sh\", args: [\"-c\", launchCmd] }\n  const envCmd = env?.CAMOFOX_SERVE_CMD ?? process.env.CAMOFOX_SERVE_CMD\n  if (envCmd) return { file: \"/bin/sh\", args: [\"-c\", envCmd] }\n  if (platform() === \"darwin\")\n    return { file: \"launchctl\", args: [\"start\", \"com.agentik.camofox\"], isLaunchctl: true }\n  return null\n}\n\nexport const camofoxAdapter: BrowserAdapterHandle = {\n  id: \"camofox\",\n  name: \"Camofox (stealth Firefox headless)\",\n  description:\n    \"Camofox headless stealth Firefox REST API on :9377. Exposes /sessions, /tabs, and /health. Required dependency for the bureau adapter.\",\n  defaultPort: 9377,\n  healthPath: \"/health\",\n\n  location: \"local\",\n\n  install: [\n    {\n      method: \"vendored\",\n      // Shipped via the agentik launchd plist on macOS; on other platforms\n      // install camofox separately and point CAMOFOX_SERVE_CMD at it.\n    },\n  ],\n\n  requires: {\n    // nativeLaunchOs ≠ hard constraint: the adapter is available on all\n    // platforms.  This field only signals that the built-in launchd path\n    // (com.agentik.camofox) exists on macOS; elsewhere CAMOFOX_SERVE_CMD\n    // or opts.launchCmd must be provided.\n    nativeLaunchOs: [\"darwin\"],\n  },\n\n  config: [\n    {\n      id: \"camofox-serve-cmd\",\n      kind: \"prompt\",\n      prompt: \"Shell command to start camofox (leave blank on macOS when using the com.agentik.camofox launchd plist)\",\n      description:\n        \"Required on non-macOS hosts.  On macOS this overrides the default `launchctl start com.agentik.camofox` path.\",\n      type: \"text\",\n      persist: { env: \"CAMOFOX_SERVE_CMD\" },\n    },\n  ],\n\n  async ensure(opts: BrowserAdapterStartOptions): Promise<BrowserAdapterInstance> {\n    return resolveLaunch({\n      handle: this,\n      opts,\n      label: \"camofox\",\n      resolveLocalCmd: () => resolveCmd(opts.launchCmd, opts.env),\n    })\n  },\n}\n","import type { BrowserAdapterHandle, BrowserAdapterStartOptions, BrowserAdapterInstance } from \"../types.js\"\nimport { resolveLaunch } from \"../lib/resolve-launch.js\"\nimport { camofoxAdapter } from \"./camofox.js\"\n\nfunction resolveBureauCmd(\n  launchCmd: string | undefined,\n  env: Record<string, string> | undefined\n): { file: string; args: string[] } {\n  const cmd = launchCmd ?? env?.BUREAU_SERVE_CMD ?? process.env.BUREAU_SERVE_CMD\n  if (cmd) return { file: \"/bin/sh\", args: [\"-c\", cmd] }\n  // Default: `bureau serve` assumed on PATH (installed globally or via the workspace bin).\n  return { file: \"bureau\", args: [\"serve\"] }\n}\n\nexport const bureauAdapter: BrowserAdapterHandle = {\n  id: \"bureau\",\n  name: \"Bureau (Camofox + MCP capability server)\",\n  description:\n    \"Bureau capability server on :8830. Orchestrates Camofox headless first, then \" +\n    \"spawns bureau serve which exposes browser tools as MCP-over-HTTP.\",\n  defaultPort: 8830,\n  healthPath: \"/health\",\n\n  location: \"local\",\n\n  install: [\n    {\n      method: \"path\",\n      // `bureau` CLI must be on PATH (e.g. installed via `npm i -g @agentik/bureau`\n      // or linked from the monorepo workspace bin).\n    },\n  ],\n\n  config: [\n    // bureau inherits camofox's CAMOFOX_SERVE_CMD implicitly — camofoxAdapter.ensure\n    // is called first inside `ensure` and reads that env var itself.\n    {\n      id: \"bureau-serve-cmd\",\n      kind: \"prompt\",\n      prompt: \"Shell command to start bureau (leave blank to use `bureau serve` on PATH)\",\n      type: \"text\",\n      persist: { env: \"BUREAU_SERVE_CMD\" },\n    },\n    {\n      id: \"bureau-port\",\n      kind: \"prompt\",\n      prompt: \"Port bureau should listen on\",\n      type: \"text\",\n      default: \"8830\",\n      persist: { env: \"BUREAU_PORT\" },\n    },\n  ],\n\n  async ensure(opts: BrowserAdapterStartOptions): Promise<BrowserAdapterInstance> {\n    const timeoutMs = opts.timeoutMs ?? 60_000\n    const log = opts.log\n\n    // Camofox must be up before bureau serve can start.\n    const cam = await camofoxAdapter.ensure({\n      port: opts.camofoxPort ?? 9377,\n      launchCmd: undefined,\n      env: opts.env,\n      timeoutMs,\n      log,\n    })\n\n    return resolveLaunch({\n      handle: this,\n      opts,\n      label: \"bureau\",\n      resolveLocalCmd: () => resolveBureauCmd(opts.launchCmd, opts.env),\n      // PORT must reflect the resolved port — extraEnv receives it as a factory arg.\n      extraEnv: (port) => ({\n        CAMOFOX_URL: cam.baseUrl,\n        PORT: String(port),\n      }),\n    })\n  },\n}\n","import type { BrowserAdapterHandle, BrowserAdapterStartOptions, BrowserAdapterInstance } from \"../types.js\"\nimport { resolveLaunch } from \"../lib/resolve-launch.js\"\n\nfunction resolveCmd(\n  launchCmd: string | undefined,\n  env: Record<string, string> | undefined,\n  log: ((s: string) => void) | undefined\n): { file: string; args: string[]; cwd?: string } {\n  if (launchCmd) return { file: \"/bin/sh\", args: [\"-c\", launchCmd] }\n  const envCmd = env?.CHROMIUM_SERVE_CMD ?? process.env.CHROMIUM_SERVE_CMD\n  if (envCmd) return { file: \"/bin/sh\", args: [\"-c\", envCmd] }\n\n  // Default pnpm filter command — requires the workspace root as cwd.\n  const cwd = resolveCwd(env, log)\n  return { file: \"/bin/sh\", args: [\"-c\", \"pnpm --filter=@browser/service start\"], cwd }\n}\n\n/**\n * Resolve the working directory for the spawned browser-service process.\n *\n * Priority: CHROMIUM_SERVE_CWD from caller env > same var from process env >\n * undefined (spawn inherits the daemon's own cwd, which is the pnpm workspace\n * root when the daemon was started normally). When the default pnpm --filter\n * command is used and no cwd is resolvable, a warning is emitted — pnpm needs\n * the workspace root to match the filter.\n */\nfunction resolveCwd(\n  env: Record<string, string> | undefined,\n  log: ((s: string) => void) | undefined\n): string | undefined {\n  const explicit = env?.CHROMIUM_SERVE_CWD ?? process.env.CHROMIUM_SERVE_CWD\n  if (explicit) return explicit\n  log?.(\n    \"[chromium] warning: CHROMIUM_SERVE_CWD is not set; relying on daemon cwd for \" +\n      \"`pnpm --filter=@browser/service start`. Set CHROMIUM_SERVE_CWD or run the daemon \" +\n      \"from the repo root, or override with CHROMIUM_SERVE_CMD.\"\n  )\n  return undefined\n}\n\nexport const chromiumAdapter: BrowserAdapterHandle = {\n  id: \"chromium\",\n  name: \"Chromium Browser Service\",\n  description:\n    \"Heavy Chromium webservice (projects/browser/apps/service) on :3200. Exposes /healthz, /readyz, REST session routes, and a CDP WebSocket proxy.\",\n  defaultPort: 3200,\n  healthPath: \"/healthz\",\n\n  location: \"local\",\n\n  install: [\n    {\n      method: \"path\",\n      // Local: `pnpm --filter=@browser/service start` from the monorepo root,\n      // or set CHROMIUM_SERVE_CMD / CHROMIUM_SERVE_CWD to point at a custom launcher.\n      // Cloud variant (future — not yet wired into ensure):\n      //   method: \"cloud\", url: process.env.BROWSER_SERVICE_URL, secret: \"BROWSER_SERVICE_KEY\"\n    },\n  ],\n\n  config: [\n    {\n      id: \"chromium-serve-cmd\",\n      kind: \"prompt\",\n      prompt: \"Shell command to start the browser service (default: pnpm --filter=@browser/service start)\",\n      description:\n        \"Override CHROMIUM_SERVE_CMD.  When blank, the default pnpm filter command is used and \" +\n        \"CHROMIUM_SERVE_CWD must point to the monorepo root.\",\n      type: \"text\",\n      persist: { env: \"CHROMIUM_SERVE_CMD\" },\n    },\n    {\n      id: \"chromium-serve-cwd\",\n      kind: \"prompt\",\n      prompt: \"Working directory for the browser service (monorepo root required for the pnpm filter command)\",\n      type: \"text\",\n      persist: { env: \"CHROMIUM_SERVE_CWD\" },\n    },\n    // Future cloud step (T9+):\n    // { id: \"chromium-cloud-url\",   kind: \"prompt\", prompt: \"Remote browser-service URL\", type: \"text\",   persist: { env: \"BROWSER_SERVICE_URL\" } },\n    // { id: \"chromium-cloud-token\", kind: \"prompt\", prompt: \"X-Internal-Key token\",        type: \"secret\", persist: { env: \"BROWSER_SERVICE_KEY\" } },\n  ],\n\n  async ensure(opts: BrowserAdapterStartOptions): Promise<BrowserAdapterInstance> {\n    return resolveLaunch({\n      handle: this,\n      opts,\n      label: \"chromium\",\n      resolveLocalCmd: () => resolveCmd(opts.launchCmd, opts.env, opts.log),\n      // Kill the whole process group so the pnpm-forked node child is not orphaned.\n      killProcessGroup: true,\n    })\n  },\n}\n","export type {\n  BrowserAdapterHandle,\n  BrowserAdapterStartOptions,\n  BrowserAdapterInstance,\n} from \"./types.js\"\n\nexport { camofoxAdapter } from \"./adapters/camofox.js\"\nexport { bureauAdapter } from \"./adapters/bureau.js\"\nexport { chromiumAdapter } from \"./adapters/chromium.js\"\n\nimport { camofoxAdapter } from \"./adapters/camofox.js\"\nimport { bureauAdapter } from \"./adapters/bureau.js\"\nimport { chromiumAdapter } from \"./adapters/chromium.js\"\nimport type { BrowserAdapterHandle } from \"./types.js\"\n\nexport const browserAdapters: Record<string, BrowserAdapterHandle> = {\n  camofox: camofoxAdapter,\n  bureau: bureauAdapter,\n  chromium: chromiumAdapter,\n}\n\nexport function getBrowserAdapter(id: string): BrowserAdapterHandle | undefined {\n  return browserAdapters[id]\n}\n"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@agentproto/adapter-browser",
+  "version": "0.1.0-alpha.0",
+  "description": "@agentproto/adapter-browser — browser service adapters for agentproto. Manages Camofox (stealth Firefox) and Bureau (Camofox + MCP capability server) as first-class process handles: health-check, idempotent launch, structured stop.",
+  "keywords": [
+    "agentproto",
+    "browser",
+    "camofox",
+    "bureau",
+    "adapter"
+  ],
+  "homepage": "https://agentproto.sh",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "adapters/browser"
+  },
+  "bugs": {
+    "url": "https://github.com/agentproto/ts/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentproto/browser-process": "0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}