@paperclipai/shared 2026.1001.0 → 2026.1002.0-beta.0

package/dist/browser-use.d.ts

@@ -0,0 +1,107 @@
+import { z } from "zod";
+export declare const BROWSER_USE_API_URL = "https://api.browser-use.com/api/v4";
+export declare const BROWSER_USE_IDLE_MS: number;
+/** Remote viewport dimensions, not Paperclip layout tokens. */
+export declare const BROWSER_USE_VIEWPORT_PRESETS: readonly [{
+    readonly id: "phone";
+    readonly label: "Phone";
+    readonly width: 390;
+    readonly height: 844;
+}, {
+    readonly id: "tablet";
+    readonly label: "Tablet";
+    readonly width: 768;
+    readonly height: 1024;
+}, {
+    readonly id: "laptop";
+    readonly label: "Laptop";
+    readonly width: 1280;
+    readonly height: 800;
+}, {
+    readonly id: "desktop";
+    readonly label: "Desktop";
+    readonly width: 1440;
+    readonly height: 900;
+}];
+export declare const browserUseViewportPresetSchema: z.ZodEnum<{
+    default: "default";
+    desktop: "desktop";
+    fit: "fit";
+    laptop: "laptop";
+    phone: "phone";
+    tablet: "tablet";
+}>;
+export type BrowserUseViewportPreset = z.infer<typeof browserUseViewportPresetSchema>;
+export declare const browserUseViewerSchema: z.ZodObject<{
+    viewerId: z.ZodString;
+}, z.core.$strict>;
+export declare const browserUseViewportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    preset: z.ZodLiteral<"fit">;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    viewerId: z.ZodString;
+    takeControl: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    preset: z.ZodEnum<{
+        default: "default";
+        desktop: "desktop";
+        laptop: "laptop";
+        phone: "phone";
+        tablet: "tablet";
+    }>;
+    viewerId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "preset">;
+export type BrowserUseViewportRequest = z.infer<typeof browserUseViewportSchema>;
+export interface BrowserUseViewportState {
+    preset: BrowserUseViewportPreset;
+    width?: number;
+    height?: number;
+    controlledElsewhere?: boolean;
+    /** True only when remote metrics changed (lease renewals do not create audit noise). */
+    applied?: boolean;
+}
+export declare const browserUseSettingsSchema: z.ZodObject<{
+    allowedProfileIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    maxCostUsd: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type BrowserUseSettings = z.infer<typeof browserUseSettingsSchema>;
+export declare const browserUseControlSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        cancel: "cancel";
+        end: "end";
+        keep_open: "keep_open";
+    }>;
+}, z.core.$strict>;
+export type BrowserUseControl = z.infer<typeof browserUseControlSchema>["action"];
+export interface TaskBrowser {
+    id: string;
+    sessionId: string;
+    issueId: string;
+    status: "starting" | "running" | "idle" | "stopping" | "closed" | "failed";
+    runStatus: string | null;
+    progress: string | null;
+    costCents: number;
+    idleDeadline: string | null;
+    expiresAt: string | null;
+    error: string | null;
+    createdAt: string;
+}
+/** Reviewed v4 catalog. Never proxy arbitrary provider paths or request bodies. */
+export declare const BROWSER_USE_TOOLS: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, unknown>;
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+}[];
+//# sourceMappingURL=browser-use.d.ts.map

package/dist/browser-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-use.d.ts","sourceRoot":"","sources":["../src/browser-use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB,uCAAuC,CAAC;AACxE,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AAClD,+DAA+D;AAC/D,eAAO,MAAM,4BAA4B;aACrC,EAAE,EAAE,OAAO;aAAE,KAAK,EAAE,OAAO;aAAE,KAAK,EAAE,GAAG;aAAE,MAAM,EAAE,GAAG;;aACpD,EAAE,EAAE,QAAQ;aAAE,KAAK,EAAE,QAAQ;aAAE,KAAK,EAAE,GAAG;aAAE,MAAM,EAAE,IAAI;;aACvD,EAAE,EAAE,QAAQ;aAAE,KAAK,EAAE,QAAQ;aAAE,KAAK,EAAE,IAAI;aAAE,MAAM,EAAE,GAAG;;aACvD,EAAE,EAAE,SAAS;aAAE,KAAK,EAAE,SAAS;aAAE,KAAK,EAAE,IAAI;aAAE,MAAM,EAAE,GAAG;EACnD,CAAC;AACX,eAAO,MAAM,8BAA8B;;;;;;;EAOzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AACF,eAAO,MAAM,sBAAsB;;kBAExB,CAAC;AACZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;8BAgBnC,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,wBAAwB,CAChC,CAAC;AACF,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,wBAAwB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AACD,eAAO,MAAM,wBAAwB;;;kBAK1B,CAAC;AACZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,eAAO,MAAM,uBAAuB;;;;;;kBAIzB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CACrC,OAAO,uBAAuB,CAC/B,CAAC,QAAQ,CAAC,CAAC;AACZ,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAsCD,mFAAmF;AACnF,eAAO,MAAM,iBAAiB;;;;;;;;;;;QARxB,YAAY;QACZ,eAAe;QACf,cAAc;QACd,aAAa;;GA2DlB,CAAC"}

package/dist/browser-use.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+export const BROWSER_USE_API_URL = "https://api.browser-use.com/api/v4";
+export const BROWSER_USE_IDLE_MS = 10 * 60 * 1000;
+/** Remote viewport dimensions, not Paperclip layout tokens. */
+export const BROWSER_USE_VIEWPORT_PRESETS = [
+    { id: "phone", label: "Phone", width: 390, height: 844 },
+    { id: "tablet", label: "Tablet", width: 768, height: 1024 },
+    { id: "laptop", label: "Laptop", width: 1280, height: 800 },
+    { id: "desktop", label: "Desktop", width: 1440, height: 900 },
+];
+export const browserUseViewportPresetSchema = z.enum([
+    "fit",
+    "default",
+    "phone",
+    "tablet",
+    "laptop",
+    "desktop",
+]);
+export const browserUseViewerSchema = z
+    .object({ viewerId: z.string().uuid() })
+    .strict();
+export const browserUseViewportSchema = z.discriminatedUnion("preset", [
+    z
+        .object({
+        preset: z.literal("fit"),
+        width: z.number().int().min(1).max(6144),
+        height: z.number().int().min(1).max(3456),
+        viewerId: z.string().uuid(),
+        takeControl: z.boolean().optional(),
+    })
+        .strict(),
+    z
+        .object({
+        preset: z.enum(["default", "phone", "tablet", "laptop", "desktop"]),
+        viewerId: z.string().uuid().optional(),
+    })
+        .strict(),
+]);
+export const browserUseSettingsSchema = z
+    .object({
+    allowedProfileIds: z.array(z.string().uuid()).max(100).default([]),
+    maxCostUsd: z.number().positive().finite().nullable().default(null),
+})
+    .strict();
+export const browserUseControlSchema = z
+    .object({
+    action: z.enum(["cancel", "end", "keep_open"]),
+})
+    .strict();
+const session = {
+    type: "string",
+    format: "uuid",
+    description: "Paperclip browser conversation ID, never a provider ID.",
+};
+const task = {
+    type: "string",
+    minLength: 1,
+    maxLength: 30000,
+    description: "The browser task to delegate.",
+};
+function tool(name, description, properties, required, read = false) {
+    return {
+        name,
+        title: name.replaceAll("_", " "),
+        description,
+        inputSchema: {
+            type: "object",
+            properties,
+            required,
+            additionalProperties: false,
+        },
+        annotations: {
+            readOnlyHint: read,
+            destructiveHint: !read,
+            idempotentHint: read,
+            openWorldHint: !read,
+        },
+    };
+}
+/** Reviewed v4 catalog. Never proxy arbitrary provider paths or request bodies. */
+export const BROWSER_USE_TOOLS = [
+    tool("browser_start", "Delegate a hosted browser task. The human can watch and interact in the task's Browser tab. Poll browser_status until finished; do not end your Paperclip run while the task is active.", {
+        task,
+        profileId: { type: "string", format: "uuid" },
+        maxCostUsd: { type: "number", exclusiveMinimum: 0 },
+    }, ["task"]),
+    tool("browser_status", "Read the owned conversation's run result and sanitized progress.", { sessionId: session }, ["sessionId"], true),
+    tool("browser_continue", "Continue an idle owned conversation. Busy sessions reject new work. Use a normal task message to request followup work.", {
+        sessionId: session,
+        task,
+        maxCostUsd: { type: "number", exclusiveMinimum: 0 },
+    }, ["sessionId", "task"]),
+    tool("browser_cancel", "Request cancellation of the active agent run. The browser stays open until expiry or browser_end.", { sessionId: session }, ["sessionId"]),
+    tool("browser_end", "Cancel active work and stop all browsers belonging to this conversation.", { sessionId: session }, ["sessionId"]),
+    tool("browser_sessions", "List only browser conversations owned by this task, agent and credential grant.", {}, [], true),
+    tool("browser_profiles", "List existing profiles explicitly allowed for this credential. Omit profileId for a fresh browser.", {}, [], true),
+];
+//# sourceMappingURL=browser-use.js.map

package/dist/browser-use.js.map

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