saico 2.7.0 → 2.7.1

package/README.md

@@ -69,14 +69,15 @@ Saico separates construction from activation:
 const agent = new Saico({
     name: 'agent',
     prompt: 'System prompt here',
+    createQ: true,  // message Q created on activate()
     dynamodb: { region: 'us-east-1', credentials: { accessKeyId: 'AK', secretAccessKey: 'SK' } },
 });
 
 // DB methods work before activation
 const item = await agent.dbGetItem('id', '123');
 
-// 2. Activate — creates internal task + optional message queue context
-agent.activate({ createQ: true });
+// 2. Activate — creates internal task + message Q (from this.createQ)
+agent.activate();
 
 // 3. Use — send messages, spawn children
 await agent.sendMessage('Do something');
@@ -86,6 +87,23 @@ await agent.recvChatMessage('User says hello');
 await agent.deactivate();
 ```
 
+Subclasses can also define `this.states` (task functions) in the constructor — `activate()` picks them up automatically:
+
+```js
+class MyAgent extends Saico {
+    constructor() {
+        super({ name: 'agent', prompt: 'You are helpful', createQ: true });
+        this.states = [
+            async function main() {
+                return await this.sendMessage('Starting...');
+            }
+        ];
+    }
+}
+const agent = new MyAgent();
+agent.activate();  // no params needed — uses this.createQ and this.states
+```
+
 ### Message Orchestration
 
 When `sendMessage()` or `recvChatMessage()` is called, Saico walks the parent chain to build the full LLM payload:
@@ -177,6 +195,7 @@ new Saico({
     // AI config
     prompt: 'System prompt',
     functions: [],             // OpenAI function definitions
+    createQ: false,            // Create message Q on activate() (also settable as this.createQ)
 
     // Behavior
     isolate: false,            // Stop ancestor aggregation
@@ -207,9 +226,9 @@ new Saico({
 
 ```js
 agent.activate({
-    createQ: true,             // Create message queue context
+    createQ: true,             // Override this.createQ for this activation
     prompt: 'Extra prompt',    // Appended to class-level prompt
-    states: [],                // Task state functions
+    states: [],                // Override this.states for this activation
     taskId: 'custom-id',
     sequential_mode: true,     // Process messages sequentially
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saico",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "main": "index.js",
   "type": "commonjs",
   "description": "Hierarchical AI Conversation Orchestrator - Task hierarchy with conversation contexts",

package/saico.js

@@ -37,6 +37,7 @@ class Saico {
      * @param {Array} [opt.functions] - Available AI functions
      * @param {string} [opt.key] - Redis key override (default: 'saico:<id>')
      * @param {boolean} [opt.redis=true] - Set false to skip Redis proxy
+     * @param {boolean} [opt.createQ] - Create message Q context on activate()
      * @param {boolean} [opt.isolate] - Isolate: don't aggregate from ancestors
      * @param {Object} [opt.dynamodb] - DynamoDB config { region, credentials: { accessKeyId, secretAccessKey }, client }
      * @param {Object} [opt.db] - Pluggable DB backend
@@ -60,6 +61,7 @@ class Saico {
         this.name = opt.name || this.constructor.name || 'saico';
         this.prompt = opt.prompt || '';
         this.functions = opt.functions || null;
+        this.createQ = opt.createQ || false;
 
         // Absorbed from Sid
         this.userData = opt.userData || {};
@@ -99,10 +101,10 @@ class Saico {
      * Create the internal Itask and optionally a message Q context.
      *
      * @param {Object} opts
-     * @param {boolean} [opts.createQ] - If true, attach a message Q (Context)
+     * @param {boolean} [opts.createQ] - Override this.createQ for this activation
      * @param {string} [opts.prompt] - Additional prompt (appended to class-level)
      * @param {Array} [opts.functions] - Override functions
-     * @param {Array} [opts.states] - Task state functions
+     * @param {Array} [opts.states] - Override this.states for this activation
      * @param {string} [opts.taskId] - Custom task ID
      * @param {number} [opts.token_limit] - Token limit for context
      * @param {number} [opts.max_depth] - Max tool call depth
@@ -119,7 +121,7 @@ class Saico {
         if (this._task)
             throw new Error('Already activated. Call deactivate() first.');
 
-        const states = opts.states || [];
+        const states = opts.states || this.states || [];
 
         // Build effective prompt: class-level + activation-level
         const effectivePrompt = [this.prompt, opts.prompt].filter(Boolean).join('\n');
@@ -136,8 +138,8 @@ class Saico {
         // Store Saico reference on task for parent chain traversal
         this._task._saico = this;
 
-        // Create message Q context if requested (only via createQ flag, NOT prompt)
-        if (opts.createQ) {
+        // Create message Q context if requested (class-level or activate-level)
+        if (opts.createQ ?? this.createQ) {
             const functions = opts.functions || this.functions;
             const contextConfig = {
                 tag: opts.tag || this._task.id,