nexus-ai-pro 2.2.0 → 2.3.0

package/dist-cjs/utils/tenant.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TenantIdError = void 0;
 exports.assertTenantId = assertTenantId;
 exports.tenantPrefix = tenantPrefix;
+exports.withPrincipal = withPrincipal;
 class TenantIdError extends RangeError {
     code = 'TENANT_ID_INVALID';
     constructor(tenantId) {
@@ -20,3 +21,17 @@ function assertTenantId(tenantId) {
 function tenantPrefix(tenantId) {
     return `tenant/${assertTenantId(tenantId)}/`;
 }
+function withPrincipal(runOptions) {
+    const principal = runOptions.principal;
+    if (!principal)
+        return runOptions;
+    const tenantId = principal.tenantId;
+    if (tenantId !== undefined && runOptions.tenantId !== undefined && tenantId !== runOptions.tenantId) {
+        throw new TypeError("The run's tenantId and its principal's tenant differ");
+    }
+    return {
+        ...runOptions,
+        ...(tenantId !== undefined && runOptions.tenantId === undefined ? { tenantId } : {}),
+        ...(principal.userId !== undefined ? { metadata: { ...runOptions.metadata, userId: principal.userId } } : {}),
+    };
+}

package/dist-cjs/version.d.ts

@@ -2,4 +2,4 @@
  * This package's version, recorded where provenance matters, such as on every experiment. A test
  * keeps it equal to `package.json`.
  */
-export declare const NEXUS_VERSION = "2.2.0";
+export declare const NEXUS_VERSION = "2.3.0";

package/dist-cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NEXUS_VERSION = void 0;
-exports.NEXUS_VERSION = '2.2.0';
+exports.NEXUS_VERSION = '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 78 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 143 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-ai-pro",
-  "version": "2.2.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",
@@ -540,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",
@@ -670,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",
@@ -840,6 +890,16 @@
         "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",
@@ -1350,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",
@@ -1360,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",
@@ -1812,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"
       ],
@@ -1845,6 +1947,9 @@
       "postgres/vectors": [
         "dist-cjs/postgres/vectors.d.ts"
       ],
+      "postgres/fulltext": [
+        "dist-cjs/postgres/fulltext.d.ts"
+      ],
       "postgres/traces": [
         "dist-cjs/postgres/traces.d.ts"
       ],
@@ -1896,6 +2001,9 @@
       "server/tenancy": [
         "dist-cjs/server/tenancy.d.ts"
       ],
+      "server/auth": [
+        "dist-cjs/server/auth.d.ts"
+      ],
       "tenancy": [
         "dist-cjs/tenancy/index.d.ts"
       ],
@@ -2070,9 +2178,18 @@
       "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"
       ],