import type { ToolHost } from "@boardwalk-labs/engine/core";
import type { WebSearchInput, WebSearchOutput } from "./tools/web_search.js";
import type { ArtifactStore } from "./tools/artifacts.js";
/** Socket-safety ceiling on the RAW bytes read off a `webfetch` response, so a hostile URL can't
 *  stream an unbounded body into the worker. This bounds MEMORY, not what the model sees (the
 *  model-facing content is extracted + capped separately — see DEFAULT_FETCH_CONTENT_CHARS). The
 *  engine's per-call `maxBytes` overrides this when set. */
export declare const DEFAULT_FETCH_MAX_BYTES: number;
/** Ceiling on the MODEL-FACING content of a `webfetch`, in chars, AFTER HTML→text extraction
 *  (~12K tokens). Raw HTML is mostly `<script>`/`<style>`/markup the model doesn't need and which
 *  then rides in context for the rest of the loop, so we extract the readable text and cap it. A
 *  whole 5 MB page used to land in context verbatim; this is the single biggest webfetch token sink. */
export declare const DEFAULT_FETCH_CONTENT_CHARS = 50000;
/** The broker surface the web_search + read-artifact paths need (RunnerControlClient satisfies it).
 *  `webSearch` proxies to Tavily server-side; `signArtifactUrl` + `downloadBytes` back `readArtifact`. */
export interface ToolHostBroker {
    webSearch(input: WebSearchInput): Promise<WebSearchOutput>;
    signArtifactUrl(artifactId: string, ttlSeconds: number): Promise<{
        signedUrl: string;
    }>;
    downloadBytes(url: string): Promise<Uint8Array | null>;
}
export interface BrokerToolHostDeps {
    /** Broker client for web_search + read-artifact signing/download. */
    broker: ToolHostBroker;
    /** The artifact store the `artifacts` write/list path already uses (reused verbatim). */
    artifacts: ArtifactStore;
    /** Injected fetch for `webfetch` (defaults to global fetch — the proxy is applied by the runtime,
     *  not here, so a plain global fetch already routes through the egress allowlist). */
    fetchImpl?: typeof fetch;
    /** Override the default `webfetch` RAW read cap, in bytes (tests). */
    maxFetchBytes?: number;
    /** Override the default `webfetch` model-facing content cap, in chars (tests). */
    maxFetchContentChars?: number;
}
/**
 * Build the engine `ToolHost` for one run, backed by the broker. Returned as a plain object literal so
 * each hook closes over the injected deps; the shape matches the engine's optional-method interface
 * (omitting `lsp` leaves that tool unregistered).
 */
export declare function buildBrokerToolHost(deps: BrokerToolHostDeps): ToolHost;
/**
 * Reduce an HTML document to readable text: drop non-content elements (script/style/head/etc.),
 * turn block boundaries into newlines, strip remaining tags, decode common entities, and collapse
 * whitespace. A pragmatic, dependency-free extractor — NOT a full readability pass (it does not
 * score main-content vs. nav/ads), but it removes the bulk of the markup/script tokens that would
 * otherwise flood the model. A heavier readability library could improve precision later.
 */
export declare function htmlToText(html: string): string;