@valbuild/shared 0.117.0 → 0.120.0

package/CHANGELOG.md

@@ -1,5 +1,71 @@
 # @valbuild/shared
 
+## 0.120.0
+
+### Minor Changes
+
+- [#589](https://github.com/valbuild/val/pull/589) [`c2d3c0e`](https://github.com/valbuild/val/commit/c2d3c0e6c2010c0a94c725d9dbaa618998773e8a) Thanks [@freekh](https://github.com/freekh)! - **Breaking:** `s.richtext()` options are flat.
+
+  The `style`, `block` and `inline` groups are gone — every option is a key of its
+  own. The names are unchanged, so updating a schema is only a matter of removing
+  the wrappers:
+
+  ```ts
+  // before
+  s.richtext({
+    style: { bold: true, italic: true },
+    block: { h1: true, ul: true },
+    inline: { a: true, img: s.image() },
+  });
+
+  // after
+  s.richtext({
+    bold: true,
+    italic: true,
+    h1: true,
+    ul: true,
+    a: true,
+    img: s.image(),
+  });
+  ```
+
+  The groups never carried any meaning the option names did not already have, and
+  they cost something real: an option name and its `ValRichText` theme key were
+  spelled differently (`block.h1` vs `theme.h1`), so the type that keeps a theme
+  exhaustive had to restate all thirteen options by hand. It is now a mapped type
+  over the options themselves — which also fixes an inconsistency in it: enabling
+  links with a schema (`a: s.route()`) rather than `a: true` now requires an `a`
+  key in the theme, the way `img` always has.
+
+  `ValRichText` themes were already flat and are unchanged. The serialized schema
+  that the server sends the Studio is flat too, so a project must not mix
+  `@valbuild/*` versions across this release.
+
+### Patch Changes
+
+- Updated dependencies [[`c2d3c0e`](https://github.com/valbuild/val/commit/c2d3c0e6c2010c0a94c725d9dbaa618998773e8a)]:
+  - @valbuild/core@0.120.0
+
+## 0.118.0
+
+### Minor Changes
+
+- [#574](https://github.com/valbuild/val/pull/574) [`198ba8b`](https://github.com/valbuild/val/commit/198ba8bd8e6c921660e97f5cd26fb17f2d5f3f95) Thanks [@freekh](https://github.com/freekh)! - The assistant lets you pick which model answers, from the models your key can
+  actually reach.
+
+  The content server now asks each provider what a key may use and reports the
+  answer; the Studio offers exactly that, beside the composer. Which model to use
+  is a per-message decision — something cheap for a typo, something strong for a
+  hard question — so the control sits where the message is written rather than in
+  a settings panel.
+
+  The choice is remembered per browser and re-checked against what is on offer
+  each time the assistant starts, so a model an account has lost access to is
+  quietly replaced instead of being sent and refused.
+
+  A content server that does not report models, or could not reach a provider,
+  leaves the built-in catalog as the fallback, filtered to reachable providers.
+
 ## 0.117.0
 
 ### Patch Changes

package/dist/declarations/src/internal/ApiRoutes.d.ts

@@ -1035,6 +1035,12 @@ export declare const Api: {
                     nonce: z.ZodString;
                     wsUrl: z.ZodString;
                     providers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        provider: z.ZodString;
+                        model: z.ZodString;
+                        label: z.ZodString;
+                        contextWindow: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    }, z.core.$strip>>>;
                 }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 status: z.ZodLiteral<500>;

package/internal/dist/valbuild-shared-internal.cjs.dev.js

@@ -1123,25 +1123,24 @@ var SerializedImageSchema = zod.z.object({
 });
 var RichTextOptions = zod.z.lazy(function () {
   return zod.z.object({
-    style: zod.z.object({
-      bold: zod.z["boolean"]().optional(),
-      italic: zod.z["boolean"]().optional(),
-      lineThrough: zod.z["boolean"]().optional()
-    }).optional(),
-    block: zod.z.object({
-      h1: zod.z["boolean"]().optional(),
-      h2: zod.z["boolean"]().optional(),
-      h3: zod.z["boolean"]().optional(),
-      h4: zod.z["boolean"]().optional(),
-      h5: zod.z["boolean"]().optional(),
-      h6: zod.z["boolean"]().optional(),
-      ul: zod.z["boolean"]().optional(),
-      ol: zod.z["boolean"]().optional()
-    }).optional(),
-    inline: zod.z.object({
-      a: zod.z.union([zod.z["boolean"](), SerializedRouteSchema, SerializedStringSchema]).optional(),
-      img: zod.z.union([zod.z["boolean"](), SerializedImageSchema]).optional()
-    }).optional()
+    // Set by `.maxLength()` / `.minLength()`, not by the options argument.
+    // These z.objects strip unknown keys, so leaving them out drops the
+    // length constraints in transit.
+    maxLength: zod.z.number().optional(),
+    minLength: zod.z.number().optional(),
+    bold: zod.z["boolean"]().optional(),
+    italic: zod.z["boolean"]().optional(),
+    lineThrough: zod.z["boolean"]().optional(),
+    h1: zod.z["boolean"]().optional(),
+    h2: zod.z["boolean"]().optional(),
+    h3: zod.z["boolean"]().optional(),
+    h4: zod.z["boolean"]().optional(),
+    h5: zod.z["boolean"]().optional(),
+    h6: zod.z["boolean"]().optional(),
+    ul: zod.z["boolean"]().optional(),
+    ol: zod.z["boolean"]().optional(),
+    a: zod.z.union([zod.z["boolean"](), SerializedRouteSchema, SerializedStringSchema]).optional(),
+    img: zod.z.union([zod.z["boolean"](), SerializedImageSchema]).optional()
   });
 });
 var SerializedRichTextSchema = zod.z.object({
@@ -2203,7 +2202,28 @@ var Api = {
            * reject the whole response over a name this version has not heard
            * of. Unknown entries are simply ignored.
            */
-          providers: zod.z.array(zod.z.string()).optional()
+          providers: zod.z.array(zod.z.string()).optional(),
+          /**
+           * The models those keys can actually use, as the providers report
+           * them.
+           *
+           * Which models *exist* is something only the provider knows: it
+           * depends on the account, its tier, and what has shipped since this
+           * Studio was built. So the server asks and passes the answer on,
+           * and the picker offers exactly this.
+           *
+           * Optional and loosely typed for the same reason as `providers`: a
+           * content server that does not report them, or reports a provider
+           * this version has not heard of, must not invalidate the whole
+           * response. Absent or empty means fall back to the built-in
+           * catalog.
+           */
+          models: zod.z.array(zod.z.object({
+            provider: zod.z.string(),
+            model: zod.z.string(),
+            label: zod.z.string(),
+            contextWindow: zod.z.number().nullable().optional()
+          })).optional()
         })
       }), zod.z.object({
         status: zod.z.literal(500),
@@ -3646,7 +3666,7 @@ function getInlineImgInfo(richtextSchema) {
   if (richtextSchema.type !== "richtext") return {
     kind: "not-allowed"
   };
-  var img = (_richtextSchema$optio = richtextSchema.options) === null || _richtextSchema$optio === void 0 || (_richtextSchema$optio = _richtextSchema$optio.inline) === null || _richtextSchema$optio === void 0 ? void 0 : _richtextSchema$optio.img;
+  var img = (_richtextSchema$optio = richtextSchema.options) === null || _richtextSchema$optio === void 0 ? void 0 : _richtextSchema$optio.img;
   if (!img) return {
     kind: "not-allowed"
   };

package/internal/dist/valbuild-shared-internal.cjs.prod.js

@@ -1123,25 +1123,24 @@ var SerializedImageSchema = zod.z.object({
 });
 var RichTextOptions = zod.z.lazy(function () {
   return zod.z.object({
-    style: zod.z.object({
-      bold: zod.z["boolean"]().optional(),
-      italic: zod.z["boolean"]().optional(),
-      lineThrough: zod.z["boolean"]().optional()
-    }).optional(),
-    block: zod.z.object({
-      h1: zod.z["boolean"]().optional(),
-      h2: zod.z["boolean"]().optional(),
-      h3: zod.z["boolean"]().optional(),
-      h4: zod.z["boolean"]().optional(),
-      h5: zod.z["boolean"]().optional(),
-      h6: zod.z["boolean"]().optional(),
-      ul: zod.z["boolean"]().optional(),
-      ol: zod.z["boolean"]().optional()
-    }).optional(),
-    inline: zod.z.object({
-      a: zod.z.union([zod.z["boolean"](), SerializedRouteSchema, SerializedStringSchema]).optional(),
-      img: zod.z.union([zod.z["boolean"](), SerializedImageSchema]).optional()
-    }).optional()
+    // Set by `.maxLength()` / `.minLength()`, not by the options argument.
+    // These z.objects strip unknown keys, so leaving them out drops the
+    // length constraints in transit.
+    maxLength: zod.z.number().optional(),
+    minLength: zod.z.number().optional(),
+    bold: zod.z["boolean"]().optional(),
+    italic: zod.z["boolean"]().optional(),
+    lineThrough: zod.z["boolean"]().optional(),
+    h1: zod.z["boolean"]().optional(),
+    h2: zod.z["boolean"]().optional(),
+    h3: zod.z["boolean"]().optional(),
+    h4: zod.z["boolean"]().optional(),
+    h5: zod.z["boolean"]().optional(),
+    h6: zod.z["boolean"]().optional(),
+    ul: zod.z["boolean"]().optional(),
+    ol: zod.z["boolean"]().optional(),
+    a: zod.z.union([zod.z["boolean"](), SerializedRouteSchema, SerializedStringSchema]).optional(),
+    img: zod.z.union([zod.z["boolean"](), SerializedImageSchema]).optional()
   });
 });
 var SerializedRichTextSchema = zod.z.object({
@@ -2203,7 +2202,28 @@ var Api = {
            * reject the whole response over a name this version has not heard
            * of. Unknown entries are simply ignored.
            */
-          providers: zod.z.array(zod.z.string()).optional()
+          providers: zod.z.array(zod.z.string()).optional(),
+          /**
+           * The models those keys can actually use, as the providers report
+           * them.
+           *
+           * Which models *exist* is something only the provider knows: it
+           * depends on the account, its tier, and what has shipped since this
+           * Studio was built. So the server asks and passes the answer on,
+           * and the picker offers exactly this.
+           *
+           * Optional and loosely typed for the same reason as `providers`: a
+           * content server that does not report them, or reports a provider
+           * this version has not heard of, must not invalidate the whole
+           * response. Absent or empty means fall back to the built-in
+           * catalog.
+           */
+          models: zod.z.array(zod.z.object({
+            provider: zod.z.string(),
+            model: zod.z.string(),
+            label: zod.z.string(),
+            contextWindow: zod.z.number().nullable().optional()
+          })).optional()
         })
       }), zod.z.object({
         status: zod.z.literal(500),
@@ -3646,7 +3666,7 @@ function getInlineImgInfo(richtextSchema) {
   if (richtextSchema.type !== "richtext") return {
     kind: "not-allowed"
   };
-  var img = (_richtextSchema$optio = richtextSchema.options) === null || _richtextSchema$optio === void 0 || (_richtextSchema$optio = _richtextSchema$optio.inline) === null || _richtextSchema$optio === void 0 ? void 0 : _richtextSchema$optio.img;
+  var img = (_richtextSchema$optio = richtextSchema.options) === null || _richtextSchema$optio === void 0 ? void 0 : _richtextSchema$optio.img;
   if (!img) return {
     kind: "not-allowed"
   };

package/internal/dist/valbuild-shared-internal.esm.js

@@ -1119,25 +1119,24 @@ var SerializedImageSchema = z.object({
 });
 var RichTextOptions = z.lazy(function () {
   return z.object({
-    style: z.object({
-      bold: z["boolean"]().optional(),
-      italic: z["boolean"]().optional(),
-      lineThrough: z["boolean"]().optional()
-    }).optional(),
-    block: z.object({
-      h1: z["boolean"]().optional(),
-      h2: z["boolean"]().optional(),
-      h3: z["boolean"]().optional(),
-      h4: z["boolean"]().optional(),
-      h5: z["boolean"]().optional(),
-      h6: z["boolean"]().optional(),
-      ul: z["boolean"]().optional(),
-      ol: z["boolean"]().optional()
-    }).optional(),
-    inline: z.object({
-      a: z.union([z["boolean"](), SerializedRouteSchema, SerializedStringSchema]).optional(),
-      img: z.union([z["boolean"](), SerializedImageSchema]).optional()
-    }).optional()
+    // Set by `.maxLength()` / `.minLength()`, not by the options argument.
+    // These z.objects strip unknown keys, so leaving them out drops the
+    // length constraints in transit.
+    maxLength: z.number().optional(),
+    minLength: z.number().optional(),
+    bold: z["boolean"]().optional(),
+    italic: z["boolean"]().optional(),
+    lineThrough: z["boolean"]().optional(),
+    h1: z["boolean"]().optional(),
+    h2: z["boolean"]().optional(),
+    h3: z["boolean"]().optional(),
+    h4: z["boolean"]().optional(),
+    h5: z["boolean"]().optional(),
+    h6: z["boolean"]().optional(),
+    ul: z["boolean"]().optional(),
+    ol: z["boolean"]().optional(),
+    a: z.union([z["boolean"](), SerializedRouteSchema, SerializedStringSchema]).optional(),
+    img: z.union([z["boolean"](), SerializedImageSchema]).optional()
   });
 });
 var SerializedRichTextSchema = z.object({
@@ -2199,7 +2198,28 @@ var Api = {
            * reject the whole response over a name this version has not heard
            * of. Unknown entries are simply ignored.
            */
-          providers: z.array(z.string()).optional()
+          providers: z.array(z.string()).optional(),
+          /**
+           * The models those keys can actually use, as the providers report
+           * them.
+           *
+           * Which models *exist* is something only the provider knows: it
+           * depends on the account, its tier, and what has shipped since this
+           * Studio was built. So the server asks and passes the answer on,
+           * and the picker offers exactly this.
+           *
+           * Optional and loosely typed for the same reason as `providers`: a
+           * content server that does not report them, or reports a provider
+           * this version has not heard of, must not invalidate the whole
+           * response. Absent or empty means fall back to the built-in
+           * catalog.
+           */
+          models: z.array(z.object({
+            provider: z.string(),
+            model: z.string(),
+            label: z.string(),
+            contextWindow: z.number().nullable().optional()
+          })).optional()
         })
       }), z.object({
         status: z.literal(500),
@@ -3642,7 +3662,7 @@ function getInlineImgInfo(richtextSchema) {
   if (richtextSchema.type !== "richtext") return {
     kind: "not-allowed"
   };
-  var img = (_richtextSchema$optio = richtextSchema.options) === null || _richtextSchema$optio === void 0 || (_richtextSchema$optio = _richtextSchema$optio.inline) === null || _richtextSchema$optio === void 0 ? void 0 : _richtextSchema$optio.img;
+  var img = (_richtextSchema$optio = richtextSchema.options) === null || _richtextSchema$optio === void 0 ? void 0 : _richtextSchema$optio.img;
   if (!img) return {
     kind: "not-allowed"
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.117.0",
+  "version": "0.120.0",
   "private": false,
   "description": "Val shared types and utilities",
   "repository": {
@@ -31,7 +31,7 @@
   "dependencies": {
     "zod": "^4.4.3",
     "zod-validation-error": "^5.0.0",
-    "@valbuild/core": "0.117.0"
+    "@valbuild/core": "0.120.0"
   },
   "files": [
     "CHANGELOG.md",