@rynx-ai/daemon 0.1.9 → 0.1.10-beta.2

package/dist/browser-artifact-management.js

@@ -0,0 +1,61 @@
+import { resolveChromeForTestingRelease, } from "./chrome-for-testing-release-resolver.js";
+import { createChromeForTestingArtifactStore, } from "./chrome-for-testing-store.js";
+const MAX_PROGRESS_MESSAGES = 64;
+const MAX_PROGRESS_MESSAGE_BYTES = 2 * 1024;
+const MAX_PROGRESS_TOTAL_BYTES = 32 * 1024;
+/** Daemon-owned Browser artifact operations exposed through local management. */
+export function createBrowserArtifactManagementService(options = {}) {
+    const resolveRelease = options.resolveRelease ?? resolveChromeForTestingRelease;
+    const createStore = options.createStore ?? createChromeForTestingArtifactStore;
+    let store;
+    const artifactStore = () => store ??= createStore();
+    const install = async (input, context = {}) => {
+        const selector = "version" in input && input.version
+            ? { kind: "version", version: input.version }
+            : {
+                kind: "channel",
+                channel: releaseChannel(input.channel ?? "stable"),
+            };
+        const resolved = await resolveRelease(selector, { signal: context.signal });
+        const messages = [];
+        let messageBytes = 0;
+        const installed = await artifactStore().installResolved(resolved, {
+            signal: context.signal,
+            onProgress: (message) => {
+                if (messages.length >= MAX_PROGRESS_MESSAGES)
+                    return;
+                const bounded = boundedUtf8(message, MAX_PROGRESS_MESSAGE_BYTES);
+                const bytes = Buffer.byteLength(bounded, "utf8");
+                if (messageBytes + bytes > MAX_PROGRESS_TOTAL_BYTES)
+                    return;
+                messageBytes += bytes;
+                messages.push(bounded);
+            },
+        });
+        return { resolved, installed, messages };
+    };
+    return {
+        install,
+        update: install,
+        version: () => ({ installed: artifactStore().readActive() ?? null }),
+        clean: () => artifactStore().pruneBuilds(),
+    };
+}
+function releaseChannel(channel) {
+    switch (channel) {
+        case "stable":
+            return "Stable";
+        case "beta":
+            return "Beta";
+        case "dev":
+            return "Dev";
+        case "canary":
+            return "Canary";
+    }
+}
+function boundedUtf8(value, maxBytes) {
+    const bytes = Buffer.from(value, "utf8");
+    if (bytes.byteLength <= maxBytes)
+        return value;
+    return bytes.subarray(0, maxBytes).toString("utf8").replace(/\uFFFD$/u, "");
+}

package/dist/chrome-for-testing-store.js

@@ -9,9 +9,9 @@ import { createHash } from "node:crypto";
 import { accessSync, chmodSync, closeSync, existsSync, lstatSync, mkdirSync, mkdtempSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, writeFileSync, writeSync, } from "node:fs";
 import { constants as fsConstants } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import extractZipArchive from "@electron-internal/extract-zip";
 import { rynxHome } from "@rynx-ai/core";
 import Database from "better-sqlite3";
+import extractZipArchive from "extract-zip";
 const BUILD_OWNER_FILE = ".rynx-cft-owner.json";
 const STAGING_OWNER_FILE = ".rynx-cft-staging-owner.json";
 const ACTIVE_MANIFEST_FILE = "active.json";

package/dist/chrome-inspection-gateway.d.ts

@@ -0,0 +1,58 @@
+declare const LOOPBACK_HOST = "127.0.0.1";
+export interface ChromeInspectionTarget {
+    /** Stable only for the exact daemon boot, Browser generation, and Page. */
+    key: string;
+    title: string;
+    url: string;
+    description: string;
+    engineVersion: string;
+}
+export interface ChromeInspectionTargetSource {
+    /** Discovery must only project existing targets; it must never create a Browser. */
+    listTargets(): Promise<readonly ChromeInspectionTarget[]>;
+    /** Resolve again at attach time so stale routes fail closed. */
+    resolveWebSocketEndpoint?(target: ChromeInspectionTarget): Promise<string>;
+    /**
+     * Open an already-authenticated attachment without publishing another local
+     * listener. Remote Runtime targets use this path.
+     */
+    openConnection?(target: ChromeInspectionTarget, options?: {
+        signal?: AbortSignal;
+    }): Promise<ChromeInspectionConnection | undefined>;
+    activate?(target: ChromeInspectionTarget): Promise<void>;
+    close?(target: ChromeInspectionTarget): Promise<void>;
+}
+export type ChromeInspectionMessage = {
+    binary: false;
+    data: string;
+} | {
+    binary: true;
+    data: Uint8Array;
+};
+export interface ChromeInspectionConnection extends AsyncIterable<ChromeInspectionMessage> {
+    send(message: ChromeInspectionMessage): Promise<void>;
+    close(): Promise<void>;
+}
+export interface StartChromeInspectionGatewayOptions {
+    source: ChromeInspectionTargetSource;
+    port?: number;
+    openTimeoutMs?: number;
+    maxConnections?: number;
+    maxPendingOpenings?: number;
+    randomToken?: () => string;
+    onError?: (error: Error, context: string) => void;
+}
+export interface ChromeInspectionGateway {
+    readonly host: typeof LOOPBACK_HOST;
+    readonly port: number;
+    readonly httpEndpoint: string;
+    shutdown(): Promise<void>;
+}
+/**
+ * Stable loopback discovery endpoint consumed by stock Chrome.
+ *
+ * This gateway owns no Browser. It rewrites only discovery metadata and then
+ * bridges each DevTools WebSocket to an exact target supplied by the daemon.
+ */
+export declare function startChromeInspectionGateway(options: StartChromeInspectionGatewayOptions): Promise<ChromeInspectionGateway>;
+export {};