@runtypelabs/cli 2.11.2 → 2.11.3

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,220 @@ var require_builtin_tools_registry = __commonJS({
       THIRD_PARTY_API: "third_party_api",
       ARTIFACT: "artifact",
       DATA_MANAGEMENT: "data_management",
-      COMMERCE: "commerce"
+      COMMERCE: "commerce",
+      BROWSER: "browser"
     };
     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"
+    };
+    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,6 +11819,544 @@ var require_builtin_tools_registry = __commonJS({
         requiresApiKey: true,
         executionHint: "platform"
       },
+      // Cloudflare Browser Run Quick Action: Screenshot
+      {
+        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],
+        parametersSchema: {
+          type: "object",
+          properties: {
+            ...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: Content
+      {
+        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: browserRunCommonProperties,
+          required: ["url"]
+        },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      // Cloudflare Browser Run Quick Action: Scrape
+      {
+        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: {
+            ...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: ["url", "elements"]
+        },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      // Cloudflare Browser Run Quick Action: JSON
+      {
+        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: {
+            ...browserRunCommonProperties,
+            prompt: {
+              type: "string",
+              description: "Natural-language extraction instructions",
+              minLength: 1
+            },
+            schema: {
+              type: "object",
+              description: "JSON Schema describing the desired extracted result"
+            }
+          },
+          required: ["url"]
+        },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      // Cloudflare Browser Run Quick Action: Markdown
+      {
+        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: {
+            ...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: ["url"]
+        },
+        defaultConfig: {
+          visibleLinksOnly: false
+        },
+        documentationUrl: BROWSER_RUN_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      // -----------------------------------------------------------------------
+      // Cloudflare Browser Run Session Tools (Phase 2)
+      // Persistent browser sessions for interactive agent browsing.
+      // -----------------------------------------------------------------------
+      {
+        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: "The URL to navigate to"
+            },
+            viewport: browserRunViewportSchema,
+            userAgent: {
+              type: "string",
+              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: "The session ID returned by browser:open"
+            },
+            url: {
+              type: "string",
+              description: "The URL to navigate to"
+            },
+            waitUntil: {
+              type: "string",
+              description: "When to consider navigation finished",
+              enum: ["load", "domcontentloaded", "networkidle0", "networkidle2"],
+              default: "networkidle0"
+            }
+          },
+          required: ["sessionId", "url"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      {
+        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: {
+            sessionId: {
+              type: "string",
+              description: "The session ID returned by browser:open"
+            },
+            selector: {
+              type: "string",
+              description: "CSS selector of the element to click"
+            },
+            button: {
+              type: "string",
+              description: "Mouse button to click",
+              enum: ["left", "right", "middle"],
+              default: "left"
+            },
+            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: ["sessionId", "selector"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      {
+        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: {
+            sessionId: {
+              type: "string",
+              description: "The session ID returned by browser:open"
+            },
+            text: {
+              type: "string",
+              description: "The text to type"
+            },
+            selector: {
+              type: "string",
+              description: "CSS selector of the input element. If omitted, types into the focused element."
+            },
+            delay: {
+              type: "number",
+              description: "Delay between keystrokes in milliseconds",
+              minimum: 0
+            },
+            pressEnter: {
+              type: "boolean",
+              description: "Press Enter after typing",
+              default: false
+            }
+          },
+          required: ["sessionId", "text"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      {
+        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: {
+            sessionId: {
+              type: "string",
+              description: "The session ID returned by browser:open"
+            },
+            direction: {
+              type: "string",
+              description: "Scroll direction",
+              enum: ["up", "down", "left", "right"],
+              default: "down"
+            },
+            amount: {
+              type: "number",
+              description: "Scroll amount in pixels",
+              minimum: 1,
+              default: 500
+            },
+            selector: {
+              type: "string",
+              description: "CSS selector of the element to scroll within. If omitted, scrolls the page."
+            }
+          },
+          required: ["sessionId"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      {
+        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: {
+            sessionId: {
+              type: "string",
+              description: "The session ID returned by browser:open"
+            },
+            fullPage: {
+              type: "boolean",
+              description: "Capture the full scrollable page instead of just the viewport",
+              default: false
+            },
+            selector: {
+              type: "string",
+              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: ["sessionId"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      {
+        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: {
+            sessionId: {
+              type: "string",
+              description: "The session ID returned by browser:open"
+            },
+            script: {
+              type: "string",
+              description: "JavaScript code to evaluate in the page context"
+            }
+          },
+          required: ["sessionId", "script"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      {
+        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: {
+            sessionId: {
+              type: "string",
+              description: "The session ID returned by browser:open"
+            }
+          },
+          required: ["sessionId"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      {
+        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: {
+            sessionId: {
+              type: "string",
+              description: "The session ID returned by browser:open"
+            }
+          },
+          required: ["sessionId"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true
+      },
+      {
+        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: {
+            goal: {
+              type: "string",
+              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: ["goal"]
+        },
+        documentationUrl: BROWSER_SESSION_DOCUMENTATION_URL,
+        requiresApiKey: false,
+        executionHint: "platform",
+        platformKeySupport: true,
+        experimental: true
+      },
       // Vector Search - Semantic search across knowledge bases
       // Supports multi-instance format: builtin:vector-search#<instance-id>
       {
@@ -11684,6 +12447,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -11742,6 +12506,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -11836,6 +12601,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -11874,6 +12640,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -11907,6 +12674,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -11978,6 +12746,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12012,6 +12781,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12056,6 +12826,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12080,6 +12851,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12117,6 +12889,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12142,6 +12915,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12162,6 +12936,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12287,6 +13062,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12421,6 +13197,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12449,6 +13226,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12489,6 +13267,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12517,6 +13296,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12567,6 +13347,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12586,6 +13367,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12637,6 +13419,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12656,6 +13439,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12696,6 +13480,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12737,6 +13522,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12791,6 +13577,7 @@ var require_builtin_tools_registry = __commonJS({
         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",
@@ -12815,12 +13602,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 +13640,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 +13748,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 +13836,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"],
@@ -13214,6 +14012,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 +14083,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"],
@@ -13567,6 +14369,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 +14690,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 +14789,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"
       },
@@ -19681,6 +20501,7 @@ var require_flow_step_types = __commonJS({
       "fetch-github",
       "api-call",
       "transform-data",
+      "template",
       "conditional",
       "set-variable",
       "upsert-record",
@@ -19739,10 +20560,12 @@ 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.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" }),
@@ -19766,6 +20589,18 @@ 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()
+    });
+    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()
+    });
     exports.agentDefinitionSchema = zod_1.z.object({
       name: zod_1.z.string().min(1),
       description: zod_1.z.string().min(1),
@@ -19776,6 +20611,8 @@ var require_fpo_schema = __commonJS({
         model: zod_1.z.string(),
         systemPrompt: zod_1.z.string().optional()
       }).optional(),
+      subagentConfig: agentSubagentConfigSchema.optional(),
+      capabilityToolRefs: zod_1.z.array(capabilityToolRefSchema).optional(),
       createPolicy: createPolicySchema
     });
     exports.capabilitySchema = zod_1.z.object({
@@ -19874,9 +20711,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),
@@ -20038,6 +20873,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 +21078,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 +21103,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") {
@@ -20331,15 +21192,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 +21251,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 +21270,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 +21337,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 +21539,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 };
+    }
   }
 });