@positronic/core 0.0.52 → 0.0.53

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

@@ -0,0 +1,80 @@
+import { Brain } from './builder/brain.js';
+import type { AgentConfig, AgentTool, RuntimeEnv } from './types.js';
+import type { ObjectGenerator } from '../clients/types.js';
+import type { Resources } from '../resources/resources.js';
+import type { PagesService } from './pages.js';
+import type { UIComponent } from '../ui/types.js';
+/**
+ * Configuration for creating a project-level brain function.
+ */
+export interface CreateBrainConfig<TServices extends object = {}, TComponents extends Record<string, UIComponent<any>> = {}, TTools extends Record<string, AgentTool> = {}> {
+    /** Services available to all brains (e.g., slack, gmail, database clients) */
+    services?: TServices;
+    /** UI components for generative UI steps */
+    components?: TComponents;
+    /** Default tools available to all agent steps */
+    defaultTools?: TTools;
+}
+/**
+ * Creates a project-level brain function with pre-configured services, components, and tools.
+ *
+ * This is the recommended way to set up brains in a Positronic project. It provides:
+ * - Type-safe access to services in all brain steps
+ * - Automatic injection of components and default tools
+ * - Support for both builder pattern and direct agent creation
+ *
+ * @example
+ * ```typescript
+ * // brain.ts - your project's brain configuration
+ * import { createBrain } from '@positronic/core';
+ * import { components } from './components/index.js';
+ * import slack from './services/slack.js';
+ * import gmail from './services/gmail.js';
+ *
+ * export const brain = createBrain({
+ *   services: { slack, gmail },
+ *   components,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // brains/my-brain.ts - using the configured brain
+ * import { brain } from '../brain.js';
+ *
+ * // Builder pattern
+ * export default brain('my-workflow')
+ *   .step('Init', ({ slack }) => {
+ *     slack.postMessage('#general', 'Starting workflow');
+ *     return { started: true };
+ *   });
+ *
+ * // Or direct agent creation
+ * export default brain('my-agent', ({ slack, env }) => ({
+ *   system: 'You are helpful',
+ *   prompt: 'Help the user',
+ *   tools: { ... }
+ * }));
+ * ```
+ */
+export declare function createBrain<TServices extends object = {}, TComponents extends Record<string, UIComponent<any>> = {}, TTools extends Record<string, AgentTool> = {}>(config: CreateBrainConfig<TServices, TComponents, TTools>): {
+    <T extends Record<string, AgentTool>>(title: string, configFn: (params: {
+        state: object;
+        options: {};
+        tools: TTools extends {} ? Record<string, AgentTool> : TTools;
+        components: TComponents extends {} ? Record<string, UIComponent<any>> : TComponents;
+        client: ObjectGenerator;
+        resources: Resources;
+        response: undefined;
+        page: undefined;
+        pages?: PagesService;
+        env: RuntimeEnv;
+    } & TServices) => AgentConfig<T> | Promise<AgentConfig<T>>): Brain<{}, object, TServices, undefined, undefined>;
+    <T extends Record<string, AgentTool>>(title: string, config: AgentConfig<T>): Brain<{}, object, TServices, undefined, undefined>;
+    (title: string): Brain<{}, object, TServices, undefined, undefined>;
+    (config: {
+        title: string;
+        description?: string;
+    }): Brain<{}, object, TServices, undefined, undefined>;
+};
+//# sourceMappingURL=create-brain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-brain.d.ts","sourceRoot":"","sources":["../../../src/dsl/create-brain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrE,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;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAChC,SAAS,SAAS,MAAM,GAAG,EAAE,EAC7B,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EACzD,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,EAAE;IAE7C,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,WAAW,CACzB,SAAS,SAAS,MAAM,GAAG,EAAE,EAC7B,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EACzD,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,EAAE,EAC7C,MAAM,EAAE,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC;KAqB1C,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,SACzC,MAAM,YACH,CAAC,MAAM;eAlBV,MAAM;iBACJ,EAAE;eACJ,MAAM,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM;oBACjD,WAAW,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW;gBAC3E,eAAe;mBACZ,SAAS;kBACV,SAAS;cACb,SAAS;gBACP,YAAY;aACf,UAAU;iBASe,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;KAI9D,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,SACzC,MAAM,UACL,WAAW,CAAC,CAAC,CAAC;YAIF,MAAM;aAGL;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;EA6B/D"}

package/dist/types/dsl/definitions/blocks.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import type { ObjectGenerator } from '../../clients/types.js';
+import type { State, JsonObject, RuntimeEnv, AgentTool, AgentConfig } from '../types.js';
+import type { Resources } from '../../resources/resources.js';
+import type { PagesService } from '../pages.js';
+import type { GeneratedPage } from './brain-types.js';
+export type StepAction<TStateIn, TStateOut, TOptions extends JsonObject = JsonObject, TServices extends object = object, TResponseIn extends JsonObject | undefined = undefined, TWaitFor extends readonly any[] = readonly [], TResponseOut extends JsonObject | undefined = undefined, TPageIn extends GeneratedPage | undefined = undefined> = (params: {
+    state: TStateIn;
+    options: TOptions;
+    client: ObjectGenerator;
+    resources: Resources;
+    response: TResponseIn;
+    page: TPageIn;
+    pages?: PagesService;
+    env: RuntimeEnv;
+} & TServices) => TStateOut | Promise<TStateOut> | {
+    state: TStateOut;
+    waitFor: TWaitFor;
+} | Promise<{
+    state: TStateOut;
+    waitFor: TWaitFor;
+}> | {
+    state: TStateOut;
+    promptResponse: TResponseOut;
+} | Promise<{
+    state: TStateOut;
+    promptResponse: TResponseOut;
+}>;
+export type StepBlock<TStateIn, TStateOut, TOptions extends JsonObject = JsonObject, TServices extends object = object, TResponseIn extends JsonObject | undefined = undefined, TWebhooks extends readonly any[] = readonly [], TPageIn extends GeneratedPage | undefined = undefined> = {
+    type: 'step';
+    title: string;
+    action: StepAction<TStateIn, TStateOut, TOptions, TServices, TResponseIn, TWebhooks, JsonObject | undefined, TPageIn>;
+    /** If true, this is a UI generation step that requires components configuration */
+    isUIStep?: boolean;
+    /** Configuration for UI generation steps */
+    uiConfig?: {
+        template: (state: TStateIn, resources: Resources) => string | Promise<string>;
+        responseSchema?: z.ZodObject<any>;
+    };
+};
+export type BrainBlock<TOuterState, TInnerState extends State, TNewState, TOptions extends JsonObject = JsonObject, TServices extends object = object, TInnerBrain = any> = {
+    type: 'brain';
+    title: string;
+    innerBrain: TInnerBrain;
+    initialState: State | ((outerState: TOuterState) => State);
+    action: (outerState: TOuterState, innerState: TInnerState, services: TServices) => TNewState;
+};
+export type AgentBlock<TStateIn, TStateOut, TOptions extends JsonObject = JsonObject, TServices extends object = object, TResponseIn extends JsonObject | undefined = undefined, TTools extends Record<string, AgentTool> = Record<string, AgentTool>> = {
+    type: 'agent';
+    title: string;
+    configFn: (params: {
+        state: TStateIn;
+        options: TOptions;
+        client: ObjectGenerator;
+        resources: Resources;
+        response: TResponseIn;
+        pages?: PagesService;
+        env: RuntimeEnv;
+    } & TServices) => AgentConfig<TTools> | Promise<AgentConfig<TTools>>;
+};
+export type Block<TStateIn, TStateOut, TOptions extends JsonObject = JsonObject, TServices extends object = object, TResponseIn extends JsonObject | undefined = undefined, TWebhooks extends readonly any[] = readonly [], TPageIn extends GeneratedPage | undefined = undefined> = StepBlock<TStateIn, TStateOut, TOptions, TServices, TResponseIn, TWebhooks, TPageIn> | BrainBlock<TStateIn, any, TStateOut, TOptions, TServices> | AgentBlock<TStateIn, TStateOut, TOptions, TServices, TResponseIn>;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/types/dsl/definitions/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../../src/dsl/definitions/blocks.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import type { WebhookRegistration } from '../webhook.js';
+/**
+ * Page object available after a .ui() step.
+ * Contains URL to the page and a pre-configured webhook for form submissions.
+ *
+ * Usage:
+ * ```typescript
+ * .ui('Create Form', { template: ..., responseSchema: z.object({ name: z.string() }) })
+ * .step('Notify', async ({ page, slack }) => {
+ *   await slack.post(`Fill out the form: ${page.url}`);
+ *   return { state, waitFor: [page.webhook] };
+ * })
+ * .step('Process', ({ response }) => {
+ *   // response.name is typed from responseSchema
+ * })
+ * ```
+ */
+export type GeneratedPage<TSchema extends z.ZodSchema = z.ZodSchema> = {
+    /** URL where the generated page can be accessed */
+    url: string;
+    /** Pre-configured webhook for form submissions, typed based on responseSchema */
+    webhook: WebhookRegistration<TSchema>;
+};
+/**
+ * Configuration for creating a brain - either a simple string title
+ * or an object with title and optional description.
+ */
+export type BrainConfig = string | {
+    title: string;
+    description?: string;
+};
+//# sourceMappingURL=brain-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brain-types.d.ts","sourceRoot":"","sources":["../../../../src/dsl/definitions/brain-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI;IACrE,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/dsl/definitions/events.d.ts

@@ -0,0 +1,129 @@
+import type { BRAIN_EVENTS, STATUS } from '../constants.js';
+import type { JsonObject, JsonPatch } from '../types.js';
+import type { SerializedStepStatus } from './steps.js';
+import type { SerializedWebhookRegistration } from '../webhook.js';
+export type SerializedError = {
+    name: string;
+    message: string;
+    stack?: string;
+};
+interface BaseEvent<TOptions extends JsonObject = JsonObject> {
+    type: (typeof BRAIN_EVENTS)[keyof typeof BRAIN_EVENTS];
+    options: TOptions;
+    brainRunId: string;
+}
+interface BrainBaseEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    brainTitle: string;
+    brainDescription?: string;
+}
+export interface BrainStartEvent<TOptions extends JsonObject = JsonObject> extends BrainBaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.START | typeof BRAIN_EVENTS.RESTART;
+    initialState?: object;
+    status: typeof STATUS.RUNNING;
+}
+export interface BrainCompleteEvent<TOptions extends JsonObject = JsonObject> extends BrainBaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.COMPLETE;
+    status: typeof STATUS.COMPLETE;
+}
+export interface BrainErrorEvent<TOptions extends JsonObject = JsonObject> extends BrainBaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.ERROR;
+    status: typeof STATUS.ERROR;
+    error: SerializedError;
+}
+export interface BrainCancelledEvent<TOptions extends JsonObject = JsonObject> extends BrainBaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.CANCELLED;
+    status: typeof STATUS.CANCELLED;
+}
+export interface StepStatusEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.STEP_STATUS;
+    steps: SerializedStepStatus[];
+}
+export interface StepStartedEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.STEP_START;
+    status: typeof STATUS.RUNNING;
+    stepTitle: string;
+    stepId: string;
+}
+export interface StepCompletedEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.STEP_COMPLETE;
+    status: typeof STATUS.RUNNING;
+    stepTitle: string;
+    stepId: string;
+    patch: JsonPatch;
+}
+export interface StepRetryEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.STEP_RETRY;
+    stepTitle: string;
+    stepId: string;
+    error: SerializedError;
+    attempt: number;
+}
+export interface WebhookEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.WEBHOOK;
+    waitFor: SerializedWebhookRegistration[];
+}
+export interface AgentStartEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.AGENT_START;
+    stepTitle: string;
+    stepId: string;
+    prompt: string;
+    system?: string;
+}
+export interface AgentIterationEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.AGENT_ITERATION;
+    stepTitle: string;
+    stepId: string;
+    iteration: number;
+}
+export interface AgentToolCallEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.AGENT_TOOL_CALL;
+    stepTitle: string;
+    stepId: string;
+    toolName: string;
+    toolCallId: string;
+    input: JsonObject;
+}
+export interface AgentToolResultEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.AGENT_TOOL_RESULT;
+    stepTitle: string;
+    stepId: string;
+    toolName: string;
+    toolCallId: string;
+    result: unknown;
+}
+export interface AgentAssistantMessageEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.AGENT_ASSISTANT_MESSAGE;
+    stepTitle: string;
+    stepId: string;
+    content: string;
+}
+export interface AgentCompleteEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.AGENT_COMPLETE;
+    stepTitle: string;
+    stepId: string;
+    terminalToolName: string;
+    result: JsonObject;
+    totalIterations: number;
+}
+export interface AgentTokenLimitEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.AGENT_TOKEN_LIMIT;
+    stepTitle: string;
+    stepId: string;
+    totalTokens: number;
+    maxTokens: number;
+}
+export interface AgentWebhookEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.AGENT_WEBHOOK;
+    stepTitle: string;
+    stepId: string;
+    toolCallId: string;
+    toolName: string;
+    input: JsonObject;
+}
+export interface WebhookResponseEvent<TOptions extends JsonObject = JsonObject> extends BaseEvent<TOptions> {
+    type: typeof BRAIN_EVENTS.WEBHOOK_RESPONSE;
+    response: JsonObject;
+}
+export type BrainEvent<TOptions extends JsonObject = JsonObject> = BrainStartEvent<TOptions> | BrainCompleteEvent<TOptions> | BrainErrorEvent<TOptions> | BrainCancelledEvent<TOptions> | StepStatusEvent<TOptions> | StepStartedEvent<TOptions> | StepCompletedEvent<TOptions> | StepRetryEvent<TOptions> | WebhookEvent<TOptions> | WebhookResponseEvent<TOptions> | AgentStartEvent<TOptions> | AgentIterationEvent<TOptions> | AgentToolCallEvent<TOptions> | AgentToolResultEvent<TOptions> | AgentAssistantMessageEvent<TOptions> | AgentCompleteEvent<TOptions> | AgentTokenLimitEvent<TOptions> | AgentWebhookEvent<TOptions>;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/types/dsl/definitions/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/dsl/definitions/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAEnE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF,UAAU,SAAS,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU;IAC1D,IAAI,EAAE,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;IACvD,OAAO,EAAE,QAAQ,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,UAAU,cAAc,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC/D,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACvE,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAChC,IAAI,EAAE,OAAO,YAAY,CAAC,KAAK,GAAG,OAAO,YAAY,CAAC,OAAO,CAAC;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC1E,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAChC,IAAI,EAAE,OAAO,YAAY,CAAC,QAAQ,CAAC;IACnC,MAAM,EAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;CAChC;AAED,MAAM,WAAW,eAAe,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACvE,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAChC,IAAI,EAAE,OAAO,YAAY,CAAC,KAAK,CAAC;IAChC,MAAM,EAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAC5B,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC3E,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAChC,IAAI,EAAE,OAAO,YAAY,CAAC,SAAS,CAAC;IACpC,MAAM,EAAE,OAAO,MAAM,CAAC,SAAS,CAAC;CACjC;AAGD,MAAM,WAAW,eAAe,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACvE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,WAAW,CAAC;IACtC,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAGD,MAAM,WAAW,gBAAgB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACxE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,UAAU,CAAC;IACrC,MAAM,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC1E,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,aAAa,CAAC;IACxC,MAAM,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,cAAc,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACtE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,UAAU,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,YAAY,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACpE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,OAAO,CAAC;IAClC,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAGD,MAAM,WAAW,eAAe,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACvE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,WAAW,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC3E,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,eAAe,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC1E,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,eAAe,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC5E,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,iBAAiB,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B,CACzC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACxC,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,uBAAuB,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC1E,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,cAAc,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC5E,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,iBAAiB,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACzE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,aAAa,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CAC5E,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3B,IAAI,EAAE,OAAO,YAAY,CAAC,gBAAgB,CAAC;IAC3C,QAAQ,EAAE,UAAU,CAAC;CACtB;AAGD,MAAM,MAAM,UAAU,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,IAC3D,eAAe,CAAC,QAAQ,CAAC,GACzB,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,eAAe,CAAC,QAAQ,CAAC,GACzB,mBAAmB,CAAC,QAAQ,CAAC,GAC7B,eAAe,CAAC,QAAQ,CAAC,GACzB,gBAAgB,CAAC,QAAQ,CAAC,GAC1B,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,cAAc,CAAC,QAAQ,CAAC,GACxB,YAAY,CAAC,QAAQ,CAAC,GACtB,oBAAoB,CAAC,QAAQ,CAAC,GAC9B,eAAe,CAAC,QAAQ,CAAC,GACzB,mBAAmB,CAAC,QAAQ,CAAC,GAC7B,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,oBAAoB,CAAC,QAAQ,CAAC,GAC9B,0BAA0B,CAAC,QAAQ,CAAC,GACpC,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,oBAAoB,CAAC,QAAQ,CAAC,GAC9B,iBAAiB,CAAC,QAAQ,CAAC,CAAC"}

package/dist/types/dsl/definitions/run-params.d.ts

@@ -0,0 +1,26 @@
+import type { ObjectGenerator } from '../../clients/types.js';
+import type { State, JsonObject, RuntimeEnv } from '../types.js';
+import type { Resources } from '../../resources/resources.js';
+import type { PagesService } from '../pages.js';
+import type { SerializedStep } from './steps.js';
+import type { AgentResumeContext } from '../agent-messages.js';
+export interface BaseRunParams<TOptions extends JsonObject = JsonObject> {
+    client: ObjectGenerator;
+    resources?: Resources;
+    options?: TOptions;
+    pages?: PagesService;
+    env?: RuntimeEnv;
+}
+export interface InitialRunParams<TOptions extends JsonObject = JsonObject> extends BaseRunParams<TOptions> {
+    initialState?: State;
+    initialCompletedSteps?: never;
+    brainRunId?: string;
+}
+export interface RerunParams<TOptions extends JsonObject = JsonObject> extends BaseRunParams<TOptions> {
+    initialState: State;
+    initialCompletedSteps: SerializedStep[];
+    brainRunId: string;
+    response?: JsonObject;
+    agentResumeContext?: AgentResumeContext | null;
+}
+//# sourceMappingURL=run-params.d.ts.map

package/dist/types/dsl/definitions/run-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-params.d.ts","sourceRoot":"","sources":["../../../../src/dsl/definitions/run-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU;IACrE,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACxE,SAAQ,aAAa,CAAC,QAAQ,CAAC;IAC/B,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,qBAAqB,CAAC,EAAE,KAAK,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,UAAU,GAAG,UAAU,CACnE,SAAQ,aAAa,CAAC,QAAQ,CAAC;IAC/B,YAAY,EAAE,KAAK,CAAC;IACpB,qBAAqB,EAAE,cAAc,EAAE,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAChD"}

package/dist/types/dsl/definitions/steps.d.ts

@@ -0,0 +1,20 @@
+import type { STATUS } from '../constants.js';
+import type { JsonPatch } from '../types.js';
+export interface SerializedStep {
+    title: string;
+    status: (typeof STATUS)[keyof typeof STATUS];
+    id: string;
+    patch?: JsonPatch;
+    innerSteps?: SerializedStep[];
+}
+export type SerializedStepStatus = Omit<SerializedStep, 'patch'>;
+export interface BrainStructure {
+    title: string;
+    description?: string;
+    steps: Array<{
+        type: 'step' | 'brain' | 'agent';
+        title: string;
+        innerBrain?: BrainStructure;
+    }>;
+}
+//# sourceMappingURL=steps.d.ts.map

package/dist/types/dsl/definitions/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../../src/dsl/definitions/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAGD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AAGjE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,cAAc,CAAC;KAC7B,CAAC,CAAC;CACJ"}

package/dist/types/dsl/example-webhook.d.ts

@@ -30,6 +30,6 @@ declare const myBrain: import("./brain.js").Brain<import("./types.js").JsonObjec
 } | {
     emailSubject: string;
     cool: string;
-}, object, never>;
+}, object, never, undefined>;
 export default myBrain;
 //# sourceMappingURL=example-webhook.d.ts.map

package/dist/types/dsl/example-webhook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example-webhook.d.ts","sourceRoot":"","sources":["../../../src/dsl/example-webhook.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,YAAY;;;;;;;;;GAiBxB,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;GAmBxB,CAAC;AAEF,QAAA,MAAM,OAAO;;;;;;;;iBAsBT,CAAC;AAEL,eAAe,OAAO,CAAC"}
+{"version":3,"file":"example-webhook.d.ts","sourceRoot":"","sources":["../../../src/dsl/example-webhook.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,YAAY;;;;;;;;;GAiBxB,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;GAmBxB,CAAC;AAEF,QAAA,MAAM,OAAO;;;;;;;;4BAsBT,CAAC;AAEL,eAAe,OAAO,CAAC"}

package/dist/types/dsl/execution/constants.d.ts

@@ -0,0 +1,16 @@
+import type { RuntimeEnv } from '../types.js';
+/**
+ * Default runtime environment used when env is not provided.
+ * This ensures backward compatibility with existing code.
+ */
+export declare const DEFAULT_ENV: RuntimeEnv;
+/**
+ * Default system prompt prepended to all agent steps.
+ * Explains tool execution quirks to the LLM.
+ */
+export declare const DEFAULT_AGENT_SYSTEM_PROMPT = "## Tool Execution Behavior\n- Tools are executed sequentially in the order you call them\n- If a tool triggers a webhook (e.g., human approval), remaining tools in your response will NOT execute - you'll need to call them again after resuming\n- When waiting on multiple webhooks (e.g., Slack + email), the first webhook response received will resume execution\n- Terminal tools end the agent immediately - no further tools or iterations will run\n\n## Resumption Context\nWhen resuming after a webhook response, that response appears as the tool result in your conversation history.";
+/**
+ * Maximum number of retries for step execution.
+ */
+export declare const MAX_RETRIES = 1;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/dsl/execution/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/dsl/execution/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,UAGzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,4kBAOuE,CAAC;AAEhH;;GAEG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC"}

package/dist/types/dsl/execution/event-stream.d.ts

@@ -0,0 +1,44 @@
+import type { State, JsonObject, AgentTool } from '../types.js';
+import type { UIComponent } from '../../ui/types.js';
+import type { BrainEvent } from '../definitions/events.js';
+import type { Block } from '../definitions/blocks.js';
+import type { InitialRunParams, RerunParams } from '../definitions/run-params.js';
+export declare class BrainEventStream<TOptions extends JsonObject = JsonObject, TState extends State = object, TServices extends object = object> {
+    private currentState;
+    private steps;
+    private currentStepIndex;
+    private initialState;
+    private brainRunId;
+    private title;
+    private description?;
+    private client;
+    private options;
+    private services;
+    private resources;
+    private pages?;
+    private env;
+    private currentResponse;
+    private currentPage;
+    private agentResumeContext;
+    private initialCompletedSteps?;
+    private components?;
+    private defaultTools?;
+    constructor(params: (InitialRunParams<TOptions> | RerunParams<TOptions>) & {
+        title: string;
+        description?: string;
+        blocks: Block<any, any, TOptions, TServices, any, any, any>[];
+        services: TServices;
+        components?: Record<string, UIComponent<any>>;
+        defaultTools?: Record<string, AgentTool>;
+    });
+    next(): AsyncGenerator<BrainEvent<TOptions>>;
+    private executeStep;
+    private executeAgent;
+    /**
+     * Execute a UI generation step.
+     * Generates UI components, renders to HTML, creates page, and sets up webhook.
+     */
+    private executeUIStep;
+    private completeStep;
+}
+//# sourceMappingURL=event-stream.d.ts.map

package/dist/types/dsl/execution/event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-stream.d.ts","sourceRoot":"","sources":["../../../../src/dsl/execution/event-stream.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAc,SAAS,EAAiC,MAAM,aAAa,CAAC;AAO3G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,KAAK,EAAqC,MAAM,0BAA0B,CAAC;AAEzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAOlF,qBAAa,gBAAgB,CAC3B,QAAQ,SAAS,UAAU,GAAG,UAAU,EACxC,MAAM,SAAS,KAAK,GAAG,MAAM,EAC7B,SAAS,SAAS,MAAM,GAAG,MAAM;IAEjC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAe;IAC7B,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,kBAAkB,CAAoD;IAC9E,OAAO,CAAC,qBAAqB,CAAC,CAAmB;IACjD,OAAO,CAAC,UAAU,CAAC,CAAmC;IACtD,OAAO,CAAC,YAAY,CAAC,CAA4B;gBAG/C,MAAM,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG;QAC7D,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAC9D,QAAQ,EAAE,SAAS,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;KAC1C;IA8EI,IAAI,IAAI,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAgIpC,WAAW;YAwLX,YAAY;IAsQ3B;;;OAGG;YACY,aAAa;IAyF5B,OAAO,CAAE,YAAY;CAoBtB"}

package/dist/types/dsl/execution/retry.d.ts

@@ -0,0 +1,30 @@
+import type { RetryConfig } from '../types.js';
+/**
+ * Simple sleep helper that returns a promise resolving after the specified delay.
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+/**
+ * Simple semaphore for limiting concurrent operations.
+ * Used internally by batch prompt execution.
+ */
+export declare class Semaphore {
+    private readonly max;
+    private current;
+    private queue;
+    constructor(max: number);
+    acquire(): Promise<void>;
+    release(): void;
+}
+/**
+ * Normalize retry config with defaults.
+ */
+export declare function normalizeRetryConfig(config?: RetryConfig): Required<RetryConfig>;
+/**
+ * Calculate backoff delay based on attempt number and config.
+ */
+export declare function calculateBackoff(attempt: number, config: Required<RetryConfig>): number;
+/**
+ * Execute a function with retry and exponential backoff.
+ */
+export declare function executeWithRetry<T>(fn: () => Promise<T>, config: Required<RetryConfig>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/types/dsl/execution/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../../src/dsl/execution/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACI,CAAC;AAEpD;;;GAGG;AACH,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAsB;gBAEN,GAAG,EAAE,MAAM;IAElC,OAAO;IAQb,OAAO;CAQR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAOhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,UAS9E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,cAkB9B"}

package/dist/types/dsl/types.d.ts

@@ -6,7 +6,14 @@ export type JsonObject = {
     [Key in string]?: JsonValue;
 };
 export type JsonValue = JsonPrimitive | JsonArray | JsonObject;
-export type State = JsonObject;
+/**
+ * State represents the shape of brain state through its execution.
+ * Using `object` instead of `JsonObject` to allow TypeScript interfaces
+ * (which don't have implicit index signatures) as state values.
+ * The JSON patch system operates on runtime values, so the type constraint
+ * is primarily for compile-time ergonomics.
+ */
+export type State = object;
 /**
  * Secrets/environment variables available to brains at runtime.
  * This interface is augmented via module declaration in generated secrets.d.ts
@@ -43,14 +50,14 @@ export type JsonPatch = {
  * Return type for tools that need to suspend execution and wait for an external event.
  * Supports single webhook or array of webhooks (first response wins).
  */
-export interface LoopToolWaitFor {
+export interface AgentToolWaitFor {
     waitFor: WebhookRegistration<z.ZodSchema> | WebhookRegistration<z.ZodSchema>[];
 }
 /**
- * A tool definition for use in loop steps.
+ * A tool definition for use in agent steps.
  * Compatible with Vercel AI SDK tool format, extended with Positronic-specific properties.
  */
-export interface LoopTool<TInput extends z.ZodSchema = z.ZodSchema> {
+export interface AgentTool<TInput extends z.ZodSchema = z.ZodSchema> {
     /** Description of what this tool does, helps the LLM understand when to use it */
     description: string;
     /** Zod schema defining the input parameters for this tool */
@@ -60,30 +67,30 @@ export interface LoopTool<TInput extends z.ZodSchema = z.ZodSchema> {
      * Can return a result directly, or { waitFor: webhook(...) } to suspend execution.
      * Not required for terminal tools.
      */
-    execute?: (input: z.infer<TInput>) => Promise<unknown | LoopToolWaitFor> | unknown | LoopToolWaitFor;
+    execute?: (input: z.infer<TInput>) => Promise<unknown | AgentToolWaitFor> | unknown | AgentToolWaitFor;
     /**
-     * If true, calling this tool ends the loop.
-     * The tool's input becomes the loop result (merged into state).
+     * If true, calling this tool ends the agent.
+     * The tool's input becomes the agent result (merged into state).
      */
     terminal?: boolean;
 }
 /**
- * Configuration for a loop step.
+ * Configuration for an agent step.
  */
-export interface LoopConfig<TTools extends Record<string, LoopTool> = Record<string, LoopTool>> {
+export interface AgentConfig<TTools extends Record<string, AgentTool> = Record<string, AgentTool>> {
     /** System prompt for the LLM */
     system?: string;
     /** Initial user prompt to start the conversation */
     prompt: string;
-    /** Tools available to the LLM */
-    tools: TTools;
+    /** Tools available to the LLM. Optional - merged with withTools defaults */
+    tools?: TTools;
     /** Safety valve - exit if cumulative tokens exceed this limit */
     maxTokens?: number;
 }
 /**
- * Represents a single message in the loop conversation.
+ * Represents a single message in the agent conversation.
  */
-export interface LoopMessage {
+export interface AgentMessage {
     role: 'user' | 'assistant' | 'tool';
     content: string;
     /** For tool messages, the ID of the tool call this is responding to */
@@ -95,10 +102,24 @@ export interface LoopMessage {
  * Helper type to extract the terminal tool's input type from a tools object.
  * Used for typing the result that gets merged into state.
  */
-export type ExtractTerminalInput<TTools extends Record<string, LoopTool>> = {
+export type ExtractTerminalInput<TTools extends Record<string, AgentTool>> = {
     [K in keyof TTools]: TTools[K] extends {
         terminal: true;
         inputSchema: infer S;
     } ? S extends z.ZodSchema ? z.infer<S> : never : never;
 }[keyof TTools];
+/**
+ * Configuration for retry behavior with exponential backoff.
+ * Used by batch prompt execution.
+ */
+export interface RetryConfig {
+    /** Maximum retry attempts per item. Default: 3 */
+    maxRetries?: number;
+    /** Backoff strategy. Default: 'exponential' */
+    backoff?: 'none' | 'linear' | 'exponential';
+    /** Initial delay in ms before first retry. Default: 1000 */
+    initialDelay?: number;
+    /** Maximum delay in ms between retries. Default: 30000 */
+    maxDelay?: number;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/dsl/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AACpC,MAAM,MAAM,UAAU,GAAG;KAAG,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,SAAS;CAAE,CAAC;AACzD,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;CAEvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,EAAE,CAAC;AAIJ;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;CAChF;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,MAAM,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;IAChE,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KACnB,OAAO,CAAC,OAAO,GAAG,eAAe,CAAC,GAAG,OAAO,GAAG,eAAe,CAAC;IACpE;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;IAElE,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI;KACzE,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC,CAAA;KAAE,GAC3E,CAAC,SAAS,CAAC,CAAC,SAAS,GACnB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GACV,KAAK,GACP,KAAK;CACV,CAAC,MAAM,MAAM,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/dsl/types.ts"],"names":[],"mappings":"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"}