@crossworks/client-types 0.232.309 → 0.232.314

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossworks/client-types",
-  "version": "0.232.309",
+  "version": "0.232.314",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/dto/access.ts

@@ -37,8 +37,11 @@ export type MemberItemAuthor = { name: string; acceptedAt: string | null };
 
 export type AccessNodeView = {
   item: AccessItemView;
-  /** What the item's link or embeds need: a page's files and drawings, a
-   *  folder's contents, a drawing's images. Each carries its own level. */
+  /** What the item's link or embeds need, each at its own level. For a page,
+   *  drawing or note: what it embeds (images, files, drawings, child pages,
+   *  transitively), which goes down with it when it is lowered (0.232.314
+   *  on; before that it only did on "Lower them too"). For a folder: its
+   *  contents, which keep their own levels. */
   closure: AccessItemView[];
   share: AccessLinkView | null;
   /** Descendant pages (pages only; 0 otherwise). */
@@ -47,17 +50,39 @@ export type AccessNodeView = {
   canLower: boolean;
   /** Whether the item can carry a link (a folder only under `files`). */
   canLink: boolean;
+  /** True for a page, drawing or note: lowering it lowers its embeds with it
+   *  (embedding means sharing), so the control says what will be shared
+   *  instead of offering "Lower them too". False for a folder, whose
+   *  contents keep their levels. Absent from brains before 0.232.314, which
+   *  lower embeds only on request. */
+  embedsFollow?: boolean;
   /** Set when a member wrote it and an admin accepted it into the brain (the
    *  member-authored badge). Absent from brains before 0.232.285. */
   author?: MemberItemAuthor | null;
 };
 
-/** PATCH /api/access/nodes/:id { audience, withClosure?, raiseClosure? } */
+/** One item that went down with the item that embeds it. */
+export type AccessLoweredView = {
+  id: string;
+  type: string;
+  title: string;
+  from: AccessLevel;
+  to: AccessLevel;
+};
+
+/** PATCH /api/access/nodes/:id { audience, withClosure?, raiseClosure? }.
+ *  `withClosure` only matters for a folder (its contents); a page's,
+ *  drawing's or note's embeds always follow it down. */
 export type AccessNodeUpdate = {
   item: AccessItemView;
-  /** Closure items lowered with it (only when `withClosure`). */
+  /** Everything lowered with it, at its new level: the embeds that followed
+   *  it and, with `withClosure`, a folder's contents. */
   lowered: AccessItemView[];
-  /** Closure items still above the new level (when not `withClosure`). */
+  /** The embeds that followed it down, with the level each left and took.
+   *  Absent from brains before 0.232.314. */
+  alsoLowered?: AccessLoweredView[];
+  /** Closure items still above the new level: an embed that can never go
+   *  below admin, or a folder's contents when not `withClosure`. */
   stillAbove: AccessItemView[];
   /** Closure items raised with it (only when `raiseClosure`). Absent from
    *  brains before 0.232.264. */

package/src/index.ts

@@ -37,6 +37,7 @@ export type {
   AccessItemView,
   AccessLevel,
   AccessLinkView,
+  AccessLoweredView,
   AccessNodeUpdate,
   AccessNodeView,
   MemberItemAuthor,

package/src/model-choices.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it } from 'vitest';
+import {
+  ASSISTANT_MODEL_CHOICES,
+  WORKER_MODEL_CHOICES,
+  formatUsdPerM,
+  templatePrice,
+} from './model-choices';
+
+describe('formatUsdPerM', () => {
+  it('rounds float noise from per-token × 1e6 to cents', () => {
+    expect(formatUsdPerM(0.13199999999999998)).toBe('$0.13');
+    expect(formatUsdPerM(0.5279999999999999)).toBe('$0.53');
+    expect(formatUsdPerM(2.0547999999999997)).toBe('$2.05');
+    expect(formatUsdPerM(1.5999999999999999)).toBe('$1.60');
+  });
+
+  it('drops .00 on whole dollars, like the hand-written heads', () => {
+    expect(formatUsdPerM(2)).toBe('$2');
+    expect(formatUsdPerM(15)).toBe('$15');
+    expect(formatUsdPerM(0)).toBe('$0');
+  });
+
+  it('keeps two significant figures under a cent instead of $0.00', () => {
+    expect(formatUsdPerM(0.0075)).toBe('$0.0075');
+    expect(formatUsdPerM(0.001234)).toBe('$0.0012');
+  });
+
+  it('marks an unknown side', () => {
+    expect(formatUsdPerM(null)).toBe('?');
+    expect(templatePrice({ inputPerM: 0.14, outputPerM: null })).toBe('$0.14 · ? /M');
+  });
+});
+
+describe('shipped model cards', () => {
+  it('never show a price with float noise', () => {
+    const noisy = [...ASSISTANT_MODEL_CHOICES, ...WORKER_MODEL_CHOICES]
+      .filter((c) => /\d\.\d{5,}/.test(c.price))
+      .map((c) => `${c.name}: ${c.price}`);
+    expect(noisy).toEqual([]);
+  });
+});

package/src/model-choices.ts

@@ -118,7 +118,18 @@ const BASE_WORKER_CHOICES: readonly ModelChoice[] = [
 // template ships with the repo (model-pools-data.ts), so new installs offer
 // the full curated range with no network call.
 
-function templatePrice(
+/** One $/M price for a card, in the hand-written heads' style: cents with
+ *  whole dollars bare ("$2", "$1.60", "$0.13"), and two significant figures
+ *  under a cent so a tiny price never rounds to "$0.00". The snapshot holds
+ *  raw per-token × 1e6 floats (0.13199999999999998), so never print it bare. */
+export function formatUsdPerM(v: number | null): string {
+  if (v == null || !Number.isFinite(v)) return '?';
+  if (v > 0 && v < 0.01) return `$${Number(v.toPrecision(2))}`;
+  const s = v.toFixed(2);
+  return `$${s.endsWith('.00') ? s.slice(0, -3) : s}`;
+}
+
+export function templatePrice(
   p: {
     inputPerM: number | null;
     outputPerM: number | null;
@@ -126,8 +137,7 @@ function templatePrice(
 ): string {
   if (!p || (p.inputPerM == null && p.outputPerM == null)) return 'price varies';
   if (p.inputPerM === 0 && p.outputPerM === 0) return 'Free';
-  const f = (v: number | null) => (v == null ? '?' : `$${v}`);
-  return `${f(p.inputPerM)} · ${f(p.outputPerM)} /M`;
+  return `${formatUsdPerM(p.inputPerM)} · ${formatUsdPerM(p.outputPerM)} /M`;
 }
 
 function extendFromPool(pool: string, base: readonly ModelChoice[]): readonly ModelChoice[] {

package/src/model-pools-data.json

@@ -11,7 +11,7 @@
       }
     ],
     "pricing": {
-      "inputPerM": 1.5999999999999999,
+      "inputPerM": 1.6,
       "outputPerM": 4.8,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
@@ -158,8 +158,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.13199999999999998,
-      "outputPerM": 0.5279999999999999,
+      "inputPerM": 0.132,
+      "outputPerM": 0.528,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -179,8 +179,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.6537999999999999,
-      "outputPerM": 2.0547999999999997,
+      "inputPerM": 0.6538,
+      "outputPerM": 2.0548,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -284,8 +284,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.09999999999999999,
-      "outputPerM": 0.19999999999999998,
+      "inputPerM": 0.1,
+      "outputPerM": 0.2,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -305,8 +305,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.13199999999999998,
-      "outputPerM": 0.5279999999999999,
+      "inputPerM": 0.132,
+      "outputPerM": 0.528,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -494,8 +494,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.09999999999999999,
-      "outputPerM": 0.19999999999999998,
+      "inputPerM": 0.1,
+      "outputPerM": 0.2,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -515,8 +515,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.13199999999999998,
-      "outputPerM": 0.5279999999999999,
+      "inputPerM": 0.132,
+      "outputPerM": 0.528,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -704,8 +704,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.09999999999999999,
-      "outputPerM": 0.19999999999999998,
+      "inputPerM": 0.1,
+      "outputPerM": 0.2,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -725,8 +725,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.13199999999999998,
-      "outputPerM": 0.5279999999999999,
+      "inputPerM": 0.132,
+      "outputPerM": 0.528,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -914,8 +914,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.09999999999999999,
-      "outputPerM": 0.19999999999999998,
+      "inputPerM": 0.1,
+      "outputPerM": 0.2,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -935,8 +935,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.13199999999999998,
-      "outputPerM": 0.5279999999999999,
+      "inputPerM": 0.132,
+      "outputPerM": 0.528,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -1040,8 +1040,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.09999999999999999,
-      "outputPerM": 0.19999999999999998,
+      "inputPerM": 0.1,
+      "outputPerM": 0.2,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -1103,7 +1103,7 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.19999999999999998,
+      "inputPerM": 0.2,
       "outputPerM": 1.2,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
@@ -1673,8 +1673,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.09999999999999999,
-      "outputPerM": 0.19999999999999998,
+      "inputPerM": 0.1,
+      "outputPerM": 0.2,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -1694,8 +1694,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.13199999999999998,
-      "outputPerM": 0.5279999999999999,
+      "inputPerM": 0.132,
+      "outputPerM": 0.528,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -1883,8 +1883,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.09999999999999999,
-      "outputPerM": 0.19999999999999998,
+      "inputPerM": 0.1,
+      "outputPerM": 0.2,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -1904,8 +1904,8 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.13199999999999998,
-      "outputPerM": 0.5279999999999999,
+      "inputPerM": 0.132,
+      "outputPerM": 0.528,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",
       "source": "openrouter"
@@ -2030,7 +2030,7 @@
       }
     ],
     "pricing": {
-      "inputPerM": 0.041999999999999996,
+      "inputPerM": 0.042,
       "outputPerM": 0,
       "currency": "USD",
       "capturedAt": "2026-09-22T14:41:05.911Z",

package/src/purpose-limits.test.ts

@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest';
+import { PURPOSE_MAX_CHARS, purposeTooLongError } from './purpose-limits';
+
+describe('PURPOSE_MAX_CHARS', () => {
+  it('is 600, the ceiling the identity block renders', () => {
+    expect(PURPOSE_MAX_CHARS).toBe(600);
+  });
+});
+
+describe('purposeTooLongError', () => {
+  it('names the length, the limit, and where the personality lives', () => {
+    const msg = purposeTooLongError(3888);
+    expect(msg).toContain('3,888');
+    expect(msg).toContain('600');
+    expect(msg).toContain('Agent Studio');
+  });
+});

package/src/purpose-limits.ts

@@ -0,0 +1,25 @@
+/**
+ * The size ceiling on the brain's purpose (`preferences.purpose`), shared by
+ * the onboarding wizard, Settings → Profile, the routes that save it, and the
+ * identity block that injects it into every turn.
+ *
+ * It used to be three private copies of `600`, and both routes silently
+ * `.slice()`d anything longer. On 2026-09-28 a user pasted a 3,888-character
+ * assistant persona prompt into the onboarding purpose box: 3,288 characters
+ * vanished without a word and the assistant kept its default personality. The
+ * routes now refuse an over-long purpose with a 400 and this message, and the
+ * UI counts against the same number.
+ */
+
+/** Max characters of the brain's purpose, measured AFTER trimming. */
+export const PURPOSE_MAX_CHARS = 600;
+
+/** The 400 message for a purpose over the limit. */
+export function purposeTooLongError(length: number): string {
+  return (
+    `The purpose is ${length.toLocaleString('en-US')} characters; the limit is ` +
+    `${PURPOSE_MAX_CHARS.toLocaleString('en-US')}. Keep it to one or two sentences on what ` +
+    'this brain is for. The assistant’s personality is set in Agent Studio or ' +
+    'Settings → Agents, not here.'
+  );
+}