zidane 1.5.0 → 1.6.0

package/README.md

@@ -35,11 +35,12 @@ All options on `createAgent`:
 createAgent({
   provider,                          // required: LLM provider
   harness: basic,                    // tool set (default: noTools)
-  enableTools: true,                 // false for pure chat mode
-  toolExecution: 'sequential',       // or 'parallel'
-  maxTurns: 50,                      // max loop iterations
-  maxTokens: 16384,                  // max tokens per LLM response
-  thinkingBudget: 10240,             // exact thinking token budget
+  behavior: {                        // agent-level defaults
+    toolExecution: 'sequential',     // or 'parallel'
+    maxTurns: 50,                    // max loop iterations
+    maxTokens: 16384,               // max tokens per LLM response
+    thinkingBudget: 10240,          // exact thinking token budget
+  },
   execution: createProcessContext(), // where tools run
   mcpServers: [],                    // MCP tool servers
   session,                           // session for persistence
@@ -51,19 +52,22 @@ All options on `agent.run()`:
 
 ```ts
 await agent.run({
-  prompt: 'your task',     // required
+  prompt: 'your task',       // required
   model: 'claude-opus-4-6',
   system: 'be concise',
-  thinking: 'medium',      // off | minimal | low | medium | high
-  thinkingBudget: 8192,    // overrides level-based default
-  maxTurns: 10,            // overrides agent-level default
-  maxTokens: 4096,         // overrides agent-level default
-  images: [],              // base64 images
+  thinking: 'medium',        // off | minimal | low | medium | high
+  behavior: {                // per-run overrides
+    maxTurns: 10,
+    maxTokens: 4096,
+    thinkingBudget: 8192,
+  },
+  tools: {},                 // override tools for this run ({} = no tools)
+  images: [],                // base64 images
   signal: abortController.signal,
 })
 ```
 
-Per-run options override agent-level defaults. Agent-level defaults override hardcoded defaults.
+Precedence: `run.behavior` > `agent.behavior` > `harness.behavior` > hardcoded defaults.
 
 ## CLI
 
@@ -139,10 +143,10 @@ const harness = defineHarness({
 })
 ```
 
-For pure chat with no tools:
+For pure chat with no tools, pass `tools: {}` on a specific run or use the `noTools` harness:
 
 ```ts
-const agent = createAgent({ provider, enableTools: false })
+await agent.run({ prompt: 'just chat', tools: {} })
 ```
 
 ## Thinking