nexus-ai-pro 2.1.0 → 2.3.0

package/llms.txt

@@ -2,10 +2,10 @@
 
 > 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 73 KB, and installs nothing but this package.
+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 80 KB, and installs nothing but this package.
 
 - 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 138 entry points. `nexus-ai-pro` itself is the client, and every other capability has its own subpath, such as `nexus-ai-pro/graph`.
+- It has 152 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.
 
@@ -16,7 +16,8 @@ Import only what you use. The root import is the client and nothing else, and ev
 - [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 and middleware, and the simple tool loop
+- [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
 - [Traces](https://raw.githubusercontent.com/mkhitar-abrahamyan/nexus-ai/main/docs/tracing.md): Run trees, queries, feedback, comparison, and alerts
@@ -42,6 +43,7 @@ Import only what you use. The root import is the client and nothing else, and ev
 - [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
 - [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
@@ -57,5 +59,5 @@ Import only what you use. The root import is the client and nothing else, and ev
 ## 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): Delivered work and what is planned next
+- [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-ai-pro",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Typed AI framework for TypeScript: provider routing and failover, durable agent graphs and workflows, retrieval over any vector store, MCP, evals, guardrails, and cost control",
   "type": "module",
   "main": "dist-cjs/index.js",
@@ -500,6 +500,16 @@
         "default": "./dist-cjs/sqlite/vectors.js"
       }
     },
+    "./sqlite/migrations": {
+      "import": {
+        "types": "./dist/sqlite/migrations.d.ts",
+        "default": "./dist/sqlite/migrations.js"
+      },
+      "require": {
+        "types": "./dist-cjs/sqlite/migrations.d.ts",
+        "default": "./dist-cjs/sqlite/migrations.js"
+      }
+    },
     "./graph/visualize": {
       "import": {
         "types": "./dist/graph/visualize.d.ts",
@@ -530,6 +540,46 @@
         "default": "./dist-cjs/agent/index.js"
       }
     },
+    "./agent/permissions": {
+      "import": {
+        "types": "./dist/agent/permissions.d.ts",
+        "default": "./dist/agent/permissions.js"
+      },
+      "require": {
+        "types": "./dist-cjs/agent/permissions.d.ts",
+        "default": "./dist-cjs/agent/permissions.js"
+      }
+    },
+    "./agent/sandbox": {
+      "import": {
+        "types": "./dist/agent/sandbox.d.ts",
+        "default": "./dist/agent/sandbox.js"
+      },
+      "require": {
+        "types": "./dist-cjs/agent/sandbox.d.ts",
+        "default": "./dist-cjs/agent/sandbox.js"
+      }
+    },
+    "./agent/middleware": {
+      "import": {
+        "types": "./dist/agent/middleware/index.d.ts",
+        "default": "./dist/agent/middleware/index.js"
+      },
+      "require": {
+        "types": "./dist-cjs/agent/middleware/index.d.ts",
+        "default": "./dist-cjs/agent/middleware/index.js"
+      }
+    },
+    "./deep-agent": {
+      "import": {
+        "types": "./dist/deep-agent/index.d.ts",
+        "default": "./dist/deep-agent/index.js"
+      },
+      "require": {
+        "types": "./dist-cjs/deep-agent/index.d.ts",
+        "default": "./dist-cjs/deep-agent/index.js"
+      }
+    },
     "./store": {
       "import": {
         "types": "./dist/store/index.d.ts",
@@ -660,6 +710,16 @@
         "default": "./dist-cjs/postgres/vectors.js"
       }
     },
+    "./postgres/fulltext": {
+      "import": {
+        "types": "./dist/postgres/fulltext.d.ts",
+        "default": "./dist/postgres/fulltext.js"
+      },
+      "require": {
+        "types": "./dist-cjs/postgres/fulltext.d.ts",
+        "default": "./dist-cjs/postgres/fulltext.js"
+      }
+    },
     "./postgres/traces": {
       "import": {
         "types": "./dist/postgres/traces.d.ts",
@@ -680,6 +740,26 @@
         "default": "./dist-cjs/postgres/evaluate.js"
       }
     },
+    "./postgres/migrations": {
+      "import": {
+        "types": "./dist/postgres/migrations.d.ts",
+        "default": "./dist/postgres/migrations.js"
+      },
+      "require": {
+        "types": "./dist-cjs/postgres/migrations.d.ts",
+        "default": "./dist-cjs/postgres/migrations.js"
+      }
+    },
+    "./postgres/rollups": {
+      "import": {
+        "types": "./dist/postgres/rollups.d.ts",
+        "default": "./dist/postgres/rollups.js"
+      },
+      "require": {
+        "types": "./dist-cjs/postgres/rollups.d.ts",
+        "default": "./dist-cjs/postgres/rollups.js"
+      }
+    },
     "./optimizer/cost": {
       "import": {
         "types": "./dist/optimizer/cost.d.ts",
@@ -810,6 +890,36 @@
         "default": "./dist-cjs/server/tenancy.js"
       }
     },
+    "./server/auth": {
+      "import": {
+        "types": "./dist/server/auth.d.ts",
+        "default": "./dist/server/auth.js"
+      },
+      "require": {
+        "types": "./dist-cjs/server/auth.d.ts",
+        "default": "./dist-cjs/server/auth.js"
+      }
+    },
+    "./tenancy": {
+      "import": {
+        "types": "./dist/tenancy/index.d.ts",
+        "default": "./dist/tenancy/index.js"
+      },
+      "require": {
+        "types": "./dist-cjs/tenancy/index.d.ts",
+        "default": "./dist-cjs/tenancy/index.js"
+      }
+    },
+    "./doctor": {
+      "import": {
+        "types": "./dist/doctor/index.d.ts",
+        "default": "./dist/doctor/index.js"
+      },
+      "require": {
+        "types": "./dist-cjs/doctor/index.d.ts",
+        "default": "./dist-cjs/doctor/index.js"
+      }
+    },
     "./prompts": {
       "import": {
         "types": "./dist/prompts/index.d.ts",
@@ -1300,6 +1410,16 @@
         "default": "./dist-cjs/rag/chroma.js"
       }
     },
+    "./rag/elasticsearch": {
+      "import": {
+        "types": "./dist/rag/elasticsearch.d.ts",
+        "default": "./dist/rag/elasticsearch.js"
+      },
+      "require": {
+        "types": "./dist-cjs/rag/elasticsearch.d.ts",
+        "default": "./dist-cjs/rag/elasticsearch.js"
+      }
+    },
     "./rag/retrievers": {
       "import": {
         "types": "./dist/rag/retrievers.d.ts",
@@ -1310,6 +1430,26 @@
         "default": "./dist-cjs/rag/retrievers.js"
       }
     },
+    "./rag/rerankers": {
+      "import": {
+        "types": "./dist/rag/rerankers.d.ts",
+        "default": "./dist/rag/rerankers.js"
+      },
+      "require": {
+        "types": "./dist-cjs/rag/rerankers.d.ts",
+        "default": "./dist-cjs/rag/rerankers.js"
+      }
+    },
+    "./rag/pipeline": {
+      "import": {
+        "types": "./dist/rag/pipeline.d.ts",
+        "default": "./dist/rag/pipeline.js"
+      },
+      "require": {
+        "types": "./dist-cjs/rag/pipeline.d.ts",
+        "default": "./dist-cjs/rag/pipeline.js"
+      }
+    },
     "./evals": {
       "import": {
         "types": "./dist/evals/index.d.ts",
@@ -1438,9 +1578,10 @@
     "test:conformance:real": "tsx tests/conformance.real.ts",
     "test:vectors:live": "tsx tests/vector-stores.live.ts",
     "bench:graph": "node scripts/bench-graph.mjs",
+    "bench:runtime": "node --expose-gc scripts/bench-runtime.mjs",
     "pack:dry-run": "npm pack --dry-run --cache .tmp-nexus-ai-tests/npm-cache",
     "check": "npm run format:check && npm run registry:check && npm run llms:check && npm run lint && npm test && npm run typecheck:tests && npm run studio:typecheck && npm run typecheck:examples && npm run typecheck:examples:browser && npm run test:coverage",
-    "check:release": "npm run check && npm run bench:graph && npm run pack:dry-run && npm run test:clean-install && npm run test:studio-install",
+    "check:release": "npm run check && npm run bench:graph && npm run bench:runtime && npm run pack:dry-run && npm run test:clean-install && npm run test:studio-install",
     "prepack": "npm run build",
     "prepublishOnly": "npm run check:release",
     "build:esm": "tsc --removeComments --declaration false && tsc --emitDeclarationOnly",
@@ -1568,10 +1709,13 @@
     "ajv-formats": "^3.0.1",
     "bullmq": "^5.63.0",
     "express": "^5.1.0",
+    "nexus-ai-pro-2-0": "npm:nexus-ai-pro@^2.0.0",
+    "nexus-ai-pro-2-1": "npm:nexus-ai-pro@^2.1.0",
     "ollama": "^0.5.6",
     "openai": "^4.52.0",
     "tsx": "^4.16.0",
     "typescript": "^5.5.0",
+    "wasmoon": "^1.16.0",
     "yaml": "^2.9.1",
     "zod": "^3.23.0"
   },
@@ -1758,6 +1902,18 @@
       "agent": [
         "dist-cjs/agent/index.d.ts"
       ],
+      "agent/permissions": [
+        "dist-cjs/agent/permissions.d.ts"
+      ],
+      "agent/sandbox": [
+        "dist-cjs/agent/sandbox.d.ts"
+      ],
+      "agent/middleware": [
+        "dist-cjs/agent/middleware/index.d.ts"
+      ],
+      "deep-agent": [
+        "dist-cjs/deep-agent/index.d.ts"
+      ],
       "store": [
         "dist-cjs/store/index.d.ts"
       ],
@@ -1791,12 +1947,21 @@
       "postgres/vectors": [
         "dist-cjs/postgres/vectors.d.ts"
       ],
+      "postgres/fulltext": [
+        "dist-cjs/postgres/fulltext.d.ts"
+      ],
       "postgres/traces": [
         "dist-cjs/postgres/traces.d.ts"
       ],
       "postgres/evaluate": [
         "dist-cjs/postgres/evaluate.d.ts"
       ],
+      "postgres/migrations": [
+        "dist-cjs/postgres/migrations.d.ts"
+      ],
+      "postgres/rollups": [
+        "dist-cjs/postgres/rollups.d.ts"
+      ],
       "server": [
         "dist-cjs/server/index.d.ts"
       ],
@@ -1836,6 +2001,15 @@
       "server/tenancy": [
         "dist-cjs/server/tenancy.d.ts"
       ],
+      "server/auth": [
+        "dist-cjs/server/auth.d.ts"
+      ],
+      "tenancy": [
+        "dist-cjs/tenancy/index.d.ts"
+      ],
+      "doctor": [
+        "dist-cjs/doctor/index.d.ts"
+      ],
       "prompts": [
         "dist-cjs/prompts/index.d.ts"
       ],
@@ -2004,12 +2178,24 @@
       "rag/chroma": [
         "dist-cjs/rag/chroma.d.ts"
       ],
+      "rag/elasticsearch": [
+        "dist-cjs/rag/elasticsearch.d.ts"
+      ],
       "rag/retrievers": [
         "dist-cjs/rag/retrievers.d.ts"
       ],
+      "rag/rerankers": [
+        "dist-cjs/rag/rerankers.d.ts"
+      ],
+      "rag/pipeline": [
+        "dist-cjs/rag/pipeline.d.ts"
+      ],
       "sqlite/vectors": [
         "dist-cjs/sqlite/vectors.d.ts"
       ],
+      "sqlite/migrations": [
+        "dist-cjs/sqlite/migrations.d.ts"
+      ],
       "mcp/registry": [
         "dist-cjs/mcp/registry.d.ts"
       ],