@voltro/cli 0.15.0 → 0.16.0

package/dist/{dev-BHLM3RPX.js → dev-HdG7JdSk.js}

@@ -1,3 +1,3 @@
 import "./seedRunner-D6eu-u5U.js";
-import { c as e, f as t, s as n } from "./dev-C2lCUhYI.js";
+import { c as e, f as t, s as n } from "./dev-DGjEvvkV.js";
 export { n as loadApiConfig, e as loadDiscovered, t as walk };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as e, i as t, n, o as r, r as i, t as a } from "./commands-CPQuQRXh.js";
+import { a as e, i as t, n, o as r, r as i, t as a } from "./commands-8A5RU3MW.js";
 //#region src/index.ts
 var o = "framework";
 //#endregion

package/dist/{serveCommand-DBzQcCuv.js → serveCommand-C3lq3mFd.js}

@@ -3,8 +3,8 @@ import { s as n } from "./seedRunner-D6eu-u5U.js";
 import { r, t as i } from "./appModuleLoader-C9r9mxZt.js";
 import { f as a, m as o, n as s, p as c, u as l } from "./frameworkTableAssembly-BA2bAmYN.js";
 import { l as u } from "./fileConventions-Cu0tM-Bl.js";
-import { $ as d, A as ee, B as f, C as te, D as ne, E as re, F as p, H as ie, I as m, J as h, K as ae, L as oe, M as g, N as _, O as se, P as v, Q as y, S as ce, T as le, V as ue, X as de, Y as b, Z as x, _ as fe, a as S, b as C, c as pe, et as me, f as w, g as he, h as ge, j as _e, k as ve, n as ye, p as T, q as be, r as xe, s as Se, v as Ce, w as we, x as Te, y as E, z as Ee } from "./dev-C2lCUhYI.js";
-import { c as D, r as De } from "./apiBuild-CHItlwPO.js";
+import { $ as d, A as ee, B as f, C as te, D as ne, E as re, F as p, H as ie, I as m, J as h, K as ae, L as oe, M as g, N as _, O as se, P as v, Q as y, S as ce, T as le, V as ue, X as de, Y as b, Z as x, _ as fe, a as S, b as C, c as pe, et as me, f as w, g as he, h as ge, j as _e, k as ve, n as ye, p as T, q as be, r as xe, s as Se, v as Ce, w as we, x as Te, y as E, z as Ee } from "./dev-DGjEvvkV.js";
+import { c as D, r as De } from "./apiBuild-BJtiqoOu.js";
 import { t as Oe } from "./bootTiming-BdyP9nYw.js";
 import { n as ke } from "./cliArgs-qdZSElM3.js";
 import { join as Ae } from "node:path";
@@ -750,6 +750,7 @@ var rn = "/_voltro/admin/import", an = "/_voltro/admin/export", Q = (e, t) => ({
 			...Qe ? { ping: Qe } : {}
 		},
 		...Ee.length > 0 ? { httpRoutes: Ee } : {},
+		...e.getStore === void 0 ? {} : { getStore: e.getStore },
 		...oe.size > 0 ? { webhookRoutes: oe } : {}
 	});
 	if (await Re(at), (e.discovered.schedules?.length ?? 0) > 0) {
@@ -1082,6 +1083,7 @@ var rn = "/_voltro/admin/import", an = "/_voltro/admin/export", Q = (e, t) => ({
 			clientId: t
 		}),
 		httpRoutes: [...I.flatMap((e) => e.httpRoutes ?? []), ...yt],
+		getStore: () => N,
 		...V ? { baseLayer: V } : {},
 		...G === void 0 ? {} : { workflowEngineLayer: G },
 		scheduleDefaultTrigger: H,

package/dist/serveEntry.js

@@ -1,5 +1,5 @@
 import { $ as e } from "./inspectMetrics-CYDSO3za.js";
 import { c as t } from "./seedRunner-D6eu-u5U.js";
 import { r as n } from "./appModuleLoader-C9r9mxZt.js";
-import { t as r } from "./serveCommand-DBzQcCuv.js";
+import { t as r } from "./serveCommand-C3lq3mFd.js";
 export { e as loadDotEnv, n as registerAppModules, t as registerDriver, r as runServe };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/cli",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "The `voltro` CLI — dev server, codegen, migrations, project scaffolding, agent-docs seeding, and production serve.",
   "keywords": [
     "voltro",
@@ -62,22 +62,22 @@
     "@effect/platform-node": "^0.107.0",
     "@effect/sql": "^0.51.1",
     "@effect/workflow": "^0.18.2",
-    "@voltro/ai": "0.15.0",
-    "@voltro/cache": "0.15.0",
-    "@voltro/data-transfer": "0.15.0",
-    "@voltro/database": "0.15.0",
-    "@voltro/env": "0.15.0",
-    "@voltro/kv": "0.15.0",
-    "@voltro/logger": "0.15.0",
-    "@voltro/plugin-auth": "0.15.0",
-    "@voltro/plugin-broadcast": "0.15.0",
-    "@voltro/plugin-mail": "0.15.0",
-    "@voltro/plugin-storage": "0.15.0",
-    "@voltro/plugin-webhooks": "0.15.0",
-    "@voltro/protocol": "0.15.0",
-    "@voltro/runtime": "0.15.0",
-    "@voltro/serverless": "0.15.0",
-    "@voltro/workflow": "0.15.0",
+    "@voltro/ai": "0.16.0",
+    "@voltro/cache": "0.16.0",
+    "@voltro/data-transfer": "0.16.0",
+    "@voltro/database": "0.16.0",
+    "@voltro/env": "0.16.0",
+    "@voltro/kv": "0.16.0",
+    "@voltro/logger": "0.16.0",
+    "@voltro/plugin-auth": "0.16.0",
+    "@voltro/plugin-broadcast": "0.16.0",
+    "@voltro/plugin-mail": "0.16.0",
+    "@voltro/plugin-storage": "0.16.0",
+    "@voltro/plugin-webhooks": "0.16.0",
+    "@voltro/protocol": "0.16.0",
+    "@voltro/runtime": "0.16.0",
+    "@voltro/serverless": "0.16.0",
+    "@voltro/workflow": "0.16.0",
     "chokidar": "^5.0.0",
     "ioredis": "^5.11.1",
     "tinyglobby": "^0.2.17",

package/templates/AGENTS.md

@@ -526,7 +526,7 @@ each plugin's own README.
 
 | Topic | Open | Summary |
 |---|---|---|
-| **What's new in 0.14.0** | `node_modules/@voltro/cli/templates/agent-docs/whats-new.md` | Everything that changed in this version. Read it before hand-rolling something the framework may now ship. |
+| **What's new in 0.15.0** | `node_modules/@voltro/cli/templates/agent-docs/whats-new.md` | Everything that changed in this version. Read it before hand-rolling something the framework may now ship. |
 | AI | `node_modules/@voltro/cli/templates/agent-docs/ai.md` | How Voltro treats AI — agents, tools, streaming, RAG — all primitives over the same WebSocket as the rest of the framework. |
 | Authentication | `node_modules/@voltro/cli/templates/agent-docs/authentication.md` | How @voltro/plugin-auth wires password + session-cookie auth across api + web, plus the pluggable identity-strategy protocol. |
 | Caching | `node_modules/@voltro/cli/templates/agent-docs/caching.md` | Voltro's caching layer (@voltro/cache) — an always-on memory default, swappable Redis-compatible backends, a low-level wrap primitive, and automatic query-result invalidation. |

package/templates/agent-docs/_index.md

@@ -9,7 +9,7 @@ each plugin's own README.
 
 | Topic | Open | Summary |
 |---|---|---|
-| **What's new in 0.14.0** | `node_modules/@voltro/cli/templates/agent-docs/whats-new.md` | Everything that changed in this version. Read it before hand-rolling something the framework may now ship. |
+| **What's new in 0.15.0** | `node_modules/@voltro/cli/templates/agent-docs/whats-new.md` | Everything that changed in this version. Read it before hand-rolling something the framework may now ship. |
 | AI | `node_modules/@voltro/cli/templates/agent-docs/ai.md` | How Voltro treats AI — agents, tools, streaming, RAG — all primitives over the same WebSocket as the rest of the framework. |
 | Authentication | `node_modules/@voltro/cli/templates/agent-docs/authentication.md` | How @voltro/plugin-auth wires password + session-cookie auth across api + web, plus the pluggable identity-strategy protocol. |
 | Caching | `node_modules/@voltro/cli/templates/agent-docs/caching.md` | Voltro's caching layer (@voltro/cache) — an always-on memory default, swappable Redis-compatible backends, a low-level wrap primitive, and automatic query-result invalidation. |

package/templates/agent-docs/data.md

@@ -927,7 +927,15 @@ try {
 
 **Trace id for debugging.** An error caught from `useMutation` / `useAction` carries a **non-enumerable `__voltroTraceId`** — the bridge to the server logs for that exact call:
 
-```ts
+```
+`errorTag` lives in `@voltro/protocol` rather than in the client for a reason
+worth knowing before you decide where your own error handling goes: **`_tag` is a
+wire concept, and protocol owns the wire.** So a shared error handler in a package
+that has no business depending on `@voltro/client` — a UI kit, an i18n layer —
+can read a tag without taking that dependency. `instanceof` is the thing that
+does NOT survive the wire: what arrives in the browser was decoded from JSON and
+never constructed, so match on the tag, not on the class.
+ts
 const traceId = (err as { __voltroTraceId?: string }).__voltroTraceId
 // → `voltro logs --trace <traceId>` to see the server-side span
 ```

package/templates/agent-docs/plugins.md

@@ -126,7 +126,7 @@ Order matters: the framework composes outer→inner, so the rate-limit intercept
 | `extendSchema` | Contribute tables + custom SQL migrations (tracked in `_voltro_plugin_migrations`). |
 | `services` | Provide an Effect `Layer` whose Tags every handler can `yield*` (e.g. `MailService`, `StorageService`). |
 | `routes` | Register plugin-owned rpc queries / mutations / actions (alias-prefixed tags). |
-| `httpRoutes` | Serve public raw-HTTP endpoints on the framework listener (e.g. `GET /_voltro/storage/:id`). |
+| `httpRoutes` | Serve public raw-HTTP endpoints on the framework listener (e.g. `GET /_voltro/storage/:id`). The request carries `store` — the app's DataStore — for a route that must read or write (a login endpoint minting a session row cannot be an rpc mutation). Not tenant-scoped: raw HTTP has no resolved Subject, so scope it yourself. |
 | `inspectEndpoints` | Mount tooling under `/_voltro/inspect/plugins/<alias>/…`. |
 | `onScheduleFire` / `onWorkflowStep` / `onHttpRequest` | Wrap every cron firing, every workflow `step()`, every pre-auth HTTP request. |
 | `onInstall` / `onActivate` / `onDeactivate` / `onUninstall` | Lifecycle hooks at first-install, boot, shutdown, and removal. |