zidane 1.6.8 → 1.6.9

package/README.md

@@ -225,36 +225,37 @@ agent.hooks.hook('stream:thinking', (ctx) => {
 
 ### Tool execution
 
-```ts
-agent.hooks.hook('tool:before', (ctx) => { /* ctx.name, ctx.input */ })
-agent.hooks.hook('tool:after', (ctx) => { /* ctx.name, ctx.input, ctx.result */ })
-agent.hooks.hook('tool:error', (ctx) => { /* ctx.name, ctx.input, ctx.error */ })
-```
-
-### Tool gate
-
-Block a tool from running:
+All tool hooks include `turnId` and `callId` for correlation. Typed via `ToolHookContext`.
 
 ```ts
 agent.hooks.hook('tool:gate', (ctx) => {
+  // ctx.turnId, ctx.callId, ctx.name, ctx.input
   if (ctx.name === 'shell' && String(ctx.input.command).includes('rm -rf')) {
     ctx.block = true
     ctx.reason = 'dangerous command'
   }
 })
-```
-
-### Tool transform
-
-Modify tool output before it's sent back to the model:
 
-```ts
+agent.hooks.hook('tool:before', (ctx) => { /* ctx.turnId, ctx.callId, ctx.name, ctx.input */ })
+agent.hooks.hook('tool:after', (ctx) => { /* + ctx.result */ })
+agent.hooks.hook('tool:error', (ctx) => { /* + ctx.error */ })
 agent.hooks.hook('tool:transform', (ctx) => {
+  // + ctx.result, ctx.isError — mutate to modify output
   if (ctx.result.length > 5000)
     ctx.result = ctx.result.slice(0, 5000) + '\n... (truncated)'
 })
 ```
 
+MCP tool hooks mirror the same pattern with `server` and `tool` fields. Typed via `McpToolHookContext`.
+
+```ts
+agent.hooks.hook('mcp:tool:gate', (ctx) => { /* ctx.turnId, ctx.callId, ctx.server, ctx.tool, ctx.input, ctx.block, ctx.reason */ })
+agent.hooks.hook('mcp:tool:before', (ctx) => { /* ctx.turnId, ctx.callId, ctx.server, ctx.tool, ctx.input */ })
+agent.hooks.hook('mcp:tool:after', (ctx) => { /* + ctx.result */ })
+agent.hooks.hook('mcp:tool:transform', (ctx) => { /* + ctx.result — mutate to modify */ })
+agent.hooks.hook('mcp:tool:error', (ctx) => { /* + ctx.error */ })
+```
+
 ### Context transform
 
 Prune messages before each LLM call:
@@ -581,6 +582,9 @@ All types are available from `zidane/types`:
 
 ```ts
 import type { Agent, SessionTurn, TurnUsage, Provider, ToolDef } from 'zidane/types'
+
+// Hook context types for typed event handlers
+import type { ToolHookContext, McpToolHookContext, SessionHookContext, StreamHookContext } from 'zidane/types'
 ```
 
 ## Testing
@@ -589,7 +593,7 @@ import type { Agent, SessionTurn, TurnUsage, Provider, ToolDef } from 'zidane/ty
 bun test
 ```
 
-484+ tests with mock provider and execution context. No API keys or Docker needed.
+489+ tests with mock provider and execution context. No API keys or Docker needed.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zidane",
-  "version": "1.6.8",
+  "version": "1.6.9",
   "description": "an agent that goes straight to the goal",
   "type": "module",
   "private": false,