@rubytech/create-realagent 1.0.853 → 1.0.854

package/payload/platform/plugins/admin/mcp/dist/index.js

@@ -9,6 +9,7 @@ import { execFileSync } from "node:child_process";
 import { appendFileSync, cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { writeKey, validateKey, hasKey, keyFilePath, deleteKey } from "../../../../lib/anthropic-key/dist/index.js";
 import { writeAdminEntry, removeAdminFromAccount } from "../../../../lib/admins-write/dist/index.js";
+import { isPersistentComponent } from "../../../../lib/persistent-components/dist/index.js";
 import { deviceUrlBlock } from "../../../../lib/device-url/dist/index.js";
 import { substituteBrandPlaceholders } from "../../../../lib/brand-templating/dist/index.js";
 import { resolveEntitlement } from "../../../../lib/entitlement/dist/index.js";
@@ -1631,12 +1632,50 @@ server.tool("plugin-read", "Read a plugin definition (PLUGIN.md) or one of its r
         };
     }
 });
+// Task 940 — `"rendered"` is a sentinel, not a persistence ack. The platform
+// UI's stream-parser intercepts this tool_use upstream of the SDK reply
+// (platform/ui/app/lib/claude-agent/stream-parser.ts:362) and emits a typed
+// `component` event that admin-agent.ts's persistMessage flushes to Neo4j as
+// a sibling :Component node.
+//
+// Task 942 — render-component is also the *server commitment surface* for
+// PERSISTENT_COMPONENTS (action-list, document-editor, rich-content-editor,
+// grid-editor). The actual file write + :KnowledgeDocument projection lives
+// in the admin server process (stream-parser path) because the SDK delivers
+// `tool_use.input` to the UI in the assistant message but the MCP handler's
+// return reaches only the agent — there is no path back to persistMessage
+// from here. This handler emits a one-line observability marker per
+// persistence-eligible call so operators can grep for the commitment, and
+// returns richer JSON so the doctrine grep
+// `render-component.*"rendered"` resolves to a persistence-aware handler
+// rather than a bare stub.
 server.tool("render-component", "Render a pre-built UI component inline in the conversation. " +
     "Call this instead of describing a UI — the component handles input collection. " +
     "Wait for the user's response before continuing.", {
     name: z.string().describe("Component name from the UI suite (e.g. single-select, confirm, info-card, form, progress)"),
     data: z.record(z.string(), z.unknown()),
-}, async () => ({ content: [{ type: "text", text: "rendered" }] }));
+}, async ({ name, data }) => {
+    if (isPersistentComponent(name)) {
+        // Persistence-eligible: log the commitment so the live + audit grep
+        // (`[render-component-persist]`) can correlate the MCP call against
+        // the downstream :KnowledgeDocument MERGE. Byte counts come from
+        // data.html (preferred) or data.content; both being absent is a
+        // legitimate render of an empty editor and the projection is skipped
+        // server-side.
+        const html = typeof data?.html === "string" ? data.html : "";
+        const content = typeof data?.content === "string" ? data.content : "";
+        const bytes = html.length > 0 ? html.length : content.length;
+        const mimeType = html.length > 0 ? "text/html" : (content.length > 0 ? "text/markdown" : "");
+        console.error(`[render-component-persist] componentName=${name} bytes=${bytes} mimeType=${mimeType || "none"}`);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({ rendered: true, name, persistent: true, bytes, mimeType }),
+                }],
+        };
+    }
+    return { content: [{ type: "text", text: "rendered" }] };
+});
 server.tool("session-reset", "Reset the current session. Compacts conversation history to memory, clears the visible conversation, " +
     "and starts a fresh session with a new greeting. Call when the user asks to start a new session, " +
     "clear the conversation, or start fresh.", {}, async () => ({ content: [{ type: "text", text: "reset" }] }));