@bctrl/sdk 1.0.1

package/dist/contracts/automation.d.ts

@@ -0,0 +1,265 @@
+import { z } from 'zod';
+export declare const AUTOMATION_ALIAS_REGEX: RegExp;
+export declare const AutomationCallOptionsSchema: z.ZodObject<{
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    logs: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        capture: "capture";
+    }>>;
+    scriptId: z.ZodOptional<z.ZodString>;
+    scriptName: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const AutomationCallRequestSchema: z.ZodObject<{
+    call: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    as: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodObject<{
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        dryRun: z.ZodOptional<z.ZodBoolean>;
+        logs: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            capture: "capture";
+        }>>;
+        scriptId: z.ZodOptional<z.ZodString>;
+        scriptName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AutomationCallRequest = z.infer<typeof AutomationCallRequestSchema>;
+export declare const AutomationBindingTypeSchema: z.ZodEnum<{
+    page: "page";
+    context: "context";
+    handle: "handle";
+    subscription: "subscription";
+}>;
+export type AutomationBindingType = z.infer<typeof AutomationBindingTypeSchema>;
+export declare const AutomationResolvedSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    call: z.ZodString;
+    target: z.ZodString;
+    method: z.ZodString;
+    ref: z.ZodNullable<z.ZodString>;
+    pageId: z.ZodNullable<z.ZodString>;
+    contextId: z.ZodNullable<z.ZodString>;
+    handleId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type AutomationResolved = z.infer<typeof AutomationResolvedSchema>;
+export declare const AutomationBindingSchema: z.ZodObject<{
+    alias: z.ZodString;
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        page: "page";
+        context: "context";
+        handle: "handle";
+        subscription: "subscription";
+    }>;
+}, z.core.$strict>;
+export type AutomationBinding = z.infer<typeof AutomationBindingSchema>;
+export declare const AutomationErrorCodeSchema: z.ZodEnum<{
+    UNKNOWN_CALL: "UNKNOWN_CALL";
+    UNKNOWN_REF: "UNKNOWN_REF";
+    INVALID_ARGS: "INVALID_ARGS";
+    CAPABILITY_NOT_AVAILABLE: "CAPABILITY_NOT_AVAILABLE";
+    TIMEOUT: "TIMEOUT";
+    SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+    DRIVER_NOT_CONNECTED: "DRIVER_NOT_CONNECTED";
+    SUBSCRIPTION_CURSOR_CONFLICT: "SUBSCRIPTION_CURSOR_CONFLICT";
+    SUBSCRIPTION_GONE: "SUBSCRIPTION_GONE";
+}>;
+export type AutomationErrorCode = z.infer<typeof AutomationErrorCodeSchema>;
+export declare const AutomationFixSchema: z.ZodObject<{
+    title: z.ZodString;
+    command: z.ZodOptional<z.ZodString>;
+    example: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AutomationFix = z.infer<typeof AutomationFixSchema>;
+export declare const AutomationDiagnosticSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodEnum<{
+        "arg-shape": "arg-shape";
+        semantic: "semantic";
+        runtime: "runtime";
+    }>>;
+    call: z.ZodOptional<z.ZodString>;
+    driver: z.ZodOptional<z.ZodString>;
+    closest: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    expected: z.ZodOptional<z.ZodString>;
+    received: z.ZodOptional<z.ZodString>;
+    docsUrl: z.ZodOptional<z.ZodString>;
+    fixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        command: z.ZodOptional<z.ZodString>;
+        example: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type AutomationDiagnostic = z.infer<typeof AutomationDiagnosticSchema>;
+export declare const AutomationErrorSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        UNKNOWN_CALL: "UNKNOWN_CALL";
+        UNKNOWN_REF: "UNKNOWN_REF";
+        INVALID_ARGS: "INVALID_ARGS";
+        CAPABILITY_NOT_AVAILABLE: "CAPABILITY_NOT_AVAILABLE";
+        TIMEOUT: "TIMEOUT";
+        SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+        DRIVER_NOT_CONNECTED: "DRIVER_NOT_CONNECTED";
+        SUBSCRIPTION_CURSOR_CONFLICT: "SUBSCRIPTION_CURSOR_CONFLICT";
+        SUBSCRIPTION_GONE: "SUBSCRIPTION_GONE";
+    }>;
+    message: z.ZodString;
+    hint: z.ZodOptional<z.ZodString>;
+    diagnostic: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodEnum<{
+            "arg-shape": "arg-shape";
+            semantic: "semantic";
+            runtime: "runtime";
+        }>>;
+        call: z.ZodOptional<z.ZodString>;
+        driver: z.ZodOptional<z.ZodString>;
+        closest: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        expected: z.ZodOptional<z.ZodString>;
+        received: z.ZodOptional<z.ZodString>;
+        docsUrl: z.ZodOptional<z.ZodString>;
+        fixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            command: z.ZodOptional<z.ZodString>;
+            example: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AutomationError = z.infer<typeof AutomationErrorSchema>;
+export declare const AutomationSuccessResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    result: z.ZodUnknown;
+    resolved: z.ZodObject<{
+        sessionId: z.ZodString;
+        call: z.ZodString;
+        target: z.ZodString;
+        method: z.ZodString;
+        ref: z.ZodNullable<z.ZodString>;
+        pageId: z.ZodNullable<z.ZodString>;
+        contextId: z.ZodNullable<z.ZodString>;
+        handleId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    binding: z.ZodOptional<z.ZodObject<{
+        alias: z.ZodString;
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            page: "page";
+            context: "context";
+            handle: "handle";
+            subscription: "subscription";
+        }>;
+    }, z.core.$strict>>;
+    meta: z.ZodOptional<z.ZodObject<{
+        deprecatedAlias: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AutomationSuccessResponse = z.infer<typeof AutomationSuccessResponseSchema>;
+export declare const AutomationErrorResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            UNKNOWN_CALL: "UNKNOWN_CALL";
+            UNKNOWN_REF: "UNKNOWN_REF";
+            INVALID_ARGS: "INVALID_ARGS";
+            CAPABILITY_NOT_AVAILABLE: "CAPABILITY_NOT_AVAILABLE";
+            TIMEOUT: "TIMEOUT";
+            SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+            DRIVER_NOT_CONNECTED: "DRIVER_NOT_CONNECTED";
+            SUBSCRIPTION_CURSOR_CONFLICT: "SUBSCRIPTION_CURSOR_CONFLICT";
+            SUBSCRIPTION_GONE: "SUBSCRIPTION_GONE";
+        }>;
+        message: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+        diagnostic: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+            category: z.ZodOptional<z.ZodEnum<{
+                "arg-shape": "arg-shape";
+                semantic: "semantic";
+                runtime: "runtime";
+            }>>;
+            call: z.ZodOptional<z.ZodString>;
+            driver: z.ZodOptional<z.ZodString>;
+            closest: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            expected: z.ZodOptional<z.ZodString>;
+            received: z.ZodOptional<z.ZodString>;
+            docsUrl: z.ZodOptional<z.ZodString>;
+            fixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                command: z.ZodOptional<z.ZodString>;
+                example: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type AutomationErrorResponse = z.infer<typeof AutomationErrorResponseSchema>;
+export declare const AutomationResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    result: z.ZodUnknown;
+    resolved: z.ZodObject<{
+        sessionId: z.ZodString;
+        call: z.ZodString;
+        target: z.ZodString;
+        method: z.ZodString;
+        ref: z.ZodNullable<z.ZodString>;
+        pageId: z.ZodNullable<z.ZodString>;
+        contextId: z.ZodNullable<z.ZodString>;
+        handleId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    binding: z.ZodOptional<z.ZodObject<{
+        alias: z.ZodString;
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            page: "page";
+            context: "context";
+            handle: "handle";
+            subscription: "subscription";
+        }>;
+    }, z.core.$strict>>;
+    meta: z.ZodOptional<z.ZodObject<{
+        deprecatedAlias: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            UNKNOWN_CALL: "UNKNOWN_CALL";
+            UNKNOWN_REF: "UNKNOWN_REF";
+            INVALID_ARGS: "INVALID_ARGS";
+            CAPABILITY_NOT_AVAILABLE: "CAPABILITY_NOT_AVAILABLE";
+            TIMEOUT: "TIMEOUT";
+            SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+            DRIVER_NOT_CONNECTED: "DRIVER_NOT_CONNECTED";
+            SUBSCRIPTION_CURSOR_CONFLICT: "SUBSCRIPTION_CURSOR_CONFLICT";
+            SUBSCRIPTION_GONE: "SUBSCRIPTION_GONE";
+        }>;
+        message: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+        diagnostic: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+            category: z.ZodOptional<z.ZodEnum<{
+                "arg-shape": "arg-shape";
+                semantic: "semantic";
+                runtime: "runtime";
+            }>>;
+            call: z.ZodOptional<z.ZodString>;
+            driver: z.ZodOptional<z.ZodString>;
+            closest: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            expected: z.ZodOptional<z.ZodString>;
+            received: z.ZodOptional<z.ZodString>;
+            docsUrl: z.ZodOptional<z.ZodString>;
+            fixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                command: z.ZodOptional<z.ZodString>;
+                example: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+export type AutomationResponse = z.infer<typeof AutomationResponseSchema>;

package/dist/contracts/automation.js

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+export const AUTOMATION_ALIAS_REGEX = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+export const AutomationCallOptionsSchema = z
+    .object({
+    timeoutMs: z.number().int().positive().max(10 * 60 * 1000).optional(),
+    dryRun: z.boolean().optional(),
+    logs: z.enum(['off', 'capture']).optional(),
+    scriptId: z.string().min(1).optional(),
+    scriptName: z.string().min(1).optional(),
+})
+    .strict();
+export const AutomationCallRequestSchema = z
+    .object({
+    call: z.string().min(1),
+    ref: z.string().min(1).optional(),
+    args: z.array(z.unknown()).optional(),
+    as: z.string().regex(AUTOMATION_ALIAS_REGEX).optional(),
+    options: AutomationCallOptionsSchema.optional(),
+})
+    .strict();
+export const AutomationBindingTypeSchema = z.enum([
+    'page',
+    'context',
+    'handle',
+    'subscription',
+]);
+export const AutomationResolvedSchema = z
+    .object({
+    sessionId: z.string(),
+    call: z.string(),
+    target: z.string(),
+    method: z.string(),
+    ref: z.string().nullable(),
+    pageId: z.string().nullable(),
+    contextId: z.string().nullable(),
+    handleId: z.string().nullable(),
+})
+    .strict();
+export const AutomationBindingSchema = z
+    .object({
+    alias: z.string().regex(AUTOMATION_ALIAS_REGEX),
+    id: z.string(),
+    type: AutomationBindingTypeSchema,
+})
+    .strict();
+export const AutomationErrorCodeSchema = z.enum([
+    'UNKNOWN_CALL',
+    'UNKNOWN_REF',
+    'INVALID_ARGS',
+    'CAPABILITY_NOT_AVAILABLE',
+    'TIMEOUT',
+    'SESSION_NOT_FOUND',
+    'DRIVER_NOT_CONNECTED',
+    'SUBSCRIPTION_CURSOR_CONFLICT',
+    'SUBSCRIPTION_GONE',
+]);
+export const AutomationFixSchema = z
+    .object({
+    title: z.string(),
+    command: z.string().optional(),
+    example: z.string().optional(),
+})
+    .strict();
+export const AutomationDiagnosticSchema = z
+    .object({
+    id: z.string(),
+    code: z.string().optional(),
+    category: z.enum(['arg-shape', 'semantic', 'runtime']).optional(),
+    call: z.string().optional(),
+    driver: z.string().optional(),
+    closest: z.array(z.string()).max(5).optional(),
+    expected: z.string().optional(),
+    received: z.string().optional(),
+    docsUrl: z.string().url().optional(),
+    fixes: z.array(AutomationFixSchema).optional(),
+})
+    .strict();
+export const AutomationErrorSchema = z
+    .object({
+    code: AutomationErrorCodeSchema,
+    message: z.string(),
+    hint: z.string().optional(),
+    diagnostic: AutomationDiagnosticSchema.optional(),
+})
+    .strict();
+export const AutomationSuccessResponseSchema = z
+    .object({
+    ok: z.literal(true),
+    result: z.unknown(),
+    resolved: AutomationResolvedSchema,
+    binding: AutomationBindingSchema.optional(),
+    meta: z
+        .object({
+        deprecatedAlias: z.string().optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+export const AutomationErrorResponseSchema = z
+    .object({
+    ok: z.literal(false),
+    error: AutomationErrorSchema,
+})
+    .strict();
+export const AutomationResponseSchema = z.union([
+    AutomationSuccessResponseSchema,
+    AutomationErrorResponseSchema,
+]);

package/dist/contracts/browser-management.d.ts

@@ -0,0 +1,179 @@
+import { z } from 'zod';
+export declare const BrowserProxySchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        http: "http";
+        socks5: "socks5";
+    }>;
+    host: z.ZodString;
+    port: z.ZodNumber;
+    username: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type BrowserProxy = z.infer<typeof BrowserProxySchema>;
+export declare const SessionProxySchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        http: "http";
+        socks5: "socks5";
+    }>;
+    host: z.ZodString;
+    port: z.ZodNumber;
+    username: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SessionProxy = BrowserProxy;
+export declare const SessionStartOptionsSchema: z.ZodObject<{
+    humanize: z.ZodOptional<z.ZodBoolean>;
+    humanizePersonaId: z.ZodOptional<z.ZodNumber>;
+    proxy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        type: z.ZodEnum<{
+            http: "http";
+            socks5: "socks5";
+        }>;
+        host: z.ZodString;
+        port: z.ZodNumber;
+        username: z.ZodOptional<z.ZodString>;
+        password: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    storage: z.ZodOptional<z.ZodObject<{
+        defaultWorkspace: z.ZodOptional<z.ZodString>;
+        allowedWorkspaces: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    solveCaptchas: z.ZodOptional<z.ZodBoolean>;
+    vault: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allowRawReads: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SessionStartOptions = z.infer<typeof SessionStartOptionsSchema>;
+export declare const ProfileSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    name: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const ProfileCreateOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ProfileListOptionsSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ProfileListResultSchema: z.ZodObject<{
+    profiles: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        name: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+}, z.core.$strip>;
+export type Profile = z.infer<typeof ProfileSchema>;
+export type ProfileCreateOptions = z.infer<typeof ProfileCreateOptionsSchema>;
+export type ProfileListOptions = z.infer<typeof ProfileListOptionsSchema>;
+export type ProfileListResult = z.infer<typeof ProfileListResultSchema>;
+export declare const ProfileStartRequestSchema: z.ZodObject<{
+    humanize: z.ZodOptional<z.ZodBoolean>;
+    proxy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        type: z.ZodEnum<{
+            http: "http";
+            socks5: "socks5";
+        }>;
+        host: z.ZodString;
+        port: z.ZodNumber;
+        username: z.ZodOptional<z.ZodString>;
+        password: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    storage: z.ZodOptional<z.ZodObject<{
+        defaultWorkspace: z.ZodOptional<z.ZodString>;
+        allowedWorkspaces: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ProfileStartRequest = z.infer<typeof ProfileStartRequestSchema>;
+export declare const ProfileConnectRequestSchema: z.ZodObject<{
+    driver: z.ZodOptional<z.ZodEnum<{
+        selenium: "selenium";
+        stagehand: "stagehand";
+        puppeteer: "puppeteer";
+        playwright: "playwright";
+    }>>;
+}, z.core.$strict>;
+export type ProfileConnectRequest = z.infer<typeof ProfileConnectRequestSchema>;
+export declare const ProfileStopResponseSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    stopped: z.ZodBoolean;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ProfileStopResponse = z.infer<typeof ProfileStopResponseSchema>;
+export declare const ProfileLifecycleStatusSchema: z.ZodObject<{
+    profileId: z.ZodString;
+    name: z.ZodString;
+    status: z.ZodEnum<{
+        stopped: "stopped";
+        running: "running";
+    }>;
+    browserRunning: z.ZodBoolean;
+    hostStatus: z.ZodNullable<z.ZodString>;
+    currentDriver: z.ZodNullable<z.ZodString>;
+    activeSessionId: z.ZodNullable<z.ZodString>;
+    defaultContextId: z.ZodNullable<z.ZodString>;
+    defaultPageId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodNullable<z.ZodString>;
+    lastUsedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type ProfileLifecycleStatus = z.infer<typeof ProfileLifecycleStatusSchema>;
+export declare const SessionStartRequestSchema: z.ZodObject<{
+    humanize: z.ZodOptional<z.ZodBoolean>;
+    humanizePersonaId: z.ZodOptional<z.ZodNumber>;
+    proxy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        type: z.ZodEnum<{
+            http: "http";
+            socks5: "socks5";
+        }>;
+        host: z.ZodString;
+        port: z.ZodNumber;
+        username: z.ZodOptional<z.ZodString>;
+        password: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    storage: z.ZodOptional<z.ZodObject<{
+        defaultWorkspace: z.ZodOptional<z.ZodString>;
+        allowedWorkspaces: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    solveCaptchas: z.ZodOptional<z.ZodBoolean>;
+    vault: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allowRawReads: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SessionStartRequest = z.infer<typeof SessionStartRequestSchema>;
+export declare const SessionStartResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    status: z.ZodEnum<{
+        stopped: "stopped";
+        active: "active";
+    }>;
+    storageWorkspace: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SessionStartResponse = z.infer<typeof SessionStartResponseSchema>;
+export declare const SessionConnectRequestSchema: z.ZodObject<{
+    driver: z.ZodOptional<z.ZodEnum<{
+        selenium: "selenium";
+        stagehand: "stagehand";
+        puppeteer: "puppeteer";
+        playwright: "playwright";
+    }>>;
+}, z.core.$strict>;
+export type SessionConnectRequest = z.infer<typeof SessionConnectRequestSchema>;
+export declare const SessionConnectResponseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    currentDriver: z.ZodEnum<{
+        selenium: "selenium";
+        stagehand: "stagehand";
+        puppeteer: "puppeteer";
+        playwright: "playwright";
+    }>;
+    defaultContextId: z.ZodOptional<z.ZodUUID>;
+    defaultPageId: z.ZodOptional<z.ZodUUID>;
+    storageWorkspace: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SessionConnectResponse = z.infer<typeof SessionConnectResponseSchema>;

package/dist/contracts/browser-management.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+import { BrowserDriverSchema } from './runtime.js';
+import { SessionStoragePolicySchema } from './storage.js';
+import { VaultSessionPolicySchema } from './vault.js';
+export const BrowserProxySchema = z
+    .object({
+    type: z.enum(['http', 'socks5']),
+    host: z.string().min(1),
+    port: z.number().int().positive(),
+    username: z.string().min(1).optional(),
+    password: z.string().min(1).optional(),
+})
+    .strict();
+export const SessionProxySchema = BrowserProxySchema;
+export const SessionStartOptionsSchema = z.object({
+    humanize: z.boolean().optional(),
+    humanizePersonaId: z.number().int().min(0).max(124).optional(),
+    proxy: SessionProxySchema.nullable().optional(),
+    storage: SessionStoragePolicySchema.optional(),
+    solveCaptchas: z.boolean().optional(),
+    vault: VaultSessionPolicySchema.optional(),
+});
+export const ProfileSchema = z.object({
+    id: z.uuid(),
+    name: z.string().optional(),
+    createdAt: z.string(),
+});
+export const ProfileCreateOptionsSchema = z.object({
+    name: z.string().optional(),
+});
+export const ProfileListOptionsSchema = z.object({
+    page: z.number().int().positive().optional(),
+    name: z.string().optional(),
+});
+export const ProfileListResultSchema = z.object({
+    profiles: z.array(ProfileSchema),
+    totalCount: z.number().int().nonnegative(),
+});
+export const ProfileStartRequestSchema = z
+    .object({
+    humanize: z.boolean().optional(),
+    proxy: BrowserProxySchema.nullable().optional(),
+    storage: SessionStoragePolicySchema.optional(),
+})
+    .strict();
+export const ProfileConnectRequestSchema = z
+    .object({
+    driver: BrowserDriverSchema.optional(),
+})
+    .strict();
+export const ProfileStopResponseSchema = z
+    .object({
+    profileId: z.string(),
+    stopped: z.boolean(),
+    sessionId: z.string().optional(),
+})
+    .strict();
+export const ProfileLifecycleStatusSchema = z
+    .object({
+    profileId: z.string(),
+    name: z.string(),
+    status: z.enum(['running', 'stopped']),
+    browserRunning: z.boolean(),
+    hostStatus: z.string().nullable(),
+    currentDriver: z.string().nullable(),
+    activeSessionId: z.string().nullable(),
+    defaultContextId: z.string().nullable(),
+    defaultPageId: z.string().nullable(),
+    createdAt: z.string(),
+    updatedAt: z.string().nullable(),
+    lastUsedAt: z.string().nullable(),
+})
+    .strict();
+export const SessionStartRequestSchema = SessionStartOptionsSchema;
+export const SessionStartResponseSchema = z
+    .object({
+    id: z.uuid(),
+    status: z.enum(['active', 'stopped']),
+    storageWorkspace: z.string().optional(),
+})
+    .strict();
+export const SessionConnectRequestSchema = z
+    .object({
+    driver: BrowserDriverSchema.optional(),
+})
+    .strict();
+export const SessionConnectResponseSchema = z
+    .object({
+    id: z.uuid(),
+    currentDriver: BrowserDriverSchema,
+    defaultContextId: z.uuid().optional(),
+    defaultPageId: z.uuid().optional(),
+    storageWorkspace: z.string().optional(),
+})
+    .strict();