@getpaseo/protocol 0.1.103 → 0.1.104-beta.1

package/dist/browser-automation/rpc-schemas.js

@@ -0,0 +1,347 @@
+import { z } from "zod";
+export const BrowserAutomationErrorCodeSchema = z.enum([
+    "browser_disabled",
+    "browser_no_desktop",
+    "browser_tab_not_found",
+    "browser_tab_closed",
+    "browser_timeout",
+    "screenshot_no_frame",
+    "browser_denied",
+    "browser_unsupported",
+    "browser_stale_ref",
+    "browser_unknown_error",
+]);
+const BROWSER_AUTOMATION_BROWSER_ID_PATTERN = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|\d{13,}-[0-9a-f]+)$/i;
+const BROWSER_AUTOMATION_BROWSER_ID_MESSAGE = "browserId must be a real id returned by browser_new_tab or browser_list_tabs";
+const BROWSER_AUTOMATION_WAIT_CONDITION_MESSAGE = "browser_wait requires exactly one of text or url";
+export const BrowserAutomationBrowserIdSchema = z
+    .string({ error: () => BROWSER_AUTOMATION_BROWSER_ID_MESSAGE })
+    .min(1, BROWSER_AUTOMATION_BROWSER_ID_MESSAGE)
+    .regex(BROWSER_AUTOMATION_BROWSER_ID_PATTERN, BROWSER_AUTOMATION_BROWSER_ID_MESSAGE);
+const BrowserAutomationTabTargetSchema = z
+    .object({
+    browserId: BrowserAutomationBrowserIdSchema,
+})
+    .strict();
+const BrowserAutomationRefSchema = z.string().regex(/^@e\d+$/);
+const BrowserAutomationHttpUrlSchema = z
+    .string()
+    .url()
+    .refine((value) => {
+    const protocol = new URL(value).protocol;
+    return protocol === "http:" || protocol === "https:";
+}, "URL must use http or https");
+export const BrowserAutomationListTabsCommandSchema = z.object({
+    command: z.literal("list_tabs"),
+    args: z.object({}).strict().default({}),
+});
+export const BrowserAutomationNewTabCommandSchema = z.object({
+    command: z.literal("new_tab"),
+    args: z
+        .object({
+        url: BrowserAutomationHttpUrlSchema.optional(),
+    })
+        .strict()
+        .default({}),
+});
+export const BrowserAutomationSnapshotCommandSchema = z.object({
+    command: z.literal("snapshot"),
+    args: BrowserAutomationTabTargetSchema,
+});
+export const BrowserAutomationClickCommandSchema = z.object({
+    command: z.literal("click"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        ref: BrowserAutomationRefSchema,
+    }),
+});
+export const BrowserAutomationFillCommandSchema = z.object({
+    command: z.literal("fill"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        ref: BrowserAutomationRefSchema,
+        value: z.string(),
+    }),
+});
+export const BrowserAutomationWaitCommandSchema = z.object({
+    command: z.literal("wait"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        text: z.string().min(1).optional(),
+        url: z.string().min(1).optional(),
+        timeoutMs: z.number().int().positive().max(30000).optional(),
+    }).refine((args) => Number(Boolean(args.text)) + Number(Boolean(args.url)) === 1, {
+        message: BROWSER_AUTOMATION_WAIT_CONDITION_MESSAGE,
+    }),
+});
+export const BrowserAutomationTypeCommandSchema = z.object({
+    command: z.literal("type"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        ref: BrowserAutomationRefSchema.optional(),
+        text: z.string(),
+    }),
+});
+export const BrowserAutomationKeypressCommandSchema = z.object({
+    command: z.literal("keypress"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        ref: BrowserAutomationRefSchema.optional(),
+        key: z.string().min(1),
+    }),
+});
+export const BrowserAutomationNavigateCommandSchema = z.object({
+    command: z.literal("navigate"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        url: BrowserAutomationHttpUrlSchema,
+    }),
+});
+export const BrowserAutomationBackCommandSchema = z.object({
+    command: z.literal("back"),
+    args: BrowserAutomationTabTargetSchema,
+});
+export const BrowserAutomationForwardCommandSchema = z.object({
+    command: z.literal("forward"),
+    args: BrowserAutomationTabTargetSchema,
+});
+export const BrowserAutomationReloadCommandSchema = z.object({
+    command: z.literal("reload"),
+    args: BrowserAutomationTabTargetSchema,
+});
+export const BrowserAutomationScreenshotCommandSchema = z.object({
+    command: z.literal("screenshot"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        fullPage: z.boolean().default(false),
+    }),
+});
+export const BrowserAutomationUploadCommandSchema = z.object({
+    command: z.literal("upload"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        ref: BrowserAutomationRefSchema,
+        filePaths: z.array(z.string().min(1)).min(1),
+    }),
+});
+export const BrowserAutomationSelectCommandSchema = z.object({
+    command: z.literal("select"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        ref: BrowserAutomationRefSchema,
+        value: z.string(),
+    }),
+});
+export const BrowserAutomationHoverCommandSchema = z.object({
+    command: z.literal("hover"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        ref: BrowserAutomationRefSchema,
+    }),
+});
+export const BrowserAutomationDragCommandSchema = z.object({
+    command: z.literal("drag"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        sourceRef: BrowserAutomationRefSchema,
+        targetRef: BrowserAutomationRefSchema,
+    }),
+});
+export const BrowserAutomationLogsCommandSchema = z.object({
+    command: z.literal("logs"),
+    args: BrowserAutomationTabTargetSchema.extend({
+        maxEntries: z.number().int().positive().max(200).default(50),
+    }),
+});
+export const BrowserAutomationCommandSchema = z.discriminatedUnion("command", [
+    BrowserAutomationListTabsCommandSchema,
+    BrowserAutomationNewTabCommandSchema,
+    BrowserAutomationSnapshotCommandSchema,
+    BrowserAutomationClickCommandSchema,
+    BrowserAutomationFillCommandSchema,
+    BrowserAutomationWaitCommandSchema,
+    BrowserAutomationTypeCommandSchema,
+    BrowserAutomationKeypressCommandSchema,
+    BrowserAutomationNavigateCommandSchema,
+    BrowserAutomationBackCommandSchema,
+    BrowserAutomationForwardCommandSchema,
+    BrowserAutomationReloadCommandSchema,
+    BrowserAutomationScreenshotCommandSchema,
+    BrowserAutomationUploadCommandSchema,
+    BrowserAutomationSelectCommandSchema,
+    BrowserAutomationHoverCommandSchema,
+    BrowserAutomationDragCommandSchema,
+    BrowserAutomationLogsCommandSchema,
+]);
+export const BrowserAutomationTabInfoSchema = z.object({
+    browserId: BrowserAutomationBrowserIdSchema,
+    workspaceId: z.string().min(1).optional(),
+    url: z.string(),
+    title: z.string(),
+    isActive: z.boolean().default(false),
+    isLoading: z.boolean().default(false),
+    canGoBack: z.boolean().optional(),
+    canGoForward: z.boolean().optional(),
+});
+export const BrowserAutomationListTabsResultSchema = z.object({
+    command: z.literal("list_tabs"),
+    tabs: z.array(BrowserAutomationTabInfoSchema),
+});
+export const BrowserAutomationNewTabResultSchema = z.object({
+    command: z.literal("new_tab"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    workspaceId: z.string().min(1),
+    url: z.string().min(1),
+});
+export const BrowserAutomationSnapshotElementSchema = z.object({
+    ref: z.string().regex(/^@e\d+$/),
+    role: z.string(),
+    tagName: z.string(),
+    text: z.string(),
+    selector: z.string(),
+    attributes: z.record(z.string(), z.string()).default({}),
+});
+export const BrowserAutomationSnapshotResultSchema = z.object({
+    command: z.literal("snapshot"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    workspaceId: z.string().min(1).optional(),
+    url: z.string(),
+    title: z.string(),
+    elements: z.array(BrowserAutomationSnapshotElementSchema),
+});
+export const BrowserAutomationClickResultSchema = z.object({
+    command: z.literal("click"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    ref: BrowserAutomationRefSchema,
+});
+export const BrowserAutomationFillResultSchema = z.object({
+    command: z.literal("fill"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    ref: BrowserAutomationRefSchema,
+});
+export const BrowserAutomationWaitResultSchema = z.object({
+    command: z.literal("wait"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    matched: z.enum(["text", "url"]),
+});
+export const BrowserAutomationTypeResultSchema = z.object({
+    command: z.literal("type"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    ref: BrowserAutomationRefSchema.optional(),
+});
+export const BrowserAutomationKeypressResultSchema = z.object({
+    command: z.literal("keypress"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    key: z.string().min(1),
+    ref: BrowserAutomationRefSchema.optional(),
+});
+export const BrowserAutomationNavigateResultSchema = z.object({
+    command: z.literal("navigate"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    url: z.string().min(1),
+});
+export const BrowserAutomationBackResultSchema = z.object({
+    command: z.literal("back"),
+    browserId: BrowserAutomationBrowserIdSchema,
+});
+export const BrowserAutomationForwardResultSchema = z.object({
+    command: z.literal("forward"),
+    browserId: BrowserAutomationBrowserIdSchema,
+});
+export const BrowserAutomationReloadResultSchema = z.object({
+    command: z.literal("reload"),
+    browserId: BrowserAutomationBrowserIdSchema,
+});
+export const BrowserAutomationScreenshotResultSchema = z.object({
+    command: z.literal("screenshot"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    mimeType: z.literal("image/png"),
+    dataBase64: z.string().min(1),
+    width: z.number().int().nonnegative(),
+    height: z.number().int().nonnegative(),
+});
+export const BrowserAutomationUploadResultSchema = z.object({
+    command: z.literal("upload"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    ref: BrowserAutomationRefSchema,
+    filePaths: z.array(z.string().min(1)).min(1),
+});
+export const BrowserAutomationSelectResultSchema = z.object({
+    command: z.literal("select"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    ref: BrowserAutomationRefSchema,
+    value: z.string(),
+});
+export const BrowserAutomationHoverResultSchema = z.object({
+    command: z.literal("hover"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    ref: BrowserAutomationRefSchema,
+});
+export const BrowserAutomationDragResultSchema = z.object({
+    command: z.literal("drag"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    sourceRef: BrowserAutomationRefSchema,
+    targetRef: BrowserAutomationRefSchema,
+});
+export const BrowserAutomationConsoleLogEntrySchema = z.object({
+    level: z.string(),
+    message: z.string(),
+    source: z.string().optional(),
+    line: z.number().int().optional(),
+    timestamp: z.number(),
+});
+export const BrowserAutomationNetworkLogEntrySchema = z.object({
+    url: z.string(),
+    method: z.string().optional(),
+    status: z.number().int().optional(),
+    type: z.string().optional(),
+    startTime: z.number(),
+    duration: z.number(),
+    transferSize: z.number().optional(),
+});
+export const BrowserAutomationLogsResultSchema = z.object({
+    command: z.literal("logs"),
+    browserId: BrowserAutomationBrowserIdSchema,
+    console: z.array(BrowserAutomationConsoleLogEntrySchema),
+    network: z.array(BrowserAutomationNetworkLogEntrySchema),
+});
+export const BrowserAutomationResultSchema = z.discriminatedUnion("command", [
+    BrowserAutomationListTabsResultSchema,
+    BrowserAutomationNewTabResultSchema,
+    BrowserAutomationSnapshotResultSchema,
+    BrowserAutomationClickResultSchema,
+    BrowserAutomationFillResultSchema,
+    BrowserAutomationWaitResultSchema,
+    BrowserAutomationTypeResultSchema,
+    BrowserAutomationKeypressResultSchema,
+    BrowserAutomationNavigateResultSchema,
+    BrowserAutomationBackResultSchema,
+    BrowserAutomationForwardResultSchema,
+    BrowserAutomationReloadResultSchema,
+    BrowserAutomationScreenshotResultSchema,
+    BrowserAutomationUploadResultSchema,
+    BrowserAutomationSelectResultSchema,
+    BrowserAutomationHoverResultSchema,
+    BrowserAutomationDragResultSchema,
+    BrowserAutomationLogsResultSchema,
+]);
+export const BrowserAutomationErrorSchema = z.object({
+    code: BrowserAutomationErrorCodeSchema,
+    message: z.string().min(1),
+    retryable: z.boolean().default(false),
+});
+export const BrowserAutomationExecuteRequestSchema = z
+    .object({
+    type: z.literal("browser.automation.execute.request"),
+    requestId: z.string().min(1),
+    agentId: z.string().min(1).optional(),
+    cwd: z.string().min(1).optional(),
+    workspaceId: z.string().min(1).optional(),
+    command: BrowserAutomationCommandSchema,
+})
+    .strict();
+export const BrowserAutomationExecuteResponseSchema = z.object({
+    type: z.literal("browser.automation.execute.response"),
+    payload: z.discriminatedUnion("ok", [
+        z.object({
+            requestId: z.string().min(1),
+            ok: z.literal(true),
+            result: BrowserAutomationResultSchema,
+        }),
+        z.object({
+            requestId: z.string().min(1),
+            ok: z.literal(false),
+            error: BrowserAutomationErrorSchema,
+        }),
+    ]),
+});
+//# sourceMappingURL=rpc-schemas.js.map

package/dist/client-capabilities.d.ts

@@ -2,6 +2,7 @@ export declare const CLIENT_CAPS: {
     readonly reasoningMergeEnum: "reasoning_merge_enum";
     readonly customModeIcons: "custom_mode_icons";
     readonly terminalReflowableSnapshot: "terminal_reflowable_snapshot";
+    readonly desktopBrowserAutomation: "desktop_browser_automation";
 };
 export type ClientCapability = (typeof CLIENT_CAPS)[keyof typeof CLIENT_CAPS];
 //# sourceMappingURL=client-capabilities.d.ts.map

package/dist/client-capabilities.js

@@ -11,5 +11,6 @@ export const CLIENT_CAPS = {
     // Old clients use a strict TerminalState schema and would reject the extra fields.
     // Drop the gate (always send the flags) when floor >= v0.1.88.
     terminalReflowableSnapshot: "terminal_reflowable_snapshot",
+    desktopBrowserAutomation: "desktop_browser_automation",
 };
 //# sourceMappingURL=client-capabilities.js.map