@positronic/core 0.0.76 → 0.0.78

package/dist/types/jsx-runtime.d.ts

@@ -0,0 +1,35 @@
+import type { JSX as ReactJSX } from 'react';
+export declare const Fragment: unique symbol;
+export declare const File: unique symbol;
+export declare const Resource: unique symbol;
+interface FormComponent {
+    (props: Record<string, unknown>): TemplateNode;
+}
+export declare const Form: FormComponent;
+type BuiltinComponent = typeof Fragment | typeof File | typeof Resource;
+export type FunctionComponent = (props: Record<string, unknown>) => TemplateChild | Promise<TemplateChild>;
+export type ElementType = BuiltinComponent | FunctionComponent | string;
+export interface TemplateNode {
+    type: ElementType;
+    props: Record<string, unknown>;
+    children: TemplateChild[];
+}
+export type TemplateChild = string | number | boolean | null | undefined | TemplateNode | TemplateChild[];
+export declare function jsx(type: ElementType, props: Record<string, unknown>): TemplateNode;
+export declare const jsxs: typeof jsx;
+type WithTemplateChildren<T> = Omit<T, 'children'> & {
+    children?: TemplateChild;
+};
+type PositronicIntrinsicElements = {
+    [K in keyof ReactJSX.IntrinsicElements]: WithTemplateChildren<ReactJSX.IntrinsicElements[K]>;
+};
+export declare namespace JSX {
+    type Element = TemplateNode;
+    interface IntrinsicElements extends PositronicIntrinsicElements {
+    }
+    interface ElementChildrenAttribute {
+        children: {};
+    }
+}
+export {};
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/types/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../../src/jsx-runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,IAAI,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE7C,eAAO,MAAM,QAAQ,eAAoC,CAAC;AAC1D,eAAO,MAAM,IAAI,eAAgC,CAAC;AAClD,eAAO,MAAM,QAAQ,eAAoC,CAAC;AAK1D,UAAU,aAAa;IACrB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC;CAChD;AACD,eAAO,MAAM,IAAI,EAAE,aAAoD,CAAC;AAExE,KAAK,gBAAgB,GAAG,OAAO,QAAQ,GAAG,OAAO,IAAI,GAAG,OAAO,QAAQ,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,YAAY,GACZ,aAAa,EAAE,CAAC;AAGpB,wBAAgB,GAAG,CACjB,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,YAAY,CAOd;AAGD,eAAO,MAAM,IAAI,YAAM,CAAC;AAGxB,KAAK,oBAAoB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG;IACnD,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B,CAAC;AAEF,KAAK,2BAA2B,GAAG;KAChC,CAAC,IAAI,MAAM,QAAQ,CAAC,iBAAiB,GAAG,oBAAoB,CAC3D,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAC9B;CACF,CAAC;AAEF,yBAAiB,GAAG,CAAC;IACnB,KAAY,OAAO,GAAG,YAAY,CAAC;IAEnC,UAAiB,iBAAkB,SAAQ,2BAA2B;KAAG;IAEzE,UAAiB,wBAAwB;QACvC,QAAQ,EAAE,EAAE,CAAC;KACd;CACF"}

package/dist/types/memory/{scoped-memory.d.ts → create-memory.d.ts}

@@ -1,6 +1,6 @@
-import type { MemoryProvider, ScopedMemory } from './types.js';
+import type { MemoryProvider, Memory } from './types.js';
 /**
- * Creates a scoped memory instance with agentId and userId pre-bound.
+ * Creates a Memory instance with agentId and userId pre-bound.
  *
  * This wraps a MemoryProvider and automatically includes the agentId
  * and userId in all calls, so brain steps don't need to pass them explicitly.
@@ -8,16 +8,16 @@ import type { MemoryProvider, ScopedMemory } from './types.js';
  * @param provider - The underlying memory provider
  * @param agentId - The agent/brain ID to scope memories to
  * @param userId - The user name to scope memories to (from currentUser.name)
- * @returns A ScopedMemory instance
+ * @returns A Memory instance
  *
  * @example
  * ```typescript
  * const provider = createMem0Provider({ apiKey: '...' });
- * const scopedMemory = createScopedMemory(provider, 'my-brain', 'user-123');
+ * const memory = createMemory(provider, 'my-brain', 'user-123');
  *
  * // Now search without passing agentId or userId
- * const memories = await scopedMemory.search('user preferences');
+ * const memories = await memory.search('user preferences');
  * ```
  */
-export declare function createScopedMemory(provider: MemoryProvider, agentId: string, userId: string): ScopedMemory;
-//# sourceMappingURL=scoped-memory.d.ts.map
+export declare function createMemory(provider: MemoryProvider, agentId: string, userId: string): Memory;
+//# sourceMappingURL=create-memory.d.ts.map

package/dist/types/memory/create-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/create-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,MAAM,EAKP,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,CAkBR"}

package/dist/types/memory/types.d.ts

@@ -8,7 +8,7 @@
 /**
  * A single memory entry returned from search operations.
  */
-export interface Memory {
+export interface MemoryEntry {
     /** Unique identifier for this memory */
     id: string;
     /** The memory content */
@@ -66,7 +66,7 @@ export interface MemoryProvider {
      */
     search(query: string, scope: MemoryScope, options?: {
         limit?: number;
-    }): Promise<Memory[]>;
+    }): Promise<MemoryEntry[]>;
     /**
      * Add memories from a conversation.
      *
@@ -82,7 +82,7 @@ export interface MemoryProvider {
  * Scoped memory interface with agentId and userId pre-bound.
  * This is what brain steps receive - they don't need to pass agentId or userId.
  */
-export interface ScopedMemory {
+export interface Memory {
     /**
      * Search for relevant memories.
      *
@@ -90,7 +90,7 @@ export interface ScopedMemory {
      * @param options - Optional search options (limit)
      * @returns Array of matching memories
      */
-    search(query: string, options?: MemorySearchOptions): Promise<Memory[]>;
+    search(query: string, options?: MemorySearchOptions): Promise<MemoryEntry[]>;
     /**
      * Add memories from messages.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAErB;;;;;;OAMG;IACH,GAAG,CACD,QAAQ,EAAE,aAAa,EAAE,EACzB,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAExE;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1B;;;;;;OAMG;IACH,GAAG,CACD,QAAQ,EAAE,aAAa,EAAE,EACzB,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE7E;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E"}

package/dist/types/plugins/collect-webhooks.d.ts

@@ -0,0 +1,8 @@
+import type { ConfiguredPlugin } from './types.js';
+import type { WebhookFunction } from '../dsl/webhook.js';
+/**
+ * Collect webhook declarations from all plugins.
+ * Returns a manifest-compatible record mapping slug -> WebhookFunction.
+ */
+export declare function collectPluginWebhooks(plugins: readonly ConfiguredPlugin[]): Record<string, WebhookFunction<any>>;
+//# sourceMappingURL=collect-webhooks.d.ts.map

package/dist/types/plugins/collect-webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-webhooks.d.ts","sourceRoot":"","sources":["../../../src/plugins/collect-webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAWtC"}

package/dist/types/plugins/define-plugin.d.ts

@@ -0,0 +1,25 @@
+import type { PluginDefinition, PluginCreateReturn, ConfiguredPlugin, ConfiguredPluginWithSetup } from './types.js';
+/**
+ * Define a plugin with a setup function for typed configuration.
+ * Returns a ConfiguredPlugin with a .setup() method.
+ *
+ * Usage:
+ *   const mem0 = definePlugin({ name: 'mem0', setup: (c: Config) => c, create: ... })
+ *   brain('x').withPlugin(mem0)                    // default config
+ *   brain('x').withPlugin(mem0.setup({ scope: 'user' }))  // custom config
+ */
+export declare function definePlugin<TName extends string, TConfig, TCreate extends PluginCreateReturn>(definition: PluginDefinition<TName, TConfig, TCreate> & {
+    setup: (config: TConfig) => TConfig;
+}): ConfiguredPluginWithSetup<TName, TConfig, TCreate>;
+/**
+ * Define a plugin without a setup function (no configuration needed).
+ * Returns a ConfiguredPlugin that can be passed directly to withPlugin().
+ *
+ * Usage:
+ *   const logger = definePlugin({ name: 'logger', create: ... })
+ *   brain('x').withPlugin(logger)
+ */
+export declare function definePlugin<TName extends string, TCreate extends PluginCreateReturn>(definition: PluginDefinition<TName, undefined, TCreate> & {
+    setup?: never;
+}): ConfiguredPlugin<TName, undefined, TCreate>;
+//# sourceMappingURL=define-plugin.d.ts.map

package/dist/types/plugins/define-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/define-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,KAAK,SAAS,MAAM,EACpB,OAAO,EACP,OAAO,SAAS,kBAAkB,EAElC,UAAU,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG;IACtD,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CACrC,GACA,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEtD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,SAAS,MAAM,EACpB,OAAO,SAAS,kBAAkB,EAElC,UAAU,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAC1E,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC"}

package/dist/types/plugins/index.d.ts

@@ -0,0 +1,3 @@
+export { definePlugin } from './define-plugin.js';
+export type { CreateContext, PluginAdapter, PluginCreateReturn, PluginDefinition, PluginInjection, PluginsFrom, PluginsFromArray, ConfiguredPlugin, ConfiguredPluginWithSetup, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EACV,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/types/plugins/types.d.ts

@@ -0,0 +1,83 @@
+import type { CurrentUser } from '../dsl/types.js';
+import type { WebhookFunction } from '../dsl/webhook.js';
+/**
+ * Context passed to a plugin's `create` function.
+ * Contains per-run information needed to scope the plugin instance.
+ */
+export interface CreateContext<TConfig = undefined> {
+    config: TConfig;
+    brainTitle: string;
+    currentUser: CurrentUser;
+    brainRunId: string;
+}
+/**
+ * A plugin adapter that receives brain events.
+ * Optional `resume` method receives historical events on brain resume
+ * for rebuilding internal state without side effects.
+ */
+export interface PluginAdapter {
+    dispatch(event: any): void | Promise<void>;
+    resume?(events: any[]): void;
+}
+/**
+ * The return value of a plugin's `create` function.
+ * Special keys `tools` and `adapter` are intercepted by the framework.
+ * Everything else goes on StepContext under the plugin name.
+ */
+export type PluginCreateReturn = {
+    tools?: Record<string, any>;
+    adapter?: PluginAdapter;
+    webhooks?: Record<string, WebhookFunction<any>>;
+    [key: string]: any;
+};
+/**
+ * The full plugin definition as passed to definePlugin().
+ */
+export interface PluginDefinition<TName extends string, TConfig, TCreate extends PluginCreateReturn> {
+    name: TName;
+    setup?: (config: TConfig) => TConfig;
+    create: (ctx: CreateContext<TConfig>) => TCreate;
+    /** Static webhook declarations — discovered at startup for manifest registration */
+    webhooks?: Record<string, WebhookFunction<any>>;
+}
+/**
+ * What goes on StepContext under the plugin name:
+ * everything from create() except `adapter`.
+ */
+export type PluginInjection<TCreate extends PluginCreateReturn> = Omit<TCreate, 'adapter'>;
+/**
+ * A configured plugin instance. Returned by definePlugin() and by .setup().
+ * Can be passed directly to brain.withPlugin().
+ *
+ * The __plugin and __config fields are internal — used by the framework
+ * to resolve plugins at brain.run() time.
+ */
+export interface ConfiguredPlugin<TName extends string = string, TConfig = any, TCreate extends PluginCreateReturn = PluginCreateReturn> {
+    readonly __plugin: PluginDefinition<TName, TConfig, TCreate>;
+    readonly __config: TConfig;
+}
+/**
+ * Extract plugin injections from a plugins object literal.
+ * Maps { slack: ConfiguredPlugin<'slack', C, R> } → { slack: PluginInjection<R> }.
+ * The injection name comes from the object key, not the plugin's internal name.
+ */
+export type PluginsFrom<T extends Record<string, ConfiguredPlugin>> = {
+    [K in keyof T]: T[K] extends ConfiguredPlugin<any, any, infer C> ? PluginInjection<C> : never;
+};
+/**
+ * Extract plugin injections from an array of ConfiguredPlugin instances.
+ * Reuses PluginsFrom by mapping the array's union to a record keyed by plugin name.
+ *
+ * Used by createBrain() to propagate project-level plugin types to all brains.
+ */
+export type PluginsFromArray<T extends readonly ConfiguredPlugin[]> = PluginsFrom<{
+    [K in T[number] as K['__plugin']['name']]: K;
+}>;
+/**
+ * A configured plugin that also has a .setup() method for per-brain configuration.
+ * Returned by definePlugin() when a setup function is provided.
+ */
+export interface ConfiguredPluginWithSetup<TName extends string, TConfig, TCreate extends PluginCreateReturn> extends ConfiguredPlugin<TName, TConfig, TCreate> {
+    setup(config: TConfig): ConfiguredPlugin<TName, TConfig, TCreate>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,SAAS;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAC/B,KAAK,SAAS,MAAM,EACpB,OAAO,EACP,OAAO,SAAS,kBAAkB;IAElC,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IACrC,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;IACjD,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,kBAAkB,IAAI,IAAI,CACpE,OAAO,EACP,SAAS,CACV,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB,CAC/B,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,OAAO,GAAG,GAAG,EACb,OAAO,SAAS,kBAAkB,GAAG,kBAAkB;IAEvD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI;KACnE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,GAC5D,eAAe,CAAC,CAAC,CAAC,GAClB,KAAK;CACV,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,SAAS,gBAAgB,EAAE,IAChE,WAAW,CAAC;KACT,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;CAC7C,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,WAAW,yBAAyB,CACxC,KAAK,SAAS,MAAM,EACpB,OAAO,EACP,OAAO,SAAS,kBAAkB,CAClC,SAAQ,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC;IACjD,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;CACnE"}

package/dist/types/store/index.d.ts

@@ -1,2 +1,2 @@
-export type { Store, StoreProvider, PerUserField, InferStoreTypes, StoreContext, } from './types.js';
+export type { Store, StoreProvider, PerUserField, InferStoreTypes, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/store/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,EACL,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/types/store/types.d.ts

@@ -40,12 +40,4 @@ export type StoreProvider = (config: {
     brainTitle: string;
     currentUser?: CurrentUser;
 }) => Store<any>;
-/**
- * Conditional type that adds `store` to step params only when withStore() is used.
- * When TStore is `never` (default), this resolves to `{}` — no store in params.
- * When TStore is a record type, this adds `{ store: Store<TStore> }`.
- */
-export type StoreContext<TStore> = [TStore] extends [never] ? {} : TStore extends Record<string, JsonValue | undefined> ? {
-    store: Store<TStore>;
-} : {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/store/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC3D,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,WAAW,IAAI;KAClD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,CAAC,GAC9C,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GACV,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GACtB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACb,KAAK;CACV,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IACpE,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACnE,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GACvD,EAAE,GACF,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,GACpD;IAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,GACxB,EAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/store/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC3D,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,WAAW,IAAI;KAClD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,CAAC,GAC9C,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GACV,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GACtB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACb,KAAK;CACV,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IACpE,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACnE,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC"}

package/dist/types/template/render-html.d.ts

@@ -0,0 +1,9 @@
+import { type TemplateChild } from '../jsx-runtime.js';
+export interface RenderHtmlContext {
+    formAction?: string;
+}
+export declare function renderHtml(node: TemplateChild, context?: RenderHtmlContext): string;
+export declare function wrapHtmlDocument(body: string, options?: {
+    title?: string;
+}): string;
+//# sourceMappingURL=render-html.d.ts.map

package/dist/types/template/render-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-html.d.ts","sourceRoot":"","sources":["../../../src/template/render-html.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8JD,wBAAgB,UAAU,CACxB,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAER;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,MAAM,CAcR"}

package/dist/types/template/render.d.ts

@@ -0,0 +1,15 @@
+import { type TemplateNode, type TemplateChild } from '../jsx-runtime.js';
+import type { TemplateReturn } from '../dsl/definitions/blocks.js';
+export interface TemplateContext {
+    readFile?: (name: string) => Promise<string>;
+    readResource?: (name: string) => Promise<string>;
+}
+export declare function buildTemplateContext(files?: {
+    open(name: string): {
+        read(): Promise<string>;
+    };
+}, resources?: unknown): TemplateContext;
+export declare function isTemplateNode(value: unknown): value is TemplateNode;
+export declare function resolveTemplate(raw: TemplateReturn, context?: TemplateContext): Promise<string>;
+export declare function renderTemplate(node: TemplateChild, context?: TemplateContext): Promise<string>;
+//# sourceMappingURL=render.d.ts.map

package/dist/types/template/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/template/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD;AAED,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,EAAE;IAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,EAC3D,SAAS,CAAC,EAAE,OAAO,GAClB,eAAe,CAOjB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAQpE;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,cAAc,EACnB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/types/tools/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { AgentTool, AgentToolWaitFor, StepContext } from '../dsl/types.js';
+import type { Tool, ToolWaitFor, StepContext } from '../dsl/types.js';
 /**
  * Helper function to create tools with proper type inference.
  *
@@ -24,10 +24,10 @@ import type { AgentTool, AgentToolWaitFor, StepContext } from '../dsl/types.js';
 export declare function createTool<T extends z.ZodSchema>(config: {
     description: string;
     inputSchema: T;
-    execute?: (input: z.infer<T>, context: StepContext) => unknown | Promise<unknown> | AgentToolWaitFor | Promise<AgentToolWaitFor>;
+    execute?: (input: z.infer<T>, context: StepContext) => unknown | Promise<unknown> | ToolWaitFor | Promise<ToolWaitFor>;
     terminal?: boolean;
-}): AgentTool<T>;
-declare const generateUIInputSchema: z.ZodObject<{
+}): Tool<T>;
+declare const generatePageInputSchema: z.ZodObject<{
     prompt: z.ZodString;
     hasForm: z.ZodOptional<z.ZodBoolean>;
     persist: z.ZodOptional<z.ZodBoolean>;
@@ -59,7 +59,7 @@ declare const generateUIInputSchema: z.ZodObject<{
  *
  * The description is enriched at runtime with available component information.
  */
-export declare const generateUI: AgentTool<typeof generateUIInputSchema>;
+export declare const generatePage: Tool<typeof generatePageInputSchema>;
 declare const waitForWebhookInputSchema: z.ZodObject<{
     slug: z.ZodString;
     identifier: z.ZodString;
@@ -68,29 +68,29 @@ declare const waitForWebhookInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     slug: string;
     identifier: string;
-    token?: string | undefined;
     timeout?: string | undefined;
+    token?: string | undefined;
 }, {
     slug: string;
     identifier: string;
-    token?: string | undefined;
     timeout?: string | undefined;
+    token?: string | undefined;
 }>;
 /**
  * Wait for webhook tool - pauses execution until a webhook receives a response.
  *
- * Use this after generating a UI page with a form to wait for the user's submission.
+ * Use this after generating a page with a form to wait for the user's submission.
  * The form data will be returned as the tool result when the webhook fires.
  *
  * IMPORTANT: Before calling this tool, ensure the user knows the page URL
  * so they can access and submit the form.
  */
-export declare const waitForWebhook: AgentTool<typeof waitForWebhookInputSchema>;
+export declare const waitForWebhook: Tool<typeof waitForWebhookInputSchema>;
 /**
  * Print tool - the simplest way for agents to communicate with users.
  * Like PRINT in BASIC - outputs a message that users can see.
  */
-export declare const print: AgentTool<z.ZodObject<{
+export declare const print: Tool<z.ZodObject<{
     message: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     message: string;
@@ -101,7 +101,7 @@ export declare const print: AgentTool<z.ZodObject<{
  * Console log tool - for internal server-side debugging and logging.
  * NOT for user communication - use print for that.
  */
-export declare const consoleLog: AgentTool<z.ZodObject<{
+export declare const consoleLog: Tool<z.ZodObject<{
     message: z.ZodString;
     level: z.ZodOptional<z.ZodEnum<["info", "warn", "error"]>>;
 }, "strip", z.ZodTypeAny, {
@@ -112,16 +112,29 @@ export declare const consoleLog: AgentTool<z.ZodObject<{
     level?: "error" | "info" | "warn" | undefined;
 }>>;
 /**
- * Default schema for the auto-generated 'done' tool when no outputSchema is provided.
- * Used internally by the framework.
+ * Read a file by name. The agent decides which files to read.
+ * Returns the file content as text.
  */
-export declare const defaultDoneSchema: z.ZodObject<{
-    result: z.ZodString;
+export declare const readFile: Tool<z.ZodObject<{
+    name: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    result: string;
+    name: string;
 }, {
-    result: string;
-}>;
+    name: string;
+}>>;
+/**
+ * Write text content to a file. The agent decides what to write and where.
+ */
+export declare const writeFile: Tool<z.ZodObject<{
+    name: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    content: string;
+}, {
+    name: string;
+    content: string;
+}>>;
 /**
  * Default tools bundle.
  *
@@ -129,9 +142,8 @@ export declare const defaultDoneSchema: z.ZodObject<{
  * standard tools in your brain. Tools can be extended or overridden in
  * individual agent steps.
  *
- * Note: A 'done' terminal tool is automatically generated for every agent.
- * If you provide an outputSchema, 'done' will use that schema. Otherwise,
- * it uses a default schema expecting { result: string }.
+ * Note: A 'done' terminal tool is automatically generated for every agent
+ * using the required outputSchema.
  *
  * @example
  * ```typescript
@@ -153,7 +165,7 @@ export declare const defaultDoneSchema: z.ZodObject<{
  * ```
  */
 export declare const defaultTools: {
-    generateUI: AgentTool<z.ZodObject<{
+    generatePage: Tool<z.ZodObject<{
         prompt: z.ZodString;
         hasForm: z.ZodOptional<z.ZodBoolean>;
         persist: z.ZodOptional<z.ZodBoolean>;
@@ -169,7 +181,7 @@ export declare const defaultTools: {
         hasForm?: boolean | undefined;
         persist?: boolean | undefined;
     }>>;
-    waitForWebhook: AgentTool<z.ZodObject<{
+    waitForWebhook: Tool<z.ZodObject<{
         slug: z.ZodString;
         identifier: z.ZodString;
         token: z.ZodOptional<z.ZodString>;
@@ -177,22 +189,22 @@ export declare const defaultTools: {
     }, "strip", z.ZodTypeAny, {
         slug: string;
         identifier: string;
-        token?: string | undefined;
         timeout?: string | undefined;
+        token?: string | undefined;
     }, {
         slug: string;
         identifier: string;
-        token?: string | undefined;
         timeout?: string | undefined;
+        token?: string | undefined;
     }>>;
-    print: AgentTool<z.ZodObject<{
+    print: Tool<z.ZodObject<{
         message: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         message: string;
     }, {
         message: string;
     }>>;
-    consoleLog: AgentTool<z.ZodObject<{
+    consoleLog: Tool<z.ZodObject<{
         message: z.ZodString;
         level: z.ZodOptional<z.ZodEnum<["info", "warn", "error"]>>;
     }, "strip", z.ZodTypeAny, {

package/dist/types/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC;IACf,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EACjB,OAAO,EAAE,WAAW,KAElB,OAAO,GACP,OAAO,CAAC,OAAO,CAAC,GAChB,gBAAgB,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,SAAS,CAAC,CAAC,CAAC,CAEf;AAED,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;EAmCzB,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,CAAC,OAAO,qBAAqB,CAiG9D,CAAC;AAEF,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;EA+B7B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,OAAO,yBAAyB,CA4CtE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;GAWhB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;GAmBrB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAQ5B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMtE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC;IACf,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EACjB,OAAO,EAAE,WAAW,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,IAAI,CAAC,CAAC,CAAC,CAEV;AAED,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;EAmC3B,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,OAAO,uBAAuB,CA+F7D,CAAC;AAEF,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;EA+B7B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,OAAO,yBAAyB,CA4CjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;GAWhB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;GAmBrB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;GAcnB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;GAepB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKxB,CAAC"}

package/dist/types/ui/generate-page-html.d.ts

@@ -3,9 +3,9 @@ import type { Placement } from './types.js';
  * Generate a CSRF token for form submissions.
  * Use this when building custom HTML pages with forms that submit to webhook endpoints.
  *
- * Include the returned token as a hidden input field:
- * ```html
- * <input type="hidden" name="__positronic_token" value="${token}">
+ * Include the returned token as a query parameter in the form action URL:
+ * ```
+ * /webhooks/system/ui-form?identifier=...&token=${token}
  * ```
  * And include it in the WebhookRegistration's `token` field.
  */
@@ -22,10 +22,8 @@ export interface GeneratePageHtmlOptions {
     data: Record<string, unknown>;
     /** Page title */
     title?: string;
-    /** Form action URL for form submission */
+    /** Form action URL for form submission (include token as query param if needed) */
     formAction?: string;
-    /** CSRF token for form submission validation */
-    formToken?: string;
 }
 /**
  * Generate a complete HTML page from placements.

package/dist/types/ui/generate-page-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-page-html.d.ts","sourceRoot":"","sources":["../../../src/ui/generate-page-html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CA4DzE"}
+{"version":3,"file":"generate-page-html.d.ts","sourceRoot":"","sources":["../../../src/ui/generate-page-html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8HD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAwDzE"}

package/dist/types/ui/{generate-ui.d.ts → generate-page.d.ts}

@@ -1,9 +1,9 @@
 import type { ObjectGenerator } from '../clients/types.js';
 import type { UIComponent, Placement, FormSchema } from './types.js';
 /**
- * Result of generateUI - contains all component placements from the agent loop.
+ * Result of generatePage - contains all component placements from the agent loop.
  */
-export interface GenerateUIResult {
+export interface GeneratePageResult {
     placements: Placement[];
     rootId: string | undefined;
     yaml?: string;
@@ -22,7 +22,7 @@ export interface GenerateUIResult {
  * ```typescript
  * import { components } from '@positronic/gen-ui-components';
  *
- * const result = await generateUI({
+ * const result = await generatePage({
  *   client,
  *   prompt: 'Create a form to collect user name and email',
  *   components,
@@ -35,7 +35,7 @@ export interface GenerateUIResult {
  * // result.yaml is the generated YAML template
  * ```
  */
-export declare function generateUI(params: {
+export declare function generatePage(params: {
     client: ObjectGenerator;
     prompt: string;
     components: Record<string, UIComponent<any>>;
@@ -43,5 +43,5 @@ export declare function generateUI(params: {
     data?: Record<string, unknown>;
     system?: string;
     maxSteps?: number;
-}): Promise<GenerateUIResult>;
-//# sourceMappingURL=generate-ui.d.ts.map
+}): Promise<GeneratePageResult>;
+//# sourceMappingURL=generate-page.d.ts.map

package/dist/types/ui/generate-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-page.d.ts","sourceRoot":"","sources":["../../../src/ui/generate-page.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkErE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AA8UD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoE9B"}

package/dist/types/ui/parse-form-data.d.ts

@@ -1,12 +1,8 @@
 /**
  * Parse form data into a plain object, handling array fields.
- * Extracts and strips the __positronic_token CSRF field.
  * Supports:
  * - name[] syntax for explicit arrays
  * - Multiple values with same key (converted to array)
  */
-export declare function parseFormData(formData: FormData): {
-    data: Record<string, unknown>;
-    token: string | null;
-};
+export declare function parseFormData(formData: FormData): Record<string, unknown>;
 //# sourceMappingURL=parse-form-data.d.ts.map

package/dist/types/ui/parse-form-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-form-data.d.ts","sourceRoot":"","sources":["../../../src/ui/parse-form-data.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CA8BA"}
+{"version":3,"file":"parse-form-data.d.ts","sourceRoot":"","sources":["../../../src/ui/parse-form-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzE"}