@positronic/core 0.0.55 → 0.0.57

package/dist/src/dsl/builder/brain.js

@@ -388,6 +388,7 @@ export var Brain = /*#__PURE__*/ function() {
         _define_property(this, "optionsSchema", void 0);
         _define_property(this, "components", void 0);
         _define_property(this, "defaultTools", void 0);
+        _define_property(this, "memoryProvider", void 0);
         this.title = title;
         this.description = description;
         this.blocks = [];
@@ -435,6 +436,7 @@ export var Brain = /*#__PURE__*/ function() {
                 nextBrain.optionsSchema = this.optionsSchema;
                 nextBrain.components = this.components;
                 nextBrain.defaultTools = this.defaultTools;
+                nextBrain.memoryProvider = this.memoryProvider;
                 return nextBrain;
             }
         },
@@ -446,6 +448,7 @@ export var Brain = /*#__PURE__*/ function() {
                 nextBrain.services = this.services;
                 nextBrain.components = this.components;
                 nextBrain.defaultTools = this.defaultTools;
+                nextBrain.memoryProvider = this.memoryProvider;
                 return nextBrain;
             }
         },
@@ -470,6 +473,7 @@ export var Brain = /*#__PURE__*/ function() {
                 nextBrain.services = this.services;
                 nextBrain.components = components;
                 nextBrain.defaultTools = this.defaultTools;
+                nextBrain.memoryProvider = this.memoryProvider;
                 return nextBrain;
             }
         },
@@ -500,6 +504,33 @@ export var Brain = /*#__PURE__*/ function() {
                 return next;
             }
         },
+        {
+            /**
+   * Configure a memory provider for this brain.
+   * When configured, steps receive a scoped memory instance in their context.
+   *
+   * @param provider - The memory provider to use
+   *
+   * @example
+   * ```typescript
+   * import { createMem0Provider } from '@positronic/mem0';
+   *
+   * const memory = createMem0Provider({ apiKey: process.env.MEM0_API_KEY });
+   *
+   * const myBrain = brain('my-brain')
+   *   .withMemory(memory)
+   *   .brain('agent', async ({ memory }) => {
+   *     const prefs = await memory.search('user preferences');
+   *     return { system: `User preferences: ${prefs}`, prompt: 'Help me' };
+   *   });
+   * ```
+   */ key: "withMemory",
+            value: function withMemory(provider) {
+                var next = this.nextBrain();
+                next.memoryProvider = provider;
+                return next;
+            }
+        },
         {
             key: "step",
             value: function step(title, action) {
@@ -876,7 +907,8 @@ export var Brain = /*#__PURE__*/ function() {
                                     options: validatedOptions,
                                     services: this.services,
                                     components: this.components,
-                                    defaultTools: this.defaultTools
+                                    defaultTools: this.defaultTools,
+                                    memoryProvider: this.memoryProvider
                                 }));
                                 return [
                                     5,
@@ -912,6 +944,8 @@ export var Brain = /*#__PURE__*/ function() {
                 nextBrain.components = this.components;
                 // Copy defaultTools to the next brain
                 nextBrain.defaultTools = this.defaultTools;
+                // Copy memoryProvider to the next brain
+                nextBrain.memoryProvider = this.memoryProvider;
                 return nextBrain;
             }
         }

package/dist/src/dsl/constants.js

@@ -1,5 +1,7 @@
 export var BRAIN_EVENTS = {
     START: 'brain:start',
+    // RESTART is deprecated - use START for all brain starts (fresh or resume)
+    // Kept temporarily for backwards compatibility during transition
     RESTART: 'brain:restart',
     STEP_START: 'step:start',
     STEP_COMPLETE: 'step:complete',
@@ -8,6 +10,8 @@ export var BRAIN_EVENTS = {
     ERROR: 'brain:error',
     COMPLETE: 'brain:complete',
     CANCELLED: 'brain:cancelled',
+    PAUSED: 'brain:paused',
+    RESUMED: 'brain:resumed',
     WEBHOOK: 'brain:webhook',
     WEBHOOK_RESPONSE: 'brain:webhook_response',
     // Agent step events
@@ -18,12 +22,20 @@ export var BRAIN_EVENTS = {
     AGENT_ASSISTANT_MESSAGE: 'agent:assistant_message',
     AGENT_COMPLETE: 'agent:complete',
     AGENT_TOKEN_LIMIT: 'agent:token_limit',
-    AGENT_WEBHOOK: 'agent:webhook'
+    AGENT_ITERATION_LIMIT: 'agent:iteration_limit',
+    AGENT_WEBHOOK: 'agent:webhook',
+    AGENT_RAW_RESPONSE_MESSAGE: 'agent:raw_response_message',
+    AGENT_USER_MESSAGE: 'agent:user_message'
 };
 export var STATUS = {
     PENDING: 'pending',
     RUNNING: 'running',
     COMPLETE: 'complete',
     ERROR: 'error',
-    CANCELLED: 'cancelled'
+    CANCELLED: 'cancelled',
+    WAITING: 'waiting',
+    PAUSED: 'paused',
+    // Internal status for tracking when execution is inside an agent loop.
+    // Publicly this maps to RUNNING for consumers.
+    AGENT_LOOP: 'agent_loop'
 };

package/dist/src/dsl/create-brain.js

@@ -41,7 +41,7 @@ import { brain as coreBrain } from './builder/brain.js';
  * }));
  * ```
  */ export function createBrain(config) {
-    var services = config.services, components = config.components, defaultTools = config.defaultTools;
+    var services = config.services, components = config.components, defaultTools = config.defaultTools, memory = config.memory;
     // Implementation
     function brain(titleOrConfig, agentConfig) {
         var base = coreBrain(titleOrConfig);
@@ -51,6 +51,9 @@ import { brain as coreBrain } from './builder/brain.js';
         if (defaultTools) {
             base = base.withTools(defaultTools);
         }
+        if (memory) {
+            base = base.withMemory(memory);
+        }
         if (services) {
             base = base.withServices(services);
         }

package/dist/src/dsl/execution/constants.js

@@ -7,8 +7,8 @@
 };
 /**
  * Default system prompt prepended to all agent steps.
- * Explains tool execution quirks to the LLM.
- */ export var 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.";
+ * Explains the headless nature of Positronic Brains.
+ */ export var DEFAULT_AGENT_SYSTEM_PROMPT = "## You Are a Positronic Brain\n\nYou are running as an automated agent in a headless workflow. This is NOT a chat interface - there is no user watching your text output.\n\n**To communicate with users, you MUST use tool calls.** Look at your available tools and use them to send messages, notifications, or create pages for user interaction.\n\n## Tool Execution\n- Tools execute sequentially in the order you call them\n- Webhook-triggering tools pause execution until the webhook fires\n- Terminal tools (like 'done') end the agent immediately\n\n## Resumption\nWhen resuming after a webhook, that response appears as the tool result in your conversation history.";
 /**
  * Maximum number of retries for step execution.
  */ export var MAX_RETRIES = 1;