@rubytech/create-realagent-code 0.1.29 → 0.1.31

package/payload/server/server.js

@@ -618,7 +618,7 @@ var serveStatic = (options = { root: "" }) => {
 
 // server/index.ts
 import { readFileSync as readFileSync19, existsSync as existsSync22, watchFile } from "fs";
-import { resolve as resolve23, join as join13, basename as basename5 } from "path";
+import { resolve as resolve23, join as join14, basename as basename5 } from "path";
 import { homedir as homedir5 } from "os";
 
 // app/lib/agent-slug-pattern.ts
@@ -8024,7 +8024,7 @@ app14.post("/:id/resume", async (c) => {
                 await storeComponentArtefact(accountId, c2.artefactAttachmentId, bytesPick.mimeType, bytesPick.content, filename);
                 clearHealPending(accountId, c2.artefactAttachmentId);
                 streamLogPath.write(
-                  `[${(/* @__PURE__ */ new Date()).toISOString()}] [render-component-persist] heal componentName=${c2.name} attachmentId=${c2.artefactAttachmentId.slice(0, 8)} mimeType=${bytesPick.mimeType} bytes=${bytesPick.content.length} outcome=ok
+                  `[${(/* @__PURE__ */ new Date()).toISOString()}] [component-persist] heal componentName=${c2.name} attachmentId=${c2.artefactAttachmentId.slice(0, 8)} mimeType=${bytesPick.mimeType} bytes=${bytesPick.content.length} outcome=ok
 `
                 );
                 return {
@@ -8037,7 +8037,7 @@ app14.post("/:id/resume", async (c) => {
                 clearHealPending(accountId, c2.artefactAttachmentId);
                 const reason2 = writeErr instanceof Error ? writeErr.message : String(writeErr);
                 streamLogPath.write(
-                  `[${(/* @__PURE__ */ new Date()).toISOString()}] [render-component-persist] heal componentName=${c2.name} attachmentId=${c2.artefactAttachmentId.slice(0, 8)} outcome=disk-fail reason=${JSON.stringify(reason2.slice(0, 200))}
+                  `[${(/* @__PURE__ */ new Date()).toISOString()}] [component-persist] heal componentName=${c2.name} attachmentId=${c2.artefactAttachmentId.slice(0, 8)} outcome=disk-fail reason=${JSON.stringify(reason2.slice(0, 200))}
 `
                 );
                 return base;
@@ -8217,19 +8217,72 @@ async function buildOnboardingPromptBlock(accountId) {
   return { step };
 }
 
-// server/routes/admin/claude-sessions.ts
+// server/lib/onboarding-advance.ts
+import { execFile as execFile2 } from "child_process";
+import { join as join11, resolve as resolvePath2 } from "path";
 var TAG19 = "[claude-session-manager:wrapper]";
+function onboardingAdvanceScriptPath() {
+  const platformRoot = process.env.MAXY_PLATFORM_ROOT ?? resolvePath2(process.cwd(), "..");
+  return join11(platformRoot, "services", "claude-session-manager", "scripts", "onboarding-advance.sh");
+}
+function runOnboardingAdvance(accountId, currentStep) {
+  const scriptPath = onboardingAdvanceScriptPath();
+  const stepArg = currentStep === null ? "null" : String(currentStep);
+  return new Promise((resolve24) => {
+    execFile2(
+      scriptPath,
+      [accountId, stepArg],
+      { maxBuffer: 64 * 1024, timeout: 5e3 },
+      (err, stdout, stderr) => {
+        if (err) {
+          console.error(`${TAG19} [onboarding-state] route-advance script-failed step=${stepArg} sender=${accountId}: ${err.message}`);
+          resolve24(null);
+          return;
+        }
+        if (stderr && stderr.trim()) {
+          process.stderr.write(stderr.endsWith("\n") ? stderr : `${stderr}
+`);
+        }
+        resolve24(stdout);
+      }
+    );
+  });
+}
+
+// server/routes/admin/claude-sessions.ts
+var TAG20 = "[claude-session-manager:wrapper]";
 function managerBase2() {
   const port2 = Number(process.env.CLAUDE_SESSION_MANAGER_PORT ?? "19400");
   return `http://127.0.0.1:${port2}`;
 }
+async function resolveConversationIdForBanner(cacheKey, accountId, userId) {
+  const bound = getConversationIdForSession(cacheKey);
+  if (bound) return bound;
+  const ensured = await ensureConversation(
+    accountId,
+    "admin",
+    cacheKey,
+    void 0,
+    void 0,
+    userId
+  ).catch((err) => {
+    console.error(`${TAG20} ensureConversation failed: ${err instanceof Error ? err.message : String(err)}`);
+    return null;
+  });
+  if (ensured?.conversationId) {
+    setConversationIdForSession(cacheKey, ensured.conversationId);
+    return ensured.conversationId;
+  }
+  return null;
+}
 var app15 = new Hono();
 app15.use("*", requireAdminSession);
 app15.post("/", async (c) => {
   const cacheKey = c.get("cacheKey") ?? "";
   const senderId = getAccountIdForSession(cacheKey) ?? "";
+  const userId = getUserIdForSession(cacheKey);
   if (!senderId) {
-    console.error(`${TAG19} reject reason=no-account-id`);
+    console.error(`${TAG20} reject reason=no-account-id`);
     return c.json({ error: "admin-account-not-resolved" }, 500);
   }
   let body = {};
@@ -8239,37 +8292,59 @@ app15.post("/", async (c) => {
   }
   const channel = typeof body.channel === "string" ? body.channel : "browser";
   const initialMessage = typeof body.initialMessage === "string" && body.initialMessage.trim() ? body.initialMessage : null;
+  const onboardingAdvance = body.onboardingAdvance === true;
   const permissionMode = typeof body.permissionMode === "string" ? body.permissionMode : void 0;
   let onboarding;
+  let resolvedStep = 9;
   try {
     const outcome = await buildOnboardingPromptBlock(senderId);
     onboarding = { step: outcome.step };
+    resolvedStep = outcome.step;
   } catch (err) {
-    console.error(`${TAG19} onboarding-resolve failed: ${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} onboarding-resolve failed: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  let scriptOutput = null;
+  if (onboardingAdvance && resolvedStep !== 9 && onboarding) {
+    scriptOutput = await runOnboardingAdvance(senderId, resolvedStep);
+    if (scriptOutput && scriptOutput.trim()) {
+      onboarding = { step: resolvedStep, resumePrompt: scriptOutput };
+    }
   }
   const upstream = await fetch(`${managerBase2()}/spawn`, {
     method: "POST",
     headers: { "content-type": "application/json" },
     body: JSON.stringify({ senderId, role: "admin", channel, accountId: senderId, onboarding, permissionMode })
   }).catch((err) => {
-    console.error(`${TAG19} fetch-failed op=spawn message=${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} fetch-failed op=spawn message=${err instanceof Error ? err.message : String(err)}`);
     return null;
   });
   if (!upstream) return c.json({ error: "manager-unreachable" }, 503);
   let spawnedSessionId = null;
-  if (upstream.ok && initialMessage) {
+  if (upstream.ok) {
     const buffered = await upstream.clone().json().catch(() => null);
     if (buffered && typeof buffered.sessionId === "string" && buffered.sessionId) {
       spawnedSessionId = buffered.sessionId;
     }
   }
-  if (initialMessage && spawnedSessionId) {
+  if (onboardingAdvance && spawnedSessionId && scriptOutput && scriptOutput.trim()) {
+    const conversationId = await resolveConversationIdForBanner(cacheKey, senderId, userId);
+    if (conversationId) {
+      try {
+        await persistMessage(conversationId, "assistant", scriptOutput.trimEnd(), senderId);
+      } catch (err) {
+        console.error(`${TAG20} persist initial assistant message failed: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    } else {
+      console.error(`${TAG20} banner-flow no conversationId resolved \u2014 script output not persisted, only system prompt carries it`);
+    }
+  }
+  if (!onboardingAdvance && initialMessage && spawnedSessionId) {
     fetch(`${managerBase2()}/${encodeURIComponent(spawnedSessionId)}/input`, {
       method: "POST",
       headers: { "content-type": "application/json" },
       body: JSON.stringify({ text: initialMessage })
     }).catch((err) => {
-      console.error(`${TAG19} fetch-failed op=initial-input message=${err instanceof Error ? err.message : String(err)}`);
+      console.error(`${TAG20} fetch-failed op=initial-input message=${err instanceof Error ? err.message : String(err)}`);
     });
   }
   return new Response(upstream.body, { status: upstream.status, headers: upstream.headers });
@@ -8281,7 +8356,7 @@ app15.get("/", async (c) => {
   const upstream = await fetch(
     `${managerBase2()}/list?senderId=${encodeURIComponent(senderId)}`
   ).catch((err) => {
-    console.error(`${TAG19} fetch-failed op=list message=${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} fetch-failed op=list message=${err instanceof Error ? err.message : String(err)}`);
     return null;
   });
   if (!upstream) return c.json({ error: "manager-unreachable" }, 503);
@@ -8311,7 +8386,7 @@ app15.post("/resume", async (c) => {
       claudeSessionId: body.claudeSessionId
     })
   }).catch((err) => {
-    console.error(`${TAG19} fetch-failed op=resume message=${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} fetch-failed op=resume message=${err instanceof Error ? err.message : String(err)}`);
     return null;
   });
   if (!upstream) return c.json({ error: "manager-unreachable" }, 503);
@@ -8324,7 +8399,7 @@ app15.delete("/:sessionId", async (c) => {
     `${managerBase2()}/${encodeURIComponent(sessionId)}${purge}`,
     { method: "DELETE" }
   ).catch((err) => {
-    console.error(`${TAG19} fetch-failed op=delete message=${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} fetch-failed op=delete message=${err instanceof Error ? err.message : String(err)}`);
     return null;
   });
   if (!upstream) return c.json({ error: "manager-unreachable" }, 503);
@@ -8341,7 +8416,7 @@ app15.post("/:sessionId/archive", async (c) => {
       body
     }
   ).catch((err) => {
-    console.error(`${TAG19} fetch-failed op=archive message=${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} fetch-failed op=archive message=${err instanceof Error ? err.message : String(err)}`);
     return null;
   });
   if (!upstream) return c.json({ error: "manager-unreachable" }, 503);
@@ -8352,7 +8427,7 @@ app15.get("/:sessionId/meta", async (c) => {
   const upstream = await fetch(
     `${managerBase2()}/${encodeURIComponent(sessionId)}/meta`
   ).catch((err) => {
-    console.error(`${TAG19} fetch-failed op=meta message=${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} fetch-failed op=meta message=${err instanceof Error ? err.message : String(err)}`);
     return null;
   });
   if (!upstream) return c.json({ error: "manager-unreachable" }, 503);
@@ -8369,7 +8444,7 @@ app15.patch("/:sessionId", async (c) => {
       body
     }
   ).catch((err) => {
-    console.error(`${TAG19} fetch-failed op=patch message=${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} fetch-failed op=patch message=${err instanceof Error ? err.message : String(err)}`);
     return null;
   });
   if (!upstream) return c.json({ error: "manager-unreachable" }, 503);
@@ -8386,7 +8461,7 @@ app15.post("/:sessionId/input", async (c) => {
       body: rawBody
     }
   ).catch((err) => {
-    console.error(`${TAG19} fetch-failed op=input message=${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} fetch-failed op=input message=${err instanceof Error ? err.message : String(err)}`);
     return null;
   });
   if (!upstream) return c.json({ error: "manager-unreachable" }, 503);
@@ -8398,7 +8473,7 @@ app15.get("/:sessionId/log", async (c) => {
   const upstream = await fetch(
     `${managerBase2()}/${encodeURIComponent(sessionId)}/log${follow}`
   ).catch((err) => {
-    console.error(`${TAG19} fetch-failed op=log message=${err instanceof Error ? err.message : String(err)}`);
+    console.error(`${TAG20} fetch-failed op=log message=${err instanceof Error ? err.message : String(err)}`);
     return null;
   });
   if (!upstream) return c.json({ error: "manager-unreachable" }, 503);
@@ -8514,13 +8589,13 @@ async function cdpNavigateNewTab(url, opts = {}) {
 // server/routes/admin/device-browser.ts
 var app18 = new Hono();
 app18.post("/navigate", async (c) => {
-  const TAG21 = "[device-url:click]";
+  const TAG22 = "[device-url:click]";
   let body;
   try {
     body = await c.req.json();
   } catch (err) {
     const detail = err instanceof Error ? err.message : String(err);
-    console.error(`${TAG21} reject reason=body-not-json detail=${detail} browser=fallback navigateResult=error`);
+    console.error(`${TAG22} reject reason=body-not-json detail=${detail} browser=fallback navigateResult=error`);
     return c.json(
       { ok: false, navigateResult: "error", browser: "fallback", detail: "Request body was not valid JSON" },
       400
@@ -8530,7 +8605,7 @@ app18.post("/navigate", async (c) => {
   const intent = typeof body.intent === "string" ? body.intent : "";
   const hostname2 = typeof body.hostname === "string" ? body.hostname : "";
   if (!url) {
-    console.error(`${TAG21} reject reason=missing-url intent=${JSON.stringify(intent)} browser=fallback navigateResult=error`);
+    console.error(`${TAG22} reject reason=missing-url intent=${JSON.stringify(intent)} browser=fallback navigateResult=error`);
     return c.json(
       { ok: false, navigateResult: "error", browser: "fallback", detail: "url field is required" },
       400
@@ -8540,7 +8615,7 @@ app18.post("/navigate", async (c) => {
   try {
     parsed = new URL(url);
   } catch {
-    console.error(`${TAG21} reject reason=url-malformed intent=${JSON.stringify(intent)} url=${url} browser=fallback navigateResult=error`);
+    console.error(`${TAG22} reject reason=url-malformed intent=${JSON.stringify(intent)} url=${url} browser=fallback navigateResult=error`);
     return c.json(
       { ok: false, navigateResult: "error", browser: "fallback", detail: "url is not a valid URL" },
       400
@@ -8548,7 +8623,7 @@ app18.post("/navigate", async (c) => {
   }
   if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
     console.error(
-      `${TAG21} reject reason=scheme-not-allowed scheme=${parsed.protocol} intent=${JSON.stringify(intent)} browser=fallback navigateResult=error`
+      `${TAG22} reject reason=scheme-not-allowed scheme=${parsed.protocol} intent=${JSON.stringify(intent)} browser=fallback navigateResult=error`
     );
     return c.json(
       {
@@ -8564,7 +8639,7 @@ app18.post("/navigate", async (c) => {
   const cdpOk = await ensureCdp(transport);
   if (!cdpOk) {
     console.error(
-      `${TAG21} intent=${JSON.stringify(intent)} browser=fallback navigateResult=cdp-unreachable hostname=${JSON.stringify(hostname2)}`
+      `${TAG22} intent=${JSON.stringify(intent)} browser=fallback navigateResult=cdp-unreachable hostname=${JSON.stringify(hostname2)}`
     );
     return c.json(
       {
@@ -8580,7 +8655,7 @@ app18.post("/navigate", async (c) => {
   const browser = outcome.result === "ok" ? "vnc" : "fallback";
   const detailStr = outcome.detail ? ` detail=${JSON.stringify(outcome.detail.length > 230 ? outcome.detail.slice(0, 227) + "..." : outcome.detail)}` : "";
   console.error(
-    `${TAG21} intent=${JSON.stringify(intent)} browser=${browser} navigateResult=${outcome.result} hostname=${JSON.stringify(hostname2)} targetId=${outcome.targetId ?? "none"}${detailStr}`
+    `${TAG22} intent=${JSON.stringify(intent)} browser=${browser} navigateResult=${outcome.result} hostname=${JSON.stringify(hostname2)} targetId=${outcome.targetId ?? "none"}${detailStr}`
   );
   if (outcome.result !== "ok") {
     return c.json(
@@ -8611,18 +8686,18 @@ var ALLOWED_EVENTS2 = /* @__PURE__ */ new Set([
 ]);
 var app19 = new Hono();
 app19.post("/", async (c) => {
-  const TAG21 = "[admin:events]";
+  const TAG22 = "[admin:events]";
   let body;
   try {
     body = await c.req.json();
   } catch (err) {
     const detail = err instanceof Error ? err.message : String(err);
-    console.error(`${TAG21} reject reason=body-not-json detail=${detail}`);
+    console.error(`${TAG22} reject reason=body-not-json detail=${detail}`);
     return c.json({ ok: false, detail: "Request body was not valid JSON" }, 400);
   }
   const event = typeof body.event === "string" ? body.event : "";
   if (!ALLOWED_EVENTS2.has(event)) {
-    console.error(`${TAG21} reject reason=event-not-allowed event=${JSON.stringify(event)}`);
+    console.error(`${TAG22} reject reason=event-not-allowed event=${JSON.stringify(event)}`);
     return c.json({ ok: false, detail: `Event "${event}" is not allowed` }, 400);
   }
   const rawFields = body.fields && typeof body.fields === "object" ? body.fields : {};
@@ -9514,7 +9589,7 @@ var cloudflare_default = app20;
 import { createReadStream as createReadStream3 } from "fs";
 import { readdir as readdir2, readFile as readFile4, stat as stat4, mkdir as mkdir3, writeFile as writeFile4, unlink as unlink2 } from "fs/promises";
 import { realpathSync as realpathSync4 } from "fs";
-import { basename as basename4, dirname as dirname6, join as join11, resolve as resolve16, sep as sep3 } from "path";
+import { basename as basename4, dirname as dirname6, join as join12, resolve as resolve16, sep as sep3 } from "path";
 import { Readable as Readable2 } from "stream";
 
 // app/lib/data-path.ts
@@ -9872,7 +9947,7 @@ async function cascadeDeleteDocument(params) {
 var UUID_RE4 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 async function readMeta(absDir, baseName) {
   try {
-    const raw = await readFile4(join11(absDir, `${baseName}.meta.json`), "utf8");
+    const raw = await readFile4(join12(absDir, `${baseName}.meta.json`), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed?.filename === "string") {
       return { filename: parsed.filename, mimeType: typeof parsed.mimeType === "string" ? parsed.mimeType : void 0 };
@@ -9910,7 +9985,7 @@ async function readAccountNames() {
 }
 async function enrich(absolute, entry, accountNames) {
   if (entry.kind === "directory" && UUID_RE4.test(entry.name)) {
-    const meta = await readMeta(join11(absolute, entry.name), entry.name);
+    const meta = await readMeta(join12(absolute, entry.name), entry.name);
     if (meta?.filename) {
       entry.displayName = meta.filename;
       entry.mimeType = meta.mimeType;
@@ -9969,7 +10044,7 @@ app21.get("/", requireAdminSession, async (c) => {
         continue;
       }
       try {
-        const entryPath = join11(absolute, name);
+        const entryPath = join12(absolute, name);
         const s = await stat4(entryPath);
         entries.push({
           name,
@@ -10142,7 +10217,7 @@ app21.delete("/", requireAdminSession, async (c) => {
     }
     const dot = base.lastIndexOf(".");
     const stem = dot === -1 ? base : base.slice(0, dot);
-    const sidecarPath = UUID_RE4.test(stem) && base !== `${stem}.meta.json` ? join11(dirname6(absolute), `${stem}.meta.json`) : null;
+    const sidecarPath = UUID_RE4.test(stem) && base !== `${stem}.meta.json` ? join12(dirname6(absolute), `${stem}.meta.json`) : null;
     await unlink2(absolute);
     if (sidecarPath) {
       try {
@@ -12193,10 +12268,10 @@ var sidebar_artefact_content_default = app31;
 
 // server/routes/admin/health.ts
 import { existsSync as existsSync19, readFileSync as readFileSync16 } from "fs";
-import { resolve as resolve20, join as join12 } from "path";
+import { resolve as resolve20, join as join13 } from "path";
 var PLATFORM_ROOT7 = process.env.MAXY_PLATFORM_ROOT ?? resolve20(process.cwd(), "..");
 var brandHostname = "maxy";
-var brandJsonPath = join12(PLATFORM_ROOT7, "config", "brand.json");
+var brandJsonPath = join13(PLATFORM_ROOT7, "config", "brand.json");
 if (existsSync19(brandJsonPath)) {
   try {
     const brand = JSON.parse(readFileSync16(brandJsonPath, "utf-8"));
@@ -12511,7 +12586,7 @@ function startGraphHealthTimer() {
 }
 
 // app/lib/whatsapp/inbound/claude-bridge.ts
-var TAG20 = "[whatsapp-adaptor]";
+var TAG21 = "[whatsapp-adaptor]";
 function whatsappTurnTimeoutMs() {
   return Number(process.env.WHATSAPP_PTY_TURN_TIMEOUT_MS ?? String(5 * 6e4));
 }
@@ -12532,7 +12607,7 @@ async function dispatchToClaude(input) {
     await input.reply(result.turnText);
   } catch (err) {
     const m = err instanceof Error ? err.message : String(err);
-    console.error(`${TAG20} reject reason=reply-failed senderId=${input.senderId} message=${m}`);
+    console.error(`${TAG21} reject reason=reply-failed senderId=${input.senderId} message=${m}`);
   }
 }
 function startReaper2() {
@@ -12780,7 +12855,7 @@ function clientFrom(c) {
   );
 }
 var PLATFORM_ROOT8 = process.env.MAXY_PLATFORM_ROOT || "";
-var BRAND_JSON_PATH = PLATFORM_ROOT8 ? join13(PLATFORM_ROOT8, "config", "brand.json") : "";
+var BRAND_JSON_PATH = PLATFORM_ROOT8 ? join14(PLATFORM_ROOT8, "config", "brand.json") : "";
 var BRAND = { productName: "Maxy", hostname: "maxy", configDir: ".maxy", domain: "getmaxy.com" };
 if (BRAND_JSON_PATH && !existsSync22(BRAND_JSON_PATH)) {
   console.error(`[brand] WARNING: brand.json not found at ${BRAND_JSON_PATH} \u2014 using Maxy defaults`);
@@ -12806,7 +12881,7 @@ var brandLoginOpts = {
   bodyFont: BRAND.defaultFonts?.body,
   logoContainsName: !!BRAND.logoContainsName
 };
-var ALIAS_DOMAINS_PATH2 = join13(homedir5(), BRAND.configDir, "alias-domains.json");
+var ALIAS_DOMAINS_PATH2 = join14(homedir5(), BRAND.configDir, "alias-domains.json");
 function loadAliasDomains() {
   try {
     if (!existsSync22(ALIAS_DOMAINS_PATH2)) return null;
@@ -13252,7 +13327,7 @@ var brandScript = `<script>window.__BRAND__=${JSON.stringify({
 function readInstalledVersion() {
   try {
     if (!PLATFORM_ROOT8) return "unknown";
-    const versionFile = join13(PLATFORM_ROOT8, "config", `.${BRAND.hostname}-version`);
+    const versionFile = join14(PLATFORM_ROOT8, "config", `.${BRAND.hostname}-version`);
     if (!existsSync22(versionFile)) return "unknown";
     const content = readFileSync19(versionFile, "utf-8").trim();
     return content || "unknown";
@@ -13311,14 +13386,14 @@ ${clientErrorReporterScript}
 }
 var brandedHtmlCache = /* @__PURE__ */ new Map();
 function loadBrandingCache(agentSlug) {
-  const configDir2 = join13(homedir5(), BRAND.configDir);
+  const configDir2 = join14(homedir5(), BRAND.configDir);
   try {
-    const accountJsonPath = join13(configDir2, "account.json");
+    const accountJsonPath = join14(configDir2, "account.json");
     if (!existsSync22(accountJsonPath)) return null;
     const account = JSON.parse(readFileSync19(accountJsonPath, "utf-8"));
     const accountId = account.accountId;
     if (!accountId) return null;
-    const cachePath = join13(configDir2, "branding-cache", accountId, `${agentSlug}.json`);
+    const cachePath = join14(configDir2, "branding-cache", accountId, `${agentSlug}.json`);
     if (!existsSync22(cachePath)) return null;
     return JSON.parse(readFileSync19(cachePath, "utf-8"));
   } catch {
@@ -13327,8 +13402,8 @@ function loadBrandingCache(agentSlug) {
 }
 function resolveDefaultSlug() {
   try {
-    const configDir2 = join13(homedir5(), BRAND.configDir);
-    const accountJsonPath = join13(configDir2, "account.json");
+    const configDir2 = join14(homedir5(), BRAND.configDir);
+    const accountJsonPath = join14(configDir2, "account.json");
     if (!existsSync22(accountJsonPath)) return null;
     const account = JSON.parse(readFileSync19(accountJsonPath, "utf-8"));
     return account.defaultAgent || null;
@@ -13650,7 +13725,7 @@ if (bootAccountConfig?.whatsapp) {
 }
 init({
   configDir: configDirForWhatsApp,
-  platformRoot: resolve23(process.env.MAXY_PLATFORM_ROOT ?? join13(__dirname, "..")),
+  platformRoot: resolve23(process.env.MAXY_PLATFORM_ROOT ?? join14(__dirname, "..")),
   accountConfig: bootAccountConfig,
   onMessage: async (msg) => {
     if (process.env.WHATSAPP_PTY_BRIDGE_ENABLED === "true" && msg.text && !msg.isOwnerMirror) {

package/payload/platform/plugins/admin/references/contextual-ui.md

@@ -1,107 +0,0 @@
-# Contextual UI Toolkit
-
-A suite of UI primitives rendered inline in the conversation via `render-component`. Use these when structured interaction improves clarity, reduces ambiguity, or prevents errors — not for every exchange.
-
-## Component Catalogue
-
-| Name | Purpose | Data key fields |
-|------|---------|-----------------|
-| `single-select` | Choose one option from a list | `options[].{value, label, description?}`, `submitMessage?` |
-| `multi-select` | Choose multiple options with checkboxes | `options[].{value, label, description?, badge?, defaultSelected?}`, `submitMessage?`, `skipLabel?` |
-| `confirm` | Approve or reject a consequential action | `title`, `description?`, `items?[].{label, value}`, `confirmMessage?`, `rejectMessage?` |
-| `info-card` | Display structured entity data (read-only) | `title`, `subtitle?`, `fields[].{label, value, type?}`, `actions?[].{label, message, variant}` |
-| `action-list` | List of items with per-item actions | `items[].{id, label, description?, status?, actions[]}`, `doneMessage?` |
-| `form` | Collect 2+ pieces of structured input | `fields[].{name, label, type, description?, placeholder?, required?, options?[].{value, label, description?}}`, `submitMessage?` |
-| `progress` | Multi-step progress tracker (read-only) | `steps[].{label, status, description?}`, `completedMessage?` |
-| `browser-viewer` | VNC iframe for browser automation | `title` |
-| `document-editor` | Inline markdown editor — prose content | `title`, `content` (markdown), `filePath?`, `readOnly?` |
-| `rich-content-editor` | Rich HTML editor — visual/branded content with images | `title`, `content` (HTML fragment), `filePath?`, `readOnly?`, `brandName?`, `brandLogo?` |
-| `grid-editor` | Spreadsheet grid — tabular data editing | `title`, `columns[]`, `rows[][]`, `filePath?`, `brandName?`, `brandLogo?` |
-
-Editors that accept `filePath` display an **Approve** button in the header bar. Omitting `filePath` renders the editor without an approval action — the user can view and edit but cannot submit content for writing. Always include `filePath` when the content requires user approval before being saved to disk.
-
-## Editor Selection
-
-Three editor modes serve different content types. Choose based on what the user is working with:
-
-| Content type | Editor | Examples |
-|---|---|---|
-| Prose — headings, paragraphs, lists | `document-editor` | Knowledge base articles, FAQs, procedures, meeting notes, SOUL files |
-| Visual/branded — HTML with images and layout | `rich-content-editor` | Product cards, blog posts, invoices with logos, marketing materials |
-| Tabular — columns and rows of values | `grid-editor` | Price lists, contact details, inventory, service catalogues |
-
-**Decision rule:** If the content has images or needs branded visual layout → `rich-content-editor`. If the content is a table of values → `grid-editor`. Everything else → `document-editor`.
-
-All three editors support PDF export. Include `brandName` and `brandLogo` (from the business profile in the graph) when the output may be exported as a branded PDF.
-
-## When to Use UI vs. Text
-
-**Use a component when:**
-- The user is choosing from 2+ discrete options → `single-select` or `multi-select`
-- You need approval before a consequential or irreversible action → `confirm`
-- You're presenting a structured entity (contact, task, invoice, status) → `info-card`
-- A list has distinct per-item actions → `action-list`
-- You need 2+ pieces of information at once → `form`
-- A multi-step process benefits from visible progress → `progress`
-
-**Use an editor when:**
-- The user asks to see, review, or edit a document → `document-editor`
-- The user needs visual/branded content (product card, invoice, brochure) → `rich-content-editor`
-- The user asks about tabular data (prices, contacts, inventory) → `grid-editor`
-- "Show me the FAQ" → `document-editor` with the FAQ content
-- "Create a product card for the new range" → `rich-content-editor` with generated HTML
-- "Show me the price list" → `grid-editor` with columns and rows
-
-**Use plain text when:**
-- Simple yes/no — ask in text
-- Open-ended input — ask in text
-- Informational response with no structure — just respond
-- Single piece of information needed — ask in text
-- The interaction is fast and unambiguous without UI
-
-Components add value when they reduce ambiguity, prevent errors, or present structure that text cannot. Not every interaction needs a widget.
-
-## How to Use
-
-Call `render-component` with `name` (component name) and `data` (structured object matching the component's schema). Then wait for the user's response before continuing — the response arrives as a regular message.
-
-### Form field types
-
-The `form` component supports these field types:
-
-| Type | Renders as | Value type | Notes |
-|------|-----------|------------|-------|
-| `text` | Text input | string | Default for short text |
-| `textarea` | Multi-line text | string | For longer input |
-| `select` | Dropdown | string | Requires `options[]` with `{value, label, description?}` — descriptions are appended to the option label |
-| `checkbox` | Toggle checkbox | boolean | Uses the shared Checkbox component. Label appears inline next to the checkbox, not above it |
-| `number` | Number input | string | |
-| `date` | Date input | string | |
-
-All field types accept optional `description` (help text below the label) and `defaultValue` (pre-populated value — used if the user doesn't interact with the field) properties.
-
-For `checkbox` fields, the submitted JSON value is `true` or `false` (boolean), not a string. For all other types, the value is a string.
-
-### Submit message templates
-
-Most components accept a `submitMessage` field that controls the format of the message sent back:
-- `single-select`: `"Selected: {{value}}"` — `{{value}}` and `{{label}}` are replaced
-- `multi-select`: `"Selected: {{values}}"` — `{{values}}` is comma-separated selected values
-- `form`: `"Form submitted: {{json}}"` — `{{json}}` is a JSON string of `{name: value}` pairs. Per-field placeholders `{{fieldName}}` are also supported (e.g. `"model={{model}}, live={{liveMemory}}"`). `{{values}}` is an alias for `{{json}}`
-- `confirm`: `confirmMessage` / `rejectMessage` — literal strings
-- `action-list`: each item action has its own `message` field
-- `info-card`: each action has its own `message` field
-
-When no template is provided, sensible defaults are used.
-
-### Backwards-compatible aliases
-
-These legacy names still work: `output-style` → `single-select`, `thinking-view` → `single-select`, `plugin-selector` → `multi-select`.
-
-## Anti-patterns
-
-- Rendering a `single-select` for a yes/no question — just ask in text
-- Rendering a `form` for a single field — just ask in text
-- Chaining multiple components in one response — render one, wait for the response, then decide if another is needed
-- Using `info-card` for data the user already knows — only show structured display when it adds value
-- Rendering `progress` once and never updating it — progress is for multi-step processes where you re-render with updated step statuses