@agentproto/adapter-browser 0.1.0-alpha.0 → 0.1.0

package/dist/index.d.ts

@@ -134,6 +134,20 @@ interface BrowserAdapterStartOptions {
      * Required (and only used) when `location === "cloud"`.
      */
     baseUrl?: string;
+    /**
+     * Override the binary path used for the local spawn.
+     * When set, takes precedence over the adapter's own resolved binary path.
+     * Only used on the local path (`location !== "cloud"`).
+     */
+    binPath?: string;
+    /**
+     * Opt-in non-blocking cold start. When set, `ensure` waits only this many
+     * milliseconds for the freshly-spawned service to become healthy. If it does
+     * not, `ensure` returns promptly with `status: "starting"` while health
+     * convergence continues in the background. When unset (default), `ensure`
+     * blocks up to `timeoutMs` (existing behaviour).
+     */
+    initialWaitMs?: number;
 }
 interface BrowserAdapterInstance {
     id: string;
@@ -145,6 +159,14 @@ interface BrowserAdapterInstance {
      */
     pid?: number;
     wasAlreadyRunning: boolean;
+    /**
+     * Whether the service is confirmed healthy at return time. Always true on
+     * the warm path and on a blocking cold start. Only `false` when
+     * `opts.initialWaitMs` was set and the service had not converged within the
+     * bounded window — health-wait continues in the background and
+     * `browser_status` / `list_browsers` will flip it to running once up.
+     */
+    healthy: boolean;
     /**
      * Best-effort stop. Sends SIGTERM to `pid` if known; otherwise a no-op
      * (externally-managed services must be stopped via their own manager).

package/dist/index.mjs

@@ -59,7 +59,8 @@ async function resolveLaunch(cfg) {
       launch: () => null,
       timeoutMs,
       intervalMs: 1e3,
-      log
+      log,
+      ...opts.initialWaitMs !== void 0 ? { initialWaitMs: opts.initialWaitMs } : {}
     });
     return {
       id: handle.id,
@@ -67,6 +68,7 @@ async function resolveLaunch(cfg) {
       baseUrl: result2.baseUrl,
       pid: void 0,
       wasAlreadyRunning: result2.wasAlreadyRunning,
+      healthy: result2.healthy,
       stop: async () => {
       }
     };
@@ -83,16 +85,17 @@ async function resolveLaunch(cfg) {
           `[${label}] service is not running on :${port} and no launch command is available.${platformHint}`
         );
       }
-      log?.(`[${label}] starting: ${[cmd.file, ...cmd.args].join(" ")}`);
+      const cmdFile = opts.binPath ?? cmd.file;
+      log?.(`[${label}] starting: ${[cmdFile, ...cmd.args].join(" ")}`);
       if (cmd.isLaunchctl) {
-        spawn(cmd.file, cmd.args, {
+        spawn(cmdFile, cmd.args, {
           detached: true,
           stdio: "ignore",
           env: { ...process.env, ...persistedEnv, ...opts.env, ...resolvedExtraEnv }
         }).unref();
         return null;
       }
-      const child = spawn(cmd.file, cmd.args, {
+      const child = spawn(cmdFile, cmd.args, {
         detached: true,
         stdio: "ignore",
         env: { ...process.env, ...persistedEnv, ...opts.env, ...resolvedExtraEnv },
@@ -103,7 +106,8 @@ async function resolveLaunch(cfg) {
     },
     timeoutMs,
     intervalMs: 1e3,
-    log
+    log,
+    ...opts.initialWaitMs !== void 0 ? { initialWaitMs: opts.initialWaitMs } : {}
   });
   return {
     id: handle.id,
@@ -111,6 +115,7 @@ async function resolveLaunch(cfg) {
     baseUrl: result.baseUrl,
     pid: result.pid,
     wasAlreadyRunning: result.wasAlreadyRunning,
+    healthy: result.healthy,
     stop: makeStop(result.pid, cfg.killProcessGroup ?? false)
   };
 }
@@ -234,13 +239,13 @@ function resolveCmd2(launchCmd, env, log) {
   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 };
+  return { file: "/bin/sh", args: ["-c", "pnpm --filter=@agstudio/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."
+    "[chromium] warning: CHROMIUM_SERVE_CWD is not set; relying on daemon cwd for `pnpm --filter=@agstudio/browser-service start`. Set CHROMIUM_SERVE_CWD or run the daemon from the repo root, or override with CHROMIUM_SERVE_CMD."
   );
   return void 0;
 }
@@ -254,7 +259,7 @@ var chromiumAdapter = {
   install: [
     {
       method: "path"
-      // Local: `pnpm --filter=@browser/service start` from the monorepo root,
+      // Local: `pnpm --filter=@agstudio/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"
@@ -264,7 +269,7 @@ var chromiumAdapter = {
     {
       id: "chromium-serve-cmd",
       kind: "prompt",
-      prompt: "Shell command to start the browser service (default: pnpm --filter=@browser/service start)",
+      prompt: "Shell command to start the browser service (default: pnpm --filter=@agstudio/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" }

package/dist/index.mjs.map

@@ -1 +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":";;;;;;;;;;;AAgBA,eAAe,iBAAiB,SAAA,EAAoD;AAClF,EAAA,MAAM,IAAA,GAAO,QAAQ,GAAA,CAAI,iBAAiB,KAAK,IAAA,CAAK,OAAA,IAAW,aAAa,CAAA;AAC5E,EAAA,MAAM,aAAa,IAAA,CAAK,IAAA,EAAM,kBAAA,EAAoB,CAAA,EAAG,SAAS,CAAA,KAAA,CAAO,CAAA;AACrE,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,QAAA,CAAS,UAAA,EAAY,MAAM,CAAA;AAC7C,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAC7B,IAAA,OAAO,MAAA,CAAO,aAAa,EAAC;AAAA,EAC9B,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACF;AA2CA,SAAS,QAAA,CAAS,KAAyB,YAAA,EAA4C;AACrF,EAAA,OAAO,YAAY;AACjB,IAAA,IAAI,CAAC,GAAA,EAAK;AACV,IAAA,IAAI,YAAA,EAAc;AAChB,MAAA,IAAI;AACF,QAAA,OAAA,CAAQ,IAAA,CAAK,CAAC,GAAA,EAAK,SAAS,CAAA;AAC5B,QAAA;AAAA,MACF,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AACA,IAAA,IAAI;AACF,MAAA,OAAA,CAAQ,IAAA,CAAK,KAAK,SAAS,CAAA;AAAA,IAC7B,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,CAAA;AACF;AAYA,eAAsB,cAAc,GAAA,EAA2D;AAC7F,EAAA,MAAM,EAAE,MAAA,EAAQ,IAAA,EAAM,KAAA,EAAM,GAAI,GAAA;AAChC,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,IAAA,IAAQ,MAAA,CAAO,WAAA;AACjC,EAAA,MAAM,SAAA,GAAY,KAAK,SAAA,IAAa,GAAA;AACpC,EAAA,MAAM,MAAM,IAAA,CAAK,GAAA;AACjB,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,IAAY,MAAA,CAAO,QAAA,IAAY,OAAA;AAIrD,EAAA,MAAM,YAAA,GAAe,MAAM,gBAAA,CAAiB,MAAA,CAAO,EAAE,CAAA;AAErD,EAAA,MAAM,gBAAA,GACJ,OAAO,GAAA,CAAI,QAAA,KAAa,aAAa,GAAA,CAAI,QAAA,CAAS,IAAI,CAAA,GAAI,GAAA,CAAI,QAAA;AAGhE,EAAA,IAAI,aAAa,OAAA,EAAS;AACxB,IAAA,MAAM,YAAY,IAAA,CAAK,OAAA;AACvB,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,IAAI,KAAK,CAAA,uEAAA;AAAA,OACX;AAAA,IACF;AACA,IAAA,MAAM,YAAY,SAAA,CAAU,OAAA,CAAQ,KAAA,EAAO,EAAE,IAAI,MAAA,CAAO,UAAA;AACxD,IAAA,GAAA,GAAM,CAAA,CAAA,EAAI,KAAK,CAAA,oCAAA,EAAkC,SAAS,CAAA,CAAE,CAAA;AAC5D,IAAA,MAAMA,OAAAA,GAAS,MAAM,oBAAA,CAAqB;AAAA,MACxC,MAAM,MAAA,CAAO,EAAA;AAAA,MACb,SAAA;AAAA,MACA,QAAQ,MAAM,IAAA;AAAA,MACd,SAAA;AAAA,MACA,UAAA,EAAY,GAAA;AAAA,MACZ;AAAA,KACD,CAAA;AACD,IAAA,OAAO;AAAA,MACL,IAAI,MAAA,CAAO,EAAA;AAAA,MACX,IAAA;AAAA,MACA,SAASA,OAAAA,CAAO,OAAA;AAAA,MAChB,GAAA,EAAK,MAAA;AAAA,MACL,mBAAmBA,OAAAA,CAAO,iBAAA;AAAA,MAC1B,MAAM,YAAY;AAAA,MAAC;AAAA,KACrB;AAAA,EACF;AAGA,EAAA,MAAM,MAAA,GAAS,MAAM,oBAAA,CAAqB;AAAA,IACxC,MAAM,MAAA,CAAO,EAAA;AAAA,IACb,SAAA,EAAW,CAAA,iBAAA,EAAoB,IAAI,CAAA,EAAG,OAAO,UAAU,CAAA,CAAA;AAAA,IACvD,MAAA,GAAS;AACP,MAAA,MAAM,GAAA,GAAM,IAAI,eAAA,EAAgB;AAChC,MAAA,IAAI,CAAC,GAAA,EAAK;AACR,QAAA,MAAM,eAAA,GAAkB,OAAO,QAAA,EAAU,cAAA;AACzC,QAAA,MAAM,eACJ,eAAA,IAAmB,CAAC,eAAA,CAAgB,QAAA,CAAS,UAAU,CAAA,GACnD,CAAA,oCAAA,EAAuC,eAAA,CAAgB,KAAK,IAAI,CAAC,CAAA,wCAAA,EACxB,QAAA,EAAU,CAAA,wBAAA,CAAA,GACnD,EAAA;AACN,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,CAAA,EAAI,KAAK,CAAA,6BAAA,EAAgC,IAAI,uCAAuC,YAAY,CAAA;AAAA,SAClG;AAAA,MACF;AACA,MAAA,GAAA,GAAM,CAAA,CAAA,EAAI,KAAK,CAAA,YAAA,EAAe,CAAC,GAAA,CAAI,IAAA,EAAM,GAAG,GAAA,CAAI,IAAI,CAAA,CAAE,IAAA,CAAK,GAAG,CAAC,CAAA,CAAE,CAAA;AACjE,MAAA,IAAI,IAAI,WAAA,EAAa;AAEnB,QAAA,KAAA,CAAM,GAAA,CAAI,IAAA,EAAM,GAAA,CAAI,IAAA,EAAM;AAAA,UACxB,QAAA,EAAU,IAAA;AAAA,UACV,KAAA,EAAO,QAAA;AAAA,UACP,GAAA,EAAK,EAAE,GAAG,OAAA,CAAQ,GAAA,EAAK,GAAG,YAAA,EAAc,GAAG,IAAA,CAAK,GAAA,EAAK,GAAG,gBAAA;AAAiB,SAC1E,EAAE,KAAA,EAAM;AACT,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,GAAA,CAAI,IAAA,EAAM,IAAI,IAAA,EAAM;AAAA,QACtC,QAAA,EAAU,IAAA;AAAA,QACV,KAAA,EAAO,QAAA;AAAA,QACP,GAAA,EAAK,EAAE,GAAG,OAAA,CAAQ,GAAA,EAAK,GAAG,YAAA,EAAc,GAAG,IAAA,CAAK,GAAA,EAAK,GAAG,gBAAA,EAAiB;AAAA,QACzE,GAAI,IAAI,GAAA,GAAM,EAAE,KAAK,GAAA,CAAI,GAAA,KAAQ;AAAC,OACnC,CAAA;AACD,MAAA,KAAA,CAAM,KAAA,EAAM;AACZ,MAAA,OAAO,KAAA;AAAA,IACT,CAAA;AAAA,IACA,SAAA;AAAA,IACA,UAAA,EAAY,GAAA;AAAA,IACZ;AAAA,GACD,CAAA;AAED,EAAA,OAAO;AAAA,IACL,IAAI,MAAA,CAAO,EAAA;AAAA,IACX,IAAA;AAAA,IACA,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,KAAK,MAAA,CAAO,GAAA;AAAA,IACZ,mBAAmB,MAAA,CAAO,iBAAA;AAAA,IAC1B,MAAM,QAAA,CAAS,MAAA,CAAO,GAAA,EAAK,GAAA,CAAI,oBAAoB,KAAK;AAAA,GAC1D;AACF;;;ACzLA,SAAS,UAAA,CACP,WACA,GAAA,EACgE;AAChE,EAAA,IAAI,SAAA,SAAkB,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,CAAC,IAAA,EAAM,SAAS,CAAA,EAAE;AACjE,EAAA,MAAM,MAAA,GAAS,GAAA,EAAK,iBAAA,IAAqB,OAAA,CAAQ,GAAA,CAAI,iBAAA;AACrD,EAAA,IAAI,MAAA,SAAe,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,CAAC,IAAA,EAAM,MAAM,CAAA,EAAE;AAC3D,EAAA,IAAIC,UAAS,KAAM,QAAA;AACjB,IAAA,OAAO,EAAE,MAAM,WAAA,EAAa,IAAA,EAAM,CAAC,OAAA,EAAS,qBAAqB,CAAA,EAAG,WAAA,EAAa,IAAA,EAAK;AACxF,EAAA,OAAO,IAAA;AACT;AAEO,IAAM,cAAA,GAAuC;AAAA,EAClD,EAAA,EAAI,SAAA;AAAA,EACJ,IAAA,EAAM,oCAAA;AAAA,EACN,WAAA,EACE,wIAAA;AAAA,EACF,WAAA,EAAa,IAAA;AAAA,EACb,UAAA,EAAY,SAAA;AAAA,EAEZ,QAAA,EAAU,OAAA;AAAA,EAEV,OAAA,EAAS;AAAA,IACP;AAAA,MACE,MAAA,EAAQ;AAAA;AAAA;AAAA;AAGV,GACF;AAAA,EAEA,QAAA,EAAU;AAAA;AAAA;AAAA;AAAA;AAAA,IAKR,cAAA,EAAgB,CAAC,QAAQ;AAAA,GAC3B;AAAA,EAEA,MAAA,EAAQ;AAAA,IACN;AAAA,MACE,EAAA,EAAI,mBAAA;AAAA,MACJ,IAAA,EAAM,QAAA;AAAA,MACN,MAAA,EAAQ,wGAAA;AAAA,MACR,WAAA,EACE,+GAAA;AAAA,MACF,IAAA,EAAM,MAAA;AAAA,MACN,OAAA,EAAS,EAAE,GAAA,EAAK,mBAAA;AAAoB;AACtC,GACF;AAAA,EAEA,MAAM,OAAO,IAAA,EAAmE;AAC9E,IAAA,OAAO,aAAA,CAAc;AAAA,MACnB,MAAA,EAAQ,IAAA;AAAA,MACR,IAAA;AAAA,MACA,KAAA,EAAO,SAAA;AAAA,MACP,iBAAiB,MAAM,UAAA,CAAW,IAAA,CAAK,SAAA,EAAW,KAAK,GAAG;AAAA,KAC3D,CAAA;AAAA,EACH;AACF;;;AC1DA,SAAS,gBAAA,CACP,WACA,GAAA,EACkC;AAClC,EAAA,MAAM,GAAA,GAAM,SAAA,IAAa,GAAA,EAAK,gBAAA,IAAoB,QAAQ,GAAA,CAAI,gBAAA;AAC9D,EAAA,IAAI,GAAA,SAAY,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,CAAC,IAAA,EAAM,GAAG,CAAA,EAAE;AAErD,EAAA,OAAO,EAAE,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,CAAC,OAAO,CAAA,EAAE;AAC3C;AAEO,IAAM,aAAA,GAAsC;AAAA,EACjD,EAAA,EAAI,QAAA;AAAA,EACJ,IAAA,EAAM,0CAAA;AAAA,EACN,WAAA,EACE,gJAAA;AAAA,EAEF,WAAA,EAAa,IAAA;AAAA,EACb,UAAA,EAAY,SAAA;AAAA,EAEZ,QAAA,EAAU,OAAA;AAAA,EAEV,OAAA,EAAS;AAAA,IACP;AAAA,MACE,MAAA,EAAQ;AAAA;AAAA;AAAA;AAGV,GACF;AAAA,EAEA,MAAA,EAAQ;AAAA;AAAA;AAAA,IAGN;AAAA,MACE,EAAA,EAAI,kBAAA;AAAA,MACJ,IAAA,EAAM,QAAA;AAAA,MACN,MAAA,EAAQ,2EAAA;AAAA,MACR,IAAA,EAAM,MAAA;AAAA,MACN,OAAA,EAAS,EAAE,GAAA,EAAK,kBAAA;AAAmB,KACrC;AAAA,IACA;AAAA,MACE,EAAA,EAAI,aAAA;AAAA,MACJ,IAAA,EAAM,QAAA;AAAA,MACN,MAAA,EAAQ,8BAAA;AAAA,MACR,IAAA,EAAM,MAAA;AAAA,MACN,OAAA,EAAS,MAAA;AAAA,MACT,OAAA,EAAS,EAAE,GAAA,EAAK,aAAA;AAAc;AAChC,GACF;AAAA,EAEA,MAAM,OAAO,IAAA,EAAmE;AAC9E,IAAA,MAAM,SAAA,GAAY,KAAK,SAAA,IAAa,GAAA;AACpC,IAAA,MAAM,MAAM,IAAA,CAAK,GAAA;AAGjB,IAAA,MAAM,GAAA,GAAM,MAAM,cAAA,CAAe,MAAA,CAAO;AAAA,MACtC,IAAA,EAAM,KAAK,WAAA,IAAe,IAAA;AAAA,MAC1B,SAAA,EAAW,MAAA;AAAA,MACX,KAAK,IAAA,CAAK,GAAA;AAAA,MACV,SAAA;AAAA,MACA;AAAA,KACD,CAAA;AAED,IAAA,OAAO,aAAA,CAAc;AAAA,MACnB,MAAA,EAAQ,IAAA;AAAA,MACR,IAAA;AAAA,MACA,KAAA,EAAO,QAAA;AAAA,MACP,iBAAiB,MAAM,gBAAA,CAAiB,IAAA,CAAK,SAAA,EAAW,KAAK,GAAG,CAAA;AAAA;AAAA,MAEhE,QAAA,EAAU,CAAC,IAAA,MAAU;AAAA,QACnB,aAAa,GAAA,CAAI,OAAA;AAAA,QACjB,IAAA,EAAM,OAAO,IAAI;AAAA,OACnB;AAAA,KACD,CAAA;AAAA,EACH;AACF;;;AC3EA,SAASC,WAAAA,CACP,SAAA,EACA,GAAA,EACA,GAAA,EACgD;AAChD,EAAA,IAAI,SAAA,SAAkB,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,CAAC,IAAA,EAAM,SAAS,CAAA,EAAE;AACjE,EAAA,MAAM,MAAA,GAAS,GAAA,EAAK,kBAAA,IAAsB,OAAA,CAAQ,GAAA,CAAI,kBAAA;AACtD,EAAA,IAAI,MAAA,SAAe,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,CAAC,IAAA,EAAM,MAAM,CAAA,EAAE;AAG3D,EAAA,MAAM,GAAA,GAAM,UAAA,CAAW,GAAA,EAAK,GAAG,CAAA;AAC/B,EAAA,OAAO,EAAE,MAAM,SAAA,EAAW,IAAA,EAAM,CAAC,IAAA,EAAM,sCAAsC,GAAG,GAAA,EAAI;AACtF;AAWA,SAAS,UAAA,CACP,KACA,GAAA,EACoB;AACpB,EAAA,MAAM,QAAA,GAAW,GAAA,EAAK,kBAAA,IAAsB,OAAA,CAAQ,GAAA,CAAI,kBAAA;AACxD,EAAA,IAAI,UAAU,OAAO,QAAA;AACrB,EAAA,GAAA;AAAA,IACE;AAAA,GAGF;AACA,EAAA,OAAO,MAAA;AACT;AAEO,IAAM,eAAA,GAAwC;AAAA,EACnD,EAAA,EAAI,UAAA;AAAA,EACJ,IAAA,EAAM,0BAAA;AAAA,EACN,WAAA,EACE,gJAAA;AAAA,EACF,WAAA,EAAa,IAAA;AAAA,EACb,UAAA,EAAY,UAAA;AAAA,EAEZ,QAAA,EAAU,OAAA;AAAA,EAEV,OAAA,EAAS;AAAA,IACP;AAAA,MACE,MAAA,EAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAKV,GACF;AAAA,EAEA,MAAA,EAAQ;AAAA,IACN;AAAA,MACE,EAAA,EAAI,oBAAA;AAAA,MACJ,IAAA,EAAM,QAAA;AAAA,MACN,MAAA,EAAQ,4FAAA;AAAA,MACR,WAAA,EACE,2IAAA;AAAA,MAEF,IAAA,EAAM,MAAA;AAAA,MACN,OAAA,EAAS,EAAE,GAAA,EAAK,oBAAA;AAAqB,KACvC;AAAA,IACA;AAAA,MACE,EAAA,EAAI,oBAAA;AAAA,MACJ,IAAA,EAAM,QAAA;AAAA,MACN,MAAA,EAAQ,gGAAA;AAAA,MACR,IAAA,EAAM,MAAA;AAAA,MACN,OAAA,EAAS,EAAE,GAAA,EAAK,oBAAA;AAAqB;AACvC;AAAA;AAAA;AAAA,GAIF;AAAA,EAEA,MAAM,OAAO,IAAA,EAAmE;AAC9E,IAAA,OAAO,aAAA,CAAc;AAAA,MACnB,MAAA,EAAQ,IAAA;AAAA,MACR,IAAA;AAAA,MACA,KAAA,EAAO,UAAA;AAAA,MACP,eAAA,EAAiB,MAAMA,WAAAA,CAAW,IAAA,CAAK,WAAW,IAAA,CAAK,GAAA,EAAK,KAAK,GAAG,CAAA;AAAA;AAAA,MAEpE,gBAAA,EAAkB;AAAA,KACnB,CAAA;AAAA,EACH;AACF;;;AC9EO,IAAM,eAAA,GAAwD;AAAA,EACnE,OAAA,EAAS,cAAA;AAAA,EACT,MAAA,EAAQ,aAAA;AAAA,EACR,QAAA,EAAU;AACZ;AAEO,SAAS,kBAAkB,EAAA,EAA8C;AAC9E,EAAA,OAAO,gBAAgB,EAAE,CAAA;AAC3B","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"]}
+{"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      ...(opts.initialWaitMs !== undefined ? { initialWaitMs: opts.initialWaitMs } : {}),\n    })\n    return {\n      id: handle.id,\n      port,\n      baseUrl: result.baseUrl,\n      pid: undefined,\n      wasAlreadyRunning: result.wasAlreadyRunning,\n      healthy: result.healthy,\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      const cmdFile = opts.binPath ?? cmd.file\n      log?.(`[${label}] starting: ${[cmdFile, ...cmd.args].join(\" \")}`)\n      if (cmd.isLaunchctl) {\n        // Launcher exits immediately — spawn for side-effect only; pid stays undefined.\n        spawn(cmdFile, 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(cmdFile, 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    ...(opts.initialWaitMs !== undefined ? { initialWaitMs: opts.initialWaitMs } : {}),\n  })\n\n  return {\n    id: handle.id,\n    port,\n    baseUrl: result.baseUrl,\n    pid: result.pid,\n    wasAlreadyRunning: result.wasAlreadyRunning,\n    healthy: result.healthy,\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\nexport function 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=@agstudio/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=@agstudio/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=@agstudio/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=@agstudio/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

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/adapter-browser",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.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",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@agentproto/browser-process": "0.1.0-alpha.0"
+    "@agentproto/browser-process": "0.1.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",