@agentproto/runtime 3.6.1 → 4.0.0

package/dist/{context-continuity-ib9_bVYM.d.ts → context-continuity-Bn99UtVC.d.ts}

@@ -1,3 +1,42 @@
+import { AcpMcpServer } from '@agentproto/acp';
+import { SandboxMode } from '@agentproto/command-sandbox';
+
+/**
+ * `agent_start({ browser: "headless" })` — an isolated headless Chrome for
+ * one spawned agent, mounted as a per-session stdio MCP server
+ * (`chrome-devtools-mcp --headless --isolated`, see
+ * `@agentproto/plugin-local-browser`'s `buildHeadlessBrowserMcpEntry`).
+ *
+ * The server is a child of the adapter process, so it inherits the session's
+ * `commandSandbox` confinement and normally dies with the adapter (stdin EOF,
+ * and Chrome exits when its pipe closes). On `session:exited`,
+ * `sweepSessionBrowser` does two things:
+ *   - kills anything still carrying the session's `--agentproto-session=<id>`
+ *     Chrome marker, in case an adapter never exited or never closed its MCP
+ *     children;
+ *   - deletes the session's profile dir, `$TMPDIR/agentproto-browser/<id>`.
+ * The profile is caller-owned rather than `--isolated`, because `--isolated`
+ * only cleans up on a graceful `browser.close()`; observed live, a killed
+ * session left its puppeteer temp profile behind.
+ */
+
+/** `agent_start.browser`. `false` (the default) mounts nothing. */
+type SpawnBrowserMode = "headless" | false;
+interface HeadlessBrowserMount {
+    entry: AcpMcpServer;
+    /** Read grants the adapter's `commandSandbox` needs for the MCP server +
+     *  Chrome (threaded as `additionalReadPaths`). */
+    readPaths: string[];
+}
+interface ResolveHeadlessBrowserInput {
+    sessionId: string;
+    cwd: string;
+    /** The spawn's explicit `commandSandbox`; `undefined` falls back to the
+     *  workspace's `adapterSpawn` config, like the driver does. */
+    commandSandbox?: SandboxMode;
+}
+type ResolveHeadlessBrowser = (input: ResolveHeadlessBrowserInput) => Promise<HeadlessBrowserMount>;
+
 /**
  * Canonical context-continuity policy for long-running agent sessions.
  *
@@ -62,4 +101,4 @@ interface ResolvedContextContinuityPolicy extends ContextContinuityThresholds, R
     label: string;
 }
 
-export type { ContextContinuityPolicy as C, ResolvedContextContinuityPolicy as R };
+export type { ContextContinuityPolicy as C, ResolveHeadlessBrowser as R, SpawnBrowserMode as S, ResolvedContextContinuityPolicy as a };

package/dist/{heartbeat-COGpMrJS.d.ts → heartbeat-BJtxbDb9.d.ts}

@@ -47,7 +47,19 @@ interface RemoteLogEvent {
     at: string;
     line: string;
 }
-type RuntimeEvent = BootEvent | HeartbeatFiredEvent | HeartbeatErrorEvent | ConvTurnEvent | RemoteLogEvent;
+/**
+ * Fired once per successful `config_set` / `PATCH /config` write to
+ * `~/.agentproto/config.json` (config-tools.ts). Never carries a secret
+ * key's value — only the dotted path(s) touched and whether the change
+ * takes effect immediately or needs a restart.
+ */
+interface ConfigChangedEvent {
+    type: "config:changed";
+    at: string;
+    keys: string[];
+    applied: "hot" | "restart-required";
+}
+type RuntimeEvent = BootEvent | HeartbeatFiredEvent | HeartbeatErrorEvent | ConvTurnEvent | RemoteLogEvent | ConfigChangedEvent;
 interface RuntimeEvents {
     on<E extends RuntimeEvent["type"]>(type: E, handler: (ev: Extract<RuntimeEvent, {
         type: E;

package/dist/heartbeat.d.ts

@@ -1,2 +1,2 @@
 import './conversations.js';
-export { B as BuildHeartbeatAgent, H as HeartbeatAgent, a as HeartbeatRunner, c as HeartbeatRunnerOptions, p as parseDuration, s as startHeartbeat } from './heartbeat-COGpMrJS.js';
+export { B as BuildHeartbeatAgent, H as HeartbeatAgent, a as HeartbeatRunner, c as HeartbeatRunnerOptions, p as parseDuration, s as startHeartbeat } from './heartbeat-BJtxbDb9.js';