@shardworks/spider-apparatus 0.1.238 → 0.1.240

package/dist/rig-view.d.ts

@@ -1,6 +1,6 @@
 /**
  * Rig view aggregator — builds the UI-facing RigView from a persisted
- * RigDoc by joining against the animator/sessions book.
+ * RigDoc by joining against the Animator's per-session cost snapshot.
  *
  * Read-only. Pure derived fields; never persisted.
  *
@@ -11,18 +11,21 @@
  *   zeros; sessions that are missing from the book are skipped silently.
  * - tokenUsage fields are optional: when no contributing session has
  *   tokenUsage, the aggregate inputTokens/outputTokens are omitted.
+ *
+ * The cost data comes from AnimatorApi.getSessionCosts — the Animator owns
+ * the shape of cost answers, so consumers like this aggregator do not reach
+ * into the sessions book directly.
  */
-import type { StacksApi } from '@shardworks/stacks-apparatus';
 import type { RigDoc, RigView } from './types.ts';
 /**
- * Build a RigView for a single rig by reading every engine's session doc
- * (if any) from the animator/sessions book and summing cost + token usage.
+ * Build a RigView for a single rig by asking the Animator for cost/token
+ * snapshots of every engine's session (if any) and summing across them.
  *
  * Does not mutate the rig. Safe to call on every read.
  */
-export declare function enrichRigView(rig: RigDoc, stacks: StacksApi): Promise<RigView>;
+export declare function enrichRigView(rig: RigDoc): Promise<RigView>;
 /**
  * Enrich an array of rigs in parallel.
  */
-export declare function enrichRigViews(rigs: RigDoc[], stacks: StacksApi): Promise<RigView[]>;
+export declare function enrichRigViews(rigs: RigDoc[]): Promise<RigView[]>;
 //# sourceMappingURL=rig-view.d.ts.map

package/dist/rig-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rig-view.d.ts","sourceRoot":"","sources":["../src/rig-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EAGR,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CA8DpF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAE1F"}
+{"version":3,"file":"rig-view.d.ts","sourceRoot":"","sources":["../src/rig-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EAGR,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA8DjE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAEvE"}

package/dist/rig-view.js

@@ -1,6 +1,6 @@
 /**
  * Rig view aggregator — builds the UI-facing RigView from a persisted
- * RigDoc by joining against the animator/sessions book.
+ * RigDoc by joining against the Animator's per-session cost snapshot.
  *
  * Read-only. Pure derived fields; never persisted.
  *
@@ -11,15 +11,19 @@
  *   zeros; sessions that are missing from the book are skipped silently.
  * - tokenUsage fields are optional: when no contributing session has
  *   tokenUsage, the aggregate inputTokens/outputTokens are omitted.
+ *
+ * The cost data comes from AnimatorApi.getSessionCosts — the Animator owns
+ * the shape of cost answers, so consumers like this aggregator do not reach
+ * into the sessions book directly.
  */
+import { guild } from '@shardworks/nexus-core';
 /**
- * Build a RigView for a single rig by reading every engine's session doc
- * (if any) from the animator/sessions book and summing cost + token usage.
+ * Build a RigView for a single rig by asking the Animator for cost/token
+ * snapshots of every engine's session (if any) and summing across them.
  *
  * Does not mutate the rig. Safe to call on every read.
  */
-export async function enrichRigView(rig, stacks) {
-    const sessionsBook = stacks.readBook('animator', 'sessions');
+export async function enrichRigView(rig) {
     // Collect (engineId, sessionId) pairs to look up.
     const pairs = [];
     for (const engine of rig.engines || []) {
@@ -31,19 +35,23 @@ export async function enrichRigView(rig, stacks) {
     if (pairs.length === 0) {
         return { ...rig };
     }
-    // Fetch all sessions concurrently.
-    const sessions = await Promise.all(pairs.map((p) => sessionsBook.get(p.sessionId).catch(() => null)));
+    // Resolve the Animator via the same apparatus-resolution mechanism
+    // Spider's engines use elsewhere, and fetch cost snapshots in a single
+    // bulk call. Missing ids are silently omitted from the returned Map
+    // (see AnimatorApi.getSessionCosts), which preserves the "missing = zero
+    // contribution" semantic this aggregator has always had.
+    const animator = guild().apparatus('animator');
+    const costs = await animator.getSessionCosts(pairs.map((p) => p.sessionId));
     const engineCosts = {};
     let totalCostUsd = 0;
     let totalInputTokens = 0;
     let totalOutputTokens = 0;
     let anyTokenUsage = false;
-    for (let i = 0; i < pairs.length; i++) {
-        const { engineId } = pairs[i];
-        const session = sessions[i];
-        const costUsd = session?.costUsd ?? 0;
-        const inputTokens = session?.tokenUsage?.inputTokens;
-        const outputTokens = session?.tokenUsage?.outputTokens;
+    for (const { engineId, sessionId } of pairs) {
+        const cost = costs.get(sessionId);
+        const costUsd = cost?.costUsd ?? 0;
+        const inputTokens = cost?.inputTokens;
+        const outputTokens = cost?.outputTokens;
         const engineCost = { costUsd };
         if (inputTokens !== undefined)
             engineCost.inputTokens = inputTokens;
@@ -74,7 +82,7 @@ export async function enrichRigView(rig, stacks) {
 /**
  * Enrich an array of rigs in parallel.
  */
-export async function enrichRigViews(rigs, stacks) {
-    return Promise.all(rigs.map((r) => enrichRigView(r, stacks)));
+export async function enrichRigViews(rigs) {
+    return Promise.all(rigs.map((r) => enrichRigView(r)));
 }
 //# sourceMappingURL=rig-view.js.map

package/dist/rig-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"rig-view.js","sourceRoot":"","sources":["../src/rig-view.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rig-view.js","sourceRoot":"","sources":["../src/rig-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAS/C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,kDAAkD;IAClD,MAAM,KAAK,GAAmD,EAAE,CAAC;IACjE,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,mEAAmE;IACnE,uEAAuE;IACvE,oEAAoE;IACpE,yEAAyE;IACzE,yDAAyD;IACzD,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAE5E,MAAM,WAAW,GAAsC,EAAE,CAAC;IAC1D,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,KAAK,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,KAAK,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAElC,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,CAAC;QACtC,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,CAAC;QAExC,MAAM,UAAU,GAAsB,EAAE,OAAO,EAAE,CAAC;QAClD,IAAI,WAAW,KAAK,SAAS;YAAE,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QACpE,IAAI,YAAY,KAAK,SAAS;YAAE,UAAU,CAAC,YAAY,GAAG,YAAY,CAAC;QACvE,WAAW,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;QAEnC,YAAY,IAAI,OAAO,CAAC;QACxB,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,gBAAgB,IAAI,WAAW,CAAC;YAChC,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,iBAAiB,IAAI,YAAY,CAAC;YAClC,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAmB,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAC9D,IAAI,aAAa,EAAE,CAAC;QAClB,WAAW,CAAC,WAAW,GAAG,gBAAgB,CAAC;QAC3C,WAAW,CAAC,YAAY,GAAG,iBAAiB,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,GAAG,GAAG;QACN,WAAW;QACX,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc;IACjD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/tools/rig-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rig-list.d.ts","sourceRoot":"","sources":["../../src/tools/rig-list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;;;;;;;;AAOxB,wBAkCG"}
+{"version":3,"file":"rig-list.d.ts","sourceRoot":"","sources":["../../src/tools/rig-list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;;;;;;;;AAMxB,wBAiCG"}

package/dist/tools/rig-list.js

@@ -34,13 +34,12 @@ export default tool({
     handler: async (params) => {
         const g = guild();
         const spider = g.apparatus('spider');
-        const stacks = g.apparatus('stacks');
         const rigs = await spider.list({
             status: params.status,
             limit: params.limit,
             offset: params.offset,
         });
-        return enrichRigViews(rigs, stacks);
+        return enrichRigViews(rigs);
     },
 });
 //# sourceMappingURL=rig-list.js.map

package/dist/tools/rig-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"rig-list.js","sourceRoot":"","sources":["../../src/tools/rig-list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,iCAAiC;IAC9C,YAAY,EACV,+DAA+D;QAC/D,4EAA4E;QAC5E,4EAA4E;QAC5E,0EAA0E;IAC5E,MAAM,EAAE;QACN,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;aAC5D,QAAQ,EAAE;aACV,QAAQ,CAAC,uBAAuB,CAAC;QACpC,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0CAA0C,CAAC;QACvD,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4BAA4B,CAAC;KAC1C;IACD,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAsB,EAAE;QAC5C,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YAC7B,MAAM,EAAE,MAAM,CAAC,MAA+B;YAC9C,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"rig-list.js","sourceRoot":"","sources":["../../src/tools/rig-list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,iCAAiC;IAC9C,YAAY,EACV,+DAA+D;QAC/D,4EAA4E;QAC5E,4EAA4E;QAC5E,0EAA0E;IAC5E,MAAM,EAAE;QACN,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;aAC5D,QAAQ,EAAE;aACV,QAAQ,CAAC,uBAAuB,CAAC;QACpC,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0CAA0C,CAAC;QACvD,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4BAA4B,CAAC;KAC1C;IACD,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAsB,EAAE;QAC5C,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;YAC7B,MAAM,EAAE,MAAM,CAAC,MAA+B;YAC9C,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/rig-show.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rig-show.d.ts","sourceRoot":"","sources":["../../src/tools/rig-show.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAOxB,wBAkBG"}
+{"version":3,"file":"rig-show.d.ts","sourceRoot":"","sources":["../../src/tools/rig-show.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAMxB,wBAiBG"}

package/dist/tools/rig-show.js

@@ -22,9 +22,8 @@ export default tool({
     handler: async (params) => {
         const g = guild();
         const spider = g.apparatus('spider');
-        const stacks = g.apparatus('stacks');
         const rig = await spider.show(params.id);
-        return enrichRigView(rig, stacks);
+        return enrichRigView(rig);
     },
 });
 //# sourceMappingURL=rig-show.js.map

package/dist/tools/rig-show.js.map

@@ -1 +1 @@
-{"version":3,"file":"rig-show.js","sourceRoot":"","sources":["../../src/tools/rig-show.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,sBAAsB;IACnC,YAAY,EACV,wEAAwE;QACxE,gFAAgF;QAChF,uGAAuG;IACzG,MAAM,EAAE;QACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KAClD;IACD,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAoB,EAAE;QAC1C,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"rig-show.js","sourceRoot":"","sources":["../../src/tools/rig-show.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,sBAAsB;IACnC,YAAY,EACV,wEAAwE;QACxE,gFAAgF;QAChF,uGAAuG;IACzG,MAAM,EAAE;QACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KAClD;IACD,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAoB,EAAE;QAC1C,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardworks/spider-apparatus",
-  "version": "0.1.238",
+  "version": "0.1.240",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -22,17 +22,17 @@
     "hono": "^4.7.11",
     "yaml": "^2.0.0",
     "zod": "4.3.6",
-    "@shardworks/fabricator-apparatus": "0.1.238",
-    "@shardworks/clerk-apparatus": "0.1.238",
-    "@shardworks/stacks-apparatus": "0.1.238",
-    "@shardworks/tools-apparatus": "0.1.238",
-    "@shardworks/codexes-apparatus": "0.1.238",
-    "@shardworks/animator-apparatus": "0.1.238",
-    "@shardworks/loom-apparatus": "0.1.238"
+    "@shardworks/fabricator-apparatus": "0.1.240",
+    "@shardworks/stacks-apparatus": "0.1.240",
+    "@shardworks/animator-apparatus": "0.1.240",
+    "@shardworks/codexes-apparatus": "0.1.240",
+    "@shardworks/loom-apparatus": "0.1.240",
+    "@shardworks/tools-apparatus": "0.1.240",
+    "@shardworks/clerk-apparatus": "0.1.240"
   },
   "devDependencies": {
     "@types/node": "25.5.0",
-    "@shardworks/nexus-core": "0.1.238"
+    "@shardworks/nexus-core": "0.1.240"
   },
   "files": [
     "dist",

package/src/static/spider-ui.test.ts

@@ -521,8 +521,8 @@ describe('spider.js engine-detail stable-skeleton + updater', () => {
     );
     assert.match(
       updaterBlock[0],
-      /setText\(['"]ed-cost['"]\s*,\s*formatCostWithTokens\(/,
-      'engine-detail cost row should render via formatCostWithTokens()',
+      /setText\(['"]ed-cost['"]\s*,\s*window\.NexusFormat\.formatCostWithTokens\(/,
+      'engine-detail cost row should render via window.NexusFormat.formatCostWithTokens()',
     );
     assert.match(
       updaterBlock[0],
@@ -1033,70 +1033,48 @@ describe('spider.js server-supplied engine cost', () => {
   });
 });
 
-// ── Cost / token formatting helpers ─────────────────────────────────────
+// ── Cost / token formatting via shared namespace ────────────────────────
 
-describe('spider.js cost/token formatting helpers', () => {
-  // T3 / D6 / D7: a single source of truth for cost + token rendering,
-  // always using the explicit 'en-US' locale so grouping is stable.
+describe('spider.js cost/token formatting delegates to window.NexusFormat', () => {
+  // Spider no longer defines its own cost/token helpers. The shared
+  // formatter lives in oculus's static asset (nexus-format.js) and is
+  // auto-injected into the dashboard <head> before this IIFE runs, so
+  // every dashboard in the guild uses the same precision and locale.
 
-  it('defines formatTokenCount using toLocaleString(en-US)', () => {
-    assert.match(
+  it('does not redefine formatTokenCount locally', () => {
+    assert.doesNotMatch(
       spiderJs,
-      /function formatTokenCount\(n\)/,
-      'should define formatTokenCount helper',
-    );
-    const block = spiderJs.match(
-      /function formatTokenCount[\s\S]*?(?=\n  function )/,
-    );
-    assert.ok(block, 'should find formatTokenCount body');
-    assert.match(
-      block[0],
-      /toLocaleString\(['"]en-US['"]\)/,
-      'formatTokenCount should pass "en-US" locale explicitly',
+      /function formatTokenCount\(/,
+      'spider.js must not redeclare formatTokenCount — use window.NexusFormat.formatTokenCount',
     );
   });
 
-  it('defines formatCostUsd that always emits $x.yy (2 decimals)', () => {
-    assert.match(
+  it('does not redefine formatCostUsd locally', () => {
+    assert.doesNotMatch(
       spiderJs,
-      /function formatCostUsd\(costUsd\)/,
-      'should define formatCostUsd helper',
-    );
-    const block = spiderJs.match(
-      /function formatCostUsd[\s\S]*?(?=\n\s*\/\*\*|\n  function )/,
-    );
-    assert.ok(block, 'should find formatCostUsd body');
-    assert.match(
-      block[0],
-      /toFixed\(2\)/,
-      'formatCostUsd should format to two decimal places',
-    );
-    assert.match(
-      block[0],
-      /['"]\$['"]\s*\+/,
-      'formatCostUsd should prefix with "$"',
+      /function formatCostUsd\(/,
+      'spider.js must not redeclare formatCostUsd — use window.NexusFormat.formatCostUsd',
     );
   });
 
-  it('defines formatCostWithTokens that omits parenthetical when tokens absent', () => {
-    assert.match(
+  it('does not redefine formatCostWithTokens locally', () => {
+    assert.doesNotMatch(
       spiderJs,
-      /function formatCostWithTokens\(costUsd, inputTokens, outputTokens\)/,
-      'should define formatCostWithTokens helper',
-    );
-    const block = spiderJs.match(
-      /function formatCostWithTokens[\s\S]*?(?=\n  function )/,
+      /function formatCostWithTokens\(/,
+      'spider.js must not redeclare formatCostWithTokens — use window.NexusFormat.formatCostWithTokens',
     );
-    assert.ok(block, 'should find formatCostWithTokens body');
+  });
+
+  it('calls into window.NexusFormat for cost rendering', () => {
     assert.match(
-      block[0],
-      /inputTokens\s*===\s*undefined\s*\|\|\s*outputTokens\s*===\s*undefined/,
-      'formatCostWithTokens should detect absent tokens and skip parenthetical',
+      spiderJs,
+      /window\.NexusFormat\.formatCostUsd\(/,
+      'spider.js should route cost rendering through window.NexusFormat.formatCostUsd',
     );
     assert.match(
-      block[0],
-      /formatTokenCount\(inputTokens\)[\s\S]*?input[\s\S]*?formatTokenCount\(outputTokens\)[\s\S]*?output/,
-      'formatCostWithTokens should render "(N input, M output)" via formatTokenCount',
+      spiderJs,
+      /window\.NexusFormat\.formatCostWithTokens\(/,
+      'spider.js should route cost+tokens rendering through window.NexusFormat.formatCostWithTokens',
     );
   });
 });
@@ -1228,14 +1206,14 @@ describe('spider.js rig-meta stable-id skeleton', () => {
     );
   });
 
-  it('updateRigMeta writes cost via formatCostWithTokens', () => {
+  it('updateRigMeta writes cost via window.NexusFormat.formatCostWithTokens', () => {
     const block = spiderJs.match(
       /function updateRigMeta\(rig\)[\s\S]*?(?=\n  function |\n  \/\/)/,
     );
     assert.ok(block, 'should find updateRigMeta body');
     assert.match(
       block[0],
-      /setText\(['"]rig-meta-cost['"]\s*,\s*formatCostWithTokens\(/,
+      /setText\(['"]rig-meta-cost['"]\s*,\s*window\.NexusFormat\.formatCostWithTokens\(/,
       'updateRigMeta should render cost via the shared formatter',
     );
     assert.match(

package/src/static/spider.js

@@ -94,38 +94,11 @@
   }
 
   // ── Cost / token formatting ────────────────────────────────────────────
-
-  // Single source of truth for grouping conventions. Always pass 'en-US'
-  // explicitly so the comma separator is consistent regardless of viewer
-  // locale.
-  function formatTokenCount(n) {
-    return Number(n).toLocaleString('en-US');
-  }
-
-  /**
-   * Format a cost value as `$x.yy`. Used for the rig-list Cost column
-   * and any other surface that shows cost without tokens.
-   */
-  function formatCostUsd(costUsd) {
-    var n = Number(costUsd);
-    if (!isFinite(n)) n = 0;
-    return '$' + n.toFixed(2);
-  }
-
-  /**
-   * Format a cost + tokens triplet as `$x.yy (N input, M output)` with
-   * thousands-separator grouping. When either token count is absent
-   * (undefined), the parenthetical is omitted entirely — matching the
-   * brief's rule that we never render `(0 input, 0 output)` when no
-   * anima session has reported usage.
-   */
-  function formatCostWithTokens(costUsd, inputTokens, outputTokens) {
-    var cost = formatCostUsd(costUsd);
-    if (inputTokens === undefined || outputTokens === undefined) {
-      return cost;
-    }
-    return cost + ' (' + formatTokenCount(inputTokens) + ' input, ' + formatTokenCount(outputTokens) + ' output)';
-  }
+  //
+  // Cost and token formatting routes through the shared window.NexusFormat
+  // namespace (served by oculus and auto-injected into every dashboard
+  // page, so it is defined before this IIFE runs). The namespace is the
+  // single source of truth — no local redefinitions here.
 
   function formatElapsed(startedAt, completedAt) {
     var diffMs = new Date(completedAt) - new Date(startedAt);
@@ -745,7 +718,7 @@
     var costTd = row.querySelector('.rig-row-cost');
     if (costTd) {
       var costUsd = (rig.costSummary && typeof rig.costSummary.costUsd === 'number') ? rig.costSummary.costUsd : 0;
-      var costText = formatCostUsd(costUsd);
+      var costText = window.NexusFormat.formatCostUsd(costUsd);
       if (costTd.textContent !== costText) costTd.textContent = costText;
     }
 
@@ -818,7 +791,7 @@
     var costUsd = summary ? summary.costUsd : 0;
     var inputTokens = summary ? summary.inputTokens : undefined;
     var outputTokens = summary ? summary.outputTokens : undefined;
-    setText('rig-meta-cost', formatCostWithTokens(costUsd, inputTokens, outputTokens));
+    setText('rig-meta-cost', window.NexusFormat.formatCostWithTokens(costUsd, inputTokens, outputTokens));
   }
 
   // ── Show rig detail ────────────────────────────────────────────────────
@@ -1310,7 +1283,7 @@
     // Updates on the 2 s rig poll cadence without any per-engine fetch.
     var engineCost = (currentRig && currentRig.engineCosts) ? currentRig.engineCosts[engine.id] : undefined;
     if (engineCost) {
-      setText('ed-cost', formatCostWithTokens(engineCost.costUsd, engineCost.inputTokens, engineCost.outputTokens));
+      setText('ed-cost', window.NexusFormat.formatCostWithTokens(engineCost.costUsd, engineCost.inputTokens, engineCost.outputTokens));
       setRowDisplay('ed-cost-dt', 'ed-cost', true);
     } else {
       setText('ed-cost', '');