@vistagenic/vista 0.3.6 → 0.3.9

package/package.json

@@ -1,178 +1,196 @@
-{
-  "name": "@vistagenic/vista",
-  "version": "0.3.6",
-  "description": "The React Framework for Visionaries - Rust-powered SSR with Server Components",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Mantitup-Org/vista.git",
-    "directory": "packages/vista"
-  },
-  "author": "Vista Team",
-  "license": "MIT",
-  "keywords": [
-    "react",
-    "framework",
-    "ssr",
-    "server-components",
-    "rsc",
-    "rust",
-    "swc",
-    "vista"
-  ],
-  "files": [
-    "dist",
-    "bin"
-  ],
-  "exports": {
-    ".": {
-      "react-server": "./dist/react-server.js",
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./link": {
-      "react-server": "./dist/client/link.react-server.js",
-      "types": "./dist/client/link.d.ts",
-      "default": "./dist/client/link.js"
-    },
-    "./image": {
-      "react-server": "./dist/image/react-server.js",
-      "types": "./dist/image/index.d.ts",
-      "default": "./dist/image/index.js"
-    },
-    "./router": {
-      "react-server": "./dist/client/router.react-server.js",
-      "types": "./dist/client/router.d.ts",
-      "default": "./dist/client/router.js"
-    },
-    "./navigation": {
-      "react-server": "./dist/client/navigation.react-server.js",
-      "types": "./dist/client/navigation.d.ts",
-      "default": "./dist/client/navigation.js"
-    },
-    "./dynamic": {
-      "react-server": "./dist/client/dynamic.react-server.js",
-      "types": "./dist/client/dynamic.d.ts",
-      "default": "./dist/client/dynamic.js"
-    },
-    "./script": {
-      "react-server": "./dist/client/script.react-server.js",
-      "types": "./dist/client/script.d.ts",
-      "default": "./dist/client/script.js"
-    },
-    "./font": {
-      "types": "./dist/font/index.d.ts",
-      "default": "./dist/font/index.js"
-    },
-    "./font/google": {
-      "types": "./dist/font/google.d.ts",
-      "default": "./dist/font/google.js"
-    },
-    "./font/local": {
-      "types": "./dist/font/local.d.ts",
-      "default": "./dist/font/local.js"
-    },
-    "./theme": {
-      "react-server": "./dist/theme/react-server.js",
-      "types": "./dist/theme/index.d.ts",
-      "default": "./dist/theme/index.js"
-    },
-    "./head": {
-      "react-server": "./dist/client/head.react-server.js",
-      "types": "./dist/client/head.d.ts",
-      "default": "./dist/client/head.js"
-    },
-    "./config": {
-      "types": "./dist/config.d.ts",
-      "default": "./dist/config.js"
-    },
-    "./auth": {
-      "types": "./dist/auth/index.d.ts",
-      "default": "./dist/auth/index.js"
-    },
-    "./auth/react": {
-      "react-server": "./dist/auth/react-server.js",
-      "types": "./dist/auth/react.d.ts",
-      "default": "./dist/auth/react.js"
-    },
-    "./ai": {
-      "types": "./dist/ai/index.d.ts",
-      "default": "./dist/ai/index.js"
-    },
-    "./ai/react": {
-      "react-server": "./dist/ai/react/react-server.js",
-      "types": "./dist/ai/react/index.d.ts",
-      "default": "./dist/ai/react/index.js"
-    },
-    "./stack": {
-      "types": "./dist/stack/index.d.ts",
-      "default": "./dist/stack/index.js"
-    },
-    "./stack/client": {
-      "types": "./dist/stack/client/index.d.ts",
-      "default": "./dist/stack/client/index.js"
-    },
-    "./client/rsc-router": {
-      "react-server": "./dist/client/rsc-router.react-server.js",
-      "types": "./dist/client/rsc-router.d.ts",
-      "default": "./dist/client/rsc-router.js"
-    },
-    "./client/server-actions": {
-      "types": "./dist/client/server-actions.d.ts",
-      "default": "./dist/client/server-actions.js"
-    },
-    "./server": {
-      "types": "./dist/server/index.d.ts",
-      "default": "./dist/server/index.js"
-    },
-    "./server/runtime-actions": {
-      "types": "./dist/server/runtime-actions.d.ts",
-      "default": "./dist/server/runtime-actions.js"
-    },
-    "./cache": {
-      "types": "./dist/server/cache.d.ts",
-      "default": "./dist/server/cache.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "bin": {
-    "vista": "bin/vista.js"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc"
-  },
-  "dependencies": {
-    "@pmmmwh/react-refresh-webpack-plugin": "^0.5.11",
-    "@swc-node/register": "^1.9.0",
-    "@swc/core": "^1.4.0",
-    "chokidar": "^3.6.0",
-    "css-loader": "^7.1.2",
-    "esbuild": "^0.24.2",
-    "express": "^4.21.2",
-    "mini-css-extract-plugin": "^2.9.4",
-    "null-loader": "^4.0.1",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "react-refresh": "^0.14.0",
-    "react-server-dom-webpack": "^19.0.0",
-    "swc-loader": "^0.2.6",
-    "ts-node": "^10.9.2",
-    "webpack": "^5.90.0",
-    "webpack-dev-middleware": "^7.0.0",
-    "webpack-hot-middleware": "^2.26.0"
-  },
-  "devDependencies": {
-    "@types/express": "^5.0.0",
-    "@types/node": "^22.10.2",
-    "@types/react": "^19.0.1",
-    "@types/react-dom": "^19.0.2",
-    "@types/webpack": "^5.28.5",
-    "@types/webpack-hot-middleware": "^2.25.9",
-    "typescript": "^5.7.2"
-  },
-  "gitHead": "d1b9f715d6365d8e1f553e96b752fbce8d98df7c"
-}
+{
+  "name": "@vistagenic/vista",
+  "version": "0.3.9",
+  "description": "The React Framework for Visionaries - Rust-powered SSR with Server Components",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mantitup-Org/vista.git",
+    "directory": "packages/vista"
+  },
+  "author": "Vista Team",
+  "license": "MIT",
+  "keywords": [
+    "react",
+    "framework",
+    "ssr",
+    "server-components",
+    "rsc",
+    "rust",
+    "swc",
+    "vista"
+  ],
+  "files": [
+    "dist",
+    "bin",
+    "native",
+    "docs",
+    "skills"
+  ],
+  "exports": {
+    ".": {
+      "react-server": "./dist/react-server.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./link": {
+      "react-server": "./dist/client/link.react-server.js",
+      "types": "./dist/client/link.d.ts",
+      "default": "./dist/client/link.js"
+    },
+    "./image": {
+      "react-server": "./dist/image/react-server.js",
+      "types": "./dist/image/index.d.ts",
+      "default": "./dist/image/index.js"
+    },
+    "./router": {
+      "react-server": "./dist/client/router.react-server.js",
+      "types": "./dist/client/router.d.ts",
+      "default": "./dist/client/router.js"
+    },
+    "./navigation": {
+      "react-server": "./dist/client/navigation.react-server.js",
+      "types": "./dist/client/navigation.d.ts",
+      "default": "./dist/client/navigation.js"
+    },
+    "./dynamic": {
+      "react-server": "./dist/client/dynamic.react-server.js",
+      "types": "./dist/client/dynamic.d.ts",
+      "default": "./dist/client/dynamic.js"
+    },
+    "./script": {
+      "react-server": "./dist/client/script.react-server.js",
+      "types": "./dist/client/script.d.ts",
+      "default": "./dist/client/script.js"
+    },
+    "./font": {
+      "types": "./dist/font/index.d.ts",
+      "default": "./dist/font/index.js"
+    },
+    "./font/google": {
+      "types": "./dist/font/google.d.ts",
+      "default": "./dist/font/google.js"
+    },
+    "./font/local": {
+      "types": "./dist/font/local.d.ts",
+      "default": "./dist/font/local.js"
+    },
+    "./theme": {
+      "react-server": "./dist/theme/react-server.js",
+      "types": "./dist/theme/index.d.ts",
+      "default": "./dist/theme/index.js"
+    },
+    "./head": {
+      "react-server": "./dist/client/head.react-server.js",
+      "types": "./dist/client/head.d.ts",
+      "default": "./dist/client/head.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "default": "./dist/auth/index.js"
+    },
+    "./auth/react": {
+      "react-server": "./dist/auth/react-server.js",
+      "types": "./dist/auth/react.d.ts",
+      "default": "./dist/auth/react.js"
+    },
+    "./ai": {
+      "types": "./dist/ai/index.d.ts",
+      "default": "./dist/ai/index.js"
+    },
+    "./ai/react": {
+      "react-server": "./dist/ai/react/react-server.js",
+      "types": "./dist/ai/react/index.d.ts",
+      "default": "./dist/ai/react/index.js"
+    },
+    "./stack": {
+      "types": "./dist/stack/index.d.ts",
+      "default": "./dist/stack/index.js"
+    },
+    "./stack/client": {
+      "types": "./dist/stack/client/index.d.ts",
+      "default": "./dist/stack/client/index.js"
+    },
+    "./client/rsc-router": {
+      "react-server": "./dist/client/rsc-router.react-server.js",
+      "types": "./dist/client/rsc-router.d.ts",
+      "default": "./dist/client/rsc-router.js"
+    },
+    "./client/server-actions": {
+      "types": "./dist/client/server-actions.d.ts",
+      "default": "./dist/client/server-actions.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "default": "./dist/server/index.js"
+    },
+    "./server/runtime-actions": {
+      "types": "./dist/server/runtime-actions.d.ts",
+      "default": "./dist/server/runtime-actions.js"
+    },
+    "./cache": {
+      "types": "./dist/server/cache.d.ts",
+      "default": "./dist/server/cache.js"
+    },
+    "./metadata": {
+      "types": "./dist/metadata/index.d.ts",
+      "default": "./dist/metadata/index.js"
+    },
+    "./og": {
+      "types": "./dist/og/index.d.ts",
+      "default": "./dist/og/index.js"
+    },
+    "./rust": {
+      "types": "./dist/rust/index.d.ts",
+      "default": "./dist/rust/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "vista": "bin/vista.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "stage:flashpack": "node scripts/stage-flashpack-binary.mjs"
+  },
+  "dependencies": {
+    "@pmmmwh/react-refresh-webpack-plugin": "^0.5.11",
+    "@swc-node/register": "^1.9.0",
+    "@swc/core": "^1.4.0",
+    "chokidar": "^3.6.0",
+    "css-loader": "^7.1.2",
+    "esbuild": "^0.24.2",
+    "express": "^4.21.2",
+    "mini-css-extract-plugin": "^2.9.4",
+    "null-loader": "^4.0.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-refresh": "^0.14.0",
+    "react-server-dom-webpack": "^19.0.0",
+    "satori": "^0.12.2",
+    "@resvg/resvg-wasm": "^2.6.2",
+    "swc-loader": "^0.2.6",
+    "ts-node": "^10.9.2",
+    "webpack": "^5.90.0",
+    "webpack-dev-middleware": "^7.0.0",
+    "webpack-hot-middleware": "^2.26.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.0.1",
+    "@types/react-dom": "^19.0.2",
+    "@types/webpack": "^5.28.5",
+    "@types/webpack-hot-middleware": "^2.25.9",
+    "typescript": "^5.7.2"
+  },
+  "gitHead": "d1b9f715d6365d8e1f553e96b752fbce8d98df7c"
+}

package/skills/README.md

@@ -0,0 +1,9 @@
+# Vista agent skills
+
+These skills ship inside the `vista` package at `skills/`. An app's `AGENTS.md` points agents here. Read the `SKILL.md` that matches the task. Framework lookups stay in `docs/`.
+
+| Skill | When |
+| --- | --- |
+| `vista-dev-loop` | After an edit, verify the running `vista dev` server |
+| `vista-agent` | Add an agent, tools, and a streaming chat route |
+| `vista-rag` | Ground an agent with `InMemoryVectorStore` |

package/skills/vista-agent/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: vista-agent
+description: >
+  Add a Vista AI agent, tool, and streaming chat route. Use when the user
+  asks for a chat agent, tool calling, `vista g agent`, `useAgent`, or
+  `vista/ai`. Do not install a third-party agent SDK.
+---
+
+# Add a Vista agent
+
+Read `docs/ai.md` in this package before editing.
+
+## Steps
+
+1. From the app root, run `vista g agent <name>`. The name is kebab-case. This writes:
+   - `app/agents/<name>/agent.ts`
+   - `app/api/agents/<name>/route.ts`
+   - `app/AGENTS.md` when that file is missing
+2. Edit the generated agent. Keep `import { agent, tool } from 'vista/ai'`. Set `model` to `process.env.VISTA_AI_MODEL` or an explicit `provider:model` string from `docs/ai.md`. Put real tools in `tools`. Leave `memory: true` unless the user asked for a stateless agent.
+3. Keep the generated `POST` handler. It must call `<name>Agent.stream({ prompt, messages, sessionId })` and `return stream.toDataStreamResponse()`.
+4. Add a client page with `'use client'` and `useAgent({ api: '/api/agents/<name>' })` from `vista/ai/react`.
+5. Do not commit API keys. Tell the user which env var the chosen provider needs (`OPENAI_API_KEY`, `GROQ_API_KEY`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY`, or `NVIDIA_API_KEY`).
+6. Verify with the `vista-dev-loop` skill: `POST /api/agents/<name>` with a JSON body `{ "prompt": "ping" }` and confirm the terminal shows the request rather than a compile error.
+
+## Do not
+
+- Import from `@vistagenic/vista/ai` inside an app. Apps use `vista/ai`.
+- Create `app/page.tsx` or `app/layout.tsx`. Home is `app/index.tsx`. The root layout is `app/root.tsx`.

package/skills/vista-dev-loop/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: vista-dev-loop
+description: >
+  Verify a Vista app edit against the running dev server. Use after changing
+  pages, layouts, routes, styles, or client state in an app whose scripts are
+  `vista dev` / `vista build`. Covers port 3003, `.vista` vs `.flash`, and
+  reading the dev terminal before claiming the change works.
+---
+
+# Vista dev loop
+
+Run this after each edit that changes what the user sees or what a route returns. Do not claim the UI works from a file read alone.
+
+## Steps
+
+1. Confirm the app scripts are `vista dev`, `vista build`, and `vista start`. Do not rename them when `vista.config.ts` sets `engine.variant` to `flashpack`.
+2. Start `vista dev` if it is not already running. The default port is `3003`. If the port is taken, stop the existing Vista process and start once. Do not start a second server.
+3. Request the changed route. For a page, open `http://localhost:3003<path>`. For a route handler, call the HTTP method the file exports.
+4. Read the dev terminal. A successful page log looks like `GET / 200`. Compile and runtime errors are printed there. Fix the first error and request the route again.
+5. On the flashpack engine, dev artifacts are under `.flash/` (`dev/modules`, `dev/ssr`, `logs`). Production build artifacts stay under `.vista/`. Do not treat those folders as duplicates.
+6. When the change is visual or interactive, exercise the control (click, type, submit, navigate), including the empty and error states the edit touches.
+
+## Stop when
+
+The changed route returns the expected status, the terminal has no new error for that request, and the interaction you changed behaves correctly.

package/skills/vista-rag/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: vista-rag
+description: >
+  Ground a Vista agent with retrieval. Use when the user asks for RAG,
+  document search, embeddings, `InMemoryVectorStore`, `createRetrieverTool`,
+  or `embedText`. Keyword search needs no API key. Embeddings are optional.
+---
+
+# Add RAG to a Vista agent
+
+Read `docs/rag.md` in this package before editing.
+
+## Steps
+
+1. Run `vista g agent <name>` if the agent does not exist yet. Follow `vista-agent` for the route and the client page.
+2. Add a module such as `lib/rag.ts` that creates an `InMemoryVectorStore`, calls `addDocuments` (or `addDocument` when storing vectors), and exports a `createRetrieverTool`.
+3. Start with keyword search: omit `embed`. Use `model: 'mock:echo'` only for a smoke test. For a real answer, set `provider:model` and the matching API key.
+4. Pass that tool on the agent's `tools` array. The system prompt must tell the model to answer from the retriever results and to say when nothing matches.
+5. Add embeddings only when the user asks for semantic search. Use `embedText` from `vista/ai` with an OpenAI-compatible embedding model, store `vector` on each document, and pass the same function as `createRetrieverTool`'s `embed`.
+6. Verify with `vista-dev-loop`. `POST` a question whose answer is in the indexed text and confirm the route responds. Do not claim the model cited a chunk unless the response includes it.
+
+## Imports
+
+```ts
+import { agent, InMemoryVectorStore, createRetrieverTool, embedText } from 'vista/ai';
+```