@nextblock-cms/cortex 0.21.2 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +46 -46
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -1,46 +1,46 @@
1
- # @nextblock-cms/cortex
2
-
3
- Cortex AI, the premium AI module of [NextBlock](https://github.com/nextblock-cms/nextblock), the
4
- open-core CMS for Next.js and Supabase. It powers the CMS assistant that builds and edits pages,
5
- posts and products through tools, inline block and HTML generation, SEO metadata, image alt
6
- text, and the MCP server that lets external agents work on a NextBlock site.
7
-
8
- Models are called through [OpenRouter](https://openrouter.ai) with the Vercel AI SDK, and the
9
- site operator chooses the model.
10
-
11
- Projects created with `npm create nextblock@latest` already depend on it. It needs Next.js 16
12
- (peer dependency), Node.js 22.12 or later, and the project's own `ai` at ^7 and
13
- `@ai-sdk/openai-compatible` at ^3, the versions this package builds its models with.
14
-
15
- ## Licensing
16
-
17
- The source is public under AGPL-3.0-or-later, and the features are license-gated under the
18
- package id `cortex-ai`. A NextBlock project enables Cortex AI only after its license is active:
19
- start the free trial or buy one in the CMS under **Settings → Packages**. The app checks it with
20
- `verifyPackageOnline('cortex-ai')` from `@nextblock-cms/db/server`.
21
-
22
- ## Entry points
23
-
24
- | Import | Use it from | What it holds |
25
- | :-- | :-- | :-- |
26
- | `@nextblock-cms/cortex` | server only | The OpenRouter client and model registry, the global agent and its tools, block and widget generation, SEO metadata, alt text, and the MCP server, tokens and tool registry. It imports `next/headers` and `server-only` modules. |
27
- | `@nextblock-cms/cortex/client` | client or server | The browser-safe values a Client Component may need: `createCortexAiStoredModelSelection`, `formatCortexSiteBriefForPrompt` and `isCortexSiteBriefComplete` |
28
-
29
- Types from the main entry are safe to import anywhere; runtime values used by a Client
30
- Component must come from `/client`.
31
-
32
- ## Environment
33
-
34
- - `OPENROUTER_API_KEY`: the server-side key, used when no key is stored in the CMS. A key saved
35
- in the CMS takes precedence.
36
- - `CORTEX_AI_ENCRYPTION_KEY`: required to save and read the key stored in the CMS. Changing it
37
- makes stored keys unreadable.
38
-
39
- ## Documentation
40
-
41
- - [Cortex AI architecture](https://github.com/nextblock-cms/nextblock/blob/master/docs/08-NEXTBLOCK-CORTEX-AI-ARCHITECTURE.md)
42
- - [Project overview](https://github.com/nextblock-cms/nextblock/blob/master/docs/01-PROJECT-OVERVIEW.md)
43
-
44
- ## License
45
-
46
- AGPL-3.0-or-later.
1
+ # @nextblock-cms/cortex
2
+
3
+ Cortex AI, the premium AI module of [NextBlock](https://github.com/nextblock-cms/nextblock), the
4
+ open-core CMS for Next.js and Supabase. It powers the CMS assistant that builds and edits pages,
5
+ posts and products through tools, inline block and HTML generation, SEO metadata, image alt
6
+ text, and the MCP server that lets external agents work on a NextBlock site.
7
+
8
+ Models are called through [OpenRouter](https://openrouter.ai) with the Vercel AI SDK, and the
9
+ site operator chooses the model.
10
+
11
+ Projects created with `npm create nextblock@latest` already depend on it. It needs Next.js 16
12
+ (peer dependency), Node.js 22.12 or later, and the project's own `ai` at ^7 and
13
+ `@ai-sdk/openai-compatible` at ^3, the versions this package builds its models with.
14
+
15
+ ## Licensing
16
+
17
+ The source is public under AGPL-3.0-or-later, and the features are license-gated under the
18
+ package id `cortex-ai`. A NextBlock project enables Cortex AI only after its license is active:
19
+ start the free trial or buy one in the CMS under **Settings → Packages**. The app checks it with
20
+ `verifyPackageOnline('cortex-ai')` from `@nextblock-cms/db/server`.
21
+
22
+ ## Entry points
23
+
24
+ | Import | Use it from | What it holds |
25
+ | :-- | :-- | :-- |
26
+ | `@nextblock-cms/cortex` | server only | The OpenRouter client and model registry, the global agent and its tools, block and widget generation, SEO metadata, alt text, and the MCP server, tokens and tool registry. It imports `next/headers` and `server-only` modules. |
27
+ | `@nextblock-cms/cortex/client` | client or server | The browser-safe values a Client Component may need: `createCortexAiStoredModelSelection`, `formatCortexSiteBriefForPrompt` and `isCortexSiteBriefComplete` |
28
+
29
+ Types from the main entry are safe to import anywhere; runtime values used by a Client
30
+ Component must come from `/client`.
31
+
32
+ ## Environment
33
+
34
+ - `OPENROUTER_API_KEY`: the server-side key, used when no key is stored in the CMS. A key saved
35
+ in the CMS takes precedence.
36
+ - `CORTEX_AI_ENCRYPTION_KEY`: required to save and read the key stored in the CMS. Changing it
37
+ makes stored keys unreadable.
38
+
39
+ ## Documentation
40
+
41
+ - [Cortex AI architecture](https://github.com/nextblock-cms/nextblock/blob/master/docs/08-NEXTBLOCK-CORTEX-AI-ARCHITECTURE.md)
42
+ - [Project overview](https://github.com/nextblock-cms/nextblock/blob/master/docs/01-PROJECT-OVERVIEW.md)
43
+
44
+ ## License
45
+
46
+ AGPL-3.0-or-later.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nextblock-cms/cortex",
3
- "version": "0.21.2",
3
+ "version": "0.22.0",
4
4
  "license": "AGPL-3.0-or-later",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -29,9 +29,9 @@
29
29
  },
30
30
  "dependencies": {
31
31
  "@ai-sdk/openai-compatible": "^3.0.53",
32
- "@nextblock-cms/db": "^0.21.2",
33
- "@nextblock-cms/ecommerce": "npm:@nextblock-cms/ecom@^0.21.2",
34
- "@nextblock-cms/utils": "^0.21.2",
32
+ "@nextblock-cms/db": "^0.22.0",
33
+ "@nextblock-cms/ecommerce": "npm:@nextblock-cms/ecom@^0.22.0",
34
+ "@nextblock-cms/utils": "^0.22.0",
35
35
  "ai": "^7.0.107",
36
36
  "zod": "^4.6.5"
37
37
  },