@proxyhuman/protocol 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,3601 @@
+import { z } from 'zod';
+
+/**
+ * @proxyhuman/protocol — wire-format contract for the ProxyHuman platform.
+ *
+ * Every type is defined as a zod schema and a `z.infer`-ed TypeScript type.
+ * Consumers can `safeParse` incoming messages to validate before acting.
+ *
+ * Three actors:
+ *   Publisher — agent-side runtime (the MCP server, ffmpeg + CDP).
+ *   API       — Cloudflare Worker + Durable Objects (api.proxyhuman.ai).
+ *   Viewer    — human's browser at app.proxyhuman.ai/browser/:sid.
+ *
+ * Naming conventions:
+ *   Commands (imperative):  new_session, cancel_handoff
+ *   Events (past tense):    viewer_joined, state_changed, publish_started
+ *   Responses:              session_ready, stream_ready
+ *   All wire `type` values are snake_case.
+ */
+
+declare const IceServerSchema: z.ZodObject<{
+    urls: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    username: z.ZodOptional<z.ZodString>;
+    credential: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    urls: string | string[];
+    username?: string | undefined;
+    credential?: string | undefined;
+}, {
+    urls: string | string[];
+    username?: string | undefined;
+    credential?: string | undefined;
+}>;
+type IceServer = z.infer<typeof IceServerSchema>;
+declare const KeyboardModifiersSchema: z.ZodObject<{
+    shiftKey: z.ZodOptional<z.ZodBoolean>;
+    ctrlKey: z.ZodOptional<z.ZodBoolean>;
+    altKey: z.ZodOptional<z.ZodBoolean>;
+    metaKey: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    shiftKey?: boolean | undefined;
+    ctrlKey?: boolean | undefined;
+    altKey?: boolean | undefined;
+    metaKey?: boolean | undefined;
+}, {
+    shiftKey?: boolean | undefined;
+    ctrlKey?: boolean | undefined;
+    altKey?: boolean | undefined;
+    metaKey?: boolean | undefined;
+}>;
+type KeyboardModifiers = z.infer<typeof KeyboardModifiersSchema>;
+declare const ViewportSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    width: number;
+    height: number;
+}, {
+    width: number;
+    height: number;
+}>;
+type Viewport = z.infer<typeof ViewportSchema>;
+/**
+ * Self-reported publisher identity, persisted on SessionInfo so the
+ * dashboard can show "which client opened this handoff".
+ */
+declare const PublisherInfoSchema: z.ZodObject<{
+    /** Package name, e.g. "@proxyhuman/mcp". */
+    name: z.ZodString;
+    /** Package version, e.g. "0.2.0". */
+    version: z.ZodString;
+    /** Optional host descriptor (OS / hostname) for diagnostic logs. */
+    host: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: string;
+    host?: string | undefined;
+}, {
+    name: string;
+    version: string;
+    host?: string | undefined;
+}>;
+type PublisherInfo = z.infer<typeof PublisherInfoSchema>;
+/**
+ * Per-session info about the browser the publisher attached to. Captured
+ * once at attach time so the dashboard can show "session N attached to
+ * Chrome 148 at 1920x1080 starting at example.com". Useful for post-mortems.
+ */
+declare const TargetInfoSchema: z.ZodObject<{
+    /** Chrome DevTools Protocol HTTP endpoint — diagnostic only. */
+    cdpUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Page URL when the publisher attached (first frame_navigated). */
+    initialUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Encoder viewport — the actual stream resolution. */
+    viewport: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width: number;
+        height: number;
+    }>>>;
+    /** Browser identity from CDP `Browser.getVersion` (`product` field). */
+    browserVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Full user-agent string of the attached page. */
+    userAgent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    cdpUrl?: string | null | undefined;
+    initialUrl?: string | null | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | null | undefined;
+    browserVersion?: string | null | undefined;
+    userAgent?: string | null | undefined;
+}, {
+    cdpUrl?: string | null | undefined;
+    initialUrl?: string | null | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | null | undefined;
+    browserVersion?: string | null | undefined;
+    userAgent?: string | null | undefined;
+}>;
+type TargetInfo = z.infer<typeof TargetInfoSchema>;
+/**
+ * Per-viewer client info captured at WS upgrade. The server fills in what
+ * the browser tells us (User-Agent, Cloudflare's `cf-connecting-ip`) plus
+ * a stable `deviceId` — a random opaque string set as a cookie on the
+ * viewer's first connection and echoed back on every subsequent one. The
+ * dashboard uses this to render "watched from this device" timelines and
+ * detect URL leaks (same viewerUrl, two different deviceIds).
+ */
+declare const ViewerInfoSchema: z.ZodObject<{
+    /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+    deviceId: z.ZodNullable<z.ZodString>;
+    userAgent: z.ZodNullable<z.ZodString>;
+    ip: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userAgent: string | null;
+    deviceId: string | null;
+    ip: string | null;
+}, {
+    userAgent: string | null;
+    deviceId: string | null;
+    ip: string | null;
+}>;
+type ViewerInfo = z.infer<typeof ViewerInfoSchema>;
+/**
+ * One human-intent record. The API recorder collapses adjacent low-level
+ * events into these coarser entries. Tap coordinates are normalized [0, 1].
+ *
+ * `redacted: true` on `type` / `paste` means the user was typing into a
+ * sensitive field (e.g. `<input type="password">`) at the time, so the
+ * actual text was replaced with `[REDACTED]` of the same length before
+ * persisting. The publisher signals sensitive context via `focus_changed`.
+ */
+declare const RecordedActionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"type">;
+    text: z.ZodString;
+    redacted: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "type";
+    ts: number;
+    text: string;
+    redacted?: boolean | undefined;
+}, {
+    type: "type";
+    ts: number;
+    text: string;
+    redacted?: boolean | undefined;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"paste">;
+    text: z.ZodString;
+    redacted: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "paste";
+    ts: number;
+    text: string;
+    redacted?: boolean | undefined;
+}, {
+    type: "paste";
+    ts: number;
+    text: string;
+    redacted?: boolean | undefined;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"press">;
+    key: z.ZodString;
+    modifiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "press";
+    ts: number;
+    key: string;
+    modifiers?: string[] | undefined;
+}, {
+    type: "press";
+    ts: number;
+    key: string;
+    modifiers?: string[] | undefined;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"tap">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "tap";
+    ts: number;
+    x: number;
+    y: number;
+}, {
+    type: "tap";
+    ts: number;
+    x: number;
+    y: number;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"scroll">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    deltaX: z.ZodNumber;
+    deltaY: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "scroll";
+    ts: number;
+    x: number;
+    y: number;
+    deltaX: number;
+    deltaY: number;
+}, {
+    type: "scroll";
+    ts: number;
+    x: number;
+    y: number;
+    deltaX: number;
+    deltaY: number;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"navigate">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "navigate";
+    ts: number;
+    url: string;
+}, {
+    type: "navigate";
+    ts: number;
+    url: string;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"back">;
+}, "strip", z.ZodTypeAny, {
+    type: "back";
+    ts: number;
+}, {
+    type: "back";
+    ts: number;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"forward">;
+}, "strip", z.ZodTypeAny, {
+    type: "forward";
+    ts: number;
+}, {
+    type: "forward";
+    ts: number;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"reload">;
+}, "strip", z.ZodTypeAny, {
+    type: "reload";
+    ts: number;
+}, {
+    type: "reload";
+    ts: number;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"url_update">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "url_update";
+    ts: number;
+    url: string;
+}, {
+    type: "url_update";
+    ts: number;
+    url: string;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"human_done">;
+}, "strip", z.ZodTypeAny, {
+    type: "human_done";
+    ts: number;
+}, {
+    type: "human_done";
+    ts: number;
+}>]>;
+type RecordedAction = z.infer<typeof RecordedActionSchema>;
+declare const SessionStateSchema: z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>;
+type SessionState = z.infer<typeof SessionStateSchema>;
+declare const TERMINAL_STATES: readonly ["complete", "failed", "cancelled"];
+declare function isTerminalState(state: SessionState): boolean;
+declare const SessionOutcomeSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"human_done">;
+}, "strip", z.ZodTypeAny, {
+    type: "human_done";
+}, {
+    type: "human_done";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"disconnected">;
+}, "strip", z.ZodTypeAny, {
+    type: "disconnected";
+}, {
+    type: "disconnected";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"timeout">;
+}, "strip", z.ZodTypeAny, {
+    type: "timeout";
+}, {
+    type: "timeout";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"cancelled">;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "cancelled";
+    reason?: string | undefined;
+}, {
+    type: "cancelled";
+    reason?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"cdp_lost">;
+}, "strip", z.ZodTypeAny, {
+    type: "cdp_lost";
+}, {
+    type: "cdp_lost";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"encoder_crash">;
+}, "strip", z.ZodTypeAny, {
+    type: "encoder_crash";
+}, {
+    type: "encoder_crash";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"relay_error">;
+    detail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "relay_error";
+    detail?: string | undefined;
+}, {
+    type: "relay_error";
+    detail?: string | undefined;
+}>]>;
+type SessionOutcome = z.infer<typeof SessionOutcomeSchema>;
+declare const SessionEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"state_changed">;
+    from: z.ZodNullable<z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>>;
+    to: z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "state_changed";
+    ts: number;
+    from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+    to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+}, {
+    type: "state_changed";
+    ts: number;
+    from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+    to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"viewer_joined">;
+    viewerCount: z.ZodNumber;
+    viewer: z.ZodOptional<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "viewer_joined";
+    ts: number;
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}, {
+    type: "viewer_joined";
+    ts: number;
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"viewer_left">;
+    viewerCount: z.ZodNumber;
+    viewer: z.ZodOptional<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "viewer_left";
+    ts: number;
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}, {
+    type: "viewer_left";
+    ts: number;
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"action_recorded">;
+    action: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"type">;
+        text: z.ZodString;
+        redacted: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }, {
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"paste">;
+        text: z.ZodString;
+        redacted: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }, {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"press">;
+        key: z.ZodString;
+        modifiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    }, {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"tap">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    }, {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"scroll">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        deltaX: z.ZodNumber;
+        deltaY: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    }, {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"navigate">;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "navigate";
+        ts: number;
+        url: string;
+    }, {
+        type: "navigate";
+        ts: number;
+        url: string;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"back">;
+    }, "strip", z.ZodTypeAny, {
+        type: "back";
+        ts: number;
+    }, {
+        type: "back";
+        ts: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"forward">;
+    }, "strip", z.ZodTypeAny, {
+        type: "forward";
+        ts: number;
+    }, {
+        type: "forward";
+        ts: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"reload">;
+    }, "strip", z.ZodTypeAny, {
+        type: "reload";
+        ts: number;
+    }, {
+        type: "reload";
+        ts: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"url_update">;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "url_update";
+        ts: number;
+        url: string;
+    }, {
+        type: "url_update";
+        ts: number;
+        url: string;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"human_done">;
+    }, "strip", z.ZodTypeAny, {
+        type: "human_done";
+        ts: number;
+    }, {
+        type: "human_done";
+        ts: number;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    type: "action_recorded";
+    ts: number;
+    action: {
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    } | {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    } | {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    } | {
+        type: "navigate";
+        ts: number;
+        url: string;
+    } | {
+        type: "back";
+        ts: number;
+    } | {
+        type: "forward";
+        ts: number;
+    } | {
+        type: "reload";
+        ts: number;
+    } | {
+        type: "url_update";
+        ts: number;
+        url: string;
+    } | {
+        type: "human_done";
+        ts: number;
+    };
+}, {
+    type: "action_recorded";
+    ts: number;
+    action: {
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    } | {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    } | {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    } | {
+        type: "navigate";
+        ts: number;
+        url: string;
+    } | {
+        type: "back";
+        ts: number;
+    } | {
+        type: "forward";
+        ts: number;
+    } | {
+        type: "reload";
+        ts: number;
+    } | {
+        type: "url_update";
+        ts: number;
+        url: string;
+    } | {
+        type: "human_done";
+        ts: number;
+    };
+}>, z.ZodObject<{
+    ts: z.ZodNumber;
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+    detail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    type: "error";
+    ts: number;
+    detail?: string | undefined;
+}, {
+    message: string;
+    type: "error";
+    ts: number;
+    detail?: string | undefined;
+}>]>;
+type SessionEvent = z.infer<typeof SessionEventSchema>;
+/**
+ * Publisher's first message. Authenticates + requests a new session, and
+ * carries the metadata that will be persisted on SessionInfo (prompt,
+ * publisher identity, target info).
+ */
+declare const NewSessionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"new_session">;
+    apiKey: z.ZodString;
+    /** Free-text context shown to the human in the dashboard. */
+    prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    publisher: z.ZodOptional<z.ZodObject<{
+        /** Package name, e.g. "@proxyhuman/mcp". */
+        name: z.ZodString;
+        /** Package version, e.g. "0.2.0". */
+        version: z.ZodString;
+        /** Optional host descriptor (OS / hostname) for diagnostic logs. */
+        host: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    }, {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    }>>;
+    target: z.ZodOptional<z.ZodObject<{
+        /** Chrome DevTools Protocol HTTP endpoint — diagnostic only. */
+        cdpUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Page URL when the publisher attached (first frame_navigated). */
+        initialUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Encoder viewport — the actual stream resolution. */
+        viewport: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            width: number;
+            height: number;
+        }, {
+            width: number;
+            height: number;
+        }>>>;
+        /** Browser identity from CDP `Browser.getVersion` (`product` field). */
+        browserVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Full user-agent string of the attached page. */
+        userAgent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    }, {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "new_session";
+    apiKey: string;
+    prompt?: string | null | undefined;
+    publisher?: {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    } | undefined;
+    target?: {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    } | undefined;
+}, {
+    type: "new_session";
+    apiKey: string;
+    prompt?: string | null | undefined;
+    publisher?: {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    } | undefined;
+    target?: {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    } | undefined;
+}>;
+type NewSession = z.infer<typeof NewSessionSchema>;
+declare const UrlUpdateSchema: z.ZodObject<{
+    type: z.ZodLiteral<"url_update">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "url_update";
+    url: string;
+}, {
+    type: "url_update";
+    url: string;
+}>;
+type UrlUpdate = z.infer<typeof UrlUpdateSchema>;
+/** Publisher signals its WHIP upload is live → API notifies subscribed viewers. */
+declare const PublishStartedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"publish_started">;
+}, "strip", z.ZodTypeAny, {
+    type: "publish_started";
+}, {
+    type: "publish_started";
+}>;
+type PublishStarted = z.infer<typeof PublishStartedSchema>;
+/** Publisher signals a state-machine transition. */
+declare const StateChangedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"state_changed">;
+    from: z.ZodNullable<z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>>;
+    to: z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>;
+    outcome: z.ZodNullable<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"human_done">;
+    }, "strip", z.ZodTypeAny, {
+        type: "human_done";
+    }, {
+        type: "human_done";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"disconnected">;
+    }, "strip", z.ZodTypeAny, {
+        type: "disconnected";
+    }, {
+        type: "disconnected";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"timeout">;
+    }, "strip", z.ZodTypeAny, {
+        type: "timeout";
+    }, {
+        type: "timeout";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cancelled">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "cancelled";
+        reason?: string | undefined;
+    }, {
+        type: "cancelled";
+        reason?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cdp_lost">;
+    }, "strip", z.ZodTypeAny, {
+        type: "cdp_lost";
+    }, {
+        type: "cdp_lost";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"encoder_crash">;
+    }, "strip", z.ZodTypeAny, {
+        type: "encoder_crash";
+    }, {
+        type: "encoder_crash";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"relay_error">;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "relay_error";
+        detail?: string | undefined;
+    }, {
+        type: "relay_error";
+        detail?: string | undefined;
+    }>]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "state_changed";
+    from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+    to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    outcome: {
+        type: "human_done";
+    } | {
+        type: "disconnected";
+    } | {
+        type: "timeout";
+    } | {
+        type: "cancelled";
+        reason?: string | undefined;
+    } | {
+        type: "cdp_lost";
+    } | {
+        type: "encoder_crash";
+    } | {
+        type: "relay_error";
+        detail?: string | undefined;
+    } | null;
+}, {
+    type: "state_changed";
+    from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+    to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    outcome: {
+        type: "human_done";
+    } | {
+        type: "disconnected";
+    } | {
+        type: "timeout";
+    } | {
+        type: "cancelled";
+        reason?: string | undefined;
+    } | {
+        type: "cdp_lost";
+    } | {
+        type: "encoder_crash";
+    } | {
+        type: "relay_error";
+        detail?: string | undefined;
+    } | null;
+}>;
+type StateChanged = z.infer<typeof StateChangedSchema>;
+/**
+ * Publisher reports a DOM focus change. The API recorder uses `isSensitive`
+ * to toggle redaction mode — when true, subsequent `type`/`paste` actions
+ * have their text replaced with `[REDACTED]` of the same length before
+ * being persisted in the event log.
+ *
+ * The publisher observes focus via CDP (`Runtime.evaluate` on
+ * `document.activeElement` after input dispatch, or a MutationObserver),
+ * and considers a field "sensitive" if any of:
+ *   - `<input type="password">`
+ *   - `autocomplete` value includes `current-password` / `new-password` /
+ *     `one-time-code` / `cc-number` / `cc-csc`
+ *   - explicit `data-private` / `data-redact` attribute (opt-in)
+ */
+declare const FocusChangedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"focus_changed">;
+    isSensitive: z.ZodBoolean;
+    /** Diagnostic only — `password` / `text` / `email` etc. May be omitted. */
+    fieldType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "focus_changed";
+    isSensitive: boolean;
+    fieldType?: string | undefined;
+}, {
+    type: "focus_changed";
+    isSensitive: boolean;
+    fieldType?: string | undefined;
+}>;
+type FocusChanged = z.infer<typeof FocusChangedSchema>;
+declare const PublisherToApiSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"new_session">;
+    apiKey: z.ZodString;
+    /** Free-text context shown to the human in the dashboard. */
+    prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    publisher: z.ZodOptional<z.ZodObject<{
+        /** Package name, e.g. "@proxyhuman/mcp". */
+        name: z.ZodString;
+        /** Package version, e.g. "0.2.0". */
+        version: z.ZodString;
+        /** Optional host descriptor (OS / hostname) for diagnostic logs. */
+        host: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    }, {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    }>>;
+    target: z.ZodOptional<z.ZodObject<{
+        /** Chrome DevTools Protocol HTTP endpoint — diagnostic only. */
+        cdpUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Page URL when the publisher attached (first frame_navigated). */
+        initialUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Encoder viewport — the actual stream resolution. */
+        viewport: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            width: number;
+            height: number;
+        }, {
+            width: number;
+            height: number;
+        }>>>;
+        /** Browser identity from CDP `Browser.getVersion` (`product` field). */
+        browserVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Full user-agent string of the attached page. */
+        userAgent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    }, {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "new_session";
+    apiKey: string;
+    prompt?: string | null | undefined;
+    publisher?: {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    } | undefined;
+    target?: {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    } | undefined;
+}, {
+    type: "new_session";
+    apiKey: string;
+    prompt?: string | null | undefined;
+    publisher?: {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    } | undefined;
+    target?: {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"url_update">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "url_update";
+    url: string;
+}, {
+    type: "url_update";
+    url: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"publish_started">;
+}, "strip", z.ZodTypeAny, {
+    type: "publish_started";
+}, {
+    type: "publish_started";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"state_changed">;
+    from: z.ZodNullable<z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>>;
+    to: z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>;
+    outcome: z.ZodNullable<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"human_done">;
+    }, "strip", z.ZodTypeAny, {
+        type: "human_done";
+    }, {
+        type: "human_done";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"disconnected">;
+    }, "strip", z.ZodTypeAny, {
+        type: "disconnected";
+    }, {
+        type: "disconnected";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"timeout">;
+    }, "strip", z.ZodTypeAny, {
+        type: "timeout";
+    }, {
+        type: "timeout";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cancelled">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "cancelled";
+        reason?: string | undefined;
+    }, {
+        type: "cancelled";
+        reason?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cdp_lost">;
+    }, "strip", z.ZodTypeAny, {
+        type: "cdp_lost";
+    }, {
+        type: "cdp_lost";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"encoder_crash">;
+    }, "strip", z.ZodTypeAny, {
+        type: "encoder_crash";
+    }, {
+        type: "encoder_crash";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"relay_error">;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "relay_error";
+        detail?: string | undefined;
+    }, {
+        type: "relay_error";
+        detail?: string | undefined;
+    }>]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "state_changed";
+    from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+    to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    outcome: {
+        type: "human_done";
+    } | {
+        type: "disconnected";
+    } | {
+        type: "timeout";
+    } | {
+        type: "cancelled";
+        reason?: string | undefined;
+    } | {
+        type: "cdp_lost";
+    } | {
+        type: "encoder_crash";
+    } | {
+        type: "relay_error";
+        detail?: string | undefined;
+    } | null;
+}, {
+    type: "state_changed";
+    from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+    to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    outcome: {
+        type: "human_done";
+    } | {
+        type: "disconnected";
+    } | {
+        type: "timeout";
+    } | {
+        type: "cancelled";
+        reason?: string | undefined;
+    } | {
+        type: "cdp_lost";
+    } | {
+        type: "encoder_crash";
+    } | {
+        type: "relay_error";
+        detail?: string | undefined;
+    } | null;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"focus_changed">;
+    isSensitive: z.ZodBoolean;
+    /** Diagnostic only — `password` / `text` / `email` etc. May be omitted. */
+    fieldType: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "focus_changed";
+    isSensitive: boolean;
+    fieldType?: string | undefined;
+}, {
+    type: "focus_changed";
+    isSensitive: boolean;
+    fieldType?: string | undefined;
+}>]>;
+type PublisherToApi = z.infer<typeof PublisherToApiSchema>;
+declare const SessionReadySchema: z.ZodObject<{
+    type: z.ZodLiteral<"session_ready">;
+    sessionId: z.ZodString;
+    whipUrl: z.ZodString;
+    viewerUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "session_ready";
+    sessionId: string;
+    whipUrl: string;
+    viewerUrl: string;
+}, {
+    type: "session_ready";
+    sessionId: string;
+    whipUrl: string;
+    viewerUrl: string;
+}>;
+type SessionReady = z.infer<typeof SessionReadySchema>;
+declare const ViewerJoinedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"viewer_joined">;
+    viewerCount: z.ZodNumber;
+    /** Set for the just-joined viewer; null on summary broadcasts. */
+    viewer: z.ZodOptional<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "viewer_joined";
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}, {
+    type: "viewer_joined";
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}>;
+type ViewerJoined = z.infer<typeof ViewerJoinedSchema>;
+declare const ViewerLeftSchema: z.ZodObject<{
+    type: z.ZodLiteral<"viewer_left">;
+    viewerCount: z.ZodNumber;
+    /** Set for the just-left viewer when known. */
+    viewer: z.ZodOptional<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "viewer_left";
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}, {
+    type: "viewer_left";
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}>;
+type ViewerLeft = z.infer<typeof ViewerLeftSchema>;
+/** API directs the publisher to cancel the handoff (agent or admin action). */
+declare const CancelHandoffSchema: z.ZodObject<{
+    type: z.ZodLiteral<"cancel_handoff">;
+    reason: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "cancel_handoff";
+    reason: string | null;
+}, {
+    type: "cancel_handoff";
+    reason: string | null;
+}>;
+type CancelHandoff = z.infer<typeof CancelHandoffSchema>;
+/**
+ * Input commands the viewer sends. The API records each + forwards verbatim
+ * to the publisher — including `human_done`, which the publisher uses to
+ * transition state to `complete`.
+ *
+ * `x`, `y` are normalized [0, 1] of the viewport.
+ *
+ * `paste` is sent when the desktop browser intercepts a paste event; the
+ * publisher dispatches the text via CDP `Input.insertText` (one call, IME-safe)
+ * instead of char-by-char keypress. Recorder treats it like a `type` action.
+ */
+declare const ViewerCommandSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"tap">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "tap";
+    x: number;
+    y: number;
+}, {
+    type: "tap";
+    x: number;
+    y: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"scroll">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    deltaX: z.ZodNumber;
+    deltaY: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "scroll";
+    x: number;
+    y: number;
+    deltaX: number;
+    deltaY: number;
+}, {
+    type: "scroll";
+    x: number;
+    y: number;
+    deltaX: number;
+    deltaY: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"key">;
+    event: z.ZodEnum<["keydown", "keyup"]>;
+    key: z.ZodString;
+    code: z.ZodString;
+    modifiers: z.ZodOptional<z.ZodObject<{
+        shiftKey: z.ZodOptional<z.ZodBoolean>;
+        ctrlKey: z.ZodOptional<z.ZodBoolean>;
+        altKey: z.ZodOptional<z.ZodBoolean>;
+        metaKey: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    }, {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    type: "key";
+    key: string;
+    event: "keydown" | "keyup";
+    modifiers?: {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    } | undefined;
+}, {
+    code: string;
+    type: "key";
+    key: string;
+    event: "keydown" | "keyup";
+    modifiers?: {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"paste">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "paste";
+    text: string;
+}, {
+    type: "paste";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"navigate">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "navigate";
+    url: string;
+}, {
+    type: "navigate";
+    url: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"history_back">;
+}, "strip", z.ZodTypeAny, {
+    type: "history_back";
+}, {
+    type: "history_back";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"history_forward">;
+}, "strip", z.ZodTypeAny, {
+    type: "history_forward";
+}, {
+    type: "history_forward";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"reload">;
+}, "strip", z.ZodTypeAny, {
+    type: "reload";
+}, {
+    type: "reload";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"human_done">;
+}, "strip", z.ZodTypeAny, {
+    type: "human_done";
+}, {
+    type: "human_done";
+}>]>;
+type ViewerCommand = z.infer<typeof ViewerCommandSchema>;
+declare const ApiToPublisherSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"session_ready">;
+    sessionId: z.ZodString;
+    whipUrl: z.ZodString;
+    viewerUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "session_ready";
+    sessionId: string;
+    whipUrl: string;
+    viewerUrl: string;
+}, {
+    type: "session_ready";
+    sessionId: string;
+    whipUrl: string;
+    viewerUrl: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"viewer_joined">;
+    viewerCount: z.ZodNumber;
+    /** Set for the just-joined viewer; null on summary broadcasts. */
+    viewer: z.ZodOptional<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "viewer_joined";
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}, {
+    type: "viewer_joined";
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"viewer_left">;
+    viewerCount: z.ZodNumber;
+    /** Set for the just-left viewer when known. */
+    viewer: z.ZodOptional<z.ZodObject<{
+        /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+        deviceId: z.ZodNullable<z.ZodString>;
+        userAgent: z.ZodNullable<z.ZodString>;
+        ip: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }, {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "viewer_left";
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}, {
+    type: "viewer_left";
+    viewerCount: number;
+    viewer?: {
+        userAgent: string | null;
+        deviceId: string | null;
+        ip: string | null;
+    } | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"cancel_handoff">;
+    reason: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "cancel_handoff";
+    reason: string | null;
+}, {
+    type: "cancel_handoff";
+    reason: string | null;
+}>, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"tap">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "tap";
+    x: number;
+    y: number;
+}, {
+    type: "tap";
+    x: number;
+    y: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"scroll">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    deltaX: z.ZodNumber;
+    deltaY: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "scroll";
+    x: number;
+    y: number;
+    deltaX: number;
+    deltaY: number;
+}, {
+    type: "scroll";
+    x: number;
+    y: number;
+    deltaX: number;
+    deltaY: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"key">;
+    event: z.ZodEnum<["keydown", "keyup"]>;
+    key: z.ZodString;
+    code: z.ZodString;
+    modifiers: z.ZodOptional<z.ZodObject<{
+        shiftKey: z.ZodOptional<z.ZodBoolean>;
+        ctrlKey: z.ZodOptional<z.ZodBoolean>;
+        altKey: z.ZodOptional<z.ZodBoolean>;
+        metaKey: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    }, {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    type: "key";
+    key: string;
+    event: "keydown" | "keyup";
+    modifiers?: {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    } | undefined;
+}, {
+    code: string;
+    type: "key";
+    key: string;
+    event: "keydown" | "keyup";
+    modifiers?: {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"paste">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "paste";
+    text: string;
+}, {
+    type: "paste";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"navigate">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "navigate";
+    url: string;
+}, {
+    type: "navigate";
+    url: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"history_back">;
+}, "strip", z.ZodTypeAny, {
+    type: "history_back";
+}, {
+    type: "history_back";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"history_forward">;
+}, "strip", z.ZodTypeAny, {
+    type: "history_forward";
+}, {
+    type: "history_forward";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"reload">;
+}, "strip", z.ZodTypeAny, {
+    type: "reload";
+}, {
+    type: "reload";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"human_done">;
+}, "strip", z.ZodTypeAny, {
+    type: "human_done";
+}, {
+    type: "human_done";
+}>]>]>;
+type ApiToPublisher = z.infer<typeof ApiToPublisherSchema>;
+declare const ViewerToApiSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"tap">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "tap";
+    x: number;
+    y: number;
+}, {
+    type: "tap";
+    x: number;
+    y: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"scroll">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    deltaX: z.ZodNumber;
+    deltaY: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "scroll";
+    x: number;
+    y: number;
+    deltaX: number;
+    deltaY: number;
+}, {
+    type: "scroll";
+    x: number;
+    y: number;
+    deltaX: number;
+    deltaY: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"key">;
+    event: z.ZodEnum<["keydown", "keyup"]>;
+    key: z.ZodString;
+    code: z.ZodString;
+    modifiers: z.ZodOptional<z.ZodObject<{
+        shiftKey: z.ZodOptional<z.ZodBoolean>;
+        ctrlKey: z.ZodOptional<z.ZodBoolean>;
+        altKey: z.ZodOptional<z.ZodBoolean>;
+        metaKey: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    }, {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    type: "key";
+    key: string;
+    event: "keydown" | "keyup";
+    modifiers?: {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    } | undefined;
+}, {
+    code: string;
+    type: "key";
+    key: string;
+    event: "keydown" | "keyup";
+    modifiers?: {
+        shiftKey?: boolean | undefined;
+        ctrlKey?: boolean | undefined;
+        altKey?: boolean | undefined;
+        metaKey?: boolean | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"paste">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "paste";
+    text: string;
+}, {
+    type: "paste";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"navigate">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "navigate";
+    url: string;
+}, {
+    type: "navigate";
+    url: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"history_back">;
+}, "strip", z.ZodTypeAny, {
+    type: "history_back";
+}, {
+    type: "history_back";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"history_forward">;
+}, "strip", z.ZodTypeAny, {
+    type: "history_forward";
+}, {
+    type: "history_forward";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"reload">;
+}, "strip", z.ZodTypeAny, {
+    type: "reload";
+}, {
+    type: "reload";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"human_done">;
+}, "strip", z.ZodTypeAny, {
+    type: "human_done";
+}, {
+    type: "human_done";
+}>]>;
+type ViewerToApi = z.infer<typeof ViewerToApiSchema>;
+/** API tells a freshly-attached viewer the WHIP stream is live + how to subscribe. */
+declare const StreamReadySchema: z.ZodObject<{
+    type: z.ZodLiteral<"stream_ready">;
+    whepUrl: z.ZodString;
+    iceServers: z.ZodArray<z.ZodObject<{
+        urls: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+        username: z.ZodOptional<z.ZodString>;
+        credential: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        urls: string | string[];
+        username?: string | undefined;
+        credential?: string | undefined;
+    }, {
+        urls: string | string[];
+        username?: string | undefined;
+        credential?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "stream_ready";
+    whepUrl: string;
+    iceServers: {
+        urls: string | string[];
+        username?: string | undefined;
+        credential?: string | undefined;
+    }[];
+}, {
+    type: "stream_ready";
+    whepUrl: string;
+    iceServers: {
+        urls: string | string[];
+        username?: string | undefined;
+        credential?: string | undefined;
+    }[];
+}>;
+type StreamReady = z.infer<typeof StreamReadySchema>;
+declare const SessionEndedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session_ended">;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "session_ended";
+    reason: string;
+}, {
+    type: "session_ended";
+    reason: string;
+}>;
+type SessionEnded = z.infer<typeof SessionEndedSchema>;
+declare const ApiToViewerSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"stream_ready">;
+    whepUrl: z.ZodString;
+    iceServers: z.ZodArray<z.ZodObject<{
+        urls: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+        username: z.ZodOptional<z.ZodString>;
+        credential: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        urls: string | string[];
+        username?: string | undefined;
+        credential?: string | undefined;
+    }, {
+        urls: string | string[];
+        username?: string | undefined;
+        credential?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "stream_ready";
+    whepUrl: string;
+    iceServers: {
+        urls: string | string[];
+        username?: string | undefined;
+        credential?: string | undefined;
+    }[];
+}, {
+    type: "stream_ready";
+    whepUrl: string;
+    iceServers: {
+        urls: string | string[];
+        username?: string | undefined;
+        credential?: string | undefined;
+    }[];
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"session_ended">;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "session_ended";
+    reason: string;
+}, {
+    type: "session_ended";
+    reason: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"url_update">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "url_update";
+    url: string;
+}, {
+    type: "url_update";
+    url: string;
+}>]>;
+type ApiToViewer = z.infer<typeof ApiToViewerSchema>;
+/** Per-session record persisted in the DO + returned by detail/summary endpoints. */
+declare const SessionInfoSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    state: z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>;
+    viewerCount: z.ZodNumber;
+    createdAt: z.ZodNumber;
+    /** Set when a terminal state is reached, null while still active. */
+    endedAt: z.ZodNullable<z.ZodNumber>;
+    outcome: z.ZodNullable<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"human_done">;
+    }, "strip", z.ZodTypeAny, {
+        type: "human_done";
+    }, {
+        type: "human_done";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"disconnected">;
+    }, "strip", z.ZodTypeAny, {
+        type: "disconnected";
+    }, {
+        type: "disconnected";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"timeout">;
+    }, "strip", z.ZodTypeAny, {
+        type: "timeout";
+    }, {
+        type: "timeout";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cancelled">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "cancelled";
+        reason?: string | undefined;
+    }, {
+        type: "cancelled";
+        reason?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cdp_lost">;
+    }, "strip", z.ZodTypeAny, {
+        type: "cdp_lost";
+    }, {
+        type: "cdp_lost";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"encoder_crash">;
+    }, "strip", z.ZodTypeAny, {
+        type: "encoder_crash";
+    }, {
+        type: "encoder_crash";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"relay_error">;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "relay_error";
+        detail?: string | undefined;
+    }, {
+        type: "relay_error";
+        detail?: string | undefined;
+    }>]>>;
+    prompt: z.ZodNullable<z.ZodString>;
+    publisher: z.ZodNullable<z.ZodObject<{
+        /** Package name, e.g. "@proxyhuman/mcp". */
+        name: z.ZodString;
+        /** Package version, e.g. "0.2.0". */
+        version: z.ZodString;
+        /** Optional host descriptor (OS / hostname) for diagnostic logs. */
+        host: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    }, {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    }>>;
+    target: z.ZodNullable<z.ZodObject<{
+        /** Chrome DevTools Protocol HTTP endpoint — diagnostic only. */
+        cdpUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Page URL when the publisher attached (first frame_navigated). */
+        initialUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Encoder viewport — the actual stream resolution. */
+        viewport: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            width: number;
+            height: number;
+        }, {
+            width: number;
+            height: number;
+        }>>>;
+        /** Browser identity from CDP `Browser.getVersion` (`product` field). */
+        browserVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Full user-agent string of the attached page. */
+        userAgent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    }, {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    viewerCount: number;
+    prompt: string | null;
+    publisher: {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    } | null;
+    target: {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    } | null;
+    outcome: {
+        type: "human_done";
+    } | {
+        type: "disconnected";
+    } | {
+        type: "timeout";
+    } | {
+        type: "cancelled";
+        reason?: string | undefined;
+    } | {
+        type: "cdp_lost";
+    } | {
+        type: "encoder_crash";
+    } | {
+        type: "relay_error";
+        detail?: string | undefined;
+    } | null;
+    sessionId: string;
+    state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    createdAt: number;
+    endedAt: number | null;
+}, {
+    viewerCount: number;
+    prompt: string | null;
+    publisher: {
+        name: string;
+        version: string;
+        host?: string | undefined;
+    } | null;
+    target: {
+        cdpUrl?: string | null | undefined;
+        initialUrl?: string | null | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | null | undefined;
+        browserVersion?: string | null | undefined;
+        userAgent?: string | null | undefined;
+    } | null;
+    outcome: {
+        type: "human_done";
+    } | {
+        type: "disconnected";
+    } | {
+        type: "timeout";
+    } | {
+        type: "cancelled";
+        reason?: string | undefined;
+    } | {
+        type: "cdp_lost";
+    } | {
+        type: "encoder_crash";
+    } | {
+        type: "relay_error";
+        detail?: string | undefined;
+    } | null;
+    sessionId: string;
+    state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    createdAt: number;
+    endedAt: number | null;
+}>;
+type SessionInfo = z.infer<typeof SessionInfoSchema>;
+declare const SessionSummarySchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    state: z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>;
+    outcome: z.ZodNullable<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"human_done">;
+    }, "strip", z.ZodTypeAny, {
+        type: "human_done";
+    }, {
+        type: "human_done";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"disconnected">;
+    }, "strip", z.ZodTypeAny, {
+        type: "disconnected";
+    }, {
+        type: "disconnected";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"timeout">;
+    }, "strip", z.ZodTypeAny, {
+        type: "timeout";
+    }, {
+        type: "timeout";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cancelled">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "cancelled";
+        reason?: string | undefined;
+    }, {
+        type: "cancelled";
+        reason?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"cdp_lost">;
+    }, "strip", z.ZodTypeAny, {
+        type: "cdp_lost";
+    }, {
+        type: "cdp_lost";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"encoder_crash">;
+    }, "strip", z.ZodTypeAny, {
+        type: "encoder_crash";
+    }, {
+        type: "encoder_crash";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"relay_error">;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "relay_error";
+        detail?: string | undefined;
+    }, {
+        type: "relay_error";
+        detail?: string | undefined;
+    }>]>>;
+    prompt: z.ZodNullable<z.ZodString>;
+    viewerCount: z.ZodNumber;
+    actionCount: z.ZodNumber;
+    createdAt: z.ZodNumber;
+    endedAt: z.ZodNullable<z.ZodNumber>;
+    /** Last event-log append timestamp. */
+    updatedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    viewerCount: number;
+    prompt: string | null;
+    outcome: {
+        type: "human_done";
+    } | {
+        type: "disconnected";
+    } | {
+        type: "timeout";
+    } | {
+        type: "cancelled";
+        reason?: string | undefined;
+    } | {
+        type: "cdp_lost";
+    } | {
+        type: "encoder_crash";
+    } | {
+        type: "relay_error";
+        detail?: string | undefined;
+    } | null;
+    sessionId: string;
+    state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    createdAt: number;
+    endedAt: number | null;
+    actionCount: number;
+    updatedAt: number;
+}, {
+    viewerCount: number;
+    prompt: string | null;
+    outcome: {
+        type: "human_done";
+    } | {
+        type: "disconnected";
+    } | {
+        type: "timeout";
+    } | {
+        type: "cancelled";
+        reason?: string | undefined;
+    } | {
+        type: "cdp_lost";
+    } | {
+        type: "encoder_crash";
+    } | {
+        type: "relay_error";
+        detail?: string | undefined;
+    } | null;
+    sessionId: string;
+    state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    createdAt: number;
+    endedAt: number | null;
+    actionCount: number;
+    updatedAt: number;
+}>;
+type SessionSummary = z.infer<typeof SessionSummarySchema>;
+/** `GET /sessions/:sid/actions` */
+declare const SessionActionsResponseSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    currentUrl: z.ZodString;
+    actions: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"type">;
+        text: z.ZodString;
+        redacted: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }, {
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"paste">;
+        text: z.ZodString;
+        redacted: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }, {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"press">;
+        key: z.ZodString;
+        modifiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    }, {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"tap">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    }, {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"scroll">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        deltaX: z.ZodNumber;
+        deltaY: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    }, {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"navigate">;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "navigate";
+        ts: number;
+        url: string;
+    }, {
+        type: "navigate";
+        ts: number;
+        url: string;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"back">;
+    }, "strip", z.ZodTypeAny, {
+        type: "back";
+        ts: number;
+    }, {
+        type: "back";
+        ts: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"forward">;
+    }, "strip", z.ZodTypeAny, {
+        type: "forward";
+        ts: number;
+    }, {
+        type: "forward";
+        ts: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"reload">;
+    }, "strip", z.ZodTypeAny, {
+        type: "reload";
+        ts: number;
+    }, {
+        type: "reload";
+        ts: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"url_update">;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "url_update";
+        ts: number;
+        url: string;
+    }, {
+        type: "url_update";
+        ts: number;
+        url: string;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"human_done">;
+    }, "strip", z.ZodTypeAny, {
+        type: "human_done";
+        ts: number;
+    }, {
+        type: "human_done";
+        ts: number;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    currentUrl: string;
+    actions: ({
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    } | {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    } | {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    } | {
+        type: "navigate";
+        ts: number;
+        url: string;
+    } | {
+        type: "back";
+        ts: number;
+    } | {
+        type: "forward";
+        ts: number;
+    } | {
+        type: "reload";
+        ts: number;
+    } | {
+        type: "url_update";
+        ts: number;
+        url: string;
+    } | {
+        type: "human_done";
+        ts: number;
+    })[];
+}, {
+    sessionId: string;
+    currentUrl: string;
+    actions: ({
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    } | {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    } | {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    } | {
+        type: "navigate";
+        ts: number;
+        url: string;
+    } | {
+        type: "back";
+        ts: number;
+    } | {
+        type: "forward";
+        ts: number;
+    } | {
+        type: "reload";
+        ts: number;
+    } | {
+        type: "url_update";
+        ts: number;
+        url: string;
+    } | {
+        type: "human_done";
+        ts: number;
+    })[];
+}>;
+type SessionActionsResponse = z.infer<typeof SessionActionsResponseSchema>;
+/** `GET /sessions/:sid` */
+declare const SessionDetailResponseSchema: z.ZodObject<{
+    info: z.ZodObject<{
+        sessionId: z.ZodString;
+        state: z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>;
+        viewerCount: z.ZodNumber;
+        createdAt: z.ZodNumber;
+        /** Set when a terminal state is reached, null while still active. */
+        endedAt: z.ZodNullable<z.ZodNumber>;
+        outcome: z.ZodNullable<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"human_done">;
+        }, "strip", z.ZodTypeAny, {
+            type: "human_done";
+        }, {
+            type: "human_done";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"disconnected">;
+        }, "strip", z.ZodTypeAny, {
+            type: "disconnected";
+        }, {
+            type: "disconnected";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"timeout">;
+        }, "strip", z.ZodTypeAny, {
+            type: "timeout";
+        }, {
+            type: "timeout";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"cancelled">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "cancelled";
+            reason?: string | undefined;
+        }, {
+            type: "cancelled";
+            reason?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"cdp_lost">;
+        }, "strip", z.ZodTypeAny, {
+            type: "cdp_lost";
+        }, {
+            type: "cdp_lost";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"encoder_crash">;
+        }, "strip", z.ZodTypeAny, {
+            type: "encoder_crash";
+        }, {
+            type: "encoder_crash";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"relay_error">;
+            detail: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "relay_error";
+            detail?: string | undefined;
+        }, {
+            type: "relay_error";
+            detail?: string | undefined;
+        }>]>>;
+        prompt: z.ZodNullable<z.ZodString>;
+        publisher: z.ZodNullable<z.ZodObject<{
+            /** Package name, e.g. "@proxyhuman/mcp". */
+            name: z.ZodString;
+            /** Package version, e.g. "0.2.0". */
+            version: z.ZodString;
+            /** Optional host descriptor (OS / hostname) for diagnostic logs. */
+            host: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            version: string;
+            host?: string | undefined;
+        }, {
+            name: string;
+            version: string;
+            host?: string | undefined;
+        }>>;
+        target: z.ZodNullable<z.ZodObject<{
+            /** Chrome DevTools Protocol HTTP endpoint — diagnostic only. */
+            cdpUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /** Page URL when the publisher attached (first frame_navigated). */
+            initialUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /** Encoder viewport — the actual stream resolution. */
+            viewport: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                width: number;
+                height: number;
+            }, {
+                width: number;
+                height: number;
+            }>>>;
+            /** Browser identity from CDP `Browser.getVersion` (`product` field). */
+            browserVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            /** Full user-agent string of the attached page. */
+            userAgent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            cdpUrl?: string | null | undefined;
+            initialUrl?: string | null | undefined;
+            viewport?: {
+                width: number;
+                height: number;
+            } | null | undefined;
+            browserVersion?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }, {
+            cdpUrl?: string | null | undefined;
+            initialUrl?: string | null | undefined;
+            viewport?: {
+                width: number;
+                height: number;
+            } | null | undefined;
+            browserVersion?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        viewerCount: number;
+        prompt: string | null;
+        publisher: {
+            name: string;
+            version: string;
+            host?: string | undefined;
+        } | null;
+        target: {
+            cdpUrl?: string | null | undefined;
+            initialUrl?: string | null | undefined;
+            viewport?: {
+                width: number;
+                height: number;
+            } | null | undefined;
+            browserVersion?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        } | null;
+        outcome: {
+            type: "human_done";
+        } | {
+            type: "disconnected";
+        } | {
+            type: "timeout";
+        } | {
+            type: "cancelled";
+            reason?: string | undefined;
+        } | {
+            type: "cdp_lost";
+        } | {
+            type: "encoder_crash";
+        } | {
+            type: "relay_error";
+            detail?: string | undefined;
+        } | null;
+        sessionId: string;
+        state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+        createdAt: number;
+        endedAt: number | null;
+    }, {
+        viewerCount: number;
+        prompt: string | null;
+        publisher: {
+            name: string;
+            version: string;
+            host?: string | undefined;
+        } | null;
+        target: {
+            cdpUrl?: string | null | undefined;
+            initialUrl?: string | null | undefined;
+            viewport?: {
+                width: number;
+                height: number;
+            } | null | undefined;
+            browserVersion?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        } | null;
+        outcome: {
+            type: "human_done";
+        } | {
+            type: "disconnected";
+        } | {
+            type: "timeout";
+        } | {
+            type: "cancelled";
+            reason?: string | undefined;
+        } | {
+            type: "cdp_lost";
+        } | {
+            type: "encoder_crash";
+        } | {
+            type: "relay_error";
+            detail?: string | undefined;
+        } | null;
+        sessionId: string;
+        state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+        createdAt: number;
+        endedAt: number | null;
+    }>;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"state_changed">;
+        from: z.ZodNullable<z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>>;
+        to: z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "state_changed";
+        ts: number;
+        from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+        to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    }, {
+        type: "state_changed";
+        ts: number;
+        from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+        to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"viewer_joined">;
+        viewerCount: z.ZodNumber;
+        viewer: z.ZodOptional<z.ZodObject<{
+            /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+            deviceId: z.ZodNullable<z.ZodString>;
+            userAgent: z.ZodNullable<z.ZodString>;
+            ip: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "viewer_joined";
+        ts: number;
+        viewerCount: number;
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
+    }, {
+        type: "viewer_joined";
+        ts: number;
+        viewerCount: number;
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"viewer_left">;
+        viewerCount: z.ZodNumber;
+        viewer: z.ZodOptional<z.ZodObject<{
+            /** Random opaque id; persisted as the `ph_device` cookie on the viewer. */
+            deviceId: z.ZodNullable<z.ZodString>;
+            userAgent: z.ZodNullable<z.ZodString>;
+            ip: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }, {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "viewer_left";
+        ts: number;
+        viewerCount: number;
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
+    }, {
+        type: "viewer_left";
+        ts: number;
+        viewerCount: number;
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"action_recorded">;
+        action: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"type">;
+            text: z.ZodString;
+            redacted: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            type: "type";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        }, {
+            type: "type";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"paste">;
+            text: z.ZodString;
+            redacted: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            type: "paste";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        }, {
+            type: "paste";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"press">;
+            key: z.ZodString;
+            modifiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            type: "press";
+            ts: number;
+            key: string;
+            modifiers?: string[] | undefined;
+        }, {
+            type: "press";
+            ts: number;
+            key: string;
+            modifiers?: string[] | undefined;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"tap">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            type: "tap";
+            ts: number;
+            x: number;
+            y: number;
+        }, {
+            type: "tap";
+            ts: number;
+            x: number;
+            y: number;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"scroll">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            deltaX: z.ZodNumber;
+            deltaY: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            type: "scroll";
+            ts: number;
+            x: number;
+            y: number;
+            deltaX: number;
+            deltaY: number;
+        }, {
+            type: "scroll";
+            ts: number;
+            x: number;
+            y: number;
+            deltaX: number;
+            deltaY: number;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"navigate">;
+            url: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "navigate";
+            ts: number;
+            url: string;
+        }, {
+            type: "navigate";
+            ts: number;
+            url: string;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"back">;
+        }, "strip", z.ZodTypeAny, {
+            type: "back";
+            ts: number;
+        }, {
+            type: "back";
+            ts: number;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"forward">;
+        }, "strip", z.ZodTypeAny, {
+            type: "forward";
+            ts: number;
+        }, {
+            type: "forward";
+            ts: number;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"reload">;
+        }, "strip", z.ZodTypeAny, {
+            type: "reload";
+            ts: number;
+        }, {
+            type: "reload";
+            ts: number;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"url_update">;
+            url: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "url_update";
+            ts: number;
+            url: string;
+        }, {
+            type: "url_update";
+            ts: number;
+            url: string;
+        }>, z.ZodObject<{
+            ts: z.ZodNumber;
+            type: z.ZodLiteral<"human_done">;
+        }, "strip", z.ZodTypeAny, {
+            type: "human_done";
+            ts: number;
+        }, {
+            type: "human_done";
+            ts: number;
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "action_recorded";
+        ts: number;
+        action: {
+            type: "type";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        } | {
+            type: "paste";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        } | {
+            type: "press";
+            ts: number;
+            key: string;
+            modifiers?: string[] | undefined;
+        } | {
+            type: "tap";
+            ts: number;
+            x: number;
+            y: number;
+        } | {
+            type: "scroll";
+            ts: number;
+            x: number;
+            y: number;
+            deltaX: number;
+            deltaY: number;
+        } | {
+            type: "navigate";
+            ts: number;
+            url: string;
+        } | {
+            type: "back";
+            ts: number;
+        } | {
+            type: "forward";
+            ts: number;
+        } | {
+            type: "reload";
+            ts: number;
+        } | {
+            type: "url_update";
+            ts: number;
+            url: string;
+        } | {
+            type: "human_done";
+            ts: number;
+        };
+    }, {
+        type: "action_recorded";
+        ts: number;
+        action: {
+            type: "type";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        } | {
+            type: "paste";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        } | {
+            type: "press";
+            ts: number;
+            key: string;
+            modifiers?: string[] | undefined;
+        } | {
+            type: "tap";
+            ts: number;
+            x: number;
+            y: number;
+        } | {
+            type: "scroll";
+            ts: number;
+            x: number;
+            y: number;
+            deltaX: number;
+            deltaY: number;
+        } | {
+            type: "navigate";
+            ts: number;
+            url: string;
+        } | {
+            type: "back";
+            ts: number;
+        } | {
+            type: "forward";
+            ts: number;
+        } | {
+            type: "reload";
+            ts: number;
+        } | {
+            type: "url_update";
+            ts: number;
+            url: string;
+        } | {
+            type: "human_done";
+            ts: number;
+        };
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"error">;
+        message: z.ZodString;
+        detail: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        type: "error";
+        ts: number;
+        detail?: string | undefined;
+    }, {
+        message: string;
+        type: "error";
+        ts: number;
+        detail?: string | undefined;
+    }>]>, "many">;
+    actions: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"type">;
+        text: z.ZodString;
+        redacted: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }, {
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"paste">;
+        text: z.ZodString;
+        redacted: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }, {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"press">;
+        key: z.ZodString;
+        modifiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    }, {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"tap">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    }, {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"scroll">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        deltaX: z.ZodNumber;
+        deltaY: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    }, {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"navigate">;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "navigate";
+        ts: number;
+        url: string;
+    }, {
+        type: "navigate";
+        ts: number;
+        url: string;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"back">;
+    }, "strip", z.ZodTypeAny, {
+        type: "back";
+        ts: number;
+    }, {
+        type: "back";
+        ts: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"forward">;
+    }, "strip", z.ZodTypeAny, {
+        type: "forward";
+        ts: number;
+    }, {
+        type: "forward";
+        ts: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"reload">;
+    }, "strip", z.ZodTypeAny, {
+        type: "reload";
+        ts: number;
+    }, {
+        type: "reload";
+        ts: number;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"url_update">;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "url_update";
+        ts: number;
+        url: string;
+    }, {
+        type: "url_update";
+        ts: number;
+        url: string;
+    }>, z.ZodObject<{
+        ts: z.ZodNumber;
+        type: z.ZodLiteral<"human_done">;
+    }, "strip", z.ZodTypeAny, {
+        type: "human_done";
+        ts: number;
+    }, {
+        type: "human_done";
+        ts: number;
+    }>]>, "many">;
+    currentUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    currentUrl: string;
+    actions: ({
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    } | {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    } | {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    } | {
+        type: "navigate";
+        ts: number;
+        url: string;
+    } | {
+        type: "back";
+        ts: number;
+    } | {
+        type: "forward";
+        ts: number;
+    } | {
+        type: "reload";
+        ts: number;
+    } | {
+        type: "url_update";
+        ts: number;
+        url: string;
+    } | {
+        type: "human_done";
+        ts: number;
+    })[];
+    info: {
+        viewerCount: number;
+        prompt: string | null;
+        publisher: {
+            name: string;
+            version: string;
+            host?: string | undefined;
+        } | null;
+        target: {
+            cdpUrl?: string | null | undefined;
+            initialUrl?: string | null | undefined;
+            viewport?: {
+                width: number;
+                height: number;
+            } | null | undefined;
+            browserVersion?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        } | null;
+        outcome: {
+            type: "human_done";
+        } | {
+            type: "disconnected";
+        } | {
+            type: "timeout";
+        } | {
+            type: "cancelled";
+            reason?: string | undefined;
+        } | {
+            type: "cdp_lost";
+        } | {
+            type: "encoder_crash";
+        } | {
+            type: "relay_error";
+            detail?: string | undefined;
+        } | null;
+        sessionId: string;
+        state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+        createdAt: number;
+        endedAt: number | null;
+    };
+    events: ({
+        type: "state_changed";
+        ts: number;
+        from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+        to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    } | {
+        type: "viewer_joined";
+        ts: number;
+        viewerCount: number;
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
+    } | {
+        type: "viewer_left";
+        ts: number;
+        viewerCount: number;
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
+    } | {
+        type: "action_recorded";
+        ts: number;
+        action: {
+            type: "type";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        } | {
+            type: "paste";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        } | {
+            type: "press";
+            ts: number;
+            key: string;
+            modifiers?: string[] | undefined;
+        } | {
+            type: "tap";
+            ts: number;
+            x: number;
+            y: number;
+        } | {
+            type: "scroll";
+            ts: number;
+            x: number;
+            y: number;
+            deltaX: number;
+            deltaY: number;
+        } | {
+            type: "navigate";
+            ts: number;
+            url: string;
+        } | {
+            type: "back";
+            ts: number;
+        } | {
+            type: "forward";
+            ts: number;
+        } | {
+            type: "reload";
+            ts: number;
+        } | {
+            type: "url_update";
+            ts: number;
+            url: string;
+        } | {
+            type: "human_done";
+            ts: number;
+        };
+    } | {
+        message: string;
+        type: "error";
+        ts: number;
+        detail?: string | undefined;
+    })[];
+}, {
+    currentUrl: string;
+    actions: ({
+        type: "type";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "paste";
+        ts: number;
+        text: string;
+        redacted?: boolean | undefined;
+    } | {
+        type: "press";
+        ts: number;
+        key: string;
+        modifiers?: string[] | undefined;
+    } | {
+        type: "tap";
+        ts: number;
+        x: number;
+        y: number;
+    } | {
+        type: "scroll";
+        ts: number;
+        x: number;
+        y: number;
+        deltaX: number;
+        deltaY: number;
+    } | {
+        type: "navigate";
+        ts: number;
+        url: string;
+    } | {
+        type: "back";
+        ts: number;
+    } | {
+        type: "forward";
+        ts: number;
+    } | {
+        type: "reload";
+        ts: number;
+    } | {
+        type: "url_update";
+        ts: number;
+        url: string;
+    } | {
+        type: "human_done";
+        ts: number;
+    })[];
+    info: {
+        viewerCount: number;
+        prompt: string | null;
+        publisher: {
+            name: string;
+            version: string;
+            host?: string | undefined;
+        } | null;
+        target: {
+            cdpUrl?: string | null | undefined;
+            initialUrl?: string | null | undefined;
+            viewport?: {
+                width: number;
+                height: number;
+            } | null | undefined;
+            browserVersion?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        } | null;
+        outcome: {
+            type: "human_done";
+        } | {
+            type: "disconnected";
+        } | {
+            type: "timeout";
+        } | {
+            type: "cancelled";
+            reason?: string | undefined;
+        } | {
+            type: "cdp_lost";
+        } | {
+            type: "encoder_crash";
+        } | {
+            type: "relay_error";
+            detail?: string | undefined;
+        } | null;
+        sessionId: string;
+        state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+        createdAt: number;
+        endedAt: number | null;
+    };
+    events: ({
+        type: "state_changed";
+        ts: number;
+        from: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled" | null;
+        to: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+    } | {
+        type: "viewer_joined";
+        ts: number;
+        viewerCount: number;
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
+    } | {
+        type: "viewer_left";
+        ts: number;
+        viewerCount: number;
+        viewer?: {
+            userAgent: string | null;
+            deviceId: string | null;
+            ip: string | null;
+        } | undefined;
+    } | {
+        type: "action_recorded";
+        ts: number;
+        action: {
+            type: "type";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        } | {
+            type: "paste";
+            ts: number;
+            text: string;
+            redacted?: boolean | undefined;
+        } | {
+            type: "press";
+            ts: number;
+            key: string;
+            modifiers?: string[] | undefined;
+        } | {
+            type: "tap";
+            ts: number;
+            x: number;
+            y: number;
+        } | {
+            type: "scroll";
+            ts: number;
+            x: number;
+            y: number;
+            deltaX: number;
+            deltaY: number;
+        } | {
+            type: "navigate";
+            ts: number;
+            url: string;
+        } | {
+            type: "back";
+            ts: number;
+        } | {
+            type: "forward";
+            ts: number;
+        } | {
+            type: "reload";
+            ts: number;
+        } | {
+            type: "url_update";
+            ts: number;
+            url: string;
+        } | {
+            type: "human_done";
+            ts: number;
+        };
+    } | {
+        message: string;
+        type: "error";
+        ts: number;
+        detail?: string | undefined;
+    })[];
+}>;
+type SessionDetailResponse = z.infer<typeof SessionDetailResponseSchema>;
+/**
+ * `GET /users/me/sessions` (Clerk JWT) and `GET /sessions` (API key, used by
+ * the CLI to enumerate historical handoffs from the agent's box).
+ */
+declare const UserSessionsResponseSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        state: z.ZodEnum<["awaiting_viewer", "streaming", "paused", "complete", "failed", "cancelled"]>;
+        outcome: z.ZodNullable<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"human_done">;
+        }, "strip", z.ZodTypeAny, {
+            type: "human_done";
+        }, {
+            type: "human_done";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"disconnected">;
+        }, "strip", z.ZodTypeAny, {
+            type: "disconnected";
+        }, {
+            type: "disconnected";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"timeout">;
+        }, "strip", z.ZodTypeAny, {
+            type: "timeout";
+        }, {
+            type: "timeout";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"cancelled">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "cancelled";
+            reason?: string | undefined;
+        }, {
+            type: "cancelled";
+            reason?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"cdp_lost">;
+        }, "strip", z.ZodTypeAny, {
+            type: "cdp_lost";
+        }, {
+            type: "cdp_lost";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"encoder_crash">;
+        }, "strip", z.ZodTypeAny, {
+            type: "encoder_crash";
+        }, {
+            type: "encoder_crash";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"relay_error">;
+            detail: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "relay_error";
+            detail?: string | undefined;
+        }, {
+            type: "relay_error";
+            detail?: string | undefined;
+        }>]>>;
+        prompt: z.ZodNullable<z.ZodString>;
+        viewerCount: z.ZodNumber;
+        actionCount: z.ZodNumber;
+        createdAt: z.ZodNumber;
+        endedAt: z.ZodNullable<z.ZodNumber>;
+        /** Last event-log append timestamp. */
+        updatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        viewerCount: number;
+        prompt: string | null;
+        outcome: {
+            type: "human_done";
+        } | {
+            type: "disconnected";
+        } | {
+            type: "timeout";
+        } | {
+            type: "cancelled";
+            reason?: string | undefined;
+        } | {
+            type: "cdp_lost";
+        } | {
+            type: "encoder_crash";
+        } | {
+            type: "relay_error";
+            detail?: string | undefined;
+        } | null;
+        sessionId: string;
+        state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+        createdAt: number;
+        endedAt: number | null;
+        actionCount: number;
+        updatedAt: number;
+    }, {
+        viewerCount: number;
+        prompt: string | null;
+        outcome: {
+            type: "human_done";
+        } | {
+            type: "disconnected";
+        } | {
+            type: "timeout";
+        } | {
+            type: "cancelled";
+            reason?: string | undefined;
+        } | {
+            type: "cdp_lost";
+        } | {
+            type: "encoder_crash";
+        } | {
+            type: "relay_error";
+            detail?: string | undefined;
+        } | null;
+        sessionId: string;
+        state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+        createdAt: number;
+        endedAt: number | null;
+        actionCount: number;
+        updatedAt: number;
+    }>, "many">;
+    /** Opaque cursor for the next page, or null when there are no more. */
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sessions: {
+        viewerCount: number;
+        prompt: string | null;
+        outcome: {
+            type: "human_done";
+        } | {
+            type: "disconnected";
+        } | {
+            type: "timeout";
+        } | {
+            type: "cancelled";
+            reason?: string | undefined;
+        } | {
+            type: "cdp_lost";
+        } | {
+            type: "encoder_crash";
+        } | {
+            type: "relay_error";
+            detail?: string | undefined;
+        } | null;
+        sessionId: string;
+        state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+        createdAt: number;
+        endedAt: number | null;
+        actionCount: number;
+        updatedAt: number;
+    }[];
+    nextCursor: string | null;
+}, {
+    sessions: {
+        viewerCount: number;
+        prompt: string | null;
+        outcome: {
+            type: "human_done";
+        } | {
+            type: "disconnected";
+        } | {
+            type: "timeout";
+        } | {
+            type: "cancelled";
+            reason?: string | undefined;
+        } | {
+            type: "cdp_lost";
+        } | {
+            type: "encoder_crash";
+        } | {
+            type: "relay_error";
+            detail?: string | undefined;
+        } | null;
+        sessionId: string;
+        state: "awaiting_viewer" | "streaming" | "paused" | "complete" | "failed" | "cancelled";
+        createdAt: number;
+        endedAt: number | null;
+        actionCount: number;
+        updatedAt: number;
+    }[];
+    nextCursor: string | null;
+}>;
+type UserSessionsResponse = z.infer<typeof UserSessionsResponseSchema>;
+
+export { type ApiToPublisher, ApiToPublisherSchema, type ApiToViewer, ApiToViewerSchema, type CancelHandoff, CancelHandoffSchema, type FocusChanged, FocusChangedSchema, type IceServer, IceServerSchema, type KeyboardModifiers, KeyboardModifiersSchema, type NewSession, NewSessionSchema, type PublishStarted, PublishStartedSchema, type PublisherInfo, PublisherInfoSchema, type PublisherToApi, PublisherToApiSchema, type RecordedAction, RecordedActionSchema, type SessionActionsResponse, SessionActionsResponseSchema, type SessionDetailResponse, SessionDetailResponseSchema, type SessionEnded, SessionEndedSchema, type SessionEvent, SessionEventSchema, type SessionInfo, SessionInfoSchema, type SessionOutcome, SessionOutcomeSchema, type SessionReady, SessionReadySchema, type SessionState, SessionStateSchema, type SessionSummary, SessionSummarySchema, type StateChanged, StateChangedSchema, type StreamReady, StreamReadySchema, TERMINAL_STATES, type TargetInfo, TargetInfoSchema, type UrlUpdate, UrlUpdateSchema, type UserSessionsResponse, UserSessionsResponseSchema, type ViewerCommand, ViewerCommandSchema, type ViewerInfo, ViewerInfoSchema, type ViewerJoined, ViewerJoinedSchema, type ViewerLeft, ViewerLeftSchema, type ViewerToApi, ViewerToApiSchema, type Viewport, ViewportSchema, isTerminalState };