Shared from "Claude-Code" on Inkdown
What happens after the AI finishes a response.
query/stopHooks.ts runs after every AI turn completes. It's the post-turn pipeline that triggers background tasks, checks for hook conditions, and decides whether to continue.
Run when the model stops (no more tool_use blocks):
Stop hooks are used for:
Fire when a task completes:
Fire when a teammate agent has been idle:
After hooks, several background tasks are triggered (non-blocking):
When a stop hook requests a retry:
This allows the hook to inject additional messages or context and re-query the model.
Hooks are configured via Zod schemas (schemas/hooks.ts):
Patterns for triggering hooks:
schemas/hooks.ts)Extracted Zod schemas to break import cycles:
| File | Purpose |
|---|---|
src/query/stopHooks.ts | Post-turn hook execution |
src/query/config.ts | Query config snapshot |
src/query/deps.ts | Dependency injection |
src/query/tokenBudget.ts | Token budget tracking |
src/schemas/hooks.ts | Zod hook schemas |