harness-mix 0.1.0

package/src/native-ui/desktop-control/dist/contract-audit.d.ts

@@ -0,0 +1,73 @@
+import { type ElectronRendererSummary } from "./renderer-control-session.js";
+export declare const DESKTOP_CONTRACT_AUDIT_SCHEMA_VERSION: 1;
+export type ContractAuditCardinalityState = "unique" | "missing" | "ambiguous" | "inactive";
+export interface RendererContractAuditInspection {
+    schemaVersion: 1;
+    composer: {
+        composerCount: number;
+        visibleComposerCount: number;
+        activeComposerCount: number;
+        modelCandidateCount: number;
+        verifiedModelCandidateCount: number;
+        permissionCandidateCount: number;
+        verifiedPermissionCandidateCount: number;
+        contextUsageCandidateCount: number;
+        verifiedContextUsageCandidateCount: number;
+        sendButtonCount: number;
+        trailingActionOwnerCount: number;
+    };
+    model: {
+        draftCount: number;
+        conversationCount: number;
+        missingCount: number;
+        ambiguousCount: number;
+    };
+    settings: {
+        headerCount: number;
+        visibleHeaderCount: number;
+        insertionPointCount: number;
+    };
+    sidebar: {
+        rowCount: number;
+        titleOwnerCount: number;
+        resolvedThreadCount: number;
+        ambiguousThreadCount: number;
+    };
+    transcript: {
+        turnCount: number;
+        itemNodeCount: number;
+        identifiedItemCount: number;
+        textBodyCount: number;
+        textBodyOwnerCount: number;
+    };
+    fork: {
+        annotatedResponseCount: number;
+        candidateButtonCount: number;
+        verifiedButtonCount: number;
+    };
+    production: {
+        bindingPresent: boolean;
+        adapterState: "installing" | "ready" | "unsupported" | "absent";
+        adapterReason: string;
+        titlePolicyState: "ready" | "absent" | "unknown";
+        draftPrewarmPolicyState: "ready" | "absent" | "unknown";
+    };
+}
+export interface DesktopContractAuditObservation {
+    schemaVersion: typeof DESKTOP_CONTRACT_AUDIT_SCHEMA_VERSION;
+    browser: {
+        browser: string;
+        protocolVersion: string;
+    };
+    renderer: ElectronRendererSummary;
+    contracts: RendererContractAuditInspection;
+}
+export interface InspectDesktopContractsOptions {
+    endpoint: string;
+    inspectorEndpoint: string;
+    rendererAuditSource: string;
+    timeoutMs?: number;
+}
+export declare function validateRendererContractAuditInspection(value: unknown): RendererContractAuditInspection;
+export declare function inspectDesktopContracts(options: InspectDesktopContractsOptions): Promise<DesktopContractAuditObservation>;
+//# sourceMappingURL=contract-audit.d.ts.map

package/src/native-ui/desktop-control/dist/contract-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-audit.d.ts","sourceRoot":"","sources":["../src/contract-audit.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,+BAA+B,CAAC;AAEvC,eAAO,MAAM,qCAAqC,EAAG,CAAU,CAAC;AAEhE,MAAM,MAAM,6BAA6B,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAE5F,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,CAAC,CAAC;IACjB,QAAQ,EAAE;QACR,aAAa,EAAE,MAAM,CAAC;QACtB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,2BAA2B,EAAE,MAAM,CAAC;QACpC,wBAAwB,EAAE,MAAM,CAAC;QACjC,gCAAgC,EAAE,MAAM,CAAC;QACzC,0BAA0B,EAAE,MAAM,CAAC;QACnC,kCAAkC,EAAE,MAAM,CAAC;QAC3C,eAAe,EAAE,MAAM,CAAC;QACxB,wBAAwB,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,IAAI,EAAE;QACJ,sBAAsB,EAAE,MAAM,CAAC;QAC/B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,UAAU,EAAE;QACV,cAAc,EAAE,OAAO,CAAC;QACxB,YAAY,EAAE,YAAY,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;QAChE,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;QACjD,uBAAuB,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;KACzD,CAAC;CACH;AAED,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,OAAO,qCAAqC,CAAC;IAC5D,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE,uBAAuB,CAAC;IAClC,SAAS,EAAE,+BAA+B,CAAC;CAC5C;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwCD,wBAAgB,uCAAuC,CACrD,KAAK,EAAE,OAAO,GACb,+BAA+B,CAqGjC;AAyCD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,+BAA+B,CAAC,CAwB1C"}

package/src/native-ui/desktop-control/dist/contract-audit.js

@@ -0,0 +1,152 @@
+import { CdpClient, getCdpBrowserVersion } from "./cdp-client.js";
+import { inspectElectronWebContents, selectRendererWebContents, waitForInspectorTarget, } from "./renderer-control-session.js";
+export const DESKTOP_CONTRACT_AUDIT_SCHEMA_VERSION = 1;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function strictKeys(value, expected, label) {
+    const keys = Object.keys(value).toSorted();
+    const sortedExpected = [...expected].toSorted();
+    if (keys.length !== sortedExpected.length ||
+        keys.some((key, index) => key !== sortedExpected[index])) {
+        throw new Error(`${label} contains unknown or missing fields`);
+    }
+}
+function integer(value, label) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`${label} must be a non-negative integer`);
+    }
+    return value;
+}
+function integerRecord(value, keys, label) {
+    if (!isRecord(value))
+        throw new Error(`${label} must be an object`);
+    strictKeys(value, keys, label);
+    return Object.fromEntries(keys.map((key) => [key, integer(value[key], `${label}.${key}`)]));
+}
+export function validateRendererContractAuditInspection(value) {
+    if (!isRecord(value))
+        throw new Error("Renderer contract audit must be an object");
+    strictKeys(value, [
+        "schemaVersion",
+        "composer",
+        "model",
+        "settings",
+        "sidebar",
+        "transcript",
+        "fork",
+        "production",
+    ], "Renderer contract audit");
+    if (value.schemaVersion !== 1)
+        throw new Error("Renderer contract audit schema is unsupported");
+    const production = value.production;
+    if (!isRecord(production))
+        throw new Error("Renderer contract audit production state is invalid");
+    strictKeys(production, [
+        "bindingPresent",
+        "adapterState",
+        "adapterReason",
+        "titlePolicyState",
+        "draftPrewarmPolicyState",
+    ], "Renderer contract audit production state");
+    if (typeof production.bindingPresent !== "boolean" ||
+        !["installing", "ready", "unsupported", "absent"].includes(String(production.adapterState)) ||
+        typeof production.adapterReason !== "string" ||
+        production.adapterReason.length > 64 ||
+        !["ready", "absent", "unknown"].includes(String(production.titlePolicyState)) ||
+        !["ready", "absent", "unknown"].includes(String(production.draftPrewarmPolicyState))) {
+        throw new Error("Renderer contract audit production state is invalid");
+    }
+    return {
+        schemaVersion: 1,
+        composer: integerRecord(value.composer, [
+            "composerCount",
+            "visibleComposerCount",
+            "activeComposerCount",
+            "modelCandidateCount",
+            "verifiedModelCandidateCount",
+            "permissionCandidateCount",
+            "verifiedPermissionCandidateCount",
+            "contextUsageCandidateCount",
+            "verifiedContextUsageCandidateCount",
+            "sendButtonCount",
+            "trailingActionOwnerCount",
+        ], "Renderer composer contract"),
+        model: integerRecord(value.model, ["draftCount", "conversationCount", "missingCount", "ambiguousCount"], "Renderer model contract"),
+        settings: integerRecord(value.settings, ["headerCount", "visibleHeaderCount", "insertionPointCount"], "Renderer settings contract"),
+        sidebar: integerRecord(value.sidebar, ["rowCount", "titleOwnerCount", "resolvedThreadCount", "ambiguousThreadCount"], "Renderer sidebar contract"),
+        transcript: integerRecord(value.transcript, [
+            "turnCount",
+            "itemNodeCount",
+            "identifiedItemCount",
+            "textBodyCount",
+            "textBodyOwnerCount",
+        ], "Renderer transcript contract"),
+        fork: integerRecord(value.fork, ["annotatedResponseCount", "candidateButtonCount", "verifiedButtonCount"], "Renderer fork contract"),
+        production: {
+            bindingPresent: production.bindingPresent,
+            adapterState: production.adapterState,
+            adapterReason: production.adapterReason,
+            titlePolicyState: production.titlePolicyState,
+            draftPrewarmPolicyState: production.draftPrewarmPolicyState,
+        },
+    };
+}
+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');
+})()`;
+async function executeReadOnlyAudit(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');
+    return contents.executeJavaScript(${JSON.stringify(`(() => {
+      const previous = window.__codexhostContractAuditV1;
+      ${source}
+      try {
+        const audit = window.__codexhostContractAuditV1;
+        if (audit == null || typeof audit.inspect !== 'function') {
+          throw new Error('Renderer contract audit entry is unavailable');
+        }
+        return audit.inspect();
+      } finally {
+        if (previous === undefined) delete window.__codexhostContractAuditV1;
+        else window.__codexhostContractAuditV1 = previous;
+      }
+    })()`)}, true);
+  })()`);
+}
+function browserIdentity(version) {
+    return { browser: version.browser, protocolVersion: version.protocolVersion };
+}
+export async function inspectDesktopContracts(options) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const [browser, inspectorTarget] = await Promise.all([
+        getCdpBrowserVersion(options.endpoint),
+        waitForInspectorTarget(options.inspectorEndpoint, { timeoutMs }),
+    ]);
+    const inspector = await CdpClient.connect(inspectorTarget.webSocketDebuggerUrl);
+    try {
+        await inspector.command("Runtime.enable");
+        const inventory = await inspectElectronWebContents(inspector);
+        const renderer = selectRendererWebContents(inventory);
+        if (!renderer)
+            throw new Error("Contract audit did not find a primary Renderer");
+        const contracts = validateRendererContractAuditInspection(await executeReadOnlyAudit(inspector, renderer.id, options.rendererAuditSource));
+        return {
+            schemaVersion: DESKTOP_CONTRACT_AUDIT_SCHEMA_VERSION,
+            browser: browserIdentity(browser),
+            renderer,
+            contracts,
+        };
+    }
+    finally {
+        inspector.close();
+    }
+}
+//# sourceMappingURL=contract-audit.js.map

package/src/native-ui/desktop-control/dist/contract-audit.js.map

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

package/src/native-ui/desktop-control/dist/controller-attachment-server.d.ts

@@ -0,0 +1,10 @@
+export interface ControllerAttachmentServer {
+    close(): Promise<void>;
+}
+export interface StartControllerAttachmentServerOptions {
+    port: number;
+    nonce: string;
+    attach(): Promise<void>;
+}
+export declare function startControllerAttachmentServer(options: StartControllerAttachmentServerOptions): Promise<ControllerAttachmentServer>;
+//# sourceMappingURL=controller-attachment-server.d.ts.map

package/src/native-ui/desktop-control/dist/controller-attachment-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-attachment-server.d.ts","sourceRoot":"","sources":["../src/controller-attachment-server.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,0BAA0B;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,sCAAsC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAuBD,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,sCAAsC,GAC9C,OAAO,CAAC,0BAA0B,CAAC,CAuDrC"}

package/src/native-ui/desktop-control/dist/controller-attachment-server.js

@@ -0,0 +1,77 @@
+import { createServer } from "node:net";
+const MAX_REQUEST_BYTES = 96;
+function validPort(value) {
+    return Number.isInteger(value) && value >= 1 && value <= 65_535;
+}
+function validNonce(value) {
+    return /^[0-9a-f]{32}$/.test(value);
+}
+function closeServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => {
+            if (error)
+                reject(error);
+            else
+                resolve();
+        });
+    });
+}
+function respond(socket, value) {
+    socket.end(`${value}\n`);
+}
+export async function startControllerAttachmentServer(options) {
+    if (!validPort(options.port))
+        throw new Error("attachment port must be a valid TCP port");
+    if (!validNonce(options.nonce)) {
+        throw new Error("attachment nonce must be 32 lowercase hexadecimal characters");
+    }
+    const sockets = new Set();
+    const server = createServer((socket) => {
+        sockets.add(socket);
+        socket.once("close", () => sockets.delete(socket));
+        socket.setEncoding("utf8");
+        socket.setTimeout(5_000, () => socket.destroy());
+        let request = "";
+        let handled = false;
+        socket.on("data", (chunk) => {
+            if (handled)
+                return;
+            request += chunk;
+            if (request.length > MAX_REQUEST_BYTES) {
+                handled = true;
+                respond(socket, "rejected");
+                return;
+            }
+            const newline = request.indexOf("\n");
+            if (newline < 0)
+                return;
+            handled = true;
+            const line = request.slice(0, newline).replace(/\r$/, "");
+            if (line === `ATTACH ${options.nonce}`) {
+                void options.attach().then(() => respond(socket, "ready"), () => respond(socket, "failed"));
+                return;
+            }
+            respond(socket, "rejected");
+        });
+    });
+    await new Promise((resolve, reject) => {
+        const onError = (error) => reject(error);
+        server.once("error", onError);
+        server.listen(options.port, "127.0.0.1", () => {
+            server.off("error", onError);
+            resolve();
+        });
+    });
+    let closed = false;
+    return {
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            for (const socket of sockets)
+                socket.destroy();
+            await closeServer(server);
+        },
+    };
+}
+//# sourceMappingURL=controller-attachment-server.js.map

package/src/native-ui/desktop-control/dist/controller-attachment-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-attachment-server.js","sourceRoot":"","sources":["../src/controller-attachment-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA4B,MAAM,UAAU,CAAC;AAElE,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAY7B,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,MAAM,CAAC;AAClE,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACrB,IAAI,KAAK;gBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;gBACpB,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,KAAsC;IACrE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAA+C;IAE/C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC1F,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAClC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,IAAI,KAAK,CAAC;YACjB,IAAI,OAAO,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;gBACvC,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAC5B,OAAO;YACT,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAO;YACxB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1D,IAAI,IAAI,KAAK,UAAU,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;gBACvC,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CACxB,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAChC,CAAC;gBACF,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,OAAO,GAAG,CAAC,KAAY,EAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,OAAO;QACL,KAAK,CAAC,KAAK;YACT,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/C,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,21 @@
+export { CdpClient, getCdpBrowserVersion, listCdpTargets, waitForRendererTarget, } from "./cdp-client.js";
+export type { CdpBrowserVersion, CdpClientOptions, CdpEventListener, CdpFetch, CdpFetchResponse, CdpSocketFactory, CdpTarget, } from "./cdp-client.js";
+export { DESKTOP_CONTRACT_AUDIT_SCHEMA_VERSION, inspectDesktopContracts, validateRendererContractAuditInspection, } from "./contract-audit.js";
+export type { DesktopContractAuditObservation, InspectDesktopContractsOptions, RendererContractAuditInspection, } from "./contract-audit.js";
+export { inspectRendererDom, validateRendererDomInspection } from "./renderer-dom.js";
+export { createRendererCdpControlSession, installRendererCdpControlSession, selectPrimaryRendererTarget, } from "./renderer-cdp-control-session.js";
+export type { InstallRendererCdpControlOptions, ProductionRendererStatus as RendererCdpProductionStatus, RendererCdpControlSession, RendererCdpControlSnapshot, } from "./renderer-cdp-control-session.js";
+export { activateElectronDesktop, createRendererControlSession, inspectElectronWebContents, installRendererControlSession, selectRendererWebContents, waitForInspectorTarget, waitForRendererTitlePolicyReady, } from "./renderer-control-session.js";
+export type { ElectronRendererSummary, InstallRendererControlOptions, ProductionRendererStatus, RendererControlSession, RendererControlSnapshot, } from "./renderer-control-session.js";
+export type { RendererDomInspection, RendererDomNodeSummary, RendererShadowRootSummary, } from "./renderer-dom.js";
+export { installMainProcessTitlePolicy, markRendererTitlePolicyReady, readMainProcessTitlePolicyCounters, } from "./main-process-title-policy.js";
+export type { MainProcessTitlePolicyCounters, MainProcessTitlePolicyStatus, RendererTitlePolicyReadiness, } from "./main-process-title-policy.js";
+export { installRendererDraftPrewarmPolicy, installRendererDraftPrewarmPolicyDirect, } from "./renderer-draft-prewarm-policy.js";
+export type { RendererDraftPrewarmPolicyStatus } from "./renderer-draft-prewarm-policy.js";
+export { parseDesktopControllerArguments, runDesktopController, serializeDesktopControllerReadiness, } from "./production-controller.js";
+export type { DesktopControllerDependencies, DesktopControllerOptions, DesktopControllerReadiness, } from "./production-controller.js";
+export declare const packageMetadata: {
+    readonly name: "@codexhost/desktop-control";
+    readonly contractVersion: 1;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,GACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qCAAqC,EACrC,uBAAuB,EACvB,uCAAuC,GACxC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACV,gCAAgC,EAChC,wBAAwB,IAAI,2BAA2B,EACvD,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,6BAA6B,EAC7B,yBAAyB,EACzB,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,uBAAuB,EACvB,6BAA6B,EAC7B,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,iCAAiC,EACjC,uCAAuC,GACxC,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAE3F,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,mCAAmC,GACpC,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,eAAe;;;CAGlB,CAAC"}

package/src/native-ui/desktop-control/dist/index.js

@@ -0,0 +1,14 @@
+import { WORKSPACE_CONTRACT_VERSION } from "@codexhost/shared-contracts";
+export { CdpClient, getCdpBrowserVersion, listCdpTargets, waitForRendererTarget, } from "./cdp-client.js";
+export { DESKTOP_CONTRACT_AUDIT_SCHEMA_VERSION, inspectDesktopContracts, validateRendererContractAuditInspection, } from "./contract-audit.js";
+export { inspectRendererDom, validateRendererDomInspection } from "./renderer-dom.js";
+export { createRendererCdpControlSession, installRendererCdpControlSession, selectPrimaryRendererTarget, } from "./renderer-cdp-control-session.js";
+export { activateElectronDesktop, createRendererControlSession, inspectElectronWebContents, installRendererControlSession, selectRendererWebContents, waitForInspectorTarget, waitForRendererTitlePolicyReady, } from "./renderer-control-session.js";
+export { installMainProcessTitlePolicy, markRendererTitlePolicyReady, readMainProcessTitlePolicyCounters, } from "./main-process-title-policy.js";
+export { installRendererDraftPrewarmPolicy, installRendererDraftPrewarmPolicyDirect, } from "./renderer-draft-prewarm-policy.js";
+export { parseDesktopControllerArguments, runDesktopController, serializeDesktopControllerReadiness, } from "./production-controller.js";
+export const packageMetadata = {
+    name: "@codexhost/desktop-control",
+    contractVersion: WORKSPACE_CONTRACT_VERSION,
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAUzB,OAAO,EACL,qCAAqC,EACrC,uBAAuB,EACvB,uCAAuC,GACxC,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAO3C,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,6BAA6B,EAC7B,yBAAyB,EACzB,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AAavC,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EACL,iCAAiC,EACjC,uCAAuC,GACxC,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,mCAAmC,GACpC,MAAM,4BAA4B,CAAC;AAOpC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,4BAA4B;IAClC,eAAe,EAAE,0BAA0B;CACnC,CAAC"}

package/src/native-ui/desktop-control/dist/main-process-title-policy.d.ts

@@ -0,0 +1,24 @@
+import type { CdpClient } from "./cdp-client.js";
+interface CdpCommander {
+    command(method: string, params?: Record<string, unknown>): Promise<unknown>;
+}
+export interface MainProcessTitlePolicyStatus {
+    state: "ready";
+    reason: "ready";
+    requiresRendererReload: true;
+}
+export interface MainProcessTitlePolicyCounters {
+    codexTitleCalls: number;
+    piTitleSkips: number;
+    externalTitleSkips: number;
+    ambiguousTitleSkips: number;
+}
+export interface RendererTitlePolicyReadiness {
+    state: "ready";
+    reason: "owned-metadata-service";
+}
+export declare function installMainProcessTitlePolicy(inspector: Pick<CdpClient, "command"> | CdpCommander, rendererWebContentsId: number): Promise<MainProcessTitlePolicyStatus>;
+export declare function markRendererTitlePolicyReady(inspector: Pick<CdpClient, "evaluate">, rendererWebContentsId: number): Promise<RendererTitlePolicyReadiness>;
+export declare function readMainProcessTitlePolicyCounters(inspector: Pick<CdpClient, "evaluate">): Promise<MainProcessTitlePolicyCounters | null>;
+export {};
+//# sourceMappingURL=main-process-title-policy.d.ts.map

package/src/native-ui/desktop-control/dist/main-process-title-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-process-title-policy.d.ts","sourceRoot":"","sources":["../src/main-process-title-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,UAAU,YAAY;IACpB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E;AAYD,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,sBAAsB,EAAE,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,wBAAwB,CAAC;CAClC;AA6JD,wBAAsB,6BAA6B,CACjD,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,YAAY,EACpD,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC,4BAA4B,CAAC,CAoFvC;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EACtC,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC,4BAA4B,CAAC,CAgCvC;AAED,wBAAsB,kCAAkC,CACtD,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GACrC,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAgBhD"}