added hooks type for eve

[prakriti-solankey]

This pull request introduces "hooks mode" as a new, fourth integration mode for the NAMS AI provider, enabling runtime-controlled, deterministic session memory. The documentation has been updated throughout to reflect this new mode, clarify how entity extraction works, and provide examples for all four integration modes. Two new example scripts demonstrate hooks mode and mode switching. The codebase has also been updated to support and document the new mode.

The most important changes are:

New Feature: Hooks Mode

• Added hooks mode to NAMS, allowing the runtime (not the LLM) to restore and persist the session transcript around every generation for deterministic, production-grade memory. This includes new APIs (createNams(...).hooks(scope?)) and extensive documentation and examples
  Documentation Updates
• Updated the README to describe all four integration modes (provider, middleware, tools, hooks), including a new section on hooks mode, its recommended use cases, and how it differs from tools mode

Examples

• Added examples/hooks-chat.ts to demonstrate hooks mode in practice.
• Added examples/mode-switch-chat.ts to show how to switch between all four modes at deploy time, with a shared memory backend.

Test and Build Updates

• Updated test instructions and scripts to include the new hooks mode.

API and Type Changes

• Updated types and exports to include hooks mode and its options, and to clarify the scope of entity extraction.

These changes provide a more flexible, production-ready memory integration for AI agents, with clear guidance and examples for each mode.

[rafaljanicki]

It'd be good to support more advanced hooks e.g. like Claude has them