@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/planner.js

@@ -34,9 +34,9 @@ const plannerResponseSchema = z.object({
         .max(5),
     rationale: z.string().default(''),
 });
-export async function planChain(repoRoot, task) {
+export async function planChain(repoRoot, task, builtin = []) {
     const [skills, config, verifyCommands] = await Promise.all([
-        discoverSkills(repoRoot),
+        discoverSkills(repoRoot, { builtin }),
         loadConfig(repoRoot),
         detectVerifyCommands(repoRoot),
     ]);
@@ -49,17 +49,20 @@ export async function planChain(repoRoot, task) {
     const plannerModel = config.defaultRunner === 'claude' ? config.plannerModel : undefined;
     // Plan under the SAME agent account this project's tasks run on (spec
     // 2026-07-29-agent-profiles). Without this the planner would quietly bill the personal
-    // subscription for a project the user pointed at their work account.
-    const { env: profileEnv } = await resolveProfileEnvForRoot(repoRoot, config.defaultRunner);
+    // subscription for a project the user pointed at their work account. An account cezar refuses
+    // to spawn (`AgentAccountUnavailableError`) plans nothing and takes the fallback below, for the
+    // same reason.
+    const account = await resolveProfileEnvForRoot(repoRoot, config.defaultRunner).catch(() => null);
+    const profileEnv = account?.env ?? {};
     // One retry on an unparseable answer; a runner error goes straight to fallback.
-    for (let attempt = 0; attempt < 2; attempt++) {
+    for (let attempt = 0; account !== null && attempt < 2; attempt++) {
         let text;
         try {
             const result = await runner.run({
                 systemPrompt: PLANNER_SYSTEM_PROMPT,
                 userPrompt,
                 cwd: repoRoot,
-                allowedTools: [],
+                toolGrant: { kind: 'explicit', tools: [] },
                 ...(Object.keys(profileEnv).length > 0 ? { env: profileEnv } : {}),
                 model: plannerModel,
                 timeoutMs: PLANNER_TIMEOUT_MS,

package/dist/planner.js.map

@@ -1 +1 @@
-{"version":3,"file":"planner.js","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"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"}

package/dist/preview/agent-address.d.ts

@@ -0,0 +1,34 @@
+import type { AgentGrant, RunContext } from './host.ts';
+import type { PreviewHostLike } from './registration.ts';
+/**
+ * The agent's preview browser address (hearsay-tools/cezarion#784, spec
+ * 2026-10-26-preview-agent-cdp): the cockpit's own bound origin as `ws:`, at the CDP proxy route,
+ * with the grant's token. Undefined when the origin is not a URL.
+ */
+export declare function previewCdpUrl(cockpitOrigin: string, token: string): string | undefined;
+/**
+ * A session's tool capability with the CDP address added: `CEZ_PREVIEW_CDP_URL` joins its env, and
+ * its `revoke` also revokes the grant, so every site that ends the tools closes the agent's browser
+ * sockets too.
+ */
+export declare function withPreviewCdp<S extends {
+    env: Record<string, string>;
+    revoke(): void;
+}>(session: S, grant: AgentGrant, cockpitOrigin: string): S;
+/**
+ * `withPreviewCdp` behind its gate: only with `CEZ_PREVIEW=1`, a host that can grant, a cockpit
+ * origin (none under `cez run`) and a worktree. Every runner's session goes through here, so the
+ * harness parity cell R125 reads the same decision RunManager makes.
+ */
+export declare function previewCdpSession<S extends {
+    env: Record<string, string>;
+    revoke(): void;
+}>(session: S, opts: {
+    host?: Pick<PreviewHostLike, 'grantAgent'> | undefined;
+    cockpitOrigin?: string | undefined;
+    runId: string;
+    worktree: boolean;
+    context: () => RunContext | undefined;
+}): S;
+/** The preview host's view of a run with a live worktree, read when the agent connects. */
+export declare function previewRunContext(store: RunContext['store'], dataDir: string, runId: string): RunContext | undefined;

package/dist/preview/agent-address.js

@@ -0,0 +1,51 @@
+import { existsSync } from 'node:fs';
+import { previewToolEnabled } from '../ci-wait/tools.js';
+/**
+ * The agent's preview browser address (hearsay-tools/cezarion#784, spec
+ * 2026-10-26-preview-agent-cdp): the cockpit's own bound origin as `ws:`, at the CDP proxy route,
+ * with the grant's token. Undefined when the origin is not a URL.
+ */
+export function previewCdpUrl(cockpitOrigin, token) {
+    let address;
+    try {
+        address = new URL(cockpitOrigin);
+    }
+    catch {
+        return undefined;
+    }
+    address.protocol = address.protocol === 'https:' ? 'wss:' : 'ws:';
+    address.pathname = `/api/v1/preview/cdp/${token}`;
+    address.search = address.hash = '';
+    return address.toString();
+}
+/**
+ * A session's tool capability with the CDP address added: `CEZ_PREVIEW_CDP_URL` joins its env, and
+ * its `revoke` also revokes the grant, so every site that ends the tools closes the agent's browser
+ * sockets too.
+ */
+export function withPreviewCdp(session, grant, cockpitOrigin) {
+    const url = previewCdpUrl(cockpitOrigin, grant.token);
+    if (!url) {
+        grant.revoke();
+        return session;
+    }
+    return { ...session, env: { ...session.env, CEZ_PREVIEW_CDP_URL: url }, revoke: () => { session.revoke(); grant.revoke(); } };
+}
+/**
+ * `withPreviewCdp` behind its gate: only with `CEZ_PREVIEW=1`, a host that can grant, a cockpit
+ * origin (none under `cez run`) and a worktree. Every runner's session goes through here, so the
+ * harness parity cell R125 reads the same decision RunManager makes.
+ */
+export function previewCdpSession(session, opts) {
+    if (!previewToolEnabled() || !opts.host?.grantAgent || !opts.cockpitOrigin || !opts.worktree)
+        return session;
+    return withPreviewCdp(session, opts.host.grantAgent(opts.runId, opts.context), opts.cockpitOrigin);
+}
+/** The preview host's view of a run with a live worktree, read when the agent connects. */
+export function previewRunContext(store, dataDir, runId) {
+    const run = store.getRun(runId);
+    if (!run?.worktreePath || !existsSync(run.worktreePath))
+        return undefined;
+    return { runId, title: run.title, worktreePath: run.worktreePath, dataDir, store };
+}
+//# sourceMappingURL=agent-address.js.map

package/dist/preview/agent-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-address.js","sourceRoot":"","sources":["../../src/preview/agent-address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIzD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,aAAqB,EAAE,KAAa;IAChE,IAAI,OAAY,CAAC;IACjB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,OAAO,CAAC,QAAQ,GAAG,uBAAuB,KAAK,EAAE,CAAC;IAClD,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC;IACnC,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAA4D,OAAU,EAAE,KAAiB,EAAE,aAAqB;IAC5I,MAAM,GAAG,GAAG,aAAa,CAAC,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAChI,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAU,EACV,IAA6K;IAE7K,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC7G,OAAO,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;AACrG,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,KAA0B,EAAE,OAAe,EAAE,KAAa;IAC1F,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE,YAAY,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACrF,CAAC"}

package/dist/preview/agent-marker.d.ts

@@ -0,0 +1,17 @@
+import type { RunContext } from './host.ts';
+/** Before `connected` is appended: a crash after this line still leaves a marker to reconcile. */
+export declare function markAgentConnected(dataDir: string, runId: string): void;
+/** After `disconnected` is appended. */
+export declare function clearAgentMarker(dataDir: string, runId: string): void;
+/**
+ * Appends `preview.agent-browser` for a run that exists, with its marker around it. Best effort: it
+ * runs inside a socket's close, so a failed write never stops that cleanup, and a `disconnected` it
+ * could not write keeps the marker for the next boot. Answers whether the event is written.
+ */
+export declare function recordAgentBrowser(ctx: Pick<RunContext, 'runId' | 'store' | 'dataDir'>, state: 'connected' | 'disconnected'): boolean;
+/**
+ * Boot: every marker this process does not own is a crash's. Its run gets the `disconnected` it
+ * missed, then the marker goes; a crash between the two only appends `disconnected` again.
+ * Synchronous, so it finishes before the agent's CDP route can accept a connection.
+ */
+export declare function reconcileAgentMarkers(dataDir: string, store: RunContext['store'], live: (runId: string) => boolean): number;

package/dist/preview/agent-marker.js

@@ -0,0 +1,71 @@
+import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * A run's `preview.agent-browser` state across a crash (hearsay-tools/cezarion#784): the marker
+ * `<dataDir>/preview/<runId>/agent-connected` exists from just before `connected` is appended until
+ * just after `disconnected` is. A cezar killed with an agent connected leaves the marker, and the
+ * next boot appends the missing `disconnected`, so the cockpit never lists a page no agent drives.
+ */
+const MARKER = 'agent-connected';
+function markerPath(dataDir, runId) {
+    return join(dataDir, 'preview', runId, MARKER);
+}
+/** Before `connected` is appended: a crash after this line still leaves a marker to reconcile. */
+export function markAgentConnected(dataDir, runId) {
+    try {
+        mkdirSync(join(dataDir, 'preview', runId), { recursive: true });
+        writeFileSync(markerPath(dataDir, runId), '');
+    }
+    catch { /* a read-only data dir: the state then lives only as long as this process */ }
+}
+/** After `disconnected` is appended. */
+export function clearAgentMarker(dataDir, runId) {
+    try {
+        rmSync(markerPath(dataDir, runId), { force: true });
+    }
+    catch { /* the next boot finds the marker and appends `disconnected` again */ }
+}
+/**
+ * Appends `preview.agent-browser` for a run that exists, with its marker around it. Best effort: it
+ * runs inside a socket's close, so a failed write never stops that cleanup, and a `disconnected` it
+ * could not write keeps the marker for the next boot. Answers whether the event is written.
+ */
+export function recordAgentBrowser(ctx, state) {
+    const { runId, store, dataDir } = ctx;
+    try {
+        const run = store.getRun(runId);
+        if (run && state === 'connected')
+            markAgentConnected(dataDir, runId);
+        if (run)
+            store.appendEvent(runId, { type: 'preview.agent-browser', state });
+    }
+    catch {
+        return false;
+    }
+    if (state === 'disconnected')
+        clearAgentMarker(dataDir, runId);
+    return true;
+}
+/**
+ * Boot: every marker this process does not own is a crash's. Its run gets the `disconnected` it
+ * missed, then the marker goes; a crash between the two only appends `disconnected` again.
+ * Synchronous, so it finishes before the agent's CDP route can accept a connection.
+ */
+export function reconcileAgentMarkers(dataDir, store, live) {
+    let runIds;
+    try {
+        runIds = readdirSync(join(dataDir, 'preview'));
+    }
+    catch {
+        return 0;
+    }
+    let reconciled = 0;
+    for (const runId of runIds) {
+        if (!existsSync(markerPath(dataDir, runId)) || live(runId))
+            continue;
+        if (recordAgentBrowser({ runId, store, dataDir }, 'disconnected'))
+            reconciled += 1;
+    }
+    return reconciled;
+}
+//# sourceMappingURL=agent-marker.js.map

package/dist/preview/agent-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-marker.js","sourceRoot":"","sources":["../../src/preview/agent-marker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;GAKG;AAEH,MAAM,MAAM,GAAG,iBAAiB,CAAC;AAEjC,SAAS,UAAU,CAAC,OAAe,EAAE,KAAa;IAChD,OAAO,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,KAAa;IAC/D,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC,CAAC,6EAA6E,CAAC,CAAC;AAC3F,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,KAAa;IAC7D,IAAI,CAAC;QACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC,CAAC,qEAAqE,CAAC,CAAC;AACnF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAoD,EAAE,KAAmC;IAC1H,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,GAAG,IAAI,KAAK,KAAK,WAAW;YAAE,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACrE,IAAI,GAAG;YAAE,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,KAAK,cAAc;QAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,KAA0B,EAAE,IAAgC;IACjH,IAAI,MAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QACrE,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,cAAc,CAAC;YAAE,UAAU,IAAI,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/preview/cdp-proxy.d.ts

@@ -0,0 +1,54 @@
+import type { CdpConnection } from './cdp.ts';
+/**
+ * One agent connection to the task's Chromium (hearsay-tools/cezarion#784, spec
+ * 2026-10-26-preview-agent-cdp). Chromium has no debug port, only cezar's pipe; each agent socket
+ * gets its own browser session on that pipe (`Target.attachToBrowserTarget`), so its Target domain
+ * state, its ids and its events stay apart from cezar's own page session and from other agents.
+ *
+ * - A message without `sessionId` is the agent's root: it goes to its browser session.
+ * - A message naming a session goes through only when this link opened that session.
+ * - Replies and events come back in the order the browser sent them, the browser session's without
+ *   a `sessionId`, as a client of a root WebSocket expects.
+ * - Commands that would end the owner's browser or the page the pane streams are refused, and so
+ *   is `Target.sendMessageToTarget`, which would carry such a command past these checks.
+ * - Each target the agent creates, attaches to or activates is reported (`onTarget`): the pane's
+ *   "agent's page" follows it, because `agent-browser --pin-tab` drives a fresh tab of its own.
+ */
+/** The agent's side of the link: an open WebSocket, as the proxy route hands it over. */
+export type AgentClient = {
+    send(text: string): void;
+    close(code: number, reason: string): void;
+};
+export declare class AgentCdpLink {
+    private readonly connection;
+    private readonly client;
+    private readonly browserSession;
+    private readonly protectedTargetId;
+    private readonly onClose;
+    private readonly onTarget;
+    /** Child sessions this link opened, each with the target it is attached to. */
+    private readonly owned;
+    private readonly offEvent;
+    private closed;
+    private constructor();
+    /**
+     * Opens the agent's browser session. `protectedTargetId` is the page the owner's pane streams:
+     * the agent may drive it but not close it. Rejects when the browser refuses the session.
+     */
+    static open(connection: CdpConnection, client: AgentClient, opts?: {
+        protectedTargetId?: string | undefined;
+        onClose?: () => void;
+        onTarget?: (targetId: string) => void;
+    }): Promise<AgentCdpLink>;
+    /** One message from the agent's socket. */
+    fromClient(text: string): void;
+    /** The agent's socket closed, or the link is closing it: the browser session goes, and with it every child. */
+    close(code?: number, reason?: string): void;
+    private refusal;
+    private fromBrowser;
+    /** The target a successful command made the agent's: created, attached to, or brought to front. */
+    private reportTarget;
+    private adopt;
+    private forget;
+    private deliver;
+}

package/dist/preview/cdp-proxy.js

@@ -0,0 +1,151 @@
+/** End the browser for everyone: the owner's pane and every other agent share it. */
+const BROWSER_ENDING = new Set(['Browser.close', 'Browser.crash', 'Browser.crashGpuProcess']);
+/** Commands that close a target or a session given in their params. */
+const CLOSES_TARGET = new Set(['Target.closeTarget']);
+const CLOSES_PAGE = new Set(['Page.close']);
+/** The legacy tunnel: its session and command sit inside `params`, where no guard here reads them. */
+const TUNNEL = 'Target.sendMessageToTarget';
+/** JSON-RPC's code for a request the server will not run: CDP uses it for unknown sessions too. */
+const REFUSED_CODE = -32000;
+export class AgentCdpLink {
+    connection;
+    client;
+    browserSession;
+    protectedTargetId;
+    onClose;
+    onTarget;
+    /** Child sessions this link opened, each with the target it is attached to. */
+    owned = new Map();
+    offEvent;
+    closed = false;
+    constructor(connection, client, browserSession, protectedTargetId, onClose, onTarget) {
+        this.connection = connection;
+        this.client = client;
+        this.browserSession = browserSession;
+        this.protectedTargetId = protectedTargetId;
+        this.onClose = onClose;
+        this.onTarget = onTarget;
+        this.offEvent = connection.onEvent(msg => this.fromBrowser(msg));
+        void connection.closed.then(() => this.close(1011, 'The preview browser exited'));
+    }
+    /**
+     * Opens the agent's browser session. `protectedTargetId` is the page the owner's pane streams:
+     * the agent may drive it but not close it. Rejects when the browser refuses the session.
+     */
+    static async open(connection, client, opts = {}) {
+        const reply = await connection.call('Target.attachToBrowserTarget', {}, undefined);
+        const sessionId = reply.result?.sessionId;
+        if (reply.error || typeof sessionId !== 'string')
+            throw new Error(`Target.attachToBrowserTarget: ${reply.error?.message ?? 'no session'}`);
+        return new AgentCdpLink(connection, client, sessionId, opts.protectedTargetId, opts.onClose ?? (() => { }), opts.onTarget ?? (() => { }));
+    }
+    /** One message from the agent's socket. */
+    fromClient(text) {
+        if (this.closed)
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(text);
+        }
+        catch {
+            return;
+        }
+        if (typeof msg.id !== 'number' || typeof msg.method !== 'string')
+            return;
+        const { id, method } = msg;
+        const named = typeof msg.sessionId === 'string' ? msg.sessionId : undefined;
+        const reply = (body) => this.deliver({ id, ...body, ...(named ? { sessionId: named } : {}) });
+        if (named !== undefined && !this.owned.has(named))
+            return reply({ error: { code: REFUSED_CODE, message: 'Session with given id not found.' } });
+        const refusal = this.refusal(method, msg.params, named);
+        if (refusal)
+            return reply({ error: { code: REFUSED_CODE, message: refusal } });
+        this.connection.request(method, msg.params ?? {}, named ?? this.browserSession, answer => {
+            if (method === 'Target.attachToTarget' && !answer.error)
+                this.adopt(answer.result, msg.params?.targetId);
+            if (method === 'Target.detachFromTarget' && !answer.error)
+                this.forget(msg.params?.sessionId);
+            reply(answer.error ? { error: answer.error } : { result: answer.result ?? {} });
+            if (!answer.error)
+                this.reportTarget(method, msg.params, answer.result);
+        });
+    }
+    /** The agent's socket closed, or the link is closing it: the browser session goes, and with it every child. */
+    close(code = 1000, reason = '') {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.offEvent();
+        this.connection.request('Target.detachFromTarget', { sessionId: this.browserSession }, undefined, () => { });
+        this.client.close(code, reason);
+        this.onClose();
+    }
+    refusal(method, params, named) {
+        if (BROWSER_ENDING.has(method))
+            return `cezar refuses ${method}: the owner's preview pane shares this browser.`;
+        if (method === TUNNEL)
+            return `cezar refuses ${TUNNEL}: use flat sessions (attach with flatten: true).`;
+        const p = (params ?? {});
+        if (CLOSES_TARGET.has(method) && this.protectedTargetId !== undefined && p.targetId === this.protectedTargetId) {
+            return `cezar refuses ${method} on the page the owner's preview pane shows.`;
+        }
+        if (CLOSES_PAGE.has(method) && named !== undefined && this.owned.get(named) === this.protectedTargetId && this.protectedTargetId !== undefined) {
+            return `cezar refuses ${method} on the page the owner's preview pane shows.`;
+        }
+        // Only this link's sessions: a foreign id could be cezar's own page session.
+        if (method === 'Target.detachFromTarget' && typeof p.sessionId === 'string' && !this.owned.has(p.sessionId)) {
+            return 'Session with given id not found.';
+        }
+        return undefined;
+    }
+    fromBrowser(msg) {
+        if (this.closed || typeof msg.sessionId !== 'string')
+            return;
+        const own = msg.sessionId === this.browserSession;
+        if (!own && !this.owned.has(msg.sessionId))
+            return;
+        if (msg.method === 'Target.attachedToTarget')
+            this.adopt(msg.params, undefined);
+        if (msg.method === 'Target.detachedFromTarget')
+            this.forget(msg.params?.sessionId);
+        if (own) {
+            const { sessionId: _browserSession, ...rest } = msg;
+            this.deliver(rest);
+        }
+        else {
+            this.deliver(msg);
+        }
+    }
+    /** The target a successful command made the agent's: created, attached to, or brought to front. */
+    reportTarget(method, params, result) {
+        if (this.closed)
+            return;
+        const fromParams = params?.targetId;
+        const target = method === 'Target.createTarget'
+            ? result?.targetId
+            : method === 'Target.attachToTarget' || method === 'Target.activateTarget' ? fromParams : undefined;
+        if (typeof target === 'string')
+            this.onTarget(target);
+    }
+    adopt(attached, targetId) {
+        if (typeof attached?.sessionId !== 'string')
+            return;
+        const target = attached.targetInfo?.targetId ?? targetId;
+        this.owned.set(attached.sessionId, typeof target === 'string' ? target : undefined);
+    }
+    forget(sessionId) {
+        if (typeof sessionId === 'string')
+            this.owned.delete(sessionId);
+    }
+    deliver(msg) {
+        if (this.closed)
+            return;
+        try {
+            this.client.send(JSON.stringify(msg));
+        }
+        catch {
+            this.close(1011, 'The agent socket failed');
+        }
+    }
+}
+//# sourceMappingURL=cdp-proxy.js.map

package/dist/preview/cdp-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-proxy.js","sourceRoot":"","sources":["../../src/preview/cdp-proxy.ts"],"names":[],"mappings":"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"}

package/dist/preview/cdp.d.ts

@@ -1,13 +1,49 @@
+import type { Readable, Writable } from 'node:stream';
 /**
- * A minimal Chrome DevTools Protocol client over one page target's WebSocket (#781). Raw CDP never
- * leaves the server process: the preview host wraps this behind its own whitelisted vocabulary.
+ * A minimal Chrome DevTools Protocol client (hearsay-tools/cezarion#781). Raw CDP never leaves the server process except
+ * through the agent's CDP proxy (`cdp-proxy.ts`, hearsay-tools/cezarion#784), which gives each agent
+ * connection its own browser session on this same connection.
  */
 export interface Cdp {
     send<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
     /** Subscribe to a CDP event; returns the unsubscribe. */
     on<T = unknown>(event: string, fn: (params: T) => void): () => void;
     close(): void;
-    /** Settles when the socket is gone, whoever closed it. */
+    /** Settles when the connection is gone, whoever closed it. */
     closed: Promise<void>;
 }
+/** One CDP message as it crosses the wire. Flat sessions name their session in `sessionId`. */
+export type CdpMessage = {
+    id?: number;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: {
+        code?: number;
+        message?: string;
+        data?: unknown;
+    };
+    sessionId?: string;
+};
+/** The browser-level connection: flat sessions over one transport (the pipe, hearsay-tools/cezarion#784). */
+export interface CdpConnection {
+    /** A page or browser session's client. Undefined is the root session. */
+    session(sessionId: string | undefined): Cdp;
+    /** Sends one command and settles with its raw reply, error included: the proxy forwards it as it came. */
+    call(method: string, params: unknown, sessionId: string | undefined): Promise<CdpMessage>;
+    /** `call` with a callback run in wire order, before any message read after the reply: a proxy
+     *  that forwards replies and events keeps the order the browser sent them in. */
+    request(method: string, params: unknown, sessionId: string | undefined, onReply: (msg: CdpMessage) => void): void;
+    /** Every event on every session, as it came; returns the unsubscribe. */
+    onEvent(fn: (msg: CdpMessage) => void): () => void;
+    close(): void;
+    closed: Promise<void>;
+}
+/** One page target's WebSocket. The tests' fake CDP servers speak it. */
 export declare function connectCdp(wsUrl: string): Promise<Cdp>;
+/**
+ * Chromium's `--remote-debugging-pipe` (hearsay-tools/cezarion#784): commands go into fd 3 and
+ * replies come out of fd 4, each message ended by a NUL byte. No port exists, so only this process
+ * reaches the browser.
+ */
+export declare function cdpOverPipe(toBrowser: Writable, fromBrowser: Readable): CdpConnection;