@elizaos/agent 2.0.0-alpha.173 → 2.0.0-alpha.192

package/packages/agent/src/services/browser-workspace-network.js

@@ -0,0 +1,137 @@
+import { browserWorkspacePageFetch, DEFAULT_TIMEOUT_MS, } from "./browser-workspace-helpers.js";
+import { getBrowserWorkspaceTimestamp } from "./browser-workspace-state.js";
+export function browserWorkspacePatternMatches(pattern, value) {
+    const trimmed = pattern.trim();
+    if (!trimmed) {
+        return false;
+    }
+    if (!trimmed.includes("*")) {
+        return value.includes(trimmed);
+    }
+    let wildcardPattern = "";
+    for (let index = 0; index < trimmed.length; index += 1) {
+        const char = trimmed[index] ?? "";
+        if (char === "*") {
+            const next = trimmed[index + 1];
+            if (next === "*") {
+                wildcardPattern += ".*";
+                index += 1;
+            }
+            else {
+                wildcardPattern += ".*";
+            }
+            continue;
+        }
+        wildcardPattern += char.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
+    }
+    return new RegExp(`^${wildcardPattern}$`, "i").test(value);
+}
+export function normalizeBrowserWorkspaceHeaders(headers) {
+    if (!headers) {
+        return {};
+    }
+    return Object.fromEntries(Object.entries(headers).filter((entry) => typeof entry[0] === "string" &&
+        entry[0].trim().length > 0 &&
+        typeof entry[1] === "string"));
+}
+export function findBrowserWorkspaceNetworkRoute(state, url) {
+    return ([...state.networkRoutes]
+        .reverse()
+        .find((route) => browserWorkspacePatternMatches(route.pattern, url)) ??
+        null);
+}
+export function recordBrowserWorkspaceNetworkRequest(state, request) {
+    const entry = {
+        ...request,
+        id: `req_${state.networkNextRequestId++}`,
+        timestamp: getBrowserWorkspaceTimestamp(),
+    };
+    state.networkRequests.push(entry);
+    if (state.networkHar.active) {
+        state.networkHar.entries.push(entry);
+    }
+    return entry;
+}
+export async function fetchBrowserWorkspaceTrackedResponse(state, url, init = {}, resourceType) {
+    if (state.settings.offline) {
+        recordBrowserWorkspaceNetworkRequest(state, {
+            matchedRoute: null,
+            method: String(init.method ?? "GET").toUpperCase(),
+            resourceType,
+            responseBody: null,
+            responseHeaders: {},
+            status: 0,
+            url,
+        });
+        throw new Error("Browser workspace is offline.");
+    }
+    const route = findBrowserWorkspaceNetworkRoute(state, url);
+    if (route?.abort) {
+        recordBrowserWorkspaceNetworkRequest(state, {
+            matchedRoute: route.pattern,
+            method: String(init.method ?? "GET").toUpperCase(),
+            resourceType,
+            responseBody: null,
+            responseHeaders: route.headers,
+            status: 0,
+            url,
+        });
+        throw new Error(`Browser workspace network route aborted request: ${url}`);
+    }
+    if (route &&
+        (route.body !== null ||
+            route.status !== null ||
+            Object.keys(route.headers).length > 0)) {
+        const response = new Response(route?.body ?? "", {
+            headers: route?.headers,
+            status: route?.status ?? 200,
+        });
+        recordBrowserWorkspaceNetworkRequest(state, {
+            matchedRoute: route?.pattern ?? null,
+            method: String(init.method ?? "GET").toUpperCase(),
+            resourceType,
+            responseBody: route?.body ?? "",
+            responseHeaders: route?.headers ?? {},
+            status: route?.status ?? 200,
+            url,
+        });
+        return response;
+    }
+    const headers = new Headers(init.headers ?? {});
+    for (const [key, value] of Object.entries(state.settings.headers)) {
+        if (!headers.has(key)) {
+            headers.set(key, value);
+        }
+    }
+    if (state.settings.credentials &&
+        !headers.has("Authorization") &&
+        state.settings.credentials.username) {
+        headers.set("Authorization", `Basic ${Buffer.from(`${state.settings.credentials.username}:${state.settings.credentials.password}`).toString("base64")}`);
+    }
+    const response = await browserWorkspacePageFetch(url, {
+        ...init,
+        headers,
+        redirect: init.redirect ?? "follow",
+        signal: init.signal ?? AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+    });
+    let responseBody = null;
+    if (resourceType !== "document") {
+        const clone = response.clone();
+        try {
+            responseBody = await clone.text();
+        }
+        catch {
+            responseBody = null;
+        }
+    }
+    recordBrowserWorkspaceNetworkRequest(state, {
+        matchedRoute: null,
+        method: String(init.method ?? "GET").toUpperCase(),
+        resourceType,
+        responseBody,
+        responseHeaders: Object.fromEntries(response.headers.entries()),
+        status: response.status,
+        url: response.url || url,
+    });
+    return response;
+}

package/packages/agent/src/services/browser-workspace-snapshots.d.ts

@@ -0,0 +1,14 @@
+import type { BrowserWorkspaceSnapshotRecord } from "./browser-workspace-types.js";
+export declare function escapeBrowserWorkspacePdfText(value: string): string;
+export declare function createBrowserWorkspacePdfBuffer(title: string, bodyText: string): Buffer;
+export declare function createBrowserWorkspaceSyntheticScreenshotData(title: string, url: string, bodyText: string, viewport?: {
+    height: number;
+    width: number;
+}): string;
+export declare function createBrowserWorkspaceSnapshotRecord(title: string, url: string, bodyText: string): BrowserWorkspaceSnapshotRecord;
+export declare function buildBrowserWorkspaceDocumentSnapshotText(document: Document): string;
+export declare function diffBrowserWorkspaceSnapshots(before: BrowserWorkspaceSnapshotRecord | null, after: BrowserWorkspaceSnapshotRecord): Record<string, unknown>;
+export declare function readBrowserWorkspaceStorage(storage: Storage): Record<string, string>;
+export declare function readBrowserWorkspaceCookies(document: Document): Record<string, string>;
+export declare function applyBrowserWorkspaceStateToWebDocument(document: Document, snapshot: Record<string, unknown>): void;
+//# sourceMappingURL=browser-workspace-snapshots.d.ts.map

package/packages/agent/src/services/browser-workspace-snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-workspace-snapshots.d.ts","sourceRoot":"","sources":["../../../../../src/services/browser-workspace-snapshots.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAEnF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,CAmCR;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3C,MAAM,CAqBR;AAED,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,8BAA8B,CAMhC;AAED,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAqBR;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,8BAA8B,GAAG,IAAI,EAC7C,KAAK,EAAE,8BAA8B,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxB;AAED,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAyBN"}

package/packages/agent/src/services/browser-workspace-snapshots.js

@@ -0,0 +1,144 @@
+import { normalizeBrowserWorkspaceText } from "./browser-workspace-helpers.js";
+export function escapeBrowserWorkspacePdfText(value) {
+    return value
+        .replaceAll("\\", "\\\\")
+        .replaceAll("(", "\\(")
+        .replaceAll(")", "\\)");
+}
+export function createBrowserWorkspacePdfBuffer(title, bodyText) {
+    const lines = [
+        title.trim() || "Eliza Browser Workspace",
+        "",
+        ...bodyText
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .slice(0, 32),
+    ];
+    const contentLines = lines.map((line, index) => {
+        const offset = index === 0 ? "50 750 Td" : "0 -18 Td";
+        return `${offset} (${escapeBrowserWorkspacePdfText(line)}) Tj`;
+    });
+    const stream = `BT\n/F1 12 Tf\n${contentLines.join("\n")}\nET`;
+    const objects = [
+        "<< /Type /Catalog /Pages 2 0 R >>",
+        "<< /Type /Pages /Kids [3 0 R] /Count 1 >>",
+        "<< /Type /Page /Parent 2 0 R /MediaBox [0 0 612 792] /Contents 4 0 R /Resources << /Font << /F1 5 0 R >> >> >>",
+        `<< /Length ${Buffer.byteLength(stream, "utf8")} >>\nstream\n${stream}\nendstream`,
+        "<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>",
+    ];
+    let pdf = "%PDF-1.4\n";
+    const offsets = [0];
+    for (let index = 0; index < objects.length; index += 1) {
+        offsets.push(Buffer.byteLength(pdf, "utf8"));
+        pdf += `${index + 1} 0 obj\n${objects[index]}\nendobj\n`;
+    }
+    const xrefOffset = Buffer.byteLength(pdf, "utf8");
+    pdf += `xref\n0 ${objects.length + 1}\n0000000000 65535 f \n`;
+    for (let index = 1; index < offsets.length; index += 1) {
+        pdf += `${String(offsets[index]).padStart(10, "0")} 00000 n \n`;
+    }
+    pdf += `trailer\n<< /Size ${objects.length + 1} /Root 1 0 R >>\nstartxref\n${xrefOffset}\n%%EOF`;
+    return Buffer.from(pdf, "utf8");
+}
+export function createBrowserWorkspaceSyntheticScreenshotData(title, url, bodyText, viewport) {
+    const width = viewport?.width ?? 1280;
+    const height = viewport?.height ?? 720;
+    const lines = [
+        title || "Eliza Browser Workspace",
+        url,
+        "",
+        ...bodyText
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .slice(0, 18),
+    ];
+    const escapedLines = lines.map((line) => line
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;"));
+    const svg = `<?xml version="1.0" encoding="UTF-8"?><svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}"><rect width="100%" height="100%" fill="#faf7f1"/><rect x="24" y="24" width="${width - 48}" height="${height - 48}" rx="18" fill="#ffffff" stroke="#d8d1c4"/><text x="48" y="72" font-family="Menlo, Monaco, monospace" font-size="20" fill="#111111">${escapedLines.map((line, index) => `<tspan x="48" dy="${index === 0 ? 0 : 28}">${line}</tspan>`).join("")}</text></svg>`;
+    return Buffer.from(svg, "utf8").toString("base64");
+}
+export function createBrowserWorkspaceSnapshotRecord(title, url, bodyText) {
+    return {
+        bodyText: normalizeBrowserWorkspaceText(bodyText),
+        title: normalizeBrowserWorkspaceText(title),
+        url: normalizeBrowserWorkspaceText(url),
+    };
+}
+export function buildBrowserWorkspaceDocumentSnapshotText(document) {
+    const bodyText = normalizeBrowserWorkspaceText(document.body?.textContent);
+    const controlText = Array.from(document.querySelectorAll("input, textarea, select, option:checked"))
+        .map((element) => {
+        const name = element.getAttribute("name") ||
+            element.getAttribute("id") ||
+            element.tagName.toLowerCase();
+        const value = element.tagName === "SELECT"
+            ? element.value
+            : "value" in element
+                ? element.value
+                : (element.textContent ?? "");
+        return `${name}:${normalizeBrowserWorkspaceText(value)}`;
+    })
+        .filter(Boolean)
+        .join(" ");
+    return normalizeBrowserWorkspaceText(`${bodyText} ${controlText}`);
+}
+export function diffBrowserWorkspaceSnapshots(before, after) {
+    return {
+        changed: !before ||
+            before.bodyText !== after.bodyText ||
+            before.title !== after.title ||
+            before.url !== after.url,
+        previous: before,
+        current: after,
+    };
+}
+export function readBrowserWorkspaceStorage(storage) {
+    const entries = {};
+    for (let index = 0; index < storage.length; index += 1) {
+        const key = storage.key(index);
+        if (!key) {
+            continue;
+        }
+        entries[key] = storage.getItem(key) ?? "";
+    }
+    return entries;
+}
+export function readBrowserWorkspaceCookies(document) {
+    const cookieString = document.cookie || "";
+    if (!cookieString.trim()) {
+        return {};
+    }
+    return Object.fromEntries(cookieString
+        .split(/;\s*/)
+        .map((entry) => {
+        const [name, ...rest] = entry.split("=");
+        return [name ?? "", rest.join("=")];
+    })
+        .filter((entry) => entry[0].trim().length > 0));
+}
+export function applyBrowserWorkspaceStateToWebDocument(document, snapshot) {
+    const localEntries = snapshot.localStorage && typeof snapshot.localStorage === "object"
+        ? snapshot.localStorage
+        : {};
+    const sessionEntries = snapshot.sessionStorage && typeof snapshot.sessionStorage === "object"
+        ? snapshot.sessionStorage
+        : {};
+    const cookies = snapshot.cookies && typeof snapshot.cookies === "object"
+        ? snapshot.cookies
+        : {};
+    document.defaultView?.localStorage.clear();
+    for (const [key, value] of Object.entries(localEntries)) {
+        document.defaultView?.localStorage.setItem(key, String(value ?? ""));
+    }
+    document.defaultView?.sessionStorage.clear();
+    for (const [key, value] of Object.entries(sessionEntries)) {
+        document.defaultView?.sessionStorage.setItem(key, String(value ?? ""));
+    }
+    for (const [key, value] of Object.entries(cookies)) {
+        document.cookie = `${key}=${String(value ?? "")}; path=/`;
+    }
+}

package/packages/agent/src/services/browser-workspace-state.d.ts

@@ -0,0 +1,22 @@
+import type { BrowserWorkspaceDomElementSummary, BrowserWorkspaceMode, BrowserWorkspaceRuntimeState, WebBrowserWorkspaceTabState } from "./browser-workspace-types.js";
+export declare const webWorkspaceState: {
+    nextId: number;
+    tabs: WebBrowserWorkspaceTabState[];
+};
+export declare const browserWorkspaceElementRefs: Map<string, Map<string, string>>;
+export declare const browserWorkspaceRuntimeState: Map<string, BrowserWorkspaceRuntimeState>;
+export declare let browserWorkspaceClipboardText: string;
+export declare function setBrowserWorkspaceClipboardText(value: string): void;
+export declare function withWebStateLock<T>(fn: () => T | Promise<T>): Promise<T>;
+export declare function resetWebStateLock(): void;
+export declare function createBrowserWorkspaceRuntimeState(): BrowserWorkspaceRuntimeState;
+export declare function getBrowserWorkspaceRuntimeState(mode: BrowserWorkspaceMode, tabId: string): BrowserWorkspaceRuntimeState;
+export declare function clearBrowserWorkspaceRuntimeState(mode: BrowserWorkspaceMode, tabId: string): void;
+export declare function resetBrowserWorkspaceRuntimeNavigationState(state: BrowserWorkspaceRuntimeState): void;
+export declare function clearBrowserWorkspaceElementRefs(mode: BrowserWorkspaceMode, tabId: string): void;
+export declare function registerBrowserWorkspaceElementRefs(mode: BrowserWorkspaceMode, tabId: string, elements: BrowserWorkspaceDomElementSummary[]): BrowserWorkspaceDomElementSummary[];
+export declare function resolveBrowserWorkspaceElementRef(mode: BrowserWorkspaceMode, tabId: string, ref: string): string | null;
+export declare function appendBrowserWorkspaceTraceEntry(state: BrowserWorkspaceRuntimeState, entry: Record<string, unknown>): void;
+export declare function appendBrowserWorkspaceProfilerEntry(state: BrowserWorkspaceRuntimeState, entry: Record<string, unknown>): void;
+export declare function getBrowserWorkspaceTimestamp(): string;
+//# sourceMappingURL=browser-workspace-state.d.ts.map

package/packages/agent/src/services/browser-workspace-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-workspace-state.d.ts","sourceRoot":"","sources":["../../../../../src/services/browser-workspace-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iCAAiC,EACjC,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,8BAA8B,CAAC;AAEtC,eAAO,MAAM,iBAAiB,EAAE;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,2BAA2B,EAAE,CAAC;CAIrC,CAAC;AAEF,eAAO,MAAM,2BAA2B,kCAGrC,CAAC;AACJ,eAAO,MAAM,4BAA4B,2CAGtC,CAAC;AACJ,eAAO,IAAI,6BAA6B,QAAK,CAAC;AAE9C,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEpE;AAOD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOxE;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,kCAAkC,IAAI,4BAA4B,CA2BjF;AASD,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,GACZ,4BAA4B,CAQ9B;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,GACZ,IAAI,CAIN;AAED,wBAAgB,2CAA2C,CACzD,KAAK,EAAE,4BAA4B,GAClC,IAAI,CAKN;AASD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,GACZ,IAAI,CAIN;AAED,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,iCAAiC,EAAE,GAC5C,iCAAiC,EAAE,CAiBrC;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,4BAA4B,EACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAQN;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,4BAA4B,EACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAQN;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}

package/packages/agent/src/services/browser-workspace-state.js

@@ -0,0 +1,129 @@
+export const webWorkspaceState = {
+    nextId: 1,
+    tabs: [],
+};
+export const browserWorkspaceElementRefs = new Map();
+export const browserWorkspaceRuntimeState = new Map();
+export let browserWorkspaceClipboardText = "";
+export function setBrowserWorkspaceClipboardText(value) {
+    browserWorkspaceClipboardText = value;
+}
+/**
+ * Simple async mutex to serialise mutations to webWorkspaceState.
+ * Prevents concurrent requests from corrupting tab state or history.
+ */
+let webStateLock = Promise.resolve();
+export function withWebStateLock(fn) {
+    const next = webStateLock.then(fn, fn);
+    webStateLock = next.then(() => { }, () => { });
+    return next;
+}
+export function resetWebStateLock() {
+    webStateLock = Promise.resolve();
+}
+export function createBrowserWorkspaceRuntimeState() {
+    return {
+        consoleEntries: [],
+        currentFrame: null,
+        dialog: null,
+        errors: [],
+        frameDoms: new Map(),
+        highlightedSelector: null,
+        lastScreenshotData: null,
+        lastSnapshot: null,
+        mouse: { buttons: [], x: 0, y: 0 },
+        networkHar: { active: false, entries: [], startedAt: null },
+        networkNextRequestId: 1,
+        networkRequests: [],
+        networkRoutes: [],
+        settings: {
+            credentials: null,
+            device: null,
+            geo: null,
+            headers: {},
+            media: null,
+            offline: false,
+            viewport: null,
+        },
+        trace: { active: false, entries: [] },
+        profiler: { active: false, entries: [] },
+    };
+}
+function getBrowserWorkspaceRuntimeStateKey(mode, tabId) {
+    return `${mode}:${tabId}`;
+}
+export function getBrowserWorkspaceRuntimeState(mode, tabId) {
+    const key = getBrowserWorkspaceRuntimeStateKey(mode, tabId);
+    let state = browserWorkspaceRuntimeState.get(key);
+    if (!state) {
+        state = createBrowserWorkspaceRuntimeState();
+        browserWorkspaceRuntimeState.set(key, state);
+    }
+    return state;
+}
+export function clearBrowserWorkspaceRuntimeState(mode, tabId) {
+    browserWorkspaceRuntimeState.delete(getBrowserWorkspaceRuntimeStateKey(mode, tabId));
+}
+export function resetBrowserWorkspaceRuntimeNavigationState(state) {
+    state.currentFrame = null;
+    state.dialog = null;
+    state.frameDoms.clear();
+    state.highlightedSelector = null;
+}
+function getBrowserWorkspaceElementRefStateKey(mode, tabId) {
+    return `${mode}:${tabId}`;
+}
+export function clearBrowserWorkspaceElementRefs(mode, tabId) {
+    browserWorkspaceElementRefs.delete(getBrowserWorkspaceElementRefStateKey(mode, tabId));
+}
+export function registerBrowserWorkspaceElementRefs(mode, tabId, elements) {
+    if (elements.length === 0) {
+        clearBrowserWorkspaceElementRefs(mode, tabId);
+        return [];
+    }
+    const refs = new Map();
+    const augmented = elements.map((element, index) => {
+        const ref = `@e${index + 1}`;
+        refs.set(ref, element.selector);
+        return { ...element, ref };
+    });
+    browserWorkspaceElementRefs.set(getBrowserWorkspaceElementRefStateKey(mode, tabId), refs);
+    return augmented;
+}
+export function resolveBrowserWorkspaceElementRef(mode, tabId, ref) {
+    return (browserWorkspaceElementRefs
+        .get(getBrowserWorkspaceElementRefStateKey(mode, tabId))
+        ?.get(ref.trim()) ?? null);
+}
+export function appendBrowserWorkspaceTraceEntry(state, entry) {
+    if (!state.trace.active) {
+        return;
+    }
+    state.trace.entries.push({
+        ...entry,
+        timestamp: getBrowserWorkspaceTimestamp(),
+    });
+}
+export function appendBrowserWorkspaceProfilerEntry(state, entry) {
+    if (!state.profiler.active) {
+        return;
+    }
+    state.profiler.entries.push({
+        ...entry,
+        timestamp: getBrowserWorkspaceTimestamp(),
+    });
+}
+export function getBrowserWorkspaceTimestamp() {
+    return new Date().toISOString();
+}
+/** @internal - test-only reset */
+export async function __resetBrowserWorkspaceStateForTests() {
+    await withWebStateLock(async () => {
+        webWorkspaceState.nextId = 1;
+        webWorkspaceState.tabs = [];
+        browserWorkspaceElementRefs.clear();
+        browserWorkspaceRuntimeState.clear();
+        browserWorkspaceClipboardText = "";
+    });
+    resetWebStateLock();
+}