aimeat 1.25.0 → 1.26.0

package/dist/public/js/services/memory.js

@@ -28,6 +28,19 @@ export async function searchMemory(query, agentGaii) {
   return Array.isArray(list) ? list : [];
 }
 
+/**
+ * Librarian full-text search across all of the caller's content (GET /v1/librarian/search).
+ * Returns the ranked hits array (each: { key, title, snippet, score, organismId, workspaceId, ... }).
+ */
+export async function librarianSearch(query, limit, scope) {
+  let url = `/v1/librarian/search?q=${encodeURIComponent(query)}`;
+  if (limit) url += `&limit=${encodeURIComponent(limit)}`;
+  if (scope) url += `&scope=${encodeURIComponent(scope)}`;
+  const data = await apiGet(url);
+  const hits = data?.data?.hits || [];
+  return Array.isArray(hits) ? hits : [];
+}
+
 /**
  * Create a new memory entry.
  * @param {string} [agentGaii] Owner-session only — store the entry under one of

package/dist/public/js/services/messages.js

@@ -9,13 +9,14 @@
  * @usage import * as messages from '/js/services/messages.js';
  * @version-history
  *   v1.0.0 -- 2026-06-16 -- Initial creation for user-to-user messaging (layer 5: Inbox tab).
+ *   v1.0.1 -- 2026-06-19 -- JSDoc type annotations for frontend type-checking
  */
 import { api, apiGet } from '/js/api.js';
 
 const enc = encodeURIComponent;
 
 /** Send a direct message. `attachments` is an array of descriptors (storage_key, mime, size, kind, inline, id). */
-export async function send({ to, body, attachments, replyTo }) {
+export async function send({ to, body, attachments, replyTo } = /** @type {{ to?: any, body?: any, attachments?: any, replyTo?: any }} */ ({})) {
   return api('/v1/messages', {
     method: 'POST',
     body: JSON.stringify({ to, body, attachments, reply_to: replyTo }),

package/dist/public/js/services/notebook.js

@@ -0,0 +1,124 @@
+/**
+ * @file notebook.js
+ * @description Notebook slice B client service. classifyNote() asks the backend AI classifier where a
+ *   note belongs; materializeDocument() then ORCHESTRATES the placement over the existing generic
+ *   memory/organism APIs (no-SSR — the client composes create-organism / create-workspace /
+ *   write-document; there is no per-feature backend write route). Supports an existing target, a new
+ *   workspace in an existing organism, or a brand-new organism+workspace, always materializing the
+ *   note as a workspace DOCUMENT.
+ * @structure
+ *   - classifyNote(text) — POST /v1/librarian/classify
+ *   - materializeDocument(plan) — resolve/create org → ws → document space → write doc → drop source
+ * @version-history
+ *   v1.0.0 — 2026-06-19 — Initial: classify + materialize-document orchestration (slice B).
+ */
+import { api, apiPost } from '/js/api.js';
+import { createMemory, getMemory, deleteMemory } from '/js/services/memory.js';
+import { createOrganism, saveManifest, listWorkspaces, saveWorkspaceRegistry, wsRoot } from '/js/services/organisms.js';
+
+const DOC_SPACE = 'pages';
+
+function rid(prefix) {
+  const r = (typeof crypto !== 'undefined' && crypto.randomUUID) ? crypto.randomUUID().slice(0, 8) : Math.random().toString(36).slice(2, 10);
+  return prefix + r;
+}
+
+/** Ask the backend AI classifier where a note belongs. Returns the ClassifyResult envelope's data.
+ *  This is a slow AI call — give it the full AI timeout (30 min) and DO NOT retry, otherwise the
+ *  default 30s client timeout aborts a model that is still thinking and re-fires the request. */
+export async function classifyNote(text) {
+  const resp = await api('/v1/librarian/classify', {
+    method: 'POST',
+    body: JSON.stringify({ text }),
+    timeoutMs: 1_800_000,
+    retries: 0,
+  });
+  if (resp?.ok === false) throw new Error(resp.error?.message || 'Classify failed');
+  return resp?.data || null;
+}
+
+/** A document-space objectType for a memory-backed workspace. */
+function docSpaceObjectType() {
+  return { name: 'Pages', namespace: DOC_SPACE, schemaRef: 'schema:document@1', mode: 'document', backing: 'memory', writeRole: 'member', cardinality: 'many', versioned: true };
+}
+
+function newWorkspaceManifest(orgId, name) {
+  return { manifestVersion: '1.0', id: orgId, name: name || 'Notebook', kind: 'project', status: 'active', objectTypes: [docSpaceObjectType()] };
+}
+
+/** Read a workspace manifest (raw value), or null if it has none / is unreadable. */
+async function readManifest(orgId, wsId) {
+  try {
+    const r = await getMemory(`${wsRoot(orgId, wsId)}.meta.manifest`);
+    return r?.data?.value || null;
+  } catch { return null; }
+}
+
+/**
+ * Materialize a note into a workspace document.
+ * @param {object} plan
+ * @param {string|null} plan.organismId  Existing organism id, or null to create one.
+ * @param {string} [plan.organismName]   Name for a new organism (when organismId is null).
+ * @param {string|null} plan.workspaceId Existing workspace id, or null to create one.
+ * @param {string} [plan.workspaceName]  Name for a new workspace (when workspaceId is null).
+ * @param {string|null} plan.space       Existing document-space namespace, or null to use/create the default.
+ * @param {string} plan.title
+ * @param {string} plan.markdown
+ * @param {string} [plan.sourceKey]      Inbox note key to delete once filed.
+ * @returns {Promise<{organismId:string, workspaceId:string, space:string, docId:string}>}
+ */
+export async function materializeDocument(plan) {
+  let { organismId, workspaceId, space } = plan;
+
+  // 1. Organism — create if needed.
+  if (!organismId) {
+    const resp = await createOrganism({
+      name: (plan.organismName || 'Notebook').trim(),
+      description: 'Created from the notebook',
+      type: 'project',
+      join_policy: 'approval_required',
+      visibility: 'private',
+    });
+    if (resp?.ok === false) throw new Error(resp.error?.message || 'Could not create organism');
+    organismId = resp?.data?.organism?.id;
+    if (!organismId) throw new Error('Organism creation returned no id');
+  }
+
+  // 2. Workspace — create if needed (registry + manifest with a document space).
+  if (!workspaceId) {
+    workspaceId = rid('ws-');
+    const manifest = newWorkspaceManifest(organismId, plan.workspaceName);
+    await saveManifest(organismId, workspaceId, manifest);
+    await apiPost('/v1/memory', { key: `${wsRoot(organismId, workspaceId)}.meta.readme`, value: `# ${manifest.name}\n\nCreated from the notebook.`, visibility: 'private' });
+    const existing = await listWorkspaces(organismId);
+    await saveWorkspaceRegistry(organismId, [...existing, { id: workspaceId, name: manifest.name, createdAt: new Date().toISOString() }]);
+    space = DOC_SPACE;
+  }
+
+  // 3. Document space — ensure one exists on the chosen workspace.
+  if (!space) {
+    const manifest = await readManifest(organismId, workspaceId);
+    const existingDoc = (manifest?.objectTypes || []).find(ot => (ot.mode === 'document') || (!ot.mode && ot.kind === 'document'));
+    if (existingDoc?.namespace) {
+      space = existingDoc.namespace;
+    } else if (manifest) {
+      // Best-effort: add a default document space to the manifest so the doc renders.
+      const updated = { ...manifest, objectTypes: [...(manifest.objectTypes || []), docSpaceObjectType()] };
+      await saveManifest(organismId, workspaceId, updated).catch(() => {});
+      space = DOC_SPACE;
+    } else {
+      space = DOC_SPACE;
+    }
+  }
+
+  // 4. Write the document.
+  const docId = rid('doc-');
+  const key = `${wsRoot(organismId, workspaceId)}.${space}.${docId}.latest`;
+  const resp = await createMemory(key, { id: docId, title: plan.title, markdown: plan.markdown }, 'private');
+  if (resp?.ok === false) throw new Error(resp.error?.message || 'Could not write document');
+
+  // 5. Drop the source inbox note (it has been filed).
+  if (plan.sourceKey) await deleteMemory(plan.sourceKey).catch(() => {});
+
+  return { organismId, workspaceId, space, docId };
+}

package/dist/public/js/services/packages.js

@@ -16,6 +16,7 @@
  *   v1.0.0 — 2026-03-15 — initial implementation (Phase 6)
  *   v1.1.0 — 2026-03-20 — add exportPackageZip, importPackageZip, proposeAsTemplate
  *   v1.2.0 — 2026-03-20 — add syncFederationTemplates, listFederationTemplates
+ *   v1.2.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 import { apiGet, apiPost, apiPatch, apiDelete } from '/js/api.js';
 
@@ -54,7 +55,7 @@ export const toggleFeatured = (id, featured) => apiPatch(`/v1/templates/${enc(id
 // ── ZIP Import/Export ──
 export async function exportPackageZip(groupId) {
   const session = window.AIMEAT?.auth?.getSession?.();
-  const headers = {};
+  const headers = /** @type {Record<string,string>} */ ({});
   if (session?.jwt) headers['Authorization'] = `Bearer ${session.jwt}`;
   const res = await fetch(`/v1/packages/${enc(groupId)}/export`, { headers });
   if (!res.ok) throw new Error(`Export failed: ${res.status}`);
@@ -65,7 +66,7 @@ export async function importPackageZip(file) {
   const session = window.AIMEAT?.auth?.getSession?.();
   const formData = new FormData();
   formData.append('file', file);
-  const headers = {};
+  const headers = /** @type {Record<string,string>} */ ({});
   if (session?.jwt) headers['Authorization'] = `Bearer ${session.jwt}`;
   const res = await fetch('/v1/packages/import', {
     method: 'POST',

package/dist/public/js/services/presence.js

@@ -0,0 +1,35 @@
+/**
+ * @file presence.js
+ * @description AIMEAT Presence Service — thin API layer over /v1/presence/*. Read
+ *   your own config + status, update it, and read viewer-scoped status for one or
+ *   many identities. List/dot rendering should go through /js/presence-store.js
+ *   (cache + batch coalescing) rather than calling getPresence per row.
+ * @structure getMyPresence / setMyPresence / getPresence / getPresenceBatch
+ * @usage import { getPresenceBatch } from '/js/services/presence.js';
+ * @version-history
+ *   v1.0.0 — 2026-06-19 — Initial presence service.
+ */
+import { apiGet, apiPut } from '/js/api.js';
+
+/** Read the caller's own presence config + computed status. Returns the envelope. */
+export async function getMyPresence() {
+  return apiGet('/v1/presence/me');
+}
+
+/** Update the caller's presence config (partial: { mode, status, visibility }). */
+export async function setMyPresence(config) {
+  return apiPut('/v1/presence/me', config);
+}
+
+/** Viewer-scoped status of a single identity. Returns the envelope ({ data: { ghii, status, since } }). */
+export async function getPresence(ghii) {
+  return apiGet(`/v1/presence/${encodeURIComponent(ghii)}`);
+}
+
+/** Batch viewer-scoped status. Returns a map of ghii → { status, since }. */
+export async function getPresenceBatch(ghiis) {
+  const ids = (ghiis || []).map(encodeURIComponent).join(',');
+  if (!ids) return {};
+  const r = await apiGet(`/v1/presence?ids=${ids}`);
+  return r?.data?.presence || {};
+}

package/dist/public/js/style-testbed.js

@@ -7,6 +7,7 @@
  *   (no inline handlers) to satisfy the static-asset CSP (script-src 'self').
  * @version-history
  *   v1.0.0 — 2026-06-02 — Initial testbed behavior
+ *   v1.0.1 — 2026-06-19 — JSDoc type annotations for frontend type-checking
  */
 (function () {
   'use strict';
@@ -95,7 +96,7 @@
         const sel = variant.querySelector('.stb-decide');
         if (!sel) return; // canonical reference — no decision
         total += 1;
-        const val = sel.value;
+        const val = /** @type {HTMLInputElement} */ (sel).value;
         if (val !== '') decided += 1;
         sel.classList.toggle('stb-chosen', val !== '');
         const clone = variant.getAttribute('data-clone') || '';
@@ -104,7 +105,7 @@
         rows.push('  [' + pad(LABEL[val] || val, 18) + '] ' + pad(clone, 46) + ' ' + sitesStr);
       });
       const note = fam.querySelector('.stb-note');
-      const noteVal = note && note.value.trim();
+      const noteVal = note && /** @type {HTMLInputElement} */ (note).value.trim();
 
       lines.push('## ' + famName);
       rows.forEach((r) => lines.push(r));
@@ -113,7 +114,7 @@
     });
 
     const out = document.getElementById('stb-output');
-    if (out) out.value = lines.join('\n');
+    if (out) /** @type {HTMLInputElement} */ (out).value = lines.join('\n');
     const count = document.getElementById('stb-count');
     if (count) count.textContent = '(' + decided + '/' + total + ' clones decided)';
   }
@@ -140,9 +141,9 @@
       setTimeout(() => { btn.classList.remove('stb-copied'); btn.textContent = prev; }, 1500);
     };
     if (navigator.clipboard && navigator.clipboard.writeText) {
-      navigator.clipboard.writeText(out.value).then(done, () => { out.select(); document.execCommand('copy'); done(); });
+      navigator.clipboard.writeText(/** @type {HTMLInputElement} */ (out).value).then(done, () => { /** @type {HTMLInputElement} */ (out).select(); document.execCommand('copy'); done(); });
     } else {
-      out.select();
+      /** @type {HTMLInputElement} */ (out).select();
       document.execCommand('copy');
       done();
     }

package/dist/public/lib/minidenticons.min.js

@@ -1 +1,2 @@
+// @ts-nocheck — vendored minified third-party bundle; not type-checked by tsconfig.frontend.json
 const t=5;function e(e){return e.split("").reduce(((e,n)=>(e^n.charCodeAt(0))*-t),t)>>>2}export function minidenticon(t="",n=95,i=45,s=e){const o=s(t),c=o%9*40;return[...Array(t?25:0)].reduce(((t,e,n)=>o&1<<n%15?t+`<rect x="${n>14?7-~~(n/5):~~(n/5)}" y="${n%5}" width="1" height="1"/>`:t),`<svg viewBox="-1.5 -1.5 8 8" xmlns="http://www.w3.org/2000/svg" fill="hsl(${c} ${n}% ${i}%)">`)+"</svg>"}export const minidenticonSvg=globalThis.customElements?.get("minidenticon-svg")?null:globalThis.customElements?.define("minidenticon-svg",class t extends HTMLElement{static observedAttributes=["username","saturation","lightness"];static#t={};#e=!1;connectedCallback(){this.#n(),this.#e=!0}attributeChangedCallback(){this.#e&&this.#n()}#n(){const e=t.observedAttributes.map((t=>this.getAttribute(t)||void 0)),n=e.join(",");this.innerHTML=t.#t[n]??=minidenticon(...e)}});

package/dist/public/lib/yaml.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck — vendored minified third-party bundle; not type-checked by tsconfig.frontend.json
 /* esm.sh - yaml@2.8.2 */
 var un=Object.defineProperty;var ps=(s,e)=>{for(var t in e)un(s,t,{get:e[t],enumerable:!0})};var us={};ps(us,{Alias:()=>ee,CST:()=>ls,Composer:()=>be,Document:()=>se,Lexer:()=>Be,LineCounter:()=>De,Pair:()=>v,Parser:()=>we,Scalar:()=>y,Schema:()=>ve,YAMLError:()=>_e,YAMLMap:()=>$,YAMLParseError:()=>F,YAMLSeq:()=>B,YAMLWarning:()=>Pe,isAlias:()=>x,isCollection:()=>L,isDocument:()=>R,isMap:()=>U,isNode:()=>I,isPair:()=>T,isScalar:()=>E,isSeq:()=>V,parse:()=>cn,parseAllDocuments:()=>ln,parseDocument:()=>fs,stringify:()=>fn,visit:()=>Q,visitAsync:()=>je});var tt=Symbol.for("yaml.alias"),st=Symbol.for("yaml.document"),Y=Symbol.for("yaml.map"),jt=Symbol.for("yaml.pair"),q=Symbol.for("yaml.scalar"),re=Symbol.for("yaml.seq"),K=Symbol.for("yaml.node.type"),x=s=>!!s&&typeof s=="object"&&s[K]===tt,R=s=>!!s&&typeof s=="object"&&s[K]===st,U=s=>!!s&&typeof s=="object"&&s[K]===Y,T=s=>!!s&&typeof s=="object"&&s[K]===jt,E=s=>!!s&&typeof s=="object"&&s[K]===q,V=s=>!!s&&typeof s=="object"&&s[K]===re;function L(s){if(s&&typeof s=="object")switch(s[K]){case Y:case re:return!0}return!1}function I(s){if(s&&typeof s=="object")switch(s[K]){case tt:case Y:case q:case re:return!0}return!1}var nt=s=>(E(s)||L(s))&&!!s.anchor;var j=Symbol("break visit"),ms=Symbol("skip children"),z=Symbol("remove node");function Q(s,e){let t=ds(e);R(s)?ke(null,s.contents,t,Object.freeze([s]))===z&&(s.contents=null):ke(null,s,t,Object.freeze([]))}Q.BREAK=j;Q.SKIP=ms;Q.REMOVE=z;function ke(s,e,t,n){let i=gs(s,e,t,n);if(I(i)||T(i))return ys(s,n,i),ke(s,i,t,n);if(typeof i!="symbol"){if(L(e)){n=Object.freeze(n.concat(e));for(let r=0;r<e.items.length;++r){let o=ke(r,e.items[r],t,n);if(typeof o=="number")r=o-1;else{if(o===j)return j;o===z&&(e.items.splice(r,1),r-=1)}}}else if(T(e)){n=Object.freeze(n.concat(e));let r=ke("key",e.key,t,n);if(r===j)return j;r===z&&(e.key=null);let o=ke("value",e.value,t,n);if(o===j)return j;o===z&&(e.value=null)}}return i}async function je(s,e){let t=ds(e);R(s)?await Ne(null,s.contents,t,Object.freeze([s]))===z&&(s.contents=null):await Ne(null,s,t,Object.freeze([]))}je.BREAK=j;je.SKIP=ms;je.REMOVE=z;async function Ne(s,e,t,n){let i=await gs(s,e,t,n);if(I(i)||T(i))return ys(s,n,i),Ne(s,i,t,n);if(typeof i!="symbol"){if(L(e)){n=Object.freeze(n.concat(e));for(let r=0;r<e.items.length;++r){let o=await Ne(r,e.items[r],t,n);if(typeof o=="number")r=o-1;else{if(o===j)return j;o===z&&(e.items.splice(r,1),r-=1)}}}else if(T(e)){n=Object.freeze(n.concat(e));let r=await Ne("key",e.key,t,n);if(r===j)return j;r===z&&(e.key=null);let o=await Ne("value",e.value,t,n);if(o===j)return j;o===z&&(e.value=null)}}return i}function ds(s){return typeof s=="object"&&(s.Collection||s.Node||s.Value)?Object.assign({Alias:s.Node,Map:s.Node,Scalar:s.Node,Seq:s.Node},s.Value&&{Map:s.Value,Scalar:s.Value,Seq:s.Value},s.Collection&&{Map:s.Collection,Seq:s.Collection},s):s}function gs(s,e,t,n){if(typeof t=="function")return t(s,e,n);if(U(e))return t.Map?.(s,e,n);if(V(e))return t.Seq?.(s,e,n);if(T(e))return t.Pair?.(s,e,n);if(E(e))return t.Scalar?.(s,e,n);if(x(e))return t.Alias?.(s,e,n)}function ys(s,e,t){let n=e[e.length-1];if(L(n))n.items[s]=t;else if(T(n))s==="key"?n.key=t:n.value=t;else if(R(n))n.contents=t;else{let i=x(n)?"alias":"scalar";throw new Error(`Cannot replace node with ${i} parent`)}}var hn={"!":"%21",",":"%2C","[":"%5B","]":"%5D","{":"%7B","}":"%7D"},pn=s=>s.replace(/[!,[\]{}]/g,e=>hn[e]),Z=class s{constructor(e,t){this.docStart=null,this.docEnd=!1,this.yaml=Object.assign({},s.defaultYaml,e),this.tags=Object.assign({},s.defaultTags,t)}clone(){let e=new s(this.yaml,this.tags);return e.docStart=this.docStart,e}atDocument(){let e=new s(this.yaml,this.tags);switch(this.yaml.version){case"1.1":this.atNextDocument=!0;break;case"1.2":this.atNextDocument=!1,this.yaml={explicit:s.defaultYaml.explicit,version:"1.2"},this.tags=Object.assign({},s.defaultTags);break}return e}add(e,t){this.atNextDocument&&(this.yaml={explicit:s.defaultYaml.explicit,version:"1.1"},this.tags=Object.assign({},s.defaultTags),this.atNextDocument=!1);let n=e.trim().split(/[ \t]+/),i=n.shift();switch(i){case"%TAG":{if(n.length!==2&&(t(0,"%TAG directive should contain exactly two parts"),n.length<2))return!1;let[r,o]=n;return this.tags[r]=o,!0}case"%YAML":{if(this.yaml.explicit=!0,n.length!==1)return t(0,"%YAML directive should contain exactly one part"),!1;let[r]=n;if(r==="1.1"||r==="1.2")return this.yaml.version=r,!0;{let o=/^\d+\.\d+$/.test(r);return t(6,`Unsupported YAML version ${r}`,o),!1}}default:return t(0,`Unknown directive ${i}`,!0),!1}}tagName(e,t){if(e==="!")return"!";if(e[0]!=="!")return t(`Not a valid tag: ${e}`),null;if(e[1]==="<"){let o=e.slice(2,-1);return o==="!"||o==="!!"?(t(`Verbatim tags aren't resolved, so ${e} is invalid.`),null):(e[e.length-1]!==">"&&t("Verbatim tags must end with a >"),o)}let[,n,i]=e.match(/^(.*!)([^!]*)$/s);i||t(`The ${e} tag has no suffix`);let r=this.tags[n];if(r)try{return r+decodeURIComponent(i)}catch(o){return t(String(o)),null}return n==="!"?e:(t(`Could not resolve tag: ${e}`),null)}tagString(e){for(let[t,n]of Object.entries(this.tags))if(e.startsWith(n))return t+pn(e.substring(n.length));return e[0]==="!"?e:`!<${e}>`}toString(e){let t=this.yaml.explicit?[`%YAML ${this.yaml.version||"1.2"}`]:[],n=Object.entries(this.tags),i;if(e&&n.length>0&&I(e.contents)){let r={};Q(e.contents,(o,a)=>{I(a)&&a.tag&&(r[a.tag]=!0)}),i=Object.keys(r)}else i=[];for(let[r,o]of n)r==="!!"&&o==="tag:yaml.org,2002:"||(!e||i.some(a=>a.startsWith(o)))&&t.push(`%TAG ${r} ${o}`);return t.join(`
 `)}};Z.defaultYaml={explicit:!1,version:"1.2"};Z.defaultTags={"!!":"tag:yaml.org,2002:"};function it(s){if(/[\x00-\x19\s,[\]{}]/.test(s)){let t=`Anchor must not contain whitespace or control characters: ${JSON.stringify(s)}`;throw new Error(t)}return!0}function qt(s){let e=new Set;return Q(s,{Value(t,n){n.anchor&&e.add(n.anchor)}}),e}function xt(s,e){for(let t=1;;++t){let n=`${s}${t}`;if(!e.has(n))return n}}function bs(s,e){let t=[],n=new Map,i=null;return{onAnchor:r=>{t.push(r),i??(i=qt(s));let o=xt(e,i);return i.add(o),o},setAnchors:()=>{for(let r of t){let o=n.get(r);if(typeof o=="object"&&o.anchor&&(E(o.node)||L(o.node)))o.node.anchor=o.anchor;else{let a=new Error("Failed to resolve repeated object (this should not happen)");throw a.source=r,a}}},sourceObjects:n}}function fe(s,e,t,n){if(n&&typeof n=="object")if(Array.isArray(n))for(let i=0,r=n.length;i<r;++i){let o=n[i],a=fe(s,n,String(i),o);a===void 0?delete n[i]:a!==o&&(n[i]=a)}else if(n instanceof Map)for(let i of Array.from(n.keys())){let r=n.get(i),o=fe(s,n,i,r);o===void 0?n.delete(i):o!==r&&n.set(i,o)}else if(n instanceof Set)for(let i of Array.from(n)){let r=fe(s,n,i,i);r===void 0?n.delete(i):r!==i&&(n.delete(i),n.add(r))}else for(let[i,r]of Object.entries(n)){let o=fe(s,n,i,r);o===void 0?delete n[i]:o!==r&&(n[i]=o)}return s.call(e,t,n)}function M(s,e,t){if(Array.isArray(s))return s.map((n,i)=>M(n,String(i),t));if(s&&typeof s.toJSON=="function"){if(!t||!nt(s))return s.toJSON(e,t);let n={aliasCount:0,count:1,res:void 0};t.anchors.set(s,n),t.onCreate=r=>{n.res=r,delete t.onCreate};let i=s.toJSON(e,t);return t.onCreate&&t.onCreate(i),i}return typeof s=="bigint"&&!t?.keep?Number(s):s}var ue=class{constructor(e){Object.defineProperty(this,K,{value:e})}clone(){let e=Object.create(Object.getPrototypeOf(this),Object.getOwnPropertyDescriptors(this));return this.range&&(e.range=this.range.slice()),e}toJS(e,{mapAsMap:t,maxAliasCount:n,onAnchor:i,reviver:r}={}){if(!R(e))throw new TypeError("A document argument is required");let o={anchors:new Map,doc:e,keep:!0,mapAsMap:t===!0,mapKeyWarned:!1,maxAliasCount:typeof n=="number"?n:100},a=M(this,"",o);if(typeof i=="function")for(let{count:l,res:c}of o.anchors.values())i(c,l);return typeof r=="function"?fe(r,{"":a},"",a):a}};var ee=class extends ue{constructor(e){super(tt),this.source=e,Object.defineProperty(this,"tag",{set(){throw new Error("Alias nodes cannot have tags")}})}resolve(e,t){let n;t?.aliasResolveCache?n=t.aliasResolveCache:(n=[],Q(e,{Node:(r,o)=>{(x(o)||nt(o))&&n.push(o)}}),t&&(t.aliasResolveCache=n));let i;for(let r of n){if(r===this)break;r.anchor===this.source&&(i=r)}return i}toJSON(e,t){if(!t)return{source:this.source};let{anchors:n,doc:i,maxAliasCount:r}=t,o=this.resolve(i,t);if(!o){let l=`Unresolved alias (the anchor must be set before the alias): ${this.source}`;throw new ReferenceError(l)}let a=n.get(o);if(a||(M(o,null,t),a=n.get(o)),a?.res===void 0){let l="This should not happen: Alias anchor was not resolved?";throw new ReferenceError(l)}if(r>=0&&(a.count+=1,a.aliasCount===0&&(a.aliasCount=rt(i,o,n)),a.count*a.aliasCount>r)){let l="Excessive alias count indicates a resource exhaustion attack";throw new ReferenceError(l)}return a.res}toString(e,t,n){let i=`*${this.source}`;if(e){if(it(this.source),e.options.verifyAliasOrder&&!e.anchors.has(this.source)){let r=`Unresolved alias (the anchor must be set before the alias): ${this.source}`;throw new Error(r)}if(e.implicitKey)return`${i} `}return i}};function rt(s,e,t){if(x(e)){let n=e.resolve(s),i=t&&n&&t.get(n);return i?i.count*i.aliasCount:0}else if(L(e)){let n=0;for(let i of e.items){let r=rt(s,i,t);r>n&&(n=r)}return n}else if(T(e)){let n=rt(s,e.key,t),i=rt(s,e.value,t);return Math.max(n,i)}return 1}var ot=s=>!s||typeof s!="function"&&typeof s!="object",y=class extends ue{constructor(e){super(q),this.value=e}toJSON(e,t){return t?.keep?this.value:M(this.value,e,t)}toString(){return String(this.value)}};y.BLOCK_FOLDED="BLOCK_FOLDED";y.BLOCK_LITERAL="BLOCK_LITERAL";y.PLAIN="PLAIN";y.QUOTE_DOUBLE="QUOTE_DOUBLE";y.QUOTE_SINGLE="QUOTE_SINGLE";var mn="tag:yaml.org,2002:";function dn(s,e,t){if(e){let n=t.filter(r=>r.tag===e),i=n.find(r=>!r.format)??n[0];if(!i)throw new Error(`Tag ${e} not found`);return i}return t.find(n=>n.identify?.(s)&&!n.format)}function oe(s,e,t){if(R(s)&&(s=s.contents),I(s))return s;if(T(s)){let f=t.schema[Y].createNode?.(t.schema,null,t);return f.items.push(s),f}(s instanceof String||s instanceof Number||s instanceof Boolean||typeof BigInt<"u"&&s instanceof BigInt)&&(s=s.valueOf());let{aliasDuplicateObjects:n,onAnchor:i,onTagObj:r,schema:o,sourceObjects:a}=t,l;if(n&&s&&typeof s=="object"){if(l=a.get(s),l)return l.anchor??(l.anchor=i(s)),new ee(l.anchor);l={anchor:null,node:null},a.set(s,l)}e?.startsWith("!!")&&(e=mn+e.slice(2));let c=dn(s,e,o.tags);if(!c){if(s&&typeof s.toJSON=="function"&&(s=s.toJSON()),!s||typeof s!="object"){let f=new y(s);return l&&(l.node=f),f}c=s instanceof Map?o[Y]:Symbol.iterator in Object(s)?o[re]:o[Y]}r&&(r(c),delete t.onTagObj);let p=c?.createNode?c.createNode(t.schema,s,t):typeof c?.nodeClass?.from=="function"?c.nodeClass.from(t.schema,s,t):new y(s);return e?p.tag=e:c.default||(p.tag=c.tag),l&&(l.node=p),p}function qe(s,e,t){let n=t;for(let i=e.length-1;i>=0;--i){let r=e[i];if(typeof r=="number"&&Number.isInteger(r)&&r>=0){let o=[];o[r]=n,n=o}else n=new Map([[r,n]])}return oe(n,void 0,{aliasDuplicateObjects:!1,keepUndefined:!1,onAnchor:()=>{throw new Error("This should not happen, please report a bug.")},schema:s,sourceObjects:new Map})}var Ae=s=>s==null||typeof s=="object"&&!!s[Symbol.iterator]().next().done,Oe=class extends ue{constructor(e,t){super(e),Object.defineProperty(this,"schema",{value:t,configurable:!0,enumerable:!1,writable:!0})}clone(e){let t=Object.create(Object.getPrototypeOf(this),Object.getOwnPropertyDescriptors(this));return e&&(t.schema=e),t.items=t.items.map(n=>I(n)||T(n)?n.clone(e):n),this.range&&(t.range=this.range.slice()),t}addIn(e,t){if(Ae(e))this.add(t);else{let[n,...i]=e,r=this.get(n,!0);if(L(r))r.addIn(i,t);else if(r===void 0&&this.schema)this.set(n,qe(this.schema,i,t));else throw new Error(`Expected YAML collection at ${n}. Remaining path: ${i}`)}}deleteIn(e){let[t,...n]=e;if(n.length===0)return this.delete(t);let i=this.get(t,!0);if(L(i))return i.deleteIn(n);throw new Error(`Expected YAML collection at ${t}. Remaining path: ${n}`)}getIn(e,t){let[n,...i]=e,r=this.get(n,!0);return i.length===0?!t&&E(r)?r.value:r:L(r)?r.getIn(i,t):void 0}hasAllNullValues(e){return this.items.every(t=>{if(!T(t))return!1;let n=t.value;return n==null||e&&E(n)&&n.value==null&&!n.commentBefore&&!n.comment&&!n.tag})}hasIn(e){let[t,...n]=e;if(n.length===0)return this.has(t);let i=this.get(t,!0);return L(i)?i.hasIn(n):!1}setIn(e,t){let[n,...i]=e;if(i.length===0)this.set(n,t);else{let r=this.get(n,!0);if(L(r))r.setIn(i,t);else if(r===void 0&&this.schema)this.set(n,qe(this.schema,i,t));else throw new Error(`Expected YAML collection at ${n}. Remaining path: ${i}`)}}};var ws=s=>s.replace(/^(?!$)(?: $)?/gm,"#");function J(s,e){return/^\n+$/.test(s)?s.substring(1):e?s.replace(/^(?! *$)/gm,e):s}var te=(s,e,t)=>s.endsWith(`

package/dist/public/spa.html

@@ -64,6 +64,9 @@
   </script>
   <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,300;0,9..40,400;0,9..40,500;0,9..40,600;0,9..40,700;0,9..40,800&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
   <link rel="stylesheet" href="/css/theme.css">
+  <!-- Canonical styles for the shared <Markdown> component — load before views so it styles
+       rendered markdown everywhere the component is used (no per-view re-definition). -->
+  <link rel="stylesheet" href="/css/components/markdown.css">
   <!-- View CSS preloaded so they are ready before any view renders (prevents FOUC) -->
   <!-- hrefs are stamped with ?v=BUILD_ID at serve time by portal.ts serveSpa() -->
   <link rel="stylesheet" href="/css/views/portal.css">
@@ -71,6 +74,7 @@
   <link rel="stylesheet" href="/css/views/portal-classic.css">
   <link rel="stylesheet" href="/css/views/portal-dev.css">
   <link rel="stylesheet" href="/css/views/profile.css">
+  <link rel="stylesheet" href="/css/views/notebook.css">
   <link rel="stylesheet" href="/css/views/offers.css">
   <link rel="stylesheet" href="/css/views/foundry.css">
   <link rel="stylesheet" href="/css/views/calibrator.css">
@@ -157,6 +161,7 @@
       "/js/services/foundry-probe-reconcile.js": "/js/services/foundry-probe-reconcile.js",
       "/js/services/knowledge.js": "/js/services/knowledge.js",
       "/js/services/memory.js": "/js/services/memory.js",
+      "/js/services/notebook.js": "/js/services/notebook.js",
       "/js/services/nodes.js": "/js/services/nodes.js",
       "/js/services/organisms.js": "/js/services/organisms.js",
       "/js/services/offers.js": "/js/services/offers.js",
@@ -167,6 +172,8 @@
       "/js/services/wallet.js": "/js/services/wallet.js",
       "/js/services/work.js": "/js/services/work.js",
       "/js/services/messages.js": "/js/services/messages.js",
+      "/js/services/presence.js": "/js/services/presence.js",
+      "/js/presence-store.js": "/js/presence-store.js",
       "/js/components/auth-image.js": "/js/components/auth-image.js",
       "/js/components/tag-cloud.js": "/js/components/tag-cloud.js",
       "/js/components/tag-editor.js": "/js/components/tag-editor.js",
@@ -184,6 +191,7 @@
       "/components/ToggleSwitch.js": "/components/ToggleSwitch.js",
       "/components/Card.js": "/components/Card.js",
       "/components/StatusDot.js": "/components/StatusDot.js",
+      "/components/PresenceDot.js": "/components/PresenceDot.js",
       "/components/TagList.js": "/components/TagList.js",
       "/components/Pagination.js": "/components/Pagination.js",
       "/components/KeyValueRow.js": "/components/KeyValueRow.js",
@@ -208,7 +216,23 @@
       "/js/services/agent-integration.js": "/js/services/agent-integration.js",
       "/js/services/admin-agent-integration.js": "/js/services/admin-agent-integration.js",
       "/js/services/schedules.js": "/js/services/schedules.js",
-      "/js/services/workflows.js": "/js/services/workflows.js"
+      "/js/services/workflows.js": "/js/services/workflows.js",
+      "/views/profile/shared.js": "/views/profile/shared.js",
+      "/views/profile/generator-settings.js": "/views/profile/generator-settings.js",
+      "/views/profile/organisms/helpers.js": "/views/profile/organisms/helpers.js",
+      "/views/profile/organisms/widgets.js": "/views/profile/organisms/widgets.js",
+      "/views/profile/organisms/panels.js": "/views/profile/organisms/panels.js",
+      "/views/profile/organisms/agents.js": "/views/profile/organisms/agents.js",
+      "/views/profile/organisms/members.js": "/views/profile/organisms/members.js",
+      "/views/profile/organisms/home.js": "/views/profile/organisms/home.js",
+      "/views/profile/organisms/workspace-list.js": "/views/profile/organisms/workspace-list.js",
+      "/views/profile/organisms/workspace.js": "/views/profile/organisms/workspace.js",
+      "/views/profile/organisms/activity-panel.js": "/views/profile/organisms/activity-panel.js",
+      "/views/profile/organisms/participants-panel.js": "/views/profile/organisms/participants-panel.js",
+      "/views/profile/organisms/workspace-comments.js": "/views/profile/organisms/workspace-comments.js",
+      "/views/profile/organisms/sources-panel.js": "/views/profile/organisms/sources-panel.js",
+      "/views/profile/organisms/schema-form.js": "/views/profile/organisms/schema-form.js",
+      "/views/profile/organisms/document.js": "/views/profile/organisms/document.js"
     }
   }
   </script>
@@ -223,6 +247,28 @@
   <!-- App root (Preact mounts here) -->
   <div id="app"></div>
 
+  <!-- SSO handoff: the desktop app already holds an authenticated owner JWT (from its inline
+       sign-in). It opens the portal with #handoff=<base64({owner,jwt})> so the browser is logged
+       in WITHOUT a second sign-in. Runs synchronously before the app reads the session. -->
+  <script>
+    (function () {
+      try {
+        var m = location.hash.match(/[#&]handoff=([^&]+)/);
+        if (!m) return;
+        var s = JSON.parse(atob(decodeURIComponent(m[1])));
+        if (s && s.jwt && s.owner) {
+          var node = '';
+          try { node = (JSON.parse(atob(s.jwt.split('.')[1].replace(/-/g, '+').replace(/_/g, '/'))) || {}).node || ''; } catch (e) {}
+          localStorage.setItem('aimeat_session', JSON.stringify({
+            owner: s.owner, jwt: s.jwt, ghii: node ? (s.owner + '@' + node) : null, gaii: null,
+          }));
+        }
+        // Strip the token from the URL so it is not bookmarked or left in history.
+        history.replaceState(null, '', location.pathname + location.search);
+      } catch (e) { /* ignore a malformed handoff */ }
+    })();
+  </script>
+
   <script type="module">
     import { h, render, Component } from 'preact';
     import { useState, useEffect, useCallback } from 'preact/hooks';
@@ -430,10 +476,24 @@
     }
 
     // ── Header Component ──
+    // Built-in public links. Operators can show/hide and reorder these via the admin
+    // Portal tab (persisted at /v1/site/header-nav). Auth/role-gated links (Apps, Profile,
+    // Admin) are NOT in this list — they stay forced by the session/role checks below.
+    const PUBLIC_NAV_LINKS = [
+      { id: 'try',        path: '/v1/portal',          key: 'nav.try' },
+      { id: 'howItWorks', path: '/v1/how-it-works',    key: 'nav.howItWorks', fallback: 'How it works' },
+      { id: 'business',   path: '/v1/business',        key: 'nav.business',   fallback: 'For your business' },
+      { id: 'devView',    path: '/v1/portal?view=dev', key: 'nav.devView',    matchActive: false },
+      { id: 'help',       path: '/v1/help',            key: 'nav.help' },
+    ];
+
     function Header({ navigate, locale }) {
       const [session, setSession] = useState(null);
       const [morsels, setMorsels] = useState(null);
       const [menuOpen, setMenuOpen] = useState(false);
+      // Header nav config: { order, hidden }. Defaults to all visible in declared order
+      // until the public /v1/site/header-nav fetch resolves (no flash of empty nav).
+      const [navConfig, setNavConfig] = useState({ order: PUBLIC_NAV_LINKS.map(l => l.id), hidden: [] });
 
       // Check auth state
       useEffect(() => {
@@ -451,6 +511,21 @@
         return () => window.removeEventListener('aimeat-auth-change', checkAuth);
       }, []);
 
+      // Load operator-configured header nav (public endpoint, no auth needed).
+      useEffect(() => {
+        let cancelled = false;
+        fetch('/v1/site/header-nav')
+          .then(r => r.json())
+          .then(d => {
+            if (cancelled || !d?.ok || !d.data) return;
+            const order = Array.isArray(d.data.order) ? d.data.order : PUBLIC_NAV_LINKS.map(l => l.id);
+            const hidden = Array.isArray(d.data.hidden) ? d.data.hidden : [];
+            setNavConfig({ order, hidden });
+          })
+          .catch(e => console.warn('Header nav fetch failed:', e.message));
+        return () => { cancelled = true; };
+      }, []);
+
       // Fetch morsels when session is available
       useEffect(() => {
         if (!session) { setMorsels(null); return; }
@@ -477,6 +552,13 @@
 
       const currentPath = location.pathname;
 
+      // Resolve the public links to render: config order, minus hidden, by declared id.
+      const linkById = Object.fromEntries(PUBLIC_NAV_LINKS.map(l => [l.id, l]));
+      const hiddenSet = new Set(navConfig.hidden);
+      const visibleLinks = navConfig.order
+        .map(id => linkById[id])
+        .filter(l => l && !hiddenSet.has(l.id));
+
       return html`
         <nav class="topnav">
           <div style="display:flex;align-items:center;gap:20px">
@@ -490,14 +572,14 @@
             <button class="topnav-burger" aria-label="Menu" aria-expanded=${menuOpen ? 'true' : 'false'}
               onClick=${() => setMenuOpen(o => !o)}>☰</button>
             <div class="topnav-menu ${menuOpen ? 'open' : ''}">
-              <!-- "Try it" leads to the landing's path cards + app gallery — an empty
-                   Welcome Board on /v1/classic was the weakest possible first experience.
+              <!-- Public links are operator-configurable (visibility + order) via the admin
+                   Portal tab. "Try it" leads to the landing's path cards + app gallery.
                    Classic stays reachable deeper (landing card B "Start building"). -->
-              <a href="/v1/portal" onClick=${(e) => { handleNav(e, '/v1/portal'); setMenuOpen(false); }} class="${currentPath === '/v1/portal' ? 'active' : ''}">${t('nav.try')}</a>
-              <a href="/v1/how-it-works" onClick=${(e) => { handleNav(e, '/v1/how-it-works'); setMenuOpen(false); }} class="${currentPath === '/v1/how-it-works' ? 'active' : ''}">${t('nav.howItWorks') || 'How it works'}</a>
-              <a href="/v1/business" onClick=${(e) => { handleNav(e, '/v1/business'); setMenuOpen(false); }} class="${currentPath === '/v1/business' ? 'active' : ''}">${t('nav.business') || 'For your business'}</a>
-              <a href="/v1/portal?view=dev" onClick=${(e) => { handleNav(e, '/v1/portal?view=dev'); setMenuOpen(false); }}>${t('nav.devView')}</a>
-              <a href="/v1/help" onClick=${(e) => { handleNav(e, '/v1/help'); setMenuOpen(false); }} class="${currentPath === '/v1/help' ? 'active' : ''}">${t('nav.help')}</a>
+              ${visibleLinks.map(link => html`
+                <a href="${link.path}" key=${link.id}
+                  onClick=${(e) => { handleNav(e, link.path); setMenuOpen(false); }}
+                  class="${link.matchActive !== false && currentPath === link.path ? 'active' : ''}">${t(link.key) || link.fallback || link.key}</a>
+              `)}
               ${session && html`
                 <a href="/app-catalog.html" target="_blank" onClick=${() => setMenuOpen(false)} class="${currentPath === '/app-catalog.html' ? 'active' : ''}">${t('nav.apps') || 'Apps'}</a>
                 <a href="/v1/profile" class="profile-link visible ${currentPath === '/v1/profile' ? 'active' : ''}" onClick=${(e) => { handleNav(e, '/v1/profile'); setMenuOpen(false); }}>

package/dist/public/types/aimeat-globals.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @file aimeat-globals.d.ts
+ * @description Ambient type declarations for the no-build frontend. Covers browser globals that
+ *   arrive via <script> tags or build-time injection (not ES-module imports), plus the
+ *   conventional fields the api.js fetch wrapper attaches to thrown Errors. This lets
+ *   `tsc --noEmit` (checkJs) type-check public/ without these surfacing as "cannot find name"
+ *   or "property does not exist" noise. It declares no runtime — types only.
+ * @usage  Picked up automatically by tsconfig.frontend.json via its d.ts include glob.
+ * @version-history
+ *   v1.0.0 — 2026-06-19 — Initial ambient declarations for frontend type-checking
+ */
+
+export {};
+
+declare global {
+  /** The window.AIMEAT SDK (auth, data, ai, …) — loaded by aimeat-auth.js before the SPA. */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const AIMEAT: any;
+  /** Chart.js — loaded via a <script> tag on admin pages. */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const Chart: any;
+  /** Build-time version string injected for cache-busting (see i18n.js). */
+  const __APP_VERSION__: string;
+
+  interface Window {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    AIMEAT: any;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    Chart: any;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    mermaid: any;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    toastui: any;
+    showToast?: (message: string, isError?: boolean) => void;
+    /** Preact bundle marker set by the vendored preact build. */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    __B?: any;
+  }
+
+  /**
+   * The api.js fetch wrapper attaches these fields to thrown Errors so callers can branch
+   * on the server error envelope (see public/js/api.js). Declared here so `err.code` /
+   * `err.status` / `err.response` type-check at every catch site.
+   */
+  interface Error {
+    code?: string;
+    status?: number;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    response?: any;
+    source?: string;
+  }
+}

package/dist/public/types/vendored-libs.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @file vendored-libs.d.ts
+ * @description Type stubs for the vendored, minified ESM libraries the frontend imports by bare
+ *   specifier (preact, preact/hooks, htm). The browser resolves these via the importmap to
+ *   public/lib/*.mjs at runtime; this stub exists only so `tsc --noEmit` (checkJs) resolves the
+ *   imports without trying to type-check minified third-party bundles. Exports are intentionally
+ *   loose (`any`) — htm template rendering is untyped regardless, so precise framework types add
+ *   little here. tsconfig.frontend.json maps the bare specifiers to this file via "paths".
+ * @version-history
+ *   v1.0.0 — 2026-06-19 — Initial stubs for preact / preact/hooks / htm
+ */
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+declare module 'preact' {
+  export const h: any;
+  export const Fragment: any;
+  export const render: any;
+  export const hydrate: any;
+  export const cloneElement: any;
+  export const createContext: any;
+  export const createRef: any;
+  export const isValidElement: any;
+  export const toChildArray: any;
+  export const options: any;
+  export class Component {
+    constructor(props?: any, context?: any);
+    setState(state?: any, callback?: () => void): void;
+    forceUpdate(callback?: () => void): void;
+    render(props?: any, state?: any, context?: any): any;
+    props: any;
+    state: any;
+    context: any;
+    base?: any;
+  }
+  const preact: any;
+  export default preact;
+}
+
+declare module 'preact/hooks' {
+  export const useState: any;
+  export const useEffect: any;
+  export const useLayoutEffect: any;
+  export const useRef: any;
+  export const useCallback: any;
+  export const useMemo: any;
+  export const useReducer: any;
+  export const useContext: any;
+  export const useErrorBoundary: any;
+  export const useId: any;
+}
+
+declare module 'htm' {
+  const htm: any;
+  export default htm;
+}

package/dist/public/views/_template.js

@@ -13,8 +13,10 @@
  *   6. Create public/css/views/myview.css for view-specific styles
  * ─────────────────────────────────────────────────────────────────────────────
  */
-import { html }                    from 'htm/preact';
+import { h }                       from 'preact';
+import htm                         from 'htm';
 import { useState, useEffect }     from 'preact/hooks';
+const html = htm.bind(h);
 import { t }                       from '/js/i18n.js';
 import { escHtml }                 from '/js/utils.js';
 import { apiGet, apiPost }         from '/js/api.js';

package/dist/public/views/admin/agent-integration-tab.js

@@ -70,7 +70,7 @@ export default function AgentIntegrationTab({ data, session }) {
 
   return html`
     <div>
-      ${renderPlatformRegistry(platforms, totalAgents, session, loadData)}
+      <${PlatformRegistry} platforms=${platforms} totalAgents=${totalAgents} session=${session} loadData=${loadData} />
       ${renderOnboardingOverview(onboarding, readiness, session, loadData)}
       ${renderSkillBundles(bundles, handleRegenerate, regenerating, session)}
       ${renderBundleTemplates()}
@@ -78,8 +78,9 @@ export default function AgentIntegrationTab({ data, session }) {
   `;
 }
 
-/* ── M8: Merged Platform column (name + ID as secondary text) ── */
-function renderPlatformRegistry(platforms, totalAgents, session, loadData) {
+/* ── M8: Merged Platform column (name + ID as secondary text) ──
+   A real component (not a render-helper) so its useState obeys the Rules of Hooks. */
+function PlatformRegistry({ platforms, totalAgents, session, loadData }) {
   const [showForm, setShowForm] = useState(false);
 
   return html`