create-pyric 0.1.0-alpha.12 → 0.1.0-alpha.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pyric",
-  "version": "0.1.0-alpha.12",
+  "version": "0.1.0-alpha.14",
   "license": "Apache-2.0",
   "homepage": "https://pyric.dev",
   "repository": {

package/templates/chat/.env.example

@@ -12,9 +12,11 @@ VITE_FIREBASE_DATABASE_URL=
 # production FCM token registration; the dev sandbox mints tokens without it.
 VITE_FIREBASE_VAPID_KEY=
 
-# Optional local OpenAI-compatible model. Leave both unset to use Pyric's
-# built-in scripted AI. MiniMax example:
-# PYRIC_AI_PROXY_UPSTREAM=http://localhost:8080/v1
-# PYRIC_AI_MODEL=minimax-m2.7
-PYRIC_AI_PROXY_UPSTREAM=
+# Optional local model. Setting this switches from Pyric's scripted AI to its
+# OpenAI-compatible engine and supplies the model name sent upstream.
+# The model-only path uses Ollama at http://localhost:11434/v1 by default.
+# Example: ollama pull qwen3:4b
 PYRIC_AI_MODEL=
+# Override only for another OpenAI-compatible model server. This is the
+# server-side base URL, not the browser proxy path; include /v1 when required.
+PYRIC_AI_PROXY_UPSTREAM=

package/templates/chat/README.md

@@ -13,16 +13,41 @@ npm run dev
 ```
 
 With no model configuration, Pyric's built-in scripted engine answers locally.
-To use MiniMax or another OpenAI-compatible server, copy `.env.example` to
-`.env.local` and set both:
+To use Ollama, pull a model, copy `.env.example` to `.env.local`, and select it:
+
+```bash
+ollama pull qwen3:4b
+```
+
+```dotenv
+PYRIC_AI_MODEL=qwen3:4b
+```
+
+Pyric forwards the unchanged `firebase/ai` calls to Ollama's default
+OpenAI-compatible endpoint at `http://localhost:11434/v1`. For another model
+server, also set its base URL (including `/v1` when required):
 
 ```dotenv
-PYRIC_AI_PROXY_UPSTREAM=http://localhost:8080/v1
 PYRIC_AI_MODEL=minimax-m2.7
+PYRIC_AI_PROXY_UPSTREAM=http://localhost:8080/v1
 ```
 
-Start that server separately, then restart Vite. The scaffold deliberately does
-not assume an operating system or a particular model launcher.
+Start the model server separately, then restart Vite.
+See the [Pyric AI Logic guide](https://pyric.dev/docs/build/ai-logic/) for the full
+engine and proxy behaviour.
+
+For a one-off run on macOS, Linux, or another POSIX shell, prefix the same
+command with the variables:
+
+```bash
+PYRIC_AI_MODEL=qwen3:4b \
+PYRIC_AI_PROXY_UPSTREAM=http://localhost:11434/v1 \
+npm run dev
+```
+
+Do not put `&&` before `npm run dev`: that makes the values unexported shell
+variables instead of environment variables for Vite. Use `.env.local` for the
+normal, persistent setup.
 
 ## What runs in the sandbox
 
@@ -38,6 +63,15 @@ The same bundled module service worker handles `onBackgroundMessage` in local
 development and production. Local delivery still requires an open page to keep
 the Pyric sandbox alive.
 
+## Runtime status
+
+Pyric adds a collapsed runtime chip to the bottom-right corner during Vite
+development. It signals sandbox errors and tells you when the long-lived worker
+needs an update. Open it to copy an error, activate the new worker safely,
+or open Pyric Studio in a new tab. Updating finishes accepted sandbox work and
+then reloads every connected tab onto the new worker. The chip is not included
+in a normal production build.
+
 ## Test and build
 
 ```bash

package/templates/chat/functions/index.js

@@ -24,7 +24,7 @@ export const onPresenceOnline = onValueCreated('/presence/{uid}', async (event)
   const profile = getFirestore().collection('users').doc(uid);
   const snapshot = await profile.get();
   const now = FieldValue.serverTimestamp();
-  const seen = snapshot.exists && snapshot.get('firstSeenAt')
+  const seen = snapshot.exists && snapshot.data()?.firstSeenAt
     ? { lastSeenAt: now }
     : { firstSeenAt: now, lastSeenAt: now };
   await profile.set(seen, { merge: true });

package/templates/chat/src/ui/chat/chat-page.tsx

@@ -13,8 +13,7 @@ import type { ChatPageServices, UiConversation, UiMessage, UiNotification, UiPre
 import type { ChatMode } from '../../chat-mode';
 import { MarkdownMessage } from './markdown-message';
 import { storePreviewComponent } from './preview-component-state';
-
-const starterMessages: UiMessage[] = [{ id: 'welcome', role: 'assistant', text: 'Good morning. What would you like to work through?', status: 'complete' }];
+import { reconcileMessages, starterMessages } from './message-reconciliation';
 
 const initials = (user: UiUser | null): string =>
   (user?.displayName ?? user?.email ?? 'You').split(' ').map((part) => part[0]).join('').slice(0, 2).toUpperCase();
@@ -27,11 +26,6 @@ const modeOptions: Array<{ id: ChatMode; label: string; description: string; pla
   { id: 'plan', label: 'Plan', description: 'Make it actionable', placeholder: 'Turn an idea into a plan…' },
   { id: 'refine', label: 'Refine', description: 'Pressure-test a direction', placeholder: 'Pressure-test a direction…' },
 ];
-const chronological = (items: UiMessage[]): UiMessage[] => [...items].sort((a, b) => {
-  if (!a.createdAt || !b.createdAt) return 0;
-  return a.createdAt.getTime() - b.createdAt.getTime();
-});
-
 const conversationIdFromUrl = (): string | null => new URLSearchParams(window.location.search).get('conversation');
 
 const writeConversationUrl = (conversationId: string | null, replace = false): void => {
@@ -41,65 +35,6 @@ const writeConversationUrl = (conversationId: string | null, replace = false): v
   window.history[replace ? 'replaceState' : 'pushState']({}, '', `${url.pathname}${url.search}${url.hash}`);
 };
 
-const reconcileMessages = (serverMessages: UiMessage[], currentMessages: UiMessage[]): UiMessage[] => {
-  const seenServerMessages = new Set<string>();
-  const server = chronological(serverMessages).filter((message) => {
-    if (!message.clientMessageId) return true;
-    const key = `${message.role}:${message.clientMessageId}`;
-    if (seenServerMessages.has(key)) return false;
-    seenServerMessages.add(key);
-    return true;
-  });
-  const serverClientIds = new Set(server.map((message) => message.clientMessageId).filter(Boolean));
-  const localAssistants = currentMessages.filter((message) => message.role === 'assistant' && message.id !== 'welcome');
-  const persistedAssistantIds = new Set(server.filter((message) => message.role === 'assistant').map((message) => message.clientMessageId).filter(Boolean));
-  const linkedAssistants = new Set<string>();
-  const result: UiMessage[] = [];
-
-  const addReply = (message: UiMessage) => {
-    for (const assistant of localAssistants) {
-      if (assistant.replyToClientMessageId === message.clientMessageId && !persistedAssistantIds.has(assistant.id)) {
-        result.push(assistant);
-        linkedAssistants.add(assistant.id);
-      }
-    }
-  };
-
-  for (const message of server) {
-    result.push(message);
-    if (message.role === 'user') addReply(message);
-  }
-
-  for (const message of currentMessages) {
-    if (message.role === 'user' && message.clientMessageId && !serverClientIds.has(message.clientMessageId)) {
-      result.push(message);
-      addReply(message);
-    }
-  }
-
-  result.push(...localAssistants.filter((message) => !linkedAssistants.has(message.id) && !message.replyToClientMessageId));
-
-  const turnKey = (message: UiMessage): string => {
-    if (message.role === 'assistant') {
-      if (message.replyToClientMessageId) return message.replyToClientMessageId;
-      if (message.clientMessageId?.startsWith('assistant-')) return message.clientMessageId.slice('assistant-'.length);
-    }
-    return message.clientMessageId ?? message.id;
-  };
-  const turnOrder = new Map<string, number>();
-  result.forEach((message, index) => {
-    const key = turnKey(message);
-    if (!turnOrder.has(key)) turnOrder.set(key, index);
-  });
-  return result.length ? [...result].sort((a, b) => {
-    const orderDifference = (turnOrder.get(turnKey(a)) ?? 0) - (turnOrder.get(turnKey(b)) ?? 0);
-    if (orderDifference !== 0) return orderDifference;
-    if (a.role === 'user' && b.role !== 'user') return -1;
-    if (a.role !== 'user' && b.role === 'user') return 1;
-    return 0;
-  }) : starterMessages;
-};
-
 function CopyMessageButton({ text }: { text: string }) {
   const [copied, setCopied] = useState(false);
 

package/templates/chat/src/ui/chat/message-reconciliation.ts

@@ -0,0 +1,81 @@
+import type { UiMessage } from './chat-types';
+
+export const starterMessages: UiMessage[] = [{
+  id: 'welcome',
+  role: 'assistant',
+  text: 'Good morning. What would you like to work through?',
+  status: 'complete',
+}];
+
+const chronological = (items: UiMessage[]): UiMessage[] => [...items].sort((a, b) => {
+  if (!a.createdAt || !b.createdAt) return 0;
+  return a.createdAt.getTime() - b.createdAt.getTime();
+});
+
+export const reconcileMessages = (
+  serverMessages: UiMessage[],
+  currentMessages: UiMessage[],
+): UiMessage[] => {
+  const seenServerMessages = new Set<string>();
+  const server = chronological(serverMessages).filter((message) => {
+    if (!message.clientMessageId) return true;
+    const key = `${message.role}:${message.clientMessageId}`;
+    if (seenServerMessages.has(key)) return false;
+    seenServerMessages.add(key);
+    return true;
+  });
+  const serverIds = new Set(server.map((message) => message.id));
+  const serverClientIds = new Set(server.map((message) => message.clientMessageId).filter(Boolean));
+  const localAssistants = currentMessages.filter((message) => message.role === 'assistant' && message.id !== 'welcome');
+  const persistedAssistantIds = new Set(server.filter((message) => message.role === 'assistant').map((message) => message.clientMessageId).filter(Boolean));
+  const linkedAssistants = new Set<string>();
+  const result: UiMessage[] = [];
+
+  const addReply = (message: UiMessage) => {
+    for (const assistant of localAssistants) {
+      if (assistant.replyToClientMessageId === message.clientMessageId && !persistedAssistantIds.has(assistant.id)) {
+        result.push(assistant);
+        linkedAssistants.add(assistant.id);
+      }
+    }
+  };
+
+  for (const message of server) {
+    result.push(message);
+    if (message.role === 'user') addReply(message);
+  }
+
+  for (const message of currentMessages) {
+    if (message.role === 'user' && message.clientMessageId && !serverClientIds.has(message.clientMessageId)) {
+      result.push(message);
+      addReply(message);
+    }
+  }
+
+  // React state contains both optimistic assistants and the previous listener
+  // result. Keep only assistants that are genuinely absent from this snapshot.
+  result.push(...localAssistants.filter((message) =>
+    !serverIds.has(message.id)
+    && !linkedAssistants.has(message.id)
+    && !message.replyToClientMessageId));
+
+  const turnKey = (message: UiMessage): string => {
+    if (message.role === 'assistant') {
+      if (message.replyToClientMessageId) return message.replyToClientMessageId;
+      if (message.clientMessageId?.startsWith('assistant-')) return message.clientMessageId.slice('assistant-'.length);
+    }
+    return message.clientMessageId ?? message.id;
+  };
+  const turnOrder = new Map<string, number>();
+  result.forEach((message, index) => {
+    const key = turnKey(message);
+    if (!turnOrder.has(key)) turnOrder.set(key, index);
+  });
+  return result.length ? [...result].sort((a, b) => {
+    const orderDifference = (turnOrder.get(turnKey(a)) ?? 0) - (turnOrder.get(turnKey(b)) ?? 0);
+    if (orderDifference !== 0) return orderDifference;
+    if (a.role === 'user' && b.role !== 'user') return -1;
+    if (a.role !== 'user' && b.role === 'user') return 1;
+    return 0;
+  }) : starterMessages;
+};

package/templates/chat/test/message-reconciliation.test.ts

@@ -0,0 +1,58 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { reconcileMessages } from '../src/ui/chat/message-reconciliation.ts';
+import type { UiMessage } from '../src/ui/chat/chat-types.ts';
+
+test('does not duplicate a persisted assistant when Firestore publishes again', () => {
+  const persistedAssistant: UiMessage = {
+    id: 'OK6MzPx25jG9GY9FwRA3',
+    role: 'assistant',
+    text: 'Persisted reply',
+    status: 'complete',
+    clientMessageId: 'assistant-client-message-1',
+  };
+
+  const firstSnapshot = reconcileMessages([persistedAssistant], []);
+  const secondSnapshot = reconcileMessages([persistedAssistant], firstSnapshot);
+
+  assert.deepEqual(secondSnapshot.map((message) => message.id), ['OK6MzPx25jG9GY9FwRA3']);
+});
+
+test('keeps a streaming assistant until its persisted replacement arrives', () => {
+  const user: UiMessage = {
+    id: 'server-user-1',
+    role: 'user',
+    text: 'Hello',
+    status: 'complete',
+    clientMessageId: 'client-message-1',
+  };
+  const streamingAssistant: UiMessage = {
+    id: 'assistant-client-message-1',
+    role: 'assistant',
+    text: 'Streaming',
+    status: 'streaming',
+    replyToClientMessageId: 'client-message-1',
+  };
+
+  const whileStreaming = reconcileMessages([user], [user, streamingAssistant]);
+  assert.deepEqual(whileStreaming.map((message) => message.id), [
+    'server-user-1',
+    'assistant-client-message-1',
+  ]);
+
+  const persistedAssistant: UiMessage = {
+    id: 'server-assistant-1',
+    role: 'assistant',
+    text: 'Complete',
+    status: 'complete',
+    clientMessageId: 'assistant-client-message-1',
+  };
+  const afterPersistence = reconcileMessages(
+    [user, persistedAssistant],
+    whileStreaming,
+  );
+  assert.deepEqual(afterPersistence.map((message) => message.id), [
+    'server-user-1',
+    'server-assistant-1',
+  ]);
+});

package/templates/chat/vite.config.ts

@@ -1,4 +1,4 @@
-import { defineConfig, loadEnv } from 'vite';
+import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 import tailwindcss from '@tailwindcss/vite';
 import { pyric } from '@pyric/cli/vite';
@@ -11,44 +11,11 @@ import path from 'node:path';
 // self-contained sandbox preview you can serve under `pyric dev`, build with a
 // non-production mode: `vite build --mode development` (see the `build:sandbox`
 // script). That output is marked and can never be deployed.
-export default defineConfig(({ mode }) => {
-  const env = loadEnv(mode, process.cwd(), '');
-  const proxyUpstream = env.PYRIC_AI_PROXY_UPSTREAM;
-  const model = env.PYRIC_AI_MODEL;
-  if (Boolean(proxyUpstream) !== Boolean(model)) {
-    throw new Error(
-      'PyChat local AI configuration requires both PYRIC_AI_PROXY_UPSTREAM and PYRIC_AI_MODEL.',
-    );
-  }
-
-  return {
-    plugins: [
-      react(),
-      tailwindcss(),
-      pyric({
-        bridge: true,
-        // The authored 2+modules source is the source of truth; the plugin
-        // resolves it in-memory, so no vendored firestore.rules is needed in
-        // dev. `npm run rules:resolve` still generates it for Firebase deploy.
-        rules: 'firestore.modules.rules',
-        ...(proxyUpstream && model
-          ? {
-              ai: {
-                proxyUpstream,
-                engine: {
-                  kind: 'openai' as const,
-                  model,
-                  modelMap: { 'gemini-2.5-flash': model },
-                },
-              },
-            }
-          : {}),
-      }),
-    ],
-    resolve: {
-      alias: {
-        '@': path.resolve(__dirname, './src'),
-      },
+export default defineConfig({
+  plugins: [react(), tailwindcss(), pyric()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
     },
-  };
+  },
 });