# nexus-ai-pro

> The typed AI framework for TypeScript. One API for provider routing and failover, agent graphs and workflows that run branches in parallel and survive a restart, retrieval over any vector store, MCP, durable background operations, guardrails, cost control, images, voice, and evals — with a studio a team can share.

Import only what you use. The root import is the client and nothing else, and every other capability has its own entry point with a size budget CI enforces; [the packaging guide](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/packaging.md) publishes what each one costs. The package has no required dependencies: a graph-only application loads 81 KB, and installs nothing but this package. The client, the provider adapters, graphs, agents, and the agent protocols run on Node.js, Deno, Bun, edge runtimes, and browsers; [the runtimes guide](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/runtimes.md) lists the entry points that need Node.js, and why.

- Install with `npm install nexus-ai-pro`. It needs Node.js 22 or newer, and ships ESM and CommonJS builds with shared types. License: MIT.
- It has 200 entry points. `nexus-ai-pro` itself is the client, and every other capability has its own subpath, such as `nexus-ai-pro/graph`.
- Nothing is a required dependency. Install only the optional peers you use: `@anthropic-ai/sdk`, `@types/node`, `ajv`, `ajv-formats`, `ollama`, `openai`, `zod`.
- Each guide explains every export of its entry points, then lists them in a reference generated from the doc comments.

## Guides

- [The client](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/core.md): Requests, context windows, token optimization, cost checks, reasoning, prompt caching, streaming
- [The lifecycle](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/lifecycle.md): Authorization, a shared budget, hooks, audit, and metrics for every call of every family
- [Providers and routing](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/providers.md): The twelve completion providers, routing and failover, the model registry
- [Guardrails](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/security.md): Injection, PII, secrets, schema validation, output redaction
- [Graphs](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/graphs.md): Parallel branches, interrupts, checkpoints, time travel, subgraphs, caching, diagrams
- [Agents and tools](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/agents.md): Graph-based agents with approvals, capabilities and permission policies, a sandbox contract, the middleware catalog, and the simple tool loop
- [The deep-agent preset](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/deep-agents.md): Long, multi-step agents: a plan, a sandboxed workspace, helpers, skills, and a context that stays small
- [Long-term memory](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/memory.md): Namespaced memory with semantic search, in memory or Redis
- [MCP](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/mcp.md): Borrowing tools from MCP servers, a registry of many, and serving your own
- [Agent protocols](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/protocols.md): Serving an agent to user interfaces over AG-UI, to other agents over A2A, and to code editors over ACP, and calling remote agents as tools
- [Traces](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/tracing.md): Run trees, queries, feedback, comparison, and alerts
- [Evaluation](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/evaluation.md): Datasets, evaluators, experiments, comparisons with a verdict, review queues, LLM judges, and tools emulated by a model so an evaluation sends nothing
- [Context hub](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/context-hub.md): Prompts, instructions, tools, and skills versioned together, promoted through gates, and moved between projects
- [Insights](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/insights.md): Failing and slow runs clustered, regressions between time windows, and evaluated fix proposals
- [Prompts](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/prompts.md): Typed templates, content versions, gated promotion, rollback, A/B splits, serving through outages
- [Postgres](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/postgres.md): One adapter family for operations, memory, traces, evaluation, circuits, and prompts
- [SQLite](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/sqlite.md): Durable operations, checkpoints, and memory on one machine, over any SQLite driver
- [Durable operations and jobs](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/operations.md): Operations that survive a restart, webhooks, and in-process job helpers
- [Resilience and observability](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/resilience.md): Circuit breaking, distributed rate limits, metrics, logs, and audit
- [Batch tiers](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/batch.md): The providers' discounted batch APIs, resumable from any process
- [Caching](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/caching.md): Exact and semantic response caches, with memory, Redis, and SQLite adapters
- [Grounding](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/grounding.md): Retrieval, citations, verification, self-consistency, and knowledge graphs
- [Loaders](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/loaders.md): Files, Markdown, HTML, CSV, JSON, PDF, web pages, sitemaps, and Git repositories into retrieval
- [Retrieval](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/retrieval.md): Hybrid search, reranking, MMR, parent documents, and Redis, Pinecone, Weaviate, and Chroma stores
- [Embeddings and retrieval](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/embeddings.md): Embeddings as a routed operation family, and RAG helpers
- [Media understanding](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/media.md): Reading documents and images page by page, describing images, and answering questions about them, through any vision model or OCR
- [Typed decisions](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/decisions.md): A yes or no, a choice, or a score, answered with probabilities and a calibrated confidence, from TypeSafe AI's Jev or any model, so a graph, an approval, or a guardrail acts when it is sure and asks a person when not
- [Video generation](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/video.md): Videos from a prompt or a first frame, on Google Veo and Runway, as durable jobs streamed into an asset store and priced per second
- [Images (experimental)](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/images.md): Generation and masked edits over three backends, input safety, moderation, asset stores
- [Voice](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/voice.md): Transcription, speech, voice turns, and voice sessions
- [Realtime voice](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/realtime.md): Browser and server realtime sessions with barge-in, tools, and exports
- [Telephony](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/telephony.md): Calls, webhooks, phone numbers, and phone agents on realtime sessions
- [Testing](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/testing.md): Recording and replaying provider traffic, and conformance suites
- [Adapter kit](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/adapter-kit.md): Building a provider, store, or retriever outside this repository, verifying it against the same contracts, and its compatibility record on the [compatibility page](https://github.com/mkhitar-abrahamyan/nexus-ai/blob/main/COMPATIBILITY.md)
- [Studio](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/studio.md): A shared UI for traces, threads, approvals, experiments, prompts, deployments, costs, and health, as a separate package
- [Agent server](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/server.md): Self-hosted HTTP server for assistants: threads, durable runs, resumable streams, cron, a worker queue, and metrics
- [Deployments](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/deployments.md): Revisions and canaries with automatic rollback, autoscaling on Kubernetes and Helm, and per-tenant limits
- [Tenancy](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/tenancy.md): One tenant model: a tenant's view of every store, tenant graph runs, and the isolation suite
- [Policy](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/policy.md): Guardrails, routing, budgets, residency, and credentials as one versioned file, validated as the client starts, checked by `nexus policy check` in CI, and recorded on every operation
- [Regions and credentials](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/regions.md): Agent servers across regions behind a gateway, residency rules that keep each tenant's requests, traces, and assets in its regions, and each tenant's provider keys from a secret manager
- [Workflows](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/workflows.md): Ready-made chains and domain workflows
- [Command line](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/cli.md): The `nexus` command
- [Packaging and install weight](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/packaging.md): Every entry point and what it costs
- [Runtimes](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/runtimes.md): The portable kernel, and running the client, providers, graphs, and agents on Deno, Bun, edge runtimes, and browsers

## Project

- [README](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/README.md): Install, a first request, and the full feature list
- [Migrating to 2.0](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/MIGRATING.md): What 2.0 changed, and the codemod that rewrites imports
- [API stability](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/API_STABILITY.md): Which entry points are stable and which are experimental
- [Changelog](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/CHANGELOG.md): Every release, newest first
- [Security](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/SECURITY.md): Reporting a vulnerability, and the security model

## Optional

- [Full documentation](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/llms-full.txt): The README and every guide in one file, for a tool that takes one document
- [Roadmap](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/ROADMAP.md): The releases planned next, and the gaps each one closes
- [Contributing](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/CONTRIBUTING.md): Testing and the release procedure