@positronic/core 0.0.75 → 0.0.77

package/dist/src/dsl/execution/event-stream.js

@@ -166,35 +166,6 @@ function AsyncFromSyncIterator(s) {
         }
     }, new AsyncFromSyncIterator(s);
 }
-function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
-    try {
-        var info = gen[key](arg);
-        var value = info.value;
-    } catch (error) {
-        reject(error);
-        return;
-    }
-    if (info.done) {
-        resolve(value);
-    } else {
-        Promise.resolve(value).then(_next, _throw);
-    }
-}
-function _async_to_generator(fn) {
-    return function() {
-        var self = this, args = arguments;
-        return new Promise(function(resolve, reject) {
-            var gen = fn.apply(self, args);
-            function _next(value) {
-                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
-            }
-            function _throw(err) {
-                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
-            }
-            _next(undefined);
-        });
-    };
-}
 function _await_async_generator(value) {
     return new _overload_yield(value, 0);
 }
@@ -465,6 +436,7 @@ import { z } from 'zod';
 import { v4 as uuidv4 } from 'uuid';
 import { STATUS, BRAIN_EVENTS } from '../constants.js';
 import { createPatch, applyPatches } from '../json-patch.js';
+import { IterateResult } from '../iterate-result.js';
 import { generateUI } from '../../ui/generate-ui.js';
 import { generatePageHtml } from '../../ui/generate-page-html.js';
 import { createScopedMemory } from '../../memory/scoped-memory.js';
@@ -474,45 +446,6 @@ import { defaultDoneSchema } from '../../tools/index.js';
 var clone = function(value) {
     return structuredClone(value);
 };
-function createSemaphore(limit) {
-    var running = 0;
-    var queue = [];
-    return {
-        acquire: function acquire() {
-            return _async_to_generator(function() {
-                return _ts_generator(this, function(_state) {
-                    if (running < limit) {
-                        running++;
-                        return [
-                            2,
-                            function() {
-                                running--;
-                                if (queue.length > 0) {
-                                    running++;
-                                    queue.shift()();
-                                }
-                            }
-                        ];
-                    }
-                    return [
-                        2,
-                        new Promise(function(resolve) {
-                            queue.push(function() {
-                                return resolve(function() {
-                                    running--;
-                                    if (queue.length > 0) {
-                                        running++;
-                                        queue.shift()();
-                                    }
-                                });
-                            });
-                        })
-                    ];
-                });
-            })();
-        }
-    };
-}
 export var BrainEventStream = /*#__PURE__*/ function() {
     "use strict";
     function BrainEventStream(params) {
@@ -534,6 +467,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
         _define_property(this, "resumeContext", void 0);
         _define_property(this, "components", void 0);
         _define_property(this, "defaultTools", void 0);
+        _define_property(this, "extraTools", void 0);
         _define_property(this, "signalProvider", void 0);
         _define_property(this, "memoryProvider", void 0);
         _define_property(this, "scopedMemory", void 0);
@@ -543,7 +477,8 @@ export var BrainEventStream = /*#__PURE__*/ function() {
         _define_property(this, "guards", new Map());
         _define_property(this, "waits", new Map());
         _define_property(this, "stopped", false);
-        var blocks = params.blocks, title = params.title, description = params.description, providedBrainRunId = params.brainRunId, _params_options = params.options, options = _params_options === void 0 ? {} : _params_options, client = params.client, services = params.services, _params_resources = params.resources, resources = _params_resources === void 0 ? {} : _params_resources, pages = params.pages, env = params.env, components = params.components, defaultTools = params.defaultTools, signalProvider = params.signalProvider, memoryProvider = params.memoryProvider, store = params.store, currentUser = params.currentUser;
+        _define_property(this, "optionsSchema", void 0);
+        var blocks = params.blocks, title = params.title, description = params.description, providedBrainRunId = params.brainRunId, _params_options = params.options, options = _params_options === void 0 ? {} : _params_options, client = params.client, services = params.services, _params_resources = params.resources, resources = _params_resources === void 0 ? {} : _params_resources, pages = params.pages, env = params.env, components = params.components, defaultTools = params.defaultTools, extraTools = params.extraTools, signalProvider = params.signalProvider, memoryProvider = params.memoryProvider, store = params.store, currentUser = params.currentUser;
         // Store governor for per-step client resolution
         this.governor = params.governor;
         this.currentUser = currentUser;
@@ -562,9 +497,11 @@ export var BrainEventStream = /*#__PURE__*/ function() {
         this.resumeContext = resumeContext;
         this.components = components;
         this.defaultTools = defaultTools;
+        this.extraTools = extraTools;
         this.signalProvider = signalProvider;
         this.memoryProvider = memoryProvider;
         this.store = store;
+        this.optionsSchema = params.optionsSchema;
         // Create scoped memory if provider is configured
         if (memoryProvider) {
             this.scopedMemory = createScopedMemory(memoryProvider, title, this.currentUser.name);
@@ -611,7 +548,16 @@ export var BrainEventStream = /*#__PURE__*/ function() {
             if (!signalProvider && resumeContext.webhookResponse && !resumeContext.agentContext) {
                 this.currentResponse = resumeContext.webhookResponse;
             }
-        // Agent webhook response is handled via agentContext (checked in executeAgent)
+            // Agent webhook response is handled via agentContext (checked in executeAgent)
+            // Restore page context if available (from a preceding UI step)
+            if (resumeContext.currentPage) {
+                this.currentPage = {
+                    url: resumeContext.currentPage.url,
+                    webhook: _object_spread_props(_object_spread({}, resumeContext.currentPage.webhook), {
+                        schema: z.record(z.unknown())
+                    })
+                };
+            }
         } else {
             var _initialParams_initialState;
             // Fresh start: use initialState or empty object
@@ -685,6 +631,12 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 ];
                             case 3:
                                 _state.sent();
+                                // Validate options after START so errors are visible in watch/history
+                                if (this.optionsSchema) {
+                                    this.options = this.optionsSchema.parse(this.options);
+                                } else if (this.options && Object.keys(this.options).length > 0) {
+                                    throw new Error("Brain '".concat(brainTitle, "' received options but no schema was defined. Use withOptionsSchema() to define a schema for options."));
+                                }
                                 return [
                                     3,
                                     11
@@ -956,7 +908,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 ];
                             case 29:
                                 _state.sent();
-                                // Backend requested a stop (e.g. batch chunk pause for DO restart)
+                                // Backend requested a stop (e.g. iterate item pause for DO restart)
                                 if (this.stopped) {
                                     return [
                                         2
@@ -1052,11 +1004,32 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                 }).call(this);
             }
         },
+        {
+            key: "buildStepContext",
+            value: function buildStepContext(step) {
+                var _this_options;
+                return _object_spread({
+                    state: this.currentState,
+                    options: (_this_options = this.options) !== null && _this_options !== void 0 ? _this_options : {},
+                    client: this.client,
+                    resources: this.resources,
+                    response: this.currentResponse,
+                    page: this.currentPage,
+                    pages: this.pages,
+                    env: this.env,
+                    memory: this.scopedMemory,
+                    store: this.store,
+                    currentUser: this.currentUser,
+                    brainRunId: this.brainRunId,
+                    stepId: step.id
+                }, this.services);
+            }
+        },
         {
             key: "executeStep",
             value: function executeStep(step) {
                 return _wrap_async_generator(function() {
-                    var block, stepBlock, _this_resumeContext, brainBlock, initialState, innerResumeContext, patches, innerBrainPaused, _this_options, _this_options1, innerRun, _iteratorAbruptCompletion, _didIteratorError, _iteratorError, _iterator, _step, _value, event, err, _innerResumeContext_state, baseState, innerState, prevState, _, prevState1, stepBlock1, stepClient, _this_options2, result;
+                    var block, stepBlock, _this_resumeContext, brainBlock, initialState, innerResumeContext, patches, innerBrainPaused, _this_options, _this_options1, innerRun, _iteratorAbruptCompletion, _didIteratorError, _iteratorError, _iterator, _step, _value, event, err, _innerResumeContext_state, baseState, innerState, prevState, _, agentBlock, prevState1, prevState2, stepBlock1, stepClient, _this_options2, result;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
@@ -1080,13 +1053,13 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                     2
                                 ];
                             case 2:
-                                if (!stepBlock.batchConfig) return [
+                                if (!stepBlock.iterateConfig) return [
                                     3,
                                     4
                                 ];
                                 return [
                                     5,
-                                    _ts_values(_async_generator_delegate(_async_iterator(this.executeBatchPrompt(step))))
+                                    _ts_values(_async_generator_delegate(_async_iterator(this.executeIteratePrompt(step))))
                                 ];
                             case 3:
                                 _state.sent();
@@ -1096,9 +1069,23 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                             case 4:
                                 if (!(block.type === 'brain')) return [
                                     3,
-                                    20
+                                    22
                                 ];
                                 brainBlock = block;
+                                if (!brainBlock.iterateConfig) return [
+                                    3,
+                                    6
+                                ];
+                                return [
+                                    5,
+                                    _ts_values(_async_generator_delegate(_async_iterator(this.executeIterateBrain(step))))
+                                ];
+                            case 5:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                            case 6:
                                 initialState = typeof brainBlock.initialState === 'function' ? brainBlock.initialState(this.currentState) : brainBlock.initialState;
                                 // Check if we're resuming and if there's an inner resume context
                                 innerResumeContext = (_this_resumeContext = this.resumeContext) === null || _this_resumeContext === void 0 ? void 0 : _this_resumeContext.innerResumeContext;
@@ -1128,25 +1115,25 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                     governor: this.governor
                                 });
                                 _iteratorAbruptCompletion = false, _didIteratorError = false;
-                                _state.label = 5;
-                            case 5:
+                                _state.label = 7;
+                            case 7:
                                 _state.trys.push([
-                                    5,
-                                    11,
-                                    12,
-                                    17
+                                    7,
+                                    13,
+                                    14,
+                                    19
                                 ]);
                                 _iterator = _async_iterator(innerRun);
-                                _state.label = 6;
-                            case 6:
+                                _state.label = 8;
+                            case 8:
                                 return [
                                     4,
                                     _await_async_generator(_iterator.next())
                                 ];
-                            case 7:
+                            case 9:
                                 if (!(_iteratorAbruptCompletion = !(_step = _state.sent()).done)) return [
                                     3,
-                                    10
+                                    12
                                 ];
                                 _value = _step.value;
                                 event = _value;
@@ -1154,7 +1141,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                     4,
                                     event
                                 ];
-                            case 8:
+                            case 10:
                                 _state.sent(); // Forward all inner brain events
                                 if (event.type === BRAIN_EVENTS.STEP_COMPLETE) {
                                     patches.push(event.patch);
@@ -1167,64 +1154,64 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 if (event.type === BRAIN_EVENTS.COMPLETE) {
                                     return [
                                         3,
-                                        10
+                                        12
                                     ];
                                 }
-                                _state.label = 9;
-                            case 9:
+                                _state.label = 11;
+                            case 11:
                                 _iteratorAbruptCompletion = false;
                                 return [
                                     3,
-                                    6
+                                    8
                                 ];
-                            case 10:
+                            case 12:
                                 return [
                                     3,
-                                    17
+                                    19
                                 ];
-                            case 11:
+                            case 13:
                                 err = _state.sent();
                                 _didIteratorError = true;
                                 _iteratorError = err;
                                 return [
                                     3,
-                                    17
+                                    19
                                 ];
-                            case 12:
+                            case 14:
                                 _state.trys.push([
-                                    12,
+                                    14,
                                     ,
-                                    15,
-                                    16
+                                    17,
+                                    18
                                 ]);
                                 if (!(_iteratorAbruptCompletion && _iterator.return != null)) return [
                                     3,
-                                    14
+                                    16
                                 ];
                                 return [
                                     4,
                                     _await_async_generator(_iterator.return())
                                 ];
-                            case 13:
+                            case 15:
                                 _state.sent();
-                                _state.label = 14;
-                            case 14:
+                                _state.label = 16;
+                            case 16:
                                 return [
                                     3,
-                                    16
+                                    18
                                 ];
-                            case 15:
+                            case 17:
                                 if (_didIteratorError) {
                                     throw _iteratorError;
                                 }
                                 return [
                                     7
                                 ];
-                            case 16:
+                            case 18:
                                 return [
                                     7
                                 ];
-                            case 17:
+                            case 19:
                                 // If inner brain paused for webhook, don't complete the outer brain step
                                 // The outer brain should also pause
                                 if (innerBrainPaused) {
@@ -1244,36 +1231,58 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                     4,
                                     _await_async_generator(brainBlock.action(this.currentState, innerState, this.services))
                                 ];
-                            case 18:
+                            case 20:
                                 _.currentState = _state.sent();
                                 return [
                                     5,
                                     _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState))))
                                 ];
-                            case 19:
+                            case 21:
                                 _state.sent();
                                 return [
                                     3,
-                                    25
+                                    30
                                 ];
-                            case 20:
+                            case 22:
                                 if (!(block.type === 'agent')) return [
                                     3,
-                                    22
+                                    27
+                                ];
+                                agentBlock = block;
+                                if (!agentBlock.iterateConfig) return [
+                                    3,
+                                    24
+                                ];
+                                return [
+                                    5,
+                                    _ts_values(_async_generator_delegate(_async_iterator(this.executeIterateAgent(step))))
+                                ];
+                            case 23:
+                                _state.sent();
+                                return [
+                                    2
                                 ];
+                            case 24:
+                                prevState1 = this.currentState;
                                 return [
                                     5,
                                     _ts_values(_async_generator_delegate(_async_iterator(this.executeAgent(step))))
                                 ];
-                            case 21:
+                            case 25:
+                                _state.sent();
+                                return [
+                                    5,
+                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState1))))
+                                ];
+                            case 26:
                                 _state.sent();
                                 return [
                                     3,
-                                    25
+                                    30
                                 ];
-                            case 22:
+                            case 27:
                                 // Get previous state before action
-                                prevState1 = this.currentState;
+                                prevState2 = this.currentState;
                                 stepBlock1 = block;
                                 // Resolve per-step client: if the step has an override, apply governor to it;
                                 // otherwise use the default (already-governed) client
@@ -1294,7 +1303,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         currentUser: this.currentUser
                                     }, this.services))))
                                 ];
-                            case 23:
+                            case 28:
                                 result = _state.sent();
                                 // Extract state from result (handles promptResponse case)
                                 if (result && (typeof result === "undefined" ? "undefined" : _type_of(result)) === 'object' && 'promptResponse' in result) {
@@ -1304,9 +1313,9 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 }
                                 return [
                                     5,
-                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState1))))
+                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState2))))
                                 ];
-                            case 24:
+                            case 29:
                                 _state.sent();
                                 // Handle promptResponse - set currentResponse for next step
                                 if (result && (typeof result === "undefined" ? "undefined" : _type_of(result)) === 'object' && 'promptResponse' in result) {
@@ -1314,8 +1323,8 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 }
                                 // Reset currentPage after step consumes it (page is ephemeral)
                                 this.currentPage = undefined;
-                                _state.label = 25;
-                            case 25:
+                                _state.label = 30;
+                            case 30:
                                 return [
                                     2
                                 ];
@@ -1328,21 +1337,21 @@ export var BrainEventStream = /*#__PURE__*/ function() {
             key: "executeAgent",
             value: function executeAgent(step) {
                 return _wrap_async_generator(function() {
-                    var _this_resumeContext, _this_resumeContext1, block, prevState, _this_defaultTools, defaultTools, _this_components, components, _this_options, config, _config_tools, mergedTools, _config_outputSchema, schema, name, responseMessages, initialMessages, agentContext, webhookResponse, _agentContext_stepId, effectiveStepId, _this_options1, _this_options2, userMessage, toolResultMessage, _this_options3, userMessage1, _config_prompt, prompt, _this_options4, totalTokens, iteration, _config_maxIterations, maxIterations, _response_responseMessages, signals, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, signal, userMessage2, _this_options5, err, _this_options6, toolsForClient, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, _step_value, name1, toolDef, tool, description, componentList, systemPrompt, response, newAssistantMessage, _this_options7, tokensThisIteration, _this_options8, _this_options9, _this_options10, pendingWebhook, _iteratorNormalCompletion2, _didIteratorError2, _iteratorError2, _iterator2, _step2, toolCall, _this_options11, tool1, _this_options12, _this_options13, toolContext, toolResult, waitForResult, webhooks, _this_options14, placeholderMessage, _this_options15, toolResultMessage1, _this_options16, err, _this_options17, _this_options18;
+                    var _this_resumeContext, _this_resumeContext1, block, prevState, _this_defaultTools, _this_extraTools, allTools, _this_components, components, _this_options, config, _config_tools, mergedTools, _config_outputSchema, schema, name, responseMessages, initialMessages, agentContext, webhookResponse, _agentContext_stepId, effectiveStepId, _this_options1, _this_options2, userMessage, toolResultMessage, _this_options3, userMessage1, _config_prompt, prompt, _this_options4, totalTokens, iteration, _config_maxIterations, maxIterations, _response_responseMessages, signals, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, signal, userMessage2, _this_options5, err, _this_options6, toolsForClient, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, _step_value, name1, toolDef, tool, description, componentList, systemPrompt, response, newAssistantMessage, _this_options7, tokensThisIteration, _this_options8, _this_options9, _this_options10, pendingWebhook, _iteratorNormalCompletion2, _didIteratorError2, _iteratorError2, _iterator2, _step2, toolCall, _this_options11, tool1, _this_options12, parsed, _this_options13, toolContext, toolResult, waitForResult, webhooks, _this_options14, placeholderMessage, _this_options15, toolResultMessage1, _this_options16, err, _this_options17, _this_options18;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
                                 block = step.block;
                                 prevState = this.currentState;
-                                // Get default tools and components for injection into configFn
-                                defaultTools = (_this_defaultTools = this.defaultTools) !== null && _this_defaultTools !== void 0 ? _this_defaultTools : {};
+                                // Combine default tools and extra tools for injection into configFn
+                                allTools = _object_spread({}, (_this_defaultTools = this.defaultTools) !== null && _this_defaultTools !== void 0 ? _this_defaultTools : {}, (_this_extraTools = this.extraTools) !== null && _this_extraTools !== void 0 ? _this_extraTools : {});
                                 components = (_this_components = this.components) !== null && _this_components !== void 0 ? _this_components : {};
                                 return [
                                     4,
                                     _await_async_generator(block.configFn(_object_spread({
                                         state: this.currentState,
                                         options: (_this_options = this.options) !== null && _this_options !== void 0 ? _this_options : {},
-                                        tools: defaultTools,
+                                        tools: allTools,
                                         components: components,
                                         client: this.client,
                                         resources: this.resources,
@@ -1359,8 +1368,8 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 config = _state.sent();
                                 // Reset currentPage after configFn consumes it (page is ephemeral)
                                 this.currentPage = undefined;
-                                // Merge tools: step tools override defaults
-                                mergedTools = _object_spread({}, defaultTools, (_config_tools = config.tools) !== null && _config_tools !== void 0 ? _config_tools : {});
+                                // Merge tools: step tools override defaults + extras
+                                mergedTools = _object_spread({}, allTools, (_config_tools = config.tools) !== null && _config_tools !== void 0 ? _config_tools : {});
                                 // Always generate a 'done' terminal tool for every agent
                                 // If outputSchema is provided, use that schema; otherwise use defaultDoneSchema
                                 if (config.outputSchema) {
@@ -1525,7 +1534,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                             case 12:
                                 if (!true) return [
                                     3,
-                                    60
+                                    55
                                 ];
                                 iteration++;
                                 if (!this.signalProvider) return [
@@ -1683,7 +1692,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                             case 26:
                                 if (!(iteration > maxIterations)) return [
                                     3,
-                                    29
+                                    28
                                 ];
                                 return [
                                     4,
@@ -1700,16 +1709,13 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 ];
                             case 27:
                                 _state.sent();
-                                return [
-                                    5,
-                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState))))
-                                ];
-                            case 28:
-                                _state.sent();
+                                if (config.outputSchema) {
+                                    throw new Error("Agent hit iteration limit (".concat(maxIterations, ") without producing required '").concat(config.outputSchema.name, "' output"));
+                                }
                                 return [
                                     2
                                 ];
-                            case 29:
+                            case 28:
                                 // Check if client supports generateText
                                 if (!this.client.generateText) {
                                     throw new Error('Client does not support generateText. Use a client that implements generateText for agent steps.');
@@ -1762,7 +1768,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         toolChoice: config.toolChoice
                                     }))
                                 ];
-                            case 30:
+                            case 29:
                                 response = _state.sent();
                                 // Update responseMessages for next iteration (preserves providerOptions)
                                 responseMessages = response.responseMessages;
@@ -1770,7 +1776,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 newAssistantMessage = (_response_responseMessages = response.responseMessages) === null || _response_responseMessages === void 0 ? void 0 : _response_responseMessages.at(-1);
                                 if (!newAssistantMessage) return [
                                     3,
-                                    32
+                                    31
                                 ];
                                 return [
                                     4,
@@ -1784,10 +1790,10 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 31:
+                            case 30:
                                 _state.sent();
-                                _state.label = 32;
-                            case 32:
+                                _state.label = 31;
+                            case 31:
                                 // Track tokens
                                 tokensThisIteration = response.usage.totalTokens;
                                 totalTokens += tokensThisIteration;
@@ -1805,11 +1811,11 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 33:
+                            case 32:
                                 _state.sent();
                                 if (!(config.maxTokens && totalTokens > config.maxTokens)) return [
                                     3,
-                                    36
+                                    34
                                 ];
                                 return [
                                     4,
@@ -1823,21 +1829,18 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 34:
-                                _state.sent();
-                                return [
-                                    5,
-                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState))))
-                                ];
-                            case 35:
+                            case 33:
                                 _state.sent();
+                                if (config.outputSchema) {
+                                    throw new Error("Agent hit token limit (".concat(config.maxTokens, ") without producing required '").concat(config.outputSchema.name, "' output"));
+                                }
                                 return [
                                     2
                                 ];
-                            case 36:
+                            case 34:
                                 if (!response.text) return [
                                     3,
-                                    38
+                                    36
                                 ];
                                 // Log assistant messages to console as fallback (users shouldn't rely on this)
                                 console.log("[Assistant] ".concat(response.text));
@@ -1852,42 +1855,34 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 37:
-                                _state.sent();
-                                _state.label = 38;
-                            case 38:
-                                if (!(!response.toolCalls || response.toolCalls.length === 0)) return [
-                                    3,
-                                    40
-                                ];
-                                return [
-                                    5,
-                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState))))
-                                ];
-                            case 39:
+                            case 35:
                                 _state.sent();
-                                return [
-                                    2
-                                ];
-                            case 40:
+                                _state.label = 36;
+                            case 36:
+                                // If no tool calls, agent is done
+                                if (!response.toolCalls || response.toolCalls.length === 0) {
+                                    return [
+                                        2
+                                    ];
+                                }
                                 // Track pending webhook if any tool returns waitFor
                                 // We process ALL tool calls first, then pause for webhook at the end
                                 pendingWebhook = null;
                                 _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
-                                _state.label = 41;
-                            case 41:
+                                _state.label = 37;
+                            case 37:
                                 _state.trys.push([
-                                    41,
-                                    54,
-                                    55,
-                                    56
+                                    37,
+                                    49,
+                                    50,
+                                    51
                                 ]);
                                 _iterator2 = response.toolCalls[Symbol.iterator]();
-                                _state.label = 42;
-                            case 42:
+                                _state.label = 38;
+                            case 38:
                                 if (!!(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done)) return [
                                     3,
-                                    53
+                                    48
                                 ];
                                 toolCall = _step2.value;
                                 return [
@@ -1903,7 +1898,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 43:
+                            case 39:
                                 _state.sent();
                                 tool1 = mergedTools[toolCall.toolName];
                                 if (!tool1) {
@@ -1911,7 +1906,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 }
                                 if (!tool1.terminal) return [
                                     3,
-                                    46
+                                    41
                                 ];
                                 return [
                                     4,
@@ -1927,30 +1922,28 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 44:
+                            case 40:
                                 _state.sent();
                                 // Merge terminal result into state
                                 // Only namespace under outputSchema.name when 'done' tool is called with outputSchema
                                 if (config.outputSchema && toolCall.toolName === 'done') {
+                                    parsed = config.outputSchema.schema.safeParse(toolCall.args);
+                                    if (!parsed.success) {
+                                        throw new Error("Agent output does not match outputSchema '".concat(config.outputSchema.name, "': ").concat(parsed.error.message));
+                                    }
                                     // Namespace result under outputSchema.name
-                                    this.currentState = _object_spread_props(_object_spread({}, this.currentState), _define_property({}, config.outputSchema.name, toolCall.args));
+                                    this.currentState = _object_spread_props(_object_spread({}, this.currentState), _define_property({}, config.outputSchema.name, parsed.data));
                                 } else {
                                     // Default behavior: spread into state root (for other terminal tools)
                                     this.currentState = _object_spread({}, this.currentState, toolCall.args);
                                 }
-                                return [
-                                    5,
-                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState))))
-                                ];
-                            case 45:
-                                _state.sent();
                                 return [
                                     2
                                 ];
-                            case 46:
+                            case 41:
                                 if (!tool1.execute) return [
                                     3,
-                                    52
+                                    47
                                 ];
                                 toolContext = {
                                     state: this.currentState,
@@ -1972,11 +1965,11 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                     4,
                                     _await_async_generator(tool1.execute(toolCall.args, toolContext))
                                 ];
-                            case 47:
+                            case 42:
                                 toolResult = _state.sent();
                                 if (!(toolResult && (typeof toolResult === "undefined" ? "undefined" : _type_of(toolResult)) === 'object' && 'waitFor' in toolResult)) return [
                                     3,
-                                    49
+                                    44
                                 ];
                                 waitForResult = toolResult;
                                 // Normalize waitFor to array (supports single or multiple webhooks)
@@ -2015,7 +2008,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 48:
+                            case 43:
                                 _state.sent();
                                 // Add placeholder to responseMessages locally so the conversation stays valid
                                 // for any subsequent generateText calls in this execution.
@@ -2033,9 +2026,9 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 // Continue processing other tool calls - don't return yet
                                 return [
                                     3,
-                                    52
+                                    47
                                 ];
-                            case 49:
+                            case 44:
                                 // Emit tool result event for debugging/visibility
                                 return [
                                     4,
@@ -2050,11 +2043,11 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 50:
+                            case 45:
                                 _state.sent();
                                 if (!(this.client.createToolResultMessage && responseMessages)) return [
                                     3,
-                                    52
+                                    47
                                 ];
                                 toolResultMessage1 = this.client.createToolResultMessage(toolCall.toolCallId, toolCall.toolName, toolResult);
                                 responseMessages = _to_consumable_array(responseMessages).concat([
@@ -2073,29 +2066,29 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 51:
+                            case 46:
                                 _state.sent();
-                                _state.label = 52;
-                            case 52:
+                                _state.label = 47;
+                            case 47:
                                 _iteratorNormalCompletion2 = true;
                                 return [
                                     3,
-                                    42
+                                    38
                                 ];
-                            case 53:
+                            case 48:
                                 return [
                                     3,
-                                    56
+                                    51
                                 ];
-                            case 54:
+                            case 49:
                                 err = _state.sent();
                                 _didIteratorError2 = true;
                                 _iteratorError2 = err;
                                 return [
                                     3,
-                                    56
+                                    51
                                 ];
-                            case 55:
+                            case 50:
                                 try {
                                     if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
                                         _iterator2.return();
@@ -2108,10 +2101,10 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 return [
                                     7
                                 ];
-                            case 56:
+                            case 51:
                                 if (!pendingWebhook) return [
                                     3,
-                                    59
+                                    54
                                 ];
                                 // Emit AGENT_WEBHOOK event
                                 return [
@@ -2127,7 +2120,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     }
                                 ];
-                            case 57:
+                            case 52:
                                 _state.sent();
                                 // Emit WEBHOOK event with all webhooks (first response wins)
                                 return [
@@ -2142,17 +2135,17 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         brainRunId: this.brainRunId
                                     })
                                 ];
-                            case 58:
+                            case 53:
                                 _state.sent();
                                 return [
                                     2
                                 ];
-                            case 59:
+                            case 54:
                                 return [
                                     3,
                                     12
                                 ];
-                            case 60:
+                            case 55:
                                 return [
                                     2
                                 ];
@@ -2162,73 +2155,83 @@ export var BrainEventStream = /*#__PURE__*/ function() {
             }
         },
         {
-            key: "executeBatchPrompt",
+            key: "executeIteratePrompt",
             value: /**
-   * Execute a batch prompt step in chunks, yielding one BATCH_CHUNK_COMPLETE
-   * event per chunk. Between chunks, checks for PAUSE/KILL signals so
+   * Execute an iterate prompt step, yielding one ITERATE_ITEM_COMPLETE
+   * event per item. Between items, checks for PAUSE/KILL signals so
    * Cloudflare backends can restart the DO to reclaim memory.
-   */ function executeBatchPrompt(step) {
+   */ function executeIteratePrompt(step) {
                 return _wrap_async_generator(function() {
-                    var _this, _this_resumeContext, block, batchConfig, prevState, rawClient, client, items, totalItems, _batchConfig_concurrency, concurrency, semaphore, batchProgress, _batchProgress_processedCount, startIndex, results, chunkStart, signals, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, signal, _this_options, err, chunkEnd, chunk, chunkResults, i, _this_options1, finalResults;
+                    var _this_resumeContext, block, iterateConfig, prevState, rawClient, client, items, totalItems, iterateProgress, _iterateProgress_processedCount, startIndex, resultsMap, k, r, i, signals, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, signal, _this_options, err, item, result, _this_options1, promptText, response, error, fallback, _this_options2, finalResults;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
-                                _this = this;
                                 block = step.block;
-                                batchConfig = block.batchConfig;
+                                iterateConfig = block.iterateConfig;
                                 prevState = this.currentState;
-                                rawClient = batchConfig.client;
+                                rawClient = iterateConfig.client;
                                 client = rawClient ? this.governor ? this.governor(rawClient) : rawClient : this.client;
-                                items = batchConfig.over(this.currentState);
+                                return [
+                                    4,
+                                    _await_async_generator(iterateConfig.over(this.buildStepContext(step)))
+                                ];
+                            case 1:
+                                items = _state.sent();
                                 totalItems = items.length;
-                                concurrency = (_batchConfig_concurrency = batchConfig.concurrency) !== null && _batchConfig_concurrency !== void 0 ? _batchConfig_concurrency : 10;
-                                semaphore = createSemaphore(concurrency);
                                 // Resume support: pick up from where we left off
-                                batchProgress = (_this_resumeContext = this.resumeContext) === null || _this_resumeContext === void 0 ? void 0 : _this_resumeContext.batchProgress;
-                                startIndex = (_batchProgress_processedCount = batchProgress === null || batchProgress === void 0 ? void 0 : batchProgress.processedCount) !== null && _batchProgress_processedCount !== void 0 ? _batchProgress_processedCount : 0;
-                                results = (batchProgress === null || batchProgress === void 0 ? void 0 : batchProgress.accumulatedResults) ? _to_consumable_array(batchProgress.accumulatedResults) : new Array(totalItems);
-                                // Clear resumeContext after consuming batchProgress
-                                if (batchProgress) {
+                                iterateProgress = (_this_resumeContext = this.resumeContext) === null || _this_resumeContext === void 0 ? void 0 : _this_resumeContext.iterateProgress;
+                                startIndex = (_iterateProgress_processedCount = iterateProgress === null || iterateProgress === void 0 ? void 0 : iterateProgress.processedCount) !== null && _iterateProgress_processedCount !== void 0 ? _iterateProgress_processedCount : 0;
+                                // Use a Map for results accumulation during iteration.
+                                resultsMap = new Map();
+                                if (iterateProgress === null || iterateProgress === void 0 ? void 0 : iterateProgress.accumulatedResults) {
+                                    for(k = 0; k < iterateProgress.accumulatedResults.length; k++){
+                                        r = iterateProgress.accumulatedResults[k];
+                                        if (r != null) resultsMap.set(k, r);
+                                    }
+                                }
+                                // Clear resumeContext after consuming iterateProgress
+                                if (iterateProgress) {
                                     this.resumeContext = undefined;
                                 }
-                                chunkStart = startIndex;
-                                _state.label = 1;
-                            case 1:
-                                if (!(chunkStart < totalItems)) return [
+                                i = startIndex;
+                                _state.label = 2;
+                            case 2:
+                                if (!(i < totalItems)) return [
                                     3,
-                                    15
+                                    20
                                 ];
                                 if (!this.signalProvider) return [
                                     3,
-                                    11
+                                    12
                                 ];
                                 return [
                                     4,
                                     _await_async_generator(this.signalProvider.getSignals('CONTROL'))
                                 ];
-                            case 2:
+                            case 3:
                                 signals = _state.sent();
                                 _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-                                _state.label = 3;
-                            case 3:
+                                _state.label = 4;
+                            case 4:
                                 _state.trys.push([
-                                    3,
-                                    9,
+                                    4,
                                     10,
-                                    11
+                                    11,
+                                    12
                                 ]);
                                 _iterator = signals[Symbol.iterator]();
-                                _state.label = 4;
-                            case 4:
+                                _state.label = 5;
+                            case 5:
                                 if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
                                     3,
-                                    8
+                                    9
                                 ];
                                 signal = _step.value;
                                 if (!(signal.type === 'KILL')) return [
                                     3,
-                                    6
+                                    7
                                 ];
+                                this.stopped = true;
                                 return [
                                     4,
                                     {
@@ -2240,14 +2243,14 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         options: (_this_options = this.options) !== null && _this_options !== void 0 ? _this_options : {}
                                     }
                                 ];
-                            case 5:
+                            case 6:
                                 _state.sent();
                                 return [
                                     2
                                 ];
-                            case 6:
+                            case 7:
                                 if (signal.type === 'PAUSE') {
-                                    // Don't yield PAUSED - pausing between batch chunks is a backend
+                                    // Don't yield PAUSED - pausing between iterate items is a backend
                                     // implementation detail (e.g. Cloudflare DO restart for memory).
                                     // Just stop execution silently; the backend handles resume.
                                     this.stopped = true;
@@ -2255,27 +2258,27 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                         2
                                     ];
                                 }
-                                _state.label = 7;
-                            case 7:
+                                _state.label = 8;
+                            case 8:
                                 _iteratorNormalCompletion = true;
                                 return [
                                     3,
-                                    4
+                                    5
                                 ];
-                            case 8:
+                            case 9:
                                 return [
                                     3,
-                                    11
+                                    12
                                 ];
-                            case 9:
+                            case 10:
                                 err = _state.sent();
                                 _didIteratorError = true;
                                 _iteratorError = err;
                                 return [
                                     3,
-                                    11
+                                    12
                                 ];
-                            case 10:
+                            case 11:
                                 try {
                                     if (!_iteratorNormalCompletion && _iterator.return != null) {
                                         _iterator.return();
@@ -2288,123 +2291,685 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 return [
                                     7
                                 ];
-                            case 11:
-                                chunkEnd = Math.min(chunkStart + concurrency, totalItems);
-                                chunk = items.slice(chunkStart, chunkEnd);
-                                return [
-                                    4,
-                                    _await_async_generator(Promise.all(chunk.map(function(item) {
-                                        return _async_to_generator(function() {
-                                            var release, promptText, result, error, fallback;
-                                            return _ts_generator(this, function(_state) {
-                                                switch(_state.label){
-                                                    case 0:
-                                                        return [
-                                                            4,
-                                                            semaphore.acquire()
-                                                        ];
-                                                    case 1:
-                                                        release = _state.sent();
-                                                        _state.label = 2;
-                                                    case 2:
-                                                        _state.trys.push([
-                                                            2,
-                                                            5,
-                                                            6,
-                                                            7
-                                                        ]);
-                                                        return [
-                                                            4,
-                                                            batchConfig.template(item, this.resources)
-                                                        ];
-                                                    case 3:
-                                                        promptText = _state.sent();
-                                                        return [
-                                                            4,
-                                                            client.generateObject({
-                                                                schema: batchConfig.schema,
-                                                                schemaName: batchConfig.schemaName,
-                                                                prompt: promptText
-                                                            })
-                                                        ];
-                                                    case 4:
-                                                        result = _state.sent();
-                                                        return [
-                                                            2,
-                                                            [
-                                                                item,
-                                                                result.object
-                                                            ]
-                                                        ];
-                                                    case 5:
-                                                        error = _state.sent();
-                                                        if (batchConfig.error) {
-                                                            fallback = batchConfig.error(item, error);
-                                                            return [
-                                                                2,
-                                                                fallback !== null ? [
-                                                                    item,
-                                                                    fallback
-                                                                ] : undefined
-                                                            ];
-                                                        }
-                                                        throw error;
-                                                    case 6:
-                                                        release();
-                                                        return [
-                                                            7
-                                                        ];
-                                                    case 7:
-                                                        return [
-                                                            2
-                                                        ];
-                                                }
-                                            });
-                                        }).call(_this);
-                                    })))
-                                ];
                             case 12:
-                                chunkResults = _state.sent();
-                                // Store chunk results at correct indices
-                                for(i = 0; i < chunkResults.length; i++){
-                                    results[chunkStart + i] = chunkResults[i];
+                                item = items[i];
+                                result = void 0;
+                                _state.label = 13;
+                            case 13:
+                                _state.trys.push([
+                                    13,
+                                    16,
+                                    ,
+                                    17
+                                ]);
+                                return [
+                                    4,
+                                    _await_async_generator(iterateConfig.template({
+                                        item: item,
+                                        state: this.currentState,
+                                        options: (_this_options1 = this.options) !== null && _this_options1 !== void 0 ? _this_options1 : {},
+                                        resources: this.resources
+                                    }))
+                                ];
+                            case 14:
+                                promptText = _state.sent();
+                                return [
+                                    4,
+                                    _await_async_generator(client.generateObject({
+                                        schema: iterateConfig.schema,
+                                        schemaName: iterateConfig.schemaName,
+                                        prompt: promptText
+                                    }))
+                                ];
+                            case 15:
+                                response = _state.sent();
+                                result = [
+                                    item,
+                                    response.object
+                                ];
+                                return [
+                                    3,
+                                    17
+                                ];
+                            case 16:
+                                error = _state.sent();
+                                if (iterateConfig.error) {
+                                    fallback = iterateConfig.error(item, error);
+                                    result = fallback !== null ? [
+                                        item,
+                                        fallback
+                                    ] : undefined;
+                                } else {
+                                    throw error;
+                                }
+                                return [
+                                    3,
+                                    17
+                                ];
+                            case 17:
+                                if (result != null) {
+                                    resultsMap.set(i, result);
                                 }
-                                // Yield ONE event per chunk
+                                // Yield one event per item
                                 return [
                                     4,
                                     {
-                                        type: BRAIN_EVENTS.BATCH_CHUNK_COMPLETE,
+                                        type: BRAIN_EVENTS.ITERATE_ITEM_COMPLETE,
                                         stepTitle: step.block.title,
                                         stepId: step.id,
-                                        chunkStartIndex: chunkStart,
-                                        processedCount: chunkEnd,
+                                        itemIndex: i,
+                                        item: item,
+                                        result: result ? result[1] : undefined,
+                                        processedCount: i + 1,
                                         totalItems: totalItems,
-                                        chunkResults: chunkResults,
-                                        schemaName: batchConfig.schemaName,
-                                        options: (_this_options1 = this.options) !== null && _this_options1 !== void 0 ? _this_options1 : {},
-                                        brainRunId: this.brainRunId
+                                        schemaName: iterateConfig.schemaName,
+                                        options: (_this_options2 = this.options) !== null && _this_options2 !== void 0 ? _this_options2 : {},
+                                        brainRunId: this.brainRunId,
+                                        canRelease: !!this.signalProvider
                                     }
                                 ];
-                            case 13:
+                            case 18:
+                                _state.sent();
+                                _state.label = 19;
+                            case 19:
+                                i++;
+                                return [
+                                    3,
+                                    2
+                                ];
+                            case 20:
+                                // All items done - update state and complete step
+                                finalResults = new IterateResult(_to_consumable_array(resultsMap.values()));
+                                this.currentState = _object_spread_props(_object_spread({}, this.currentState), _define_property({}, iterateConfig.schemaName, finalResults));
+                                return [
+                                    5,
+                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState))))
+                                ];
+                            case 21:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "executeIterateBrain",
+            value: /**
+   * Execute a nested brain iterate step. Runs the inner brain once per item
+   * from the `over` list, collects [item, innerState] tuples under `outputKey`.
+   */ function executeIterateBrain(step) {
+                return _wrap_async_generator(function() {
+                    var _this_resumeContext, block, iterateConfig, prevState, items, totalItems, iterateProgress, _iterateProgress_processedCount, startIndex, resultsMap, k, r, i, signals, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, signal, _this_options, err, item, result, initialState, _this_options1, innerRun, patches, _iteratorAbruptCompletion, _didIteratorError1, _iteratorError1, _iterator1, _step1, _value, event, err1, innerState, error, fallback, _this_options2, finalResults, outputResults;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                block = step.block;
+                                iterateConfig = block.iterateConfig;
+                                prevState = this.currentState;
+                                return [
+                                    4,
+                                    _await_async_generator(iterateConfig.over(this.buildStepContext(step)))
+                                ];
+                            case 1:
+                                items = _state.sent();
+                                totalItems = items.length;
+                                // Resume support
+                                iterateProgress = (_this_resumeContext = this.resumeContext) === null || _this_resumeContext === void 0 ? void 0 : _this_resumeContext.iterateProgress;
+                                startIndex = (_iterateProgress_processedCount = iterateProgress === null || iterateProgress === void 0 ? void 0 : iterateProgress.processedCount) !== null && _iterateProgress_processedCount !== void 0 ? _iterateProgress_processedCount : 0;
+                                // Use a Map for results accumulation during iteration.
+                                resultsMap = new Map();
+                                if (iterateProgress === null || iterateProgress === void 0 ? void 0 : iterateProgress.accumulatedResults) {
+                                    for(k = 0; k < iterateProgress.accumulatedResults.length; k++){
+                                        r = iterateProgress.accumulatedResults[k];
+                                        if (r != null) resultsMap.set(k, r);
+                                    }
+                                }
+                                if (iterateProgress) {
+                                    this.resumeContext = undefined;
+                                }
+                                i = startIndex;
+                                _state.label = 2;
+                            case 2:
+                                if (!(i < totalItems)) return [
+                                    3,
+                                    31
+                                ];
+                                if (!this.signalProvider) return [
+                                    3,
+                                    12
+                                ];
+                                return [
+                                    4,
+                                    _await_async_generator(this.signalProvider.getSignals('CONTROL'))
+                                ];
+                            case 3:
+                                signals = _state.sent();
+                                _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                                _state.label = 4;
+                            case 4:
+                                _state.trys.push([
+                                    4,
+                                    10,
+                                    11,
+                                    12
+                                ]);
+                                _iterator = signals[Symbol.iterator]();
+                                _state.label = 5;
+                            case 5:
+                                if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
+                                    3,
+                                    9
+                                ];
+                                signal = _step.value;
+                                if (!(signal.type === 'KILL')) return [
+                                    3,
+                                    7
+                                ];
+                                this.stopped = true;
+                                return [
+                                    4,
+                                    {
+                                        type: BRAIN_EVENTS.CANCELLED,
+                                        status: STATUS.CANCELLED,
+                                        brainTitle: this.title,
+                                        brainDescription: this.description,
+                                        brainRunId: this.brainRunId,
+                                        options: (_this_options = this.options) !== null && _this_options !== void 0 ? _this_options : {}
+                                    }
+                                ];
+                            case 6:
                                 _state.sent();
+                                return [
+                                    2
+                                ];
+                            case 7:
+                                if (signal.type === 'PAUSE') {
+                                    this.stopped = true;
+                                    return [
+                                        2
+                                    ];
+                                }
+                                _state.label = 8;
+                            case 8:
+                                _iteratorNormalCompletion = true;
+                                return [
+                                    3,
+                                    5
+                                ];
+                            case 9:
+                                return [
+                                    3,
+                                    12
+                                ];
+                            case 10:
+                                err = _state.sent();
+                                _didIteratorError = true;
+                                _iteratorError = err;
+                                return [
+                                    3,
+                                    12
+                                ];
+                            case 11:
+                                try {
+                                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                        _iterator.return();
+                                    }
+                                } finally{
+                                    if (_didIteratorError) {
+                                        throw _iteratorError;
+                                    }
+                                }
+                                return [
+                                    7
+                                ];
+                            case 12:
+                                item = items[i];
+                                result = void 0;
+                                _state.label = 13;
+                            case 13:
+                                _state.trys.push([
+                                    13,
+                                    27,
+                                    ,
+                                    28
+                                ]);
+                                initialState = iterateConfig.initialState(item, this.currentState);
+                                innerRun = block.innerBrain.run({
+                                    resources: this.resources,
+                                    client: this.client,
+                                    currentUser: this.currentUser,
+                                    initialState: initialState,
+                                    options: (_this_options1 = this.options) !== null && _this_options1 !== void 0 ? _this_options1 : {},
+                                    pages: this.pages,
+                                    env: this.env,
+                                    brainRunId: this.brainRunId,
+                                    governor: this.governor
+                                });
+                                patches = [];
+                                _iteratorAbruptCompletion = false, _didIteratorError1 = false;
                                 _state.label = 14;
                             case 14:
-                                chunkStart += concurrency;
+                                _state.trys.push([
+                                    14,
+                                    20,
+                                    21,
+                                    26
+                                ]);
+                                _iterator1 = _async_iterator(innerRun);
+                                _state.label = 15;
+                            case 15:
                                 return [
+                                    4,
+                                    _await_async_generator(_iterator1.next())
+                                ];
+                            case 16:
+                                if (!(_iteratorAbruptCompletion = !(_step1 = _state.sent()).done)) return [
                                     3,
-                                    1
+                                    19
+                                ];
+                                _value = _step1.value;
+                                event = _value;
+                                // Throw on WEBHOOK — not supported in iterate (Phase 2)
+                                if (event.type === BRAIN_EVENTS.WEBHOOK) {
+                                    throw new Error("Webhook/wait inside brain iterate is not supported. " + 'Step "'.concat(block.title, '" item ').concat(i, " triggered a webhook. ") + "Remove .wait() from the inner brain or process items outside of iterate.");
+                                }
+                                return [
+                                    4,
+                                    event
+                                ];
+                            case 17:
+                                _state.sent(); // Forward all inner events
+                                if (event.type === BRAIN_EVENTS.STEP_COMPLETE) {
+                                    patches.push(event.patch);
+                                }
+                                if (event.type === BRAIN_EVENTS.COMPLETE) {
+                                    return [
+                                        3,
+                                        19
+                                    ];
+                                }
+                                _state.label = 18;
+                            case 18:
+                                _iteratorAbruptCompletion = false;
+                                return [
+                                    3,
+                                    15
+                                ];
+                            case 19:
+                                return [
+                                    3,
+                                    26
+                                ];
+                            case 20:
+                                err1 = _state.sent();
+                                _didIteratorError1 = true;
+                                _iteratorError1 = err1;
+                                return [
+                                    3,
+                                    26
+                                ];
+                            case 21:
+                                _state.trys.push([
+                                    21,
+                                    ,
+                                    24,
+                                    25
+                                ]);
+                                if (!(_iteratorAbruptCompletion && _iterator1.return != null)) return [
+                                    3,
+                                    23
+                                ];
+                                return [
+                                    4,
+                                    _await_async_generator(_iterator1.return())
+                                ];
+                            case 22:
+                                _state.sent();
+                                _state.label = 23;
+                            case 23:
+                                return [
+                                    3,
+                                    25
+                                ];
+                            case 24:
+                                if (_didIteratorError1) {
+                                    throw _iteratorError1;
+                                }
+                                return [
+                                    7
+                                ];
+                            case 25:
+                                return [
+                                    7
+                                ];
+                            case 26:
+                                innerState = applyPatches(initialState, patches);
+                                result = [
+                                    item,
+                                    innerState
                                 ];
-                            case 15:
-                                // All chunks done - update state and complete step
-                                finalResults = results.filter(function(r) {
-                                    return r != null;
-                                });
-                                this.currentState = _object_spread_props(_object_spread({}, this.currentState), _define_property({}, batchConfig.schemaName, finalResults));
+                                return [
+                                    3,
+                                    28
+                                ];
+                            case 27:
+                                error = _state.sent();
+                                if (iterateConfig.error) {
+                                    fallback = iterateConfig.error(item, error);
+                                    result = fallback !== null ? [
+                                        item,
+                                        fallback
+                                    ] : undefined;
+                                } else {
+                                    throw error;
+                                }
+                                return [
+                                    3,
+                                    28
+                                ];
+                            case 28:
+                                if (result != null) {
+                                    resultsMap.set(i, result);
+                                }
+                                return [
+                                    4,
+                                    {
+                                        type: BRAIN_EVENTS.ITERATE_ITEM_COMPLETE,
+                                        stepTitle: step.block.title,
+                                        stepId: step.id,
+                                        itemIndex: i,
+                                        item: item,
+                                        result: result ? result[1] : undefined,
+                                        processedCount: i + 1,
+                                        totalItems: totalItems,
+                                        schemaName: iterateConfig.outputKey,
+                                        options: (_this_options2 = this.options) !== null && _this_options2 !== void 0 ? _this_options2 : {},
+                                        brainRunId: this.brainRunId,
+                                        canRelease: !!this.signalProvider
+                                    }
+                                ];
+                            case 29:
+                                _state.sent();
+                                _state.label = 30;
+                            case 30:
+                                i++;
+                                return [
+                                    3,
+                                    2
+                                ];
+                            case 31:
+                                finalResults = _to_consumable_array(resultsMap.values());
+                                outputResults = new IterateResult(finalResults);
+                                this.currentState = _object_spread_props(_object_spread({}, this.currentState), _define_property({}, iterateConfig.outputKey, outputResults));
                                 return [
                                     5,
                                     _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState))))
                                 ];
-                            case 16:
+                            case 32:
+                                _state.sent();
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "executeIterateAgent",
+            value: /**
+   * Execute an agent config iterate step. Runs the agent once per item
+   * from the `over` list, collects [item, agentResult] tuples under `outputKey`.
+   */ function executeIterateAgent(step) {
+                return _wrap_async_generator(function() {
+                    var _this, _loop, _this_resumeContext, block, iterateConfig, prevState, items, totalItems, iterateProgress, _iterateProgress_processedCount, startIndex, resultsMap, k, r, i, _ret, finalResults;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                _loop = function(i) {
+                                    var signals, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, signal, _this_options, err, item, result, savedState, itemConfigFn, tempBlock, tempStep, agentResult, error, fallback, _this_options1;
+                                    return _ts_generator(this, function(_state) {
+                                        switch(_state.label){
+                                            case 0:
+                                                if (!_this.signalProvider) return [
+                                                    3,
+                                                    10
+                                                ];
+                                                return [
+                                                    4,
+                                                    _await_async_generator(_this.signalProvider.getSignals('CONTROL'))
+                                                ];
+                                            case 1:
+                                                signals = _state.sent();
+                                                _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                                                _state.label = 2;
+                                            case 2:
+                                                _state.trys.push([
+                                                    2,
+                                                    8,
+                                                    9,
+                                                    10
+                                                ]);
+                                                _iterator = signals[Symbol.iterator]();
+                                                _state.label = 3;
+                                            case 3:
+                                                if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
+                                                    3,
+                                                    7
+                                                ];
+                                                signal = _step.value;
+                                                if (!(signal.type === 'KILL')) return [
+                                                    3,
+                                                    5
+                                                ];
+                                                _this.stopped = true;
+                                                return [
+                                                    4,
+                                                    {
+                                                        type: BRAIN_EVENTS.CANCELLED,
+                                                        status: STATUS.CANCELLED,
+                                                        brainTitle: _this.title,
+                                                        brainDescription: _this.description,
+                                                        brainRunId: _this.brainRunId,
+                                                        options: (_this_options = _this.options) !== null && _this_options !== void 0 ? _this_options : {}
+                                                    }
+                                                ];
+                                            case 4:
+                                                _state.sent();
+                                                return [
+                                                    2,
+                                                    {
+                                                        v: void void 0
+                                                    }
+                                                ];
+                                            case 5:
+                                                if (signal.type === 'PAUSE') {
+                                                    _this.stopped = true;
+                                                    return [
+                                                        2,
+                                                        {
+                                                            v: void void 0
+                                                        }
+                                                    ];
+                                                }
+                                                _state.label = 6;
+                                            case 6:
+                                                _iteratorNormalCompletion = true;
+                                                return [
+                                                    3,
+                                                    3
+                                                ];
+                                            case 7:
+                                                return [
+                                                    3,
+                                                    10
+                                                ];
+                                            case 8:
+                                                err = _state.sent();
+                                                _didIteratorError = true;
+                                                _iteratorError = err;
+                                                return [
+                                                    3,
+                                                    10
+                                                ];
+                                            case 9:
+                                                try {
+                                                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                                        _iterator.return();
+                                                    }
+                                                } finally{
+                                                    if (_didIteratorError) {
+                                                        throw _iteratorError;
+                                                    }
+                                                }
+                                                return [
+                                                    7
+                                                ];
+                                            case 10:
+                                                item = items[i];
+                                                result = void 0;
+                                                _state.label = 11;
+                                            case 11:
+                                                _state.trys.push([
+                                                    11,
+                                                    13,
+                                                    ,
+                                                    14
+                                                ]);
+                                                // Save outer state; agent will modify this.currentState
+                                                savedState = _this.currentState;
+                                                // Create a wrapper configFn that injects the item as the first argument
+                                                itemConfigFn = function(params) {
+                                                    return block.configFn(item, params);
+                                                };
+                                                // Create a temporary agent block with the per-item configFn
+                                                tempBlock = {
+                                                    type: 'agent',
+                                                    title: block.title,
+                                                    configFn: itemConfigFn
+                                                };
+                                                tempStep = new Step(tempBlock);
+                                                return [
+                                                    5,
+                                                    _ts_values(_async_generator_delegate(_async_iterator(_this.executeAgent(tempStep))))
+                                                ];
+                                            case 12:
+                                                _state.sent();
+                                                // Capture agent result from this.currentState, then restore outer state
+                                                agentResult = _this.currentState;
+                                                _this.currentState = savedState;
+                                                result = [
+                                                    item,
+                                                    agentResult
+                                                ];
+                                                return [
+                                                    3,
+                                                    14
+                                                ];
+                                            case 13:
+                                                error = _state.sent();
+                                                if (iterateConfig.error) {
+                                                    fallback = iterateConfig.error(item, error);
+                                                    result = fallback !== null ? [
+                                                        item,
+                                                        fallback
+                                                    ] : undefined;
+                                                } else {
+                                                    throw error;
+                                                }
+                                                return [
+                                                    3,
+                                                    14
+                                                ];
+                                            case 14:
+                                                if (result != null) {
+                                                    resultsMap.set(i, result);
+                                                }
+                                                return [
+                                                    4,
+                                                    {
+                                                        type: BRAIN_EVENTS.ITERATE_ITEM_COMPLETE,
+                                                        stepTitle: step.block.title,
+                                                        stepId: step.id,
+                                                        itemIndex: i,
+                                                        item: item,
+                                                        result: result ? result[1] : undefined,
+                                                        processedCount: i + 1,
+                                                        totalItems: totalItems,
+                                                        schemaName: iterateConfig.outputKey,
+                                                        options: (_this_options1 = _this.options) !== null && _this_options1 !== void 0 ? _this_options1 : {},
+                                                        brainRunId: _this.brainRunId,
+                                                        canRelease: !!_this.signalProvider
+                                                    }
+                                                ];
+                                            case 15:
+                                                _state.sent();
+                                                return [
+                                                    2
+                                                ];
+                                        }
+                                    });
+                                };
+                                block = step.block;
+                                iterateConfig = block.iterateConfig;
+                                prevState = this.currentState;
+                                return [
+                                    4,
+                                    _await_async_generator(iterateConfig.over(this.buildStepContext(step)))
+                                ];
+                            case 1:
+                                items = _state.sent();
+                                totalItems = items.length;
+                                // Resume support
+                                iterateProgress = (_this_resumeContext = this.resumeContext) === null || _this_resumeContext === void 0 ? void 0 : _this_resumeContext.iterateProgress;
+                                startIndex = (_iterateProgress_processedCount = iterateProgress === null || iterateProgress === void 0 ? void 0 : iterateProgress.processedCount) !== null && _iterateProgress_processedCount !== void 0 ? _iterateProgress_processedCount : 0;
+                                // Use a Map for results accumulation during iteration.
+                                resultsMap = new Map();
+                                if (iterateProgress === null || iterateProgress === void 0 ? void 0 : iterateProgress.accumulatedResults) {
+                                    for(k = 0; k < iterateProgress.accumulatedResults.length; k++){
+                                        r = iterateProgress.accumulatedResults[k];
+                                        if (r != null) resultsMap.set(k, r);
+                                    }
+                                }
+                                if (iterateProgress) {
+                                    this.resumeContext = undefined;
+                                }
+                                i = startIndex;
+                                _state.label = 2;
+                            case 2:
+                                if (!(i < totalItems)) return [
+                                    3,
+                                    5
+                                ];
+                                _this = this;
+                                return [
+                                    5,
+                                    _ts_values(_loop(i))
+                                ];
+                            case 3:
+                                _ret = _state.sent();
+                                if (_type_of(_ret) === "object") return [
+                                    2,
+                                    _ret.v
+                                ];
+                                _state.label = 4;
+                            case 4:
+                                i++;
+                                return [
+                                    3,
+                                    2
+                                ];
+                            case 5:
+                                finalResults = new IterateResult(_to_consumable_array(resultsMap.values()));
+                                this.currentState = _object_spread_props(_object_spread({}, this.currentState), _define_property({}, iterateConfig.outputKey, finalResults));
+                                return [
+                                    5,
+                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState))))
+                                ];
+                            case 6:
                                 _state.sent();
                                 return [
                                     2
@@ -2421,7 +2986,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
    * Generates UI components, renders to HTML, creates page, and sets up webhook.
    */ function executeUIStep(step, stepBlock) {
                 return _wrap_async_generator(function() {
-                    var prevState, uiConfig, prompt, uiResult, placementCount, placementInfo, _uiResult_text, webhookIdentifier, formToken, formAction, html, page, _uiConfig_responseSchema, webhook;
+                    var prevState, uiConfig, _this_options, prompt, uiResult, placementCount, placementInfo, _uiResult_text, webhookIdentifier, formToken, formAction, html, page, _uiConfig_responseSchema, webhook;
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
@@ -2436,7 +3001,11 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 uiConfig = stepBlock.uiConfig;
                                 return [
                                     4,
-                                    _await_async_generator(uiConfig.template(this.currentState, this.resources))
+                                    _await_async_generator(uiConfig.template({
+                                        state: this.currentState,
+                                        options: (_this_options = this.options) !== null && _this_options !== void 0 ? _this_options : {},
+                                        resources: this.resources
+                                    }))
                                 ];
                             case 1:
                                 prompt = _state.sent();
@@ -2504,7 +3073,14 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                                 // The next step will receive the page object and can use waitFor
                                 return [
                                     5,
-                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState))))
+                                    _ts_values(_async_generator_delegate(_async_iterator(this.completeStep(step, prevState, {
+                                        url: page.url,
+                                        webhook: {
+                                            slug: webhook.slug,
+                                            identifier: webhook.identifier,
+                                            token: webhook.token
+                                        }
+                                    }))))
                                 ];
                             case 4:
                                 _state.sent();
@@ -2761,7 +3337,7 @@ export var BrainEventStream = /*#__PURE__*/ function() {
         },
         {
             key: "completeStep",
-            value: function completeStep(step, prevState) {
+            value: function completeStep(step, prevState, pageContext) {
                 var patch, _this_options;
                 return _ts_generator(this, function(_state) {
                     switch(_state.label){
@@ -2772,15 +3348,18 @@ export var BrainEventStream = /*#__PURE__*/ function() {
                             step.withPatch(patch);
                             return [
                                 4,
-                                {
+                                _object_spread_props(_object_spread({
                                     type: BRAIN_EVENTS.STEP_COMPLETE,
                                     status: STATUS.RUNNING,
                                     stepTitle: step.block.title,
                                     stepId: step.id,
-                                    patch: patch,
+                                    patch: patch
+                                }, pageContext && {
+                                    pageContext: pageContext
+                                }), {
                                     options: (_this_options = this.options) !== null && _this_options !== void 0 ? _this_options : {},
                                     brainRunId: this.brainRunId
-                                }
+                                })
                             ];
                         case 1:
                             _state.sent();