@nadicodeai/ui 8.5.0 → 9.0.0

package/AGENTS.md

@@ -7,7 +7,7 @@ exports.
 - Component changes and admission: `docs/contract.md`.
 - Consumer setup: `docs/consuming-cross-repo.md`.
 - Tokens, CSS, motion, and assets: `../design-system/DESIGN.md`.
-- Agent visuals: `docs/agent-visual.md`; the Forma avatars: `docs/forma-avatar.md`.
+- Agent identity, the orbs and their stored appearance: `docs/agent-orb.md`.
 - System activity indicators: `docs/activity.md`.
 - What belongs in this package and what belongs in a product: `docs/contract.md`,
   "Placement". Nadia's entry screen is the worked example that moved out.

package/LICENSES/THINKING-ORBS-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jakub Antalik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -1,15 +1,12 @@
-@nadicodeai/ui includes a modified derivative of Paper Shaders 0.0.78.
+@nadicodeai/ui includes an adapted copy of the ribbon geometry from
+thinking-orbs 0.3.1.
 
-Paper Shaders
-Copyright 2026 Paper
+thinking-orbs
+Copyright (c) 2026 Jakub Antalik
 
-Powered by Paper Shaders:
-https://shaders.paper.design
-
-The modified shader preserves Paper's Metaballs field, motion, colour blending,
-and edge calculation while adding NadicodeAI's four approved clipped surface
-materials. The modified source is
-src/internal/agent-visual/shader.ts.
+Licensed under the MIT License; the full text ships as
+LICENSES/THINKING-ORBS-MIT.txt. The copy in src/internal/agent-orb.ts keeps each
+dot's lane through the depth sort, so Nadia's striped ribbon holds its stripes.
 
 @nadicodeai/ui includes model-maker and model-family marks from the LobeHub icon
 set, generated from @lobehub/icons-static-svg 1.95.1.

package/dist/components/agent-orb-appearance.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The stored appearance, reachable from a server. `agent-orb.tsx` is a
+ * `"use client"` module, and under React Server Components every export of one
+ * becomes a client reference, a re-exported pure function included, which a
+ * server caller can only fail to invoke. A product that resolves an Agent's
+ * look before it renders the orb (the Portal builds its rows that way) imports
+ * the resolver from here; the orb comes from `@nadicodeai/ui/components/agent-orb`,
+ * and neither module re-exports the other.
+ */
+import type { AgentOrbFigure, AgentOrbForm } from "../internal/agent-orb.js";
+export type { AgentOrbFigure, AgentOrbForm } from "../internal/agent-orb.js";
+/** What Nadia stores for an Agent's look, and reports to the Portal. Both may be absent or unknown. */
+export interface StoredAgentOrbAppearance {
+    shape?: string | null;
+    color?: string | null;
+}
+/** The seven forms a person may choose, in the order a picker offers them. */
+export declare const agentOrbForms: readonly ["orbit", "ribbon", "lattice", "globe", "network", "braid", "morph"];
+/**
+ * The colours a person may choose. Each clears 3:1 against both the white and
+ * the black canvas, so a chosen orb stays visible in either theme; giallo does
+ * not (1.6:1 on white) and is not offered. Absence of a colour is the default:
+ * the orb inherits the text colour.
+ */
+export declare const agentOrbColors: readonly ["cobalto", "verde", "rosso", "arancio"];
+export type AgentOrbColor = (typeof agentOrbColors)[number];
+/**
+ * The hex each colour is stored as. Nadia keeps an Agent's colour as a CSS
+ * value for its own surfaces, so the stored spelling is a value rather than a
+ * token reference; `agent-orb-appearance.test.ts` holds this table to the
+ * shipped design-system tokens, and the ESLint colour-literal exemption in the
+ * root config names this file.
+ */
+export declare const agentOrbColorValues: Record<AgentOrbColor, string>;
+/** The design-system token each colour paints with. */
+export declare const agentOrbColorTokens: Record<AgentOrbColor, string>;
+/** The `shape` value a chosen form is stored as. */
+export declare const shapeForOrb: (form: AgentOrbForm) => string;
+/** The form an Agent wears until a person chooses one. */
+export declare const defaultAgentOrbForm: AgentOrbForm;
+export declare const defaultAgentOrbShape: string;
+/**
+ * Resolve the stored strings to what `AgentOrb` draws. The root Agent is Nadia
+ * and wears her striped ribbon whatever is stored, since her look is fixed. An
+ * unknown shape is the default form; an unknown colour is undefined, which
+ * leaves the orb the inherited text colour.
+ */
+export declare function resolveAgentOrb(stored: StoredAgentOrbAppearance, { root }?: {
+    root?: boolean;
+}): {
+    form: AgentOrbFigure;
+    color: AgentOrbColor | undefined;
+};
+//# sourceMappingURL=agent-orb-appearance.d.ts.map

package/dist/components/agent-orb-appearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-orb-appearance.d.ts","sourceRoot":"","sources":["../../src/components/agent-orb-appearance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzE,uGAAuG;AACvG,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,8EAA8E;AAC9E,eAAO,MAAM,aAAa,+EAQkB,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,mDAAoD,CAAC;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAK7D,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAK7D,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,KAAG,MAAuB,CAAC;AAEzE,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,EAAE,YAAsB,CAAC;AACzD,eAAO,MAAM,oBAAoB,EAAE,MAAyC,CAAC;AAsB7E;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,wBAAwB,EAChC,EAAE,IAAY,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAG5D"}

package/dist/components/agent-orb-appearance.js

@@ -0,0 +1,87 @@
+/** The seven forms a person may choose, in the order a picker offers them. */
+export const agentOrbForms = [
+    "orbit",
+    "ribbon",
+    "lattice",
+    "globe",
+    "network",
+    "braid",
+    "morph",
+];
+/**
+ * The colours a person may choose. Each clears 3:1 against both the white and
+ * the black canvas, so a chosen orb stays visible in either theme; giallo does
+ * not (1.6:1 on white) and is not offered. Absence of a colour is the default:
+ * the orb inherits the text colour.
+ */
+export const agentOrbColors = ["cobalto", "verde", "rosso", "arancio"];
+/**
+ * The hex each colour is stored as. Nadia keeps an Agent's colour as a CSS
+ * value for its own surfaces, so the stored spelling is a value rather than a
+ * token reference; `agent-orb-appearance.test.ts` holds this table to the
+ * shipped design-system tokens, and the ESLint colour-literal exemption in the
+ * root config names this file.
+ */
+export const agentOrbColorValues = {
+    cobalto: "#1e3cff",
+    verde: "#00a85a",
+    rosso: "#d3302f",
+    arancio: "#ff5a1f",
+};
+/** The design-system token each colour paints with. */
+export const agentOrbColorTokens = {
+    cobalto: "var(--nc-identity-cobalto)",
+    verde: "var(--nc-identity-verde)",
+    rosso: "var(--nc-identity-rosso)",
+    arancio: "var(--nc-identity-arancio)",
+};
+/** The `shape` value a chosen form is stored as. */
+export const shapeForOrb = (form) => `orb:${form}`;
+/** The form an Agent wears until a person chooses one. */
+export const defaultAgentOrbForm = "orbit";
+export const defaultAgentOrbShape = shapeForOrb(defaultAgentOrbForm);
+/**
+ * The retired Forma spellings, each carried to one orb so an Agent that chose
+ * a form before the orbs keeps a distinct look until someone changes it. The
+ * five role names are the launch Agents' own stored spellings.
+ */
+const retiredShapes = new Map([
+    ["forma:uovo", "orbit"],
+    ["forma:pillola", "ribbon"],
+    ["forma:esagono", "lattice"],
+    ["forma:quadrato", "globe"],
+    ["forma:nuvola", "network"],
+    ["forma:goccia", "braid"],
+    ["forma:triangolo", "morph"],
+    ["forma:research", "orbit"],
+    ["forma:build", "braid"],
+    ["forma:design", "network"],
+    ["forma:operate", "globe"],
+    ["forma:review", "lattice"],
+]);
+/**
+ * Resolve the stored strings to what `AgentOrb` draws. The root Agent is Nadia
+ * and wears her striped ribbon whatever is stored, since her look is fixed. An
+ * unknown shape is the default form; an unknown colour is undefined, which
+ * leaves the orb the inherited text colour.
+ */
+export function resolveAgentOrb(stored, { root = false } = {}) {
+    if (root)
+        return { form: "nadia", color: undefined };
+    return { form: formFor(stored.shape), color: colorFor(stored.color) };
+}
+function formFor(shape) {
+    if (!shape)
+        return defaultAgentOrbForm;
+    // A Map, not an object: the shape is a stored string from a machine, and an
+    // object lookup would hand back `toString` or `constructor` for those spellings.
+    return (agentOrbForms.find((form) => shape === shapeForOrb(form)) ??
+        retiredShapes.get(shape) ??
+        defaultAgentOrbForm);
+}
+function colorFor(color) {
+    if (!color)
+        return undefined;
+    const stored = color.toLowerCase();
+    return agentOrbColors.find((name) => stored === agentOrbColorValues[name] || stored === name);
+}

package/dist/components/agent-orb.d.ts

@@ -1,10 +1,12 @@
 import { type CSSProperties } from "react";
-import { type AgentOrbForm, type AgentOrbSize } from "../internal/agent-orb.js";
-export type { AgentOrbForm, AgentOrbSize } from "../internal/agent-orb.js";
+import { type AgentOrbFigure, type AgentOrbSize } from "../internal/agent-orb.js";
+export type { AgentOrbFigure, AgentOrbForm, AgentOrbSize } from "../internal/agent-orb.js";
 import type { AgentOrbState } from "../internal/agent-orb-motion.js";
 export type { AgentOrbState } from "../internal/agent-orb-motion.js";
 export type AgentOrbProps = {
-    form: AgentOrbForm;
+    /** A chosen form, or `nadia`: her striped ribbon, whose colours are fixed. */
+    form: AgentOrbFigure;
+    /** The pigment of a chosen form; on Nadia, only her third, white stripe takes it. */
     color?: CSSProperties["color"];
     size?: AgentOrbSize;
     paused?: boolean;

package/dist/components/agent-orb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-orb.d.ts","sourceRoot":"","sources":["../../src/components/agent-orb.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AAG5F,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,CAAC;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElF,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,IAAS,EACT,MAAc,EACd,KAAc,EACd,SAAa,EACb,UAAkB,EAClB,KAAK,EACL,SAAS,GACV,EAAE,aAAa,+BAyCf"}
+{"version":3,"file":"agent-orb.d.ts","sourceRoot":"","sources":["../../src/components/agent-orb.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AAG9F,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,MAAM,aAAa,GAAG;IAC1B,8EAA8E;IAC9E,IAAI,EAAE,cAAc,CAAC;IACrB,qFAAqF;IACrF,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,CAAC;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElF,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,IAAS,EACT,MAAc,EACd,KAAc,EACd,SAAa,EACb,UAAkB,EAClB,KAAK,EACL,SAAS,GACV,EAAE,aAAa,+BAyCf"}

package/dist/eslint/index.js

@@ -6,6 +6,7 @@ import { confirmDestructiveAction } from "./rules/confirm-destructive-action.js"
 import { iconControlAccessibleName } from "./rules/icon-control-accessible-name.js";
 import { noAppFeatureComponent } from "./rules/no-app-feature-component.js";
 import { noElevatedEdge } from "./rules/no-elevated-edge.js";
+import { noExistenceOnlyAssertion } from "./rules/no-existence-only-assertion.js";
 import { noNestedOverlay } from "./rules/no-nested-overlay.js";
 import { noOffGridSpacing } from "./rules/no-off-grid-spacing.js";
 import { noRawShadow } from "./rules/no-raw-shadow.js";
@@ -17,6 +18,7 @@ import { noPackageComponentRedefinition } from "./rules/no-package-component-red
 import { noPairedSizeUtility } from "./rules/no-paired-size-utility.js";
 import { noRestingSettingsControl } from "./rules/no-resting-settings-control.js";
 import { noShadcnAppearanceOverride } from "./rules/no-shadcn-appearance-override.js";
+import { noSubjectDerivedExpectation } from "./rules/no-subject-derived-expectation.js";
 import { noUnpinnedVercelFunctionsImport } from "./rules/no-unpinned-vercel-functions-import.js";
 import { noNativeVisibleControl } from "./rules/no-native-visible-control.js";
 import { noRepaintedFocus } from "./rules/no-repainted-focus.js";
@@ -84,6 +86,7 @@ const plugin = {
     "icon-control-accessible-name": iconControlAccessibleName,
     "no-app-feature-component": noAppFeatureComponent,
     "no-elevated-edge": noElevatedEdge,
+    "no-existence-only-assertion": noExistenceOnlyAssertion,
     "no-deprecated-zod-api": noDeprecatedZodApi,
     "no-mono-title-register": noMonoTitleRegister,
     "no-nested-overlay": noNestedOverlay,
@@ -95,6 +98,7 @@ const plugin = {
     "no-route-width-override": noRouteWidthOverride,
     "prefer-radio-for-few-static-options": preferRadioForFewStaticOptions,
     "no-shadcn-appearance-override": noShadcnAppearanceOverride,
+    "no-subject-derived-expectation": noSubjectDerivedExpectation,
     "no-native-visible-control": noNativeVisibleControl,
     "no-repainted-focus": noRepaintedFocus,
     "no-unpinned-vercel-functions-import": noUnpinnedVercelFunctionsImport,

package/dist/eslint/rules/expect-chain.js

@@ -0,0 +1,60 @@
+/*
+ * One reader for `expect(subject).<modifiers>.<matcher>(args)`.
+ *
+ * Both assertion rules here judge a call by its matcher name, and the matcher
+ * is not the callee's property in the general case: `not`, `resolves` and
+ * `rejects` sit between `expect(...)` and the matcher, so the name has to be
+ * read by walking the member chain back to the `expect` call. This is that
+ * walk, kept in one place so the two rules cannot disagree about what counts
+ * as an assertion.
+ */
+
+function propertyName(member) {
+  if (!member.computed && member.property.type === "Identifier") return member.property.name;
+  if (member.computed && member.property.type === "Literal") {
+    return typeof member.property.value === "string" ? member.property.value : undefined;
+  }
+  return undefined;
+}
+
+/** `a?.b` and `a?.()` arrive wrapped; the rules want the expression itself. */
+function unwrapChain(node) {
+  return node?.type === "ChainExpression" ? node.expression : node;
+}
+
+function isExpectCall(node) {
+  if (node?.type !== "CallExpression") return false;
+  if (node.callee.type === "Identifier") return node.callee.name === "expect";
+  // `expect.soft(value)` and `expect.poll(fn)` open the same chain.
+  return node.callee.type === "MemberExpression" && node.callee.object.type === "Identifier"
+    ? node.callee.object.name === "expect"
+    : false;
+}
+
+/**
+ * Reads an assertion call. Returns `{ matcher, modifiers, subject, args }` for
+ * `expect(subject).<modifiers>.<matcher>(args)`, or `undefined` when the call
+ * is not an `expect` chain. `subject` is unwrapped of its `ChainExpression`.
+ */
+export function expectAssertion(node) {
+  if (node.type !== "CallExpression" || node.callee.type !== "MemberExpression") return undefined;
+  const matcher = propertyName(node.callee);
+  if (!matcher) return undefined;
+
+  const modifiers = [];
+  let current = node.callee.object;
+  while (current.type === "MemberExpression") {
+    const name = propertyName(current);
+    if (!name) return undefined;
+    modifiers.unshift(name);
+    current = current.object;
+  }
+  if (!isExpectCall(current)) return undefined;
+
+  return {
+    matcher,
+    modifiers,
+    subject: unwrapChain(current.arguments[0]),
+    args: node.arguments,
+  };
+}

package/dist/eslint/rules/no-existence-only-assertion.js

@@ -0,0 +1,89 @@
+/*
+ * An assertion that something exists is not an assertion about behavior.
+ *
+ * Two shapes in this suite pass for nearly any implementation.
+ *
+ * A `&&` or `||` subject returns one of its operands, not a boolean, so the
+ * short-circuit alone can satisfy the matcher: the left operand decides the
+ * result and the right one is never evaluated.
+ *
+ * An optional call yields `undefined` when the method is gone. That is exactly
+ * what `toBeFalsy()` and `toBeUndefined()` accept, which is how
+ * `expect(options.clientPrivileges?.()).toBeFalsy()` in
+ * `apps/portal/src/lib/server/nadia-oauth-provider.test.ts` kept asserting that
+ * OAuth grants no configuration privileges after the privilege hooks had been
+ * deleted from the provider.
+ *
+ * What is deliberately left alone: `toBeDefined()` / `toBeTruthy()` on any
+ * other subject. On a plain identifier or member read it is the type-narrowing
+ * step before reading a property off it. On a Testing Library `getBy*` query it
+ * is redundant, since the query already throws, but it is the suite's idiom for
+ * "this element renders" and replacing it mechanically produces
+ * `expect(getByText("X").textContent).toBe("X")`, which is a tautology of its
+ * own: 214 such sites were rewritten that way once and reverted. `toBeNull()`
+ * and `toBeUndefined()` on any other subject are a real claim of absence.
+ *
+ * Standard tools checked first: `vitest/expect-expect` refuses a test with no
+ * assertion at all and `vitest/valid-expect` checks the call's arity; neither
+ * asks what the asserted expression can produce, which is the whole question
+ * here.
+ */
+import { expectAssertion } from "./expect-chain.js";
+
+const SHORT_CIRCUIT_MATCHERS = new Set(["toBeDefined", "toBeTruthy", "toBeFalsy", "toBeUndefined"]);
+const MISSING_VALUE_MATCHERS = new Set(["toBeFalsy", "toBeUndefined"]);
+
+function isOptionalCall(node) {
+  return node?.type === "CallExpression" && node.optional === true;
+}
+
+export const noExistenceOnlyAssertion = {
+  meta: {
+    type: "problem",
+    docs: {
+      description:
+        "Disallow expectations that only assert a value exists, which pass for almost any implementation",
+    },
+    schema: [],
+    messages: {
+      shortCircuitSubject:
+        "`{{operator}}` returns one of its operands rather than a boolean, so `{{assertion}}` passes on the short-circuit alone, with the right operand never evaluated. Assert each operand separately, or assert the value the expression stands for.",
+      optionalCallAbsence:
+        "`{{assertion}}` on an optional call passes when the call never happens: a deleted or renamed method makes `?.()` yield `undefined`, which is both falsy and undefined. Assert the method is present, then assert what the call returns.",
+    },
+  },
+
+  create(context) {
+    function assertionText(matcher, modifiers) {
+      return [...modifiers, `${matcher}()`].join(".");
+    }
+
+    return {
+      CallExpression(node) {
+        const assertion = expectAssertion(node);
+        if (!assertion) return;
+        const { matcher, modifiers, subject } = assertion;
+        if (!subject) return;
+
+        if (modifiers.length > 0) return;
+
+        if (subject.type === "LogicalExpression" && SHORT_CIRCUIT_MATCHERS.has(matcher)) {
+          context.report({
+            node,
+            messageId: "shortCircuitSubject",
+            data: { operator: subject.operator, assertion: assertionText(matcher, modifiers) },
+          });
+          return;
+        }
+
+        if (isOptionalCall(subject) && MISSING_VALUE_MATCHERS.has(matcher)) {
+          context.report({
+            node,
+            messageId: "optionalCallAbsence",
+            data: { assertion: assertionText(matcher, modifiers) },
+          });
+        }
+      },
+    };
+  },
+};

package/dist/eslint/rules/no-subject-derived-expectation.js

@@ -0,0 +1,129 @@
+/*
+ * The expected value cannot come out of the module under test.
+ *
+ * When a test compares a result with a constant it imported from the sibling
+ * module it is testing, both sides move together: editing the implementation
+ * edits the expectation, and no change to the value can ever turn the test
+ * red. What looks like a pinned contract is a restatement of the code.
+ *
+ * Three of these were live here. `viewer-time-zone.test.ts` asserted
+ * `expect(await viewerTimeZone()).toBe(DEFAULT_VIEWER_TIME_ZONE)` with
+ * `DEFAULT_VIEWER_TIME_ZONE` imported from `./viewer-time-zone`, so the
+ * default the Portal falls back to was never pinned to a time zone at all.
+ * `contract-v1.test.ts` asserted the served ETag header against
+ * `openApiV1Etag` from `./contract-v1`, so the published API contract's
+ * validator was compared with itself, and a token TTL went the same way.
+ *
+ * The fix is to write the literal (`"Europe/Rome"`), or to compute the
+ * expectation from something the subject does not own — a checked-in fixture,
+ * a hash taken in the test, the wire format itself.
+ *
+ * Scope: only a relative import (`./`, `../`) is the subject. A constant from
+ * a package or an alias (`@/…`, `vitest`) is a third party's contract, and a
+ * value the test file declares itself is a value the test chose. Only a bare
+ * identifier or a member read off one counts: a call, a template literal or a
+ * literal built around the identifier is a transformation the test performs,
+ * and the transformation is the thing being asserted.
+ *
+ * A relative import that resolves into a `tests/` or `fixtures/` directory is
+ * the harness, not the subject: `PORTAL_TEST_ADMIN.userId` from
+ * `apps/portal/tests/support/postgres-testdb` is the row the test seeded, so
+ * comparing a query result with it asserts that the code returned what was put
+ * in. Those are excluded by the resolved path, not by the specifier, because a
+ * test under `tests/` reaches its own support modules as `../support/…`.
+ */
+import { dirname, resolve, sep } from "node:path";
+
+import { expectAssertion } from "./expect-chain.js";
+
+const EQUALITY_MATCHERS = new Set(["toBe", "toEqual", "toStrictEqual"]);
+const TEST_FILE = /\.test\.tsx?$/;
+const HARNESS_DIRECTORIES = new Set(["tests", "test", "__tests__", "fixtures", "__fixtures__"]);
+
+/** True when the import lands in a directory the test side owns. */
+function isHarnessModule(filename, source) {
+  const resolved = resolve(dirname(filename), source);
+  const segments = resolved.split(sep);
+  if (segments.some((segment) => HARNESS_DIRECTORIES.has(segment))) return true;
+  // `openrouter-wire.fixture.ts` beside its subject: a fixture by name, not by directory.
+  return /\.fixture(\.[cm]?[jt]sx?)?$/.test(segments[segments.length - 1]);
+}
+
+/** The identifier a bare read or a member read (`contract.etag`) starts from. */
+function rootIdentifier(node) {
+  let current = node;
+  while (current?.type === "MemberExpression" || current?.type === "ChainExpression") {
+    current = current.type === "ChainExpression" ? current.expression : current.object;
+  }
+  return current?.type === "Identifier" ? current : undefined;
+}
+
+export const noSubjectDerivedExpectation = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Disallow an expected value imported from the sibling module the test covers",
+    },
+    schema: [],
+    messages: {
+      subjectDerived:
+        "`{{name}}` comes from `{{source}}`, the module this test covers, so the expectation moves with the implementation and no change to that value can fail this test. Write the expected value as a literal here, or compute it from something the subject does not own.",
+    },
+  },
+
+  create(context) {
+    if (!TEST_FILE.test(context.filename)) return {};
+
+    const sourceCode = context.sourceCode;
+    /** @type {Map<import('eslint').Scope.Variable, string>} */
+    const subjectBindings = new Map();
+
+    function bindingSource(identifier) {
+      for (let scope = sourceCode.getScope(identifier); scope; scope = scope.upper) {
+        const variable = scope.set.get(identifier.name);
+        // The nearest binding wins: a local declaration shadowing the import
+        // is a value this test chose, so it drops out here.
+        if (variable) return subjectBindings.get(variable);
+      }
+      return undefined;
+    }
+
+    return {
+      Program(node) {
+        for (const statement of node.body) {
+          if (statement.type !== "ImportDeclaration") continue;
+          if (statement.importKind === "type") continue;
+          const source = statement.source.value;
+          if (typeof source !== "string") continue;
+          if (!source.startsWith("./") && !source.startsWith("../")) continue;
+          if (isHarnessModule(context.filename, source)) continue;
+          for (const specifier of statement.specifiers) {
+            if (specifier.importKind === "type") continue;
+            for (const variable of sourceCode.getDeclaredVariables(specifier)) {
+              subjectBindings.set(variable, source);
+            }
+          }
+        }
+      },
+
+      CallExpression(node) {
+        const assertion = expectAssertion(node);
+        if (!assertion || !EQUALITY_MATCHERS.has(assertion.matcher)) return;
+        const [expected] = assertion.args;
+        if (!expected) return;
+        if (expected.type !== "Identifier" && expected.type !== "MemberExpression") return;
+
+        const root = rootIdentifier(expected);
+        if (!root) return;
+        const source = bindingSource(root);
+        if (!source) return;
+
+        context.report({
+          node: expected,
+          messageId: "subjectDerived",
+          data: { name: sourceCode.getText(expected), source },
+        });
+      },
+    };
+  },
+};

package/dist/index.d.ts

@@ -7,7 +7,6 @@ export * from "./components/activity-orb.js";
 export * from "./components/activity-calendar.js";
 export * from "./components/agent-card.js";
 export * from "./components/agent-orb.js";
-export * from "./components/agent-visual.js";
 export * from "./components/alert.js";
 export * from "./components/alert-dialog.js";
 export * from "./components/aspect-ratio.js";
@@ -68,7 +67,6 @@ export * from "./components/field.js";
 export * from "./components/file-type-icon.js";
 export * from "./components/footer.js";
 export * from "./components/form.js";
-export * from "./components/forma-avatar.js";
 export * from "./components/glass-control.js";
 export * from "./components/glyph-spinner.js";
 export * from "./components/handoff-banner.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -7,7 +7,6 @@ export * from "./components/activity-orb.js";
 export * from "./components/activity-calendar.js";
 export * from "./components/agent-card.js";
 export * from "./components/agent-orb.js";
-export * from "./components/agent-visual.js";
 export * from "./components/alert.js";
 export * from "./components/alert-dialog.js";
 export * from "./components/aspect-ratio.js";
@@ -68,7 +67,6 @@ export * from "./components/field.js";
 export * from "./components/file-type-icon.js";
 export * from "./components/footer.js";
 export * from "./components/form.js";
-export * from "./components/forma-avatar.js";
 export * from "./components/glass-control.js";
 export * from "./components/glyph-spinner.js";
 export * from "./components/handoff-banner.js";

package/dist/internal/agent-orb-motion.d.ts

@@ -1,7 +1,7 @@
-import type { AgentOrbForm } from "./agent-orb.js";
+import type { AgentOrbFigure } from "./agent-orb.js";
 export type AgentOrbState = "idle" | "working" | "waiting" | "blocked" | "thinking" | "done";
-export declare function stateSpeed(state: AgentOrbState, form: AgentOrbForm): number;
-export declare function motionPose(form: AgentOrbForm, state: AgentOrbState, age: number): {
+export declare function stateSpeed(state: AgentOrbState, form: AgentOrbFigure): number;
+export declare function motionPose(form: AgentOrbFigure, state: AgentOrbState, age: number): {
     sx: number;
     sy: number;
     x: number;

package/dist/internal/agent-orb-motion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-orb-motion.d.ts","sourceRoot":"","sources":["../../src/internal/agent-orb-motion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAY7F,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,UAGlE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM;;;;;;;;EA0C/E;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,EAAE,MAAM,GAAG,OAAO,QAgExB"}
+{"version":3,"file":"agent-orb-motion.d.ts","sourceRoot":"","sources":["../../src/internal/agent-orb-motion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAa7F,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,cAAc,UAGpE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM;;;;;;;;EA0CjF;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,EAAE,MAAM,GAAG,OAAO,QAgExB"}

package/dist/internal/agent-orb-motion.js

@@ -1,5 +1,6 @@
 const personalities = {
     ribbon: { speed: 0.55, tilt: 0.15 },
+    nadia: { speed: 0.55, tilt: 0.15 },
     lattice: { speed: 0.28, tilt: -0.12 },
     orbit: { speed: 0.7, tilt: 0.2 },
     globe: { speed: 0.35, tilt: -0.16 },

package/dist/internal/agent-orb.d.ts

@@ -1,3 +1,4 @@
+import { type ModeOpts, type OrbFrame } from "thinking-orbs/engine";
 import { type AgentOrbState } from "./agent-orb-motion.js";
 declare const agentOrbForms: {
     readonly orbit: "working";
@@ -9,8 +10,17 @@ declare const agentOrbForms: {
     readonly morph: "shaping";
 };
 export type AgentOrbForm = keyof typeof agentOrbForms;
+/** A chosen form, or Nadia's own ribbon, which nobody chooses. */
+export type AgentOrbFigure = AgentOrbForm | "nadia";
 export type AgentOrbSize = 20 | 24 | 32 | 40 | 64 | 96 | 160;
-export declare function mountAgentOrb(canvas: HTMLCanvasElement, form: AgentOrbForm, size: AgentOrbSize, initiallyPaused: boolean, initialState?: AgentOrbState): {
+/**
+ * The vendor's `ribbon` geometry (thinking-orbs 0.3.1, MIT, Jakub Antalik),
+ * repeated here only so every dot carries its lane through the depth sort. The
+ * engine sorts dots by depth each frame, so colouring by array position makes
+ * a stripe jump between lanes as the ribbon turns; the lane is the stable id.
+ */
+export declare function stripedRibbonFrame(size: number, t: number, opts: ModeOpts): OrbFrame;
+export declare function mountAgentOrb(canvas: HTMLCanvasElement, form: AgentOrbFigure, size: AgentOrbSize, initiallyPaused: boolean, initialState?: AgentOrbState): {
     destroy(): void;
     setPaused(_value: boolean): void;
     setState(_value: AgentOrbState): void;