@positronic/template-new-project 0.0.73 → 0.0.75

package/index.js

@@ -53,10 +53,10 @@ module.exports = {
   ],
   setup: async ctx => {
     const devRootPath = process.env.POSITRONIC_LOCAL_PATH;
-    let coreVersion = '^0.0.73';
-    let cloudflareVersion = '^0.0.73';
-    let clientVercelVersion = '^0.0.73';
-    let genUIComponentsVersion = '^0.0.73';
+    let coreVersion = '^0.0.75';
+    let cloudflareVersion = '^0.0.75';
+    let clientVercelVersion = '^0.0.75';
+    let genUIComponentsVersion = '^0.0.75';
 
     // Map backend selection to package names
     const backendPackageMap = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@positronic/template-new-project",
-  "version": "0.0.73",
+  "version": "0.0.75",
   "publishConfig": {
     "access": "public"
   },

package/template/CLAUDE.md

@@ -126,7 +126,7 @@ The optional `timeout` parameter accepts durations like `'30m'`, `'1h'`, `'24h'`
 If your brain generates a custom HTML page with a form that submits to a webhook, you must include a CSRF token. Without a token, the server will reject the submission.
 
 1. Generate a token with `generateFormToken()` from `@positronic/core`
-2. Add `<input type="hidden" name="__positronic_token" value="${token}">` to the form
+2. Add `<input type="hidden" name="__positronic_token" value="<%= '${token}' %>">` to the form
 3. Pass the token when creating the webhook registration: `myWebhook(identifier, token)`
 
 The `.ui()` step handles this automatically. See `/docs/brain-dsl-guide.md` for full examples.

package/template/_env

@@ -33,4 +33,4 @@ R2_BUCKET_NAME=<%= projectName %>
 # 4. Copy your Account ID from the right sidebar on any Cloudflare page
 #
 # CLOUDFLARE_API_TOKEN=
-# CLOUDFLARE_ACCOUNT_ID=
+# CLOUDFLARE_ACCOUNT_ID=

package/template/brain.ts

@@ -81,7 +81,7 @@ import { components } from './components/index.js';
  * const memoryTools = createMem0Tools();
  * ```
  *
- * Memory is automatically scoped to the current user (via currentUser.id)
+ * Memory is automatically scoped to the current user (via currentUser.name)
  * and the brain name. No need to pass userId manually.
  *
  * See docs/memory-guide.md for full details.

package/template/brains/example.ts

@@ -1,6 +1,10 @@
 import { z } from 'zod';
 import { brain } from '../brain.js';
 
+// This brain uses the AI client configured in runner.ts.
+// By default it uses Google Gemini (requires GOOGLE_GENERATIVE_AI_API_KEY in .env).
+// See runner.ts to switch to Anthropic, OpenAI, or any other Vercel AI SDK provider.
+
 const exampleBrain = brain('example')
   .step('Start', ({ state }) => ({
     ...state,

package/template/docs/memory-guide.md

@@ -277,7 +277,7 @@ brain('sales-agent').withMemory(memory)    // agentId = 'sales-agent'
 
 ### userId
 
-Automatically set from `currentUser.id` when the brain runs. All memory operations are automatically scoped to the current user — no need to pass userId manually:
+Automatically set from `currentUser.name` when the brain runs. All memory operations are automatically scoped to the current user — no need to pass userId manually:
 
 ```typescript
 // userId is auto-bound from currentUser — just use memory directly

package/template/docs/positronic-guide.md

@@ -234,7 +234,7 @@ const api = {
 
 ## currentUser
 
-Every brain run requires a `currentUser` — an object with at least an `id` field that identifies who is running the brain. This identity is used to scope per-user data like memory and store fields.
+Every brain run requires a `currentUser` — an object with at least a `name` field that identifies who is running the brain. This identity is used to scope per-user data like memory and store fields.
 
 ### How currentUser Gets Set
 
@@ -251,7 +251,7 @@ import { runner } from './runner.js';
 import myBrain from './brains/my-brain.js';
 
 await runner.run(myBrain, {
-  currentUser: { id: 'local-dev-user' },
+  currentUser: { name: 'local-dev-user' },
 });
 ```
 
@@ -261,7 +261,7 @@ await runner.run(myBrain, {
 const events = await collectEvents(
   testBrain.run({
     client: mockClient,
-    currentUser: { id: 'test-user' },
+    currentUser: { name: 'test-user' },
   })
 );
 ```
@@ -278,7 +278,7 @@ const events = await collectEvents(
 ```typescript
 export default brain('greet')
   .step('Hello', ({ currentUser }) => ({
-    greeting: 'Hello, user ' + currentUser.id,
+    greeting: 'Hello, user ' + currentUser.name,
   }));
 ```
 

package/template/runner.ts

@@ -5,6 +5,39 @@ import { google } from '@ai-sdk/google';
 /**
  * The BrainRunner executes brains with the configured client and adapters.
  *
+ * ## AI Provider Setup
+ *
+ * By default this uses Google Gemini. Set GOOGLE_GENERATIVE_AI_API_KEY in
+ * your .env file (get a key at https://aistudio.google.com/apikey).
+ *
+ * To switch to a different provider, install its Vercel AI SDK adapter
+ * and swap the model below:
+ *
+ * **Anthropic (Claude):**
+ * ```bash
+ * npm install @ai-sdk/anthropic
+ * ```
+ * ```typescript
+ * import { anthropic } from '@ai-sdk/anthropic';
+ * const client = new VercelClient(anthropic('claude-sonnet-4-5-20250929'));
+ * ```
+ * Then set ANTHROPIC_API_KEY in your .env file.
+ *
+ * **OpenAI:**
+ * ```bash
+ * npm install @ai-sdk/openai
+ * ```
+ * ```typescript
+ * import { openai } from '@ai-sdk/openai';
+ * const client = new VercelClient(openai('gpt-4o'));
+ * ```
+ * Then set OPENAI_API_KEY in your .env file.
+ *
+ * Any provider supported by the Vercel AI SDK works — just install the
+ * package and pass the model to VercelClient.
+ *
+ * ## Memory
+ *
  * To add memory (automatic conversation indexing with Mem0):
  *
  * ```typescript
@@ -23,7 +56,6 @@ import { google } from '@ai-sdk/google';
  * });
  * ```
  *
- * The adapter automatically indexes all agent conversations to memory.
  * See docs/memory-guide.md for more details.
  */
 const client = new VercelClient(google('gemini-3-pro-preview'));