@positronic/core 0.0.52 → 0.0.53

package/dist/src/yaml/schema-extractor.js

@@ -0,0 +1,330 @@
+/**
+ * Schema extractor for YAML templates.
+ *
+ * Extracts the form schema that will be produced by the template's form fields.
+ * Also validates extracted schema against expected Zod schemas.
+ */ function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+import { z } from 'zod';
+/**
+ * Map of component names to their form field types.
+ */ var FORM_COMPONENTS = {
+    Input: 'string',
+    TextInput: 'string',
+    NumberInput: 'number',
+    Checkbox: 'boolean',
+    Select: 'string',
+    RadioGroup: 'string',
+    TextArea: 'string',
+    HiddenInput: 'string',
+    MultiTextInput: 'string[]'
+};
+/**
+ * Extract form fields from a component tree.
+ *
+ * @param root - The root ComponentNode
+ * @returns ExtractedFormSchema with all form fields found
+ */ export function extractFormSchema(root) {
+    var fields = [];
+    function extractFromNode(node, insideLoop) {
+        // Check if this is a form component
+        var fieldType = FORM_COMPONENTS[node.component];
+        // Special handling for Checkbox: if it has a value prop, it returns that string value
+        if (node.component === 'Checkbox') {
+            var valueProp = node.props.value;
+            fieldType = valueProp ? 'string' : 'boolean';
+        }
+        if (fieldType) {
+            var nameProp = node.props.name;
+            if ((nameProp === null || nameProp === void 0 ? void 0 : nameProp.type) === 'literal' && typeof nameProp.value === 'string') {
+                var name = nameProp.value;
+                // Determine final type - arrays if inside loop or already array type
+                var finalType = fieldType;
+                if (insideLoop && !fieldType.endsWith('[]')) {
+                    finalType = "".concat(fieldType, "[]");
+                }
+                fields.push({
+                    name: name,
+                    type: finalType,
+                    insideLoop: insideLoop
+                });
+            }
+        }
+        // Check if this is a loop component
+        var isLoopComponent = node.component === 'List' || node.component === 'Each';
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            // Recurse into children
+            for(var _iterator = node.children[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var child = _step.value;
+                extractFromNode(child, insideLoop || isLoopComponent);
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+    extractFromNode(root, false);
+    return {
+        fields: fields
+    };
+}
+/**
+ * Convert extracted fields to a nested object shape.
+ * Handles dot notation like "user.email" -> { user: { email: ... } }
+ */ export function fieldsToShape(fields) {
+    var shape = {};
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = fields[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var field = _step.value;
+            var parts = field.name.split('.');
+            var current = shape;
+            for(var i = 0; i < parts.length - 1; i++){
+                var part = parts[i];
+                if (!(part in current)) {
+                    current[part] = {};
+                }
+                current = current[part];
+            }
+            var lastPart = parts[parts.length - 1];
+            current[lastPart] = field.type;
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return shape;
+}
+/**
+ * Check if a Zod schema expects an array type.
+ */ function isZodArray(schema) {
+    if (_instanceof(schema, z.ZodArray)) {
+        return true;
+    }
+    if (_instanceof(schema, z.ZodOptional) || _instanceof(schema, z.ZodNullable)) {
+        return isZodArray(schema.unwrap());
+    }
+    return false;
+}
+/**
+ * Check if a Zod schema expects a string type.
+ */ function isZodString(schema) {
+    if (_instanceof(schema, z.ZodString)) {
+        return true;
+    }
+    if (_instanceof(schema, z.ZodOptional) || _instanceof(schema, z.ZodNullable)) {
+        return isZodString(schema.unwrap());
+    }
+    return false;
+}
+/**
+ * Check if a Zod schema expects a number type.
+ */ function isZodNumber(schema) {
+    if (_instanceof(schema, z.ZodNumber)) {
+        return true;
+    }
+    if (_instanceof(schema, z.ZodOptional) || _instanceof(schema, z.ZodNullable)) {
+        return isZodNumber(schema.unwrap());
+    }
+    return false;
+}
+/**
+ * Check if a Zod schema expects a boolean type.
+ */ function isZodBoolean(schema) {
+    if (_instanceof(schema, z.ZodBoolean)) {
+        return true;
+    }
+    if (_instanceof(schema, z.ZodOptional) || _instanceof(schema, z.ZodNullable)) {
+        return isZodBoolean(schema.unwrap());
+    }
+    return false;
+}
+/**
+ * Check if a field type matches a Zod schema.
+ */ function fieldTypeMatchesSchema(fieldType, zodSchema) {
+    // Handle array types
+    if (fieldType === 'string[]' || fieldType === 'number[]') {
+        if (!isZodArray(zodSchema)) {
+            return false;
+        }
+        // Get the element schema
+        var elementSchema = zodSchema;
+        if (_instanceof(elementSchema, z.ZodOptional) || _instanceof(elementSchema, z.ZodNullable)) {
+            elementSchema = elementSchema.unwrap();
+        }
+        if (_instanceof(elementSchema, z.ZodArray)) {
+            var innerType = elementSchema.element;
+            if (fieldType === 'string[]') {
+                return isZodString(innerType);
+            }
+            if (fieldType === 'number[]') {
+                return isZodNumber(innerType);
+            }
+        }
+        return false;
+    }
+    // Handle primitive types
+    switch(fieldType){
+        case 'string':
+            return isZodString(zodSchema);
+        case 'number':
+            return isZodNumber(zodSchema);
+        case 'boolean':
+            return isZodBoolean(zodSchema);
+        default:
+            return false;
+    }
+}
+/**
+ * Validate an extracted schema against an expected Zod schema.
+ *
+ * @param extracted - The ExtractedFormSchema from the template
+ * @param zodSchema - The expected Zod schema (must be ZodObject)
+ * @returns Array of validation errors
+ */ export function validateAgainstZod(extracted, zodSchema) {
+    var errors = [];
+    // Check that zodSchema is an object schema
+    if (!_instanceof(zodSchema, z.ZodObject)) {
+        errors.push({
+            type: 'form-schema-mismatch',
+            message: 'Expected schema must be a ZodObject'
+        });
+        return errors;
+    }
+    var expectedShape = zodSchema.shape;
+    var extractedFieldNames = new Set(extracted.fields.map(function(f) {
+        return f.name;
+    }));
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        // Check for missing required fields
+        for(var _iterator = Object.entries(expectedShape)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var _step_value = _sliced_to_array(_step.value, 2), fieldName = _step_value[0], fieldSchema = _step_value[1];
+            var isOptional = _instanceof(fieldSchema, z.ZodOptional) || _instanceof(fieldSchema, z.ZodNullable);
+            if (!isOptional && !extractedFieldNames.has(fieldName)) {
+                errors.push({
+                    type: 'form-schema-mismatch',
+                    message: 'Missing required form field: "'.concat(fieldName, '"'),
+                    path: fieldName
+                });
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+    try {
+        // Check type compatibility for extracted fields
+        for(var _iterator1 = extracted.fields[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+            var field = _step1.value;
+            var expectedFieldSchema = expectedShape[field.name];
+            if (!expectedFieldSchema) {
+                continue;
+            }
+            if (!fieldTypeMatchesSchema(field.type, expectedFieldSchema)) {
+                errors.push({
+                    type: 'form-schema-mismatch',
+                    message: 'Field "'.concat(field.name, '" has type "').concat(field.type, '" but expected schema requires different type'),
+                    path: field.name
+                });
+            }
+        }
+    } catch (err) {
+        _didIteratorError1 = true;
+        _iteratorError1 = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                _iterator1.return();
+            }
+        } finally{
+            if (_didIteratorError1) {
+                throw _iteratorError1;
+            }
+        }
+    }
+    return errors;
+}

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

@@ -0,0 +1,210 @@
+/**
+ * Type inference for generating readable data shape descriptions.
+ *
+ * Used to describe available data to the LLM in a TypeScript-like format
+ * with inline examples for better template generation.
+ */ /**
+ * Infer a type description for a value.
+ * Returns a simple type string like "string", "number", etc.
+ */ function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+export function inferTypeDescription(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (typeof value === 'string') {
+        return 'string';
+    }
+    if (typeof value === 'number') {
+        return 'number';
+    }
+    if (typeof value === 'boolean') {
+        return 'boolean';
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return 'unknown[]';
+        }
+        var elementType = inferTypeDescription(value[0]);
+        return "".concat(elementType, "[]");
+    }
+    if ((typeof value === "undefined" ? "undefined" : _type_of(value)) === 'object') {
+        return 'object';
+    }
+    return 'unknown';
+}
+/**
+ * Truncate a string to a maximum length with ellipsis.
+ */ function truncate(str, maxLength) {
+    if (str.length <= maxLength) {
+        return str;
+    }
+    return str.slice(0, maxLength - 3) + '...';
+}
+/**
+ * Format a value as an example (for inline comments).
+ */ function formatExample(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (typeof value === 'string') {
+        return '"'.concat(truncate(value, 30), '"');
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return '...';
+}
+/**
+ * Infer a type description with inline examples.
+ * Makes it easier for the LLM to understand the data shape.
+ *
+ * @param value - The sample value to describe
+ * @param indent - Current indentation level
+ * @returns Multi-line string describing the type with examples
+ */ export function inferTypeWithExamples(value) {
+    var indent = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 0;
+    var spaces = '  '.repeat(indent);
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (typeof value === 'string') {
+        return "string // e.g., ".concat(formatExample(value));
+    }
+    if (typeof value === 'number') {
+        return "number // e.g., ".concat(value);
+    }
+    if (typeof value === 'boolean') {
+        return "boolean // e.g., ".concat(value);
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return 'unknown[] // empty array';
+        }
+        var firstElement = value[0];
+        var elementType = inferTypeWithExamples(firstElement, indent + 1);
+        // For primitive arrays, keep it compact
+        if (typeof firstElement === 'string' || typeof firstElement === 'number' || typeof firstElement === 'boolean') {
+            return "Array<".concat(inferTypeDescription(firstElement), "> // ").concat(value.length, " items, e.g., ").concat(formatExample(firstElement));
+        }
+        // For object arrays, show the structure
+        return "Array<".concat(elementType, "> // ").concat(value.length, " items");
+    }
+    if ((typeof value === "undefined" ? "undefined" : _type_of(value)) === 'object') {
+        var entries = Object.entries(value);
+        if (entries.length === 0) {
+            return '{}';
+        }
+        var lines = [
+            '{'
+        ];
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = entries[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var _step_value = _sliced_to_array(_step.value, 2), key = _step_value[0], val = _step_value[1];
+                var valType = inferTypeWithExamples(val, indent + 1);
+                lines.push("".concat(spaces, "  ").concat(key, ": ").concat(valType));
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+        lines.push("".concat(spaces, "}"));
+        return lines.join('\n');
+    }
+    return 'unknown';
+}
+/**
+ * Describe the shape of data in a readable TypeScript-like format.
+ * This is the main entry point for generating data descriptions for the LLM.
+ *
+ * @param data - The data object to describe
+ * @returns A multi-line string describing the data shape with examples
+ *
+ * @example
+ * ```typescript
+ * const data = {
+ *   emails: [
+ *     { id: "1", subject: "Hello", from: "alice@example.com" }
+ *   ],
+ *   sessionId: "abc123"
+ * };
+ *
+ * console.log(describeDataShape(data));
+ * // Output:
+ * // {
+ * //   emails: Array<{
+ * //     id: string // e.g., "1"
+ * //     subject: string // e.g., "Hello"
+ * //     from: string // e.g., "alice@example.com"
+ * //   }> // 1 items
+ * //   sessionId: string // e.g., "abc123"
+ * // }
+ * ```
+ */ export function describeDataShape(data) {
+    return inferTypeWithExamples(data, 0);
+}

package/dist/src/yaml/types.js

@@ -0,0 +1,12 @@
+/**
+ * Types for the YAML-based UI generation DSL.
+ *
+ * Templates are written in YAML and parsed into an AST of ComponentNodes.
+ * Props can be literal values or binding expressions ({{path}}) that are
+ * resolved at render time against provided data.
+ */ /**
+ * A binding expression like {{emails}} or {{email.subject}}
+ * that references data to be resolved at render time.
+ */ /**
+ * Data type inference for validating bindings.
+ */ export { };

package/dist/types/clients/types.d.ts

@@ -84,5 +84,47 @@ export interface ObjectGenerator {
             totalTokens: number;
         };
     }>;
+    /**
+     * Generates text with multi-step tool calling support.
+     * Used for agentic workflows that require multiple LLM iterations.
+     *
+     * Unlike generateText (single step), this method:
+     * - Executes tools and feeds results back to the LLM automatically
+     * - Continues until maxSteps reached or LLM stops calling tools
+     * - Returns all tool calls with their results
+     *
+     * This is a thin wrapper around the underlying SDK's multi-step capabilities
+     * (e.g., Vercel AI SDK's stopWhen: stepCountIs()).
+     */
+    streamText(params: {
+        /** System prompt for the LLM */
+        system?: string;
+        /** Initial user prompt */
+        prompt: string;
+        /** Conversation messages (optional, for context) */
+        messages?: ToolMessage[];
+        /** Available tools for the LLM to call */
+        tools: Record<string, {
+            description: string;
+            inputSchema: z.ZodSchema;
+            execute?: (args: unknown) => Promise<unknown> | unknown;
+        }>;
+        /** Maximum number of LLM iterations (default: 10) */
+        maxSteps?: number;
+    }): Promise<{
+        /** All tool calls made across all steps, with their results */
+        toolCalls: Array<{
+            toolCallId: string;
+            toolName: string;
+            args: unknown;
+            result: unknown;
+        }>;
+        /** Final text response (if any) */
+        text?: string;
+        /** Token usage across all steps */
+        usage: {
+            totalTokens: number;
+        };
+    }>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types/clients/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/clients/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE;QAC/C;;;WAGG;QACH,MAAM,EAAE,CAAC,CAAC;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B;;;;;WAKG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;;;;WAKG;QACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;QAErB;;;;WAIG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAExB;;;OAGG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE;QACpB,gCAAgC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,sDAAsD;QACtD,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,0CAA0C;QAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAA;SAAE,CAAC,CAAC;KAC1E,GAAG,OAAO,CAAC;QACV,iCAAiC;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,iCAAiC;QACjC,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,UAAU,EAAE,MAAM,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,OAAO,CAAC;SACf,CAAC,CAAC;QACH,8BAA8B;QAC9B,KAAK,EAAE;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;KAChC,CAAC,CAAC;CACJ"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/clients/types.ts"],"names":[],"mappings":"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"}

package/dist/types/dsl/agent-messages.d.ts

@@ -0,0 +1,18 @@
+import type { BrainEvent } from './definitions/events.js';
+import type { ToolMessage } from '../clients/types.js';
+import type { JsonObject } from './types.js';
+export interface AgentResumeContext {
+    messages: ToolMessage[];
+    pendingToolCallId: string;
+    pendingToolName: string;
+    prompt: string;
+    system?: string;
+    /** The raw webhook response for event emission */
+    webhookResponse: JsonObject;
+}
+/**
+ * Reconstructs the agent context from stored events and a webhook response.
+ * Returns null if this is not an agent resume (no AGENT_WEBHOOK event found).
+ */
+export declare function reconstructAgentContext(events: BrainEvent[], webhookResponse: JsonObject): AgentResumeContext | null;
+//# sourceMappingURL=agent-messages.d.ts.map

package/dist/types/dsl/agent-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messages.d.ts","sourceRoot":"","sources":["../../../src/dsl/agent-messages.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAKX,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,eAAe,EAAE,UAAU,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,UAAU,EAAE,EACpB,eAAe,EAAE,UAAU,GAC1B,kBAAkB,GAAG,IAAI,CA2D3B"}

package/dist/types/dsl/brain-runner.d.ts

@@ -18,7 +18,7 @@ export declare class BrainRunner {
     withResources(resources: Resources): BrainRunner;
     withPages(pages: PagesService): BrainRunner;
     withEnv(env: RuntimeEnv): BrainRunner;
-    run<TOptions extends JsonObject = {}, TState extends State = {}>(brain: Brain<TOptions, TState, any>, { initialState, options, initialCompletedSteps, brainRunId, endAfter, signal, response, loopEvents, }?: {
+    run<TOptions extends JsonObject = {}, TState extends State = {}>(brain: Brain<TOptions, TState, any>, { initialState, options, initialCompletedSteps, brainRunId, endAfter, signal, response, agentEvents, }?: {
         initialState?: TState;
         options?: TOptions;
         initialCompletedSteps?: SerializedStep[] | never;
@@ -26,7 +26,7 @@ export declare class BrainRunner {
         endAfter?: number;
         signal?: AbortSignal;
         response?: JsonObject;
-        loopEvents?: BrainEvent[];
+        agentEvents?: BrainEvent[];
     }): Promise<TState>;
 }
 //# sourceMappingURL=brain-runner.d.ts.map

package/dist/types/dsl/brain-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brain-runner.d.ts","sourceRoot":"","sources":["../../../src/dsl/brain-runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,WAAW;IAEpB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE;QACf,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,EAAE,eAAe,CAAC;QACxB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,KAAK,CAAC,EAAE,YAAY,CAAC;QACrB,GAAG,CAAC,EAAE,UAAU,CAAC;KAClB;IAGH,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW;IAQ9C,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW;IAOhD,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW;IAOhD,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW;IAO3C,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW;IAO/B,GAAG,CAAC,QAAQ,SAAS,UAAU,GAAG,EAAE,EAAE,MAAM,SAAS,KAAK,GAAG,EAAE,EACnE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EACnC,EACE,YAA2B,EAC3B,OAAO,EACP,qBAAqB,EACrB,UAAU,EACV,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,UAAU,GACX,GAAE;QACD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,qBAAqB,CAAC,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;QACjD,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;KACtB,GACL,OAAO,CAAC,MAAM,CAAC;CAmGnB"}
+{"version":3,"file":"brain-runner.d.ts","sourceRoot":"","sources":["../../../src/dsl/brain-runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,WAAW;IAEpB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE;QACf,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,EAAE,eAAe,CAAC;QACxB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,KAAK,CAAC,EAAE,YAAY,CAAC;QACrB,GAAG,CAAC,EAAE,UAAU,CAAC;KAClB;IAGH,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW;IAQ9C,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW;IAOhD,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW;IAOhD,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW;IAO3C,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW;IAO/B,GAAG,CAAC,QAAQ,SAAS,UAAU,GAAG,EAAE,EAAE,MAAM,SAAS,KAAK,GAAG,EAAE,EACnE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EACnC,EACE,YAA2B,EAC3B,OAAO,EACP,qBAAqB,EACrB,UAAU,EACV,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,WAAW,GACZ,GAAE;QACD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,qBAAqB,CAAC,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;QACjD,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;KACvB,GACL,OAAO,CAAC,MAAM,CAAC;CAmGnB"}