@runtypelabs/cli 2.11.2 → 2.11.4

package/dist/index.js

@@ -253,6 +253,7 @@ var require_dashboard_url = __commonJS({
     exports.parseAccountId = parseAccountId;
     exports.isValidAccountId = isValidAccountId;
     exports.selectAccountId = selectAccountId3;
+    exports.buildEntityDashboardUrl = buildEntityDashboardUrl;
     exports.ACCOUNT_QUERY_PARAM = "account";
     function buildDashboardUrl5(opts) {
       let base = opts.baseUrl;
@@ -311,6 +312,21 @@ var require_dashboard_url = __commonJS({
         return params.userId;
       return void 0;
     }
+    var ENTITY_DASHBOARD_PATHS = {
+      product: "/products",
+      agent: "/agents",
+      flow: "/flows"
+    };
+    function buildEntityDashboardUrl(opts) {
+      const path14 = ENTITY_DASHBOARD_PATHS[opts.entityType];
+      if (!path14)
+        return null;
+      return buildDashboardUrl5({
+        baseUrl: opts.baseUrl,
+        path: `${path14}/${opts.entityId}`,
+        account: opts.account
+      });
+    }
   }
 });
 
@@ -11053,10 +11069,11 @@ var require_builtin_tools_registry = __commonJS({
   "../shared/dist/builtin-tools-registry.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.BUILTIN_TOOLS_REGISTRY = exports.BuiltInToolIdPrefix = exports.BuiltInToolCategory = exports.BuiltInToolProvider = void 0;
+    exports.BUILTIN_TOOLS_REGISTRY = exports.BuiltInToolGroup = exports.BuiltInToolIdPrefix = exports.BuiltInToolCategory = exports.BuiltInToolProvider = void 0;
     exports.formatSystemToolId = formatSystemToolId2;
     exports.getAllBuiltInTools = getAllBuiltInTools2;
     exports.getBuiltInToolById = getBuiltInToolById2;
+    exports.getBuiltInToolGroupById = getBuiltInToolGroupById;
     exports.getBuiltInToolsByProvider = getBuiltInToolsByProvider;
     exports.getBuiltInToolsByCategory = getBuiltInToolsByCategory;
     exports.isToolCompatibleWithModel = isToolCompatibleWithModel2;
@@ -11085,12 +11102,223 @@ var require_builtin_tools_registry = __commonJS({
       THIRD_PARTY_API: "third_party_api",
       ARTIFACT: "artifact",
       DATA_MANAGEMENT: "data_management",
-      COMMERCE: "commerce"
+      COMMERCE: "commerce",
+      BROWSER: "browser",
+      SANDBOX: "sandbox"
     };
     exports.BuiltInToolIdPrefix = {
       BUILTIN: "builtin",
       PLATFORM: "platform"
     };
+    exports.BuiltInToolGroup = {
+      BROWSER_FETCH: "browser_fetch",
+      BROWSER_USE: "browser_use",
+      FILE_OUTPUTS: "file_outputs",
+      VOICE: "voice",
+      RECORD_MANAGEMENT: "record_management",
+      UCP_COMMERCE: "ucp_commerce",
+      SANDBOX_USE: "sandbox_use",
+      SANDBOX_SESSION: "sandbox_session"
+    };
+    var BROWSER_RUN_DOCUMENTATION_URL = "https://developers.cloudflare.com/browser-run/quick-actions/";
+    var BROWSER_SESSION_DOCUMENTATION_URL = "https://developers.cloudflare.com/browser-run/cdp/";
+    var BROWSER_RUN_RESOURCE_TYPES = [
+      "document",
+      "stylesheet",
+      "image",
+      "media",
+      "font",
+      "script",
+      "texttrack",
+      "xhr",
+      "fetch",
+      "prefetch",
+      "eventsource",
+      "websocket",
+      "manifest",
+      "signedexchange",
+      "ping",
+      "cspviolationreport",
+      "preflight",
+      "other"
+    ];
+    var browserRunViewportSchema = {
+      type: "object",
+      description: "Browser viewport options. Defaults to Cloudflare Browser Run defaults when omitted.",
+      properties: {
+        width: {
+          type: "number",
+          description: "Viewport width in pixels",
+          minimum: 1
+        },
+        height: {
+          type: "number",
+          description: "Viewport height in pixels",
+          minimum: 1
+        },
+        deviceScaleFactor: {
+          type: "number",
+          description: "Device scale factor for higher-density screenshots",
+          minimum: 0
+        },
+        isMobile: {
+          type: "boolean",
+          description: "Whether the viewport should emulate a mobile device"
+        },
+        isLandscape: {
+          type: "boolean",
+          description: "Whether the viewport should emulate landscape orientation"
+        },
+        hasTouch: {
+          type: "boolean",
+          description: "Whether the viewport should emulate touch support"
+        }
+      }
+    };
+    var browserRunGotoOptionsSchema = {
+      type: "object",
+      description: "Page navigation options forwarded to Cloudflare Browser Run",
+      properties: {
+        waitUntil: {
+          type: "string",
+          description: "Navigation lifecycle event to wait for",
+          enum: ["load", "domcontentloaded", "networkidle0", "networkidle2"]
+        },
+        timeout: {
+          type: "number",
+          description: "Navigation timeout in milliseconds",
+          minimum: 0,
+          maximum: 6e4
+        },
+        referer: {
+          type: "string",
+          description: "Optional referer URL"
+        },
+        referrerPolicy: {
+          type: "string",
+          description: "Optional browser referrer policy"
+        }
+      }
+    };
+    var browserRunWaitForSelectorSchema = {
+      type: "object",
+      description: "Wait for a CSS selector before extracting the page",
+      properties: {
+        selector: {
+          type: "string",
+          description: "CSS selector to wait for",
+          minLength: 1
+        },
+        visible: {
+          type: "boolean",
+          description: "Wait until the selector is visible"
+        },
+        hidden: {
+          type: "boolean",
+          description: "Wait until the selector is hidden"
+        },
+        timeout: {
+          type: "number",
+          description: "Selector wait timeout in milliseconds",
+          minimum: 0,
+          maximum: 6e4
+        }
+      },
+      required: ["selector"]
+    };
+    var browserRunCommonProperties = {
+      url: {
+        type: "string",
+        description: 'The full URL to render (e.g. "https://example.com/page")',
+        minLength: 1
+      },
+      viewport: browserRunViewportSchema,
+      gotoOptions: browserRunGotoOptionsSchema,
+      waitForSelector: browserRunWaitForSelectorSchema,
+      waitForTimeout: {
+        type: "number",
+        description: "Milliseconds to wait before extracting after page navigation",
+        minimum: 0,
+        maximum: 6e4
+      },
+      rejectResourceTypes: {
+        type: "array",
+        description: "Resource types to block while loading the page",
+        items: {
+          type: "string",
+          enum: [...BROWSER_RUN_RESOURCE_TYPES]
+        }
+      },
+      rejectRequestPattern: {
+        type: "array",
+        description: "Regular expression patterns for requests to block while loading the page",
+        items: { type: "string" }
+      },
+      userAgent: {
+        type: "string",
+        description: "Custom browser user agent string"
+      },
+      cacheTTL: {
+        type: "number",
+        description: "Cloudflare Browser Run cache TTL in seconds. Set to 0 to disable cache.",
+        minimum: 0,
+        maximum: 86400
+      }
+    };
+    var browserRunScreenshotOptionsSchema = {
+      type: "object",
+      description: "Screenshot capture options forwarded to Cloudflare Browser Run",
+      properties: {
+        fullPage: {
+          type: "boolean",
+          description: "Capture the full page instead of only the viewport"
+        },
+        type: {
+          type: "string",
+          description: "Screenshot image format",
+          enum: ["png", "jpeg", "webp"],
+          default: "png"
+        },
+        quality: {
+          type: "number",
+          description: "Image quality for jpeg or webp screenshots",
+          minimum: 0,
+          maximum: 100
+        },
+        omitBackground: {
+          type: "boolean",
+          description: "Hide the default white background to allow transparency"
+        },
+        captureBeyondViewport: {
+          type: "boolean",
+          description: "Capture beyond the viewport when clipping"
+        },
+        clip: {
+          type: "object",
+          description: "Optional screenshot clipping rectangle",
+          properties: {
+            x: { type: "number", description: "Clip x coordinate" },
+            y: { type: "number", description: "Clip y coordinate" },
+            width: {
+              type: "number",
+              description: "Clip width in pixels",
+              minimum: 1
+            },
+            height: {
+              type: "number",
+              description: "Clip height in pixels",
+              minimum: 1
+            },
+            scale: {
+              type: "number",
+              description: "Clip scale",
+              minimum: 0
+            }
+          },
+          required: ["x", "y", "width", "height"]
+        }
+      }
+    };
     var CORE_BUILTIN_TOOLS_REGISTRY = [
       // OpenAI DALL-E Image Generation
       {
@@ -11594,699 +11822,1385 @@ var require_builtin_tools_registry = __commonJS({
         requiresApiKey: true,
         executionHint: "platform"
       },
-      // Vector Search - Semantic search across knowledge bases
-      // Supports multi-instance format: builtin:vector-search#<instance-id>
+      // Cloudflare Browser Run Quick Action: Screenshot
       {
-        id: "vector-search",
-        name: "Semantic Search",
-        description: "Search through knowledge bases using semantic similarity. Finds relevant documents based on meaning rather than exact keyword matches.",
-        category: exports.BuiltInToolCategory.KNOWLEDGE_RETRIEVAL,
+        id: "browser:screenshot",
+        aliases: ["browser-screenshot"],
+        name: "Browser Screenshot",
+        description: "Capture a screenshot of a rendered web page using Cloudflare Browser Run. Returns a base64-encoded image.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_FETCH,
         providers: [exports.BuiltInToolProvider.MULTI],
-        // Works with any model, uses OpenAI for embeddings
         parametersSchema: {
           type: "object",
           properties: {
-            query: {
-              type: "string",
-              description: "The search query to find semantically similar documents"
-            },
-            limit: {
-              type: "number",
-              description: "Maximum number of results to return (1-20)",
-              minimum: 1,
-              maximum: 20,
-              default: 5
-            }
+            ...browserRunCommonProperties,
+            screenshotOptions: browserRunScreenshotOptionsSchema
           },
-          required: ["query"]
+          required: ["url"]
         },
         defaultConfig: {
-          limit: 5,
-          threshold: 0.3
-        },
-        configSchema: {
-          supportsInstances: true,
-          instanceLabel: "Add Knowledge Base",
-          properties: {
-            threshold: {
-              type: "number",
-              label: "Similarity Threshold",
-              description: "Minimum similarity score (0-1). Lower values return more results.",
-              default: 0.3
-            },
-            displayName: {
-              type: "string",
-              label: "Display Name",
-              description: 'Name shown to the AI model (e.g., "Search Documentation")',
-              required: true
-            },
-            provider: {
-              type: "select",
-              label: "Vector Provider",
-              description: "Where the vectors are stored",
-              required: true,
-              default: "pgvector",
-              options: [
-                { value: "pgvector", label: "Platform (pgvector)" },
-                { value: "weaviate", label: "Weaviate" },
-                { value: "vectorize", label: "Cloudflare Vectorize" }
-              ]
-            },
-            recordType: {
-              type: "string",
-              label: "Record Type",
-              description: "Filter by record type (optional)",
-              dependsOn: { field: "provider", value: "pgvector" }
-            },
-            weaviateClassName: {
-              type: "string",
-              label: "Collection Name",
-              description: "Weaviate collection to search",
-              required: true,
-              dependsOn: { field: "provider", value: "weaviate" }
-            },
-            vectorizeIndexName: {
-              type: "string",
-              label: "Index Name",
-              description: "Vectorize index to search",
-              required: true,
-              dependsOn: { field: "provider", value: "vectorize" }
-            }
+          screenshotOptions: {
+            type: "png",
+            fullPage: false
           }
         },
-        requiresApiKey: true,
-        // Requires OpenAI key for embeddings
-        executionHint: "platform"
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
       },
-      // ElevenLabs Text-to-Speech
+      // Cloudflare Browser Run Quick Action: Content
       {
-        id: "elevenlabs-tts",
-        name: "ElevenLabs Text-to-Speech",
-        description: "Convert text to natural-sounding speech using ElevenLabs AI voices",
-        category: exports.BuiltInToolCategory.TEXT_TO_SPEECH,
+        id: "browser:content",
+        aliases: ["browser-content"],
+        name: "Browser Content",
+        description: "Fetch the fully rendered HTML of a web page after JavaScript execution using Cloudflare Browser Run.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_FETCH,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
-          properties: {
-            text: {
-              type: "string",
-              description: "Text to convert to speech",
-              minLength: 1,
-              maxLength: 5e3
-            },
-            voice_id: {
-              type: "string",
-              description: "ElevenLabs voice ID or name",
-              default: "rachel"
-            },
-            model_id: {
-              type: "string",
-              description: "ElevenLabs model ID",
-              default: "eleven_multilingual_v2"
-            },
-            stability: {
-              type: "number",
-              description: "Voice stability (0-1)",
-              minimum: 0,
-              maximum: 1,
-              default: 0.5
-            },
-            similarity_boost: {
-              type: "number",
-              description: "Voice similarity boost (0-1)",
-              minimum: 0,
-              maximum: 1,
-              default: 0.75
-            }
-          },
-          required: ["text"]
-        },
-        defaultConfig: {
-          voice_id: "rachel",
-          // @snake-case-ok: ElevenLabs API
-          model_id: "eleven_multilingual_v2",
-          // @snake-case-ok: ElevenLabs API
-          stability: 0.5,
-          similarity_boost: 0.75
-          // @snake-case-ok: ElevenLabs API
+          properties: browserRunCommonProperties,
+          required: ["url"]
         },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
         executionHint: "platform",
-        requiresApiKey: true,
-        platformKeySupport: true,
-        marginPercent: 20,
-        hidden: true
+        platformKeySupport: true
       },
-      // ElevenLabs Speech-to-Text
+      // Cloudflare Browser Run Quick Action: Scrape
       {
-        id: "elevenlabs-stt",
-        name: "ElevenLabs Speech-to-Text",
-        description: "Transcribe audio to text using ElevenLabs Scribe models",
-        category: exports.BuiltInToolCategory.TEXT_TO_SPEECH,
+        id: "browser:scrape",
+        aliases: ["browser-scrape"],
+        name: "Browser Scrape",
+        description: "Extract structured data from specific CSS selectors on a rendered web page using Cloudflare Browser Run.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_FETCH,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            audio: {
-              type: "string",
-              description: "Base64-encoded audio data",
-              minLength: 1
-            },
-            format: {
-              type: "string",
-              description: "Audio format (wav, mp3, webm, etc.)",
-              default: "wav"
-            },
-            model_id: {
-              type: "string",
-              description: "ElevenLabs STT model (scribe_v1 or scribe_v2)",
-              default: "scribe_v2"
-            },
-            language_code: {
-              type: "string",
-              description: "ISO-639-1 language code (optional, auto-detected if omitted)"
+            ...browserRunCommonProperties,
+            elements: {
+              type: "array",
+              description: "Elements to scrape from the rendered page",
+              minItems: 1,
+              items: {
+                type: "object",
+                properties: {
+                  selector: {
+                    type: "string",
+                    description: "CSS selector to extract",
+                    minLength: 1
+                  }
+                },
+                required: ["selector"]
+              }
             }
           },
-          required: ["audio"]
-        },
-        defaultConfig: {
-          format: "wav",
-          model_id: "scribe_v2"
-          // @snake-case-ok: ElevenLabs API
+          required: ["url", "elements"]
         },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
         executionHint: "platform",
-        requiresApiKey: true,
-        platformKeySupport: true,
-        marginPercent: 20,
-        hidden: true
+        platformKeySupport: true
       },
-      // Artifact-emit tools (auto-injected at runtime when ArtifactConfig is enabled)
+      // Cloudflare Browser Run Quick Action: JSON
       {
-        id: "emit_artifact_markdown",
-        name: "Emit Artifact (Markdown)",
-        description: "Stream markdown content to the artifact channel on supported clients.",
-        category: exports.BuiltInToolCategory.ARTIFACT,
+        id: "browser:json",
+        aliases: ["browser-json"],
+        name: "Browser JSON",
+        description: "Extract structured JSON from a rendered web page using Cloudflare Browser Run and Workers AI. Provide a prompt, a JSON schema, or both.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_FETCH,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            title: {
+            ...browserRunCommonProperties,
+            prompt: {
               type: "string",
-              description: "Optional title for the artifact"
+              description: "Natural-language extraction instructions",
+              minLength: 1
             },
-            markdown: {
-              type: "string",
-              description: "Markdown content to render"
+            schema: {
+              type: "object",
+              description: "JSON Schema describing the desired extracted result"
             }
           },
-          required: ["markdown"]
+          required: ["url"]
         },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
         executionHint: "platform",
-        hidden: true
+        platformKeySupport: true
       },
+      // Cloudflare Browser Run Quick Action: Markdown
       {
-        id: "emit_artifact_component",
-        name: "Emit Artifact (Component)",
-        description: "Emit a named component reference with props to the artifact channel. The client renders it using its registered component library.",
-        category: exports.BuiltInToolCategory.ARTIFACT,
+        id: "browser:markdown",
+        aliases: ["browser-markdown"],
+        name: "Browser Markdown",
+        description: "Convert a rendered web page into clean Markdown using Cloudflare Browser Run.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_FETCH,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: browserRunCommonProperties,
+          required: ["url"]
+        },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      // Cloudflare Browser Run Quick Action: Snapshot
+      {
+        id: "browser:snapshot",
+        aliases: ["browser-snapshot"],
+        name: "Browser Snapshot",
+        description: "Capture rendered HTML and a base64 screenshot of a web page in one Cloudflare Browser Run request.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_FETCH,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            title: {
-              type: "string",
-              description: "Optional title for the artifact"
-            },
-            component: {
-              type: "string",
-              description: "Name of a component registered in the client-side component registry"
-            },
-            props: {
-              type: "object",
-              description: "Props object passed to the component renderer"
+            ...browserRunCommonProperties,
+            screenshotOptions: browserRunScreenshotOptionsSchema
+          },
+          required: ["url"]
+        },
+        defaultConfig: {
+          screenshotOptions: {
+            type: "png",
+            fullPage: false
+          }
+        },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      // Cloudflare Browser Run Quick Action: Links
+      {
+        id: "browser:links",
+        aliases: ["browser-links"],
+        name: "Browser Links",
+        description: "Retrieve links from a rendered web page using Cloudflare Browser Run. Can limit results to visible links.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_FETCH,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            ...browserRunCommonProperties,
+            visibleLinksOnly: {
+              type: "boolean",
+              description: "Only return links visible on the rendered page",
+              default: false
             }
           },
-          required: ["component"]
+          required: ["url"]
+        },
+        defaultConfig: {
+          visibleLinksOnly: false
         },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
         executionHint: "platform",
-        hidden: true
+        platformKeySupport: true
       },
-      // Asset Storage — mirror files onto Runtype's CDN from a URL or inline bytes
+      // -----------------------------------------------------------------------
+      // Cloudflare Browser Run Session Tools (Phase 2)
+      // Persistent browser sessions for interactive agent browsing.
+      // -----------------------------------------------------------------------
       {
-        id: "store_asset",
-        name: "Store Asset",
-        description: "Store a file on Runtype's CDN and get back a permanent URL (public) or time-limited signed URL (private). Two modes: (1) pass `url` to download from an HTTP(S) URL, or (2) pass base64-encoded `content` plus `contentType` to upload inline bytes directly \u2014 useful when running inside a sandboxed code-execution environment with restricted outbound network. Exactly one of `url` or `content` must be provided. Files are served as attachments (the URL downloads rather than rendering). To publish an HTML page that renders in the browser, use `publish_page` instead. 25 MB max.",
-        category: exports.BuiltInToolCategory.FILE_OPERATIONS,
+        id: "browser:open",
+        aliases: ["browser-open"],
+        name: "Browser Open",
+        description: "Open a persistent browser session and navigate to a URL. Returns a sessionId you can reuse across multiple turns. Sessions survive between turns \u2014 store the sessionId and pass it to subsequent browser tools. If a session expires (idle >2 min or >10 min total), you will get an error; just call browser:open again to start a fresh session. Use browser:close to explicitly end a session when done.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
             url: {
               type: "string",
-              description: "HTTP(S) URL of the file to download and store. Provide this OR `content`, not both."
+              description: "The URL to navigate to"
             },
-            content: {
+            viewport: browserRunViewportSchema,
+            userAgent: {
               type: "string",
-              description: 'Base64-encoded file bytes to store directly, without downloading. Provide this OR `url`, not both. Requires `contentType`. A leading data: URI prefix (e.g. "data:text/html;base64,") is stripped automatically if present.'
-            },
-            contentType: {
+              description: "Custom User-Agent string"
+            }
+          },
+          required: ["url"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      {
+        id: "browser:navigate",
+        aliases: ["browser-navigate"],
+        name: "Browser Navigate",
+        description: "Navigate to a new URL in an existing browser session.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            sessionId: {
               type: "string",
-              description: 'MIME type for inline content (required when `content` is supplied). Example: "text/html", "image/png", "application/pdf". Ignored when `url` is used.'
+              description: "The session ID returned by browser:open"
             },
-            filename: {
+            url: {
               type: "string",
-              description: "Optional filename for the stored file"
+              description: "The URL to navigate to"
             },
-            visibility: {
+            waitUntil: {
               type: "string",
-              enum: ["public", "private"],
-              description: 'Access control. "public" = anyone with the URL can access. "private" = returns a signed URL that expires (default 1 hour). Default: "public".'
+              description: "When to consider navigation finished",
+              enum: ["load", "domcontentloaded", "networkidle0", "networkidle2"],
+              default: "networkidle0"
             }
           },
-          required: []
+          required: ["sessionId", "url"]
         },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
         executionHint: "platform",
-        platformKeySupport: true,
-        requiresApiKey: false
+        platformKeySupport: true
       },
-      // Publish Page — render HTML inline in the browser at a shareable URL
       {
-        id: "publish_page",
-        name: "Publish Page",
-        description: "Publish an HTML page on Runtype's CDN and get back a shareable URL that renders the page inline in the browser. Two source modes: (1) pass `url` to download an HTML file from an HTTP(S) URL, or (2) pass base64-encoded `content` (defaults to `contentType: text/html`) to upload inline HTML directly \u2014 useful when running inside a sandboxed code-execution environment with restricted outbound network. Exactly one of `url` or `content` must be provided. Served inline from a `/preview/` path under a locked-down CSP that blocks scripts, network requests, and form submissions. Page URLs are public and expire after 7 days. Accepts only HTML content. 25 MB max. To host a non-HTML file, or HTML as a permanent downloadable file, use `store_asset` instead.",
-        category: exports.BuiltInToolCategory.FILE_OPERATIONS,
+        id: "browser:click",
+        aliases: ["browser-click"],
+        name: "Browser Click",
+        description: "Click an element by CSS selector in an existing browser session.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            url: {
+            sessionId: {
               type: "string",
-              description: "HTTP(S) URL of an HTML file to download and publish. Provide this OR `content`, not both."
+              description: "The session ID returned by browser:open"
             },
-            content: {
+            selector: {
               type: "string",
-              description: 'Base64-encoded HTML bytes to publish directly. Provide this OR `url`, not both. A leading data: URI prefix (e.g. "data:text/html;base64,") is stripped automatically if present.'
+              description: "CSS selector of the element to click"
             },
-            contentType: {
+            button: {
               type: "string",
-              description: 'MIME type for inline content. Defaults to "text/html". Must be an HTML type \u2014 anything else is rejected. Ignored when `url` is used.'
+              description: "Mouse button to click",
+              enum: ["left", "right", "middle"],
+              default: "left"
             },
-            filename: {
-              type: "string",
-              description: "Optional filename for the stored page"
+            clickCount: {
+              type: "number",
+              description: "Number of clicks (e.g. 2 for double-click)",
+              minimum: 1,
+              default: 1
+            },
+            delay: {
+              type: "number",
+              description: "Delay between mousedown and mouseup in milliseconds",
+              minimum: 0
             }
           },
-          required: []
+          required: ["sessionId", "selector"]
         },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
         executionHint: "platform",
-        platformKeySupport: true,
-        requiresApiKey: false
+        platformKeySupport: true
       },
-      // Generate PDF — render HTML or Markdown to a PDF document
       {
-        id: "generate_pdf",
-        name: "Generate PDF",
-        description: "Render HTML or Markdown to a PDF file and store it on Runtype's CDN. Returns a permanent public URL or a time-limited signed URL (default 1 hour) depending on `visibility`. Exactly one of `html` or `markdown` must be provided \u2014 markdown is rendered with GFM in an A4 print shell with sensible typography; html is passed through untouched so callers can control their own fonts and CSS. Optional `pdfOptions` (format, landscape, margin, printBackground, displayHeaderFooter, headerTemplate, footerTemplate, scale, pageRanges, preferCSSPageSize, omitBackground) are forwarded to the renderer. Source is capped at 2 MB; output is capped at 25 MB. Powered by Cloudflare Browser Rendering.",
-        category: exports.BuiltInToolCategory.FILE_OPERATIONS,
+        id: "browser:type",
+        aliases: ["browser-type"],
+        name: "Browser Type",
+        description: "Type text into an input element or the currently focused element in a browser session.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            html: {
+            sessionId: {
               type: "string",
-              description: "Complete HTML document (or fragment) to render. Callers supply their own styling. Provide this OR `markdown`, not both."
+              description: "The session ID returned by browser:open"
             },
-            markdown: {
+            text: {
               type: "string",
-              description: "Markdown source. Rendered with GFM and wrapped in an A4 print shell. Inline HTML inside the markdown is escaped. Provide this OR `html`, not both."
+              description: "The text to type"
             },
-            filename: {
+            selector: {
               type: "string",
-              description: "Optional filename for the stored PDF (defaults to `document-<timestamp>.pdf`)."
+              description: "CSS selector of the input element. If omitted, types into the focused element."
             },
-            visibility: {
-              type: "string",
-              enum: ["public", "private"],
-              description: 'Access control. "public" returns a permanent URL; "private" returns a signed URL that expires (default 1 hour). Default: "public".'
+            delay: {
+              type: "number",
+              description: "Delay between keystrokes in milliseconds",
+              minimum: 0
             },
-            pdfOptions: {
-              type: "object",
-              description: "Optional puppeteer `page.pdf()` options (whitelisted).",
-              properties: {
-                format: {
-                  type: "string",
-                  description: 'Paper format (e.g. "a4", "letter", "legal"). Overrides width/height.'
-                },
-                landscape: { type: "boolean" },
-                printBackground: { type: "boolean" },
-                displayHeaderFooter: { type: "boolean" },
-                headerTemplate: {
-                  type: "string",
-                  description: "HTML template for the print header. Supports `date`, `title`, `url`, `pageNumber`, `totalPages` classes."
-                },
-                footerTemplate: { type: "string" },
-                scale: {
-                  type: "number",
-                  description: "Rendering scale, between 0.1 and 2. Default 1."
-                },
-                preferCSSPageSize: { type: "boolean" },
-                pageRanges: {
-                  type: "string",
-                  description: 'Page ranges to include, e.g. "1-5, 8, 11-13". Default: all pages.'
-                },
-                omitBackground: { type: "boolean" },
-                margin: {
-                  type: "object",
-                  properties: {
-                    top: { type: "string" },
-                    right: { type: "string" },
-                    bottom: { type: "string" },
-                    left: { type: "string" }
-                  }
-                }
-              }
+            pressEnter: {
+              type: "boolean",
+              description: "Press Enter after typing",
+              default: false
             }
           },
-          required: []
+          required: ["sessionId", "text"]
         },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
         executionHint: "platform",
-        platformKeySupport: true,
-        requiresApiKey: false
+        platformKeySupport: true
       },
-      // Record Management Tools — CRUD operations on Runtype records
       {
-        id: "runtype_record_upsert",
-        name: "Upsert Record",
-        description: "Create or update a Runtype record with structured metadata. Records are identified by type and name. If a record with the same type and name already exists, it will be updated based on the merge strategy.",
-        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        id: "browser:scroll",
+        aliases: ["browser-scroll"],
+        name: "Browser Scroll",
+        description: "Scroll the page or a specific element in a browser session.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            type: {
+            sessionId: {
               type: "string",
-              description: 'Record type category (e.g., "customer", "order", "note", "task")'
+              description: "The session ID returned by browser:open"
             },
-            name: {
+            direction: {
               type: "string",
-              description: "Unique name for this record within its type"
+              description: "Scroll direction",
+              enum: ["up", "down", "left", "right"],
+              default: "down"
             },
-            metadata: {
-              type: "object",
-              description: "JSON object containing the record data"
+            amount: {
+              type: "number",
+              description: "Scroll amount in pixels",
+              minimum: 1,
+              default: 500
             },
-            mergeStrategy: {
+            selector: {
               type: "string",
-              description: 'How to handle existing data when updating: "merge" (shallow merge, new keys override) or "replace" (completely replace metadata)',
-              enum: ["merge", "replace"],
-              default: "merge"
+              description: "CSS selector of the element to scroll within. If omitted, scrolls the page."
             }
           },
-          required: ["type", "name", "metadata"]
+          required: ["sessionId"]
         },
-        executionHint: "platform",
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
         requiresApiKey: false,
-        platformKeySupport: false
+        executionHint: "platform",
+        platformKeySupport: true
       },
       {
-        id: "runtype_record_batch_upsert",
-        name: "Batch Upsert Records",
-        description: "Create or update multiple Runtype records at once in a single transaction. Each record is identified by type and name. Maximum 100 records per call.",
-        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        id: "browser:session-screenshot",
+        aliases: ["browser-session-screenshot"],
+        name: "Browser Session Screenshot",
+        description: "Capture a screenshot of the current page in a browser session. Returns a base64-encoded image.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            records: {
-              type: "array",
-              description: "Array of records to upsert (max 100)",
-              items: {
-                type: "object",
-                properties: {
-                  type: {
-                    type: "string",
-                    description: "Record type category"
-                  },
-                  name: {
-                    type: "string",
-                    description: "Unique name within this type"
-                  },
-                  metadata: {
-                    type: "object",
-                    description: "JSON object containing the record data"
-                  }
-                },
-                required: ["type", "name", "metadata"]
-              }
+            sessionId: {
+              type: "string",
+              description: "The session ID returned by browser:open"
             },
-            mergeStrategy: {
+            fullPage: {
+              type: "boolean",
+              description: "Capture the full scrollable page instead of just the viewport",
+              default: false
+            },
+            selector: {
               type: "string",
-              description: 'How to handle existing data: "merge" or "replace". Applies to all records.',
-              enum: ["merge", "replace"],
-              default: "merge"
+              description: "CSS selector of an element to capture instead of the full page"
+            },
+            format: {
+              type: "string",
+              description: "Image format",
+              enum: ["png", "jpeg", "webp"],
+              default: "png"
             }
           },
-          required: ["records"]
+          required: ["sessionId"]
         },
-        executionHint: "platform",
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
         requiresApiKey: false,
-        platformKeySupport: false
+        executionHint: "platform",
+        platformKeySupport: true
       },
       {
-        id: "runtype_record_get",
-        name: "Get Record",
-        description: "Retrieve a single Runtype record by its type and name. Returns the full record including metadata, or null if not found.",
-        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        id: "browser:evaluate",
+        aliases: ["browser-evaluate"],
+        name: "Browser Evaluate",
+        description: "Execute JavaScript in the browser page context of an existing session. Returns the result of the script.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            type: {
+            sessionId: {
               type: "string",
-              description: "Record type to look up"
+              description: "The session ID returned by browser:open"
             },
-            name: {
+            script: {
               type: "string",
-              description: "Record name to look up"
+              description: "JavaScript code to evaluate in the page context"
             }
           },
-          required: ["type", "name"]
+          required: ["sessionId", "script"]
         },
-        executionHint: "platform",
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
         requiresApiKey: false,
-        platformKeySupport: false
+        executionHint: "platform",
+        platformKeySupport: true
       },
       {
-        id: "runtype_record_list",
-        name: "List Records",
-        description: "List and search Runtype records with optional filtering by type and text search. Returns paginated results.",
-        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        id: "browser:session-info",
+        aliases: ["browser-session-info"],
+        name: "Browser Session Info",
+        description: "Get the current state of a browser session including URL, title, and session age.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            type: {
-              type: "string",
-              description: "Filter by record type (optional)"
-            },
-            search: {
+            sessionId: {
               type: "string",
-              description: "Text search across record names (optional, case-insensitive)"
-            },
-            limit: {
-              type: "number",
-              description: "Maximum number of records to return (1-50, default 20)",
-              minimum: 1,
-              maximum: 50,
-              default: 20
-            },
-            offset: {
-              type: "number",
-              description: "Number of records to skip for pagination (default 0)",
-              minimum: 0,
-              default: 0
+              description: "The session ID returned by browser:open"
             }
           },
-          required: []
+          required: ["sessionId"]
         },
-        executionHint: "platform",
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
         requiresApiKey: false,
-        platformKeySupport: false
+        executionHint: "platform",
+        platformKeySupport: true
       },
       {
-        id: "runtype_record_delete",
-        name: "Delete Record",
-        description: "Delete a Runtype record by its type and name. Returns whether the record was found and deleted.",
-        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        id: "browser:close",
+        aliases: ["browser-close"],
+        name: "Browser Close",
+        description: "Explicitly close a browser session and release resources. Call this when you are done with a session and want a clean slate. If you do not close the session, it will be cleaned up automatically after idle timeout (2 min) or max session lifetime (10 min).",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            type: {
-              type: "string",
-              description: "Record type of the record to delete"
-            },
-            name: {
+            sessionId: {
               type: "string",
-              description: "Name of the record to delete"
+              description: "The session ID returned by browser:open"
             }
           },
-          required: ["type", "name"]
+          required: ["sessionId"]
         },
-        executionHint: "platform",
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
         requiresApiKey: false,
-        platformKeySupport: false
+        executionHint: "platform",
+        platformKeySupport: true
       },
-      // UCP (Universal Commerce Protocol) Tools — interact with any UCP-enabled merchant
       {
-        id: "ucp_discover",
-        name: "UCP Discover",
-        description: "Discover the commerce capabilities of a UCP-enabled website. Fetches the merchant's /.well-known/ucp discovery profile to determine supported services, capabilities, and payment handlers. Returns the UCP version, available services (REST/MCP/A2A endpoints), capabilities (checkout, cart, catalog, fulfillment, discount, order), and payment handler namespaces. Call this first before any other UCP operation.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "browser:task",
+        aliases: ["browser-task"],
+        name: "Browser Task",
+        description: "Run an autonomous browser task described in natural language. Provide a 'goal' plus EITHER a 'startUrl' (to open a fresh browser) OR a 'sessionId' from browser:open (to operate on an existing session). The AI will navigate, click, type, and extract information to complete the task, then return the result. When 'sessionId' is provided, the browser stays open afterward so you can continue with other browser tools (browser:click, browser:type, etc.). Provide an 'outputSchema' (JSON Schema) to get structured JSON back instead of a text summary. Use this when you want the browser to handle the 'how' and just want the outcome \u2014 for precise control over individual actions, use the lower-level browser session tools instead.",
+        category: exports.BuiltInToolCategory.BROWSER,
+        toolGroup: exports.BuiltInToolGroup.BROWSER_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: {
+            goal: {
               type: "string",
-              description: 'Domain of the UCP-enabled site (e.g., "erleia.com"). The discovery manifest will be fetched from https://{domain}/.well-known/ucp'
+              description: "Natural-language description of what to accomplish on the page."
+            },
+            startUrl: {
+              type: "string",
+              description: "URL to begin browsing from. Required when sessionId is not provided."
+            },
+            sessionId: {
+              type: "string",
+              description: "Existing browser session ID from browser:open. When provided, the task runs on that session and the browser stays open after the task completes. If both startUrl and sessionId are provided, sessionId wins."
+            },
+            outputSchema: {
+              type: "object",
+              description: "Optional JSON Schema. When provided, the result is the parsed JSON object matching the schema. Otherwise the result is a short plain-English summary of what was accomplished."
+            },
+            maxSteps: {
+              type: "number",
+              description: "Maximum number of browser actions to take (default 15, max 30).",
+              minimum: 1,
+              maximum: 30,
+              default: 15
+            },
+            viewport: browserRunViewportSchema,
+            userAgent: {
+              type: "string",
+              description: "Custom User-Agent string (only used when starting a fresh browser)."
             }
           },
-          required: ["domain"]
+          required: ["goal"]
         },
-        executionHint: "platform",
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
         requiresApiKey: false,
-        platformKeySupport: false
+        executionHint: "platform",
+        platformKeySupport: true,
+        experimental: true
       },
+      // Vector Search - Semantic search across knowledge bases
+      // Supports multi-instance format: builtin:vector-search#<instance-id>
       {
-        id: "ucp_create_checkout",
-        name: "UCP Create Checkout",
-        description: "Create a new checkout session with a UCP-enabled merchant. Provide the items to purchase and optional buyer/fulfillment information. Returns a checkout session with a sessionId for subsequent updates.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "vector-search",
+        name: "Semantic Search",
+        description: "Search through knowledge bases using semantic similarity. Finds relevant documents based on meaning rather than exact keyword matches.",
+        category: exports.BuiltInToolCategory.KNOWLEDGE_RETRIEVAL,
         providers: [exports.BuiltInToolProvider.MULTI],
+        // Works with any model, uses OpenAI for embeddings
         parametersSchema: {
           type: "object",
           properties: {
-            domain: {
+            query: {
               type: "string",
-              description: 'Domain of the UCP-enabled merchant (e.g., "erleia.com")'
+              description: "The search query to find semantically similar documents"
             },
-            items: {
-              type: "array",
-              description: "Line items for the checkout",
-              items: {
-                type: "object",
-                properties: {
-                  id: { type: "string", description: "Product/variant identifier from the merchant" },
-                  quantity: { type: "number", description: "Quantity to purchase" }
-                },
-                required: ["id", "quantity"]
-              }
+            limit: {
+              type: "number",
+              description: "Maximum number of results to return (1-20)",
+              minimum: 1,
+              maximum: 20,
+              default: 5
+            }
+          },
+          required: ["query"]
+        },
+        defaultConfig: {
+          limit: 5,
+          threshold: 0.3
+        },
+        configSchema: {
+          supportsInstances: true,
+          instanceLabel: "Add Knowledge Base",
+          properties: {
+            threshold: {
+              type: "number",
+              label: "Similarity Threshold",
+              description: "Minimum similarity score (0-1). Lower values return more results.",
+              default: 0.3
             },
-            buyer: {
-              type: "object",
-              description: "Buyer information (optional, can be added later via update)",
-              properties: {
-                email: { type: "string", description: "Buyer email address" },
-                first_name: { type: "string", description: "Buyer first name" },
-                last_name: { type: "string", description: "Buyer last name" },
-                phone_number: { type: "string", description: "Buyer phone number" }
-              }
+            displayName: {
+              type: "string",
+              label: "Display Name",
+              description: 'Name shown to the AI model (e.g., "Search Documentation")',
+              required: true
             },
-            context: {
-              type: "object",
-              description: "Buyer context for localization and intent",
-              properties: {
-                address_country: { type: "string", description: "ISO 3166-1 alpha-2 country code" },
-                language: { type: "string", description: "BCP-47 language tag" },
-                currency: { type: "string", description: "ISO 4217 currency code" },
-                intent: { type: "string", description: "Buyer intent description" }
-              }
+            provider: {
+              type: "select",
+              label: "Vector Provider",
+              description: "Where the vectors are stored",
+              required: true,
+              default: "pgvector",
+              options: [
+                { value: "pgvector", label: "Platform (pgvector)" },
+                { value: "weaviate", label: "Weaviate" },
+                { value: "vectorize", label: "Cloudflare Vectorize" }
+              ]
             },
-            fulfillment: {
-              type: "object",
-              description: "Fulfillment preferences",
-              properties: {
-                methods: {
-                  type: "array",
-                  description: "Fulfillment methods",
-                  items: {
-                    type: "object",
-                    properties: {
-                      type: {
-                        type: "string",
-                        description: "Fulfillment type",
-                        enum: ["shipping", "pickup", "digital"]
-                      },
-                      destinations: {
-                        type: "array",
-                        description: "Destinations for this fulfillment method",
-                        items: {
-                          type: "object",
-                          properties: {
-                            first_name: { type: "string", description: "Recipient first name" },
-                            last_name: { type: "string", description: "Recipient last name" },
-                            address: {
-                              type: "object",
-                              description: "Destination address",
-                              properties: {
-                                address1: { type: "string", description: "Street address line 1" },
-                                address2: { type: "string", description: "Street address line 2" },
-                                city: { type: "string", description: "City" },
-                                province_code: { type: "string", description: "State/province code" },
-                                postal_code: { type: "string", description: "Postal/ZIP code" },
-                                country_code: { type: "string", description: "ISO 3166-1 alpha-2 country code" }
-                              }
-                            },
-                            phone_number: { type: "string", description: "Recipient phone number" }
-                          }
-                        }
-                      },
-                      line_item_ids: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "Line item IDs fulfilled by this method"
-                      },
-                      selected_destination_id: {
-                        type: "string",
-                        description: "Selected destination ID for this method"
-                      },
-                      groups: {
-                        type: "array",
-                        description: "Fulfillment groups with selected options. After the server returns groups with available options, send back the group ID and the selected_option_id to choose a fulfillment option.",
-                        items: {
-                          type: "object",
-                          properties: {
-                            id: { type: "string", description: "Group ID from the checkout response" },
-                            selected_option_id: {
-                              type: "string",
-                              description: "ID of the selected fulfillment option within this group"
-                            }
-                          },
-                          required: ["id", "selected_option_id"]
-                        }
-                      }
-                    },
-                    required: ["type"]
-                  }
-                }
-              }
+            recordType: {
+              type: "string",
+              label: "Record Type",
+              description: "Filter by record type (optional)",
+              dependsOn: { field: "provider", value: "pgvector" }
             },
-            bearerToken: {
+            weaviateClassName: {
               type: "string",
-              description: "Bearer token for authenticated checkout (optional)"
+              label: "Collection Name",
+              description: "Weaviate collection to search",
+              required: true,
+              dependsOn: { field: "provider", value: "weaviate" }
+            },
+            vectorizeIndexName: {
+              type: "string",
+              label: "Index Name",
+              description: "Vectorize index to search",
+              required: true,
+              dependsOn: { field: "provider", value: "vectorize" }
             }
-          },
-          required: ["domain", "items"]
+          }
         },
-        executionHint: "platform",
-        requiresApiKey: false,
-        platformKeySupport: false
+        requiresApiKey: true,
+        // Requires OpenAI key for embeddings
+        executionHint: "platform"
       },
+      // ElevenLabs Text-to-Speech
       {
-        id: "ucp_update_checkout",
-        name: "UCP Update Checkout",
-        description: "Update an existing UCP checkout session with buyer information, shipping details, discount codes, or fulfillment preferences. All fields are optional \u2014 include only what you want to update.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "elevenlabs-tts",
+        name: "ElevenLabs Text-to-Speech",
+        description: "Convert text to natural-sounding speech using ElevenLabs AI voices",
+        category: exports.BuiltInToolCategory.TEXT_TO_SPEECH,
+        toolGroup: exports.BuiltInToolGroup.VOICE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            text: {
+              type: "string",
+              description: "Text to convert to speech",
+              minLength: 1,
+              maxLength: 5e3
+            },
+            voice_id: {
+              type: "string",
+              description: "ElevenLabs voice ID or name",
+              default: "rachel"
+            },
+            model_id: {
+              type: "string",
+              description: "ElevenLabs model ID",
+              default: "eleven_multilingual_v2"
+            },
+            stability: {
+              type: "number",
+              description: "Voice stability (0-1)",
+              minimum: 0,
+              maximum: 1,
+              default: 0.5
+            },
+            similarity_boost: {
+              type: "number",
+              description: "Voice similarity boost (0-1)",
+              minimum: 0,
+              maximum: 1,
+              default: 0.75
+            }
+          },
+          required: ["text"]
+        },
+        defaultConfig: {
+          voice_id: "rachel",
+          // @snake-case-ok: ElevenLabs API
+          model_id: "eleven_multilingual_v2",
+          // @snake-case-ok: ElevenLabs API
+          stability: 0.5,
+          similarity_boost: 0.75
+          // @snake-case-ok: ElevenLabs API
+        },
+        executionHint: "platform",
+        requiresApiKey: true,
+        platformKeySupport: true,
+        marginPercent: 20,
+        hidden: true
+      },
+      // ElevenLabs Speech-to-Text
+      {
+        id: "elevenlabs-stt",
+        name: "ElevenLabs Speech-to-Text",
+        description: "Transcribe audio to text using ElevenLabs Scribe models",
+        category: exports.BuiltInToolCategory.TEXT_TO_SPEECH,
+        toolGroup: exports.BuiltInToolGroup.VOICE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            audio: {
+              type: "string",
+              description: "Base64-encoded audio data",
+              minLength: 1
+            },
+            format: {
+              type: "string",
+              description: "Audio format (wav, mp3, webm, etc.)",
+              default: "wav"
+            },
+            model_id: {
+              type: "string",
+              description: "ElevenLabs STT model (scribe_v1 or scribe_v2)",
+              default: "scribe_v2"
+            },
+            language_code: {
+              type: "string",
+              description: "ISO-639-1 language code (optional, auto-detected if omitted)"
+            }
+          },
+          required: ["audio"]
+        },
+        defaultConfig: {
+          format: "wav",
+          model_id: "scribe_v2"
+          // @snake-case-ok: ElevenLabs API
+        },
+        executionHint: "platform",
+        requiresApiKey: true,
+        platformKeySupport: true,
+        marginPercent: 20,
+        hidden: true
+      },
+      // Artifact-emit tools (auto-injected at runtime when ArtifactConfig is enabled)
+      {
+        id: "emit_artifact_markdown",
+        name: "Emit Artifact (Markdown)",
+        description: "Stream markdown content to the artifact channel on supported clients.",
+        category: exports.BuiltInToolCategory.ARTIFACT,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            title: {
+              type: "string",
+              description: "Optional title for the artifact"
+            },
+            markdown: {
+              type: "string",
+              description: "Markdown content to render"
+            }
+          },
+          required: ["markdown"]
+        },
+        executionHint: "platform",
+        hidden: true
+      },
+      {
+        id: "emit_artifact_component",
+        name: "Emit Artifact (Component)",
+        description: "Emit a named component reference with props to the artifact channel. The client renders it using its registered component library.",
+        category: exports.BuiltInToolCategory.ARTIFACT,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            title: {
+              type: "string",
+              description: "Optional title for the artifact"
+            },
+            component: {
+              type: "string",
+              description: "Name of a component registered in the client-side component registry"
+            },
+            props: {
+              type: "object",
+              description: "Props object passed to the component renderer"
+            }
+          },
+          required: ["component"]
+        },
+        executionHint: "platform",
+        hidden: true
+      },
+      // Asset Storage — mirror files onto Runtype's CDN from a URL or inline bytes
+      {
+        id: "store_asset",
+        name: "Store Asset",
+        description: "Store a file on Runtype's CDN and get back a permanent URL (public) or time-limited signed URL (private). Two modes: (1) pass `url` to download from an HTTP(S) URL, or (2) pass base64-encoded `content` plus `contentType` to upload inline bytes directly \u2014 useful when running inside a sandboxed code-execution environment with restricted outbound network. Exactly one of `url` or `content` must be provided. Files are served as attachments (the URL downloads rather than rendering). To publish an HTML page that renders in the browser, use `publish_page` instead. 25 MB max.",
+        category: exports.BuiltInToolCategory.FILE_OPERATIONS,
+        toolGroup: exports.BuiltInToolGroup.FILE_OUTPUTS,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            url: {
+              type: "string",
+              description: "HTTP(S) URL of the file to download and store. Provide this OR `content`, not both."
+            },
+            content: {
+              type: "string",
+              description: 'Base64-encoded file bytes to store directly, without downloading. Provide this OR `url`, not both. Requires `contentType`. A leading data: URI prefix (e.g. "data:text/html;base64,") is stripped automatically if present.'
+            },
+            contentType: {
+              type: "string",
+              description: 'MIME type for inline content (required when `content` is supplied). Example: "text/html", "image/png", "application/pdf". Ignored when `url` is used.'
+            },
+            filename: {
+              type: "string",
+              description: "Optional filename for the stored file"
+            },
+            visibility: {
+              type: "string",
+              enum: ["public", "private"],
+              description: 'Access control. "public" = anyone with the URL can access. "private" = returns a signed URL that expires (default 1 hour). Default: "public".'
+            }
+          },
+          required: []
+        },
+        executionHint: "platform",
+        platformKeySupport: true,
+        requiresApiKey: false
+      },
+      // Publish Page — render HTML inline in the browser at a shareable URL
+      {
+        id: "publish_page",
+        name: "Publish Page",
+        description: "Publish an HTML page on Runtype's CDN and get back a shareable URL that renders the page inline in the browser. Two source modes: (1) pass `url` to download an HTML file from an HTTP(S) URL, or (2) pass base64-encoded `content` (defaults to `contentType: text/html`) to upload inline HTML directly \u2014 useful when running inside a sandboxed code-execution environment with restricted outbound network. Exactly one of `url` or `content` must be provided. Served inline from a `/preview/` path under a locked-down CSP that blocks scripts, network requests, and form submissions. Page URLs are public and expire after 7 days. Accepts only HTML content. 25 MB max. To host a non-HTML file, or HTML as a permanent downloadable file, use `store_asset` instead.",
+        category: exports.BuiltInToolCategory.FILE_OPERATIONS,
+        toolGroup: exports.BuiltInToolGroup.FILE_OUTPUTS,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            url: {
+              type: "string",
+              description: "HTTP(S) URL of an HTML file to download and publish. Provide this OR `content`, not both."
+            },
+            content: {
+              type: "string",
+              description: 'Base64-encoded HTML bytes to publish directly. Provide this OR `url`, not both. A leading data: URI prefix (e.g. "data:text/html;base64,") is stripped automatically if present.'
+            },
+            contentType: {
+              type: "string",
+              description: 'MIME type for inline content. Defaults to "text/html". Must be an HTML type \u2014 anything else is rejected. Ignored when `url` is used.'
+            },
+            filename: {
+              type: "string",
+              description: "Optional filename for the stored page"
+            }
+          },
+          required: []
+        },
+        executionHint: "platform",
+        platformKeySupport: true,
+        requiresApiKey: false
+      },
+      // Generate PDF — render HTML or Markdown to a PDF document
+      {
+        id: "generate_pdf",
+        name: "Generate PDF",
+        description: "Render HTML or Markdown to a PDF file and store it on Runtype's CDN. Returns a permanent public URL or a time-limited signed URL (default 1 hour) depending on `visibility`. Exactly one of `html` or `markdown` must be provided \u2014 markdown is rendered with GFM in an A4 print shell with sensible typography; html is passed through untouched so callers can control their own fonts and CSS. Optional `pdfOptions` (format, landscape, margin, printBackground, displayHeaderFooter, headerTemplate, footerTemplate, scale, pageRanges, preferCSSPageSize, omitBackground) are forwarded to the renderer. Source is capped at 2 MB; output is capped at 25 MB. Powered by Cloudflare Browser Rendering.",
+        category: exports.BuiltInToolCategory.FILE_OPERATIONS,
+        toolGroup: exports.BuiltInToolGroup.FILE_OUTPUTS,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            html: {
+              type: "string",
+              description: "Complete HTML document (or fragment) to render. Callers supply their own styling. Provide this OR `markdown`, not both."
+            },
+            markdown: {
+              type: "string",
+              description: "Markdown source. Rendered with GFM and wrapped in an A4 print shell. Inline HTML inside the markdown is escaped. Provide this OR `html`, not both."
+            },
+            filename: {
+              type: "string",
+              description: "Optional filename for the stored PDF (defaults to `document-<timestamp>.pdf`)."
+            },
+            visibility: {
+              type: "string",
+              enum: ["public", "private"],
+              description: 'Access control. "public" returns a permanent URL; "private" returns a signed URL that expires (default 1 hour). Default: "public".'
+            },
+            pdfOptions: {
+              type: "object",
+              description: "Optional puppeteer `page.pdf()` options (whitelisted).",
+              properties: {
+                format: {
+                  type: "string",
+                  description: 'Paper format (e.g. "a4", "letter", "legal"). Overrides width/height.'
+                },
+                landscape: { type: "boolean" },
+                printBackground: { type: "boolean" },
+                displayHeaderFooter: { type: "boolean" },
+                headerTemplate: {
+                  type: "string",
+                  description: "HTML template for the print header. Supports `date`, `title`, `url`, `pageNumber`, `totalPages` classes."
+                },
+                footerTemplate: { type: "string" },
+                scale: {
+                  type: "number",
+                  description: "Rendering scale, between 0.1 and 2. Default 1."
+                },
+                preferCSSPageSize: { type: "boolean" },
+                pageRanges: {
+                  type: "string",
+                  description: 'Page ranges to include, e.g. "1-5, 8, 11-13". Default: all pages.'
+                },
+                omitBackground: { type: "boolean" },
+                margin: {
+                  type: "object",
+                  properties: {
+                    top: { type: "string" },
+                    right: { type: "string" },
+                    bottom: { type: "string" },
+                    left: { type: "string" }
+                  }
+                }
+              }
+            }
+          },
+          required: []
+        },
+        executionHint: "platform",
+        platformKeySupport: true,
+        requiresApiKey: false
+      },
+      // Record Management Tools — CRUD operations on Runtype records
+      {
+        id: "runtype_record_upsert",
+        name: "Upsert Record",
+        description: "Create or update a Runtype record with structured metadata. Records are identified by type and name. If a record with the same type and name already exists, it will be updated based on the merge strategy.",
+        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        toolGroup: exports.BuiltInToolGroup.RECORD_MANAGEMENT,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            type: {
+              type: "string",
+              description: 'Record type category (e.g., "customer", "order", "note", "task")'
+            },
+            name: {
+              type: "string",
+              description: "Unique name for this record within its type"
+            },
+            metadata: {
+              type: "object",
+              description: "JSON object containing the record data"
+            },
+            mergeStrategy: {
+              type: "string",
+              description: 'How to handle existing data when updating: "merge" (shallow merge, new keys override) or "replace" (completely replace metadata)',
+              enum: ["merge", "replace"],
+              default: "merge"
+            }
+          },
+          required: ["type", "name", "metadata"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "runtype_record_batch_upsert",
+        name: "Batch Upsert Records",
+        description: "Create or update multiple Runtype records at once in a single transaction. Each record is identified by type and name. Maximum 100 records per call.",
+        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        toolGroup: exports.BuiltInToolGroup.RECORD_MANAGEMENT,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            records: {
+              type: "array",
+              description: "Array of records to upsert (max 100)",
+              items: {
+                type: "object",
+                properties: {
+                  type: {
+                    type: "string",
+                    description: "Record type category"
+                  },
+                  name: {
+                    type: "string",
+                    description: "Unique name within this type"
+                  },
+                  metadata: {
+                    type: "object",
+                    description: "JSON object containing the record data"
+                  }
+                },
+                required: ["type", "name", "metadata"]
+              }
+            },
+            mergeStrategy: {
+              type: "string",
+              description: 'How to handle existing data: "merge" or "replace". Applies to all records.',
+              enum: ["merge", "replace"],
+              default: "merge"
+            }
+          },
+          required: ["records"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "runtype_record_get",
+        name: "Get Record",
+        description: "Retrieve a single Runtype record by its type and name. Returns the full record including metadata, or null if not found.",
+        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        toolGroup: exports.BuiltInToolGroup.RECORD_MANAGEMENT,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            type: {
+              type: "string",
+              description: "Record type to look up"
+            },
+            name: {
+              type: "string",
+              description: "Record name to look up"
+            }
+          },
+          required: ["type", "name"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "runtype_record_list",
+        name: "List Records",
+        description: "List and search Runtype records with optional filtering by type and text search. Returns paginated results.",
+        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        toolGroup: exports.BuiltInToolGroup.RECORD_MANAGEMENT,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            type: {
+              type: "string",
+              description: "Filter by record type (optional)"
+            },
+            search: {
+              type: "string",
+              description: "Text search across record names (optional, case-insensitive)"
+            },
+            limit: {
+              type: "number",
+              description: "Maximum number of records to return (1-50, default 20)",
+              minimum: 1,
+              maximum: 50,
+              default: 20
+            },
+            offset: {
+              type: "number",
+              description: "Number of records to skip for pagination (default 0)",
+              minimum: 0,
+              default: 0
+            }
+          },
+          required: []
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "runtype_record_delete",
+        name: "Delete Record",
+        description: "Delete a Runtype record by its type and name. Returns whether the record was found and deleted.",
+        category: exports.BuiltInToolCategory.DATA_MANAGEMENT,
+        toolGroup: exports.BuiltInToolGroup.RECORD_MANAGEMENT,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            type: {
+              type: "string",
+              description: "Record type of the record to delete"
+            },
+            name: {
+              type: "string",
+              description: "Name of the record to delete"
+            }
+          },
+          required: ["type", "name"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      // UCP (Universal Commerce Protocol) Tools — interact with any UCP-enabled merchant
+      {
+        id: "ucp_discover",
+        name: "UCP Discover",
+        description: "Discover the commerce capabilities of a UCP-enabled website. Fetches the merchant's /.well-known/ucp discovery profile to determine supported services, capabilities, and payment handlers. Returns the UCP version, available services (REST/MCP/A2A endpoints), capabilities (checkout, cart, catalog, fulfillment, discount, order), and payment handler namespaces. Call this first before any other UCP operation.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: {
+              type: "string",
+              description: 'Domain of the UCP-enabled site (e.g., "erleia.com"). The discovery manifest will be fetched from https://{domain}/.well-known/ucp'
+            }
+          },
+          required: ["domain"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_create_checkout",
+        name: "UCP Create Checkout",
+        description: "Create a new checkout session with a UCP-enabled merchant. Provide the items to purchase and optional buyer/fulfillment information. Returns a checkout session with a sessionId for subsequent updates.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: {
+              type: "string",
+              description: 'Domain of the UCP-enabled merchant (e.g., "erleia.com")'
+            },
+            items: {
+              type: "array",
+              description: "Line items for the checkout",
+              items: {
+                type: "object",
+                properties: {
+                  id: { type: "string", description: "Product/variant identifier from the merchant" },
+                  quantity: { type: "number", description: "Quantity to purchase" }
+                },
+                required: ["id", "quantity"]
+              }
+            },
+            buyer: {
+              type: "object",
+              description: "Buyer information (optional, can be added later via update)",
+              properties: {
+                email: { type: "string", description: "Buyer email address" },
+                first_name: { type: "string", description: "Buyer first name" },
+                last_name: { type: "string", description: "Buyer last name" },
+                phone_number: { type: "string", description: "Buyer phone number" }
+              }
+            },
+            context: {
+              type: "object",
+              description: "Buyer context for localization and intent",
+              properties: {
+                address_country: { type: "string", description: "ISO 3166-1 alpha-2 country code" },
+                language: { type: "string", description: "BCP-47 language tag" },
+                currency: { type: "string", description: "ISO 4217 currency code" },
+                intent: { type: "string", description: "Buyer intent description" }
+              }
+            },
+            fulfillment: {
+              type: "object",
+              description: "Fulfillment preferences",
+              properties: {
+                methods: {
+                  type: "array",
+                  description: "Fulfillment methods",
+                  items: {
+                    type: "object",
+                    properties: {
+                      type: {
+                        type: "string",
+                        description: "Fulfillment type",
+                        enum: ["shipping", "pickup", "digital"]
+                      },
+                      destinations: {
+                        type: "array",
+                        description: "Destinations for this fulfillment method",
+                        items: {
+                          type: "object",
+                          properties: {
+                            first_name: { type: "string", description: "Recipient first name" },
+                            last_name: { type: "string", description: "Recipient last name" },
+                            address: {
+                              type: "object",
+                              description: "Destination address",
+                              properties: {
+                                address1: { type: "string", description: "Street address line 1" },
+                                address2: { type: "string", description: "Street address line 2" },
+                                city: { type: "string", description: "City" },
+                                province_code: { type: "string", description: "State/province code" },
+                                postal_code: { type: "string", description: "Postal/ZIP code" },
+                                country_code: { type: "string", description: "ISO 3166-1 alpha-2 country code" }
+                              }
+                            },
+                            phone_number: { type: "string", description: "Recipient phone number" }
+                          }
+                        }
+                      },
+                      line_item_ids: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Line item IDs fulfilled by this method"
+                      },
+                      selected_destination_id: {
+                        type: "string",
+                        description: "Selected destination ID for this method"
+                      },
+                      groups: {
+                        type: "array",
+                        description: "Fulfillment groups with selected options. After the server returns groups with available options, send back the group ID and the selected_option_id to choose a fulfillment option.",
+                        items: {
+                          type: "object",
+                          properties: {
+                            id: { type: "string", description: "Group ID from the checkout response" },
+                            selected_option_id: {
+                              type: "string",
+                              description: "ID of the selected fulfillment option within this group"
+                            }
+                          },
+                          required: ["id", "selected_option_id"]
+                        }
+                      }
+                    },
+                    required: ["type"]
+                  }
+                }
+              }
+            },
+            bearerToken: {
+              type: "string",
+              description: "Bearer token for authenticated checkout (optional)"
+            }
+          },
+          required: ["domain", "items"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_update_checkout",
+        name: "UCP Update Checkout",
+        description: "Update an existing UCP checkout session with buyer information, shipping details, discount codes, or fulfillment preferences. All fields are optional \u2014 include only what you want to update.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: {
+              type: "string",
+              description: "Domain of the UCP-enabled merchant"
+            },
+            id: {
+              type: "string",
+              description: "Checkout session ID from the create checkout response"
+            },
+            buyer: {
+              type: "object",
+              description: "Updated buyer information",
+              properties: {
+                email: { type: "string", description: "Buyer email address" },
+                first_name: { type: "string", description: "Buyer first name" },
+                last_name: { type: "string", description: "Buyer last name" },
+                phone_number: { type: "string", description: "Buyer phone number" }
+              }
+            },
+            context: {
+              type: "object",
+              description: "Buyer context for localization and intent",
+              properties: {
+                address_country: { type: "string", description: "ISO 3166-1 alpha-2 country code" },
+                language: { type: "string", description: "BCP-47 language tag" },
+                currency: { type: "string", description: "ISO 4217 currency code" },
+                intent: { type: "string", description: "Buyer intent description" }
+              }
+            },
+            fulfillment: {
+              type: "object",
+              description: "Updated fulfillment preferences",
+              properties: {
+                methods: {
+                  type: "array",
+                  description: "Fulfillment methods",
+                  items: {
+                    type: "object",
+                    properties: {
+                      type: {
+                        type: "string",
+                        description: "Fulfillment type",
+                        enum: ["shipping", "pickup", "digital"]
+                      },
+                      destinations: {
+                        type: "array",
+                        description: "Destinations for this fulfillment method",
+                        items: {
+                          type: "object",
+                          properties: {
+                            first_name: { type: "string", description: "Recipient first name" },
+                            last_name: { type: "string", description: "Recipient last name" },
+                            address: {
+                              type: "object",
+                              description: "Destination address",
+                              properties: {
+                                address1: { type: "string", description: "Street address line 1" },
+                                address2: { type: "string", description: "Street address line 2" },
+                                city: { type: "string", description: "City" },
+                                province_code: { type: "string", description: "State/province code" },
+                                postal_code: { type: "string", description: "Postal/ZIP code" },
+                                country_code: { type: "string", description: "ISO 3166-1 alpha-2 country code" }
+                              }
+                            },
+                            phone_number: { type: "string", description: "Recipient phone number" }
+                          }
+                        }
+                      },
+                      line_item_ids: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Line item IDs fulfilled by this method"
+                      },
+                      selected_destination_id: {
+                        type: "string",
+                        description: "Selected destination ID for this method"
+                      },
+                      groups: {
+                        type: "array",
+                        description: "Fulfillment groups with selected options. After the server returns groups with available options, send back the group ID and the selected_option_id to choose a fulfillment option.",
+                        items: {
+                          type: "object",
+                          properties: {
+                            id: { type: "string", description: "Group ID from the checkout response" },
+                            selected_option_id: {
+                              type: "string",
+                              description: "ID of the selected fulfillment option within this group"
+                            }
+                          },
+                          required: ["id", "selected_option_id"]
+                        }
+                      }
+                    },
+                    required: ["type"]
+                  }
+                }
+              }
+            },
+            discount_codes: {
+              type: "array",
+              description: "Discount codes to apply",
+              items: { type: "string" }
+            },
+            line_items: {
+              type: "array",
+              description: "Updated line items (full replacement)",
+              items: {
+                type: "object",
+                properties: {
+                  id: { type: "string", description: "Product/variant identifier" },
+                  quantity: { type: "number", description: "Quantity" }
+                },
+                required: ["id", "quantity"]
+              }
+            },
+            bearerToken: {
+              type: "string",
+              description: "Bearer token for authenticated checkout (optional)"
+            }
+          },
+          required: ["domain", "id"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_get_checkout",
+        name: "UCP Get Checkout",
+        description: "Retrieve the current state of a UCP checkout session. Returns the full session including status (incomplete, requires_escalation, ready_for_complete, complete_in_progress, completed, canceled), line items, buyer info, and available payment methods.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
@@ -12297,11 +13211,187 @@ var require_builtin_tools_registry = __commonJS({
             },
             id: {
               type: "string",
-              description: "Checkout session ID from the create checkout response"
+              description: "Checkout session ID"
+            },
+            bearerToken: {
+              type: "string",
+              description: "Bearer token for authenticated checkout (optional)"
+            }
+          },
+          required: ["domain", "id"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_complete_checkout",
+        name: "UCP Complete Checkout",
+        description: 'Complete a UCP checkout session by submitting payment credentials. The checkout must be in "ready_for_complete" status. Returns the order confirmation with order ID and permalink. IMPORTANT: This initiates a real purchase \u2014 use with approval.require for human-in-the-loop confirmation.',
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: {
+              type: "string",
+              description: "Domain of the UCP-enabled merchant"
+            },
+            id: {
+              type: "string",
+              description: "Checkout session ID"
+            },
+            handler_id: {
+              type: "string",
+              description: "Payment handler ID from the checkout session's available payment handlers"
+            },
+            payment_token: {
+              type: "string",
+              description: "Payment token from the payment provider"
+            },
+            payment_type: {
+              type: "string",
+              description: 'Credential type discriminator (e.g., "token", "card")'
+            },
+            bearerToken: {
+              type: "string",
+              description: "Bearer token for authenticated checkout (optional)"
+            }
+          },
+          required: ["domain", "id", "handler_id", "payment_token"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_cancel_checkout",
+        name: "UCP Cancel Checkout",
+        description: "Cancel an active UCP checkout session. Can be called on any session that is not already completed or cancelled.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: {
+              type: "string",
+              description: "Domain of the UCP-enabled merchant"
+            },
+            id: {
+              type: "string",
+              description: "Checkout session ID to cancel"
+            },
+            bearerToken: {
+              type: "string",
+              description: "Bearer token for authenticated checkout (optional)"
+            }
+          },
+          required: ["domain", "id"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_create_cart",
+        name: "UCP Create Cart",
+        description: "Create a shopping cart with a UCP-enabled merchant for price estimation before checkout. Carts are lightweight \u2014 no payment info needed. Convert to checkout when ready to purchase.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
+            items: {
+              type: "array",
+              description: "Line items for the cart",
+              items: {
+                type: "object",
+                properties: {
+                  id: { type: "string", description: "Product or variant identifier" },
+                  quantity: { type: "number", description: "Quantity" }
+                },
+                required: ["id", "quantity"]
+              }
+            },
+            buyer: {
+              type: "object",
+              description: "Buyer information (optional)",
+              properties: {
+                email: { type: "string", description: "Buyer email address" },
+                first_name: { type: "string", description: "Buyer first name" },
+                last_name: { type: "string", description: "Buyer last name" },
+                phone_number: { type: "string", description: "Buyer phone number" }
+              }
+            },
+            context: {
+              type: "object",
+              description: "Optional buyer context for localization",
+              properties: {
+                address_country: { type: "string", description: "ISO 3166-1 alpha-2 country code" },
+                language: { type: "string", description: "BCP-47 language tag" },
+                currency: { type: "string", description: "ISO 4217 currency code" },
+                intent: { type: "string", description: "Buyer intent description" }
+              }
+            },
+            bearerToken: { type: "string", description: "Bearer token for authenticated session (optional)" }
+          },
+          required: ["domain", "items"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_get_cart",
+        name: "UCP Get Cart",
+        description: "Retrieve the current state of a UCP cart session including estimated pricing, line items, and any messages.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
+            id: { type: "string", description: "Cart session ID" },
+            bearerToken: { type: "string", description: "Bearer token (optional)" }
+          },
+          required: ["domain", "id"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_update_cart",
+        name: "UCP Update Cart",
+        description: "Update a UCP cart session. Line items are full-replacement \u2014 send the complete list of items you want in the cart.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
+            id: { type: "string", description: "Cart session ID" },
+            items: {
+              type: "array",
+              description: "Updated line items (full replacement)",
+              items: {
+                type: "object",
+                properties: {
+                  id: { type: "string", description: "Product or variant identifier" },
+                  quantity: { type: "number", description: "Quantity" }
+                },
+                required: ["id", "quantity"]
+              }
             },
             buyer: {
               type: "object",
-              description: "Updated buyer information",
+              description: "Buyer information (optional)",
               properties: {
                 email: { type: "string", description: "Buyer email address" },
                 first_name: { type: "string", description: "Buyer first name" },
@@ -12311,104 +13401,173 @@ var require_builtin_tools_registry = __commonJS({
             },
             context: {
               type: "object",
-              description: "Buyer context for localization and intent",
+              description: "Optional buyer context for localization",
               properties: {
-                address_country: { type: "string", description: "ISO 3166-1 alpha-2 country code" },
-                language: { type: "string", description: "BCP-47 language tag" },
-                currency: { type: "string", description: "ISO 4217 currency code" },
-                intent: { type: "string", description: "Buyer intent description" }
+                address_country: { type: "string" },
+                language: { type: "string" },
+                currency: { type: "string" },
+                intent: { type: "string" }
               }
             },
-            fulfillment: {
+            bearerToken: { type: "string", description: "Bearer token (optional)" }
+          },
+          required: ["domain", "id"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_cancel_cart",
+        name: "UCP Cancel Cart",
+        description: "Cancel a UCP cart session.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
+            id: { type: "string", description: "Cart session ID to cancel" },
+            bearerToken: { type: "string", description: "Bearer token (optional)" }
+          },
+          required: ["domain", "id"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_search_catalog",
+        name: "UCP Search Catalog",
+        description: "Search a UCP merchant's product catalog by text query. Returns matching items with id, name, description, and price.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
+            query: { type: "string", description: "Free-text search query" },
+            context: {
               type: "object",
-              description: "Updated fulfillment preferences",
+              description: "Buyer context for localization (country, language, currency)",
               properties: {
-                methods: {
-                  type: "array",
-                  description: "Fulfillment methods",
-                  items: {
-                    type: "object",
-                    properties: {
-                      type: {
-                        type: "string",
-                        description: "Fulfillment type",
-                        enum: ["shipping", "pickup", "digital"]
-                      },
-                      destinations: {
-                        type: "array",
-                        description: "Destinations for this fulfillment method",
-                        items: {
-                          type: "object",
-                          properties: {
-                            first_name: { type: "string", description: "Recipient first name" },
-                            last_name: { type: "string", description: "Recipient last name" },
-                            address: {
-                              type: "object",
-                              description: "Destination address",
-                              properties: {
-                                address1: { type: "string", description: "Street address line 1" },
-                                address2: { type: "string", description: "Street address line 2" },
-                                city: { type: "string", description: "City" },
-                                province_code: { type: "string", description: "State/province code" },
-                                postal_code: { type: "string", description: "Postal/ZIP code" },
-                                country_code: { type: "string", description: "ISO 3166-1 alpha-2 country code" }
-                              }
-                            },
-                            phone_number: { type: "string", description: "Recipient phone number" }
-                          }
-                        }
-                      },
-                      line_item_ids: {
-                        type: "array",
-                        items: { type: "string" },
-                        description: "Line item IDs fulfilled by this method"
-                      },
-                      selected_destination_id: {
-                        type: "string",
-                        description: "Selected destination ID for this method"
-                      },
-                      groups: {
-                        type: "array",
-                        description: "Fulfillment groups with selected options. After the server returns groups with available options, send back the group ID and the selected_option_id to choose a fulfillment option.",
-                        items: {
-                          type: "object",
-                          properties: {
-                            id: { type: "string", description: "Group ID from the checkout response" },
-                            selected_option_id: {
-                              type: "string",
-                              description: "ID of the selected fulfillment option within this group"
-                            }
-                          },
-                          required: ["id", "selected_option_id"]
-                        }
-                      }
-                    },
-                    required: ["type"]
-                  }
-                }
+                address_country: { type: "string" },
+                language: { type: "string" },
+                currency: { type: "string" },
+                intent: { type: "string" }
               }
             },
-            discount_codes: {
+            filters: {
+              type: "object",
+              description: "Search filters",
+              properties: {
+                in_stock: { type: "boolean", description: "Only show in-stock items" },
+                price_min: { type: "number", description: "Minimum price in minor units (cents)" },
+                price_max: { type: "number", description: "Maximum price in minor units (cents)" }
+              }
+            },
+            page_size: { type: "number", description: "Number of results per page" },
+            page_token: { type: "string", description: "Pagination token from previous response" },
+            bearerToken: { type: "string", description: "Bearer token (optional)" }
+          },
+          required: ["domain", "query"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_lookup_catalog",
+        name: "UCP Lookup Catalog",
+        description: "Batch lookup products or variants by their identifiers. Supports product IDs, variant IDs, SKUs, and handles. Returns items with id, name, description, and price.",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
+            ids: {
               type: "array",
-              description: "Discount codes to apply",
-              items: { type: "string" }
+              items: { type: "string" },
+              description: "Product, variant, or SKU identifiers to look up"
             },
-            line_items: {
+            context: {
+              type: "object",
+              description: "Buyer context for localization",
+              properties: {
+                address_country: { type: "string" },
+                language: { type: "string" },
+                currency: { type: "string" }
+              }
+            },
+            filters: {
+              type: "object",
+              description: "Optional filters (e.g., categories, price range, availability)",
+              properties: {
+                in_stock: { type: "boolean", description: "Only show in-stock items" },
+                price_min: { type: "number", description: "Minimum price in minor units (cents)" },
+                price_max: { type: "number", description: "Maximum price in minor units (cents)" }
+              }
+            },
+            bearerToken: { type: "string", description: "Bearer token (optional)" }
+          },
+          required: ["domain", "ids"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: false
+      },
+      {
+        id: "ucp_get_product",
+        name: "UCP Get Product",
+        description: "Get detailed information about a single product. Returns product id, name, description, price, options, and selected options. Use selected_options to narrow variants (e.g., select a color to see which sizes are available).",
+        category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
+            id: { type: "string", description: "Product or variant identifier" },
+            selected_options: {
               type: "array",
-              description: "Updated line items (full replacement)",
+              description: 'Option selections for interactive variant narrowing (e.g., [{name: "Color", value: "Blue"}])',
               items: {
                 type: "object",
                 properties: {
-                  id: { type: "string", description: "Product/variant identifier" },
-                  quantity: { type: "number", description: "Quantity" }
+                  name: { type: "string", description: 'Option name (e.g., "Color", "Size")' },
+                  value: { type: "string", description: 'Selected value (e.g., "Blue", "Large")' }
                 },
-                required: ["id", "quantity"]
+                required: ["name", "value"]
+              }
+            },
+            preferences: {
+              type: "array",
+              items: { type: "string" },
+              description: "Option names in relaxation priority order. When no exact match, drops from end first."
+            },
+            context: {
+              type: "object",
+              description: "Buyer context for localization",
+              properties: {
+                address_country: { type: "string" },
+                language: { type: "string" },
+                currency: { type: "string" }
               }
             },
-            bearerToken: {
-              type: "string",
-              description: "Bearer token for authenticated checkout (optional)"
-            }
+            filters: {
+              type: "object",
+              description: "Optional filters (e.g., categories, price range, availability)",
+              properties: {
+                in_stock: { type: "boolean", description: "Only show in-stock items" },
+                price_min: { type: "number", description: "Minimum price in minor units (cents)" },
+                price_max: { type: "number", description: "Maximum price in minor units (cents)" }
+              }
+            },
+            bearerToken: { type: "string", description: "Bearer token (optional)" }
           },
           required: ["domain", "id"]
         },
@@ -12417,26 +13576,18 @@ var require_builtin_tools_registry = __commonJS({
         platformKeySupport: false
       },
       {
-        id: "ucp_get_checkout",
-        name: "UCP Get Checkout",
-        description: "Retrieve the current state of a UCP checkout session. Returns the full session including status (incomplete, requires_escalation, ready_for_complete, complete_in_progress, completed, canceled), line items, buyer info, and available payment methods.",
+        id: "ucp_get_order",
+        name: "UCP Get Order",
+        description: "Retrieve the current state of an order. Returns order details including line items, fulfillment status, shipping tracking, and any post-order adjustments (refunds, returns, exchanges).",
         category: exports.BuiltInToolCategory.COMMERCE,
+        toolGroup: exports.BuiltInToolGroup.UCP_COMMERCE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: {
-              type: "string",
-              description: "Domain of the UCP-enabled merchant"
-            },
-            id: {
-              type: "string",
-              description: "Checkout session ID"
-            },
-            bearerToken: {
-              type: "string",
-              description: "Bearer token for authenticated checkout (optional)"
-            }
+            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
+            id: { type: "string", description: "Order ID from the completed checkout" },
+            bearerToken: { type: "string", description: "Bearer token (optional)" }
           },
           required: ["domain", "id"]
         },
@@ -12444,366 +13595,372 @@ var require_builtin_tools_registry = __commonJS({
         requiresApiKey: false,
         platformKeySupport: false
       },
+      // -----------------------------------------------------------------------
+      // Sandbox tools — Tier 1 (anonymous): sandbox provisioned automatically,
+      // model never sees sandboxId. Container reused across calls in one execution.
+      // -----------------------------------------------------------------------
       {
-        id: "ucp_complete_checkout",
-        name: "UCP Complete Checkout",
-        description: 'Complete a UCP checkout session by submitting payment credentials. The checkout must be in "ready_for_complete" status. Returns the order confirmation with order ID and permalink. IMPORTANT: This initiates a real purchase \u2014 use with approval.require for human-in-the-loop confirmation.',
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:exec",
+        name: "Sandbox Exec",
+        description: "Run a shell command in a Linux sandbox (Node 22, Python 3.12, git, pnpm). The sandbox persists across tool calls within the same execution \u2014 install packages, write files, then run them. Returns stdout, stderr, and exit code.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: {
-              type: "string",
-              description: "Domain of the UCP-enabled merchant"
-            },
-            id: {
+            command: {
               type: "string",
-              description: "Checkout session ID"
+              description: "Shell command to execute (runs in bash)"
             },
-            handler_id: {
+            timeout: {
+              type: "number",
+              description: "Timeout in seconds (default 30, max 300)"
+            }
+          },
+          required: ["command"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: true
+      },
+      {
+        id: "sandbox:run_code",
+        name: "Sandbox Run Code",
+        description: "Run a code snippet in the sandbox. Supports JavaScript, TypeScript, and Python. The result is the parsed JSON output (stdout) of the script. For JavaScript/TypeScript, the last expression or return value is captured.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_USE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            code: {
               type: "string",
-              description: "Payment handler ID from the checkout session's available payment handlers"
+              description: "Code to execute"
             },
-            payment_token: {
+            language: {
               type: "string",
-              description: "Payment token from the payment provider"
-            },
-            payment_type: {
+              enum: ["javascript", "typescript", "python"],
+              description: "Programming language (default: javascript)"
+            }
+          },
+          required: ["code"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: true
+      },
+      {
+        id: "sandbox:write_file",
+        name: "Sandbox Write File",
+        description: "Write a file to the sandbox filesystem. Creates parent directories automatically. Use sandbox:exec to run files after writing them.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_USE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            path: {
               type: "string",
-              description: 'Credential type discriminator (e.g., "token", "card")'
+              description: "File path in the sandbox (e.g., /home/user/app/index.js)"
             },
-            bearerToken: {
+            content: {
               type: "string",
-              description: "Bearer token for authenticated checkout (optional)"
+              description: "File content to write"
             }
           },
-          required: ["domain", "id", "handler_id", "payment_token"]
+          required: ["path", "content"]
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       },
       {
-        id: "ucp_cancel_checkout",
-        name: "UCP Cancel Checkout",
-        description: "Cancel an active UCP checkout session. Can be called on any session that is not already completed or cancelled.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:read_file",
+        name: "Sandbox Read File",
+        description: "Read a file from the sandbox filesystem. Returns the file content as a string.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: {
-              type: "string",
-              description: "Domain of the UCP-enabled merchant"
-            },
-            id: {
+            path: {
               type: "string",
-              description: "Checkout session ID to cancel"
+              description: "File path to read"
+            }
+          },
+          required: ["path"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: true
+      },
+      {
+        id: "sandbox:expose_port",
+        name: "Sandbox Expose Port",
+        description: "Expose a port from the sandbox and get a public preview URL. Use after starting a server process with sandbox:exec.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_USE,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            port: {
+              type: "number",
+              description: "Port number to expose (must not be 3000, which is reserved)"
             },
-            bearerToken: {
+            name: {
               type: "string",
-              description: "Bearer token for authenticated checkout (optional)"
+              description: "Optional name for the preview URL"
             }
           },
-          required: ["domain", "id"]
+          required: ["port"]
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       },
       {
-        id: "ucp_create_cart",
-        name: "UCP Create Cart",
-        description: "Create a shopping cart with a UCP-enabled merchant for price estimation before checkout. Carts are lightweight \u2014 no payment info needed. Convert to checkout when ready to purchase.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:git_checkout",
+        name: "Sandbox Git Checkout",
+        description: "Clone a git repository into the sandbox. The repo is cloned into the current working directory.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_USE,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
-            items: {
-              type: "array",
-              description: "Line items for the cart",
-              items: {
-                type: "object",
-                properties: {
-                  id: { type: "string", description: "Product or variant identifier" },
-                  quantity: { type: "number", description: "Quantity" }
-                },
-                required: ["id", "quantity"]
-              }
-            },
-            buyer: {
-              type: "object",
-              description: "Buyer information (optional)",
-              properties: {
-                email: { type: "string", description: "Buyer email address" },
-                first_name: { type: "string", description: "Buyer first name" },
-                last_name: { type: "string", description: "Buyer last name" },
-                phone_number: { type: "string", description: "Buyer phone number" }
-              }
-            },
-            context: {
-              type: "object",
-              description: "Optional buyer context for localization",
-              properties: {
-                address_country: { type: "string", description: "ISO 3166-1 alpha-2 country code" },
-                language: { type: "string", description: "BCP-47 language tag" },
-                currency: { type: "string", description: "ISO 4217 currency code" },
-                intent: { type: "string", description: "Buyer intent description" }
-              }
+            repo: {
+              type: "string",
+              description: "Git repository URL to clone"
             },
-            bearerToken: { type: "string", description: "Bearer token for authenticated session (optional)" }
+            branch: {
+              type: "string",
+              description: "Branch to checkout (default: main/master)"
+            }
           },
-          required: ["domain", "items"]
+          required: ["repo"]
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       },
+      // -----------------------------------------------------------------------
+      // Sandbox tools — Tier 2 (session): model manages sandboxId explicitly.
+      // Allows multiple sandboxes, persistent instances, and cross-execution reuse.
+      // -----------------------------------------------------------------------
       {
-        id: "ucp_get_cart",
-        name: "UCP Get Cart",
-        description: "Retrieve the current state of a UCP cart session including estimated pricing, line items, and any messages.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:create",
+        name: "Sandbox Create",
+        description: "Create a new sandbox instance. Returns a sandboxId to pass to session tools. If no sandboxId is provided, a random one is generated.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_SESSION,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
-            id: { type: "string", description: "Cart session ID" },
-            bearerToken: { type: "string", description: "Bearer token (optional)" }
-          },
-          required: ["domain", "id"]
+            sandboxId: {
+              type: "string",
+              description: "Optional custom sandbox ID. If omitted, a random ID is generated."
+            }
+          }
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       },
       {
-        id: "ucp_update_cart",
-        name: "UCP Update Cart",
-        description: "Update a UCP cart session. Line items are full-replacement \u2014 send the complete list of items you want in the cart.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:session_exec",
+        name: "Sandbox Session Exec",
+        description: "Run a shell command in a specific sandbox identified by sandboxId.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_SESSION,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
-            id: { type: "string", description: "Cart session ID" },
-            items: {
-              type: "array",
-              description: "Updated line items (full replacement)",
-              items: {
-                type: "object",
-                properties: {
-                  id: { type: "string", description: "Product or variant identifier" },
-                  quantity: { type: "number", description: "Quantity" }
-                },
-                required: ["id", "quantity"]
-              }
-            },
-            buyer: {
-              type: "object",
-              description: "Buyer information (optional)",
-              properties: {
-                email: { type: "string", description: "Buyer email address" },
-                first_name: { type: "string", description: "Buyer first name" },
-                last_name: { type: "string", description: "Buyer last name" },
-                phone_number: { type: "string", description: "Buyer phone number" }
-              }
+            sandboxId: {
+              type: "string",
+              description: "The sandbox ID returned by sandbox:create"
             },
-            context: {
-              type: "object",
-              description: "Optional buyer context for localization",
-              properties: {
-                address_country: { type: "string" },
-                language: { type: "string" },
-                currency: { type: "string" },
-                intent: { type: "string" }
-              }
+            command: {
+              type: "string",
+              description: "Shell command to execute"
             },
-            bearerToken: { type: "string", description: "Bearer token (optional)" }
+            timeout: {
+              type: "number",
+              description: "Timeout in seconds (default 30, max 300)"
+            }
           },
-          required: ["domain", "id"]
+          required: ["sandboxId", "command"]
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       },
       {
-        id: "ucp_cancel_cart",
-        name: "UCP Cancel Cart",
-        description: "Cancel a UCP cart session.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:session_run_code",
+        name: "Sandbox Session Run Code",
+        description: "Run a code snippet in a specific sandbox identified by sandboxId.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_SESSION,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
-            id: { type: "string", description: "Cart session ID to cancel" },
-            bearerToken: { type: "string", description: "Bearer token (optional)" }
+            sandboxId: {
+              type: "string",
+              description: "The sandbox ID returned by sandbox:create"
+            },
+            code: {
+              type: "string",
+              description: "Code to execute"
+            },
+            language: {
+              type: "string",
+              enum: ["javascript", "typescript", "python"],
+              description: "Programming language (default: javascript)"
+            }
           },
-          required: ["domain", "id"]
+          required: ["sandboxId", "code"]
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       },
       {
-        id: "ucp_search_catalog",
-        name: "UCP Search Catalog",
-        description: "Search a UCP merchant's product catalog by text query. Returns matching items with id, name, description, and price.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:session_write_file",
+        name: "Sandbox Session Write File",
+        description: "Write a file to a specific sandbox identified by sandboxId.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_SESSION,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
-            query: { type: "string", description: "Free-text search query" },
-            context: {
-              type: "object",
-              description: "Buyer context for localization (country, language, currency)",
-              properties: {
-                address_country: { type: "string" },
-                language: { type: "string" },
-                currency: { type: "string" },
-                intent: { type: "string" }
-              }
+            sandboxId: {
+              type: "string",
+              description: "The sandbox ID returned by sandbox:create"
             },
-            filters: {
-              type: "object",
-              description: "Search filters",
-              properties: {
-                in_stock: { type: "boolean", description: "Only show in-stock items" },
-                price_min: { type: "number", description: "Minimum price in minor units (cents)" },
-                price_max: { type: "number", description: "Maximum price in minor units (cents)" }
-              }
+            path: {
+              type: "string",
+              description: "File path in the sandbox"
             },
-            page_size: { type: "number", description: "Number of results per page" },
-            page_token: { type: "string", description: "Pagination token from previous response" },
-            bearerToken: { type: "string", description: "Bearer token (optional)" }
+            content: {
+              type: "string",
+              description: "File content to write"
+            }
           },
-          required: ["domain", "query"]
+          required: ["sandboxId", "path", "content"]
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       },
       {
-        id: "ucp_lookup_catalog",
-        name: "UCP Lookup Catalog",
-        description: "Batch lookup products or variants by their identifiers. Supports product IDs, variant IDs, SKUs, and handles. Returns items with id, name, description, and price.",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:session_read_file",
+        name: "Sandbox Session Read File",
+        description: "Read a file from a specific sandbox identified by sandboxId.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_SESSION,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
-            ids: {
-              type: "array",
-              items: { type: "string" },
-              description: "Product, variant, or SKU identifiers to look up"
-            },
-            context: {
-              type: "object",
-              description: "Buyer context for localization",
-              properties: {
-                address_country: { type: "string" },
-                language: { type: "string" },
-                currency: { type: "string" }
-              }
-            },
-            filters: {
-              type: "object",
-              description: "Optional filters (e.g., categories, price range, availability)",
-              properties: {
-                in_stock: { type: "boolean", description: "Only show in-stock items" },
-                price_min: { type: "number", description: "Minimum price in minor units (cents)" },
-                price_max: { type: "number", description: "Maximum price in minor units (cents)" }
-              }
+            sandboxId: {
+              type: "string",
+              description: "The sandbox ID returned by sandbox:create"
             },
-            bearerToken: { type: "string", description: "Bearer token (optional)" }
+            path: {
+              type: "string",
+              description: "File path to read"
+            }
           },
-          required: ["domain", "ids"]
+          required: ["sandboxId", "path"]
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       },
       {
-        id: "ucp_get_product",
-        name: "UCP Get Product",
-        description: "Get detailed information about a single product. Returns product id, name, description, price, options, and selected options. Use selected_options to narrow variants (e.g., select a color to see which sizes are available).",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:session_expose_port",
+        name: "Sandbox Session Expose Port",
+        description: "Expose a port from a specific sandbox and get a public preview URL.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_SESSION,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
-            id: { type: "string", description: "Product or variant identifier" },
-            selected_options: {
-              type: "array",
-              description: 'Option selections for interactive variant narrowing (e.g., [{name: "Color", value: "Blue"}])',
-              items: {
-                type: "object",
-                properties: {
-                  name: { type: "string", description: 'Option name (e.g., "Color", "Size")' },
-                  value: { type: "string", description: 'Selected value (e.g., "Blue", "Large")' }
-                },
-                required: ["name", "value"]
-              }
+            sandboxId: {
+              type: "string",
+              description: "The sandbox ID returned by sandbox:create"
             },
-            preferences: {
-              type: "array",
-              items: { type: "string" },
-              description: "Option names in relaxation priority order. When no exact match, drops from end first."
+            port: {
+              type: "number",
+              description: "Port number to expose"
             },
-            context: {
-              type: "object",
-              description: "Buyer context for localization",
-              properties: {
-                address_country: { type: "string" },
-                language: { type: "string" },
-                currency: { type: "string" }
-              }
+            name: {
+              type: "string",
+              description: "Optional name for the preview URL"
+            }
+          },
+          required: ["sandboxId", "port"]
+        },
+        executionHint: "platform",
+        requiresApiKey: false,
+        platformKeySupport: true
+      },
+      {
+        id: "sandbox:session_git_checkout",
+        name: "Sandbox Session Git Checkout",
+        description: "Clone a git repository into a specific sandbox identified by sandboxId.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_SESSION,
+        providers: [exports.BuiltInToolProvider.MULTI],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            sandboxId: {
+              type: "string",
+              description: "The sandbox ID returned by sandbox:create"
             },
-            filters: {
-              type: "object",
-              description: "Optional filters (e.g., categories, price range, availability)",
-              properties: {
-                in_stock: { type: "boolean", description: "Only show in-stock items" },
-                price_min: { type: "number", description: "Minimum price in minor units (cents)" },
-                price_max: { type: "number", description: "Maximum price in minor units (cents)" }
-              }
+            repo: {
+              type: "string",
+              description: "Git repository URL to clone"
             },
-            bearerToken: { type: "string", description: "Bearer token (optional)" }
+            branch: {
+              type: "string",
+              description: "Branch to checkout"
+            }
           },
-          required: ["domain", "id"]
+          required: ["sandboxId", "repo"]
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       },
       {
-        id: "ucp_get_order",
-        name: "UCP Get Order",
-        description: "Retrieve the current state of an order. Returns order details including line items, fulfillment status, shipping tracking, and any post-order adjustments (refunds, returns, exchanges).",
-        category: exports.BuiltInToolCategory.COMMERCE,
+        id: "sandbox:destroy",
+        name: "Sandbox Destroy",
+        description: "Destroy a sandbox instance and release its resources. Only available for session-managed sandboxes.",
+        category: exports.BuiltInToolCategory.SANDBOX,
+        toolGroup: exports.BuiltInToolGroup.SANDBOX_SESSION,
         providers: [exports.BuiltInToolProvider.MULTI],
         parametersSchema: {
           type: "object",
           properties: {
-            domain: { type: "string", description: "Domain of the UCP-enabled merchant" },
-            id: { type: "string", description: "Order ID from the completed checkout" },
-            bearerToken: { type: "string", description: "Bearer token (optional)" }
+            sandboxId: {
+              type: "string",
+              description: "The sandbox ID to destroy"
+            }
           },
-          required: ["domain", "id"]
+          required: ["sandboxId"]
         },
         executionHint: "platform",
         requiresApiKey: false,
-        platformKeySupport: false
+        platformKeySupport: true
       }
     ];
     exports.BUILTIN_TOOLS_REGISTRY = [
@@ -12815,12 +13972,19 @@ var require_builtin_tools_registry = __commonJS({
       const prefix = (_a = tool.idPrefix) !== null && _a !== void 0 ? _a : exports.BuiltInToolIdPrefix.BUILTIN;
       return `${prefix}:${tool.id}`;
     }
-    function getAllBuiltInTools2() {
-      return exports.BUILTIN_TOOLS_REGISTRY.filter((tool) => !tool.hidden);
+    function getAllBuiltInTools2(opts) {
+      return exports.BUILTIN_TOOLS_REGISTRY.filter((tool) => !tool.hidden && !((opts === null || opts === void 0 ? void 0 : opts.hideExperimental) && tool.experimental));
     }
     function getBuiltInToolById2(toolId) {
       const cleanId = toolId.replace(/^(builtin|platform):/, "");
-      return exports.BUILTIN_TOOLS_REGISTRY.find((tool) => tool.id === cleanId);
+      return exports.BUILTIN_TOOLS_REGISTRY.find((tool) => {
+        var _a;
+        return tool.id === cleanId || ((_a = tool.aliases) === null || _a === void 0 ? void 0 : _a.includes(cleanId));
+      });
+    }
+    function getBuiltInToolGroupById(toolId) {
+      var _a;
+      return (_a = getBuiltInToolById2(toolId)) === null || _a === void 0 ? void 0 : _a.toolGroup;
     }
     function getBuiltInToolsByProvider(provider) {
       return exports.BUILTIN_TOOLS_REGISTRY.filter((tool) => tool.providers.includes(provider) || tool.providers.includes(exports.BuiltInToolProvider.MULTI));
@@ -12846,8 +14010,8 @@ var require_builtin_tools_registry = __commonJS({
         return true;
       return compatibility.models.some((m) => modelId.includes(m));
     }
-    function getCompatibleBuiltInTools(modelId, provider) {
-      return exports.BUILTIN_TOOLS_REGISTRY.filter((tool) => !tool.hidden && isToolCompatibleWithModel2(tool.id, modelId, provider));
+    function getCompatibleBuiltInTools(modelId, provider, opts) {
+      return exports.BUILTIN_TOOLS_REGISTRY.filter((tool) => !tool.hidden && !((opts === null || opts === void 0 ? void 0 : opts.hideExperimental) && tool.experimental) && isToolCompatibleWithModel2(tool.id, modelId, provider));
     }
     function validateConfigAgainstSchema(schema, config2) {
       const errors = [];
@@ -12954,6 +14118,8 @@ var require_generated_model_routing = __commonJS({
       "deepseek-v3.1-terminus": ["vercel"],
       "deepseek-v3.2": ["vercel"],
       "deepseek-v3.2-thinking": ["vercel"],
+      "deepseek-v4-flash": ["vercel"],
+      "deepseek-v4-pro": ["vercel"],
       "devstral-2": ["vercel"],
       "devstral-small": ["vercel"],
       "devstral-small-2": ["vercel"],
@@ -13040,6 +14206,8 @@ var require_generated_model_routing = __commonJS({
       "gpt-5.4-mini": ["vercel"],
       "gpt-5.4-nano": ["vercel"],
       "gpt-5.4-pro": ["vercel"],
+      "gpt-5.5": ["vercel"],
+      "gpt-5.5-pro": ["vercel"],
       "gpt-oss-120b": ["vercel"],
       "gpt-oss-20b": ["vercel"],
       "gpt-oss-safeguard-20b": ["vercel"],
@@ -13057,6 +14225,7 @@ var require_generated_model_routing = __commonJS({
       "grok-4.20-reasoning-beta": ["vercel"],
       "grok-code-fast-1": ["vercel", "xai"],
       "intellect-3": ["vercel"],
+      "interfaze-beta": ["vercel"],
       "kat-coder-pro-v1": ["vercel"],
       "kat-coder-pro-v2": ["vercel"],
       "kimi-k2": ["vercel"],
@@ -13093,6 +14262,8 @@ var require_generated_model_routing = __commonJS({
       "Meta-Llama-3.3-70B-Instruct-Turbo": ["togetherai"],
       "mimo-v2-flash": ["vercel"],
       "mimo-v2-pro": ["vercel"],
+      "mimo-v2.5": ["vercel"],
+      "mimo-v2.5-pro": ["vercel"],
       "minimax-m2": ["vercel"],
       "minimax-m2.1": ["vercel"],
       "minimax-m2.1-lightning": ["vercel"],
@@ -13143,6 +14314,7 @@ var require_generated_model_routing = __commonJS({
       "qwen3-max-thinking": ["vercel"],
       "qwen3-next-80b-a3b-instruct": ["vercel"],
       "qwen3-next-80b-a3b-thinking": ["vercel"],
+      "qwen3-vl-235b-a22b-instruct": ["vercel"],
       "qwen3-vl-instruct": ["vercel"],
       "qwen3-vl-thinking": ["vercel"],
       "qwen3.5-122b-a10b": ["mixlayer"],
@@ -13153,6 +14325,7 @@ var require_generated_model_routing = __commonJS({
       "qwen3.5-9b": ["mixlayer"],
       "qwen3.5-flash": ["vercel"],
       "qwen3.5-plus": ["vercel"],
+      "qwen3.6-27b": ["vercel"],
       "qwen3.6-plus": ["vercel"],
       "seed-1.6": ["vercel"],
       "seed-1.8": ["vercel"],
@@ -13214,6 +14387,8 @@ var require_generated_model_routing = __commonJS({
       "deepseek-v3-1": ["vercel"],
       "deepseek-v3-1-terminus": ["vercel"],
       "deepseek-v3-2": ["vercel"],
+      "deepseek-v4-flash": ["vercel"],
+      "deepseek-v4-pro": ["vercel"],
       "devstral-2": ["vercel"],
       "devstral-small": ["vercel"],
       "devstral-small-2": ["vercel"],
@@ -13283,6 +14458,8 @@ var require_generated_model_routing = __commonJS({
       "gpt-5-4-mini": ["vercel"],
       "gpt-5-4-nano": ["vercel"],
       "gpt-5-4-pro": ["vercel"],
+      "gpt-5-5": ["vercel"],
+      "gpt-5-5-pro": ["vercel"],
       "gpt-5-batch": ["openai"],
       "gpt-5-chat": ["vercel"],
       "gpt-5-codex": ["vercel"],
@@ -13308,6 +14485,7 @@ var require_generated_model_routing = __commonJS({
       "grok-4-fast-reasoning": ["vercel"],
       "grok-code-fast-1": ["vercel", "xai"],
       "intellect-3": ["vercel"],
+      "interfaze-beta": ["vercel"],
       "kat-coder-pro": ["vercel"],
       "kimi-k2": ["vercel"],
       "kimi-k2-0905": ["vercel"],
@@ -13333,6 +14511,8 @@ var require_generated_model_routing = __commonJS({
       "meta-llama-3-1-70b-instruct-turbo": ["togetherai"],
       "meta-llama-3-1-8b-instruct-turbo": ["togetherai"],
       "meta-llama-3-3-70b-instruct-turbo": ["togetherai"],
+      "mimo-v2-5": ["vercel"],
+      "mimo-v2-5-pro": ["vercel"],
       "mimo-v2-flash": ["vercel"],
       "mimo-v2-pro": ["vercel"],
       "minimax-m2": ["vercel"],
@@ -13381,6 +14561,7 @@ var require_generated_model_routing = __commonJS({
       "qwen3-5-9b": ["mixlayer"],
       "qwen3-5-flash": ["vercel"],
       "qwen3-5-plus": ["vercel"],
+      "qwen3-6-27b": ["vercel"],
       "qwen3-6-plus": ["vercel"],
       "qwen3-coder": ["vercel"],
       "qwen3-coder-30b-a3b": ["vercel"],
@@ -13393,6 +14574,7 @@ var require_generated_model_routing = __commonJS({
       "qwen3-next-80b-a3b": ["vercel"],
       "qwen3-next-80b-a3b-instruct": ["vercel"],
       "qwen3-vl": ["vercel"],
+      "qwen3-vl-235b-a22b-instruct": ["vercel"],
       "qwen3-vl-instruct": ["vercel"],
       "seed-1-6": ["vercel"],
       "seed-1-8": ["vercel"],
@@ -13567,6 +14749,12 @@ var require_generated_model_routing = __commonJS({
       "deepseek-v3.2-thinking": {
         "vercel": "deepseek/deepseek-v3.2-thinking"
       },
+      "deepseek-v4-flash": {
+        "vercel": "deepseek/deepseek-v4-flash"
+      },
+      "deepseek-v4-pro": {
+        "vercel": "deepseek/deepseek-v4-pro"
+      },
       "devstral-2": {
         "vercel": "mistral/devstral-2"
       },
@@ -13882,6 +15070,12 @@ var require_generated_model_routing = __commonJS({
       "gpt-5-4-pro": {
         "vercel": "openai/gpt-5.4-pro"
       },
+      "gpt-5-5": {
+        "vercel": "openai/gpt-5.5"
+      },
+      "gpt-5-5-pro": {
+        "vercel": "openai/gpt-5.5-pro"
+      },
       "gpt-5-batch": {
         "openai": "gpt-5-batch"
       },
@@ -13975,6 +15169,12 @@ var require_generated_model_routing = __commonJS({
       "gpt-5.4-pro": {
         "vercel": "openai/gpt-5.4-pro"
       },
+      "gpt-5.5": {
+        "vercel": "openai/gpt-5.5"
+      },
+      "gpt-5.5-pro": {
+        "vercel": "openai/gpt-5.5-pro"
+      },
       "gpt-oss-120b": {
         "vercel": "openai/gpt-oss-120b"
       },
@@ -14052,6 +15252,9 @@ var require_generated_model_routing = __commonJS({
       "intellect-3": {
         "vercel": "prime-intellect/intellect-3"
       },
+      "interfaze-beta": {
+        "vercel": "interfaze/interfaze-beta"
+      },
       "kat-coder-pro": {
         "vercel": "kwaipilot/kat-coder-pro-v2"
       },
@@ -14187,12 +15390,24 @@ var require_generated_model_routing = __commonJS({
       "Meta-Llama-3.3-70B-Instruct-Turbo": {
         "togetherai": "meta-llama/Meta-Llama-3.3-70B-Instruct-Turbo"
       },
+      "mimo-v2-5": {
+        "vercel": "xiaomi/mimo-v2.5"
+      },
+      "mimo-v2-5-pro": {
+        "vercel": "xiaomi/mimo-v2.5-pro"
+      },
       "mimo-v2-flash": {
         "vercel": "xiaomi/mimo-v2-flash"
       },
       "mimo-v2-pro": {
         "vercel": "xiaomi/mimo-v2-pro"
       },
+      "mimo-v2.5": {
+        "vercel": "xiaomi/mimo-v2.5"
+      },
+      "mimo-v2.5-pro": {
+        "vercel": "xiaomi/mimo-v2.5-pro"
+      },
       "minimax-m2": {
         "vercel": "minimax/minimax-m2"
       },
@@ -14364,6 +15579,9 @@ var require_generated_model_routing = __commonJS({
       "qwen3-5-plus": {
         "vercel": "alibaba/qwen3.5-plus"
       },
+      "qwen3-6-27b": {
+        "vercel": "alibaba/qwen3.6-27b"
+      },
       "qwen3-6-plus": {
         "vercel": "alibaba/qwen3.6-plus"
       },
@@ -14412,6 +15630,9 @@ var require_generated_model_routing = __commonJS({
       "qwen3-vl": {
         "vercel": "alibaba/qwen3-vl-thinking"
       },
+      "qwen3-vl-235b-a22b-instruct": {
+        "vercel": "alibaba/qwen3-vl-235b-a22b-instruct"
+      },
       "qwen3-vl-instruct": {
         "vercel": "alibaba/qwen3-vl-instruct"
       },
@@ -14442,6 +15663,9 @@ var require_generated_model_routing = __commonJS({
       "qwen3.5-plus": {
         "vercel": "alibaba/qwen3.5-plus"
       },
+      "qwen3.6-27b": {
+        "vercel": "alibaba/qwen3.6-27b"
+      },
       "qwen3.6-plus": {
         "vercel": "alibaba/qwen3.6-plus"
       },
@@ -14596,6 +15820,7 @@ var require_generated_model_routing = __commonJS({
       "qwen3-32b": { providers: [{ provider: "vercel", weight: 100 }] },
       "qwen3-5-flash": { providers: [{ provider: "vercel", weight: 100 }] },
       "qwen3-5-plus": { providers: [{ provider: "vercel", weight: 100 }] },
+      "qwen3-6-27b": { providers: [{ provider: "vercel", weight: 100 }] },
       "qwen3-6-plus": { providers: [{ provider: "vercel", weight: 100 }] },
       "qwen3-coder": { providers: [{ provider: "vercel", weight: 100 }] },
       "qwen3-coder-30b-a3b": { providers: [{ provider: "vercel", weight: 100 }] },
@@ -14608,6 +15833,7 @@ var require_generated_model_routing = __commonJS({
       "qwen3-next-80b-a3b": { providers: [{ provider: "vercel", weight: 100 }] },
       "qwen3-next-80b-a3b-instruct": { providers: [{ provider: "vercel", weight: 100 }] },
       "qwen3-vl": { providers: [{ provider: "vercel", weight: 100 }] },
+      "qwen3-vl-235b-a22b-instruct": { providers: [{ provider: "vercel", weight: 100 }] },
       "qwen3-vl-instruct": { providers: [{ provider: "vercel", weight: 100 }] }
     };
     function getProvidersForModel(modelId) {
@@ -19681,6 +20907,7 @@ var require_flow_step_types = __commonJS({
       "fetch-github",
       "api-call",
       "transform-data",
+      "template",
       "conditional",
       "set-variable",
       "upsert-record",
@@ -19696,7 +20923,9 @@ var require_flow_step_types = __commonJS({
       "wait-until",
       "paginate-api",
       "store-vector",
-      "execute-agent"
+      "execute-agent",
+      "store-asset",
+      "generate-pdf"
     ];
     exports.FLOW_STEP_TYPES = ["prompt", ...exports.CONTEXT_STEP_TYPES];
     function isContextStepType(type) {
@@ -19739,15 +20968,19 @@ var require_fpo_schema = __commonJS({
   "../shared/dist/product-generation/fpo-schema.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.fullProductObjectSchema = exports.surfaceSchema = exports.deployInstructionsSchema = exports.deployInstructionsSectionSchema = exports.toolSchema = exports.capabilitySchema = exports.agentDefinitionSchema = exports.flowDefinitionSchema = exports.FULL_PRODUCT_OBJECT_VERSION = void 0;
+    exports.fullProductObjectSchema = exports.productSecretSchema = exports.scheduleSchema = exports.recordSchema = exports.surfaceSchema = exports.deployInstructionsSchema = exports.deployInstructionsSectionSchema = exports.toolSchema = exports.capabilitySchema = exports.agentDefinitionSchema = exports.flowDefinitionSchema = exports.FULL_PRODUCT_OBJECT_VERSION = exports.FULL_PRODUCT_OBJECT_VERSION_1_1 = exports.FULL_PRODUCT_OBJECT_VERSION_1_0 = void 0;
     var zod_1 = require_zod();
     var flow_step_types_1 = require_flow_step_types();
-    exports.FULL_PRODUCT_OBJECT_VERSION = "1.0";
+    exports.FULL_PRODUCT_OBJECT_VERSION_1_0 = "1.0";
+    exports.FULL_PRODUCT_OBJECT_VERSION_1_1 = "1.1";
+    exports.FULL_PRODUCT_OBJECT_VERSION = exports.FULL_PRODUCT_OBJECT_VERSION_1_1;
     var createPolicySchema = zod_1.z.enum(["create", "skip", "manual"]).optional();
     var flowStepSchema = zod_1.z.object({
       type: zod_1.z.string().refine((t) => flow_step_types_1.FLOW_STEP_TYPES.includes(t), { message: "Invalid flow step type" }),
       name: zod_1.z.string().min(1, "Step name is required"),
-      config: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).default({})
+      config: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).default({}),
+      order: zod_1.z.number().int().nonnegative().optional(),
+      enabled: zod_1.z.boolean().optional()
     });
     var transitionSchema = zod_1.z.object({
       from: zod_1.z.number().int().nonnegative(),
@@ -19766,16 +20999,154 @@ var require_fpo_schema = __commonJS({
       description: zod_1.z.string().optional(),
       config: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional()
     });
+    var agentSubagentConfigSchema = zod_1.z.object({
+      toolPool: zod_1.z.array(zod_1.z.string()).optional(),
+      defaultMaxTurns: zod_1.z.number().int().positive().optional(),
+      maxSpawnsPerRun: zod_1.z.number().int().positive().optional(),
+      allowNesting: zod_1.z.boolean().optional(),
+      defaultModel: zod_1.z.string().optional(),
+      maxTurnsLimit: zod_1.z.number().int().positive().optional(),
+      defaultTimeoutMs: zod_1.z.number().int().positive().optional()
+    });
+    var capabilityToolRefSchema = zod_1.z.object({
+      capabilityId: zod_1.z.string().min(1),
+      toolName: zod_1.z.string().min(1),
+      description: zod_1.z.string().optional(),
+      parametersSchema: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional()
+    });
+    var agentLoopConfigSchema = zod_1.z.object({
+      maxTurns: zod_1.z.number().int().min(1).max(100).optional(),
+      maxCost: zod_1.z.number().nonnegative().optional(),
+      enableReflection: zod_1.z.boolean().optional(),
+      reflectionInterval: zod_1.z.number().int().min(1).max(50).optional()
+    });
+    var agentReasoningConfigSchema = zod_1.z.object({
+      enabled: zod_1.z.boolean().optional(),
+      reasoningEffort: zod_1.z.enum(["minimal", "low", "medium", "high", "xhigh"]).optional(),
+      reasoningSummary: zod_1.z.enum(["auto", "detailed"]).optional(),
+      budgetTokens: zod_1.z.number().int().min(1e3).max(1e5).optional(),
+      thinkingBudget: zod_1.z.number().int().min(1024).max(65536).optional(),
+      includeThoughts: zod_1.z.boolean().optional()
+    });
+    var agentVoiceConfigSchema = zod_1.z.object({
+      enabled: zod_1.z.boolean().optional(),
+      provider: zod_1.z.string().optional(),
+      interruptionMode: zod_1.z.enum(["none", "cancel", "barge-in"]).optional(),
+      elevenLabs: zod_1.z.object({
+        voiceId: zod_1.z.string().optional(),
+        modelId: zod_1.z.string().optional(),
+        stability: zod_1.z.number().min(0).max(1).optional(),
+        similarity: zod_1.z.number().min(0).max(1).optional()
+      }).optional()
+    });
+    var agentErrorHandlingSchema = zod_1.z.object({
+      onError: zod_1.z.enum(["fail", "continue", "fallback"]).optional(),
+      fallbacks: zod_1.z.array(zod_1.z.object({
+        type: zod_1.z.enum(["retry", "model"]),
+        model: zod_1.z.string().optional(),
+        temperature: zod_1.z.number().min(0).max(2).optional(),
+        maxTokens: zod_1.z.number().int().positive().optional(),
+        delay: zod_1.z.number().min(0).max(6e4).optional()
+      })).optional()
+    });
+    var agentArtifactsConfigSchema = zod_1.z.object({
+      enabled: zod_1.z.literal(true),
+      types: zod_1.z.array(zod_1.z.enum(["markdown", "component"])).min(1)
+    });
+    var agentMcpServerSchema = zod_1.z.object({
+      id: zod_1.z.string().min(1),
+      name: zod_1.z.string().optional(),
+      url: zod_1.z.string().min(1),
+      auth: zod_1.z.object({
+        type: zod_1.z.enum(["api_key", "bearer", "basic", "custom_header", "none"]),
+        headerName: zod_1.z.string().optional(),
+        token: zod_1.z.string().optional(),
+        username: zod_1.z.string().optional(),
+        password: zod_1.z.string().optional()
+      }).optional(),
+      allowedTools: zod_1.z.array(zod_1.z.string()).optional(),
+      timeout: zod_1.z.number().positive().optional(),
+      transport: zod_1.z.enum(["streamable_http", "rest"]).optional(),
+      enabled: zod_1.z.boolean().optional()
+    });
+    var agentToolsConfigSchema = zod_1.z.object({
+      toolIds: zod_1.z.array(zod_1.z.string()).optional(),
+      toolConfigs: zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional(),
+      runtimeTools: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string().min(1),
+        description: zod_1.z.string().optional(),
+        parametersSchema: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+        config: zod_1.z.record(zod_1.z.string(), zod_1.z.any())
+      })).optional(),
+      mcpServers: zod_1.z.array(agentMcpServerSchema).optional(),
+      maxToolCalls: zod_1.z.number().int().min(1).max(100).optional(),
+      toolCallStrategy: zod_1.z.enum(["auto", "required", "none"]).optional(),
+      parallelCalls: zod_1.z.boolean().optional(),
+      approval: zod_1.z.object({
+        require: zod_1.z.union([zod_1.z.array(zod_1.z.string()), zod_1.z.boolean()]),
+        timeout: zod_1.z.number().positive().optional()
+      }).optional(),
+      perToolLimits: zod_1.z.record(zod_1.z.string(), zod_1.z.object({
+        maxCalls: zod_1.z.number().int().positive().optional(),
+        required: zod_1.z.boolean().optional()
+      })).optional(),
+      subagentConfig: agentSubagentConfigSchema.optional(),
+      codeModeConfig: zod_1.z.object({
+        toolPool: zod_1.z.array(zod_1.z.string()).optional(),
+        description: zod_1.z.string().optional(),
+        timeoutMs: zod_1.z.number().int().positive().optional()
+      }).optional()
+    });
+    var agentExternalConfigSchema = zod_1.z.object({
+      endpoint: zod_1.z.string().url(),
+      auth: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+      timeout: zod_1.z.number().positive().optional(),
+      retryCount: zod_1.z.number().int().nonnegative().optional(),
+      skillOrchestration: zod_1.z.boolean().optional()
+    });
+    var agentClaudeManagedConfigSchema = zod_1.z.object({
+      anthropicAgentId: zod_1.z.string().min(1),
+      anthropicAgentVersion: zod_1.z.string().optional(),
+      model: zod_1.z.string().optional(),
+      systemPrompt: zod_1.z.string().optional(),
+      toolPermissions: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+      anthropicEnvironmentId: zod_1.z.string().optional(),
+      timeoutMs: zod_1.z.number().int().positive().optional()
+    });
     exports.agentDefinitionSchema = zod_1.z.object({
       name: zod_1.z.string().min(1),
       description: zod_1.z.string().min(1),
       model: zod_1.z.string().min(1, "Agent model is required"),
       systemPrompt: zod_1.z.string().optional(),
+      icon: zod_1.z.string().max(50).optional(),
+      agentType: zod_1.z.enum(["runtype", "external", "claude_managed"]).optional(),
+      status: zod_1.z.enum(["draft", "active", "paused", "archived"]).optional(),
+      loggingPolicy: zod_1.z.enum(["default", "on", "off"]).optional(),
+      // Sampling parameters
+      temperature: zod_1.z.number().min(0).max(2).optional(),
+      topP: zod_1.z.number().min(0).max(1).optional(),
+      topK: zod_1.z.number().int().min(1).max(500).optional(),
+      frequencyPenalty: zod_1.z.number().min(-2).max(2).optional(),
+      presencePenalty: zod_1.z.number().min(-2).max(2).optional(),
+      seed: zod_1.z.number().int().optional(),
+      // Tools — legacy simple array, or the full config object
       tools: zod_1.z.array(agentToolSchema).optional(),
+      toolsConfig: agentToolsConfigSchema.optional(),
+      // Advanced config
+      loopConfig: agentLoopConfigSchema.optional(),
+      reasoning: zod_1.z.union([zod_1.z.boolean(), agentReasoningConfigSchema]).optional(),
+      voice: agentVoiceConfigSchema.optional(),
+      errorHandling: agentErrorHandlingSchema.optional(),
+      artifacts: agentArtifactsConfigSchema.optional(),
       advisor: zod_1.z.object({
         model: zod_1.z.string(),
         systemPrompt: zod_1.z.string().optional()
       }).optional(),
+      subagentConfig: agentSubagentConfigSchema.optional(),
+      capabilityToolRefs: zod_1.z.array(capabilityToolRefSchema).optional(),
+      // External / managed agent configs
+      externalConfig: agentExternalConfigSchema.optional(),
+      claudeManagedConfig: agentClaudeManagedConfigSchema.optional(),
       createPolicy: createPolicySchema
     });
     exports.capabilitySchema = zod_1.z.object({
@@ -19866,6 +21237,49 @@ var require_fpo_schema = __commonJS({
       status: zod_1.z.enum(["draft", "active", "paused"]).optional(),
       environment: zod_1.z.enum(["production", "development"]).optional()
     });
+    exports.recordSchema = zod_1.z.object({
+      id: zod_1.z.string().min(1),
+      type: zod_1.z.string().min(1),
+      name: zod_1.z.string().optional(),
+      metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+      metadataSchema: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+      messages: zod_1.z.array(zod_1.z.object({
+        role: zod_1.z.string().min(1),
+        content: zod_1.z.string()
+      })).optional(),
+      createPolicy: createPolicySchema
+    });
+    exports.scheduleSchema = zod_1.z.object({
+      id: zod_1.z.string().min(1),
+      name: zod_1.z.string().optional(),
+      capabilityId: zod_1.z.string().min(1),
+      triggerType: zod_1.z.enum(["cron", "one_time"]),
+      cron: zod_1.z.string().optional(),
+      timezone: zod_1.z.string().optional(),
+      runAt: zod_1.z.string().datetime({ offset: true }).optional(),
+      recordType: zod_1.z.string().optional(),
+      recordFilter: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+      messages: zod_1.z.array(zod_1.z.object({
+        role: zod_1.z.string().min(1),
+        content: zod_1.z.string()
+      })).optional(),
+      executionOptions: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+      enabled: zod_1.z.boolean().optional(),
+      createPolicy: createPolicySchema
+    }).refine((s) => {
+      if (s.triggerType === "cron" && !s.cron)
+        return false;
+      if (s.triggerType === "one_time" && !s.runAt)
+        return false;
+      return true;
+    }, { message: "Cron schedules require `cron` field; one_time schedules require `runAt` field" });
+    exports.productSecretSchema = zod_1.z.object({
+      id: zod_1.z.string().min(1),
+      key: zod_1.z.string().min(1),
+      description: zod_1.z.string().optional(),
+      required: zod_1.z.boolean().optional(),
+      placeholder: zod_1.z.string().optional()
+    });
     var metaSchema = zod_1.z.object({
       schemaVersion: zod_1.z.string().min(1),
       catalogVersion: zod_1.z.string().min(1),
@@ -19874,9 +21288,7 @@ var require_fpo_schema = __commonJS({
       planHash: zod_1.z.string().min(1)
     });
     exports.fullProductObjectSchema = zod_1.z.object({
-      // Version for the FPO document format itself. Keep this distinct from
-      // generator metadata like _meta.schemaVersion.
-      version: zod_1.z.literal(exports.FULL_PRODUCT_OBJECT_VERSION),
+      version: zod_1.z.enum([exports.FULL_PRODUCT_OBJECT_VERSION_1_0, exports.FULL_PRODUCT_OBJECT_VERSION_1_1]),
       product: zod_1.z.object({
         name: zod_1.z.string().min(1),
         description: zod_1.z.string().min(1),
@@ -19886,6 +21298,9 @@ var require_fpo_schema = __commonJS({
       capabilities: zod_1.z.array(exports.capabilitySchema).max(50),
       tools: zod_1.z.array(exports.toolSchema).max(100),
       surfaces: zod_1.z.array(exports.surfaceSchema).max(50),
+      records: zod_1.z.array(exports.recordSchema).max(500).optional(),
+      schedules: zod_1.z.array(exports.scheduleSchema).max(50).optional(),
+      secrets: zod_1.z.array(exports.productSecretSchema).max(50).optional(),
       _meta: metaSchema
     }).superRefine((fpo, ctx) => {
       const capIds = /* @__PURE__ */ new Set();
@@ -19922,6 +21337,45 @@ var require_fpo_schema = __commonJS({
         }
         surfaceIds.add(surface.id);
       }
+      if (fpo.records) {
+        const recordIds = /* @__PURE__ */ new Set();
+        for (const [i, record] of fpo.records.entries()) {
+          if (recordIds.has(record.id)) {
+            ctx.addIssue({
+              code: "custom",
+              message: `Duplicate record id: ${record.id}`,
+              path: ["records", i, "id"]
+            });
+          }
+          recordIds.add(record.id);
+        }
+      }
+      if (fpo.schedules) {
+        const scheduleIds = /* @__PURE__ */ new Set();
+        for (const [i, schedule] of fpo.schedules.entries()) {
+          if (scheduleIds.has(schedule.id)) {
+            ctx.addIssue({
+              code: "custom",
+              message: `Duplicate schedule id: ${schedule.id}`,
+              path: ["schedules", i, "id"]
+            });
+          }
+          scheduleIds.add(schedule.id);
+        }
+      }
+      if (fpo.secrets) {
+        const secretIds = /* @__PURE__ */ new Set();
+        for (const [i, secret] of fpo.secrets.entries()) {
+          if (secretIds.has(secret.id)) {
+            ctx.addIssue({
+              code: "custom",
+              message: `Duplicate secret id: ${secret.id}`,
+              path: ["secrets", i, "id"]
+            });
+          }
+          secretIds.add(secret.id);
+        }
+      }
     });
   }
 });
@@ -20038,6 +21492,16 @@ var require_agent_validator = __commonJS({
           result.errors.push((0, types_1.createIssue)("error", "AGENT_ADVISOR_NO_MODEL", "Advisor model is required when advisor is configured", `${base}.advisor.model`));
         }
       }
+      if (agent.capabilityToolRefs) {
+        for (const [i, ref] of agent.capabilityToolRefs.entries()) {
+          if (!ref.toolName || ref.toolName.trim() === "") {
+            result.errors.push((0, types_1.createIssue)("error", "CAPABILITY_TOOL_REF_NAME_EMPTY", "capabilityToolRefs toolName is required", `${base}.capabilityToolRefs[${i}].toolName`));
+          }
+          if (!ref.capabilityId || ref.capabilityId.trim() === "") {
+            result.errors.push((0, types_1.createIssue)("error", "CAPABILITY_TOOL_REF_ID_EMPTY", "capabilityToolRefs capabilityId is required", `${base}.capabilityToolRefs[${i}].capabilityId`));
+          }
+        }
+      }
       result.valid = result.errors.length === 0;
       return result;
     }
@@ -20233,7 +21697,7 @@ var require_connectivity_validator = __commonJS({
     exports.validateConnectivity = validateConnectivity;
     var types_1 = require_types2();
     function validateConnectivity(fpo) {
-      var _a;
+      var _a, _b;
       const result = (0, types_1.emptyResult)();
       const capabilityIds = new Set(fpo.capabilities.map((c) => c.id));
       for (const [si, surface] of fpo.surfaces.entries()) {
@@ -20258,10 +21722,26 @@ var require_connectivity_validator = __commonJS({
           result.warnings.push((0, types_1.createIssue)("warning", "UNREACHABLE_CAPABILITY", `Capability "${cap.id}" is not referenced by any surface route`, `capabilities[${i}]`, "Add a surface route or remove the capability"));
         }
       }
+      const capabilityMap = new Map(fpo.capabilities.map((c) => [c.id, c]));
+      for (const [ci, cap] of fpo.capabilities.entries()) {
+        if (!((_a = cap.agent) === null || _a === void 0 ? void 0 : _a.capabilityToolRefs))
+          continue;
+        for (const [ri, ref] of cap.agent.capabilityToolRefs.entries()) {
+          const target = capabilityMap.get(ref.capabilityId);
+          if (!target) {
+            result.errors.push((0, types_1.createIssue)("error", "CAPABILITY_TOOL_REF_NOT_FOUND", `capabilityToolRefs references non-existent capability "${ref.capabilityId}"`, `capabilities[${ci}].agent.capabilityToolRefs[${ri}].capabilityId`, "Ensure the capabilityId matches an existing capability"));
+          } else if (!target.flow && !target.existingFlowId) {
+            result.errors.push((0, types_1.createIssue)("error", "CAPABILITY_TOOL_REF_NOT_FLOW", `capabilityToolRefs references capability "${ref.capabilityId}" which is not a flow capability`, `capabilities[${ci}].agent.capabilityToolRefs[${ri}].capabilityId`, "capabilityToolRefs can only reference capabilities backed by a flow or existingFlowId"));
+          }
+          if (ref.capabilityId === cap.id) {
+            result.errors.push((0, types_1.createIssue)("error", "CAPABILITY_TOOL_REF_SELF", `capabilityToolRefs cannot reference the capability's own id "${cap.id}"`, `capabilities[${ci}].agent.capabilityToolRefs[${ri}].capabilityId`));
+          }
+        }
+      }
       if (fpo.tools.length > 0) {
         const referencedToolIds = /* @__PURE__ */ new Set();
         for (const cap of fpo.capabilities) {
-          if ((_a = cap.flow) === null || _a === void 0 ? void 0 : _a.steps) {
+          if ((_b = cap.flow) === null || _b === void 0 ? void 0 : _b.steps) {
             for (const step of cap.flow.steps) {
               const config2 = step.config;
               if ((config2 === null || config2 === void 0 ? void 0 : config2.toolId) && typeof config2.toolId === "string") {
@@ -20316,6 +21796,37 @@ var require_fpo_validator = __commonJS({
         }
         surfaceIds.add(surface.id);
       }
+      if (fpo.records) {
+        const recordIds = /* @__PURE__ */ new Set();
+        for (const [i, record] of fpo.records.entries()) {
+          if (recordIds.has(record.id)) {
+            result.errors.push((0, types_1.createIssue)("error", "DUPLICATE_RECORD_ID", `Duplicate record id: "${record.id}"`, `records[${i}].id`));
+          }
+          recordIds.add(record.id);
+        }
+      }
+      const capIdSet = new Set(fpo.capabilities.map((c) => c.id));
+      if (fpo.schedules) {
+        const scheduleIds = /* @__PURE__ */ new Set();
+        for (const [i, schedule] of fpo.schedules.entries()) {
+          if (scheduleIds.has(schedule.id)) {
+            result.errors.push((0, types_1.createIssue)("error", "DUPLICATE_SCHEDULE_ID", `Duplicate schedule id: "${schedule.id}"`, `schedules[${i}].id`));
+          }
+          scheduleIds.add(schedule.id);
+          if (!capIdSet.has(schedule.capabilityId)) {
+            result.errors.push((0, types_1.createIssue)("error", "SCHEDULE_CAPABILITY_NOT_FOUND", `Schedule "${schedule.id}" references capability "${schedule.capabilityId}" which does not exist`, `schedules[${i}].capabilityId`));
+          }
+        }
+      }
+      if (fpo.secrets) {
+        const secretIds = /* @__PURE__ */ new Set();
+        for (const [i, secret] of fpo.secrets.entries()) {
+          if (secretIds.has(secret.id)) {
+            result.errors.push((0, types_1.createIssue)("error", "DUPLICATE_SECRET_ID", `Duplicate secret id: "${secret.id}"`, `secrets[${i}].id`));
+          }
+          secretIds.add(secret.id);
+        }
+      }
       const toolIds = new Set(fpo.tools.map((t) => t.id));
       const capResults = fpo.capabilities.map((cap, i) => (0, capability_validator_1.validateCapability)(cap, i, { toolIds }));
       const toolResults = fpo.tools.map((tool, i) => (0, tool_validator_1.validateToolDefinition)(tool, i));
@@ -20331,15 +21842,19 @@ var require_fpo_template = __commonJS({
   "../shared/dist/product-generation/fpo-template.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.fullProductObjectTemplateSchema = exports.fpoTemplateVariableSchema = exports.fpoTemplateVariableInputTypeSchema = exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION = void 0;
+    exports.fullProductObjectTemplateSchema = exports.fpoTemplateVariableSchema = exports.fpoTemplateVariableInputTypeSchema = exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION_1_1 = exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION = void 0;
+    exports.stripFlowVariablePrefix = stripFlowVariablePrefix;
     exports.coerceFPOTemplateVariableValue = coerceFPOTemplateVariableValue;
     exports.resolveFPOTemplate = resolveFPOTemplate;
     exports.validateFPOTemplate = validateFPOTemplate2;
+    exports.migrateFPOv1ToV1_1 = migrateFPOv1ToV1_1;
+    exports.migrateFPOTemplatev1ToV1_1 = migrateFPOTemplatev1ToV1_1;
     var zod_1 = require_zod();
     var fpo_schema_1 = require_fpo_schema();
     var types_1 = require_types2();
     var fpo_validator_1 = require_fpo_validator();
     exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION = "1.0";
+    exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION_1_1 = "1.1";
     exports.fpoTemplateVariableInputTypeSchema = zod_1.z.enum([
       "text",
       "textarea",
@@ -20386,7 +21901,7 @@ var require_fpo_template = __commonJS({
       }
     });
     exports.fullProductObjectTemplateSchema = zod_1.z.object({
-      version: zod_1.z.literal(exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION),
+      version: zod_1.z.enum([exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION, exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION_1_1]),
       productObject: fpo_schema_1.fullProductObjectSchema,
       template: zod_1.z.object({
         variables: zod_1.z.array(exports.fpoTemplateVariableSchema).max(50)
@@ -20405,6 +21920,45 @@ var require_fpo_template = __commonJS({
         });
       }
     });
+    var FLOW_PREFIX = "flow:";
+    var SECRET_PREFIX = "secret:";
+    function replaceTemplateTokens(value, replaceToken) {
+      let cursor = 0;
+      let result = "";
+      while (cursor < value.length) {
+        const start = value.indexOf("{{", cursor);
+        if (start === -1) {
+          result += value.slice(cursor);
+          break;
+        }
+        const end = value.indexOf("}}", start + 2);
+        if (end === -1) {
+          result += value.slice(cursor);
+          break;
+        }
+        result += value.slice(cursor, start);
+        const raw = value.slice(start, end + 2);
+        const inner = value.slice(start + 2, end);
+        result += replaceToken(inner, raw);
+        cursor = end + 2;
+      }
+      return result;
+    }
+    function stripFlowVariablePrefix(value) {
+      if (typeof value === "string") {
+        return replaceTemplateTokens(value, (inner, raw) => {
+          const trimmed = inner.trim();
+          return trimmed.startsWith(FLOW_PREFIX) && trimmed.length > FLOW_PREFIX.length ? `{{${trimmed.slice(FLOW_PREFIX.length)}}}` : raw;
+        });
+      }
+      if (Array.isArray(value)) {
+        return value.map(stripFlowVariablePrefix);
+      }
+      if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, nested]) => [key, stripFlowVariablePrefix(nested)]));
+      }
+      return value;
+    }
     function collectStringLeafPaths(value, path14 = []) {
       if (typeof value === "string") {
         return [{ path: path14, value }];
@@ -20433,7 +21987,7 @@ var require_fpo_template = __commonJS({
         const inner = value.slice(start + 2, end);
         const separatorIndex = inner.indexOf("|");
         const key = (separatorIndex === -1 ? inner : inner.slice(0, separatorIndex)).trim();
-        if (key.length > 0 && !key.startsWith("secret:")) {
+        if (key.length > 0 && !key.startsWith(SECRET_PREFIX) && !key.startsWith(FLOW_PREFIX)) {
           references.push({
             key,
             defaultValue: separatorIndex === -1 ? void 0 : inner.slice(separatorIndex + 1).trim(),
@@ -20635,6 +22189,122 @@ var require_fpo_template = __commonJS({
         defaultsValidation
       };
     }
+    function addFlowPrefixToString(value, skipKeys) {
+      return replaceTemplateTokens(value, (inner, raw) => {
+        if (inner.includes("|"))
+          return raw;
+        const key = inner.trim();
+        if (key.length === 0 || key.startsWith(SECRET_PREFIX) || key.startsWith(FLOW_PREFIX) || (skipKeys === null || skipKeys === void 0 ? void 0 : skipKeys.has(key))) {
+          return raw;
+        }
+        return `{{${FLOW_PREFIX}${key}}}`;
+      });
+    }
+    function addFlowPrefixToValue(value, skipKeys) {
+      if (typeof value === "string")
+        return addFlowPrefixToString(value, skipKeys);
+      if (Array.isArray(value))
+        return value.map((item) => addFlowPrefixToValue(item, skipKeys));
+      if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, addFlowPrefixToValue(v, skipKeys)]));
+      }
+      return value;
+    }
+    function migrateFPOv1ToV1_1(fpo) {
+      var _a, _b, _c, _d;
+      if (fpo.version === fpo_schema_1.FULL_PRODUCT_OBJECT_VERSION_1_1) {
+        return { migrated: fpo, changes: [] };
+      }
+      const changes = [];
+      const migrated = structuredClone(fpo);
+      migrated.version = fpo_schema_1.FULL_PRODUCT_OBJECT_VERSION_1_1;
+      for (const [ci, cap] of migrated.capabilities.entries()) {
+        if (cap.flow) {
+          for (const [si, step] of cap.flow.steps.entries()) {
+            const before = JSON.stringify(step.config);
+            step.config = addFlowPrefixToValue(step.config);
+            if (JSON.stringify(step.config) !== before) {
+              changes.push(`capabilities[${ci}].flow.steps[${si}].config: added flow: prefix to runtime variables`);
+            }
+          }
+        }
+        if ((_a = cap.agent) === null || _a === void 0 ? void 0 : _a.systemPrompt) {
+          const before = cap.agent.systemPrompt;
+          cap.agent.systemPrompt = addFlowPrefixToString(cap.agent.systemPrompt);
+          if (cap.agent.systemPrompt !== before) {
+            changes.push(`capabilities[${ci}].agent.systemPrompt: added flow: prefix to runtime variables`);
+          }
+        }
+        if ((_b = cap.agent) === null || _b === void 0 ? void 0 : _b.tools) {
+          for (const [ti, tool] of cap.agent.tools.entries()) {
+            if (tool.config) {
+              const before = JSON.stringify(tool.config);
+              tool.config = addFlowPrefixToValue(tool.config);
+              if (JSON.stringify(tool.config) !== before) {
+                changes.push(`capabilities[${ci}].agent.tools[${ti}].config: added flow: prefix to runtime variables`);
+              }
+            }
+          }
+        }
+        if ((_d = (_c = cap.agent) === null || _c === void 0 ? void 0 : _c.advisor) === null || _d === void 0 ? void 0 : _d.systemPrompt) {
+          const before = cap.agent.advisor.systemPrompt;
+          cap.agent.advisor.systemPrompt = addFlowPrefixToString(cap.agent.advisor.systemPrompt);
+          if (cap.agent.advisor.systemPrompt !== before) {
+            changes.push(`capabilities[${ci}].agent.advisor.systemPrompt: added flow: prefix to runtime variables`);
+          }
+        }
+      }
+      return { migrated, changes };
+    }
+    function migrateFPOTemplatev1ToV1_1(template) {
+      var _a, _b, _c, _d;
+      if (template.version === exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION_1_1) {
+        return { migrated: template, changes: [] };
+      }
+      const declaredKeys = new Set(template.template.variables.map((v) => v.key));
+      const changes = [];
+      const migrated = structuredClone(template);
+      migrated.version = exports.FULL_PRODUCT_OBJECT_TEMPLATE_VERSION_1_1;
+      const fpo = migrated.productObject;
+      fpo.version = fpo_schema_1.FULL_PRODUCT_OBJECT_VERSION_1_1;
+      for (const [ci, cap] of fpo.capabilities.entries()) {
+        if (cap.flow) {
+          for (const [si, step] of cap.flow.steps.entries()) {
+            const before = JSON.stringify(step.config);
+            step.config = addFlowPrefixToValue(step.config, declaredKeys);
+            if (JSON.stringify(step.config) !== before) {
+              changes.push(`productObject.capabilities[${ci}].flow.steps[${si}].config: added flow: prefix to runtime variables`);
+            }
+          }
+        }
+        if ((_a = cap.agent) === null || _a === void 0 ? void 0 : _a.systemPrompt) {
+          const before = cap.agent.systemPrompt;
+          cap.agent.systemPrompt = addFlowPrefixToString(cap.agent.systemPrompt, declaredKeys);
+          if (cap.agent.systemPrompt !== before) {
+            changes.push(`productObject.capabilities[${ci}].agent.systemPrompt: added flow: prefix to runtime variables`);
+          }
+        }
+        if ((_b = cap.agent) === null || _b === void 0 ? void 0 : _b.tools) {
+          for (const [ti, tool] of cap.agent.tools.entries()) {
+            if (tool.config) {
+              const before = JSON.stringify(tool.config);
+              tool.config = addFlowPrefixToValue(tool.config, declaredKeys);
+              if (JSON.stringify(tool.config) !== before) {
+                changes.push(`productObject.capabilities[${ci}].agent.tools[${ti}].config: added flow: prefix to runtime variables`);
+              }
+            }
+          }
+        }
+        if ((_d = (_c = cap.agent) === null || _c === void 0 ? void 0 : _c.advisor) === null || _d === void 0 ? void 0 : _d.systemPrompt) {
+          const before = cap.agent.advisor.systemPrompt;
+          cap.agent.advisor.systemPrompt = addFlowPrefixToString(cap.agent.advisor.systemPrompt, declaredKeys);
+          if (cap.agent.advisor.systemPrompt !== before) {
+            changes.push(`productObject.capabilities[${ci}].agent.advisor.systemPrompt: added flow: prefix to runtime variables`);
+          }
+        }
+      }
+      return { migrated, changes };
+    }
   }
 });