cascade-ai 0.79.0 → 0.81.0

package/dist/index.d.cts

@@ -1020,7 +1020,7 @@ interface ThemeColors {
     t2Color: string;
     t3Color: string;
 }
-type CascadeEventType = 'task:start' | 'task:complete' | 'task:error' | 'tier:status' | 'tier:result' | 'tier:root' | 'stream:token' | 'stream:done' | 'tool:approval-request' | 'tool:approval-response' | 'tool:execute' | 'tool:result' | 'tool:call' | 'cost:update' | 'session:save' | 'escalation' | 'peer:sync' | 'peer:message' | 'plan' | 'log' | 'run:cancelled' | 'budget:warning' | 'budget:exceeded' | 'permission:user-required' | 'mcp:approval-required' | 'plan:approval-required' | 'context:approval-required' | 'context:compacted';
+type CascadeEventType = 'task:start' | 'task:complete' | 'task:error' | 'tier:status' | 'tier:result' | 'tier:root' | 'stream:token' | 'stream:done' | 'tool:approval-request' | 'tool:approval-response' | 'tool:execute' | 'tool:result' | 'tool:call' | 'cost:update' | 'session:save' | 'escalation' | 'peer:sync' | 'peer:message' | 'plan' | 'log' | 'run:cancelled' | 'budget:warning' | 'budget:exceeded' | 'permission:user-required' | 'mcp:approval-required' | 'plan:approval-required' | 'context:approval-required' | 'context:approval-closed' | 'context:compacted';
 interface CascadeEvent<T = unknown> {
     type: CascadeEventType;
     taskId?: string;
@@ -3333,6 +3333,78 @@ declare class BrowserControlTool extends BaseTool {
     execute(input: Record<string, unknown>, options: ToolExecuteOptions): Promise<string>;
 }
 
+/** One thing the model needs to know before it can act. */
+interface ClarificationQuestion {
+    /** Assigned here, never by the model: two questions with one id lose an answer. */
+    id: string;
+    prompt: string;
+    /** `choice` picks one, `multi` picks any, `text` is free-form. */
+    kind: 'choice' | 'multi' | 'text';
+    /** Required for `choice` and `multi`; meaningless for `text`. */
+    options?: string[];
+}
+interface ClarificationAnswer {
+    id: string;
+    /** One option, several, or typed text — matching the question's `kind`. */
+    value: string | string[];
+}
+/**
+ * Why a questionnaire came back empty.
+ *
+ * Distinguished because they mean different things to a reader of the
+ * transcript: nobody was there to ask, the person was asked and did not
+ * answer, or the run ended underneath the question.
+ */
+type ClarificationOutcome = 'answered' | 'no-listener' | 'timeout' | 'aborted';
+interface ClarificationResult {
+    outcome: ClarificationOutcome;
+    answers: ClarificationAnswer[];
+}
+/** What the host does with a questionnaire. Supplied by `Cascade`. */
+type ClarificationAsker = (questions: ClarificationQuestion[], signal: AbortSignal | undefined) => Promise<ClarificationResult>;
+declare class AskUserTool extends BaseTool {
+    readonly name = "ask_user";
+    readonly description: string;
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            questions: {
+                type: string;
+                minItems: number;
+                maxItems: number;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        prompt: {
+                            type: string;
+                            description: string;
+                        };
+                        kind: {
+                            type: string;
+                            enum: string[];
+                            description: string;
+                        };
+                        options: {
+                            type: string;
+                            items: {
+                                type: string;
+                            };
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+    private ask;
+    constructor(ask: ClarificationAsker);
+    isDangerous(): boolean;
+    execute(input: Record<string, unknown>, options: ToolExecuteOptions): Promise<string>;
+}
+
 /** One entry in the per-run orchestration decision trail (see /why). */
 interface DecisionLogEntry {
     at: string;
@@ -3427,6 +3499,77 @@ declare class Cascade extends EventEmitter {
     private pendingPlanApproval?;
     private requestPlanApproval;
     private pendingEscalations;
+    /**
+     * Questionnaires waiting on a person, keyed by request id.
+     *
+     * Exactly the shape `pendingEscalations` uses, and for the same reason: the
+     * answer, the timeout and the abort all race, and one settle path guarded by
+     * the map delete is what makes the first of them win.
+     */
+    private pendingClarifications;
+    /**
+     * Put a gate's opening question to its listeners, and NOTICE when one fails.
+     *
+     * `emit` cannot do this job. It calls listeners synchronously and discards
+     * what they return, so an `async` listener — the ordinary shape for anything
+     * that has to reach a socket or a UI — does not fail in a way `emit` reports:
+     * it returns a REJECTED PROMISE that nobody is holding. The `try` around the
+     * emit sees nothing, the gate is never told delivery failed, and it parks for
+     * its full timeout while Node raises an unhandled rejection that can take the
+     * process down.
+     *
+     * `onFailed` is called for either shape, and it is safe to call more than
+     * once: both gates route it to `settle`, which is guarded by a map delete, so
+     * the first failure wins and the rest are no-ops.
+     *
+     * PER LISTENER, not around the loop. `emit` stops dispatching at the first
+     * throw, so one broken host used to cost a working one its notification —
+     * the same reason `announceLiveView` delivers its two listeners separately.
+     * A synchronous failure settles the gate once the whole snapshot has been
+     * delivered; an asynchronous one settles it when the rejection arrives, which
+     * is still far better than the window-long park it replaces.
+     *
+     * SETTLED AFTER THE LOOP, not inside it, and that is not tidiness. `onFailed`
+     * settles the gate, and settling emits the gate's CLOSURE — so failing
+     * mid-dispatch announced "this request is over" and then went on handing the
+     * OPENING event to the listeners after it. A host later in the list would
+     * draw a form whose only closure notification had already gone past, and it
+     * would stand there forever. Deliver to everyone, then decide.
+     *
+     * `rawListeners`, NOT `listeners`. Bypassing `emit` means taking on what
+     * `emit` was doing, and `once` is the part that bites: `listeners()` hands
+     * back the UNWRAPPED callback, so calling it never runs the wrapper that
+     * deregisters it. A host that asked to be told once would be told every
+     * time — and told through a transport it had set up for one gate only.
+     * `rawListeners()` returns the wrapper, which removes the registration and
+     * passes the underlying listener's return value straight through, so the
+     * promise below is still the one being observed. Verified against Node.
+     *
+     * `.call(this, …)`, which is the third thing `emit` was doing. EventEmitter
+     * invokes listeners with the emitter as the receiver, so
+     * `function () { this.resolveClarification(...) }` is a legitimate host — and
+     * calling it bare gave it `this === undefined`, which throws, which this
+     * would then have read as the host failing to receive the question and
+     * settled the gate unanswered. A working listener turned into a delivery
+     * failure by the thing delivering it.
+     */
+    private deliverGate;
+    /**
+     * Tell listeners something that is over, and let none of them make it worse.
+     *
+     * The closing half of the gate family — `clarification:closed`,
+     * `clarification:timeout`, `escalation:closed`, `escalation:timeout`. Each
+     * was already wrapped in a `try` for the synchronous case, and each had the
+     * same hole `deliverGate` had before last round: `emit` discards what a
+     * listener returns, so an `async` host fails by returning a rejected promise
+     * nobody is holding and Node raises an unhandled rejection.
+     *
+     * There is nothing to settle here — the gate is already closed, which is the
+     * whole message — so unlike `deliverGate` this reports to no one. It exists
+     * so that the four informational emits cannot take the process down, and so
+     * the rule is written once rather than four times.
+     */
+    private announceGateClosed;
     private requestEscalationDecision;
     /**
      * Resolve a pending escalation from a REPL / dashboard / cloud listener.
@@ -3452,6 +3595,27 @@ declare class Cascade extends EventEmitter {
      * reviewing and accepting that section's output.
      */
     private releasePendingEscalations;
+    /**
+     * Put a questionnaire to whoever is watching, if anybody is.
+     *
+     * Returns `no-listener` rather than waiting when there is nothing attached to
+     * answer — a scheduled run, an API caller with no socket, an autonomous run
+     * that has already said it wants no prompts. That check is the whole reason
+     * this can be offered to the model at all: a tool that might hang a headless
+     * run forever is a tool that cannot be registered.
+     */
+    askUser(questions: ClarificationQuestion[], signal?: AbortSignal): Promise<ClarificationResult>;
+    /**
+     * Answer a questionnaire from a REPL / dashboard / cloud listener.
+     *
+     * `requestId` comes back on the `clarification:required` event and is what
+     * makes an answer land on the question that asked. Optional for a host with
+     * only one in flight, matching `resolveEscalation`: without it the oldest
+     * outstanding request is answered, which is correct whenever there is one.
+     */
+    resolveClarification(answers: ClarificationAnswer[], requestId?: string): void;
+    /** Release every parked questionnaire — run teardown, so none outlive the run. */
+    private releasePendingClarifications;
     /**
      * Resolve a pending boardroom plan approval from a REPL / dashboard listener.
      * An optional `note` re-plans and re-asks; an optional `editedPlan` is applied
@@ -3572,6 +3736,29 @@ declare class Cascade extends EventEmitter {
      * and not the other is silent on the surface that missed it.
      */
     private registerBrowserControl;
+    /**
+     * Declare that this host can put a questionnaire to a person and answer it.
+     *
+     * Explicit, and NOT done at construction, because registering a tool is a
+     * promise the host has to keep. A host that registers `ask_user` without
+     * listening for `clarification:required` gives the model a tool that always
+     * answers "there is nobody watching this run" — while a person sits at the
+     * terminal looking at it. That is worse than not offering the tool at all:
+     * it costs a round trip and then tells the model something false.
+     *
+     * Only `cloud/server` bridges the protocol today. The CLI REPL and the
+     * dashboard do not, so they do not call this, and their models are not shown
+     * a capability nobody can serve. Wiring either of them is a matter of
+     * listening for the event and calling `resolveClarification`, then calling
+     * this.
+     *
+     * Still gated on the same conditions as the call itself, and `askUser`
+     * re-checks them: `setUnattended` can land after this, so the tool can be
+     * registered for a run that later turns out to have nobody on it. Then it
+     * answers `no-listener` and the model proceeds on its own reading, which is
+     * the same defence-in-depth `BrowserControlTool.revoke` provides.
+     */
+    enableClarification(): void;
     private registerMediaTools;
     /**
      * Register `generate_document` where there is a real workspace to write into.
@@ -6835,6 +7022,21 @@ interface RemoteBrowserSession {
      * than the one that owns the run.
      */
     liveViewUrl?: string;
+    /**
+     * How long the provider will keep this session before reaping it, in ms.
+     *
+     * Reported by the provider, never chosen by us: Steel's create API accepts
+     * no timeout field (verified against the API source — see steel.ts), so this
+     * ceiling is the provider's and the only thing we can do about it is know
+     * what it is. Absent where a provider says nothing, which includes a bare
+     * CDP endpoint: that browser is somebody else's and has no session at all.
+     *
+     * Worth surfacing because a session that outlives its usefulness dies at
+     * exactly this number, and a leak is otherwise indistinguishable from a
+     * deliberate shutdown — two field sessions ended at precisely 0:05:00 with
+     * nothing anywhere recording that five minutes was the limit.
+     */
+    expiresInMs?: number;
 }
 /**
  * Somewhere to get a browser from.
@@ -6889,6 +7091,88 @@ interface BrowserViewInfo {
     /** Where to watch it, when the provider can stream one. */
     liveViewUrl?: string;
 }
+/**
+ * One rendered frame of a run's browser, on its way to whoever is watching.
+ *
+ * A JPEG rather than a video stream, and deliberately: CDP's screencast is
+ * adaptive — Chrome sends a frame when the page actually changes, not on a
+ * clock — so an idle page costs nothing, and there is no media pipeline to run
+ * inside the deployment. It is worse than WebRTC for video-heavy pages and
+ * better than it for everything else this feature is pointed at.
+ */
+interface BrowserFrame {
+    /** base64 JPEG, as CDP hands it over. Never decoded on the way through. */
+    data: string;
+    /** The remote viewport, so a canvas can size itself without guessing. */
+    width: number;
+    height: number;
+    /**
+     * Which watch this frame belongs to. See `watchGen`.
+     *
+     * Travels with the picture so the receipt the client sends back names the
+     * watch it actually saw, rather than whichever one is current by the time it
+     * arrives.
+     */
+    generation: number;
+}
+/** Who is driving a run's browser, and whether it is being pictured. */
+interface BrowserControlState {
+    /** True while a person holds it and the agent is being refused. */
+    human: boolean;
+    /** Whether frames are being produced right now. See `setCapture`. */
+    capturing: boolean;
+    /**
+     * Whether THIS watch has confirmed receiving a picture. See `seenGen`.
+     *
+     * Pushed rather than inferred, for the same reason ownership is: the client
+     * cannot work it out while the picture is off, because it is the frames that
+     * would tell it. A client left to guess would guess from what it remembers of
+     * a previous watch, which is exactly the state this distinguishes.
+     */
+    confirmed: boolean;
+}
+/**
+ * One thing a person did to the page while they held it.
+ *
+ * Coordinates are NORMALISED — 0..1 across the frame — rather than pixels, and
+ * that is a boundary decision rather than a convenience. The picture the user
+ * clicked is a JPEG scaled twice on its way to them: once by CDP into
+ * `maxWidth`/`maxHeight`, once by the panel into whatever width the layout
+ * gave it. Only this side knows the viewport those pixels came from, so only
+ * this side can turn a click back into a page coordinate. A client sending
+ * pixels would have to reconstruct both scalings and would silently miss by a
+ * few pixels whenever it got one wrong — which, on a page of small controls, is
+ * a click on the wrong thing.
+ *
+ * Typing is `text` rather than a stream of key events because `Input.insertText`
+ * puts the whole string in at once: no IME to emulate, no per-character key
+ * codes to get wrong for anything but a US layout, and no chance of a password
+ * arriving one keystroke per socket message. `key` covers the keys that are
+ * commands rather than characters, from a fixed list — see `KEYS`.
+ */
+type BrowserInput = {
+    kind: 'move';
+    x: number;
+    y: number;
+} | {
+    kind: 'click';
+    x: number;
+    y: number;
+    button?: 'left' | 'right' | 'middle';
+    clicks?: number;
+} | {
+    kind: 'scroll';
+    x: number;
+    y: number;
+    deltaY: number;
+} | {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'key';
+    key: string;
+    modifiers?: Array<'Control' | 'Meta' | 'Shift'>;
+};
 interface RemoteBrowserControllerOptions {
     provider: RemoteBrowserProvider;
     /**
@@ -6896,8 +7180,51 @@ interface RemoteBrowserControllerOptions {
      * a wave of workers each opening their own is a cost nobody chose.
      */
     maxSessions?: number;
-    /** Told when a run's live view becomes available, so the owner can watch. */
-    onLiveView?: (runId: string, liveViewUrl: string | undefined) => void;
+    /**
+     * Told when a run's live view becomes available, so the owner can watch.
+     *
+     * `void | Promise<void>`, like `onReleaseFailed` below and for the same
+     * reason: an async sink is the ordinary shape, TypeScript accepts one
+     * wherever a `void` return is declared, and a signature promising `void`
+     * tells an embedder their rejection is somebody's problem when it is
+     * nobody's. `announceLiveView` observes it.
+     */
+    onLiveView?: (runId: string, liveViewUrl: string | undefined) => void | Promise<void>;
+    /**
+     * Told when a provider session could not be handed back.
+     *
+     * Release is best-effort by design — a run that has finished must not be
+     * reported as failed because the provider was briefly unreachable — but
+     * best-effort is not the same as unobservable. A release that silently did
+     * not happen leaves a billed browser running until the provider's own
+     * timeout collects it, and without this there is no way to tell that from a
+     * clean handback.
+     */
+    /**
+     * `void | Promise<void>`: an async sink is the ordinary shape for telemetry,
+     * and a signature promising `void` tells an embedder their rejection is
+     * somebody's problem when it is nobody's. `reportReleaseFailure` observes it.
+     */
+    onReleaseFailed?: (runId: string, sessionId: string, err: unknown, expiresInMs?: number) => void | Promise<void>;
+    /**
+     * Something that must finish before this controller may open anything.
+     *
+     * For ROTATION. A settings change builds a new controller and disposes the
+     * old one, and disposal is not instant: it detaches CDP sessions and hands
+     * provider sessions back over the network. Installing the replacement
+     * immediately meant the first action after a rotation could call
+     * `createSession` while the previous controller was still releasing — two
+     * controllers holding sessions against one provider's cap, which the pool
+     * here cannot see because it counts only its own. On a provider that
+     * enforces its own limit that action simply fails, and it is the first one
+     * after an operator changed a setting, which is the worst moment for it.
+     *
+     * Awaited once, before the pool slot is reserved, and never awaited again.
+     * A rejection is ignored on purpose: the old controller failing to tidy up
+     * is not a reason to refuse the new one work, and `dispose` already reports
+     * its own trouble.
+     */
+    ready?: Promise<unknown>;
 }
 declare class RemoteBrowserController {
     private provider;
@@ -6911,8 +7238,47 @@ declare class RemoteBrowserController {
      * bearer capability for a browser somebody else is driving.
      */
     private liveViewListeners;
+    /**
+     * Told when a run's browser changes hands, or stops being pictured.
+     *
+     * Needed because a takeover can end without anybody asking. The hold lapses
+     * on its own after `HUMAN_IDLE_MS`, and a client left believing it still has
+     * control would keep sending input into a lease it no longer holds — every
+     * event refused, with nothing on screen saying why.
+     */
+    private controlListeners;
+    /** What each run's listener was last told, so unchanged states stay quiet. */
+    private controlAnnounced;
     /** An embedder that wants every run's live view, told which run each is. */
     private onLiveViewAll;
+    /** Told when a provider session could not be handed back. See `disposeRun`. */
+    private onReleaseFailed;
+    /**
+     * Tell the observer a session leaked, without letting it become the leak.
+     *
+     * Guarded, because this runs inside a `.catch` on the release: an observer
+     * that throws — a logging or telemetry sink that is momentarily unavailable
+     * is the ordinary case — would turn its own failure into a fresh rejection
+     * from `disposeRun`, so `endRun` would reject before `forgetRun` and the
+     * fire-and-forget `stopRun` path would raise an unhandled rejection.
+     *
+     * That is precisely the guarantee this whole change claims to preserve: a
+     * release that fails must never fail the run. Reporting it cannot be the
+     * thing that breaks it.
+     *
+     * TWO WAYS TO FAIL, not one. The `try` catches a synchronous throw; an
+     * `async` sink — which is what a telemetry or logging callback usually is —
+     * fails by returning a REJECTED PROMISE, which no `try` around a call that is
+     * never awaited can see. Node then raises an unhandled rejection and can take
+     * the process down: the observer would not merely have failed to report the
+     * leak, it would have killed the run, which is the one outcome this function
+     * exists to prevent, reached through the door the guard did not cover.
+     *
+     * Not awaited, though. The caller is a `.catch` on the release and is not
+     * going to wait for a telemetry round trip; attaching a handler is what makes
+     * the rejection observed, which is the whole requirement.
+     */
+    private reportReleaseFailure;
     private runs;
     /**
      * Runs that have a pool slot but no browser yet.
@@ -6967,12 +7333,46 @@ declare class RemoteBrowserController {
      */
     private leases;
     constructor(options: RemoteBrowserControllerOptions);
+    /**
+     * The predecessor's teardown, until it has been waited for once.
+     *
+     * Cleared as soon as it settles so the wait is not re-entered on every open
+     * — and so the promise itself is not retained for the life of the process.
+     */
+    private ready;
+    /**
+     * This controller has been retired and will never open anything again.
+     *
+     * Stronger than "its runs were ended", and it has to be. A caller parked on
+     * the `ready` gate above is invisible to `dispose()` — it holds no run and
+     * has reserved no slot, because it has not got that far — so a SECOND
+     * settings change, arriving while the first retirement is still settling,
+     * found nothing to wait for and let the newest controller start immediately.
+     * The parked caller then woke up on a controller nobody holds a reference to
+     * and allocated a session against the superseded configuration, with the
+     * newest controller free to allocate its own.
+     *
+     * Set synchronously at the top of `dispose`, so anything already waiting is
+     * excluded the moment retirement begins rather than when it finishes.
+     */
+    private retired;
     private leaseFor;
     /** The controller to hand to `Cascade.setBrowserController`. */
     get controller(): (action: BrowserAction, context: BrowserActionContext) => Promise<BrowserActionOutcome>;
     /** Watch one run's browser. The URL never goes to any other run's listener. */
-    onLiveViewFor(runKey: string, listener: (info: BrowserViewInfo) => void): void;
+    onLiveViewFor(runKey: string, listener: (info: BrowserViewInfo) => void | Promise<void>): void;
     offLiveViewFor(runKey: string): void;
+    onControlFor(runKey: string, listener: (state: BrowserControlState) => void | Promise<void>): void;
+    offControlFor(runKey: string): void;
+    /**
+     * Say who has the browser, but only when the answer has changed.
+     *
+     * The lease reports every ownership change, and during ordinary work that is
+     * one per action as workers take it and give it back. None of those are
+     * interesting to a viewer — the agent had it before and has it now — and
+     * emitting them would put a socket message on every click the agent makes.
+     */
+    private announceControl;
     /**
      * Tell a run's listener what its browser situation is.
      *
@@ -6995,6 +7395,184 @@ declare class RemoteBrowserController {
     dispose(): Promise<void>;
     /** A worker finished; it will never ask for the browser again. */
     actorEnded(actorId: string): void;
+    /**
+     * Start streaming this run's page to whoever is watching it.
+     *
+     * Nothing streams until someone asks. That is the whole reason this is a
+     * method rather than something `open()` does: an unwatched run would
+     * otherwise pay to encode frames nobody sees, on every run, forever — and on
+     * a metered provider it would pay for the bandwidth too.
+     *
+     * Frames are ACKED after they are handed on, never before. Chrome sends the
+     * next frame only once the previous is acknowledged, so this bounds it to one
+     * outstanding frame against OUR OWN handling. It does not reach further than
+     * that, and an earlier version of this comment claimed it did: `onFrame` ends
+     * at a socket emit, which hands the JPEG to a transport rather than to a
+     * viewer, so the ack says nothing about what the person actually received.
+     * Bounding the rest of the path is the transport's job — see `emitFrame`,
+     * where frames go out lossy so a slow connection drops pictures instead of
+     * banking stale ones. Dropping the ack stops the stream dead, which is why it
+     * is best-effort but unconditional.
+     *
+     * Returns false when there is nothing to watch — the run has no browser, or
+     * it is already being watched. Callers use that to avoid promising a viewer
+     * a stream that will never arrive.
+     */
+    startWatching(runId: string, onFrame: (frame: BrowserFrame) => void | Promise<void>): Promise<boolean>;
+    /**
+     * Run one watch or unwatch after every one already asked for.
+     *
+     * The chain is kept non-rejecting on purpose: a failed attach must not poison
+     * every later request for this run, which is what a bare `.then` chain would
+     * do. The caller still sees its own failure, because that is the promise
+     * returned rather than the one stored.
+     */
+    private queueWatch;
+    /**
+     * Attach at most one physical CDP screencast session at a time.
+     *
+     * `startWatching()` already serializes watcher lifecycle through `watchQueue`,
+     * but the agent's detached-hidden restore cannot join that queue: it holds the
+     * action slot, while an earlier unwatch may be waiting for exactly that slot.
+     * Sharing only the physical attach closes the two-session race without making
+     * watcher teardown and agent mutation wait on each other in a cycle.
+     *
+     * A real watcher claims `onFrame` immediately, before it waits for an attach
+     * already started by the agent. The lower-level attach never writes the sink,
+     * so finishing an older temporary attempt cannot overwrite a newer viewer.
+     */
+    private attachScreencast;
+    /** Open one new CDP session and start the stream when it is safe to do so. */
+    private attachScreencastFresh;
+    /** Nobody is watching any more: stop paying to render frames. */
+    stopWatching(runId: string): Promise<void>;
+    /**
+     * Suspend or resume the picture without giving up control.
+     *
+     * The credential case, and the only reason this is separate from watching. A
+     * person who has taken the page over to sign in is about to type a password
+     * into a field whose contents are echoed as dots — but a password manager's
+     * dropdown, a "show password" toggle, a one-time code in plain text and the
+     * confirmation page afterwards are not, and all of them would otherwise be
+     * encoded into frames and sent across the network.
+     *
+     * What this does NOT do is hide anything from the agent: it stops the
+     * picture, not the page. Nothing about a suspended capture would stop a
+     * `extract_text` from reading the same screen — it is the lease that stops
+     * that, by refusing the agent for as long as the person holds it.
+     *
+     * Answers whether frames are flowing afterwards, which is what a UI needs to
+     * show and is not always what was asked for: a run with nobody watching has
+     * no session to suspend.
+     */
+    setCapture(runId: string, on: boolean): Promise<boolean>;
+    /**
+     * The capture transition itself, with no lease bookkeeping.
+     *
+     * Separate because the agent's restore in `act()` already holds the action
+     * slot — taking it again there would deadlock against itself, and the whole
+     * point of that call site is that it happens INSIDE the agent's turn.
+     *
+     * `confirmWithFrame` is used only by the agent's visibility gate. There, a
+     * successful CDP command is not enough: the externally visible state remains
+     * paused until a frame arrives, and the frame handler is the only code that
+     * promotes it to capturing. This makes a restore timeout sticky rather than
+     * a one-action refusal.
+     */
+    private applyCapture;
+    /**
+     * Wait, briefly, for Chrome to produce a frame.
+     *
+     * `Page.startScreencast` resolves when the command is accepted, which is not
+     * when a picture exists. The agent's visibility gate — "the page must be
+     * VISIBLE before anything changes it" — was therefore satisfied by a request
+     * rather than by a repaint, and the agent could click while the panel was
+     * still showing the page from before it was hidden, or nothing at all.
+     *
+     * A frame rather than a client receipt, deliberately. A receipt would prove
+     * somebody SAW it, which is stronger — and would make the agent's progress
+     * depend on a viewer that may not exist: this path runs after a handback or a
+     * lapse, when there may be nobody watching at all, and an agent that stalls
+     * because a tab was closed is a worse failure than the one being fixed. What
+     * this does guarantee is ours to guarantee: the stream is producing again.
+     *
+     * Bounded, and the bound rests on the property rounds 14 and 15 already rely
+     * on — a screencast that has just been started emits its first frame at once,
+     * whatever the page is doing. If one does not arrive, the picture genuinely
+     * has not come back, and the caller refuses on the same trade it already
+     * makes when the restore itself fails.
+     */
+    private nextFrame;
+    /** Whether a person is driving this run's browser right now. */
+    humanHolds(runId: string): boolean;
+    /**
+     * Hand this run's browser to the person watching it.
+     *
+     * The wait is the substance. An agent action already inside Playwright cannot
+     * be interrupted — `click` waits for its element to become actionable and
+     * then clicks, whatever anyone decided in the meantime — so a takeover that
+     * returned immediately would put the person on a page an action was still
+     * about to change. Bounded by the action ceiling, because that is the longest
+     * an action can legitimately take; past it something is wedged, and saying so
+     * is better than a spinner that never resolves.
+     *
+     * Idempotent for someone who already holds it: a second click of Take control
+     * just says they are still there.
+     */
+    takeOver(runId: string): Promise<{
+        ok: boolean;
+        detail?: string;
+    }>;
+    /** The person is done. Answers whether they were holding it at all. */
+    /**
+     * The viewer confirms it received a picture of this run's page.
+     *
+     * Reliable, one per watch, and the only thing that opens Hide. Checked
+     * against the CURRENT watch: a receipt that names an older one is from a
+     * viewer that has since been replaced, and vouching for its successor is the
+     * reconnect hole this counter exists to close.
+     */
+    frameSeen(runId: string, generation: number): void;
+    handBack(runId: string): boolean;
+    /**
+     * One thing the person did to the page.
+     *
+     * Authorised per event, not per session. A takeover is not a channel that
+     * stays open once opened: between two clicks the run can be stopped, the hold
+     * can lapse, the page can close, and each of those has to stop the NEXT
+     * event rather than be noticed at the end. So every event re-checks that this
+     * run is live and that the lease is still the person's, and every accepted
+     * event says so by extending the hold.
+     */
+    input(runId: string, event: BrowserInput): Promise<{
+        ok: boolean;
+        detail?: string;
+    }>;
+    /**
+     * The page's own coordinate space, measured rather than inferred.
+     *
+     * Cached, because a click should not cost a round trip, and invalidated by
+     * the frame metadata changing shape — which arrives free with every frame. A
+     * failed measurement falls back to the last good one rather than to a guess:
+     * a stale viewport is off by a resize, an invented one is off by anything.
+     */
+    private pageViewport;
+    /**
+     * Turn one authorised event into CDP calls. Coordinates arrive normalised.
+     *
+     * A switch with a default that REFUSES, rather than a chain of ifs ending in
+     * the click branch. This is a mutation boundary reached from a socket, so the
+     * question is not what a well-formed event does but what a malformed one
+     * does: the chain answered "clicks", which meant a version-skewed client
+     * sending `{ kind: 'drag', x, y }` pressed the mouse on a real page, and a
+     * kind with no coordinates at all clamped to 0 and clicked the top-left
+     * corner. Unknown input has to fail closed.
+     *
+     * The `never` in the default is the other half: adding a member to
+     * `BrowserInput` without handling it here stops compiling, so the next kind
+     * cannot silently inherit whatever the last branch happened to be.
+     */
+    private dispatch;
     /** The user stopped this run. Refuses further actions and clears its queue. */
     stopRun(runId: string): void;
     /** A run ended: release its browser rather than pay for an idle session. */
@@ -7032,6 +7610,25 @@ declare class RemoteBrowserController {
     private open;
     /** The part that may fail, with the pool slot already reserved. */
     private openReserved;
+    /** Count main-frame navigation only while this page is the run's active page. */
+    private trackPageNavigation;
+    /**
+     * Follow a page opened by the action that just finished.
+     *
+     * A popup/new tab is part of the same user gesture (OAuth is the common
+     * example). Keeping `held.page` and the screencast on its opener makes the
+     * new page both invisible and impossible to drive. This runs while the SAME
+     * action slot is still held, after the opening click/key has fully landed, so
+     * no later human/agent event can slip between detecting the popup and moving
+     * the view to it.
+     */
+    private followOpenedPage;
+    /**
+     * Make one live page the run's controlled/viewed page. Used in both
+     * directions: into a popup opened by an action, and back to another surviving
+     * page when that popup closes itself after OAuth/login completion.
+     */
+    private adoptPage;
     private perform;
 }
 
@@ -7067,6 +7664,73 @@ declare class GenericCdpProvider implements RemoteBrowserProvider {
  */
 declare function isCdpEndpoint(url: string): boolean;
 
+/**
+ * Whether this configuration will end up talking to Steel's hosted API.
+ *
+ * Lives HERE, next to the default it has to agree with, rather than in the
+ * caller that needs the answer. The hosted endpoint requires a credential and a
+ * self-hosted one usually does not, so something has to decide which a given
+ * config is — and a server-side copy of that decision is a second definition of
+ * "hosted" free to drift from the one that actually picks the URL.
+ *
+ * Several configs reach the hosted API and they do not look alike: no url at
+ * all, an empty one (`opts.url || DEFAULT_BASE` takes the default for both),
+ * the hosted host typed out in full, and the fully-qualified spelling with a
+ * terminal dot. Asking about the RESOLVED destination answers all of them at
+ * once, which asking about the presence of `url` cannot.
+ *
+ * Compared by host key, so a trailing slash, a port, a path, a different scheme,
+ * a different case or a root dot cannot disguise it. A URL this cannot parse is
+ * not the hosted API — and is refused earlier anyway, for being unparseable.
+ */
+declare function isHostedSteel(url?: string): boolean;
+/**
+ * Whether this can serve as the API base — asked of the URL ACTUALLY BUILT.
+ *
+ * Six rounds of review found six ways a base could look fine and not work:
+ * a wrong host, a terminal dot, a query string, userinfo, a path prefix on the
+ * hosted service, doubled trailing slashes. Each was answered by inspecting one
+ * more component, and a seventh arrived that no component exposes — a bare `?`
+ * or `#` leaves `search` and `hash` EMPTY while `href` keeps the delimiter, so
+ * `${base}/v1/sessions` becomes `...?/v1/sessions` and the POST lands on `/`.
+ *
+ * So this stopped adding conditions and started asking the only question that
+ * was ever the real one: build the request `call()` will build, and see whether
+ * it addresses the endpoint. A spelling nobody has thought of yet fails this by
+ * construction rather than by being enumerated.
+ */
+declare function isUsableSteelBase(url: string): boolean;
+/**
+ * Whether this credential can actually be SENT.
+ *
+ * The env schema trims, which removes surrounding whitespace and nothing else,
+ * so a key pasted out of a wrapped terminal or a here-doc can carry an embedded
+ * newline. It is truthy, so the hosted gate reads the deployment as
+ * authenticated and `/api/config` advertises Browser mode — and then `fetch`
+ * refuses the header before a byte is sent, leaving a control that cannot make
+ * one call. The third member of the category `fetch` refuses before sending,
+ * after userinfo and blocked ports.
+ *
+ * CONSTRUCTING A HEADER IS NOT SENDING ONE, and the first version of this asked
+ * the wrong one of those two questions. It built a `Headers` and trusted the
+ * result — but `Headers` (and `Request`) accept DEL and every C0 control except
+ * CR, LF and NUL, while the SEND path refuses them, so a key containing `\x7f`
+ * was advertised as usable and then died as `invalid steel-api-key header`
+ * before DNS. The comment here stated that as verified fact; it had verified
+ * the constructor, which is a different thing.
+ *
+ * So this asks the send path's own rule — RFC 9110's field value: horizontal
+ * tab, printable ASCII, or a high byte — because no constructor asks it.
+ * Confirmed by probing every byte from 0x00 to 0xff through `fetch` itself:
+ * refused are 0x00-0x08, 0x0a-0x1f and 0x7f, and this predicate agrees with it
+ * on all 256. The test pins that set rather than describing it.
+ *
+ * A scan rather than a regex: the equivalent character class is linear, but
+ * this file already carries two loops written to avoid CodeQL's backtracking
+ * finding, and one idiom is easier to keep true than two. Code points above
+ * 0xff fail here and at `fetch`, which refuses them as un-ByteString-able.
+ */
+declare function isUsableSteelKey(apiKey: string): boolean;
 declare class SteelProvider implements RemoteBrowserProvider {
     readonly name = "Steel";
     readonly isolatesSessions = true;
@@ -7089,7 +7753,7 @@ declare class SteelProvider implements RemoteBrowserProvider {
  * the capability was switched off is neither. Reporting all three as "busy"
  * had a model politely retrying something that would never be granted.
  */
-type LeaseResult = 'granted' | 'busy' | 'cancelled' | 'off';
+type LeaseResult = 'granted' | 'busy' | 'cancelled' | 'off' | 'human';
 interface BrowserLeaseOptions {
     /**
      * Whether a run has been stopped. The lease skips revoked runs when handing
@@ -7118,10 +7782,65 @@ declare class BrowserLease {
      * took the slot may release it.
      */
     private action;
+    /** Whether the current action slot represents activity by its holder. */
+    private actionCountsAsHumanActivity;
+    /**
+     * The human action that has already consumed its one idle-deadline grace.
+     * A single wedged CDP request must not look like fresh activity every two
+     * minutes forever. The first deadline may yield to an event that began before
+     * it; a second deadline for that SAME event becomes a pending lapse instead.
+     */
+    private idleGraceAction;
+    /** Release the human hold as soon as this overlong action finally unwinds. */
+    private idleLapseAfterAction;
+    /**
+     * Everyone waiting for that slot, IN THE ORDER THEY ASKED.
+     *
+     * A queue rather than a poll, and the ordering is the whole reason for it.
+     * `acquireActionSlot` used to spin on a 25ms timer, which decides nothing
+     * about who goes first: each waiter checks on its own phase, so the one that
+     * asked SECOND can find the slot free a full poll ahead of the one that asked
+     * first. The person types one event per keypress — `{ kind: 'text', text }`
+     * carries a single character — so that reordering is not a theoretical
+     * unfairness, it is "passowrd" appearing in the box.
+     *
+     * The slot is handed straight from `endAction` to the head of this line while
+     * still synchronous, so nothing can slip in between the two, and a waiter
+     * that reaches the front never has to be told the slot is already taken.
+     */
+    private actionQueue;
+    /** Lapses a human hold nobody is using. See `HUMAN_IDLE_MS`. */
+    private humanTimer;
+    /**
+     * The person ASKED for the hold to end and it could not end yet.
+     *
+     * Kept as a request rather than only a retry timer, because the retry shares
+     * `humanTimer` with the idle deadline: an authorised event settling after the
+     * request would otherwise call `touch()`, re-arm that timer for a full idle
+     * interval, and quietly cancel a handback the person had already asked for.
+     * "Give it back" is not undone by activity that was already under way when
+     * they said it.
+     *
+     * Explicit requests ONLY. An idle expiry must never set this: a deadline that
+     * lands on the person's own in-flight event is evidence they were THERE, and
+     * recording it here made `touch()` bail afterwards, so the hold dropped the
+     * instant a fresh interaction finished. See `lapse()`.
+     */
+    private handBackWanted;
     private isRevoked;
     private onChange;
     constructor(options?: BrowserLeaseOptions);
     get holderActor(): string | null;
+    /** Whether a person, rather than the agent, is driving the page right now. */
+    get heldByHuman(): boolean;
+    /**
+     * Whether THIS actor is the one holding the browser right now.
+     *
+     * For asking again after a wait. `acquire` is re-entrant for the holder, so
+     * "I was granted the lease" is a fact about the moment it was granted and
+     * says nothing about the moment the caller finally gets to act.
+     */
+    heldBy(actorId: string): boolean;
     get holderSession(): string | null;
     get queueDepth(): number;
     get actionInFlight(): boolean;
@@ -7160,6 +7879,57 @@ declare class BrowserLease {
      * refusal path runs a Stop may already have handed the lease on.
      */
     releaseIfHeldBy(actorId: string): void;
+    /**
+     * Give the browser to the person watching it.
+     *
+     * Callers must have waited the in-flight action out first — see
+     * `acquireActionSlot`. This does not interrupt one, because it cannot: a
+     * Playwright call already inside the page finishes whatever it started, and
+     * taking the lease off it would only mean the person and a still-running
+     * `fill` were both touching the same form. Waiting is what makes "you have
+     * control" true when the UI says it.
+     *
+     * Every queued worker is turned away rather than left in line, for the same
+     * reason `acquire` refuses: they were planned against a page the person is
+     * about to change.
+     */
+    takeOver(sessionId: string): void;
+    /**
+     * The person is still there — anything they did counts.
+     *
+     * Called per authorised input rather than on a heartbeat, so the hold is
+     * extended by USE and not merely by a tab being open. A left-open panel on a
+     * forgotten laptop stops holding a billed session two minutes later.
+     */
+    touch(): void;
+    /** (Re)start the idle interval. The only place the deadline is set. */
+    private armIdle;
+    /**
+     * The idle deadline came round.
+     *
+     * Both ways a hold ends obey the same rule — never while one of the person's
+     * own events is still landing — but they resolve that clash in OPPOSITE
+     * directions, and routing the lapse through `handBack()` collapsed them into
+     * one. An event in flight BEGAN before this deadline, which makes it evidence
+     * the person was there; deferring the lapse and then releasing the moment
+     * that event lands ends the hold immediately after a fresh interaction, which
+     * is the precise opposite of what an idle deadline measures. So an
+     * interrupted lapse yields: the interval starts again, and the next silence
+     * decides.
+     *
+     * `handBack()` keeps the deferral instead, because "Give it back" is a
+     * decision and activity already under way when it was made does not withdraw
+     * it. Same rule, different answer, which is why they are different methods.
+     */
+    private lapse;
+    /**
+     * The person hands the browser back, or their hold lapses.
+     *
+     * Answers whether there was a human hold to end, so a caller can tell a real
+     * handback from a duplicate click or a lapse that already happened.
+     */
+    handBack(): boolean;
+    private clearHumanIdle;
     /** Drop every queued waiter belonging to a run, and the lease if it holds it. */
     dropRun(sessionId: string): void;
     /** Turn everyone away — the capability itself has gone. */
@@ -7169,19 +7939,67 @@ declare class BrowserLease {
     /** Arm the deadlock ceiling. Not a release schedule — see the constant. */
     armCeiling(): void;
     clearCeiling(): void;
-    /** Take the per-action slot, or null when one is already running. */
-    beginAction(): symbol | null;
-    /** Release the slot, but only for the action that took it. */
+    /**
+     * Take the per-action slot, or null when one is already running.
+     *
+     * PRIVATE, so the queue is the only way in. A caller that could take the slot
+     * without joining the line would be exactly the jump-the-queue the ordering
+     * is there to prevent.
+     */
+    private beginAction;
+    /**
+     * Release the slot, but only for the action that took it.
+     *
+     * Hands it to the head of the line rather than merely clearing it, and does
+     * so SYNCHRONOUSLY: the waiter's `beginAction` runs before this call returns,
+     * so there is no window in which the slot is free and somebody who asked
+     * later can take it.
+     */
     endAction(token: symbol): boolean;
     /**
-     * Wait, briefly, for an outgoing action to unwind.
+     * Take the slot only if it is free RIGHT NOW, never joining the line.
+     *
+     * For input that is a SAMPLE rather than a decision — pointer movement. A
+     * click or a keystroke is a thing the person meant to do and has to happen,
+     * so it waits its turn; a pointer position is one of many on the way
+     * somewhere, and one that cannot be applied now is worth less than the one
+     * behind it. Queueing them is actively harmful: on an endpoint slower than
+     * the client's sampling interval the backlog grows, and the click behind it
+     * can age out against `acquireActionSlot`'s bound and be refused — movement
+     * costing the person the action they actually intended.
+     *
+     * The queue length is checked as well as the slot, so a sample cannot step
+     * over a click that is already waiting.
+     */
+    tryActionSlot(): symbol | null;
+    /**
+     * Take the per-action slot, waiting in line for it if somebody has it.
      *
      * A release can hand the browser on while the previous holder's abort is
      * still propagating through an awaited navigation. That is a handoff, not a
-     * conflict, so it is waited out rather than refused — but bounded, because a
-     * wedged action must not pin the queue.
-     */
-    awaitActionSlot(): Promise<boolean>;
+     * conflict, so it is normally bounded: a wedged action must not pin an agent
+     * or a takeover forever. Human discrete input is the exception and passes
+     * `null`: once a click, key or committed text has been accepted into this
+     * ordered queue, expiring it merely because earlier accepted input took more
+     * than two seconds silently truncates what the person typed.
+     *
+     * Waiting and TAKING are one step, which they deliberately were not before:
+     * the wait used to answer "the slot looks free" and leave the caller to call
+     * `beginAction` afterwards. Two callers woken by the same release both saw it
+     * free, and the loser was told "another action is already running" — a
+     * refusal for having asked first. Granting it here means whoever reaches the
+     * front of the line gets it, and everybody else is still waiting rather than
+     * refused.
+     *
+     * `null` as a RESULT means a bounded wait ran out OR a caller-supplied queue
+     * cap refused a new waiter. `null` as `withinMs` means an ACCEPTED operation
+     * is intentionally unbounded by time and will leave the queue only when its
+     * turn arrives; it does not require accepting infinitely many operations.
+     * `countsAsHumanActivity=false` is for
+     * lifecycle barriers: they still serialize, but an idle deadline must not
+     * mistake framework cleanup for evidence that the person is present.
+     */
+    acquireActionSlot(withinMs?: number | null, countsAsHumanActivity?: boolean, maxQueued?: number | null): Promise<symbol | null>;
     /**
      * Queue one actor, resolving when it gets the browser or is turned away.
      *
@@ -8316,4 +9134,4 @@ declare function gatherSyncBundle(config: CascadeConfig): SyncBundle;
 /** Merge a pulled bundle into a config, returning the updated config to persist. */
 declare function applySyncBundle(bundle: SyncBundle, config: CascadeConfig, cleanup?: RetiredProviderCleanup): CascadeConfig;
 
-export { AZURE_BASE_MODELS, AZURE_BASE_URL_TEMPLATE, type AcceptanceOptions, type AcceptanceProbe, type AcceptanceResult, type AcceptanceVerdict, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, type AzureDeploymentInput, type BenchmarksConfig, type Block, type BrowserAction, type BrowserActionOutcome, BrowserControlTool, type BrowserController, BrowserLease, type BudgetConfig, CASCADE_AUDIT_FILE, CASCADE_CONFIG_DIR, CASCADE_CONFIG_FILE, CASCADE_DASHBOARD_SECRET_FILE, CASCADE_DB_FILE, CASCADE_IGNORE_FILE, CASCADE_KEYSTORE_FILE, CASCADE_MD_FILE, CASCADE_VERSION, CHARS_PER_TOKEN, COMPLEXITY_T2_COUNT, Cascade, CascadeCancelledError, type CascadeConfig, CascadeConfigSchema, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, type CascadeThemeName, CascadeToolError, type ChartSeries, type ChartSpec, type Chunk, type ChunkOptions, CloudClient, type CloudConversation, type CloudMessage, type CloudSession, type CloudSessionStore, type CloudTurnInput, type CloudUser, type CodeChunkOptions, type CodeChunker, CodeSearchTool, type CompileTaskGraphOptions, type CompiledTaskGraph, type CompleteFn, type CompletedNode, ConfigManager, type ConversationMessage, type CredentialDisposition, type CredentialEndpoint, type CredentialWriteOutcome, type CurrentPageProvider, type CurrentPageSnapshot, CurrentPageTool, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CLOUD_URL, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, DOCUMENT_MIME, type DashboardConfig, DashboardServer, DependencyScheduler, type DeviceStart, type DiscoveredMcpTool, type DistilledFact, type ChartKind as DocumentChartKind, type DocumentFormat, type Embedder, type EncryptedBlob, type EscalationDecision, type EscalationPayload, type ExtendedContextConfig, type FileManifest, FileMcpOAuthStore, GLOBAL_CONFIG_DIR, GLOBAL_CREDENTIALS_FILE, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, GenerateDocumentTool, type GenerateOptions, type GenerateResult, GenericCdpProvider, type GraphFactSource, GraphRetriever, type GraphSearchOptions, GraphSearchTool, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, type ImageByteLoader, type ImageInfo, type ImageRef, type InlineRun, Keystore, LLMReranker, LM_STUDIO_BASE_URL, type LegacyThemeName, type LoadedImage, MAX_PAGE_TEXT_CHARS, MCP_TOOL_PREFIX, MODELS, type ManifestDiff, McpClient, type McpDiscoveryResult, McpOAuthProvider, type McpOAuthState, type McpOAuthStore, type McpServerConfig$1 as McpServerConfig, type McpServerRename, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, type NativeProvider, OLLAMA_BASE_URL, OpenAICompatibleEmbedder, type OpenAIEmbedderOptions, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, type ProviderConfig, type ProviderType, RESUME_SCHEMA_VERSION, type RankedFact, type RefreshResult, type RemoteBrowserConfig, RemoteBrowserController, type RemoteBrowserProvider, type RemoteBrowserSession, type RenderOptions, type Reranker, type ResumeCheckpoint, type ResumeReason, ResumeStore, type ResumeStoreOptions, type RetrievalContext, type RetrievalMode, type RetrievalPlan, Retriever, type RetrieverSearchOptions, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type SchedulerExecutionMode, type SchedulerHooks, type SchedulerOptions, type SchedulerResult, type ScoredChunk, type SearchOptions, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type SettingsCommitResult, type SettingsCredentialResult, type SettingsPayload, type SettingsSnapshot, type Slide, SqliteVectorStore, type StatusUpdate, SteelProvider, type StoredMessage, type StreamChunk, type SyncBundle, T1Administrator, type T1ToT2Assignment, T1_MODEL_PRIORITY, T2Manager, type T2Result, type T2ToT3Assignment, T2_MODEL_PRIORITY, type T3Result, type T3ResultPayload, type T3SubtaskSpec, T3Worker, T3_MODEL_PRIORITY, THEME_NAMES, TOOL_NAMES, type TaskComplexity, type TaskGraph, type TaskGraphInputNode, type TaskGraphIssue, type TaskGraphIssueCode, type TaskGraphNode, type TaskGraphNodeKind, TaskGraphValidationError, type TaskGraphValidationMode, TaskScheduler, type TaskType, Telemetry, type TelemetryConfig, type Theme, type ThemeColors, type ThemeName, type TierConfig, type TierLimits, type TierRole, type TierStatus, type TokenUsage, type ToolCall, type ToolDefinition, type ToolExecuteOptions, ToolRegistry, type ToolResult, type ToolsConfig, VISION_MODEL_PRIORITY, type VectorStore, type WebSearchConfig, type WebhookConfig, type WorkspaceConfig, type WorkspaceFileReader, WorkspaceIndex, type WorkspaceIndexOptions, applyEndpointEdit, applyProviderApiKey, applyProviderCredential, applySettingsCredentials, applySettingsPayload, applySyncBundle, azureModelForDeployment, beginMcpOAuth, buildDocumentTools, buildManifest, buildSessionTranscript, bytesToBase64, cagCharBudget, chartKind, chartToTableRows, chatCompleterFromProviders, chunkCode, chunkText, commitSettings, compileSectionGraph, compileSubtaskGraph, compileTaskGraph, completeMcpOAuth, connectMcpWithLoopbackOAuth, createCascade, credentialDispositionForEdit, credentialEndpointIdentity, decryptJSON as decryptSyncBlob, diffManifest, disambiguateMcpServerNames, discoverMcpAuthServer, discoverMcpTools, distillSessionFacts, embedderFromProviders, encryptJSON as encryptSyncBlob, endpointFromSettingsPayload, evaluateAcceptance, explainRefusal, extractCharts, failures, fileExt, fileOAuthProvider, gatherSyncBundle, hasDefaultEndpoint, hasProviderCredential, hasUsableProvider, hashContent, heuristicCodeChunker, inferAzureBaseModel, inlineRuns, isCdpEndpoint, isDocumentFormat, isMcpToolName, matchImageLine, mcpServerPrefix, mcpToolName, nodeHttpFetch, normalizeEndpoint, parseBlocks, parseChartSpec, parseDelimited, parseRankOrder, parseSlide, planRetrieval, preferIpv4Host, priorAzureRow, reciprocalRankFusion, refreshMcpToken, removeMcpServerDenials, renderDocument, renderDocx, renderPptx, renderXlsx, runCascade, sameAzureEndpoint, sameCredentialEndpoint, sameEndpoint, sessionWorthRemembering, settingsSnapshot, sniffImage, splitSlides, streamCascade, stripInline, summarizeCompleted, undecided, uniqueMcpServerName };
+export { AZURE_BASE_MODELS, AZURE_BASE_URL_TEMPLATE, type AcceptanceOptions, type AcceptanceProbe, type AcceptanceResult, type AcceptanceVerdict, type ApprovalRequest, type ApprovalResponse, AskUserTool, type AuditEntry, AuditLogger, type AzureDeploymentInput, type BenchmarksConfig, type Block, type BrowserAction, type BrowserActionOutcome, type BrowserControlState, BrowserControlTool, type BrowserController, type BrowserFrame, type BrowserInput, BrowserLease, type BudgetConfig, CASCADE_AUDIT_FILE, CASCADE_CONFIG_DIR, CASCADE_CONFIG_FILE, CASCADE_DASHBOARD_SECRET_FILE, CASCADE_DB_FILE, CASCADE_IGNORE_FILE, CASCADE_KEYSTORE_FILE, CASCADE_MD_FILE, CASCADE_VERSION, CHARS_PER_TOKEN, COMPLEXITY_T2_COUNT, Cascade, CascadeCancelledError, type CascadeConfig, CascadeConfigSchema, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, type CascadeThemeName, CascadeToolError, type ChartSeries, type ChartSpec, type Chunk, type ChunkOptions, type ClarificationAnswer, type ClarificationOutcome, type ClarificationQuestion, type ClarificationResult, CloudClient, type CloudConversation, type CloudMessage, type CloudSession, type CloudSessionStore, type CloudTurnInput, type CloudUser, type CodeChunkOptions, type CodeChunker, CodeSearchTool, type CompileTaskGraphOptions, type CompiledTaskGraph, type CompleteFn, type CompletedNode, ConfigManager, type ConversationMessage, type CredentialDisposition, type CredentialEndpoint, type CredentialWriteOutcome, type CurrentPageProvider, type CurrentPageSnapshot, CurrentPageTool, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CLOUD_URL, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, DOCUMENT_MIME, type DashboardConfig, DashboardServer, DependencyScheduler, type DeviceStart, type DiscoveredMcpTool, type DistilledFact, type ChartKind as DocumentChartKind, type DocumentFormat, type Embedder, type EncryptedBlob, type EscalationDecision, type EscalationPayload, type ExtendedContextConfig, type FileManifest, FileMcpOAuthStore, GLOBAL_CONFIG_DIR, GLOBAL_CREDENTIALS_FILE, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, GenerateDocumentTool, type GenerateOptions, type GenerateResult, GenericCdpProvider, type GraphFactSource, GraphRetriever, type GraphSearchOptions, GraphSearchTool, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, type ImageByteLoader, type ImageInfo, type ImageRef, type InlineRun, Keystore, LLMReranker, LM_STUDIO_BASE_URL, type LegacyThemeName, type LoadedImage, MAX_PAGE_TEXT_CHARS, MCP_TOOL_PREFIX, MODELS, type ManifestDiff, McpClient, type McpDiscoveryResult, McpOAuthProvider, type McpOAuthState, type McpOAuthStore, type McpServerConfig$1 as McpServerConfig, type McpServerRename, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, type NativeProvider, OLLAMA_BASE_URL, OpenAICompatibleEmbedder, type OpenAIEmbedderOptions, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, type ProviderConfig, type ProviderType, RESUME_SCHEMA_VERSION, type RankedFact, type RefreshResult, type RemoteBrowserConfig, RemoteBrowserController, type RemoteBrowserProvider, type RemoteBrowserSession, type RenderOptions, type Reranker, type ResumeCheckpoint, type ResumeReason, ResumeStore, type ResumeStoreOptions, type RetrievalContext, type RetrievalMode, type RetrievalPlan, Retriever, type RetrieverSearchOptions, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type SchedulerExecutionMode, type SchedulerHooks, type SchedulerOptions, type SchedulerResult, type ScoredChunk, type SearchOptions, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type SettingsCommitResult, type SettingsCredentialResult, type SettingsPayload, type SettingsSnapshot, type Slide, SqliteVectorStore, type StatusUpdate, SteelProvider, type StoredMessage, type StreamChunk, type SyncBundle, T1Administrator, type T1ToT2Assignment, T1_MODEL_PRIORITY, T2Manager, type T2Result, type T2ToT3Assignment, T2_MODEL_PRIORITY, type T3Result, type T3ResultPayload, type T3SubtaskSpec, T3Worker, T3_MODEL_PRIORITY, THEME_NAMES, TOOL_NAMES, type TaskComplexity, type TaskGraph, type TaskGraphInputNode, type TaskGraphIssue, type TaskGraphIssueCode, type TaskGraphNode, type TaskGraphNodeKind, TaskGraphValidationError, type TaskGraphValidationMode, TaskScheduler, type TaskType, Telemetry, type TelemetryConfig, type Theme, type ThemeColors, type ThemeName, type TierConfig, type TierLimits, type TierRole, type TierStatus, type TokenUsage, type ToolCall, type ToolDefinition, type ToolExecuteOptions, ToolRegistry, type ToolResult, type ToolsConfig, VISION_MODEL_PRIORITY, type VectorStore, type WebSearchConfig, type WebhookConfig, type WorkspaceConfig, type WorkspaceFileReader, WorkspaceIndex, type WorkspaceIndexOptions, applyEndpointEdit, applyProviderApiKey, applyProviderCredential, applySettingsCredentials, applySettingsPayload, applySyncBundle, azureModelForDeployment, beginMcpOAuth, buildDocumentTools, buildManifest, buildSessionTranscript, bytesToBase64, cagCharBudget, chartKind, chartToTableRows, chatCompleterFromProviders, chunkCode, chunkText, commitSettings, compileSectionGraph, compileSubtaskGraph, compileTaskGraph, completeMcpOAuth, connectMcpWithLoopbackOAuth, createCascade, credentialDispositionForEdit, credentialEndpointIdentity, decryptJSON as decryptSyncBlob, diffManifest, disambiguateMcpServerNames, discoverMcpAuthServer, discoverMcpTools, distillSessionFacts, embedderFromProviders, encryptJSON as encryptSyncBlob, endpointFromSettingsPayload, evaluateAcceptance, explainRefusal, extractCharts, failures, fileExt, fileOAuthProvider, gatherSyncBundle, hasDefaultEndpoint, hasProviderCredential, hasUsableProvider, hashContent, heuristicCodeChunker, inferAzureBaseModel, inlineRuns, isCdpEndpoint, isDocumentFormat, isHostedSteel, isMcpToolName, isUsableSteelBase, isUsableSteelKey, matchImageLine, mcpServerPrefix, mcpToolName, nodeHttpFetch, normalizeEndpoint, parseBlocks, parseChartSpec, parseDelimited, parseRankOrder, parseSlide, planRetrieval, preferIpv4Host, priorAzureRow, reciprocalRankFusion, refreshMcpToken, removeMcpServerDenials, renderDocument, renderDocx, renderPptx, renderXlsx, runCascade, sameAzureEndpoint, sameCredentialEndpoint, sameEndpoint, sessionWorthRemembering, settingsSnapshot, sniffImage, splitSlides, streamCascade, stripInline, summarizeCompleted, undecided, uniqueMcpServerName };