@rome-os/app-runtime 0.0.1

package/dist/browser.d.ts

@@ -0,0 +1,57 @@
+export interface DiscoveredBrowserEndpoint {
+    name: string;
+    browserUrl: string;
+}
+export interface BrowserCapabilityDiscovery {
+    getBrowserEndpoints(): DiscoveredBrowserEndpoint[];
+}
+interface PageReadyProbe {
+    readyState?: string;
+    href?: string;
+}
+export interface OpenedPageSession {
+    endpoint: DiscoveredBrowserEndpoint;
+    session: CdpSession;
+    close(): Promise<void>;
+}
+export interface BuildBrowserScriptExpressionOptions {
+    scriptSource: string;
+    entrypointExpression: string;
+    args?: unknown[];
+    autorunFlag?: string;
+    missingEntrypointMessage?: string;
+}
+export interface RunDiscoveredBrowserScriptOptions {
+    pageUrl: string;
+    scriptUrl: URL;
+    entrypointExpression: string;
+    args?: unknown[];
+    autorunFlag?: string;
+    missingEntrypointMessage?: string;
+}
+export interface RunDiscoveredBrowserScriptResult<TResult> {
+    endpoint: DiscoveredBrowserEndpoint;
+    result: TResult;
+    close(): Promise<void>;
+}
+export declare function pickBrowserEndpoint(endpoints: DiscoveredBrowserEndpoint[]): DiscoveredBrowserEndpoint | null;
+export declare function openDiscoveredPageSession(capabilityDiscovery: BrowserCapabilityDiscovery, pageUrl: string): Promise<OpenedPageSession>;
+export declare function isPageReadyForAutomation(probe: PageReadyProbe): boolean;
+export declare class CdpSession {
+    private readonly socket;
+    private nextId;
+    private pending;
+    private closed;
+    private constructor();
+    static connect(webSocketUrl: string): Promise<CdpSession>;
+    send<TResult = unknown>(method: string, params?: Record<string, unknown>): Promise<TResult>;
+    evaluateByValue<TValue>(expression: string): Promise<TValue>;
+    close(): Promise<void>;
+    private handleMessage;
+    private rejectPending;
+}
+export declare function loadCachedScriptSource(scriptUrl: URL): Promise<string>;
+export declare function buildBrowserScriptExpression(options: BuildBrowserScriptExpressionOptions): string;
+export declare function runDiscoveredBrowserScript<TResult>(capabilityDiscovery: BrowserCapabilityDiscovery, options: RunDiscoveredBrowserScriptOptions): Promise<RunDiscoveredBrowserScriptResult<TResult>>;
+export {};
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,mBAAmB,IAAI,yBAAyB,EAAE,CAAC;CACpD;AAiCD,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,mCAAmC;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,GAAG,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,gCAAgC,CAAC,OAAO;IACvD,QAAQ,EAAE,yBAAyB,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA+CD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,yBAAyB,EAAE,GACrC,yBAAyB,GAAG,IAAI,CAWlC;AAED,wBAAsB,yBAAyB,CAC7C,mBAAmB,EAAE,0BAA0B,EAC/C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAyB5B;AAqCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAOvE;AAED,qBAAa,UAAU;IAWD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAV3C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAMX;IACJ,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;WAeM,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAYzD,IAAI,CAAC,OAAO,GAAG,OAAO,EAC1B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC;IAgCb,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,aAAa;CAMtB;AAED,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAc5E;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,MAAM,CAmCR;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EACtD,mBAAmB,EAAE,0BAA0B,EAC/C,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,gCAAgC,CAAC,OAAO,CAAC,CAAC,CAuBpD"}

package/dist/browser.js

@@ -0,0 +1,326 @@
+import { readFile } from "node:fs/promises";
+import WebSocket from "ws";
+const HTTP_TIMEOUT_MS = 10_000;
+const PAGE_READY_TIMEOUT_MS = 20_000;
+const PAGE_READY_POLL_MS = 500;
+const PAGE_READY_STABLE_POLLS = 2;
+const scriptSourceCache = new Map();
+function delay(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+function normalizeBrowserUrl(browserUrl) {
+    return browserUrl.endsWith("/") ? browserUrl.slice(0, -1) : browserUrl;
+}
+async function openPage(browserUrl, pageUrl) {
+    const normalizedBrowserUrl = normalizeBrowserUrl(browserUrl);
+    const endpoint = `${normalizedBrowserUrl}/json/new?${encodeURIComponent(pageUrl)}`;
+    let response = await fetch(endpoint, {
+        method: "PUT",
+        signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+    });
+    if (response.status === 405) {
+        response = await fetch(endpoint, {
+            method: "GET",
+            signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+        });
+    }
+    if (!response.ok) {
+        throw new Error(`Failed to open a CDP page at ${normalizedBrowserUrl}: ${response.status}`);
+    }
+    return (await response.json());
+}
+async function closePage(browserUrl, targetId) {
+    const normalizedBrowserUrl = normalizeBrowserUrl(browserUrl);
+    try {
+        await fetch(`${normalizedBrowserUrl}/json/close/${encodeURIComponent(targetId)}`, {
+            method: "GET",
+            signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+        });
+    }
+    catch {
+        // Best effort cleanup.
+    }
+}
+export function pickBrowserEndpoint(endpoints) {
+    if (endpoints.length === 0) {
+        return null;
+    }
+    const sorted = [...endpoints].sort((left, right) => left.name.localeCompare(right.name));
+    return (sorted.find((endpoint) => endpoint.name === "cdp-local-chromium") ??
+        sorted.find((endpoint) => endpoint.name.includes("local")) ??
+        sorted[0]);
+}
+export async function openDiscoveredPageSession(capabilityDiscovery, pageUrl) {
+    const endpoint = pickBrowserEndpoint(capabilityDiscovery.getBrowserEndpoints());
+    if (!endpoint) {
+        throw new Error("No discovered browser endpoints are available");
+    }
+    const page = await openPage(endpoint.browserUrl, pageUrl);
+    if (!page.id || !page.webSocketDebuggerUrl) {
+        throw new Error(`CDP did not return a debuggable page target for ${pageUrl}`);
+    }
+    const session = await CdpSession.connect(page.webSocketDebuggerUrl);
+    await session.send("Page.enable");
+    await session.send("Runtime.enable");
+    await session.send("Page.bringToFront");
+    await waitForPageReady(session);
+    return {
+        endpoint,
+        session,
+        close: async () => {
+            await session.close();
+            await closePage(endpoint.browserUrl, page.id);
+        },
+    };
+}
+async function waitForPageReady(session) {
+    const deadline = Date.now() + PAGE_READY_TIMEOUT_MS;
+    let stableReadyPolls = 0;
+    let lastReadyHref = null;
+    while (Date.now() < deadline) {
+        try {
+            const probe = await session.evaluateByValue("({ readyState: document.readyState, href: location.href })");
+            const href = probe.href?.trim() ?? "";
+            if (isPageReadyForAutomation(probe)) {
+                stableReadyPolls = href === lastReadyHref ? stableReadyPolls + 1 : 1;
+                lastReadyHref = href;
+                if (stableReadyPolls >= PAGE_READY_STABLE_POLLS) {
+                    return;
+                }
+            }
+            else {
+                stableReadyPolls = 0;
+                lastReadyHref = href || null;
+            }
+        }
+        catch {
+            stableReadyPolls = 0;
+            lastReadyHref = null;
+        }
+        await delay(PAGE_READY_POLL_MS);
+    }
+    throw new Error(`Timed out waiting for the page to finish loading after ${PAGE_READY_TIMEOUT_MS}ms`);
+}
+export function isPageReadyForAutomation(probe) {
+    const href = probe.href?.trim();
+    if (!href || href === "about:blank") {
+        return false;
+    }
+    return probe.readyState === "interactive" || probe.readyState === "complete";
+}
+export class CdpSession {
+    socket;
+    nextId = 1;
+    pending = new Map();
+    closed = false;
+    constructor(socket) {
+        this.socket = socket;
+        this.socket.on("message", (data) => {
+            this.handleMessage(data.toString());
+        });
+        this.socket.on("close", () => {
+            this.closed = true;
+            this.rejectPending(new Error("CDP connection closed"));
+        });
+        this.socket.on("error", (error) => {
+            this.rejectPending(error instanceof Error ? error : new Error(`CDP socket error: ${String(error)}`));
+        });
+    }
+    static async connect(webSocketUrl) {
+        const socket = await new Promise((resolve, reject) => {
+            const ws = new WebSocket(webSocketUrl);
+            ws.once("open", () => resolve(ws));
+            ws.once("error", (error) => {
+                reject(error instanceof Error ? error : new Error(`CDP socket error: ${String(error)}`));
+            });
+        });
+        return new CdpSession(socket);
+    }
+    async send(method, params) {
+        if (this.closed) {
+            throw new Error("CDP connection is already closed");
+        }
+        const id = this.nextId++;
+        const payload = JSON.stringify({ id, method, params });
+        const responsePromise = new Promise((resolve, reject) => {
+            this.pending.set(id, {
+                resolve: (value) => resolve(value),
+                reject,
+            });
+        });
+        this.socket.send(payload, (error) => {
+            if (!error) {
+                return;
+            }
+            const pending = this.pending.get(id);
+            if (!pending) {
+                return;
+            }
+            this.pending.delete(id);
+            pending.reject(error instanceof Error ? error : new Error(String(error)));
+        });
+        return await responsePromise;
+    }
+    async evaluateByValue(expression) {
+        const response = await this.send("Runtime.evaluate", {
+            expression,
+            awaitPromise: true,
+            returnByValue: true,
+        });
+        if (response.exceptionDetails) {
+            const description = response.exceptionDetails.exception?.description ??
+                response.exceptionDetails.exception?.value ??
+                response.exceptionDetails.text ??
+                "Unknown CDP runtime evaluation error";
+            throw new Error(String(description));
+        }
+        return response.result.value;
+    }
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        await new Promise((resolve) => {
+            this.socket.once("close", () => resolve());
+            this.socket.close();
+        });
+    }
+    handleMessage(message) {
+        let parsed;
+        try {
+            parsed = JSON.parse(message);
+        }
+        catch {
+            return;
+        }
+        if (typeof parsed.id !== "number") {
+            return;
+        }
+        const pending = this.pending.get(parsed.id);
+        if (!pending) {
+            return;
+        }
+        this.pending.delete(parsed.id);
+        if (parsed.error?.message) {
+            pending.reject(new Error(parsed.error.message));
+            return;
+        }
+        pending.resolve(parsed.result);
+    }
+    rejectPending(error) {
+        for (const [id, pending] of this.pending.entries()) {
+            this.pending.delete(id);
+            pending.reject(error);
+        }
+    }
+}
+export async function loadCachedScriptSource(scriptUrl) {
+    const cacheKey = scriptUrl.href;
+    let sourcePromise = scriptSourceCache.get(cacheKey);
+    if (!sourcePromise) {
+        sourcePromise = readFile(scriptUrl, "utf-8");
+        scriptSourceCache.set(cacheKey, sourcePromise);
+    }
+    try {
+        return await sourcePromise;
+    }
+    catch (error) {
+        scriptSourceCache.delete(cacheKey);
+        throw error;
+    }
+}
+export function buildBrowserScriptExpression(options) {
+    const { scriptSource, entrypointExpression, args = [], autorunFlag, missingEntrypointMessage = `${entrypointExpression} is not defined after loading the browser script`, } = options;
+    const serializedArgs = args.map((arg) => serializeJavascriptLiteral(arg)).join(", ");
+    const serializedAutorunFlag = autorunFlag ? JSON.stringify(autorunFlag) : null;
+    return `
+(async () => {
+  ${serializedAutorunFlag ? `globalThis[${serializedAutorunFlag}] = false;` : ""}
+  try {
+${scriptSource}
+    const __romeBrowserScriptEntrypoint = ${entrypointExpression};
+    if (typeof __romeBrowserScriptEntrypoint !== "function") {
+      throw new Error(${JSON.stringify(missingEntrypointMessage)});
+    }
+
+    return await __romeBrowserScriptEntrypoint(${serializedArgs});
+  } finally {
+    ${serializedAutorunFlag
+        ? `try {
+      delete globalThis[${serializedAutorunFlag}];
+    } catch {
+      globalThis[${serializedAutorunFlag}] = undefined;
+    }`
+        : ""}
+  }
+})()
+`.trim();
+}
+export async function runDiscoveredBrowserScript(capabilityDiscovery, options) {
+    const scriptSource = await loadCachedScriptSource(options.scriptUrl);
+    const expression = buildBrowserScriptExpression({
+        scriptSource,
+        entrypointExpression: options.entrypointExpression,
+        args: options.args,
+        autorunFlag: options.autorunFlag,
+        missingEntrypointMessage: options.missingEntrypointMessage,
+    });
+    const page = await openDiscoveredPageSession(capabilityDiscovery, options.pageUrl);
+    try {
+        const result = await page.session.evaluateByValue(expression);
+        return {
+            endpoint: page.endpoint,
+            result,
+            close: page.close,
+        };
+    }
+    catch (error) {
+        await page.close();
+        throw error;
+    }
+}
+function serializeJavascriptLiteral(value) {
+    if (value === undefined) {
+        return "undefined";
+    }
+    if (value === null) {
+        return "null";
+    }
+    if (typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error("Browser script arguments must be finite numbers");
+        }
+        return String(value);
+    }
+    if (typeof value === "boolean") {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => serializeJavascriptLiteral(entry)).join(", ")}]`;
+    }
+    if (isPlainObject(value)) {
+        const properties = Object.entries(value).map(([key, entryValue]) => {
+            const propertyKey = isValidIdentifier(key) ? key : JSON.stringify(key);
+            return `${propertyKey}: ${serializeJavascriptLiteral(entryValue)}`;
+        });
+        return `{ ${properties.join(", ")} }`;
+    }
+    throw new Error(`Unsupported browser script argument type: ${typeof value}`);
+}
+function isPlainObject(value) {
+    if (Object.prototype.toString.call(value) !== "[object Object]") {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === null || prototype === Object.prototype;
+}
+function isValidIdentifier(value) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(value);
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,qBAAqB,GAAG,MAAM,CAAC;AACrC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAElC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA2B,CAAC;AA4E7D,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,UAAkB;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AACzE,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,UAAkB,EAAE,OAAe;IACzD,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,GAAG,oBAAoB,aAAa,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;IAEnF,IAAI,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;QACnC,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC;KAC7C,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YAC/B,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC;SAC7C,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,oBAAoB,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;AACpD,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,UAAkB,EAAE,QAAgB;IAC3D,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,oBAAoB,eAAe,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EAAE;YAChF,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC;SAC7C,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAAsC;IAEtC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACzF,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,oBAAoB,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,CACV,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,mBAA+C,EAC/C,OAAe;IAEf,MAAM,QAAQ,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,mDAAmD,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACpE,MAAM,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAClC,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACrC,MAAM,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACxC,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEhC,OAAO;QACL,QAAQ;QACR,OAAO;QACP,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,EAAG,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,OAAmB;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,qBAAqB,CAAC;IACpD,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,aAAa,GAAkB,IAAI,CAAC;IAExC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,eAAe,CACzC,4DAA4D,CAC7D,CAAC;YACF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAEtC,IAAI,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,gBAAgB,GAAG,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrE,aAAa,GAAG,IAAI,CAAC;gBACrB,IAAI,gBAAgB,IAAI,uBAAuB,EAAE,CAAC;oBAChD,OAAO;gBACT,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,gBAAgB,GAAG,CAAC,CAAC;gBACrB,aAAa,GAAG,IAAI,IAAI,IAAI,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB,GAAG,CAAC,CAAC;YACrB,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QAED,MAAM,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,0DAA0D,qBAAqB,IAAI,CACpF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAqB;IAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,UAAU,KAAK,aAAa,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC;AAC/E,CAAC;AAED,MAAM,OAAO,UAAU;IAWgB;IAV7B,MAAM,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,IAAI,GAAG,EAMtB,CAAC;IACI,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAqC,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;QACpD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YACjC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,IAAI,CAAC,aAAa,CAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CACjF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,YAAoB;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9D,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,YAAY,CAAC,CAAC;YACvC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YACnC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACzB,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3F,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAAc,EACd,MAAgC;QAEhC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvD,MAAM,eAAe,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC/D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAgB,CAAC;gBAC7C,MAAM;aACP,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAClC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,eAAe,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,eAAe,CAAS,UAAkB;QAC9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAgC,kBAAkB,EAAE;YAClF,UAAU;YACV,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC9B,MAAM,WAAW,GACf,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW;gBAChD,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK;gBAC1C,QAAQ,CAAC,gBAAgB,CAAC,IAAI;gBAC9B,sCAAsC,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAe,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,OAAe;QACnC,IAAI,MAA4B,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAyB,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE/B,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAEO,aAAa,CAAC,KAAY;QAChC,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,SAAc;IACzD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC;IAChC,IAAI,aAAa,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,aAAa,GAAG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,aAAa,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAA4C;IAE5C,MAAM,EACJ,YAAY,EACZ,oBAAoB,EACpB,IAAI,GAAG,EAAE,EACT,WAAW,EACX,wBAAwB,GAAG,GAAG,oBAAoB,kDAAkD,GACrG,GAAG,OAAO,CAAC;IACZ,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrF,MAAM,qBAAqB,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE/E,OAAO;;IAEL,qBAAqB,CAAC,CAAC,CAAC,cAAc,qBAAqB,YAAY,CAAC,CAAC,CAAC,EAAE;;EAE9E,YAAY;4CAC8B,oBAAoB;;wBAExC,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC;;;iDAGf,cAAc;;MAGzD,qBAAqB;QACnB,CAAC,CAAC;0BACgB,qBAAqB;;mBAE5B,qBAAqB;MAClC;QACE,CAAC,CAAC,EACN;;;CAGH,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,mBAA+C,EAC/C,OAA0C;IAE1C,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,4BAA4B,CAAC;QAC9C,YAAY;QACZ,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;KAC3D,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,yBAAyB,CAAC,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAU,UAAU,CAAC,CAAC;QACvE,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM;YACN,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACnF,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE;YACjE,MAAM,WAAW,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACvE,OAAO,GAAG,WAAW,KAAK,0BAA0B,CAAC,UAAU,CAAC,EAAE,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,KAAK,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,CAAC;AAC9D,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,413 @@
+import type { BetterSQLite3Database } from "drizzle-orm/better-sqlite3";
+export * from "./browser.js";
+export { getWorkerRpc, isWorkerRpcResponse, WorkerRpcTimeoutError, WorkerRpcDisconnectError, type RpcResponseMessage, } from "./worker-rpc.js";
+export type SpanAttributes = Record<string, unknown>;
+export interface TelemetryBridge {
+    withRomeSpan<T>(name: string, attrs: SpanAttributes, fn: () => Promise<T>): Promise<T>;
+    startRomeSpan(name: string, attrs?: SpanAttributes): void;
+    currentSessionId(): string | undefined;
+    runWithSession<T>(sessionId: string, fn: () => T): T;
+}
+/**
+ * Core calls this at `initTelemetry()` time to wire the real OTEL-backed
+ * impls into the SDK. Passing `null` unregisters (useful in tests).
+ */
+export declare function setTelemetryBridge(bridge: TelemetryBridge | null): void;
+/**
+ * Run `fn` inside a `name` span with `attrs` attached. If no bridge is
+ * registered (e.g., pure unit test without core's telemetry initialized)
+ * the span is a no-op and `fn` runs verbatim.
+ */
+export declare function withRomeSpan<T>(name: string, attrs: SpanAttributes, fn: () => Promise<T>): Promise<T>;
+/**
+ * Start a detached span. No-op if no bridge is registered. The SDK does not
+ * return a `Span` handle to apps — apps should prefer `withRomeSpan` /
+ * `withSdkSpan` which bracket their own work.
+ */
+export declare function startRomeSpan(name: string, attrs?: SpanAttributes): void;
+/** Current session id from core's AsyncLocalStorage, or `undefined`. */
+export declare function currentSessionId(): string | undefined;
+/**
+ * Run `fn` inside a fresh session context. If no bridge is registered the
+ * function runs verbatim with no context established.
+ */
+export declare function runWithSession<T>(sessionId: string, fn: () => T): T;
+/**
+ * Wrap `fn` in a `sdk:<methodName>` span with the method name stamped as
+ * `sdk.method`. Extra `attrs` merge in (e.g., `rome.app.name`). Apps call
+ * this from their own code to opt in to tracing without importing OTEL.
+ */
+export declare function withSdkSpan<T>(methodName: string, attrs: SpanAttributes, fn: () => Promise<T>): Promise<T>;
+export interface ActionConfig {
+    name: string;
+    type: "system" | "custom";
+    description: string;
+    entry?: string;
+    complexity: "simple" | "moderate" | "complex";
+    speed: "fast" | "moderate" | "slow";
+    reliability: "high" | "medium" | "low";
+    sideEffects: "read-only" | "write";
+    requiresApproval?: boolean;
+    cancellable?: boolean;
+    webhook?: boolean;
+}
+export interface Action {
+    config: ActionConfig;
+    inputSchema?: Record<string, unknown>;
+    execute(args: Record<string, unknown>): Promise<ActionResult>;
+    /**
+     * Optional preview renderer. Returns a structured payload describing what
+     * the action would do, used to build approval cards shown to the guardian.
+     * Pure function over args — no I/O.
+     */
+    preview?(args: Record<string, unknown>): PreviewPayload;
+}
+export type PreviewPayload = {
+    kind: "sensitive_message";
+    channel: string;
+    threadId: string;
+    text: string;
+    reason?: string;
+} | {
+    kind: "generic";
+    title: string;
+    summary: string;
+    fields?: {
+        label: string;
+        value: string;
+    }[];
+};
+export interface ActionResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    pendingApproval?: {
+        approvalId: string;
+        actionName: string;
+        description: string;
+    };
+}
+export interface Logger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+export type AgentMessage = {
+    type: "text";
+    content: string;
+} | {
+    type: "thinking";
+    content: string;
+} | {
+    type: "tool_use";
+    tool: string;
+    input: unknown;
+} | {
+    type: "tool_result";
+    tool: string;
+    output: unknown;
+} | {
+    type: "result";
+    content: string;
+} | {
+    type: "error";
+    error: string;
+} | {
+    type: "session_init";
+    sessionId: string;
+    systemPrompt?: string;
+    userPrompt?: string;
+};
+export type StreamAgentMessage = AgentMessage & {
+    agent?: string;
+};
+export interface ThreadContext {
+    channel: string;
+    threadId: string;
+    threadPath?: string;
+    channelUserId?: string;
+    threadName?: string;
+    threadType?: "private" | "group";
+    projectName?: string;
+}
+export interface RunParams {
+    agentName: string;
+    prompt: string;
+    channelThreadKey?: string;
+    threadContext?: ThreadContext;
+    sessionId?: string;
+    contextSuffix?: string;
+    sharedContext?: Record<string, unknown>;
+    workingDir?: string;
+}
+export interface AgentRunnerInterface {
+    run(params: RunParams): AsyncIterable<AgentMessage>;
+}
+export interface Attachment {
+    type: "image" | "video" | "audio" | "document" | "sticker" | "location" | "contact";
+    url?: string;
+    mimeType?: string;
+    fileName?: string;
+    caption?: string;
+    data?: Buffer;
+}
+export interface OutgoingAttachment {
+    type: "image" | "video" | "audio" | "document";
+    source: string;
+    caption?: string;
+}
+export interface OutgoingMessage {
+    text?: string;
+    attachments?: OutgoingAttachment[];
+    replyToMessageId?: string;
+    /**
+     * Structured message parts. When provided, replaces the plain-text path so
+     * channels that support rich content (web chat today) can render typed
+     * blocks like approval cards. Channels without rich support ignore it.
+     */
+    parts?: MessagePart[];
+}
+export type ApprovalCardStatus = "pending" | "approved" | "rejected" | "executing" | "executed" | "failed";
+export type MessagePart = {
+    type: "text";
+    content: string;
+} | {
+    type: "approval_card";
+    approvalId: string;
+    actionName: string;
+    preview: PreviewPayload;
+    status: ApprovalCardStatus;
+};
+export interface NormalizedMessage {
+    id: string;
+    channel: "telegram" | "whatsapp" | "webchat" | "discord";
+    channelUserId: string;
+    displayName: string;
+    threadId: string;
+    threadName?: string;
+    threadType: "private" | "group";
+    timestamp: Date;
+    text: string;
+    attachments: Attachment[];
+    replyToMessageId?: string;
+    rawEvent: unknown;
+}
+export interface ChannelAdapter {
+    readonly channelName: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendMessage(channelUserId: string, threadId: string, message: OutgoingMessage): Promise<void>;
+    onMessage(handler: (msg: NormalizedMessage) => Promise<void>): void;
+    notifyTyping?(threadId: string): Promise<void>;
+    /**
+     * Optional: fetch recent message history.
+     * @param threadId - Specific thread ID, or null to fetch across all accessible
+     *   threads (e.g. all Discord guild channels).
+     * @param windowHours - How many hours back to look.
+     */
+    fetchHistory?(threadId: string | null, windowHours: number): Promise<NormalizedMessage[]>;
+}
+export interface ChannelMessageHook {
+    register(): void;
+    registerAdapter(adapter: ChannelAdapter): void;
+}
+export interface ActionRunContext {
+    initiator?: string;
+    channelContext?: ThreadContext;
+    sharedContext?: Record<string, unknown>;
+}
+export interface CurrentActionContext {
+    channelContext?: ThreadContext;
+    sessionId?: string;
+    agentName?: string;
+    channelThreadKey?: string;
+    sharedContext?: Record<string, unknown>;
+}
+export type CurrentActionContextPatch = Partial<CurrentActionContext>;
+type CurrentActionContextRunner = <T>(patch: CurrentActionContextPatch, fn: () => Promise<T>) => Promise<T>;
+export declare function setCurrentActionContextResolver(resolver: (() => CurrentActionContext | undefined) | null): void;
+export declare function getCurrentActionContext(): CurrentActionContext | undefined;
+export declare function setCurrentActionContextRunner(runner: CurrentActionContextRunner | null): void;
+export declare function runWithCurrentActionContext<T>(patch: CurrentActionContextPatch, fn: () => Promise<T>): Promise<T>;
+export interface ActionEngineLike {
+    run(name: string, args: Record<string, unknown>, context?: ActionRunContext): Promise<ActionResult>;
+}
+export type DrizzleDb = BetterSQLite3Database<Record<string, never>>;
+export interface AppDbContext {
+    connection: DrizzleDb;
+    tablePrefix: string;
+    tableName(name: string): string;
+}
+export interface RomeAppDefinition {
+    id: string;
+    version: string;
+    description: string;
+    kind?: string;
+}
+export interface RomeAppContext {
+    app: RomeAppDefinition;
+    registry: unknown;
+    db: AppDbContext;
+    log: Logger;
+    runAction(name: string, args: Record<string, unknown>): Promise<ActionResult>;
+    listEvents(): Promise<ScheduledEvent[]>;
+}
+export type AppActionRuntimeDeps<TShared = Record<string, unknown>> = TShared & {
+    appContext: RomeAppContext;
+};
+export interface RomeAppApiRequest {
+    method: string;
+    path: string[];
+    headers: Record<string, string>;
+    query: URLSearchParams;
+    body?: Uint8Array;
+}
+export interface RomeAppApiHandler {
+    handle(request: RomeAppApiRequest): Promise<Response>;
+}
+export interface ChannelMappingRecord {
+    channel: string;
+    channelUserId: string;
+}
+export interface PersonRecord {
+    id: string;
+    displayName: string;
+    bondLevel: "guardian" | "inner-circle" | "acquaintance" | "other";
+    channelMappings: ChannelMappingRecord[];
+    profilePath?: string | null;
+    approved?: boolean | null;
+    createdAt?: Date;
+    [key: string]: unknown;
+}
+export interface PersonMappingRepository {
+    findByChannelUser(channel: string, channelUserId: string): Promise<PersonRecord | null>;
+    findByName(displayName: string): Promise<PersonRecord[]>;
+    findByNameFuzzy(displayName: string): Promise<PersonRecord | null>;
+    findByBondLevel(bondLevel: "guardian" | "inner-circle" | "acquaintance" | "other"): Promise<PersonRecord[]>;
+    create(data: {
+        displayName: string;
+        bondLevel: "guardian" | "inner-circle" | "acquaintance" | "other";
+        profilePath?: string;
+        approved?: boolean;
+        channelMappings?: {
+            channel: string;
+            channelUserId: string;
+        }[];
+    }): Promise<string>;
+    addChannelMapping(personId: string, channel: string, channelUserId: string, displayName?: string): Promise<unknown>;
+}
+export interface ApprovalRecord {
+    id: string;
+    type: string;
+    status: "pending" | "approved" | "rejected" | "auto_approved";
+    requestedBy: string;
+    description: string;
+    payload: unknown;
+    createdAt: Date;
+}
+export interface ApprovalsRepository {
+    create(data: {
+        type: string;
+        requestedBy: string;
+        description: string;
+        payload?: unknown;
+        status?: "pending" | "approved" | "rejected" | "auto_approved";
+    }): Promise<string>;
+}
+export interface SentinelLogEntry {
+    id: string;
+    channel: string;
+    channelUserId: string;
+    displayName: string | null;
+    text: string | null;
+    action: "replied" | "ignored" | "escalated";
+    response: string | null;
+    createdAt: Date;
+}
+export interface SentinelLogRepository {
+    create(data: {
+        messageId: string;
+        channel: string;
+        channelUserId: string;
+        displayName?: string;
+        threadId?: string;
+        text?: string;
+        action: "replied" | "ignored" | "escalated";
+        response?: string;
+    }): Promise<string>;
+    findUnreviewed(): Promise<SentinelLogEntry[]>;
+    markReviewed(ids: string[]): Promise<void>;
+}
+export interface SettingsRepository {
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown): Promise<void>;
+}
+export interface PolicyRule {
+    action: "allow" | "block" | "require_approval" | "sentinel_review";
+    conditions?: Record<string, unknown>;
+}
+export interface PolicyContext {
+    channel: string;
+    sender: {
+        id: string;
+        bondLevel: string;
+    } | null;
+    bondLevel: string;
+    threadName?: string;
+    threadType?: string;
+}
+export interface PolicyEngine {
+    evaluate(context: PolicyContext): Promise<PolicyRule>;
+}
+export interface ScheduledEvent {
+    id: string;
+    name: string;
+    type: "one-off" | "recurring";
+    tzid: string;
+    localTime: string;
+    rrule?: string | null;
+    startTime: Date;
+    endTime?: Date | null;
+    actionName: string;
+    args: unknown;
+    enabled: boolean | null;
+    createdAt: Date;
+    lastRunAt?: Date | null;
+    nextRunAt?: Date | null;
+}
+export interface EventsRepository {
+    findById(id: string): Promise<ScheduledEvent | null>;
+    create(data: {
+        name: string;
+        type: "one-off" | "recurring";
+        tzid: string;
+        localTime: string;
+        rrule?: string;
+        startTime: Date;
+        endTime?: Date;
+        actionName: string;
+        args: Record<string, unknown>[];
+        nextRunAt?: Date;
+    }): Promise<string>;
+    update(id: string, data: Partial<{
+        name: string;
+        type: "one-off" | "recurring";
+        tzid: string;
+        localTime: string;
+        rrule: string | null;
+        startTime: Date;
+        endTime: Date | null;
+        actionName: string;
+        args: Record<string, unknown>[];
+        enabled: boolean;
+    }>): Promise<void>;
+    findAll(): Promise<ScheduledEvent[]>;
+    delete(id: string): Promise<void>;
+}
+export interface EventScheduler {
+    scheduleEvent(event: ScheduledEvent): void;
+    cancelEvent(eventId: string): void;
+}
+export declare function createAppLogger(component: string): Logger;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,119 @@
+export * from "./browser.js";
+export { getWorkerRpc, isWorkerRpcResponse, WorkerRpcTimeoutError, WorkerRpcDisconnectError, } from "./worker-rpc.js";
+const TELEMETRY_BRIDGE_KEY = Symbol.for("rome.appRuntime.telemetryBridge");
+function getBridge() {
+    return globalThis[TELEMETRY_BRIDGE_KEY];
+}
+/**
+ * Core calls this at `initTelemetry()` time to wire the real OTEL-backed
+ * impls into the SDK. Passing `null` unregisters (useful in tests).
+ */
+export function setTelemetryBridge(bridge) {
+    globalThis[TELEMETRY_BRIDGE_KEY] =
+        bridge ?? undefined;
+}
+/**
+ * Run `fn` inside a `name` span with `attrs` attached. If no bridge is
+ * registered (e.g., pure unit test without core's telemetry initialized)
+ * the span is a no-op and `fn` runs verbatim.
+ */
+export function withRomeSpan(name, attrs, fn) {
+    const bridge = getBridge();
+    return bridge ? bridge.withRomeSpan(name, attrs, fn) : fn();
+}
+/**
+ * Start a detached span. No-op if no bridge is registered. The SDK does not
+ * return a `Span` handle to apps — apps should prefer `withRomeSpan` /
+ * `withSdkSpan` which bracket their own work.
+ */
+export function startRomeSpan(name, attrs = {}) {
+    getBridge()?.startRomeSpan(name, attrs);
+}
+/** Current session id from core's AsyncLocalStorage, or `undefined`. */
+export function currentSessionId() {
+    return getBridge()?.currentSessionId();
+}
+/**
+ * Run `fn` inside a fresh session context. If no bridge is registered the
+ * function runs verbatim with no context established.
+ */
+export function runWithSession(sessionId, fn) {
+    const bridge = getBridge();
+    return bridge ? bridge.runWithSession(sessionId, fn) : fn();
+}
+/**
+ * Wrap `fn` in a `sdk:<methodName>` span with the method name stamped as
+ * `sdk.method`. Extra `attrs` merge in (e.g., `rome.app.name`). Apps call
+ * this from their own code to opt in to tracing without importing OTEL.
+ */
+export async function withSdkSpan(methodName, attrs, fn) {
+    return withRomeSpan(`sdk:${methodName}`, { "sdk.method": methodName, ...attrs }, fn);
+}
+const CURRENT_ACTION_CONTEXT_RESOLVER = Symbol.for("rome.appRuntime.currentActionContextResolver");
+const CURRENT_ACTION_CONTEXT_RUNNER = Symbol.for("rome.appRuntime.currentActionContextRunner");
+export function setCurrentActionContextResolver(resolver) {
+    const registry = globalThis;
+    registry[CURRENT_ACTION_CONTEXT_RESOLVER] = resolver ?? undefined;
+}
+export function getCurrentActionContext() {
+    const registry = globalThis;
+    return registry[CURRENT_ACTION_CONTEXT_RESOLVER]?.();
+}
+export function setCurrentActionContextRunner(runner) {
+    const registry = globalThis;
+    registry[CURRENT_ACTION_CONTEXT_RUNNER] = runner ?? undefined;
+}
+export async function runWithCurrentActionContext(patch, fn) {
+    const registry = globalThis;
+    const runner = registry[CURRENT_ACTION_CONTEXT_RUNNER];
+    if (!runner) {
+        return await fn();
+    }
+    return await runner(patch, fn);
+}
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+function shouldLog(level) {
+    const currentLevel = (process.env.LOG_LEVEL ?? "info").toLowerCase();
+    return LEVEL_ORDER[level] >= (LEVEL_ORDER[currentLevel] ?? LEVEL_ORDER.info);
+}
+export function createAppLogger(component) {
+    function log(level, message, data) {
+        if (!shouldLog(level)) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            component,
+            message,
+        };
+        if (data !== undefined) {
+            entry.data = data;
+        }
+        const line = JSON.stringify(entry);
+        switch (level) {
+            case "debug":
+            case "info":
+                console.log(line);
+                break;
+            case "warn":
+                console.warn(line);
+                break;
+            case "error":
+                console.error(line);
+                break;
+        }
+    }
+    return {
+        debug: (message, data) => log("debug", message, data),
+        info: (message, data) => log("info", message, data),
+        warn: (message, data) => log("warn", message, data),
+        error: (message, data) => log("error", message, data),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/worker-rpc.d.ts

@@ -0,0 +1,28 @@
+export interface RpcResponseMessage {
+    type: "rpc_response";
+    clientId: string;
+    id: number;
+    result?: unknown;
+    error?: string;
+}
+export declare class WorkerRpcTimeoutError extends Error {
+    constructor(method: string, timeoutMs: number);
+}
+export declare class WorkerRpcDisconnectError extends Error {
+    constructor();
+}
+declare class WorkerRpcClient {
+    private readonly clientId;
+    private pending;
+    private nextId;
+    private processHandlersInstalled;
+    call<T = unknown>(method: string, params?: unknown, options?: {
+        timeoutMs?: number;
+    }): Promise<T>;
+    handleResponse(message: RpcResponseMessage): void;
+    private ensureProcessHandlers;
+}
+export declare function getWorkerRpc(): WorkerRpcClient;
+export declare function isWorkerRpcResponse(message: unknown): message is RpcResponseMessage;
+export {};
+//# sourceMappingURL=worker-rpc.d.ts.map

package/dist/worker-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-rpc.d.ts","sourceRoot":"","sources":["../src/worker-rpc.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI9C;AAED,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD;AAoBD,cAAM,eAAe;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,wBAAwB,CAAS;IAEnC,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,CAAC,CAAC;IA0Cb,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAYjD,OAAO,CAAC,qBAAqB;CAkB9B;AAID,wBAAgB,YAAY,IAAI,eAAe,CAK9C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,kBAAkB,CAOnF"}

package/dist/worker-rpc.js

@@ -0,0 +1,113 @@
+// Worker-side RPC client for calling main-process services.
+//
+// The main process owns live references to ChannelManager, EventScheduler,
+// and related services. Worker processes reach them over Node's child-process
+// IPC channel via this client — a replacement for the former HTTP callbacks
+// to the internal API.
+import { randomUUID } from "node:crypto";
+export class WorkerRpcTimeoutError extends Error {
+    constructor(method, timeoutMs) {
+        super(`WorkerRPC timeout: ${method} (${timeoutMs}ms)`);
+        this.name = "WorkerRpcTimeoutError";
+    }
+}
+export class WorkerRpcDisconnectError extends Error {
+    constructor() {
+        super("WorkerRPC main process disconnected");
+        this.name = "WorkerRpcDisconnectError";
+    }
+}
+const DEFAULT_TIMEOUT_MS = 30_000;
+// There may be more than one copy of this module loaded in the same process
+// (e.g. when an installed app ships its own physical copy of @rome-os/app-runtime
+// under node_modules/, producing a distinct ESM URL from the monorepo source).
+// Each copy constructs its own WorkerRpcClient with a distinct `clientId`.
+// Every instance installs its own process.on("message") listener; the main
+// process echoes `clientId` back on responses, so each listener only resolves
+// responses originating from its own pending map. This keeps pending maps
+// fully isolated across copies and avoids id-space collisions (nextId starts
+// from 1 independently in each copy).
+class WorkerRpcClient {
+    clientId = randomUUID();
+    pending = new Map();
+    nextId = 1;
+    processHandlersInstalled = false;
+    async call(method, params, options) {
+        if (!process.send) {
+            throw new Error(`WorkerRPC: not running in a Node.js child process (method=${method})`);
+        }
+        this.ensureProcessHandlers();
+        const id = this.nextId++;
+        const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        return await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new WorkerRpcTimeoutError(method, timeoutMs));
+            }, timeoutMs);
+            this.pending.set(id, {
+                resolve: (value) => resolve(value),
+                reject,
+                timeout,
+                method,
+            });
+            const request = {
+                type: "rpc_request",
+                clientId: this.clientId,
+                id,
+                method,
+                params,
+            };
+            process.send(request, (err) => {
+                if (err) {
+                    clearTimeout(timeout);
+                    this.pending.delete(id);
+                    reject(err);
+                }
+            });
+        });
+    }
+    handleResponse(message) {
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        clearTimeout(pending.timeout);
+        this.pending.delete(message.id);
+        if (message.error !== undefined) {
+            pending.reject(new Error(message.error));
+        }
+        else {
+            pending.resolve(message.result);
+        }
+    }
+    ensureProcessHandlers() {
+        if (this.processHandlersInstalled)
+            return;
+        this.processHandlersInstalled = true;
+        process.on("message", (message) => {
+            if (isWorkerRpcResponse(message) && message.clientId === this.clientId) {
+                this.handleResponse(message);
+            }
+        });
+        process.on("disconnect", () => {
+            for (const pending of this.pending.values()) {
+                clearTimeout(pending.timeout);
+                pending.reject(new WorkerRpcDisconnectError());
+            }
+            this.pending.clear();
+        });
+    }
+}
+let singleton = null;
+export function getWorkerRpc() {
+    if (!singleton) {
+        singleton = new WorkerRpcClient();
+    }
+    return singleton;
+}
+export function isWorkerRpcResponse(message) {
+    return (typeof message === "object" &&
+        message !== null &&
+        message.type === "rpc_response" &&
+        typeof message.clientId === "string");
+}
+//# sourceMappingURL=worker-rpc.js.map

package/dist/worker-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-rpc.js","sourceRoot":"","sources":["../src/worker-rpc.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,4EAA4E;AAC5E,uBAAuB;AAEvB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkBzC,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,MAAc,EAAE,SAAiB;QAC3C,KAAK,CAAC,sBAAsB,MAAM,KAAK,SAAS,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD;QACE,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AASD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,4EAA4E;AAC5E,kFAAkF;AAClF,+EAA+E;AAC/E,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,0EAA0E;AAC1E,6EAA6E;AAC7E,sCAAsC;AACtC,MAAM,eAAe;IACF,QAAQ,GAAW,UAAU,EAAE,CAAC;IACzC,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IACzC,MAAM,GAAG,CAAC,CAAC;IACX,wBAAwB,GAAG,KAAK,CAAC;IAEzC,KAAK,CAAC,IAAI,CACR,MAAc,EACd,MAAgB,EAChB,OAAgC;QAEhC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,6DAA6D,MAAM,GAAG,CACvE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAE7B,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,kBAAkB,CAAC;QAE3D,OAAO,MAAM,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;YACvD,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAU,CAAC;gBACvC,MAAM;gBACN,OAAO;gBACP,MAAM;aACP,CAAC,CAAC;YAEH,MAAM,OAAO,GAAsB;gBACjC,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,EAAE;gBACF,MAAM;gBACN,MAAM;aACP,CAAC;YACF,OAAO,CAAC,IAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC7B,IAAI,GAAG,EAAE,CAAC;oBACR,YAAY,CAAC,OAAO,CAAC,CAAC;oBACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACxB,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,OAA2B;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAEO,qBAAqB;QAC3B,IAAI,IAAI,CAAC,wBAAwB;YAAE,OAAO;QAC1C,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC;QAErC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAgB,EAAE,EAAE;YACzC,IAAI,mBAAmB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACvE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;YAC5B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC5C,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,wBAAwB,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,IAAI,SAAS,GAA2B,IAAI,CAAC;AAE7C,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QACf,OAA6B,CAAC,IAAI,KAAK,cAAc;QACtD,OAAQ,OAAkC,CAAC,QAAQ,KAAK,QAAQ,CACjE,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@rome-os/app-runtime",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "access": "public",
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.5.1",
+    "@types/ws": "^8.18.0",
+    "drizzle-orm": "^0.45.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}