# personaforge

> Fast TypeScript AI agent framework — per-request agents, 30+ model providers, 100+ integrations, 20+ vector DBs, 10+ databases, sessions, memory, knowledge, tracing, evals, HITL, teams, and workflows.

TypeScript AI agent framework. Start with one package, add features via tree-shakeable subpath imports. Each runbook below is operational: import, minimal use, verify, failures, rollback.

## Runbooks

- [Runbook: Adapter Redis](runbooks/adapter-redis.md): `personaforge/adapter-redis`
- [Runbook: Adapters](runbooks/adapters.md): `personaforge/adapters`
- [Runbook: Agentic](runbooks/agentic.md): `personaforge/agentic`
- [Runbook: Artifacts](runbooks/artifacts.md): `personaforge/artifacts`
- [Runbook: Background](runbooks/background.md): `personaforge/background`
- [Runbook: Checkpoint](runbooks/checkpoint.md): `personaforge/checkpoint`
- [Runbook: Cli](runbooks/cli.md): `personaforge/cli`
- [Runbook: Compression](runbooks/compression.md): `personaforge/compression`
- [Runbook: Config](runbooks/config.md): `personaforge/config`
- [Runbook: Context](runbooks/context.md): `personaforge/context`
- [Runbook: Contracts](runbooks/contracts.md): `personaforge/contracts`
- [Runbook: Control Plane](runbooks/control-plane.md): `personaforge/control-plane`
- [Runbook: Core](runbooks/core.md): `personaforge/core`
- [Runbook: Create Agent](runbooks/create-agent.md): `personaforge/create-agent`
- [Runbook: Db](runbooks/db.md): `personaforge/db`
- [Runbook: Dx](runbooks/dx.md): `personaforge/dx`
- [Runbook: Eval](runbooks/eval.md): `personaforge/eval`
- [Runbook: Execution](runbooks/execution.md): `personaforge/execution`
- [Runbook: Graph](runbooks/graph.md): `personaforge/graph`
- [Runbook: Guard](runbooks/guard.md): `personaforge/guard`
- [Runbook: Guardrails](runbooks/guardrails.md): `personaforge/guardrails`
- [Runbook: Framework Core](runbooks/index.md): `personaforge`
- [Runbook: Interfaces](runbooks/interfaces.md): `personaforge/interfaces`
- [Runbook: Knowledge](runbooks/knowledge.md): `personaforge/knowledge`
- [Runbook: Learning](runbooks/learning.md): `personaforge/learning`
- [Runbook: Lite](runbooks/lite.md): `personaforge/lite`
- [Runbook: Memory](runbooks/memory.md): `personaforge/memory`
- [Runbook: Model](runbooks/model.md): `personaforge/model`
- [Runbook: Models](runbooks/models.md): `personaforge/models`
- [Runbook: Observability](runbooks/observability.md): `personaforge/observability`
- [Runbook: Observe](runbooks/observe.md): `personaforge/observe`
- [Runbook: Orchestration](runbooks/orchestration.md): `personaforge/orchestration`
- [Runbook: Parsers](runbooks/parsers.md): `personaforge/parsers`
- [Runbook: Planner](runbooks/planner.md): `personaforge/planner`
- [Runbook: Playground](runbooks/playground.md): `personaforge/playground`
- [Runbook: Plugins](runbooks/plugins.md): `personaforge/plugins`
- [Runbook: Production](runbooks/production.md): `personaforge/production`
- [Runbook: Providers](runbooks/providers.md): `personaforge/providers`
- [Runbook: Reasoning](runbooks/reasoning.md): `personaforge/reasoning`
- [Runbook: Router](runbooks/router.md): `personaforge/router`
- [Runbook: Runnable](runbooks/runnable.md): `personaforge/runnable`
- [Runbook: Runtime](runbooks/runtime.md): `personaforge/runtime`
- [Runbook: Scheduler](runbooks/scheduler.md): `personaforge/scheduler`
- [Runbook: Sdk](runbooks/sdk.md): `personaforge/sdk`
- [Runbook: Serve](runbooks/serve.md): `personaforge/serve`
- [Runbook: Session](runbooks/session.md): `personaforge/session`
- [Runbook: Shared](runbooks/shared.md): `personaforge/shared`
- [Runbook: Simulation](runbooks/simulation.md): `personaforge/simulation`
- [Runbook: Skills](runbooks/skills.md): `personaforge/skills`
- [Runbook: Storage](runbooks/storage.md): `personaforge/storage`
- [Runbook: Streaming](runbooks/streaming.md): `personaforge/streaming`
- [Runbook: Structured](runbooks/structured.md): `personaforge/structured`
- [Runbook: Test](runbooks/test.md): `personaforge/test`
- [Runbook: Test Utils](runbooks/test-utils.md): `personaforge/test-utils`
- [Runbook: Test Utils: Conformance](runbooks/test-utils-conformance.md): `personaforge/test-utils/conformance`
- [Runbook: Testing](runbooks/testing.md): `personaforge/testing`
- [Runbook: Tool](runbooks/tool.md): `personaforge/tool`
- [Runbook: Toolkits](runbooks/toolkits.md): `personaforge/toolkits`
- [Runbook: Tools](runbooks/tools.md): `personaforge/tools`
- [Runbook: Tools: Ai](runbooks/tools-ai.md): `personaforge/tools/ai`
- [Runbook: Tools: Communication](runbooks/tools-communication.md): `personaforge/tools/communication`
- [Runbook: Tools: Core](runbooks/tools-core.md): `personaforge/tools/core`
- [Runbook: Tools: Crm](runbooks/tools-crm.md): `personaforge/tools/crm`
- [Runbook: Tools: Data](runbooks/tools-data.md): `personaforge/tools/data`
- [Runbook: Tools: Devtools](runbooks/tools-devtools.md): `personaforge/tools/devtools`
- [Runbook: Tools: Finance](runbooks/tools-finance.md): `personaforge/tools/finance`
- [Runbook: Tools: Mcp](runbooks/tools-mcp.md): `personaforge/tools/mcp`
- [Runbook: Tools: Media](runbooks/tools-media.md): `personaforge/tools/media`
- [Runbook: Tools: Memory](runbooks/tools-memory.md): `personaforge/tools/memory`
- [Runbook: Tools: Productivity](runbooks/tools-productivity.md): `personaforge/tools/productivity`
- [Runbook: Tools: Scraping](runbooks/tools-scraping.md): `personaforge/tools/scraping`
- [Runbook: Tools: Search](runbooks/tools-search.md): `personaforge/tools/search`
- [Runbook: Tools: Shell](runbooks/tools-shell.md): `personaforge/tools/shell`
- [Runbook: Tools: Social](runbooks/tools-social.md): `personaforge/tools/social`
- [Runbook: Tools: Utils](runbooks/tools-utils.md): `personaforge/tools/utils`
- [Runbook: Video](runbooks/video.md): `personaforge/video`
- [Runbook: Voice](runbooks/voice.md): `personaforge/voice`
- [Runbook: Workflow](runbooks/workflow.md): `personaforge/workflow`

## Guides

- [adapters](guide/adapters.md)
- [admin-api](guide/admin-api.md)
- [agents](guide/agents.md)
- [all-modules](guide/all-modules.md)
- [artifacts](guide/artifacts.md)
- [background-queues](guide/background-queues.md)
- [checkpoint](guide/checkpoint.md)
- [compose](guide/compose.md)
- [compression](guide/compression.md)
- [concepts](guide/concepts.md)
- [context-provider](guide/context-provider.md)
- [control-plane](guide/control-plane.md)
- [custom-adapter](guide/custom-adapter.md)
- [custom-tools](guide/custom-tools.md)
- [database](guide/database.md)
- [deep-research](guide/deep-research.md)
- [eval](guide/eval.md)
- [event-streaming](guide/event-streaming.md)
- [getting-started](guide/getting-started.md)
- [graph](guide/graph.md)
- [guardrails](guide/guardrails.md)
- [hitl](guide/hitl.md)
- [hooks](guide/hooks.md)
- [introduction](guide/introduction.md)
- [learning-machine](guide/learning-machine.md)
- [llm-router](guide/llm-router.md)
- [loaders](guide/loaders.md)
- [mcp](guide/mcp.md)
- [memory](guide/memory.md)
- [migration-crewai](guide/migration-crewai.md)
- [migration-langchain](guide/migration-langchain.md)
- [migration-vercel](guide/migration-vercel.md)
- [migration-langgraph](guide/migration-langgraph.md)
- [migration-mastra](guide/migration-mastra.md)
- [migration-agno](guide/migration-agno.md)
- [comparisons](guide/comparisons.md)
- [trust](guide/trust.md)
- [model-fallbacks](guide/model-fallbacks.md)
- [monorepo-migration](guide/monorepo-migration.md)
- [multi-tenancy](guide/multi-tenancy.md)
- [observability](guide/observability.md)
- [orchestration](guide/orchestration.md)
- [output-parsers](guide/output-parsers.md)
- [packages](guide/packages.md)
- [planner](guide/planner.md)
- [plugins](guide/plugins.md)
- [production](guide/production.md)
- [providers](guide/providers.md)
- [rag](guide/rag.md)
- [reasoning](guide/reasoning.md)
- [reasoning-tools](guide/reasoning-tools.md)
- [retrieval-advanced](guide/retrieval-advanced.md)
- [runnable](guide/runnable.md)
- [scheduler](guide/scheduler.md)
- [secret-manager](guide/secret-manager.md)
- [session](guide/session.md)
- [skills](guide/skills.md)
- [storage](guide/storage.md)
- [stream-utils](guide/stream-utils.md)
- [structured-output](guide/structured-output.md)
- [team-modes](guide/team-modes.md)
- [tool-composition](guide/tool-composition.md)
- [toolkits](guide/toolkits.md)
- [tools](guide/tools.md)
- [trace-dataset](guide/trace-dataset.md)
- [video](guide/video.md)
- [vision](guide/vision.md)
- [voice](guide/voice.md)
- [websocket](guide/websocket.md)
- [workflow-branching](guide/workflow-branching.md)
- [workflows](guide/workflows.md)

## Optional

- [README](README.md)
- [ARCHITECTURE](ARCHITECTURE.md)
- [CHANGELOG](CHANGELOG.md)