@positronic/core 0.0.77 → 0.0.78

package/dist/src/tools/index.js

@@ -119,7 +119,7 @@ function _ts_generator(thisArg, body) {
     }
 }
 import { z } from 'zod';
-import { generateUI as generateUICore } from '../ui/generate-ui.js';
+import { generatePage as generatePageCore } from '../ui/generate-page.js';
 import { generatePageHtml } from '../ui/generate-page-html.js';
 import { parseDuration } from '../dsl/duration.js';
 /**
@@ -145,7 +145,7 @@ import { parseDuration } from '../dsl/duration.js';
  */ export function createTool(config) {
     return config;
 }
-var generateUIInputSchema = z.object({
+var generatePageInputSchema = z.object({
     prompt: z.string().describe('Natural language instructions describing the UI to generate. ' + 'Include: (1) the purpose of the page, (2) what information to display from the data parameter, ' + '(3) what input fields are needed if collecting data, (4) labels and placeholders for fields, ' + '(5) any specific layout preferences. Example: "Create a form to collect user feedback with ' + 'fields for rating (1-5 scale), comments (text area), and email. Show the product name at the top."'),
     hasForm: z.boolean().optional().describe('Whether to include a form that can be submitted. Defaults to true. ' + 'Set to true when: collecting user input, approval workflows, any interactive data entry. ' + 'Set to false when: displaying read-only information, confirmation pages, dashboards. ' + 'When true, the tool returns webhook info that must be used with waitForWebhook to receive the submission.'),
     persist: z.boolean().optional().describe('Whether to keep the page after the brain run completes. Defaults to false. ' + 'Set to false (default): Page is automatically cleaned up when the brain run finishes. Use for one-time forms, approvals, or temporary displays. ' + 'Set to true: Page survives brain completion and remains accessible. Use for shared dashboards, permanent reference pages, or pages that need to outlive the workflow.'),
@@ -166,9 +166,9 @@ var generateUIInputSchema = z.object({
  * Requires components and pages to be configured via createBrain or withComponents().
  *
  * The description is enriched at runtime with available component information.
- */ export var generateUI = {
-    description: "Generate a web page for displaying rich content or collecting user input.\n\nSometimes you need more than simple notifications to communicate with users. This tool creates web pages that can display formatted content, dashboards, or forms to collect information.\n\nPass structured data via the 'data' parameter to populate the page with dynamic content. The UI generator uses {{path.to.value}} template bindings to render your data.\n\nRETURNS: { url: string, webhook: { slug: string, identifier: string, token: string } | null }\n- url: The page URL\n- webhook: For forms (hasForm=true), contains slug, identifier, and token that must be passed to waitForWebhook to pause execution until the user submits the form\n\nIMPORTANT: Users have no way to discover the page URL on their own. After generating a page, you must tell them the URL using whatever communication tools are available.",
-    inputSchema: generateUIInputSchema,
+ */ export var generatePage = {
+    description: "Generate a web page for displaying rich content or collecting user input.\n\nSometimes you need more than simple notifications to communicate with users. This tool creates web pages that can display formatted content, dashboards, or forms to collect information.\n\nPass structured data via the 'data' parameter to populate the page with dynamic content. The page generator uses {{path.to.value}} template bindings to render your data.\n\nRETURNS: { url: string, webhook: { slug: string, identifier: string, token: string } | null }\n- url: The page URL\n- webhook: For forms (hasForm=true), contains slug, identifier, and token that must be passed to waitForWebhook to pause execution until the user submits the form\n\nIMPORTANT: Users have no way to discover the page URL on their own. After generating a page, you must tell them the URL using whatever communication tools are available.",
+    inputSchema: generatePageInputSchema,
     execute: function execute(input, context) {
         return _async_to_generator(function() {
             var components, pages, client, state, env, brainRunId, stepId, _input_hasForm, hasForm, _input_data, uiResult, placementCount, webhookInfo, formAction, formToken, webhookIdentifier, _input_data1, html, page;
@@ -178,11 +178,11 @@ var generateUIInputSchema = z.object({
                         components = context.components, pages = context.pages, client = context.client, state = context.state, env = context.env, brainRunId = context.brainRunId, stepId = context.stepId;
                         hasForm = (_input_hasForm = input.hasForm) !== null && _input_hasForm !== void 0 ? _input_hasForm : true;
                         if (!components || Object.keys(components).length === 0) {
-                            throw new Error('generateUI requires components to be configured. ' + 'Use createBrain({ components }) or brain.withComponents() to register UI components.');
+                            throw new Error('generatePage requires components to be configured. ' + 'Use createBrain({ components }) or brain.withComponents() to register UI components.');
                         }
                         return [
                             4,
-                            generateUICore({
+                            generatePageCore({
                                 client: client,
                                 prompt: input.prompt,
                                 components: components,
@@ -194,19 +194,19 @@ var generateUIInputSchema = z.object({
                         if (!uiResult.rootId) {
                             placementCount = uiResult.placements.length;
                             if (placementCount === 0) {
-                                throw new Error("UI generation failed - no components were generated. " + "The LLM may not have understood the prompt. Try being more specific.");
+                                throw new Error("Page generation failed - no components were generated. " + "The LLM may not have understood the prompt. Try being more specific.");
                             } else {
-                                throw new Error("UI generation failed - no root component found. " + "".concat(placementCount, " component(s) were placed but all have a parentId."));
+                                throw new Error("Page generation failed - no root component found. " + "".concat(placementCount, " component(s) were placed but all have a parentId."));
                             }
                         }
                         // Create webhook info only if hasForm is true
                         webhookInfo = null;
                         if (hasForm) {
-                            webhookIdentifier = "".concat(brainRunId, "-").concat(stepId, "-generateui-").concat(Date.now());
+                            webhookIdentifier = "".concat(brainRunId, "-").concat(stepId, "-generatepage-").concat(Date.now());
                             formToken = crypto.randomUUID();
-                            formAction = "".concat(env.origin, "/webhooks/system/ui-form?identifier=").concat(encodeURIComponent(webhookIdentifier));
+                            formAction = "".concat(env.origin, "/webhooks/system/page-form?identifier=").concat(encodeURIComponent(webhookIdentifier), "&token=").concat(encodeURIComponent(formToken));
                             webhookInfo = {
-                                slug: 'ui-form',
+                                slug: 'page-form',
                                 identifier: webhookIdentifier,
                                 token: formToken
                             };
@@ -217,8 +217,7 @@ var generateUIInputSchema = z.object({
                             rootId: uiResult.rootId,
                             data: (_input_data1 = input.data) !== null && _input_data1 !== void 0 ? _input_data1 : {},
                             title: hasForm ? 'Generated Form' : 'Generated Page',
-                            formAction: formAction,
-                            formToken: formToken
+                            formAction: formAction
                         });
                         return [
                             4,
@@ -242,21 +241,21 @@ var generateUIInputSchema = z.object({
     }
 };
 var waitForWebhookInputSchema = z.object({
-    slug: z.string().describe('The webhook slug that identifies the type of webhook. ' + 'For generateUI forms, this is always "ui-form". ' + 'Use the exact slug value returned by the tool that created the webhook.'),
-    identifier: z.string().describe('The unique identifier for this specific webhook instance. ' + 'This is returned by generateUI in webhook.identifier. ' + 'Each generateUI call creates a unique identifier - use the one from the specific page you want to wait for.'),
-    token: z.string().optional().describe('The CSRF token for form submission validation. ' + 'This is returned by generateUI in webhook.token. ' + 'Pass it through to ensure only submissions from the actual page are accepted.'),
+    slug: z.string().describe('The webhook slug that identifies the type of webhook. ' + 'For generatePage forms, this is always "page-form". ' + 'Use the exact slug value returned by the tool that created the webhook.'),
+    identifier: z.string().describe('The unique identifier for this specific webhook instance. ' + 'This is returned by generatePage in webhook.identifier. ' + 'Each generatePage call creates a unique identifier - use the one from the specific page you want to wait for.'),
+    token: z.string().optional().describe('The CSRF token for form submission validation. ' + 'This is returned by generatePage in webhook.token. ' + 'Pass it through to ensure only submissions from the actual page are accepted.'),
     timeout: z.string().optional().describe('How long to wait before timing out. Defaults to "1h". ' + 'Accepts durations like "30m", "1h", "24h", "7d". ' + 'If the timeout elapses without a response, the brain is cancelled.')
 });
 /**
  * Wait for webhook tool - pauses execution until a webhook receives a response.
  *
- * Use this after generating a UI page with a form to wait for the user's submission.
+ * Use this after generating a page with a form to wait for the user's submission.
  * The form data will be returned as the tool result when the webhook fires.
  *
  * IMPORTANT: Before calling this tool, ensure the user knows the page URL
  * so they can access and submit the form.
  */ export var waitForWebhook = {
-    description: 'Pause agent execution and wait for an external event (webhook response).\n\nPURPOSE: Suspend the agent until a user action occurs, such as submitting a form generated by generateUI.\n\n⚠️ CRITICAL - BEFORE CALLING THIS TOOL:\nYou MUST have already communicated the page URL to the user in your response. The user has no other way to discover the URL. If you call this tool without first telling the user where to go, the job will freeze with no easy recovery.\n\nCORRECT SEQUENCE:\n1. Call generateUI to create the page\n2. In your response text, tell the user the URL (e.g., "Please complete the form at: {url}")\n3. THEN call waitForWebhook\n\nBEHAVIOR:\n- Calling this tool immediately pauses execution\n- The agent will NOT continue until the webhook receives data or the timeout elapses\n- Default timeout is 1 hour. Use the timeout parameter to customize (e.g., "30m", "24h", "7d")\n- If the timeout elapses without a response, the brain is cancelled\n- When the webhook fires, execution resumes with the webhook payload as this tool\'s result\n- The form data will be available as key-value pairs (e.g., { name: "John", email: "john@example.com" })\n\nWHEN TO USE:\n- After generateUI with hasForm=true, to wait for form submission\n- Any workflow requiring human input or approval before continuing\n\nFAILURE MODE: If the user doesn\'t know the URL, they cannot submit the form, and the agent waits until timeout. The only recovery is to kill the job or manually inspect the event stream for the URL.\n\nRETURNS: The webhook payload when triggered. For UI forms, this contains all form field values as an object.',
+    description: 'Pause agent execution and wait for an external event (webhook response).\n\nPURPOSE: Suspend the agent until a user action occurs, such as submitting a form generated by generatePage.\n\n⚠️ CRITICAL - BEFORE CALLING THIS TOOL:\nYou MUST have already communicated the page URL to the user in your response. The user has no other way to discover the URL. If you call this tool without first telling the user where to go, the job will freeze with no easy recovery.\n\nCORRECT SEQUENCE:\n1. Call generatePage to create the page\n2. In your response text, tell the user the URL (e.g., "Please complete the form at: {url}")\n3. THEN call waitForWebhook\n\nBEHAVIOR:\n- Calling this tool immediately pauses execution\n- The agent will NOT continue until the webhook receives data or the timeout elapses\n- Default timeout is 1 hour. Use the timeout parameter to customize (e.g., "30m", "24h", "7d")\n- If the timeout elapses without a response, the brain is cancelled\n- When the webhook fires, execution resumes with the webhook payload as this tool\'s result\n- The form data will be available as key-value pairs (e.g., { name: "John", email: "john@example.com" })\n\nWHEN TO USE:\n- After generatePage with hasForm=true, to wait for form submission\n- Any workflow requiring human input or approval before continuing\n\nFAILURE MODE: If the user doesn\'t know the URL, they cannot submit the form, and the agent waits until timeout. The only recovery is to kill the job or manually inspect the event stream for the URL.\n\nRETURNS: The webhook payload when triggered. For UI forms, this contains all form field values as an object.',
     inputSchema: waitForWebhookInputSchema,
     execute: function execute(input) {
         var webhook = {
@@ -312,10 +311,73 @@ var waitForWebhookInputSchema = z.object({
     }
 });
 /**
- * Default schema for the auto-generated 'done' tool when no outputSchema is provided.
- * Used internally by the framework.
- */ export var defaultDoneSchema = z.object({
-    result: z.string().describe('A clear summary of what was accomplished. ' + 'Include: key outcomes, any important values or findings, and confirmation that the task is complete. ' + 'Be specific but concise. Example: "Successfully processed 15 orders totaling $1,234.56. All items shipped."')
+ * Read a file by name. The agent decides which files to read.
+ * Returns the file content as text.
+ */ export var readFile = createTool({
+    description: 'Read the contents of a file by name. Returns the file content as text.',
+    inputSchema: z.object({
+        name: z.string().describe('The file name to read')
+    }),
+    execute: function execute(_0, _1) {
+        return _async_to_generator(function(param, context) {
+            var name, _tmp;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        name = param.name;
+                        if (!context.files) {
+                            throw new Error('readFile tool requires a files service to be configured');
+                        }
+                        _tmp = {};
+                        return [
+                            4,
+                            context.files.open(name).read()
+                        ];
+                    case 1:
+                        return [
+                            2,
+                            (_tmp.content = _state.sent(), _tmp)
+                        ];
+                }
+            });
+        }).apply(this, arguments);
+    }
+});
+/**
+ * Write text content to a file. The agent decides what to write and where.
+ */ export var writeFile = createTool({
+    description: 'Write text content to a file. Creates or overwrites the file.',
+    inputSchema: z.object({
+        name: z.string().describe('The file name to write'),
+        content: z.string().describe('The text content to write')
+    }),
+    execute: function execute(_0, _1) {
+        return _async_to_generator(function(param, context) {
+            var name, content;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        name = param.name, content = param.content;
+                        if (!context.files) {
+                            throw new Error('writeFile tool requires a files service to be configured');
+                        }
+                        return [
+                            4,
+                            context.files.write(name, content)
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2,
+                            {
+                                written: true,
+                                name: name
+                            }
+                        ];
+                }
+            });
+        }).apply(this, arguments);
+    }
 });
 /**
  * Default tools bundle.
@@ -324,9 +386,8 @@ var waitForWebhookInputSchema = z.object({
  * standard tools in your brain. Tools can be extended or overridden in
  * individual agent steps.
  *
- * Note: A 'done' terminal tool is automatically generated for every agent.
- * If you provide an outputSchema, 'done' will use that schema. Otherwise,
- * it uses a default schema expecting { result: string }.
+ * Note: A 'done' terminal tool is automatically generated for every agent
+ * using the required outputSchema.
  *
  * @example
  * ```typescript
@@ -347,7 +408,7 @@ var waitForWebhookInputSchema = z.object({
  *   }));
  * ```
  */ export var defaultTools = {
-    generateUI: generateUI,
+    generatePage: generatePage,
     waitForWebhook: waitForWebhook,
     print: print,
     consoleLog: consoleLog

package/dist/src/ui/generate-page-html.js

@@ -2,9 +2,9 @@
  * Generate a CSRF token for form submissions.
  * Use this when building custom HTML pages with forms that submit to webhook endpoints.
  *
- * Include the returned token as a hidden input field:
- * ```html
- * <input type="hidden" name="__positronic_token" value="${token}">
+ * Include the returned token as a query parameter in the form action URL:
+ * ```
+ * /webhooks/system/ui-form?identifier=...&token=${token}
  * ```
  * And include it in the WebhookRegistration's `token` field.
  */ export function generateFormToken() {
@@ -13,7 +13,7 @@
 /**
  * Bootstrap runtime that builds and renders the React tree from placements.
  * This is inlined into the generated page.
- */ var bootstrapRuntime = "\n(function() {\n  const components = window.PositronicComponents;\n  const data = window.__POSITRONIC_DATA__;\n  const tree = window.__POSITRONIC_TREE__;\n  const rootId = window.__POSITRONIC_ROOT__;\n  const formAction = window.__POSITRONIC_FORM_ACTION__;\n  const formToken = window.__POSITRONIC_FORM_TOKEN__;\n\n  if (!components) {\n    console.error('PositronicComponents not loaded');\n    return;\n  }\n\n  /**\n   * Resolve a binding path against a data context.\n   * e.g., \"email.subject\" against { email: { subject: \"Hello\" } } -> \"Hello\"\n   */\n  function resolveBinding(path, ctx) {\n    return path.split('.').reduce(function(obj, key) {\n      return obj && obj[key];\n    }, ctx);\n  }\n\n  /**\n   * Resolve a prop value - handle both full bindings and embedded bindings.\n   * - \"{{path}}\" -> resolved value (preserves type - arrays, objects, etc.)\n   * - \"Hello {{name}}, score: {{score}}\" -> \"Hello John, score: 42\"\n   */\n  function resolveProp(value, ctx) {\n    if (typeof value !== 'string') {\n      return value;\n    }\n    // Check if the entire value is a single binding - return the actual value (preserves arrays/objects)\n    var fullBindingMatch = value.match(/^{{([^}]+)}}$/);\n    if (fullBindingMatch) {\n      var resolved = resolveBinding(fullBindingMatch[1].trim(), ctx);\n      return resolved !== undefined ? resolved : value;\n    }\n    // Otherwise replace embedded bindings as strings\n    return value.replace(/{{([^}]+)}}/g, function(match, path) {\n      var resolved = resolveBinding(path.trim(), ctx);\n      return resolved !== undefined ? String(resolved) : match;\n    });\n  }\n\n  /**\n   * Build a React element from a placement.\n   */\n  function buildElement(placementId, ctx) {\n    var placement = tree.find(function(p) { return p.id === placementId; });\n    if (!placement) {\n      console.error('Placement not found:', placementId);\n      return null;\n    }\n\n    // Resolve props first (needed for List handling)\n    var props = {};\n    for (var key in placement.props) {\n      props[key] = resolveProp(placement.props[key], ctx);\n    }\n\n    // Handle List component specially - it's a virtual component that creates a loop context\n    if (placement.component === 'List') {\n      var items = Array.isArray(props.items) ? props.items : [];\n      var itemVarName = props.as || 'item';\n\n      // Find direct children of this List\n      var childIds = tree\n        .filter(function(p) { return p.parentId === placementId; })\n        .map(function(p) { return p.id; });\n\n      var listItems = items.map(function(item, index) {\n        // Create new context with loop variable\n        var itemCtx = Object.assign({}, ctx);\n        itemCtx[itemVarName] = item;\n        itemCtx[itemVarName + 'Index'] = index;\n\n        var children = childIds.map(function(childId) {\n          return buildElement(childId, itemCtx);\n        });\n\n        return React.createElement('div', { key: index, className: 'p-4 bg-white border border-gray-200 rounded-lg' }, children);\n      });\n\n      return React.createElement('div', { className: 'flex flex-col gap-4' }, listItems);\n    }\n\n    // Look up the component (after handling virtual components like List)\n    var Component = components[placement.component];\n    if (!Component) {\n      console.error('Component not found:', placement.component);\n      return null;\n    }\n\n    // Handle Form component - inject action URL and CSRF token\n    if (placement.component === 'Form' && formAction) {\n      props.action = formAction;\n    }\n\n    // Find direct children\n    var childIds = tree\n      .filter(function(p) { return p.parentId === placementId; })\n      .map(function(p) { return p.id; });\n\n    var children = childIds.map(function(childId) {\n      return buildElement(childId, ctx);\n    });\n\n    // Prepend hidden CSRF token input to Form components\n    if (placement.component === 'Form' && formToken) {\n      children = [React.createElement('input', {\n        type: 'hidden', name: '__positronic_token', value: formToken, key: '__positronic_token'\n      })].concat(children);\n    }\n\n    return React.createElement(Component, props, children.length > 0 ? children : undefined);\n  }\n\n  // Render the tree\n  var root = document.getElementById('root');\n  if (root && rootId) {\n    var element = buildElement(rootId, data);\n    ReactDOM.render(element, root);\n  }\n})();\n";
+ */ var bootstrapRuntime = "\n(function() {\n  const components = window.PositronicComponents;\n  const data = window.__POSITRONIC_DATA__;\n  const tree = window.__POSITRONIC_TREE__;\n  const rootId = window.__POSITRONIC_ROOT__;\n  const formAction = window.__POSITRONIC_FORM_ACTION__;\n\n  if (!components) {\n    console.error('PositronicComponents not loaded');\n    return;\n  }\n\n  /**\n   * Resolve a binding path against a data context.\n   * e.g., \"email.subject\" against { email: { subject: \"Hello\" } } -> \"Hello\"\n   */\n  function resolveBinding(path, ctx) {\n    return path.split('.').reduce(function(obj, key) {\n      return obj && obj[key];\n    }, ctx);\n  }\n\n  /**\n   * Resolve a prop value - handle both full bindings and embedded bindings.\n   * - \"{{path}}\" -> resolved value (preserves type - arrays, objects, etc.)\n   * - \"Hello {{name}}, score: {{score}}\" -> \"Hello John, score: 42\"\n   */\n  function resolveProp(value, ctx) {\n    if (typeof value !== 'string') {\n      return value;\n    }\n    // Check if the entire value is a single binding - return the actual value (preserves arrays/objects)\n    var fullBindingMatch = value.match(/^{{([^}]+)}}$/);\n    if (fullBindingMatch) {\n      var resolved = resolveBinding(fullBindingMatch[1].trim(), ctx);\n      return resolved !== undefined ? resolved : value;\n    }\n    // Otherwise replace embedded bindings as strings\n    return value.replace(/{{([^}]+)}}/g, function(match, path) {\n      var resolved = resolveBinding(path.trim(), ctx);\n      return resolved !== undefined ? String(resolved) : match;\n    });\n  }\n\n  /**\n   * Build a React element from a placement.\n   */\n  function buildElement(placementId, ctx) {\n    var placement = tree.find(function(p) { return p.id === placementId; });\n    if (!placement) {\n      console.error('Placement not found:', placementId);\n      return null;\n    }\n\n    // Resolve props first (needed for List handling)\n    var props = {};\n    for (var key in placement.props) {\n      props[key] = resolveProp(placement.props[key], ctx);\n    }\n\n    // Handle List component specially - it's a virtual component that creates a loop context\n    if (placement.component === 'List') {\n      var items = Array.isArray(props.items) ? props.items : [];\n      var itemVarName = props.as || 'item';\n\n      // Find direct children of this List\n      var childIds = tree\n        .filter(function(p) { return p.parentId === placementId; })\n        .map(function(p) { return p.id; });\n\n      var listItems = items.map(function(item, index) {\n        // Create new context with loop variable\n        var itemCtx = Object.assign({}, ctx);\n        itemCtx[itemVarName] = item;\n        itemCtx[itemVarName + 'Index'] = index;\n\n        var children = childIds.map(function(childId) {\n          return buildElement(childId, itemCtx);\n        });\n\n        return React.createElement('div', { key: index, className: 'p-4 bg-white border border-gray-200 rounded-lg' }, children);\n      });\n\n      return React.createElement('div', { className: 'flex flex-col gap-4' }, listItems);\n    }\n\n    // Look up the component (after handling virtual components like List)\n    var Component = components[placement.component];\n    if (!Component) {\n      console.error('Component not found:', placement.component);\n      return null;\n    }\n\n    // Handle Form component - inject action URL and CSRF token\n    if (placement.component === 'Form' && formAction) {\n      props.action = formAction;\n    }\n\n    // Find direct children\n    var childIds = tree\n      .filter(function(p) { return p.parentId === placementId; })\n      .map(function(p) { return p.id; });\n\n    var children = childIds.map(function(childId) {\n      return buildElement(childId, ctx);\n    });\n\n    return React.createElement(Component, props, children.length > 0 ? children : undefined);\n  }\n\n  // Render the tree\n  var root = document.getElementById('root');\n  if (root && rootId) {\n    var element = buildElement(rootId, data);\n    ReactDOM.render(element, root);\n  }\n})();\n";
 /**
  * Generate a complete HTML page from placements.
  *
@@ -35,7 +35,7 @@
  * });
  * ```
  */ export function generatePageHtml(options) {
-    var placements = options.placements, rootId = options.rootId, data = options.data, _options_title = options.title, title = _options_title === void 0 ? 'Generated Page' : _options_title, formAction = options.formAction, formToken = options.formToken;
+    var placements = options.placements, rootId = options.rootId, data = options.data, _options_title = options.title, title = _options_title === void 0 ? 'Generated Page' : _options_title, formAction = options.formAction;
     // Escape for embedding in HTML
     var escapeHtml = function(str) {
         return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
@@ -44,5 +44,5 @@
     var safeJsonStringify = function(obj) {
         return JSON.stringify(obj).replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/&/g, '\\u0026');
     };
-    return '<!DOCTYPE html>\n<html lang="en">\n<head>\n  <meta charset="UTF-8">\n  <meta name="viewport" content="width=device-width, initial-scale=1.0">\n  <title>'.concat(escapeHtml(title), '</title>\n  <script crossorigin src="https://unpkg.com/react@18/umd/react.production.min.js"></script>\n  <script crossorigin src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>\n  <script src="https://cdn.tailwindcss.com"></script>\n</head>\n<body class="bg-gray-50 min-h-screen">\n  <div id="root" class="max-w-4xl mx-auto p-6"></div>\n\n  <!-- Pre-bundled components -->\n  <script src="/bundle/components.js"></script>\n\n  <!-- Data and placements -->\n  <script>\n    window.__POSITRONIC_DATA__ = ').concat(safeJsonStringify(data), ";\n    window.__POSITRONIC_TREE__ = ").concat(safeJsonStringify(placements), ";\n    window.__POSITRONIC_ROOT__ = ").concat(safeJsonStringify(rootId), ";\n    window.__POSITRONIC_FORM_ACTION__ = ").concat(formAction ? safeJsonStringify(formAction) : 'null', ";\n    window.__POSITRONIC_FORM_TOKEN__ = ").concat(formToken ? safeJsonStringify(formToken) : 'null', ";\n  </script>\n\n  <!-- Bootstrap runtime -->\n  <script>\n").concat(bootstrapRuntime, "\n  </script>\n</body>\n</html>");
+    return '<!DOCTYPE html>\n<html lang="en">\n<head>\n  <meta charset="UTF-8">\n  <meta name="viewport" content="width=device-width, initial-scale=1.0">\n  <title>'.concat(escapeHtml(title), '</title>\n  <script crossorigin src="https://unpkg.com/react@18/umd/react.production.min.js"></script>\n  <script crossorigin src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>\n  <script src="https://cdn.tailwindcss.com"></script>\n</head>\n<body class="bg-gray-50 min-h-screen">\n  <div id="root" class="max-w-4xl mx-auto p-6"></div>\n\n  <!-- Pre-bundled components -->\n  <script src="/bundle/components.js"></script>\n\n  <!-- Data and placements -->\n  <script>\n    window.__POSITRONIC_DATA__ = ').concat(safeJsonStringify(data), ";\n    window.__POSITRONIC_TREE__ = ").concat(safeJsonStringify(placements), ";\n    window.__POSITRONIC_ROOT__ = ").concat(safeJsonStringify(rootId), ";\n    window.__POSITRONIC_FORM_ACTION__ = ").concat(formAction ? safeJsonStringify(formAction) : 'null', ";\n  </script>\n\n  <!-- Bootstrap runtime -->\n  <script>\n").concat(bootstrapRuntime, "\n  </script>\n</body>\n</html>");
 }

package/dist/src/ui/{generate-ui.js → generate-page.js}

@@ -185,6 +185,7 @@ function _ts_generator(thisArg, body) {
 }
 import { v4 as uuidv4 } from 'uuid';
 import { z } from 'zod';
+import { IterateResult } from '../dsl/iterate-result.js';
 import { parseTemplate } from '../yaml/parser.js';
 import { inferDataType, resolveBindings, validateDataBindings } from '../yaml/data-validator.js';
 import { extractFormSchema, validateAgainstZod } from '../yaml/schema-extractor.js';
@@ -319,7 +320,7 @@ import { describeDataShape } from '../yaml/type-inference.js';
  */ function createValidateTemplateTool(components, schema, data) {
     var dataType = inferDataType(data);
     return {
-        description: "Validate a YAML template. Checks that:\n1. The YAML is valid and can be parsed\n2. All component names are valid\n3. All data bindings (like {{email.subject}}) reference valid paths in the provided data\n4. Form components have a Button for submission\n5. The form fields will produce data matching the expected schema (if schema provided)\n\nReturns resolvedBindings showing what each binding resolves to in the actual data. Use this to verify bindings point to the right values.\n\nCall this after generating your YAML template to verify it's correct before finalizing.",
+        description: "Validate a YAML template. Checks that:\n1. The YAML is valid and can be parsed\n2. All component names are valid\n3. All data bindings (like {{email.subject}}) reference valid paths in the provided data\n4. Form components have a Button for submission\n5. The form fields will produce data matching the expected schema (if schema provided)\n\nReturns resolvedBindings showing whether each binding path is valid. Use this to verify bindings reference valid data paths.\n\nCall this after generating your YAML template to verify it's correct before finalizing.",
         inputSchema: z.object({
             yaml: z.string().describe('The complete YAML template to validate')
         }),
@@ -499,18 +500,21 @@ import { describeDataShape } from '../yaml/type-inference.js';
 /**
  * Build the user prompt with data shape and instructions.
  */ function buildUserPrompt(prompt, data, schema) {
-    var dataShape = describeDataShape(data);
-    var userPrompt = "## Available Data\n```typescript\n".concat(dataShape, "\n```\n\n## Instructions\n").concat(prompt);
+    var hasData = Object.keys(data).length > 0;
+    var userPrompt = '';
+    if (hasData) {
+        var dataShape = describeDataShape(data, {
+            includeExamples: false
+        });
+        userPrompt += "## Available Data\n```typescript\n".concat(dataShape, "\n```\n\n");
+    }
+    userPrompt += "## Instructions\n".concat(prompt);
     if (schema) {
         var schemaFields = Object.entries(schema.shape).map(function(param) {
             var _param = _sliced_to_array(param, 2), name = _param[0], field = _param[1];
             var isOptional = _instanceof(field, z.ZodOptional);
             var baseType = isOptional ? field.unwrap() : field;
-            var typeName = 'unknown';
-            if (_instanceof(baseType, z.ZodString)) typeName = 'string';
-            else if (_instanceof(baseType, z.ZodNumber)) typeName = 'number';
-            else if (_instanceof(baseType, z.ZodBoolean)) typeName = 'boolean';
-            else if (_instanceof(baseType, z.ZodArray)) typeName = "".concat(typeName, "[]");
+            var typeName = getZodTypeName(baseType);
             return "- ".concat(name, ": ").concat(typeName).concat(isOptional ? ' (optional)' : '');
         }).join('\n');
         userPrompt += "\n\n## Expected Form Output\nThe form must collect these fields:\n".concat(schemaFields, "\n\nCall validate_template after generating your YAML to verify correctness.");
@@ -527,7 +531,7 @@ import { describeDataShape } from '../yaml/type-inference.js';
  * ```typescript
  * import { components } from '@positronic/gen-ui-components';
  *
- * const result = await generateUI({
+ * const result = await generatePage({
  *   client,
  *   prompt: 'Create a form to collect user name and email',
  *   components,
@@ -539,13 +543,21 @@ import { describeDataShape } from '../yaml/type-inference.js';
  * // result.rootId is the ID of the root component
  * // result.yaml is the generated YAML template
  * ```
- */ export function generateUI(params) {
+ */ export function generatePage(params) {
     return _async_to_generator(function() {
-        var client, prompt, components, schema, _params_data, data, _params_maxSteps, maxSteps, _params_system, systemPrompt, userPrompt, validateTool, result, _result_text, yamlContent, yamlMatch, placements, rootId, _placements_find, template;
+        var client, prompt, components, schema, tmp, rawData, _params_maxSteps, maxSteps, data, _params_system, systemPrompt, userPrompt, validateTool, result, _result_text, yamlContent, yamlMatch, placements, rootId, _placements_find, template;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
-                    client = params.client, prompt = params.prompt, components = params.components, schema = params.schema, _params_data = params.data, data = _params_data === void 0 ? {} : _params_data, _params_maxSteps = params.maxSteps, maxSteps = _params_maxSteps === void 0 ? 10 : _params_maxSteps;
+                    client = params.client, prompt = params.prompt, components = params.components, schema = params.schema, tmp = params.data, rawData = tmp === void 0 ? {} : tmp, _params_maxSteps = params.maxSteps, maxSteps = _params_maxSteps === void 0 ? 10 : _params_maxSteps;
+                    // Unwrap IterateResult values to plain arrays so the LLM sees a clean data shape
+                    data = Object.fromEntries(Object.entries(rawData).map(function(param) {
+                        var _param = _sliced_to_array(param, 2), k = _param[0], v = _param[1];
+                        return [
+                            k,
+                            _instanceof(v, IterateResult) ? v.values : v
+                        ];
+                    }));
                     systemPrompt = (_params_system = params.system) !== null && _params_system !== void 0 ? _params_system : buildSystemPrompt(components, !!schema);
                     userPrompt = buildUserPrompt(prompt, data, schema);
                     // Create the validate_template tool

package/dist/src/ui/parse-form-data.js

@@ -1,6 +1,5 @@
 /**
  * Parse form data into a plain object, handling array fields.
- * Extracts and strips the __positronic_token CSRF field.
  * Supports:
  * - name[] syntax for explicit arrays
  * - Multiple values with same key (converted to array)
@@ -52,16 +51,10 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 export function parseFormData(formData) {
     var result = {};
-    var token = null;
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = formData.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
             var _step_value = _sliced_to_array(_step.value, 2), key = _step_value[0], value = _step_value[1];
-            // Extract CSRF token and exclude from response data
-            if (key === '__positronic_token') {
-                token = value;
-                continue;
-            }
             // Handle array fields (e.g., name[] for multi-select)
             if (key.endsWith('[]')) {
                 var baseKey = key.slice(0, -2);
@@ -95,8 +88,5 @@ export function parseFormData(formData) {
             }
         }
     }
-    return {
-        data: result,
-        token: token
-    };
+    return result;
 }

package/dist/src/ui/types.js

@@ -1,11 +1,3 @@
-function _array_like_to_array(arr, len) {
-    if (len == null || len > arr.length) len = arr.length;
-    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
-    return arr2;
-}
-function _array_with_holes(arr) {
-    if (Array.isArray(arr)) return arr;
-}
 function _instanceof(left, right) {
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
         return !!right[Symbol.hasInstance](left);
@@ -13,122 +5,7 @@ function _instanceof(left, right) {
         return left instanceof right;
     }
 }
-function _iterable_to_array_limit(arr, i) {
-    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
-    if (_i == null) return;
-    var _arr = [];
-    var _n = true;
-    var _d = false;
-    var _s, _e;
-    try {
-        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
-            _arr.push(_s.value);
-            if (i && _arr.length === i) break;
-        }
-    } catch (err) {
-        _d = true;
-        _e = err;
-    } finally{
-        try {
-            if (!_n && _i["return"] != null) _i["return"]();
-        } finally{
-            if (_d) throw _e;
-        }
-    }
-    return _arr;
-}
-function _non_iterable_rest() {
-    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-function _sliced_to_array(arr, i) {
-    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
-}
-function _type_of(obj) {
-    "@swc/helpers - typeof";
-    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
-}
-function _unsupported_iterable_to_array(o, minLen) {
-    if (!o) return;
-    if (typeof o === "string") return _array_like_to_array(o, minLen);
-    var n = Object.prototype.toString.call(o).slice(8, -1);
-    if (n === "Object" && o.constructor) n = o.constructor.name;
-    if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
-}
 import { z } from 'zod';
-/**
- * Infer the DataType from a sample value.
- */ export function inferDataType(value) {
-    if (value === null) {
-        return {
-            kind: 'primitive',
-            type: 'null'
-        };
-    }
-    if (typeof value === 'string') {
-        return {
-            kind: 'primitive',
-            type: 'string'
-        };
-    }
-    if (typeof value === 'number') {
-        return {
-            kind: 'primitive',
-            type: 'number'
-        };
-    }
-    if (typeof value === 'boolean') {
-        return {
-            kind: 'primitive',
-            type: 'boolean'
-        };
-    }
-    if (Array.isArray(value)) {
-        if (value.length === 0) {
-            return {
-                kind: 'array',
-                elementType: {
-                    kind: 'unknown'
-                }
-            };
-        }
-        // Infer from first element
-        return {
-            kind: 'array',
-            elementType: inferDataType(value[0])
-        };
-    }
-    if ((typeof value === "undefined" ? "undefined" : _type_of(value)) === 'object') {
-        var properties = {};
-        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-        try {
-            for(var _iterator = Object.entries(value)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                var _step_value = _sliced_to_array(_step.value, 2), key = _step_value[0], val = _step_value[1];
-                properties[key] = inferDataType(val);
-            }
-        } catch (err) {
-            _didIteratorError = true;
-            _iteratorError = err;
-        } finally{
-            try {
-                if (!_iteratorNormalCompletion && _iterator.return != null) {
-                    _iterator.return();
-                }
-            } finally{
-                if (_didIteratorError) {
-                    throw _iteratorError;
-                }
-            }
-        }
-        return {
-            kind: 'object',
-            properties: properties
-        };
-    }
-    return {
-        kind: 'unknown'
-    };
-}
 /**
  * Type guard to check if a schema is form-compatible at runtime.
  * Used as a backup validation when TypeScript inference isn't sufficient.

package/dist/src/yaml/data-validator.js

@@ -366,32 +366,6 @@ function _unsupported_iterable_to_array(o, minLen) {
     }
     return current;
 }
-/**
- * Summarize a value for LLM consumption.
- * Keeps output compact — no full data dumps.
- */ export function summarizeValue(value) {
-    if (value === undefined) return 'undefined';
-    if (value === null) return 'null';
-    if (typeof value === 'string') {
-        if (value.length <= 60) return JSON.stringify(value);
-        return JSON.stringify(value.slice(0, 57) + '...');
-    }
-    if (typeof value === 'number' || typeof value === 'boolean') {
-        return String(value);
-    }
-    if (Array.isArray(value)) {
-        if (value.length === 0) return 'Array(0) []';
-        var firstPreview = summarizeValue(value[0]);
-        return "Array(".concat(value.length, ") [").concat(firstPreview, ", ...]");
-    }
-    if ((typeof value === "undefined" ? "undefined" : _type_of(value)) === 'object') {
-        var keys = Object.keys(value);
-        var keyPreview = keys.slice(0, 5).join(', ');
-        var suffix = keys.length > 5 ? ', ...' : '';
-        return "{ ".concat(keyPreview).concat(suffix, " } (").concat(keys.length, " keys)");
-    }
-    return String(value);
-}
 /**
  * Walk the ComponentNode tree and resolve every binding against real data.
  *
@@ -412,7 +386,6 @@ function _unsupported_iterable_to_array(o, minLen) {
                         path: propValue.path,
                         component: node.component,
                         prop: propName,
-                        value: summarizeValue(value),
                         resolved: value !== undefined
                     });
                 }

package/dist/src/yaml/type-inference.js

@@ -114,7 +114,7 @@ export function inferTypeDescription(value) {
  * @param indent - Current indentation level
  * @returns Multi-line string describing the type with examples
  */ export function inferTypeWithExamples(value) {
-    var indent = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 0;
+    var indent = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 0, includeExamples = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : true;
     var spaces = '  '.repeat(indent);
     if (value === null) {
         return 'null';
@@ -123,23 +123,23 @@ export function inferTypeDescription(value) {
         return 'undefined';
     }
     if (typeof value === 'string') {
-        return "string // e.g., ".concat(formatExample(value));
+        return includeExamples ? "string // e.g., ".concat(formatExample(value)) : 'string';
     }
     if (typeof value === 'number') {
-        return "number // e.g., ".concat(value);
+        return includeExamples ? "number // e.g., ".concat(value) : 'number';
     }
     if (typeof value === 'boolean') {
-        return "boolean // e.g., ".concat(value);
+        return includeExamples ? "boolean // e.g., ".concat(value) : 'boolean';
     }
     if (Array.isArray(value)) {
         if (value.length === 0) {
             return 'unknown[] // empty array';
         }
         var firstElement = value[0];
-        var elementType = inferTypeWithExamples(firstElement, indent + 1);
+        var elementType = inferTypeWithExamples(firstElement, indent + 1, includeExamples);
         // For primitive arrays, keep it compact
         if (typeof firstElement === 'string' || typeof firstElement === 'number' || typeof firstElement === 'boolean') {
-            return "Array<".concat(inferTypeDescription(firstElement), "> // ").concat(value.length, " items, e.g., ").concat(formatExample(firstElement));
+            return includeExamples ? "Array<".concat(inferTypeDescription(firstElement), "> // ").concat(value.length, " items, e.g., ").concat(formatExample(firstElement)) : "Array<".concat(inferTypeDescription(firstElement), "> // ").concat(value.length, " items");
         }
         // For object arrays, show the structure
         return "Array<".concat(elementType, "> // ").concat(value.length, " items");
@@ -156,7 +156,7 @@ export function inferTypeDescription(value) {
         try {
             for(var _iterator = entries[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
                 var _step_value = _sliced_to_array(_step.value, 2), key = _step_value[0], val = _step_value[1];
-                var valType = inferTypeWithExamples(val, indent + 1);
+                var valType = inferTypeWithExamples(val, indent + 1, includeExamples);
                 lines.push("".concat(spaces, "  ").concat(key, ": ").concat(valType));
             }
         } catch (err) {
@@ -205,6 +205,7 @@ export function inferTypeDescription(value) {
  * //   sessionId: string // e.g., "abc123"
  * // }
  * ```
- */ export function describeDataShape(data) {
-    return inferTypeWithExamples(data, 0);
+ */ export function describeDataShape(data, options) {
+    var _options_includeExamples;
+    return inferTypeWithExamples(data, 0, (_options_includeExamples = options === null || options === void 0 ? void 0 : options.includeExamples) !== null && _options_includeExamples !== void 0 ? _options_includeExamples : true);
 }