@nadicodeai/ui 8.6.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/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;

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

@@ -1 +1 @@
-{"version":3,"file":"agent-orb.d.ts","sourceRoot":"","sources":["../../src/internal/agent-orb.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAuC,MAAM,oBAAoB,CAAC;AAE7F,QAAA,MAAM,aAAa;;;;;;;;CAQ0B,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,aAAa,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;AAkD7D,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,YAAY,EAClB,eAAe,EAAE,OAAO,EACxB,YAAY,GAAE,aAAsB;;sBAIO,OAAO;qBAAuB,aAAa;EAqHvF"}
+{"version":3,"file":"agent-orb.d.ts","sourceRoot":"","sources":["../../src/internal/agent-orb.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EAEb,KAAK,QAAQ,EAId,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,KAAK,aAAa,EAAuC,MAAM,oBAAoB,CAAC;AAE7F,QAAA,MAAM,aAAa;;;;;;;;CAQ0B,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,aAAa,CAAC;AACtD,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;AAmB7D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAuDpF;AA0DD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,YAAY,EAClB,eAAe,EAAE,OAAO,EACxB,YAAY,GAAE,aAAsB;;sBAIO,OAAO;qBAAuB,aAAa;EA0HvF"}

package/dist/internal/agent-orb.js

@@ -1,4 +1,4 @@
-import { MODE_FRAMES, resolvePreset } from "thinking-orbs/engine";
+import { finalizeFrame, MODE_FRAMES, makeProj, radiusScale, resolvePreset, } from "thinking-orbs/engine";
 import { motionPose, paintOrbCue, stateSpeed } from "./agent-orb-motion.js";
 const agentOrbForms = {
     orbit: "working",
@@ -9,9 +9,81 @@ const agentOrbForms = {
     ribbon: "composing",
     morph: "shaping",
 };
-function paintAgentOrb(context, form, size, seconds, color, state = "idle", age = 0, reduced = false, celebrationColors = [color]) {
-    const preset = resolvePreset(agentOrbForms[form], size <= 32 ? 20 : 64);
-    const frame = MODE_FRAMES[preset.mode](size, seconds, preset.opts);
+/**
+ * Nadia's four stripes across the ribbon's width, azzurro to rosso. The third
+ * is the orb's own pigment, the inherited text colour, so the white of the
+ * tricolore stays visible on a white ground as ink.
+ */
+const nadiaStripes = ["--nc-identity-azzurro", "--nc-identity-verde", null, "--nc-identity-rosso"];
+/** A stable direction on the unit sphere, the vendor's Fibonacci lattice. */
+function fibonacci(i, n) {
+    const y = 1 - (2 * (i + 0.5)) / n;
+    const radius = Math.sqrt(1 - y * y);
+    const angle = i * Math.PI * (3 - Math.sqrt(5));
+    return [radius * Math.cos(angle), y, radius * Math.sin(angle)];
+}
+/**
+ * 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 function stripedRibbonFrame(size, t, opts) {
+    const cx = size / 2;
+    const radius = (size / 2) * 0.78;
+    const spin = opts.spin ?? 1;
+    const project = makeProj(t * 0.1 * spin, 0.3, cx, cx, 1);
+    const scale = radiusScale(size, opts.rsPow ?? 0.6);
+    const dots = [];
+    const ghosts = opts.ghostN ?? 150;
+    for (let i = 0; i < ghosts; i++) {
+        const [gx, gy, gz] = fibonacci(i, ghosts);
+        const [x, y, z] = project(gx * radius, gy * radius, gz * radius);
+        dots.push({ x, y, z, r: 0.8 * scale, white: 0.78, a: 0.1 + 0.22 * ((z / radius + 1) / 2) });
+    }
+    const yaw = t * 0.24 * spin;
+    const tilt = opts.faceOn ? -0.3 : 0.55 + 0.3 * Math.sin(t * 0.18) * spin;
+    const [ax, ay, az] = [Math.cos(yaw), 0, Math.sin(yaw)];
+    const [bx, by, bz] = [-az * Math.sin(tilt), Math.cos(tilt), ax * Math.sin(tilt)];
+    const [nx, ny, nz] = [ay * bz - az * by, az * bx - ax * bz, ax * by - ay * bx];
+    const wobble = opts.wobMul ?? 1;
+    const reach = opts.faceOn ? radius / (1 + 0.85 * 0.23 * wobble) : radius;
+    const segments = opts.segs ?? 88;
+    const lanes = Math.max(1, Math.round((opts.lanes ?? 5) * (opts.bandMul ?? 1)));
+    for (let lane = 0; lane < lanes; lane++) {
+        const offset = (lane - (lanes - 1) / 2) * 0.075;
+        const edge = Math.abs(lane - (lanes - 1) / 2) / Math.max(1, (lanes - 1) / 2);
+        for (let step = 0; step < segments; step++) {
+            const angle = (step / segments) * 2 * Math.PI;
+            const wave = (0.16 * Math.sin(angle * 3 - t * 1.7 + lane * 0.22) +
+                0.07 * Math.sin(angle * 5 + t * 1.1)) *
+                wobble;
+            const stretch = opts.faceOn ? 1 + wave : 1;
+            const lift = opts.faceOn ? offset : offset + wave;
+            const px = ax * Math.cos(angle) + bx * Math.sin(angle) + nx * lift;
+            const py = ay * Math.cos(angle) + by * Math.sin(angle) + ny * lift;
+            const pz = az * Math.cos(angle) + bz * Math.sin(angle) + nz * lift;
+            const length = Math.sqrt(px * px + py * py + pz * pz);
+            const [x, y, z] = project((px / length) * reach * stretch, (py / length) * reach * stretch, (pz / length) * reach * stretch);
+            const depth = (z / radius + 1) / 2;
+            dots.push({
+                x,
+                y,
+                z,
+                r: ((opts.rBase ?? 1.1) + (opts.rDepth ?? 1.7) * depth) * (1 - 0.25 * edge) * scale,
+                white: 0.52 - 0.44 * depth + 0.18 * edge,
+                a: 0.4 + 0.6 * depth,
+                stripe: Math.min(3, Math.floor((lane / lanes) * 4)),
+            });
+        }
+    }
+    return finalizeFrame(dots, [], opts.rMin);
+}
+function paintAgentOrb(context, form, size, seconds, color, state = "idle", age = 0, reduced = false, celebrationColors = [color], stripeColors = [color]) {
+    const preset = resolvePreset(agentOrbForms[form === "nadia" ? "ribbon" : form], size <= 32 ? 20 : 64);
+    const frame = form === "nadia"
+        ? stripedRibbonFrame(size, seconds, preset.opts)
+        : MODE_FRAMES[preset.mode](size, seconds, preset.opts);
     context.clearRect(0, 0, size, size);
     const pose = motionPose(form, state, reduced ? (state === "done" ? 2 : 0.6) : age);
     const gestureSeconds = reduced ? 0.8 : age / (state === "done" ? 0.575 : 0.2875);
@@ -38,6 +110,7 @@ function paintAgentOrb(context, form, size, seconds, color, state = "idle", age
         context.stroke();
     }
     for (const dot of frame.dots) {
+        context.fillStyle = dot.stripe === undefined ? color : (stripeColors[dot.stripe] ?? color);
         context.globalAlpha = Math.min(1, Math.max(0, (1 - dot.white) * (dot.a ?? 1) * pose.opacity));
         context.beginPath();
         context.arc(...project(dot.x, dot.y), dot.r, 0, Math.PI * 2);
@@ -63,11 +136,12 @@ export function mountAgentOrb(canvas, form, size, initiallyPaused, initialState
     let ratio = 1;
     let color = getComputedStyle(canvas).color;
     let celebrationColors = [color];
+    let stripeColors = [color];
     function paint() {
         if (!context)
             return;
         context.setTransform(ratio, 0, 0, ratio, 0, 0);
-        paintAgentOrb(context, form, size, seconds, color, state, age, motion.matches, celebrationColors);
+        paintAgentOrb(context, form, size, seconds, color, state, age, motion.matches, celebrationColors, stripeColors);
     }
     function running() {
         return (!disposed &&
@@ -110,6 +184,7 @@ export function mountAgentOrb(canvas, form, size, initiallyPaused, initialState
         const appearance = getComputedStyle(canvas);
         color = appearance.color;
         celebrationColors = ["--nc-chart-5", "--nc-chart-6", "--nc-warning", "--nc-chart-4"].map((token) => `color-mix(in oklch, ${appearance.getPropertyValue(token).trim() || color} 75%, white)`);
+        stripeColors = nadiaStripes.map((token) => (token && appearance.getPropertyValue(token).trim()) || color);
         play();
     }
     const visibility = new IntersectionObserver(([entry]) => {

package/docs/agent-orb.md

@@ -1,11 +1,10 @@
 # Agent orbs
 
-`AgentOrb` is the abstract Agent identity family requested on 2026-09-19:
-seven structures from `thinking-orbs` 0.3.1, each painted in one configurable
-colour. These are persistent appearance choices, not activity states. They
-apply equally to Nadia and other Agents; this family assigns no face or
-special character to Nadia. Existing Forma consumers are not migrated by
-this component slice.
+`AgentOrb` is the one Agent identity in every product: seven structures from
+`thinking-orbs` 0.3.1, each painted in one chosen colour, and Nadia's own
+striped ribbon. These are persistent appearance choices, not activity states.
+No other Agent form, avatar or portrait exists; a custom picture a person
+uploads in Nadia is theirs, not an identity this package draws.
 
 | Form | Structure | Upstream preset |
 | --- | --- | --- |
@@ -17,7 +16,40 @@ this component slice.
 | `braid` | Interwoven strands | `weaving` |
 | `morph` | Changing geometric contour | `shaping` |
 
-The form does not select a job, tools or runtime status. Do not switch it when
+## Nadia
+
+`form="nadia"` is the ribbon striped along its whole length, across its width:
+azzurro (`--nc-identity-azzurro`), verde, the orb's own pigment, and rosso.
+The third stripe is the white of the tricolore; it takes the inherited text
+colour so it stays visible as ink on a white ground. The stripes are fixed:
+the same four at every size, in both themes and in every state, and nobody
+chooses them. Each dot keeps its lane through the engine's depth sort, so a
+stripe never changes colour as the ribbon turns. Her motion is the ribbon's.
+
+## Stored appearance
+
+Nadia stores an Agent's look in its profile and reports it to the Portal on
+every check-in; the Portal renders it and never writes it.
+`@nadicodeai/ui/components/agent-orb-appearance` is the one reading of those
+strings, server-safe so a server can resolve a row before it renders:
+
+| Field | Stored as |
+| --- | --- |
+| `shape` | `orb:orbit`, `orb:ribbon`, `orb:lattice`, `orb:globe`, `orb:network`, `orb:braid`, `orb:morph` |
+| `color` | The design system's identity hex of cobalto, verde, rosso or arancio, or null |
+
+`resolveAgentOrb(stored, { root })` returns the form and colour to draw. The
+root Agent is Nadia and draws `nadia` whatever is stored. An unknown or empty
+shape draws `orbit`; an unknown or empty colour draws the inherited text
+colour, which is also the default a picker's reset restores. Paint a colour
+with `agentOrbColorTokens[color]`. The four colours clear 3:1 against both the
+white and the black canvas; giallo does not and is not offered. Each retired
+`forma:` spelling resolves to its own orb, so an Agent keeps a distinct look
+until someone changes it.
+
+The appearance is a person's choice, never derived: do not infer it from a name,
+an id hash or a role. A machine check-in is not Agent activity, so a surface that
+only knows check-ins draws the orb idle. The form does not select a job, tools or runtime status. Do not switch it when
 an Agent starts searching or solving. Applications own the persisted form,
 colour, name and status; names beside avatars provide exact identification.
 
@@ -26,13 +58,15 @@ colour, name and status; names beside avatars provide exact identification.
 ```tsx
 import { AgentOrb } from "@nadicodeai/ui/components/agent-orb";
 
-<AgentOrb form="ribbon" color="var(--nc-identity-cobalto)" size={32} label="Nadia" />;
+<AgentOrb form="ribbon" color="var(--nc-identity-cobalto)" size={32} label="Research" />;
+<AgentOrb form="nadia" size={32} label="Nadia" />;
 ```
 
 `form` is required. `color` accepts one CSS colour, including a customer-chosen
 colour or a canonical token. Omit it to inherit text colour. This configurable
 artwork is not a new palette for controls or status. Every particle and line
-uses the same pigment; opacity, not another colour, creates depth. Working
+of a chosen form uses the same pigment, and on Nadia each stripe keeps its own;
+opacity, not another colour, creates depth. Working
 releases occasional coloured flourishes; Done repeats the same arcs,
 arrowheads, rings and sparkles in a short celebration around
 that single-colour identity, using the existing chart and warning tokens. Choose a
@@ -73,10 +107,9 @@ No state has an enclosing circle. Keep a nearby status label where exact
 state identification matters, including reduced motion and compact sizes.
 Reduced motion holds the state pose and skips the celebration.
 
-The [Portal Agent workspace](../../../apps/portal/src/components/agent-workspace/agent-workspace.tsx)
-uses the shared component. Inspect its Agent list and detail views in the
-running local Portal for compact and full-size appearances. Development
-profiles provide example orb choices; their preview edits do not change
-stored Agent records.
+In the Portal, [`agent-identity.tsx`](../../../apps/portal/src/components/agent-identity.tsx)
+draws every Agent, in its lists, Agent workspace and the sign-in, sign-up and
+Get Nadia pages. Inspect them in the running local Portal for compact and
+full-size appearances.
 
 [Upstream library and presets](https://libraries.dev/orbs), MIT licensed.

package/docs/contract.md

@@ -152,7 +152,7 @@ states to the orb.
 
 ## Admission Rules
 
-Assistant conversation and runtime APIs enter through `@nadicodeai/ui/agents`; Agent identity enters through `@nadicodeai/ui/components/agent-card`, `@nadicodeai/ui/components/agent-orb`, `@nadicodeai/ui/components/agent-visual`, and the Forma avatars in `@nadicodeai/ui/components/forma-avatar` (owned by [`forma-avatar.md`](forma-avatar.md)). The consuming application still constructs the runtime and owns transport, persistence, permissions, tools, approvals, and failure policy. Shared non-Agent product components (a shell, a settings surface, a generic section, a diff, or a file preview) are admitted only with a named consuming surface landing in the same change. App-bespoke UI and behavior (window chrome, PTY/xterm embeds, queues, approvals, and persistence) stay in the consuming app; they never become package abstractions. A component left unconsumed after its target migration ships gets removed.
+Assistant conversation and runtime APIs enter through `@nadicodeai/ui/agents`; Agent identity enters through `@nadicodeai/ui/components/agent-orb`, its stored-appearance resolver `@nadicodeai/ui/components/agent-orb-appearance` (both owned by [`agent-orb.md`](agent-orb.md)), and `@nadicodeai/ui/components/agent-card`. The consuming application still constructs the runtime and owns transport, persistence, permissions, tools, approvals, and failure policy. Shared non-Agent product components (a shell, a settings surface, a generic section, a diff, or a file preview) are admitted only with a named consuming surface landing in the same change. App-bespoke UI and behavior (window chrome, PTY/xterm embeds, queues, approvals, and persistence) stay in the consuming app; they never become package abstractions. A component left unconsumed after its target migration ships gets removed.
 
 ### Placement
 
@@ -166,34 +166,13 @@ where [`apps/nadia/docs/entry-screen.md`](../../../apps/nadia/docs/entry-screen.
 owns their contract. `packages/ui/tests/guards/product-placement.test.ts`
 refuses a product's name in either package.
 
-### Abstract Agent identities
-
-`AgentOrb` is the seven-form, single-colour abstract family in
-[`agent-orb.md`](agent-orb.md), exposed through
-`@nadicodeai/ui/components/agent-orb`. Its consuming validation surface is
-`examples/agent-orbs`: the built component at detail, menu and conversation
-sizes, with independently editable colours. The application stores appearance;
-upstream activity names select geometry only and never infer an Agent role or
-change its identity with runtime work. Customer-selected artwork colours are
-inputs, not component palette literals or interface colour roles.
-
-### Agent identity presentation
-
-The visual system (the closed recipes, motion, fallbacks, and licensing) is
-owned by [`agent-visual.md`](agent-visual.md). What this contract adds is the
-package shape: `AgentVisual` exposes only a recipe (`general`, `reasoning`,
-`coordination`, `communication`, `execution`) and a presentation (`registry`,
-`card`, `detail`); it is decorative by default, and a meaningful selectable
-image opts into `decorative={false}` with a `label`. `AgentCard` composes the
-fundamental `Card` with explicit `visual`, `name`, `job`, `status`, `meta`,
-and `action` slots and owns presentation only; when it is the page identity,
-the `name` slot carries the page's `h1`. The app owns Agent data, recipe
-assignment, status grammar, routing, and actions; it assigns a recipe
-explicitly and never infers or randomizes one from a free-form role.
-When the product chooses a card presentation, use `AgentCard`; registry cells,
-membership rows, and compact detail headers compose the shared `AgentVisual`
-within the structure their reading task requires. An Agent's presence does not
-by itself choose a card layout. There is no `AgentGlyph`, `AgentRow`, or
+### Agent identity
+
+`AgentOrb` is the only Agent identity the package ships, and
+[`agent-orb.md`](agent-orb.md) owns its rules. `AgentCard` composes the
+fundamental `Card` with explicit `visual`, `name`, `job`, `status`, `meta`, and
+`action` slots and owns presentation only; when it is the page identity, the
+`name` slot carries the page's `h1`. There is no `AgentGlyph`, `AgentRow`, or
 product-domain `agent` object prop in the shared package.
 
 - **Standard components, not app-owned product features.** This package ships primitives, standard UI components, assistant-ui compositions, brand adapters, React adapters, reusable sections, and presentational product components. It must not ship app-specific feature/use-case screens or names such as operator-login, portal activation, customer credential control, or customer management. Domain registries, command search providers, and chart dashboards bind app data and routes in the app; that binding is not a reason to copy reusable presentation. Portal's DataTable owns its Next.js query and registry protocol once, while consuming the shared UI foundation. Product-independent compositions belong here with a real consumer. The source-backed `chart-*` and `kpi-card` package surface is the plan-approved exception per issue #166; apps select charts and bind their titles, data, and navigation. A chart is named by the card title above it and navigated through Recharts' own accessibility layer; the kit ships no hidden table twin, because a component whose complete value is already available in visible text or `aria-valuetext` does not add a redundant table.