harness-mix 0.1.0

package/src/native-ui/desktop-control/dist/renderer-control-session.js

@@ -0,0 +1,366 @@
+import { CdpClient, listCdpTargets } from "./cdp-client.js";
+import { installMainProcessTitlePolicy, markRendererTitlePolicyReady, readMainProcessTitlePolicyCounters, } from "./main-process-title-policy.js";
+import { installRendererDraftPrewarmPolicy, } from "./renderer-draft-prewarm-policy.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function sleep(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+function sameAgents(actual, expected) {
+    return (actual.length === expected.length && actual.every((agent, index) => agent === expected[index]));
+}
+class RendererAdapterReadinessError extends Error {
+    state;
+    reason;
+    constructor(state, reason) {
+        super(`Production Renderer Adapter is ${state}: ${reason}`);
+        this.state = state;
+        this.reason = reason;
+        this.name = "RendererAdapterReadinessError";
+    }
+}
+function validateBindingStatus(value, expectedAgents) {
+    if (!isRecord(value) ||
+        value.version !== 2 ||
+        !Array.isArray(value.enabledAgents) ||
+        value.enabledAgents.some((agent) => typeof agent !== "string") ||
+        !sameAgents(value.enabledAgents, expectedAgents) ||
+        !isRecord(value.adapter)) {
+        throw new Error("Production Renderer binding returned an invalid status");
+    }
+    if (value.adapter.state !== "ready" || typeof value.adapter.reason !== "string") {
+        const state = typeof value.adapter.state === "string" ? value.adapter.state : "invalid";
+        const reason = typeof value.adapter.reason === "string" ? value.adapter.reason : "unknown";
+        throw new RendererAdapterReadinessError(state, reason);
+    }
+    return value;
+}
+export function selectRendererWebContents(contents, preferredRendererId) {
+    const candidates = contents
+        .filter((item) => item.type === "window" &&
+        item.surface === "primary" &&
+        item.runtime.available &&
+        item.runtime.elementCount !== null)
+        .toSorted((left, right) => (right.runtime.elementCount ?? 0) - (left.runtime.elementCount ?? 0));
+    const preferred = candidates.find((candidate) => candidate.id === preferredRendererId && (candidate.runtime.elementCount ?? 0) > 0);
+    if (preferred)
+        return preferred;
+    return candidates.find((candidate) => (candidate.runtime.elementCount ?? 0) > 0) ?? null;
+}
+export async function waitForRendererTitlePolicyReady(markReadiness, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const pollIntervalMs = options.pollIntervalMs ?? 250;
+    const now = options.now ?? Date.now;
+    const wait = options.sleep ?? sleep;
+    const deadline = now() + timeoutMs;
+    let lastError;
+    while (now() < deadline) {
+        try {
+            return await markReadiness();
+        }
+        catch (error) {
+            lastError = error;
+        }
+        await wait(pollIntervalMs);
+    }
+    const detail = lastError instanceof Error ? `: ${lastError.message}` : "";
+    throw new Error(`Renderer title policy ownership did not become ready${detail}`);
+}
+export async function waitForInspectorTarget(endpoint, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const pollIntervalMs = options.pollIntervalMs ?? 250;
+    const deadline = Date.now() + timeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+        try {
+            const targets = await listCdpTargets(endpoint, options.fetchImpl);
+            const inspector = targets.find((target) => target.type === "node");
+            if (inspector)
+                return inspector;
+            lastError = new Error("Inspector has no Node target");
+        }
+        catch (error) {
+            lastError = error;
+        }
+        await sleep(pollIntervalMs);
+    }
+    const detail = lastError instanceof Error ? `: ${lastError.message}` : "";
+    throw new Error(`Electron main-process Inspector did not become ready${detail}`);
+}
+const electronModuleExpression = `(() => {
+  const mainModule = process.mainModule;
+  if (mainModule != null && typeof mainModule.require === 'function') {
+    return mainModule.require('electron');
+  }
+  const { createRequire } = process.getBuiltinModule('module');
+  return createRequire(process.execPath)('electron');
+})()`;
+const webContentsRuntimeExpression = "(() => ({ elementCount: document.querySelectorAll('*').length }))()";
+export async function inspectElectronWebContents(inspector) {
+    const value = await inspector.evaluate(`(async () => {
+    const { webContents } = ${electronModuleExpression};
+    const result = await Promise.all(webContents.getAllWebContents().map(async (contents) => {
+      const type = contents.getType();
+      const surface = contents.getURL().includes('avatar-overlay') ? 'overlay' : 'primary';
+      let runtime = { available: false, elementCount: null };
+      if (type === 'window' && surface === 'primary') {
+        try {
+          const evaluation = contents.executeJavaScript(${JSON.stringify(webContentsRuntimeExpression)}, true);
+          const timeout = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error('Renderer inspection timed out')), 2_000);
+          });
+          runtime = { available: true, ...(await Promise.race([evaluation, timeout])) };
+        } catch {}
+      }
+      return {
+        id: contents.id,
+        type,
+        surface,
+        runtime,
+      };
+    }));
+    return result;
+  })()`);
+    if (!Array.isArray(value))
+        throw new Error("Electron webContents inspection returned an array");
+    return value.map((item) => {
+        if (!isRecord(item) ||
+            !Number.isInteger(item.id) ||
+            typeof item.type !== "string" ||
+            !["primary", "overlay"].includes(String(item.surface)) ||
+            !isRecord(item.runtime)) {
+            throw new Error("Electron webContents inspection returned an invalid item");
+        }
+        return {
+            id: item.id,
+            type: item.type,
+            surface: item.surface,
+            runtime: {
+                available: item.runtime.available === true,
+                elementCount: Number.isInteger(item.runtime.elementCount)
+                    ? item.runtime.elementCount
+                    : null,
+            },
+        };
+    });
+}
+export async function activateElectronDesktop(inspector) {
+    const value = await inspector.evaluate(`(() => {
+    const { BrowserWindow } = ${electronModuleExpression};
+    const windows = BrowserWindow.getAllWindows().filter((window) => !window.isDestroyed());
+    for (const window of windows) {
+      if (window.isMinimized()) window.restore();
+      window.show();
+      window.focus();
+    }
+    return windows.length;
+  })()`);
+    if (!Number.isInteger(value) || value < 1) {
+        throw new Error("Electron Desktop activation found no live window");
+    }
+    return value;
+}
+async function executeInWebContents(inspector, rendererWebContentsId, source) {
+    return inspector.evaluate(`(async () => {
+    const { webContents } = ${electronModuleExpression};
+    const contents = webContents.fromId(${rendererWebContentsId});
+    if (contents == null || contents.isDestroyed()) throw new Error('Renderer webContents is unavailable');
+    const result = await contents.executeJavaScript(${JSON.stringify(source)}, true);
+    return result === undefined ? null : result;
+  })()`);
+}
+async function reloadRenderer(inspector, rendererWebContentsId) {
+    await executeInWebContents(inspector, rendererWebContentsId, "location.reload(); null");
+}
+const defaultOperations = {
+    inspect: inspectElectronWebContents,
+    installTitlePolicy: installMainProcessTitlePolicy,
+    markTitlePolicyReady: markRendererTitlePolicyReady,
+    installDraftPrewarmPolicy: installRendererDraftPrewarmPolicy,
+    reload: reloadRenderer,
+    execute: executeInWebContents,
+    readBinding: (inspector, rendererWebContentsId) => executeInWebContents(inspector, rendererWebContentsId, "window.__codexhostRendererBindingProbeV1?.status() ?? null"),
+    readTitlePolicyCounters: readMainProcessTitlePolicyCounters,
+};
+async function waitForRenderer(inspector, operations, timeoutMs, pollIntervalMs, preferredRendererId) {
+    const deadline = Date.now() + timeoutMs;
+    let candidateCount = 0;
+    while (Date.now() < deadline) {
+        const inventory = await operations.inspect(inspector);
+        candidateCount = inventory.length;
+        const renderer = selectRendererWebContents(inventory, preferredRendererId);
+        if (renderer)
+            return renderer;
+        await sleep(pollIntervalMs);
+    }
+    throw new Error(`Inspector did not find a live Electron Renderer (${candidateCount} seen)`);
+}
+async function waitForBinding(inspector, operations, rendererWebContentsId, enabledAgents, timeoutMs, pollIntervalMs) {
+    const deadline = Date.now() + timeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+        try {
+            const value = await operations.readBinding(inspector, rendererWebContentsId);
+            if (value !== null)
+                return validateBindingStatus(value, enabledAgents);
+        }
+        catch (error) {
+            lastError = error;
+            if (error instanceof RendererAdapterReadinessError && error.state !== "installing") {
+                throw error;
+            }
+        }
+        await sleep(pollIntervalMs);
+    }
+    const detail = lastError instanceof Error ? `: ${lastError.message}` : "";
+    throw new Error(`Production Renderer binding did not become ready${detail}`);
+}
+class InstalledRendererControlSession {
+    inspector;
+    rendererSource;
+    enabledAgents;
+    timeoutMs;
+    pollIntervalMs;
+    operations;
+    #closed = false;
+    #snapshot;
+    constructor(inspector, rendererSource, enabledAgents, timeoutMs, pollIntervalMs, operations, snapshot) {
+        this.inspector = inspector;
+        this.rendererSource = rendererSource;
+        this.enabledAgents = enabledAgents;
+        this.timeoutMs = timeoutMs;
+        this.pollIntervalMs = pollIntervalMs;
+        this.operations = operations;
+        this.#snapshot = snapshot;
+    }
+    get snapshot() {
+        return this.#snapshot;
+    }
+    async ensureInstalled() {
+        if (this.#closed)
+            throw new Error("Renderer Control Session is closed");
+        const selected = await waitForRenderer(this.inspector, this.operations, this.timeoutMs, this.pollIntervalMs, this.#snapshot.renderer.id);
+        const existing = await this.operations
+            .readBinding(this.inspector, selected.id)
+            .catch(() => null);
+        if (existing !== null) {
+            const draftPrewarmPolicy = await this.operations.installDraftPrewarmPolicy(this.inspector, selected.id);
+            let binding;
+            try {
+                binding = validateBindingStatus(existing, this.enabledAgents);
+            }
+            catch (error) {
+                if (!(error instanceof RendererAdapterReadinessError))
+                    throw error;
+                await this.operations.execute(this.inspector, selected.id, this.rendererSource);
+                binding = await waitForBinding(this.inspector, this.operations, selected.id, this.enabledAgents, this.timeoutMs, this.pollIntervalMs);
+            }
+            this.#snapshot = {
+                ...this.#snapshot,
+                renderer: selected,
+                draftPrewarmPolicy,
+                binding,
+            };
+            return this.#snapshot;
+        }
+        const titlePolicyReadiness = await waitForRendererTitlePolicyReady(() => this.operations.markTitlePolicyReady(this.inspector, selected.id), { timeoutMs: this.timeoutMs, pollIntervalMs: this.pollIntervalMs });
+        await activateElectronDesktop(this.inspector);
+        await this.operations.execute(this.inspector, selected.id, this.rendererSource);
+        const draftPrewarmPolicy = await this.operations.installDraftPrewarmPolicy(this.inspector, selected.id);
+        const binding = await waitForBinding(this.inspector, this.operations, selected.id, this.enabledAgents, this.timeoutMs, this.pollIntervalMs);
+        this.#snapshot = {
+            ...this.#snapshot,
+            renderer: selected,
+            titlePolicyReadiness,
+            draftPrewarmPolicy,
+            binding,
+        };
+        return this.#snapshot;
+    }
+    activateDesktop() {
+        if (this.#closed)
+            return Promise.reject(new Error("Renderer Control Session is closed"));
+        return activateElectronDesktop(this.inspector);
+    }
+    executeRenderer(expression) {
+        if (this.#closed)
+            return Promise.reject(new Error("Renderer Control Session is closed"));
+        return this.operations.execute(this.inspector, this.#snapshot.renderer.id, expression);
+    }
+    readTitlePolicyCounters() {
+        if (this.#closed)
+            return Promise.reject(new Error("Renderer Control Session is closed"));
+        return this.operations.readTitlePolicyCounters(this.inspector);
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.inspector.close();
+    }
+}
+const startupTraceStartedAt = Date.now();
+function startupTrace(stage) {
+    if (process.env.CODEXHOST_STARTUP_TRACE !== "1")
+        return;
+    console.error(`[codexhost startup +${Date.now() - startupTraceStartedAt}ms] renderer-session: ${stage}`);
+}
+export async function createRendererControlSession(options) {
+    const enabledAgents = options.enabledAgents ?? ["codex", "pi"];
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const pollIntervalMs = options.pollIntervalMs ?? 250;
+    const operations = options.operations ?? defaultOperations;
+    startupTrace("waiting for initial Renderer");
+    const initial = await waitForRenderer(options.inspector, operations, timeoutMs, pollIntervalMs);
+    startupTrace("installing title policy");
+    const titlePolicy = await operations.installTitlePolicy(options.inspector, initial.id);
+    startupTrace("reloading Renderer");
+    await operations.reload(options.inspector, initial.id);
+    startupTrace("waiting for reloaded Renderer");
+    const selected = await waitForRenderer(options.inspector, operations, timeoutMs, pollIntervalMs, initial.id);
+    startupTrace("waiting for title policy readiness");
+    const titlePolicyReadiness = await waitForRendererTitlePolicyReady(() => operations.markTitlePolicyReady(options.inspector, selected.id), {
+        timeoutMs,
+        pollIntervalMs,
+    });
+    startupTrace("injecting Renderer bundle");
+    await operations.execute(options.inspector, selected.id, options.rendererSource);
+    startupTrace("installing draft routing policy");
+    const draftPrewarmPolicy = await operations.installDraftPrewarmPolicy(options.inspector, selected.id);
+    startupTrace("waiting for Renderer binding");
+    const binding = await waitForBinding(options.inspector, operations, selected.id, enabledAgents, timeoutMs, pollIntervalMs);
+    return new InstalledRendererControlSession(options.inspector, options.rendererSource, enabledAgents, timeoutMs, pollIntervalMs, operations, {
+        renderer: selected,
+        titlePolicy,
+        titlePolicyReadiness,
+        draftPrewarmPolicy,
+        binding,
+    });
+}
+export async function installRendererControlSession(options) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const pollIntervalMs = options.pollIntervalMs ?? 250;
+    startupTrace("waiting for Electron Inspector target");
+    const target = await waitForInspectorTarget(options.inspectorEndpoint, {
+        timeoutMs,
+        pollIntervalMs,
+    });
+    startupTrace("connecting to Electron Inspector");
+    const inspector = await CdpClient.connect(target.webSocketDebuggerUrl);
+    try {
+        startupTrace("enabling Inspector Runtime domain");
+        await inspector.command("Runtime.enable");
+        return await createRendererControlSession({
+            ...options,
+            inspector,
+            timeoutMs,
+            pollIntervalMs,
+        });
+    }
+    catch (error) {
+        inspector.close();
+        throw error;
+    }
+}
+//# sourceMappingURL=renderer-control-session.js.map

package/src/native-ui/desktop-control/dist/renderer-control-session.js.map

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

package/src/native-ui/desktop-control/dist/renderer-dom.d.ts

@@ -0,0 +1,24 @@
+export interface RendererDomNodeSummary {
+    nodeName: string;
+    attributeNames: string[];
+    reasons: string[];
+    ancestorNames: string[];
+}
+export interface RendererShadowRootSummary {
+    shadowRootType: "open";
+    childNodeCount: number;
+}
+export interface RendererDomInspection {
+    totalNodes: number;
+    nodeNameCounts: Record<string, number>;
+    shadowRoots: RendererShadowRootSummary[];
+    editorCandidates: RendererDomNodeSummary[];
+    sendButtonCandidates: RendererDomNodeSummary[];
+}
+interface RendererRuntimeClient {
+    evaluate<T>(expression: string): Promise<T>;
+}
+export declare function validateRendererDomInspection(value: unknown): RendererDomInspection;
+export declare function inspectRendererDom(client: RendererRuntimeClient): Promise<RendererDomInspection>;
+export {};
+//# sourceMappingURL=renderer-dom.d.ts.map

package/src/native-ui/desktop-control/dist/renderer-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-dom.d.ts","sourceRoot":"","sources":["../src/renderer-dom.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,WAAW,EAAE,yBAAyB,EAAE,CAAC;IACzC,gBAAgB,EAAE,sBAAsB,EAAE,CAAC;IAC3C,oBAAoB,EAAE,sBAAsB,EAAE,CAAC;CAChD;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7C;AAyBD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAsCnF;AAqDD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAGhC"}

package/src/native-ui/desktop-control/dist/renderer-dom.js

@@ -0,0 +1,110 @@
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function stringArray(value, field) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        throw new Error(`Renderer DOM inspection '${field}' must be a text array`);
+    }
+    return [...value];
+}
+function nodeSummary(value) {
+    if (!isRecord(value) || typeof value.nodeName !== "string") {
+        throw new Error("Renderer DOM inspection candidate must be an object");
+    }
+    return {
+        nodeName: value.nodeName,
+        attributeNames: stringArray(value.attributeNames, "attributeNames"),
+        reasons: stringArray(value.reasons, "reasons"),
+        ancestorNames: stringArray(value.ancestorNames, "ancestorNames"),
+    };
+}
+export function validateRendererDomInspection(value) {
+    if (!isRecord(value) ||
+        !Number.isInteger(value.totalNodes) ||
+        !isRecord(value.nodeNameCounts) ||
+        !Array.isArray(value.shadowRoots) ||
+        !Array.isArray(value.editorCandidates) ||
+        !Array.isArray(value.sendButtonCandidates)) {
+        throw new Error("Renderer DOM inspection returned an invalid result");
+    }
+    const nodeNameCounts = {};
+    for (const [name, count] of Object.entries(value.nodeNameCounts)) {
+        if (!Number.isInteger(count)) {
+            throw new Error("Renderer DOM inspection node counts must be integers");
+        }
+        nodeNameCounts[name] = count;
+    }
+    const shadowRoots = value.shadowRoots.map((shadowRoot) => {
+        if (!isRecord(shadowRoot) ||
+            shadowRoot.shadowRootType !== "open" ||
+            !Number.isInteger(shadowRoot.childNodeCount)) {
+            throw new Error("Renderer DOM inspection returned an invalid shadow root");
+        }
+        return {
+            shadowRootType: "open",
+            childNodeCount: shadowRoot.childNodeCount,
+        };
+    });
+    return {
+        totalNodes: value.totalNodes,
+        nodeNameCounts,
+        shadowRoots,
+        editorCandidates: value.editorCandidates.map(nodeSummary),
+        sendButtonCandidates: value.sendButtonCandidates.map(nodeSummary),
+    };
+}
+const rendererStructureExpression = `(() => {
+  const result = {
+    totalNodes: 0,
+    nodeNameCounts: {},
+    shadowRoots: [],
+    editorCandidates: [],
+    sendButtonCandidates: [],
+  };
+  const summarize = (element, reasons, ancestors) => ({
+    nodeName: element.nodeName.toLowerCase(),
+    attributeNames: element.getAttributeNames().sort(),
+    reasons,
+    ancestorNames: ancestors.slice(-8),
+  });
+  const visit = (node, ancestors) => {
+    result.totalNodes += 1;
+    const nodeName = node.nodeName.toLowerCase();
+    result.nodeNameCounts[nodeName] = (result.nodeNameCounts[nodeName] ?? 0) + 1;
+    if (node.nodeType !== Node.ELEMENT_NODE) return;
+    const element = node;
+    const editorReasons = [];
+    if (nodeName === 'textarea') editorReasons.push('textarea');
+    if (nodeName === 'input' && element.getAttribute('type') !== 'hidden') editorReasons.push('input');
+    if (element.hasAttribute('contenteditable')) editorReasons.push('contenteditable');
+    if (element.getAttribute('role') === 'textbox') editorReasons.push('role=textbox');
+    for (const attribute of ['data-lexical-editor', 'data-slate-editor', 'data-placeholder']) {
+      if (element.hasAttribute(attribute)) editorReasons.push(attribute);
+    }
+    if (editorReasons.length > 0) {
+      result.editorCandidates.push(summarize(element, editorReasons, ancestors));
+    }
+    if (nodeName === 'button' && element.getAttribute('type') === 'submit') {
+      result.sendButtonCandidates.push(summarize(element, ['type=submit'], ancestors));
+    }
+    const nextAncestors = [...ancestors, nodeName];
+    for (const child of element.children) visit(child, nextAncestors);
+    if (element.shadowRoot) {
+      result.shadowRoots.push({
+        shadowRootType: 'open',
+        childNodeCount: element.shadowRoot.childElementCount,
+      });
+      for (const child of element.shadowRoot.children) visit(child, nextAncestors);
+    }
+    if (nodeName === 'template' && element.content) {
+      for (const child of element.content.children) visit(child, nextAncestors);
+    }
+  };
+  visit(document.documentElement, []);
+  return result;
+})()`;
+export async function inspectRendererDom(client) {
+    const inspection = await client.evaluate(rendererStructureExpression);
+    return validateRendererDomInspection(inspection);
+}
+//# sourceMappingURL=renderer-dom.js.map

package/src/native-ui/desktop-control/dist/renderer-dom.js.map

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

package/src/native-ui/desktop-control/dist/renderer-draft-prewarm-policy.d.ts

@@ -0,0 +1,19 @@
+import type { CdpClient } from "./cdp-client.js";
+interface InspectorEvaluator {
+    evaluate<T>(expression: string): Promise<T>;
+}
+export interface RendererDraftPrewarmPolicyStatus {
+    state: "ready";
+    reason: "owned-request-bridge";
+}
+export interface RendererRequestManagerCandidate<Manager = object, RequestClient = object> {
+    manager: Manager;
+    requestClient: RequestClient;
+    hostId: unknown;
+    prewarmedThreadManager: unknown;
+}
+export declare function selectRendererRequestManager<Manager, RequestClient>(candidates: readonly RendererRequestManagerCandidate<Manager, RequestClient>[], activeHostIds: readonly unknown[]): RendererRequestManagerCandidate<Manager, RequestClient> | null;
+export declare function installRendererDraftPrewarmPolicyDirect(renderer: Pick<CdpClient, "evaluate"> | InspectorEvaluator): Promise<RendererDraftPrewarmPolicyStatus>;
+export declare function installRendererDraftPrewarmPolicy(inspector: Pick<CdpClient, "evaluate"> | InspectorEvaluator, rendererWebContentsId: number): Promise<RendererDraftPrewarmPolicyStatus>;
+export {};
+//# sourceMappingURL=renderer-draft-prewarm-policy.d.ts.map

package/src/native-ui/desktop-control/dist/renderer-draft-prewarm-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-draft-prewarm-policy.d.ts","sourceRoot":"","sources":["../src/renderer-draft-prewarm-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,+BAA+B,CAAC,OAAO,GAAG,MAAM,EAAE,aAAa,GAAG,MAAM;IACvF,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,aAAa,EACjE,UAAU,EAAE,SAAS,+BAA+B,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,EAC9E,aAAa,EAAE,SAAS,OAAO,EAAE,GAChC,+BAA+B,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,IAAI,CAchE;AAoJD,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,kBAAkB,GACzD,OAAO,CAAC,gCAAgC,CAAC,CAK3C;AAED,wBAAsB,iCAAiC,CACrD,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,kBAAkB,EAC3D,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC,gCAAgC,CAAC,CAS3C"}