@agent-native/core 0.15.13 → 0.16.0

package/dist/browser-sessions/actions.d.ts

@@ -0,0 +1,7 @@
+import type { ActionEntry } from "../agent/production-agent.js";
+export interface CreateBrowserSessionActionEntriesOptions {
+    getOwnerEmail: () => string | null | undefined;
+    getDefaultTimeoutMs?: () => number | undefined;
+}
+export declare function createBrowserSessionActionEntries(options: CreateBrowserSessionActionEntriesOptions): Record<string, ActionEntry>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/browser-sessions/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/browser-sessions/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAOhE,MAAM,WAAW,wCAAwC;IACvD,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,mBAAmB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAChD;AAsFD,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC,GAChD,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA2M7B"}

package/dist/browser-sessions/actions.js

@@ -0,0 +1,223 @@
+import { callBrowserSession, listBrowserSessions, } from "./store.js";
+function requireOwner(options) {
+    const owner = options.getOwnerEmail()?.trim();
+    if (!owner) {
+        throw new Error("No authenticated user is available for browser sessions");
+    }
+    return owner;
+}
+function readString(args, key) {
+    const value = args[key];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function readTimeoutMs(args, options) {
+    const raw = args.timeoutMs;
+    if (typeof raw === "number" && raw > 0)
+        return raw;
+    if (typeof raw === "string" && raw.trim()) {
+        const parsed = Number(raw);
+        if (Number.isFinite(parsed) && parsed > 0)
+            return parsed;
+    }
+    return options.getDefaultTimeoutMs?.();
+}
+async function resolveSessionId(ownerEmail, requestedSessionId) {
+    if (requestedSessionId)
+        return requestedSessionId;
+    const sessions = await listBrowserSessions(ownerEmail, { limit: 5 });
+    if (sessions.length === 0) {
+        throw new Error("No active browser sessions are connected. Open the embedded Agent-Native sidecar in the host app first.");
+    }
+    return sessions[0].sessionId;
+}
+function compactSession(session) {
+    if (!session)
+        return null;
+    const route = session.context &&
+        typeof session.context.route === "object" &&
+        session.context.route
+        ? session.context.route
+        : undefined;
+    const resource = session.context &&
+        typeof session.context.resource === "object" &&
+        session.context.resource
+        ? session.context.resource
+        : undefined;
+    return {
+        sessionId: session.sessionId,
+        label: session.label,
+        url: session.url,
+        active: session.active,
+        connectedAt: session.connectedAt,
+        lastSeenAt: session.lastSeenAt,
+        expiresAt: session.expiresAt,
+        route,
+        resource,
+        actionCount: session.actions.length,
+        actions: session.actions.map((action) => ({
+            name: action.name,
+            description: action.description,
+            source: action.source,
+            availability: action.availability,
+            destructive: action.destructive,
+            requiresApproval: action.requiresApproval,
+            schema: action.schema ?? action.parameters,
+        })),
+    };
+}
+export function createBrowserSessionActionEntries(options) {
+    return {
+        "list-browser-sessions": {
+            readOnly: true,
+            tool: {
+                description: "List active browser tabs connected through the Agent-Native embedding SDK. Use this when you need to choose which live host page to inspect or operate.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        includeExpired: {
+                            type: "boolean",
+                            description: "Include recently expired sessions for debugging. Defaults to false.",
+                        },
+                    },
+                },
+            },
+            run: async (args) => {
+                const ownerEmail = requireOwner(options);
+                const sessions = await listBrowserSessions(ownerEmail, {
+                    includeExpired: args.includeExpired === true || args.includeExpired === "true",
+                });
+                return {
+                    ok: true,
+                    sessions: sessions.map(compactSession),
+                };
+            },
+        },
+        "view-browser-session": {
+            readOnly: true,
+            tool: {
+                description: "Read the current page context and screen snapshot from a connected browser session. Omit sessionId to use the most recently active tab.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sessionId: {
+                            type: "string",
+                            description: "Browser session id from list-browser-sessions. Optional when only one tab is active.",
+                        },
+                        timeoutMs: {
+                            type: "number",
+                            description: "How long to wait for the live tab to respond.",
+                        },
+                    },
+                },
+            },
+            run: async (args) => {
+                const ownerEmail = requireOwner(options);
+                const sessionId = await resolveSessionId(ownerEmail, readString(args, "sessionId"));
+                const context = await callBrowserSession(ownerEmail, sessionId, { type: "get-context", timeoutMs: readTimeoutMs(args, options) }, { timeoutMs: readTimeoutMs(args, options) });
+                return { ok: true, sessionId, context };
+            },
+        },
+        "list-browser-session-actions": {
+            readOnly: true,
+            tool: {
+                description: "List live client actions currently exposed by a connected browser session. These actions can change after navigation or selection changes.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sessionId: {
+                            type: "string",
+                            description: "Browser session id from list-browser-sessions. Optional when only one tab is active.",
+                        },
+                        timeoutMs: {
+                            type: "number",
+                            description: "How long to wait for the live tab to respond.",
+                        },
+                    },
+                },
+            },
+            run: async (args) => {
+                const ownerEmail = requireOwner(options);
+                const sessionId = await resolveSessionId(ownerEmail, readString(args, "sessionId"));
+                const actions = await callBrowserSession(ownerEmail, sessionId, { type: "list-actions", timeoutMs: readTimeoutMs(args, options) }, { timeoutMs: readTimeoutMs(args, options) });
+                return { ok: true, sessionId, actions };
+            },
+        },
+        "run-browser-session-action": {
+            tool: {
+                description: "Run a live client action in a connected browser tab. Use list-browser-session-actions first to discover the current action names and schemas. Omit sessionId to use the most recently active tab.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sessionId: {
+                            type: "string",
+                            description: "Browser session id from list-browser-sessions. Optional when only one tab is active.",
+                        },
+                        name: {
+                            type: "string",
+                            description: "The live client action name to run.",
+                        },
+                        args: {
+                            type: "object",
+                            description: "JSON-serializable arguments for the client action. Match the schema returned by list-browser-session-actions.",
+                        },
+                        timeoutMs: {
+                            type: "number",
+                            description: "How long to wait for the live tab to respond.",
+                        },
+                    },
+                    required: ["name"],
+                },
+            },
+            run: async (args) => {
+                const ownerEmail = requireOwner(options);
+                const name = readString(args, "name");
+                if (!name)
+                    throw new Error("name is required");
+                const timeoutMs = readTimeoutMs(args, options);
+                const sessionId = await resolveSessionId(ownerEmail, readString(args, "sessionId"));
+                const result = await callBrowserSession(ownerEmail, sessionId, { type: "run-action", name, args: args.args, timeoutMs }, { timeoutMs });
+                return { ok: true, sessionId, name, result };
+            },
+        },
+        "send-browser-session-command": {
+            tool: {
+                description: "Send a command to a connected host app, such as refreshData, navigate, remountView, hardReload, openResource, or requestApproval. Omit command to ask the host to refresh visible data.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        sessionId: {
+                            type: "string",
+                            description: "Browser session id from list-browser-sessions. Optional when only one tab is active.",
+                        },
+                        command: {
+                            type: "string",
+                            description: "Built-in or custom host command. Defaults to refreshData.",
+                        },
+                        payload: {
+                            type: "object",
+                            description: "JSON-serializable payload for the command, such as a route target or refresh query key.",
+                        },
+                        timeoutMs: {
+                            type: "number",
+                            description: "How long to wait for the live tab to respond.",
+                        },
+                    },
+                },
+            },
+            run: async (args) => {
+                const ownerEmail = requireOwner(options);
+                const timeoutMs = readTimeoutMs(args, options);
+                const sessionId = await resolveSessionId(ownerEmail, readString(args, "sessionId"));
+                const command = readString(args, "command") ?? "refreshData";
+                const result = await callBrowserSession(ownerEmail, sessionId, {
+                    type: "command",
+                    command,
+                    payload: args.payload,
+                    timeoutMs,
+                }, { timeoutMs });
+                return { ok: true, sessionId, command, result };
+            },
+        },
+    };
+}
+//# sourceMappingURL=actions.js.map

package/dist/browser-sessions/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/browser-sessions/actions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ActionEntry } from \"../agent/production-agent.js\";\nimport {\n  callBrowserSession,\n  getBrowserSession,\n  listBrowserSessions,\n} from \"./store.js\";\n\nexport interface CreateBrowserSessionActionEntriesOptions {\n  getOwnerEmail: () => string | null | undefined;\n  getDefaultTimeoutMs?: () => number | undefined;\n}\n\nfunction requireOwner(\n  options: CreateBrowserSessionActionEntriesOptions,\n): string {\n  const owner = options.getOwnerEmail()?.trim();\n  if (!owner) {\n    throw new Error(\"No authenticated user is available for browser sessions\");\n  }\n  return owner;\n}\n\nfunction readString(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction readTimeoutMs(\n  args: Record<string, unknown>,\n  options: CreateBrowserSessionActionEntriesOptions,\n): number | undefined {\n  const raw = args.timeoutMs;\n  if (typeof raw === \"number\" && raw > 0) return raw;\n  if (typeof raw === \"string\" && raw.trim()) {\n    const parsed = Number(raw);\n    if (Number.isFinite(parsed) && parsed > 0) return parsed;\n  }\n  return options.getDefaultTimeoutMs?.();\n}\n\nasync function resolveSessionId(\n  ownerEmail: string,\n  requestedSessionId: string | undefined,\n): Promise<string> {\n  if (requestedSessionId) return requestedSessionId;\n  const sessions = await listBrowserSessions(ownerEmail, { limit: 5 });\n  if (sessions.length === 0) {\n    throw new Error(\n      \"No active browser sessions are connected. Open the embedded Agent-Native sidecar in the host app first.\",\n    );\n  }\n  return sessions[0].sessionId;\n}\n\nfunction compactSession(\n  session: Awaited<ReturnType<typeof getBrowserSession>>,\n) {\n  if (!session) return null;\n  const route =\n    session.context &&\n    typeof session.context.route === \"object\" &&\n    session.context.route\n      ? session.context.route\n      : undefined;\n  const resource =\n    session.context &&\n    typeof session.context.resource === \"object\" &&\n    session.context.resource\n      ? session.context.resource\n      : undefined;\n  return {\n    sessionId: session.sessionId,\n    label: session.label,\n    url: session.url,\n    active: session.active,\n    connectedAt: session.connectedAt,\n    lastSeenAt: session.lastSeenAt,\n    expiresAt: session.expiresAt,\n    route,\n    resource,\n    actionCount: session.actions.length,\n    actions: session.actions.map((action) => ({\n      name: action.name,\n      description: action.description,\n      source: action.source,\n      availability: action.availability,\n      destructive: action.destructive,\n      requiresApproval: action.requiresApproval,\n      schema: action.schema ?? action.parameters,\n    })),\n  };\n}\n\nexport function createBrowserSessionActionEntries(\n  options: CreateBrowserSessionActionEntriesOptions,\n): Record<string, ActionEntry> {\n  return {\n    \"list-browser-sessions\": {\n      readOnly: true,\n      tool: {\n        description:\n          \"List active browser tabs connected through the Agent-Native embedding SDK. Use this when you need to choose which live host page to inspect or operate.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            includeExpired: {\n              type: \"boolean\",\n              description:\n                \"Include recently expired sessions for debugging. Defaults to false.\",\n            },\n          },\n        },\n      },\n      run: async (args: Record<string, unknown>) => {\n        const ownerEmail = requireOwner(options);\n        const sessions = await listBrowserSessions(ownerEmail, {\n          includeExpired:\n            args.includeExpired === true || args.includeExpired === \"true\",\n        });\n        return {\n          ok: true,\n          sessions: sessions.map(compactSession),\n        };\n      },\n    },\n\n    \"view-browser-session\": {\n      readOnly: true,\n      tool: {\n        description:\n          \"Read the current page context and screen snapshot from a connected browser session. Omit sessionId to use the most recently active tab.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            sessionId: {\n              type: \"string\",\n              description:\n                \"Browser session id from list-browser-sessions. Optional when only one tab is active.\",\n            },\n            timeoutMs: {\n              type: \"number\",\n              description: \"How long to wait for the live tab to respond.\",\n            },\n          },\n        },\n      },\n      run: async (args: Record<string, unknown>) => {\n        const ownerEmail = requireOwner(options);\n        const sessionId = await resolveSessionId(\n          ownerEmail,\n          readString(args, \"sessionId\"),\n        );\n        const context = await callBrowserSession(\n          ownerEmail,\n          sessionId,\n          { type: \"get-context\", timeoutMs: readTimeoutMs(args, options) },\n          { timeoutMs: readTimeoutMs(args, options) },\n        );\n        return { ok: true, sessionId, context };\n      },\n    },\n\n    \"list-browser-session-actions\": {\n      readOnly: true,\n      tool: {\n        description:\n          \"List live client actions currently exposed by a connected browser session. These actions can change after navigation or selection changes.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            sessionId: {\n              type: \"string\",\n              description:\n                \"Browser session id from list-browser-sessions. Optional when only one tab is active.\",\n            },\n            timeoutMs: {\n              type: \"number\",\n              description: \"How long to wait for the live tab to respond.\",\n            },\n          },\n        },\n      },\n      run: async (args: Record<string, unknown>) => {\n        const ownerEmail = requireOwner(options);\n        const sessionId = await resolveSessionId(\n          ownerEmail,\n          readString(args, \"sessionId\"),\n        );\n        const actions = await callBrowserSession(\n          ownerEmail,\n          sessionId,\n          { type: \"list-actions\", timeoutMs: readTimeoutMs(args, options) },\n          { timeoutMs: readTimeoutMs(args, options) },\n        );\n        return { ok: true, sessionId, actions };\n      },\n    },\n\n    \"run-browser-session-action\": {\n      tool: {\n        description:\n          \"Run a live client action in a connected browser tab. Use list-browser-session-actions first to discover the current action names and schemas. Omit sessionId to use the most recently active tab.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            sessionId: {\n              type: \"string\",\n              description:\n                \"Browser session id from list-browser-sessions. Optional when only one tab is active.\",\n            },\n            name: {\n              type: \"string\",\n              description: \"The live client action name to run.\",\n            },\n            args: {\n              type: \"object\",\n              description:\n                \"JSON-serializable arguments for the client action. Match the schema returned by list-browser-session-actions.\",\n            },\n            timeoutMs: {\n              type: \"number\",\n              description: \"How long to wait for the live tab to respond.\",\n            },\n          },\n          required: [\"name\"],\n        },\n      },\n      run: async (args: Record<string, unknown>) => {\n        const ownerEmail = requireOwner(options);\n        const name = readString(args, \"name\");\n        if (!name) throw new Error(\"name is required\");\n        const timeoutMs = readTimeoutMs(args, options);\n        const sessionId = await resolveSessionId(\n          ownerEmail,\n          readString(args, \"sessionId\"),\n        );\n        const result = await callBrowserSession(\n          ownerEmail,\n          sessionId,\n          { type: \"run-action\", name, args: args.args, timeoutMs },\n          { timeoutMs },\n        );\n        return { ok: true, sessionId, name, result };\n      },\n    },\n\n    \"send-browser-session-command\": {\n      tool: {\n        description:\n          \"Send a command to a connected host app, such as refreshData, navigate, remountView, hardReload, openResource, or requestApproval. Omit command to ask the host to refresh visible data.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            sessionId: {\n              type: \"string\",\n              description:\n                \"Browser session id from list-browser-sessions. Optional when only one tab is active.\",\n            },\n            command: {\n              type: \"string\",\n              description:\n                \"Built-in or custom host command. Defaults to refreshData.\",\n            },\n            payload: {\n              type: \"object\",\n              description:\n                \"JSON-serializable payload for the command, such as a route target or refresh query key.\",\n            },\n            timeoutMs: {\n              type: \"number\",\n              description: \"How long to wait for the live tab to respond.\",\n            },\n          },\n        },\n      },\n      run: async (args: Record<string, unknown>) => {\n        const ownerEmail = requireOwner(options);\n        const timeoutMs = readTimeoutMs(args, options);\n        const sessionId = await resolveSessionId(\n          ownerEmail,\n          readString(args, \"sessionId\"),\n        );\n        const command = readString(args, \"command\") ?? \"refreshData\";\n        const result = await callBrowserSession(\n          ownerEmail,\n          sessionId,\n          {\n            type: \"command\",\n            command,\n            payload: args.payload,\n            timeoutMs,\n          },\n          { timeoutMs },\n        );\n        return { ok: true, sessionId, command, result };\n      },\n    },\n  };\n}\n"]}

package/dist/browser-sessions/routes.d.ts

@@ -0,0 +1,7 @@
+import type { H3Event } from "h3";
+export interface MountBrowserSessionRoutesOptions {
+    routePrefix?: string;
+    getOwnerFromEvent?: (event: H3Event) => string | Promise<string>;
+}
+export declare function mountBrowserSessionRoutes(nitroApp: any, options?: MountBrowserSessionRoutesOptions): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/browser-sessions/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/browser-sessions/routes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAoBlC,MAAM,WAAW,gCAAgC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClE;AA4DD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,GAAG,EACb,OAAO,GAAE,gCAAqC,GAC7C,IAAI,CA4IN"}

package/dist/browser-sessions/routes.js

@@ -0,0 +1,159 @@
+import { defineEventHandler, getMethod, setResponseHeader, setResponseStatus, } from "h3";
+import { getH3App } from "../server/framework-request-handler.js";
+import { readBody } from "../server/h3-helpers.js";
+import { getSession } from "../server/auth.js";
+import { claimBrowserSessionRequest, completeBrowserSessionRequest, createBrowserSessionRequest, disconnectBrowserSession, getBrowserSession, getBrowserSessionRequest, listBrowserSessions, registerBrowserSession, waitForBrowserSessionRequest, } from "./store.js";
+function decodeSegment(value) {
+    if (!value)
+        return undefined;
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+async function defaultOwnerFromEvent(event) {
+    const session = await getSession(event);
+    if (!session?.email) {
+        throw Object.assign(new Error("Authentication required"), {
+            statusCode: 401,
+        });
+    }
+    return session.email;
+}
+async function ownerFromEvent(event, options) {
+    return options.getOwnerFromEvent
+        ? options.getOwnerFromEvent(event)
+        : defaultOwnerFromEvent(event);
+}
+function methodNotAllowed(event) {
+    setResponseStatus(event, 405);
+    return { error: "Method not allowed" };
+}
+function badRequest(event, error) {
+    setResponseStatus(event, 400);
+    return { error };
+}
+function notFound(event, error) {
+    setResponseStatus(event, 404);
+    return { error };
+}
+function errorResponse(event, error) {
+    const statusCode = typeof error?.statusCode === "number"
+        ? error.statusCode
+        : 500;
+    setResponseStatus(event, statusCode);
+    return {
+        error: error instanceof Error ? error.message : String(error),
+    };
+}
+async function readJsonBody(event) {
+    return ((await readBody(event).catch(() => ({}))) || {});
+}
+export function mountBrowserSessionRoutes(nitroApp, options = {}) {
+    const routePrefix = options.routePrefix ?? "/_agent-native";
+    const basePath = `${routePrefix}/browser-sessions`;
+    getH3App(nitroApp).use(basePath, defineEventHandler(async (event) => {
+        setResponseHeader(event, "Cache-Control", "no-store");
+        const method = getMethod(event);
+        const raw = (event.path || "/").split("?")[0];
+        const segments = raw
+            .replace(/^\/+/, "")
+            .split("/")
+            .filter(Boolean)
+            .map(decodeSegment);
+        try {
+            const ownerEmail = await ownerFromEvent(event, options);
+            if (segments.length === 0) {
+                if (method === "GET") {
+                    const sessions = await listBrowserSessions(ownerEmail);
+                    return { ok: true, sessions };
+                }
+                if (method === "POST") {
+                    const body = await readJsonBody(event);
+                    const session = await registerBrowserSession(ownerEmail, body);
+                    return { ok: true, session };
+                }
+                return methodNotAllowed(event);
+            }
+            const sessionId = segments[0];
+            if (!sessionId)
+                return badRequest(event, "sessionId is required");
+            if (segments.length === 1) {
+                if (method === "GET") {
+                    const session = await getBrowserSession(ownerEmail, sessionId, {
+                        includeExpired: true,
+                    });
+                    return session
+                        ? { ok: true, session }
+                        : notFound(event, "Session not found");
+                }
+                if (method === "DELETE") {
+                    const deleted = await disconnectBrowserSession(ownerEmail, sessionId);
+                    return { ok: true, deleted };
+                }
+                return methodNotAllowed(event);
+            }
+            if (segments[1] === "heartbeat") {
+                if (method !== "POST")
+                    return methodNotAllowed(event);
+                const body = await readJsonBody(event);
+                const session = await registerBrowserSession(ownerEmail, {
+                    ...body,
+                    session: {
+                        ...(body.session ?? {}),
+                        id: sessionId,
+                    },
+                    sessionId,
+                });
+                return { ok: true, session };
+            }
+            if (segments[1] !== "requests") {
+                return notFound(event, "Unknown browser-session route");
+            }
+            if (segments.length === 2) {
+                if (method !== "POST")
+                    return methodNotAllowed(event);
+                const body = await readJsonBody(event);
+                const request = await createBrowserSessionRequest(ownerEmail, sessionId, body);
+                if (body.wait === true) {
+                    const result = await waitForBrowserSessionRequest(ownerEmail, request.id, { timeoutMs: body.timeoutMs });
+                    return { ok: true, requestId: request.id, result };
+                }
+                return { ok: true, request };
+            }
+            if (segments.length === 3 && segments[2] === "claim") {
+                if (method !== "POST")
+                    return methodNotAllowed(event);
+                const request = await claimBrowserSessionRequest(ownerEmail, sessionId);
+                return { ok: true, request };
+            }
+            const requestId = segments[2];
+            if (!requestId)
+                return badRequest(event, "requestId is required");
+            if (segments.length === 3) {
+                if (method !== "GET")
+                    return methodNotAllowed(event);
+                const request = await getBrowserSessionRequest(ownerEmail, requestId);
+                return request
+                    ? { ok: true, request }
+                    : notFound(event, "Request not found");
+            }
+            if (segments.length === 4 && segments[3] === "complete") {
+                if (method !== "POST")
+                    return methodNotAllowed(event);
+                const body = await readJsonBody(event);
+                const request = await completeBrowserSessionRequest(ownerEmail, sessionId, requestId, body.ok === false
+                    ? { ok: false, error: body.error, result: body.result }
+                    : { ok: true, result: body.result });
+                return { ok: true, request };
+            }
+            return notFound(event, "Unknown browser-session route");
+        }
+        catch (error) {
+            return errorResponse(event, error);
+        }
+    }));
+}
+//# sourceMappingURL=routes.js.map

package/dist/browser-sessions/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/browser-sessions/routes.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  defineEventHandler,\n  getMethod,\n  setResponseHeader,\n  setResponseStatus,\n} from \"h3\";\nimport type { H3Event } from \"h3\";\nimport { getH3App } from \"../server/framework-request-handler.js\";\nimport { readBody } from \"../server/h3-helpers.js\";\nimport { getSession } from \"../server/auth.js\";\nimport {\n  claimBrowserSessionRequest,\n  completeBrowserSessionRequest,\n  createBrowserSessionRequest,\n  disconnectBrowserSession,\n  getBrowserSession,\n  getBrowserSessionRequest,\n  listBrowserSessions,\n  registerBrowserSession,\n  waitForBrowserSessionRequest,\n} from \"./store.js\";\nimport type {\n  CreateAgentNativeBrowserSessionRequestInput,\n  RegisterAgentNativeBrowserSessionInput,\n} from \"./types.js\";\n\nexport interface MountBrowserSessionRoutesOptions {\n  routePrefix?: string;\n  getOwnerFromEvent?: (event: H3Event) => string | Promise<string>;\n}\n\nfunction decodeSegment(value: string | undefined): string | undefined {\n  if (!value) return undefined;\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    return value;\n  }\n}\n\nasync function defaultOwnerFromEvent(event: H3Event): Promise<string> {\n  const session = await getSession(event);\n  if (!session?.email) {\n    throw Object.assign(new Error(\"Authentication required\"), {\n      statusCode: 401,\n    });\n  }\n  return session.email;\n}\n\nasync function ownerFromEvent(\n  event: H3Event,\n  options: MountBrowserSessionRoutesOptions,\n): Promise<string> {\n  return options.getOwnerFromEvent\n    ? options.getOwnerFromEvent(event)\n    : defaultOwnerFromEvent(event);\n}\n\nfunction methodNotAllowed(event: H3Event) {\n  setResponseStatus(event, 405);\n  return { error: \"Method not allowed\" };\n}\n\nfunction badRequest(event: H3Event, error: string) {\n  setResponseStatus(event, 400);\n  return { error };\n}\n\nfunction notFound(event: H3Event, error: string) {\n  setResponseStatus(event, 404);\n  return { error };\n}\n\nfunction errorResponse(event: H3Event, error: unknown) {\n  const statusCode =\n    typeof (error as { statusCode?: unknown })?.statusCode === \"number\"\n      ? (error as { statusCode: number }).statusCode\n      : 500;\n  setResponseStatus(event, statusCode);\n  return {\n    error: error instanceof Error ? error.message : String(error),\n  };\n}\n\nasync function readJsonBody<T>(event: H3Event): Promise<T> {\n  return ((await readBody(event).catch(() => ({}))) || {}) as T;\n}\n\nexport function mountBrowserSessionRoutes(\n  nitroApp: any,\n  options: MountBrowserSessionRoutesOptions = {},\n): void {\n  const routePrefix = options.routePrefix ?? \"/_agent-native\";\n  const basePath = `${routePrefix}/browser-sessions`;\n\n  getH3App(nitroApp).use(\n    basePath,\n    defineEventHandler(async (event: H3Event) => {\n      setResponseHeader(event, \"Cache-Control\", \"no-store\");\n\n      const method = getMethod(event);\n      const raw = (event.path || \"/\").split(\"?\")[0];\n      const segments = raw\n        .replace(/^\\/+/, \"\")\n        .split(\"/\")\n        .filter(Boolean)\n        .map(decodeSegment);\n\n      try {\n        const ownerEmail = await ownerFromEvent(event, options);\n\n        if (segments.length === 0) {\n          if (method === \"GET\") {\n            const sessions = await listBrowserSessions(ownerEmail);\n            return { ok: true, sessions };\n          }\n          if (method === \"POST\") {\n            const body =\n              await readJsonBody<RegisterAgentNativeBrowserSessionInput>(event);\n            const session = await registerBrowserSession(ownerEmail, body);\n            return { ok: true, session };\n          }\n          return methodNotAllowed(event);\n        }\n\n        const sessionId = segments[0];\n        if (!sessionId) return badRequest(event, \"sessionId is required\");\n\n        if (segments.length === 1) {\n          if (method === \"GET\") {\n            const session = await getBrowserSession(ownerEmail, sessionId, {\n              includeExpired: true,\n            });\n            return session\n              ? { ok: true, session }\n              : notFound(event, \"Session not found\");\n          }\n          if (method === \"DELETE\") {\n            const deleted = await disconnectBrowserSession(\n              ownerEmail,\n              sessionId,\n            );\n            return { ok: true, deleted };\n          }\n          return methodNotAllowed(event);\n        }\n\n        if (segments[1] === \"heartbeat\") {\n          if (method !== \"POST\") return methodNotAllowed(event);\n          const body =\n            await readJsonBody<RegisterAgentNativeBrowserSessionInput>(event);\n          const session = await registerBrowserSession(ownerEmail, {\n            ...body,\n            session: {\n              ...(body.session ?? {}),\n              id: sessionId,\n            },\n            sessionId,\n          });\n          return { ok: true, session };\n        }\n\n        if (segments[1] !== \"requests\") {\n          return notFound(event, \"Unknown browser-session route\");\n        }\n\n        if (segments.length === 2) {\n          if (method !== \"POST\") return methodNotAllowed(event);\n          const body = await readJsonBody<\n            CreateAgentNativeBrowserSessionRequestInput & { wait?: boolean }\n          >(event);\n          const request = await createBrowserSessionRequest(\n            ownerEmail,\n            sessionId,\n            body,\n          );\n          if (body.wait === true) {\n            const result = await waitForBrowserSessionRequest(\n              ownerEmail,\n              request.id,\n              { timeoutMs: body.timeoutMs },\n            );\n            return { ok: true, requestId: request.id, result };\n          }\n          return { ok: true, request };\n        }\n\n        if (segments.length === 3 && segments[2] === \"claim\") {\n          if (method !== \"POST\") return methodNotAllowed(event);\n          const request = await claimBrowserSessionRequest(\n            ownerEmail,\n            sessionId,\n          );\n          return { ok: true, request };\n        }\n\n        const requestId = segments[2];\n        if (!requestId) return badRequest(event, \"requestId is required\");\n\n        if (segments.length === 3) {\n          if (method !== \"GET\") return methodNotAllowed(event);\n          const request = await getBrowserSessionRequest(ownerEmail, requestId);\n          return request\n            ? { ok: true, request }\n            : notFound(event, \"Request not found\");\n        }\n\n        if (segments.length === 4 && segments[3] === \"complete\") {\n          if (method !== \"POST\") return methodNotAllowed(event);\n          const body = await readJsonBody<{\n            ok?: boolean;\n            result?: unknown;\n            error?: string;\n          }>(event);\n          const request = await completeBrowserSessionRequest(\n            ownerEmail,\n            sessionId,\n            requestId,\n            body.ok === false\n              ? { ok: false, error: body.error, result: body.result }\n              : { ok: true, result: body.result },\n          );\n          return { ok: true, request };\n        }\n\n        return notFound(event, \"Unknown browser-session route\");\n      } catch (error) {\n        return errorResponse(event, error);\n      }\n    }),\n  );\n}\n"]}

package/dist/browser-sessions/store.d.ts

@@ -0,0 +1,33 @@
+import type { AgentNativeBrowserSessionRecord, AgentNativeBrowserSessionRequest, CreateAgentNativeBrowserSessionRequestInput, RegisterAgentNativeBrowserSessionInput } from "./types.js";
+export declare const DEFAULT_BROWSER_SESSION_TTL_MS = 45000;
+export declare const DEFAULT_BROWSER_SESSION_REQUEST_TIMEOUT_MS = 30000;
+export declare const DEFAULT_BROWSER_SESSION_REQUEST_POLL_MS = 250;
+export declare function registerBrowserSession(ownerEmailInput: string, input: RegisterAgentNativeBrowserSessionInput): Promise<AgentNativeBrowserSessionRecord>;
+export declare function listBrowserSessions(ownerEmailInput: string, options?: {
+    includeExpired?: boolean;
+    limit?: number;
+}): Promise<AgentNativeBrowserSessionRecord[]>;
+export declare function getBrowserSession(ownerEmailInput: string, sessionIdInput: string, options?: {
+    includeExpired?: boolean;
+}): Promise<AgentNativeBrowserSessionRecord | null>;
+export declare function disconnectBrowserSession(ownerEmailInput: string, sessionIdInput: string): Promise<boolean>;
+export declare function createBrowserSessionRequest(ownerEmailInput: string, sessionIdInput: string, input: CreateAgentNativeBrowserSessionRequestInput): Promise<AgentNativeBrowserSessionRequest>;
+export declare function getBrowserSessionRequest(ownerEmailInput: string, requestIdInput: string): Promise<AgentNativeBrowserSessionRequest | null>;
+export declare function claimBrowserSessionRequest(ownerEmailInput: string, sessionIdInput: string): Promise<AgentNativeBrowserSessionRequest | null>;
+export declare function completeBrowserSessionRequest(ownerEmailInput: string, sessionIdInput: string, requestIdInput: string, result: {
+    ok: true;
+    result?: unknown;
+} | {
+    ok: false;
+    error?: string;
+    result?: unknown;
+}): Promise<AgentNativeBrowserSessionRequest>;
+export declare function waitForBrowserSessionRequest(ownerEmailInput: string, requestIdInput: string, options?: {
+    timeoutMs?: number;
+    pollMs?: number;
+}): Promise<unknown>;
+export declare function callBrowserSession(ownerEmailInput: string, sessionIdInput: string, input: CreateAgentNativeBrowserSessionRequestInput, options?: {
+    timeoutMs?: number;
+    pollMs?: number;
+}): Promise<unknown>;
+//# sourceMappingURL=store.d.ts.map

package/dist/browser-sessions/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/browser-sessions/store.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGV,+BAA+B,EAC/B,gCAAgC,EAGhC,2CAA2C,EAC3C,sCAAsC,EACvC,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,0CAA0C,QAAS,CAAC;AACjE,eAAO,MAAM,uCAAuC,MAAM,CAAC;AAmR3D,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,sCAAsC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,CA2C1C;AAED,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAqB5C;AAED,wBAAsB,iBAAiB,CACrC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAYjD;AAED,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AA8CD,wBAAsB,2BAA2B,CAC/C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,2CAA2C,GACjD,OAAO,CAAC,gCAAgC,CAAC,CAqC3C;AAED,wBAAsB,wBAAwB,CAC5C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAUlD;AAED,wBAAsB,0BAA0B,CAC9C,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CA6BlD;AAED,wBAAsB,6BAA6B,CACjD,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,MAAM,EACF;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,OAAO,CAAC,gCAAgC,CAAC,CAoC3C;AAED,wBAAsB,4BAA4B,CAChD,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,OAAO,CAAC,CAyClB;AAED,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,2CAA2C,EAClD,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,OAAO,CAAC,CAalB"}