@vibesdotdev/control 0.0.0-stage → 1.0.0-rc.2

package/dist/browser/tools/control/prompts/plan-request.prompt.descriptor.js

@@ -0,0 +1,57 @@
+import { definePromptManifestDescriptor } from '@vibesdotdev/ai-schemas';
+/** The browser control planning request: task, step vocabulary, optional recipe and page state, response shape. */
+export default definePromptManifestDescriptor({
+    id: 'control.browser.plan-request',
+    version: '1.0.0',
+    name: 'Browser control plan request',
+    description: 'Asks the planner for browser automation steps as JSON.',
+    type: 'workflow',
+    category: 'generation',
+    tags: ['control', 'browser'],
+    scope: 'builtin',
+    isPublic: false,
+    generator: 'template',
+    content: `TASK: {{instruction}}
+
+You are a browser automation planner. Generate browser automation steps as JSON.
+
+STEP TYPES (each requires specific fields):
+- goto: { action: "goto", url: "https://..." }
+- click: { action: "click", selector: "css-selector" }
+- fill: { action: "fill", selector: "css-selector", value: "text" }
+- type: { action: "type", selector: "css-selector", text: "text", delay: 50 }
+- press: { action: "press", key: "Enter" }
+- waitForSelector: { action: "waitForSelector", selector: "css-selector", state: "visible", timeout: 30000 }
+- wait: { action: "wait", delay: 1000 }
+- select: { action: "select", selector: "css-selector", value: "option-value" }
+- hover: { action: "hover", selector: "css-selector" }
+- screenshot: { action: "screenshot", fullPage: false }
+- scroll: { action: "scroll", x: 0, y: 500 }
+- evaluate: { action: "evaluate", script: "return document.title" }
+
+RULES:
+- Use CSS selectors for element targeting
+- Add waitForSelector after navigation
+- Return ONLY valid JSON, no explanation{{#if recipe}}
+
+RECIPE CONTEXT:
+{{recipe}}{{/if}}{{#if observation}}
+
+CURRENT PAGE STATE:
+{{observation}}{{/if}}
+
+RESPONSE FORMAT:
+{
+  "summary": "brief description of what steps do",
+  "steps": [
+    { "action": "goto", "url": "https://example.com" },
+    { "action": "waitForSelector", "selector": "h1", "state": "visible", "timeout": 30000 }
+  ]
+}`,
+    arguments: [
+        { name: 'instruction', description: 'What the browser should do', type: 'text', required: true },
+        { name: 'recipe', description: 'Matched recipe context', type: 'text' },
+        { name: 'observation', description: 'Current page state', type: 'text' }
+    ]
+}, { owner: 'control' });
+//# sourceMappingURL=plan-request.prompt.descriptor.js.map

package/dist/browser/tools/control/prompts/plan-request.prompt.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-request.prompt.descriptor.js","sourceRoot":"","sources":["../../../../../src/browser/tools/control/prompts/plan-request.prompt.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,mHAAmH;AACnH,eAAe,8BAA8B,CAAC;IAC7C,EAAE,EAAE,8BAA8B;IAClC,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,wDAAwD;IACrE,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;IAC5B,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCR;IACD,SAAS,EAAE;QACV,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,4BAA4B,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE,IAAI,EAAE,MAAM,EAAE;QACvE,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,EAAE;KACxE;CACD,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC"}

package/dist/browser/tools/control/prompts/planner.prompt.descriptor.d.ts

@@ -0,0 +1,113 @@
+declare const _default: {
+    id: string;
+    kind: "prompts/manifest";
+    owner: string;
+    manifest: {
+        id: string;
+        version: string;
+        name: string;
+        description: string;
+        type: "system" | "workflow" | "specialist" | "tool" | "extraction";
+        tags: string[];
+        scope: "user" | "shared" | "builtin" | "project";
+        isPublic: boolean;
+        content: string;
+        generator: "static" | "template" | "dynamic";
+        category?: "custom" | "generation" | "extraction" | "development" | "knowledge" | "chat" | "analysis" | "validation" | undefined;
+        ownerId?: string | undefined;
+        projectId?: string | undefined;
+        sections?: {
+            key: string;
+            title: string;
+            content: string;
+            order: number;
+            collapsible: boolean;
+            conditional?: string | undefined;
+        }[] | undefined;
+        contentPath?: string | undefined;
+        tools?: string[] | undefined;
+        contextRequired?: string[] | undefined;
+        modelConfig?: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+            stopSequences?: string[] | undefined;
+        } | undefined;
+        knowledgeBaseIds?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        composedWith?: string[] | undefined;
+        inject?: "tools"[] | undefined;
+        arguments?: {
+            name: string;
+            description: string;
+            type: "string" | "number" | "boolean" | "file" | "select" | "multiselect" | "text" | "json";
+            required: boolean;
+            default?: unknown;
+            options?: {
+                label: string;
+                value: string;
+                description?: string | undefined;
+            }[] | undefined;
+            validation?: string | undefined;
+            placeholder?: string | undefined;
+        }[] | undefined;
+        templateEngine?: "handlebars" | "mustache" | "native" | undefined;
+        transform?: {
+            inputSchema?: Record<string, unknown> | undefined;
+            transformPath?: string | undefined;
+            transformSpread?: {
+                spreadFrom?: ("data" | "user" | "project" | "session")[] | undefined;
+                assigns?: Record<string, {
+                    literal: import("@vibesdotdev/kernel/bootstrap").JsonValue;
+                } | {
+                    path: string;
+                }> | undefined;
+            } | undefined;
+        } | undefined;
+        versions?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        }[] | undefined;
+        currentVersion?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        } | undefined;
+        metadata?: {
+            author?: string | undefined;
+            license?: string | undefined;
+            source?: string | undefined;
+            related?: string[] | undefined;
+            custom?: Record<string, unknown> | undefined;
+        } | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+    };
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export default _default;
+//# sourceMappingURL=planner.prompt.descriptor.d.ts.map

package/dist/browser/tools/control/prompts/planner.prompt.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.prompt.descriptor.d.ts","sourceRoot":"","sources":["../../../../../src/browser/tools/control/prompts/planner.prompt.descriptor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,wBAYyB"}

package/dist/browser/tools/control/prompts/planner.prompt.descriptor.js

@@ -0,0 +1,15 @@
+import { definePromptManifestDescriptor } from '@vibesdotdev/ai-schemas';
+export default definePromptManifestDescriptor({
+    id: 'control.browser.planner',
+    version: '1.0.0',
+    name: 'Browser automation planner',
+    description: 'System prompt for the browser control planner.',
+    type: 'system',
+    category: 'generation',
+    tags: ['control', 'browser'],
+    scope: 'builtin',
+    isPublic: false,
+    generator: 'static',
+    content: `You are a browser automation planner.`
+}, { owner: 'control' });
+//# sourceMappingURL=planner.prompt.descriptor.js.map

package/dist/browser/tools/control/prompts/planner.prompt.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.prompt.descriptor.js","sourceRoot":"","sources":["../../../../../src/browser/tools/control/prompts/planner.prompt.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,eAAe,8BAA8B,CAAC;IAC7C,EAAE,EAAE,yBAAyB;IAC7B,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,gDAAgD;IAC7D,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;IAC5B,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,uCAAuC;CAChD,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC"}

package/dist/browser/tools/control/schemas.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Browser Control Schemas
+ */
+import z from 'zod/v4';
+/** Wire-envelope: no top-level success; failures throw. */
+export declare const BrowserControlPlanSchema: z.ZodObject<{
+    summary: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"click">;
+        selector: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"fill">;
+        selector: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"type">;
+        selector: z.ZodString;
+        text: z.ZodString;
+        delay: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"press">;
+        key: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"waitForSelector">;
+        selector: z.ZodString;
+        state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            detached: "detached";
+            visible: "visible";
+            hidden: "hidden";
+            attached: "attached";
+        }>>>;
+        timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"wait">;
+        delay: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"select">;
+        selector: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"hover">;
+        selector: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"screenshot">;
+        path: z.ZodOptional<z.ZodString>;
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"scroll">;
+        selector: z.ZodOptional<z.ZodString>;
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"evaluate">;
+        script: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"goto">;
+        url: z.ZodString;
+        waitUntil: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"navigate">;
+        url: z.ZodString;
+        waitUntil: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>>;
+    }, z.core.$strip>], "action">>;
+    successIndicator: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            url: "url";
+            selector: "selector";
+            urlContains: "urlContains";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const BrowserControlPlanJsonSchema: import("@vibesdotdev/kernel/schemas/json").JsonObject;
+export declare const BrowserControlInputSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    instruction: z.ZodString;
+    session: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            create: "create";
+            ephemeral: "ephemeral";
+            upsert: "upsert";
+        }>>>;
+        persist: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        persistCredentials: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        profile: z.ZodOptional<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                load: "load";
+                create: "create";
+                upsert: "upsert";
+            }>>>;
+            persist: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$strip>>;
+        extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    tab: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        newTab: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        closeOnComplete: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>>;
+    url: z.ZodOptional<z.ZodURL>;
+    maxIterations: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    model: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    visionModel: z.ZodOptional<z.ZodString>;
+    visionProvider: z.ZodOptional<z.ZodString>;
+    observePrompt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    responseSchema: z.ZodOptional<z.ZodString>;
+    recipeId: z.ZodOptional<z.ZodString>;
+    recipeName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const BrowserControlOutputSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    tabId: z.ZodOptional<z.ZodString>;
+    finalUrl: z.ZodOptional<z.ZodString>;
+    iterations: z.ZodNumber;
+    plan: z.ZodOptional<z.ZodObject<{
+        summary: z.ZodOptional<z.ZodString>;
+        steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            action: z.ZodLiteral<"click">;
+            selector: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"fill">;
+            selector: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"type">;
+            selector: z.ZodString;
+            text: z.ZodString;
+            delay: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"press">;
+            key: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"waitForSelector">;
+            selector: z.ZodString;
+            state: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                detached: "detached";
+                visible: "visible";
+                hidden: "hidden";
+                attached: "attached";
+            }>>>;
+            timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"wait">;
+            delay: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"select">;
+            selector: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"hover">;
+            selector: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"screenshot">;
+            path: z.ZodOptional<z.ZodString>;
+            fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"scroll">;
+            selector: z.ZodOptional<z.ZodString>;
+            x: z.ZodOptional<z.ZodNumber>;
+            y: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"evaluate">;
+            script: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"goto">;
+            url: z.ZodString;
+            waitUntil: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                load: "load";
+                domcontentloaded: "domcontentloaded";
+                networkidle: "networkidle";
+            }>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"navigate">;
+            url: z.ZodString;
+            waitUntil: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                load: "load";
+                domcontentloaded: "domcontentloaded";
+                networkidle: "networkidle";
+            }>>>;
+        }, z.core.$strip>], "action">>;
+        successIndicator: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<{
+                url: "url";
+                selector: "selector";
+                urlContains: "urlContains";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    stepResults: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        stepIndex: z.ZodNumber;
+        action: z.ZodString;
+        success: z.ZodBoolean;
+        durationMs: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+        screenshotPath: z.ZodOptional<z.ZodString>;
+        evaluateResult: z.ZodOptional<z.ZodCustom<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+    }, z.core.$strip>>>;
+    observation: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BrowserControlInput = z.input<typeof BrowserControlInputSchema>;
+export type BrowserControlOutput = z.infer<typeof BrowserControlOutputSchema>;
+export type BrowserControlPlan = z.infer<typeof BrowserControlPlanSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/browser/tools/control/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/browser/tools/control/schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAC;AAUvB,2DAA2D;AAE3D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAInC,CAAC;AAEH,eAAO,MAAM,4BAA4B,uDAKxC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAepC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASrC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/browser/tools/control/schemas.js

@@ -0,0 +1,49 @@
+/**
+ * Browser Control Schemas
+ */
+import z from 'zod/v4';
+import { JsonObjectSchema } from '@vibesdotdev/kernel/schemas/json';
+import { BrowserStepSchema, StepResultSchema } from "../../shared/steps.js";
+import { BrowserSessionSchema, BrowserTabSchema } from "../direct/schemas.js";
+const SuccessIndicatorSchema = z.object({
+    type: z.enum(['url', 'urlContains', 'selector']),
+    value: z.string()
+});
+/** Wire-envelope: no top-level success; failures throw. */
+// (L-10)
+export const BrowserControlPlanSchema = z.object({
+    summary: z.string().optional(),
+    steps: z.array(BrowserStepSchema).min(1),
+    successIndicator: SuccessIndicatorSchema.optional()
+});
+export const BrowserControlPlanJsonSchema = JsonObjectSchema.parse(z.toJSONSchema(BrowserControlPlanSchema, {
+    io: 'output',
+    target: 'draft-7'
+}));
+export const BrowserControlInputSchema = z.object({
+    sessionId: z.string().optional(),
+    instruction: z.string().min(1),
+    session: BrowserSessionSchema.optional(),
+    tab: BrowserTabSchema.optional(),
+    url: z.url().optional(),
+    maxIterations: z.number().int().min(1).max(10).optional().default(3),
+    model: z.string().optional(),
+    provider: z.string().optional(),
+    visionModel: z.string().optional(),
+    visionProvider: z.string().optional(),
+    observePrompt: z.string().optional().default('Describe the current page state.'),
+    responseSchema: z.string().optional(),
+    recipeId: z.string().optional(),
+    recipeName: z.string().optional()
+});
+export const BrowserControlOutputSchema = z.object({
+    sessionId: z.string().optional(),
+    tabId: z.string().optional(),
+    finalUrl: z.string().optional(),
+    iterations: z.number().int(),
+    plan: BrowserControlPlanSchema.optional(),
+    stepResults: z.array(StepResultSchema).optional(),
+    observation: z.string().optional(),
+    error: z.string().optional()
+});
+//# sourceMappingURL=schemas.js.map

package/dist/browser/tools/control/schemas.js.map

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

package/dist/browser/tools/direct/implementation.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Browser Direct Tool Implementation
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { BrowserDirectInput, BrowserDirectOutput } from './schemas.ts';
+export declare function browserDirect(runtime: VibesRuntime, input: BrowserDirectInput): Promise<BrowserDirectOutput>;
+//# sourceMappingURL=implementation.d.ts.map

package/dist/browser/tools/direct/implementation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation.d.ts","sourceRoot":"","sources":["../../../../src/browser/tools/direct/implementation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAS5E,wBAAsB,aAAa,CAClC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAiE9B"}

package/dist/browser/tools/direct/implementation.js

@@ -0,0 +1,63 @@
+/**
+ * Browser Direct Tool Implementation
+ */
+import { resolveBrowserRuntimeManager } from "../../runtime/manager-host.js";
+import { executeBrowserSteps } from "../../runtime/step-executor.js";
+import { allocateFinalScreenshotPath, resolveExplicitScreenshotPath, resolveScreenshotsDir } from "../../shared/paths.js";
+export async function browserDirect(runtime, input) {
+    const workspacePath = await runtime.context('runtime/workspace-path');
+    const manager = await resolveBrowserRuntimeManager(runtime, workspacePath);
+    if (input.maxActiveSessions) {
+        manager.setMaxActiveSessions(input.maxActiveSessions);
+    }
+    const sessionOptions = input.session ??
+        (input.sessionId
+            ? { id: input.sessionId, mode: 'load', persist: false, persistCredentials: false }
+            : undefined);
+    const runtimeSession = await manager.getOrCreateSession(sessionOptions, input.options);
+    const runtimeTab = await manager.getOrCreateTab(runtimeSession, input.url, input.tab);
+    const steps = input.steps ?? [];
+    const stepResults = await executeBrowserSteps(runtimeTab.page, steps, {
+        runtime,
+        screenshotDir: resolveScreenshotsDir(workspacePath)
+    });
+    const allSucceeded = stepResults.every((result) => result.success);
+    let screenshotPath;
+    if (input.screenshotAfter && allSucceeded) {
+        const path = input.screenshotPath
+            ? await resolveExplicitScreenshotPath(runtime, input.screenshotPath)
+            : allocateFinalScreenshotPath({
+                workspacePath,
+                sessionId: runtimeSession.session.id
+            });
+        await runtimeTab.page.screenshot({ path, fullPage: false });
+        screenshotPath = path;
+    }
+    else {
+        screenshotPath = stepResults.find((result) => result.screenshotPath)?.screenshotPath;
+    }
+    await manager.updateTabUrl(runtimeTab.tab.id, runtimeTab.page);
+    if (input.session?.persistCredentials || input.session?.persist) {
+        await manager.persistSessionState(runtimeSession);
+    }
+    let videoPath;
+    const shouldCloseTab = input.tab?.closeOnComplete || input.options?.recordVideo?.closeOnComplete || false;
+    if (shouldCloseTab) {
+        await manager.closeTab(runtimeTab.tab.id);
+        videoPath = runtimeTab.page.video ? await runtimeTab.page.video() : undefined;
+    }
+    return {
+        sessionId: runtimeSession.session.id,
+        tabId: runtimeTab.tab.id,
+        finalUrl: runtimeTab.page.url(),
+        stepsCompleted: stepResults.filter((result) => result.success).length,
+        totalSteps: steps.length,
+        stepResults,
+        screenshotPath,
+        videoPath,
+        tabClosed: shouldCloseTab,
+        sessionPersisted: input.session?.persist || input.session?.persistCredentials || false,
+        error: allSucceeded ? undefined : stepResults.find((result) => !result.success)?.error
+    };
+}
+//# sourceMappingURL=implementation.js.map

package/dist/browser/tools/direct/implementation.js.map

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