nodality 1.1.14 → 1.2.0

package/bin/mcp-server.mjs

@@ -76,9 +76,19 @@ const NODES_SCHEMA = {
     "array order); `{ op: { name: \"shadow\" }, target: [...] }` is a " +
     "design node; `{ op: \"morph\", from: \"topnav\", to: { \"About\": " +
     "\"about\" }, effect: \"t-vhs\", duration: 900, back: true }` is a " +
-    "transition — one element becomes another on interaction. Nothing in " +
-    "N names a component; the two arrays meet only through `target`, " +
-    "`from` and `to`. Call list_ops first for the exact vocabulary.",
+    "transition — one element becomes another on interaction. A morph " +
+    "describes a whole navigation graph by carrying `chain` instead of one " +
+    "`from`/`to`: `{ op: \"morph\", effect: \"t-vhs\", duration: 620, " +
+    "back: true, chain: [ { from: \"home\", to: { \"Work\": \"work\" } }, " +
+    "{ from: \"work\", to: { \"Detail\": \"detail\" }, effect: \"t-split\" } " +
+    "] }`. The entries are EDGES, not keyframes: edge two is reachable " +
+    "FROM the state edge one lands on, so a landed state becomes a source. " +
+    "Settings on the node are defaults each edge may override, and `chain` " +
+    "wins outright — node-level `from`/`to` are not read beside it. " +
+    "Nothing in N names a component; the two arrays meet only through " +
+    "`target`, `from` and `to`, each of which names an element id, written " +
+    "either bare (\"work\") or in selector form (\"#work\"). Call list_ops " +
+    "first for the exact vocabulary.",
   items: { type: "object" },
 };
 
@@ -199,13 +209,39 @@ const IMPL = {
       },
     });
 
-    const bytes = (await readFile(out)).length;
+    const html = await readFile(out, "utf8");
+    const bytes = Buffer.byteLength(html);
+
+    // The surface this pair would give an OPERATING agent, reported to
+    // the GENERATING one. The two loops meet here: a model writing the
+    // page can see the tools a model using the page will be handed, and
+    // can tell before shipping that a form it meant to expose derived
+    // nothing. Lifted out of the rendered page rather than derived a
+    // second time, so what is reported is what the build emitted.
+    let surface;
+    const at = html.indexOf('id="nodality-agent-manifest"');
+    if (at >= 0) {
+      const s = html.indexOf(">", at);
+      const e = html.indexOf("</script>", s);
+      if (s >= 0 && e > s) {
+        try {
+          const m = JSON.parse(html.slice(s + 1, e));
+          surface = {
+            tools: m.tools.map((x) => ({ name: x.name, description: x.description })),
+            views: m.views || null,
+          };
+        } catch { /* a malformed declaration is simply not reported */ }
+      }
+    }
+
     return ok({
       path: out, bytes,
+      ...(surface ? { surface } : {}),
       // Said plainly, because an agent cannot see the result and would
       // otherwise report a shader that never ran as working.
       note: "Prerendered DOM only. Raster effects and morph transitions " +
-            "need a GPU and run when this file is opened in a browser.",
+            "need a GPU and run when this file is opened in a browser." +
+            (surface ? " `surface` is what an agent operating this page would be offered." : ""),
     });
   },
 };

package/bin/nodality.js

@@ -596,6 +596,67 @@ async function runPrerender(rawArgs) {
   }
 
   await prerenderSite(config);
+  writeAgentManifest(config);
+}
+
+/**
+ * Lift the agent surface out of the prerendered pages into one file.
+ *
+ * Nothing derives anything here. The declaration was written into each
+ * document by the SAME code that registers the tools at runtime, so by
+ * the time prerendering has finished it is already serialised inside the
+ * static HTML — this only gathers it up, so that a consumer which wants
+ * capability without parsing pages has one URL to fetch. That is the
+ * half of the agent story that needs no browser support, no origin
+ * trial and no standard: a crawler, an indexer, or an agent deciding
+ * whether the site is worth visiting reads it without executing
+ * anything.
+ *
+ * Byte-stability matters and is asserted in the suite: the file ships
+ * from a build, so it inherits the determinism the whole model rests on
+ * — pages are visited in sorted order and nothing here is timestamped.
+ */
+function writeAgentManifest(config) {
+  const uploadDir = path.resolve(config.uploadDir || "upload");
+  const MANIFEST_ID = "nodality-agent-manifest";
+  const pages = {};
+
+  const scan = (dir, prefix = "") => {
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+      const abs = path.join(dir, e.name);
+      if (e.isDirectory()) {
+        if (["node_modules", "dist", "lib", "layout", "assets", "p"].includes(e.name)) continue;
+        scan(abs, prefix + e.name + "/");
+        continue;
+      }
+      if (!e.name.endsWith(".html")) continue;
+      const html = fs.readFileSync(abs, "utf8");
+      // Located by id rather than parsed: the file is emitted by us, and
+      // a dependency-free substring read cannot be broken by whatever a
+      // page happens to contain elsewhere.
+      const open = html.indexOf(`id="${MANIFEST_ID}"`);
+      if (open < 0) continue;
+      const start = html.indexOf(">", open);
+      const end = html.indexOf("</script>", start);
+      if (start < 0 || end < 0) continue;
+      try {
+        pages[prefix + e.name] = JSON.parse(html.slice(start + 1, end));
+      } catch { /* a page that did not finish rendering is simply absent */ }
+    }
+  };
+  scan(uploadDir);
+
+  const out = path.join(uploadDir, "agent-manifest.json");
+  if (!Object.keys(pages).length) {
+    // No page declared a surface: remove a stale file rather than leave
+    // one claiming capabilities the site no longer offers.
+    if (fs.existsSync(out)) fs.unlinkSync(out);
+    return;
+  }
+  fs.writeFileSync(out, JSON.stringify({ origin: config.origin || null, pages }, null, 2) + "\n");
+  console.log(`✅ Agent manifest — ${Object.keys(pages).length} page(s) → agent-manifest.json`);
 }
 
 // ─── compile subcommand ────────────────────────────────────────

package/dist/animator.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/animator.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/audionew.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/audionew.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/base.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/base.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/beta-desktop-bar.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/beta-desktop-bar.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/beta-mobile-bar.cjs.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/dist/beta-mobile-bar.esm.js.LICENSE.txt

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.1.13
+ * nodality v1.1.15
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */