ysk-server-core 1.0.0

package/dist/host/timezones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezones.d.ts","sourceRoot":"","sources":["../../src/host/timezones.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,oXAsBrB,CAAC;AAIX,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;IACnE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,aAAa,GAAG,UAAU,CAAC;CACpC,CAAC,CAgBD;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAKtF"}

package/dist/host/timezones.js

@@ -0,0 +1,64 @@
+/**
+ * Host timezone list for identity UI (select, not free-text).
+ * Source: timedatectl list-timezones (read-only on executor policy).
+ */
+/** Used when timedatectl is missing or fails — still a select, not free text. */
+export const FALLBACK_TIMEZONES = [
+    'UTC',
+    'Asia/Hong_Kong',
+    'Asia/Shanghai',
+    'Asia/Taipei',
+    'Asia/Tokyo',
+    'Asia/Singapore',
+    'Asia/Bangkok',
+    'Asia/Kolkata',
+    'Asia/Dubai',
+    'Europe/London',
+    'Europe/Paris',
+    'Europe/Berlin',
+    'Europe/Vilnius',
+    'Europe/Moscow',
+    'America/New_York',
+    'America/Chicago',
+    'America/Denver',
+    'America/Los_Angeles',
+    'America/Sao_Paulo',
+    'Australia/Sydney',
+    'Pacific/Auckland',
+];
+const TZ_RE = /^[A-Za-z0-9_+./-]+$/;
+export function isValidTimezoneId(tz) {
+    const t = tz.trim();
+    return t.length > 0 && t.length <= 64 && TZ_RE.test(t) && !t.includes('..');
+}
+/**
+ * List IANA timezones available on the host (via timedatectl).
+ * Falls back to a curated list when the command fails.
+ */
+export async function listHostTimezones(host) {
+    try {
+        const r = await host.runCommand(['timedatectl', 'list-timezones'], { timeoutMs: 20_000 });
+        if (r.exitCode === 0) {
+            const timezones = r.stdout
+                .split('\n')
+                .map((l) => l.trim())
+                .filter((l) => isValidTimezoneId(l));
+            if (timezones.length > 0) {
+                return { timezones, source: 'timedatectl' };
+            }
+        }
+    }
+    catch {
+        /* fallback */
+    }
+    return { timezones: [...FALLBACK_TIMEZONES], source: 'fallback' };
+}
+/** Ensure current zone appears in options even if list is stale/partial. */
+export function mergeTimezoneOptions(list, current) {
+    const set = new Set(list);
+    const cur = current?.trim();
+    if (cur && isValidTimezoneId(cur))
+        set.add(cur);
+    return Array.from(set).sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=timezones.js.map

package/dist/host/timezones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezones.js","sourceRoot":"","sources":["../../src/host/timezones.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK;IACL,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,YAAY;IACZ,eAAe;IACf,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,kBAAkB;IAClB,iBAAiB;IACjB,gBAAgB;IAChB,qBAAqB;IACrB,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;CACV,CAAC;AAEX,MAAM,KAAK,GAAG,qBAAqB,CAAC;AAEpC,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACpB,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAkB;IAIxD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM;iBACvB,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,kBAAkB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AACpE,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,IAAc,EAAE,OAAuB;IAC1E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,GAAG,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5B,IAAI,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/host-browse/audio-bridge.d.ts

@@ -0,0 +1,20 @@
+/**
+ * In-page audio capture for host-browse (HTMLMediaElement.captureStream → PCM).
+ * Chunks are polled from window.__yskAudioQ by BrowserEngine.
+ */
+export type AudioPcmChunk = {
+    /** Sample rate Hz */
+    sampleRate: number;
+    /** little-endian int16 mono PCM, base64 */
+    pcmB64: string;
+    channels: 1;
+};
+export type AudioBridgeStatus = {
+    enabled: boolean;
+    active: boolean;
+    reason?: string;
+};
+/** Injected into the live page (same-origin media elements only when captureStream works). */
+export declare const AUDIO_BRIDGE_BOOTSTRAP = "(() => {\n  if (window.__yskHbAudioBoot) return;\n  window.__yskHbAudioBoot = true;\n  window.__yskAudioQ = window.__yskAudioQ || [];\n  const MAX_Q = 40;\n  const attach = (el) => {\n    try {\n      if (!el || el.__yskHbAudio) return;\n      if (typeof el.captureStream !== 'function' && typeof el.mozCaptureStream !== 'function') return;\n      el.__yskHbAudio = true;\n      const getStream = () =>\n        (el.captureStream && el.captureStream()) ||\n        (el.mozCaptureStream && el.mozCaptureStream());\n      const tryStart = () => {\n        if (el.__yskHbAudioStarted) return;\n        let stream;\n        try {\n          stream = getStream();\n        } catch (e) {\n          return;\n        }\n        if (!stream) return;\n        const tracks = stream.getAudioTracks ? stream.getAudioTracks() : [];\n        if (!tracks.length) return;\n        el.__yskHbAudioStarted = true;\n        const astream = new MediaStream(tracks);\n        const AC = window.AudioContext || window.webkitAudioContext;\n        if (!AC) return;\n        const ctx = new AC();\n        const src = ctx.createMediaStreamSource(astream);\n        const gain = ctx.createGain();\n        gain.gain.value = 0;\n        const bufSize = 2048;\n        const proc = ctx.createScriptProcessor(bufSize, 1, 1);\n        src.connect(proc);\n        proc.connect(gain);\n        gain.connect(ctx.destination);\n        proc.onaudioprocess = (ev) => {\n          try {\n            const input = ev.inputBuffer.getChannelData(0);\n            let peak = 0;\n            for (let i = 0; i < input.length; i++) {\n              const a = Math.abs(input[i]);\n              if (a > peak) peak = a;\n            }\n            if (peak < 1e-5) return;\n            const int16 = new Int16Array(input.length);\n            for (let i = 0; i < input.length; i++) {\n              let s = input[i];\n              if (s > 1) s = 1;\n              else if (s < -1) s = -1;\n              int16[i] = s < 0 ? s * 0x8000 : s * 0x7fff;\n            }\n            const u8 = new Uint8Array(int16.buffer);\n            let bin = '';\n            for (let i = 0; i < u8.length; i++) bin += String.fromCharCode(u8[i]);\n            window.__yskAudioQ.push({\n              sr: ctx.sampleRate || 48000,\n              pcm: btoa(bin),\n              ch: 1,\n            });\n            if (window.__yskAudioQ.length > MAX_Q) {\n              window.__yskAudioQ.splice(0, window.__yskAudioQ.length - MAX_Q);\n            }\n          } catch (e) { /* */ }\n        };\n        if (ctx.state === 'suspended') ctx.resume().catch(function () {});\n      };\n      el.addEventListener('play', tryStart, { passive: true });\n      el.addEventListener('playing', tryStart, { passive: true });\n      if (!el.paused) tryStart();\n    } catch (e) { /* */ }\n  };\n  const scan = () => {\n    try {\n      document.querySelectorAll('video, audio').forEach(attach);\n    } catch (e) { /* */ }\n  };\n  scan();\n  setInterval(scan, 1500);\n  try {\n    new MutationObserver(scan).observe(document.documentElement || document.body, {\n      childList: true,\n      subtree: true,\n    });\n  } catch (e) { /* */ }\n})();";
+export declare function decodePcmB64(b64: string): Buffer;
+//# sourceMappingURL=audio-bridge.d.ts.map

package/dist/host-browse/audio-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-bridge.d.ts","sourceRoot":"","sources":["../../src/host-browse/audio-bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,CAAC,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,4mGAsF7B,CAAC;AAEP,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/host-browse/audio-bridge.js

@@ -0,0 +1,96 @@
+/**
+ * In-page audio capture for host-browse (HTMLMediaElement.captureStream → PCM).
+ * Chunks are polled from window.__yskAudioQ by BrowserEngine.
+ */
+/** Injected into the live page (same-origin media elements only when captureStream works). */
+export const AUDIO_BRIDGE_BOOTSTRAP = `(() => {
+  if (window.__yskHbAudioBoot) return;
+  window.__yskHbAudioBoot = true;
+  window.__yskAudioQ = window.__yskAudioQ || [];
+  const MAX_Q = 40;
+  const attach = (el) => {
+    try {
+      if (!el || el.__yskHbAudio) return;
+      if (typeof el.captureStream !== 'function' && typeof el.mozCaptureStream !== 'function') return;
+      el.__yskHbAudio = true;
+      const getStream = () =>
+        (el.captureStream && el.captureStream()) ||
+        (el.mozCaptureStream && el.mozCaptureStream());
+      const tryStart = () => {
+        if (el.__yskHbAudioStarted) return;
+        let stream;
+        try {
+          stream = getStream();
+        } catch (e) {
+          return;
+        }
+        if (!stream) return;
+        const tracks = stream.getAudioTracks ? stream.getAudioTracks() : [];
+        if (!tracks.length) return;
+        el.__yskHbAudioStarted = true;
+        const astream = new MediaStream(tracks);
+        const AC = window.AudioContext || window.webkitAudioContext;
+        if (!AC) return;
+        const ctx = new AC();
+        const src = ctx.createMediaStreamSource(astream);
+        const gain = ctx.createGain();
+        gain.gain.value = 0;
+        const bufSize = 2048;
+        const proc = ctx.createScriptProcessor(bufSize, 1, 1);
+        src.connect(proc);
+        proc.connect(gain);
+        gain.connect(ctx.destination);
+        proc.onaudioprocess = (ev) => {
+          try {
+            const input = ev.inputBuffer.getChannelData(0);
+            let peak = 0;
+            for (let i = 0; i < input.length; i++) {
+              const a = Math.abs(input[i]);
+              if (a > peak) peak = a;
+            }
+            if (peak < 1e-5) return;
+            const int16 = new Int16Array(input.length);
+            for (let i = 0; i < input.length; i++) {
+              let s = input[i];
+              if (s > 1) s = 1;
+              else if (s < -1) s = -1;
+              int16[i] = s < 0 ? s * 0x8000 : s * 0x7fff;
+            }
+            const u8 = new Uint8Array(int16.buffer);
+            let bin = '';
+            for (let i = 0; i < u8.length; i++) bin += String.fromCharCode(u8[i]);
+            window.__yskAudioQ.push({
+              sr: ctx.sampleRate || 48000,
+              pcm: btoa(bin),
+              ch: 1,
+            });
+            if (window.__yskAudioQ.length > MAX_Q) {
+              window.__yskAudioQ.splice(0, window.__yskAudioQ.length - MAX_Q);
+            }
+          } catch (e) { /* */ }
+        };
+        if (ctx.state === 'suspended') ctx.resume().catch(function () {});
+      };
+      el.addEventListener('play', tryStart, { passive: true });
+      el.addEventListener('playing', tryStart, { passive: true });
+      if (!el.paused) tryStart();
+    } catch (e) { /* */ }
+  };
+  const scan = () => {
+    try {
+      document.querySelectorAll('video, audio').forEach(attach);
+    } catch (e) { /* */ }
+  };
+  scan();
+  setInterval(scan, 1500);
+  try {
+    new MutationObserver(scan).observe(document.documentElement || document.body, {
+      childList: true,
+      subtree: true,
+    });
+  } catch (e) { /* */ }
+})();`;
+export function decodePcmB64(b64) {
+    return Buffer.from(b64, 'base64');
+}
+//# sourceMappingURL=audio-bridge.js.map

package/dist/host-browse/audio-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-bridge.js","sourceRoot":"","sources":["../../src/host-browse/audio-bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAsFhC,CAAC;AAEP,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/host-browse/bookmarks.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Per-operator bookmarks / history / home for host-browse (persisted via settings JSON).
+ */
+export type BrowseBookmark = {
+    id: string;
+    title: string;
+    url: string;
+    createdAt: string;
+};
+export type BrowseHistoryEntry = {
+    id: string;
+    title: string;
+    url: string;
+    at: string;
+};
+export type BrowseUserLibrary = {
+    homeUrl: string;
+    bookmarks: BrowseBookmark[];
+    history: BrowseHistoryEntry[];
+    /** Last session snapshot for resume (URLs only, no cookies) */
+    lastSnapshot?: {
+        tabs: Array<{
+            url: string;
+            title?: string;
+        }>;
+        activeIndex: number;
+        mode: string;
+        engine: string;
+        updatedAt: string;
+    };
+};
+export declare function emptyLibrary(): BrowseUserLibrary;
+export declare function upsertBookmark(lib: BrowseUserLibrary, input: {
+    url: string;
+    title?: string;
+}): BrowseUserLibrary;
+export declare function removeBookmark(lib: BrowseUserLibrary, id: string): BrowseUserLibrary;
+export declare function pushHistory(lib: BrowseUserLibrary, input: {
+    url: string;
+    title?: string;
+}): BrowseUserLibrary;
+export declare function setHome(lib: BrowseUserLibrary, homeUrl: string): BrowseUserLibrary;
+export declare function saveSnapshot(lib: BrowseUserLibrary, snap: NonNullable<BrowseUserLibrary['lastSnapshot']>): BrowseUserLibrary;
+//# sourceMappingURL=bookmarks.d.ts.map

package/dist/host-browse/bookmarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookmarks.d.ts","sourceRoot":"","sources":["../../src/host-browse/bookmarks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,+DAA+D;IAC/D,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC7C,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,wBAAgB,YAAY,IAAI,iBAAiB,CAMhD;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,iBAAiB,CAiBnB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,GAAG,iBAAiB,CAEpF;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,iBAAiB,CAWnB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAGlF;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,WAAW,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,GACnD,iBAAiB,CAEnB"}

package/dist/host-browse/bookmarks.js

@@ -0,0 +1,54 @@
+/**
+ * Per-operator bookmarks / history / home for host-browse (persisted via settings JSON).
+ */
+import { randomBytes } from 'node:crypto';
+export function emptyLibrary() {
+    return {
+        homeUrl: 'https://www.google.com/',
+        bookmarks: [],
+        history: [],
+    };
+}
+export function upsertBookmark(lib, input) {
+    const url = input.url.trim();
+    if (!url)
+        return lib;
+    const existing = lib.bookmarks.find((b) => b.url === url);
+    if (existing) {
+        return {
+            ...lib,
+            bookmarks: lib.bookmarks.filter((b) => b.url !== url),
+        };
+    }
+    const b = {
+        id: randomBytes(8).toString('hex'),
+        title: (input.title || url).slice(0, 200),
+        url,
+        createdAt: new Date().toISOString(),
+    };
+    return { ...lib, bookmarks: [b, ...lib.bookmarks].slice(0, 200) };
+}
+export function removeBookmark(lib, id) {
+    return { ...lib, bookmarks: lib.bookmarks.filter((b) => b.id !== id) };
+}
+export function pushHistory(lib, input) {
+    const url = input.url.trim();
+    if (!url || url === 'about:blank')
+        return lib;
+    const entry = {
+        id: randomBytes(8).toString('hex'),
+        title: (input.title || url).slice(0, 200),
+        url,
+        at: new Date().toISOString(),
+    };
+    const rest = lib.history.filter((h) => h.url !== url);
+    return { ...lib, history: [entry, ...rest].slice(0, 200) };
+}
+export function setHome(lib, homeUrl) {
+    const u = homeUrl.trim() || 'https://www.google.com/';
+    return { ...lib, homeUrl: u };
+}
+export function saveSnapshot(lib, snap) {
+    return { ...lib, lastSnapshot: { ...snap, updatedAt: new Date().toISOString() } };
+}
+//# sourceMappingURL=bookmarks.js.map

package/dist/host-browse/bookmarks.js.map

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

package/dist/host-browse/browser-engine.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Host Chromium engine via playwright-core + system Chrome.
+ * Screencast (CDP) + mouse/keyboard for real browsing feel.
+ */
+import type { HostBrowseMode, HostBrowsePolicy } from './types.js';
+import { type StreamOptions, type StreamPresetId } from './stream-presets.js';
+import { type ChromeAsUserHandle } from './chrome-as-user.js';
+import type { HostExecutor } from '../host/executor.js';
+import { type BrowseDownload, type BrowseDownloadPublic } from './downloads.js';
+import { type AudioBridgeStatus, type AudioPcmChunk } from './audio-bridge.js';
+type Browser = import('playwright-core').Browser;
+type BrowserContext = import('playwright-core').BrowserContext;
+type Page = import('playwright-core').Page;
+type CDPSession = import('playwright-core').CDPSession;
+export type BrowserSessionHandle = {
+    sessionId: string;
+    userId: string;
+    mode: HostBrowseMode;
+    /** Per-session browser when using CDP-as-user; else shared launcher browser */
+    browser: Browser;
+    ownsBrowser: boolean;
+    chromeAsUser?: ChromeAsUserHandle;
+    context: BrowserContext;
+    page: Page;
+    /** Multi-tab pages (real browser) */
+    pages: Map<string, Page>;
+    activePageId: string;
+    cdp: CDPSession | null;
+    screencastOn: boolean;
+    viewport: {
+        w: number;
+        h: number;
+    };
+    stream: StreamOptions;
+    /** dataDir root for saving downloads (optional) */
+    dataDir?: string;
+    downloads: BrowseDownload[];
+    audioBridgeOn: boolean;
+    audioPollTimer?: ReturnType<typeof setInterval>;
+    onFrame?: (frame: {
+        mime: string;
+        data: Buffer;
+        width: number;
+        height: number;
+    }) => void;
+    onMeta?: (meta: {
+        url: string;
+        title: string;
+    }) => void;
+    onDownload?: (d: BrowseDownloadPublic) => void;
+    onAudio?: (chunk: AudioPcmChunk) => void;
+};
+export type BrowserNavResult = {
+    ok: boolean;
+    status: number;
+    finalUrl: string;
+    title: string;
+    latencyMs: number;
+    blocked?: boolean;
+    blockReason?: string;
+    cookieCount: number;
+    warnings: string[];
+    errorCode?: string;
+};
+export declare class BrowserEngine {
+    private readonly getPolicy;
+    private browser;
+    private handles;
+    private launching;
+    constructor(getPolicy?: () => HostBrowsePolicy);
+    private policy;
+    get activeCount(): number;
+    /** Close browser so next ensure re-reads chrome path / sandbox flags. */
+    invalidateBrowser(): Promise<void>;
+    ensureBrowser(): Promise<Browser>;
+    openSession(input: {
+        sessionId: string;
+        userId: string;
+        mode: HostBrowseMode;
+        /** Prefer isolated Chrome process as this Linux user */
+        ephemeral?: {
+            username: string;
+            homeDir: string;
+        };
+        host?: HostExecutor;
+        /** Panel data dir for isolated downloads */
+        dataDir?: string;
+    }): Promise<void>;
+    private wirePage;
+    private injectAudioBootstrap;
+    /**
+     * Poll page for PCM chunks from HTML media captureStream.
+     * Requires audioBridge policy (Chrome not muted).
+     */
+    startAudioBridge(sessionId: string, onAudio: (chunk: AudioPcmChunk) => void): Promise<AudioBridgeStatus>;
+    stopAudioBridge(sessionId: string): Promise<void>;
+    private pollAudioQueue;
+    private handleDownload;
+    listDownloads(sessionId: string): BrowseDownloadPublic[];
+    getDownload(sessionId: string, downloadId: string): BrowseDownload | null;
+    /** Open a new tab (Playwright page) in this session. Max 6. */
+    openTab(sessionId: string, url?: string): Promise<{
+        pageId: string;
+    }>;
+    switchTab(sessionId: string, pageId: string): Promise<void>;
+    closeTab(sessionId: string, pageId: string): Promise<{
+        activePageId: string | null;
+    }>;
+    listTabs(sessionId: string): Array<{
+        pageId: string;
+        url: string;
+        title: string;
+        active: boolean;
+    }>;
+    /** Async list with document titles (for API / UI). */
+    listTabsDetailed(sessionId: string): Promise<Array<{
+        pageId: string;
+        url: string;
+        title: string;
+        active: boolean;
+    }>>;
+    getHandle(sessionId: string): BrowserSessionHandle | null;
+    navigate(sessionId: string, rawUrl: string): Promise<BrowserNavResult>;
+    goBack(sessionId: string): Promise<BrowserNavResult>;
+    goForward(sessionId: string): Promise<BrowserNavResult>;
+    reload(sessionId: string): Promise<BrowserNavResult>;
+    private snapshotNav;
+    cookieCount(sessionId: string): Promise<number>;
+    clearCookies(sessionId: string): Promise<void>;
+    /**
+     * Start or restart screencast. Always tears down previous CDP session first
+     * so re-navigate / quality change never sticks on screencastOn=true.
+     */
+    startScreencast(sessionId: string, onFrame: BrowserSessionHandle['onFrame'], streamPartial?: Partial<StreamOptions> & {
+        preset?: StreamPresetId;
+    }): Promise<StreamOptions>;
+    stopScreencast(sessionId: string, clearHandler?: boolean): Promise<void>;
+    setStreamOptions(sessionId: string, partial: Partial<StreamOptions> & {
+        preset?: StreamPresetId;
+    }): Promise<StreamOptions>;
+    getStreamOptions(sessionId: string): StreamOptions | null;
+    mouse(sessionId: string, ev: {
+        type: 'move' | 'down' | 'up' | 'click' | 'wheel';
+        x: number;
+        y: number;
+        button?: 'left' | 'right' | 'middle';
+        deltaX?: number;
+        deltaY?: number;
+    }): Promise<void>;
+    keyboard(sessionId: string, ev: {
+        type: 'down' | 'up' | 'press' | 'type';
+        key?: string;
+        text?: string;
+    }): Promise<void>;
+    resize(sessionId: string, width: number, height: number, opts?: {
+        restartCast?: boolean;
+    }): Promise<{
+        w: number;
+        h: number;
+        stream: StreamOptions;
+    }>;
+    closeSession(sessionId: string): Promise<void>;
+    dispose(): Promise<void>;
+    private require;
+}
+export {};
+//# sourceMappingURL=browser-engine.d.ts.map

package/dist/host-browse/browser-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-engine.d.ts","sourceRoot":"","sources":["../../src/host-browse/browser-engine.ts"],"names":[],"mappings":"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"}