@rubytech/create-realagent 1.0.842 → 1.0.843

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-realagent",
-  "version": "1.0.842",
+  "version": "1.0.843",
   "description": "Install Real Agent — Built for agents. By agents.",
   "bin": {
     "create-realagent": "./dist/index.js"

package/payload/platform/plugins/admin/PLUGIN.md

@@ -1,6 +1,6 @@
 ---
 name: admin
-description: "Platform administration plugin. Provides system-status, brand-settings, account-manage, account-update, admin-add, admin-remove, admin-list, admin-update-pin, agent-list, agent-config-read, logs-read, plugin-read, render-component, session-reset, session-resume, file-attach, wifi, adherence-read (attention-weighted adherence ledger), and action-approval tools (action-pending, action-approve, action-reject, action-edit) for managing the Maxy platform."
+description: "Platform administration plugin. Provides system-status, brand-settings, account-manage, account-update, admin-add, admin-remove, admin-list, admin-update-pin, agent-list, agent-config-read, logs-read, plugin-read, store-skill (deterministic write counterpart to plugin-read; persists operator-authored skills as plugin files under the active account), render-component, session-reset, session-resume, file-attach, wifi, adherence-read (attention-weighted adherence ledger), and action-approval tools (action-pending, action-approve, action-reject, action-edit) for managing the Maxy platform."
 tools:
   - system-status
   - brand-settings
@@ -14,6 +14,7 @@ tools:
   - agent-config-read
   - logs-read
   - plugin-read
+  - store-skill
   - render-component
   - session-reset
   - session-resume

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

@@ -6,7 +6,7 @@ import { z } from "zod";
 import { readFile, writeFile } from "node:fs/promises";
 import { resolve, join } from "node:path";
 import { execFileSync } from "node:child_process";
-import { appendFileSync, cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from "node:fs";
+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 { deviceUrlBlock } from "../../../../lib/device-url/dist/index.js";
@@ -1421,6 +1421,138 @@ server.tool("logs-read", "Read recent logs. Stream logs (type=agent-stream/error
         return { content: [{ type: "text", text: `Failed to read logs: ${err instanceof Error ? err.message : String(err)}` }] };
     }
 });
+// Task 918 — operator-authored skills are written to disk as a plugin so the
+// existing plugin-manifest loader picks them up (parsePluginFrontmatter +
+// assemblePublicPluginContent + loadEmbeddedPlugins all read from
+// <PLATFORM_ROOT>/plugins/<dir>/). Canonical = <accountDir>/plugins/<plugin>
+// survives installer rmSync (data/ excluded); the mirror under
+// <PLATFORM_ROOT>/plugins/<plugin> is rehydrated at admin session start by
+// autoDeliverUserPlugins. The agent supplies pluginName/skillName/body —
+// path is computed by this tool from ACCOUNT_ID. Symmetric write counterpart
+// to plugin-read (Task 916).
+server.tool("store-skill", "Save an operator-authored skill on disk as part of an admin-managed plugin. " +
+    "The skill becomes immediately discoverable by the admin agent (and the public agent if publicEmbed=true). " +
+    "Path is computed internally from the active account; the agent supplies content + names only. " +
+    "Re-running for the same skillName overwrites in place (drops orphan reference files).", {
+    pluginName: z.string().describe("Plugin directory name in lowercase kebab-case (e.g. 'beacons-skills'). Must not collide with a shipped plugin name."),
+    skillName: z.string().describe("Skill directory name in lowercase kebab-case (e.g. 'lead-capture')."),
+    description: z.string().describe("One-sentence skill description used in SKILL.md frontmatter and as the trigger hint for the agent."),
+    publicEmbed: z.boolean().describe("True to embed this skill in the public agent's system prompt; false for admin-only."),
+    body: z.string().describe("SKILL.md body content WITHOUT frontmatter. Frontmatter (name, description, publicEmbed) is composed by the tool."),
+    references: z.array(z.object({
+        filename: z.string().describe("Reference filename matching ^[a-z0-9-]+\\.md$ (no path separators)."),
+        content: z.string().describe("Reference file body content."),
+    })).default([]).describe("Optional reference files written under skills/<skillName>/references/."),
+}, async ({ pluginName, skillName, description, publicEmbed, body, references }) => {
+    const KEBAB_RE = /^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/;
+    const REF_RE = /^[a-z0-9-]+\.md$/;
+    if (!KEBAB_RE.test(pluginName)) {
+        console.error(`[store-skill] ERROR pluginName=${pluginName} reason=invalid-kebab path=-`);
+        return { content: [{ type: "text", text: `pluginName must be lowercase kebab-case (1-64 chars, no leading/trailing hyphen): "${pluginName}"` }], isError: true };
+    }
+    if (!KEBAB_RE.test(skillName)) {
+        console.error(`[store-skill] ERROR pluginName=${pluginName} skillName=${skillName} reason=invalid-kebab path=-`);
+        return { content: [{ type: "text", text: `skillName must be lowercase kebab-case (1-64 chars, no leading/trailing hyphen): "${skillName}"` }], isError: true };
+    }
+    for (const ref of references) {
+        if (!REF_RE.test(ref.filename)) {
+            console.error(`[store-skill] ERROR pluginName=${pluginName} skillName=${skillName} reason=invalid-ref-filename ref=${ref.filename} path=-`);
+            return { content: [{ type: "text", text: `reference filename must match ^[a-z0-9-]+\\.md$: "${ref.filename}"` }], isError: true };
+        }
+    }
+    const accountDir = getAccountDir();
+    const canonicalPluginDir = resolve(accountDir, "plugins", pluginName);
+    const mirrorPluginDir = resolve(PLATFORM_ROOT, "plugins", pluginName);
+    const canonicalPluginMd = resolve(canonicalPluginDir, "PLUGIN.md");
+    const mirrorPluginMd = resolve(mirrorPluginDir, "PLUGIN.md");
+    // Collision: mirror dir exists from a shipped plugin (no canonical mirror).
+    // Refuse rather than silently shadow.
+    if (existsSync(mirrorPluginMd) && !existsSync(canonicalPluginMd)) {
+        console.error(`[store-skill] ERROR pluginName=${pluginName} skillName=${skillName} reason=collision-with-shipped path=${mirrorPluginDir}`);
+        return { content: [{ type: "text", text: `pluginName "${pluginName}" collides with a shipped plugin. Choose a different pluginName.` }], isError: true };
+    }
+    const skillDir = resolve(canonicalPluginDir, "skills", skillName);
+    const action = existsSync(resolve(skillDir, "SKILL.md")) ? "overwrite" : "create";
+    try {
+        mkdirSync(canonicalPluginDir, { recursive: true });
+        // Compose PLUGIN.md only on first write. embed=["admin","public"] +
+        // optional=false matches assemblePublicPluginContent / loadEmbeddedPlugins
+        // expectations. metadata is single-line JSON (parsePluginFrontmatter at
+        // plugin-manifest.ts:67 expects single-line) — multi-line silently falls
+        // back to platform={}.
+        if (!existsSync(canonicalPluginMd)) {
+            const pluginMd = `---
+name: ${pluginName}
+description: "Operator-authored plugin"
+tools: []
+hidden: []
+requires: []
+metadata: {"platform":{"embed":["admin","public"],"optional":false}}
+---
+
+# ${pluginName}
+
+Operator-authored plugin. Skills under \`skills/\` were created via the admin skill-builder.
+`;
+            writeFileSync(canonicalPluginMd, pluginMd);
+        }
+        // Reset skill dir before write so removed reference files don't linger.
+        if (existsSync(skillDir)) {
+            rmSync(skillDir, { recursive: true, force: true });
+        }
+        mkdirSync(skillDir, { recursive: true });
+        // Normalise description — strip newlines and tabs to keep YAML
+        // frontmatter on a single line. parsePluginFrontmatter uses a
+        // single-line regex; an embedded newline (or `\n---\n`) would
+        // otherwise corrupt the frontmatter parse and silently drop body
+        // content from the agent prompt.
+        const singleLineDescription = description.replace(/[\r\n\t]+/g, " ").trim();
+        const escapedDescription = singleLineDescription.replace(/"/g, '\\"');
+        const skillMd = `---
+name: ${skillName}
+description: "${escapedDescription}"
+publicEmbed: ${publicEmbed}
+---
+
+${body}
+`;
+        writeFileSync(resolve(skillDir, "SKILL.md"), skillMd);
+        let refCount = 0;
+        if (references.length > 0) {
+            const refsDir = resolve(skillDir, "references");
+            mkdirSync(refsDir, { recursive: true });
+            for (const ref of references) {
+                writeFileSync(resolve(refsDir, ref.filename), ref.content);
+                refCount++;
+            }
+        }
+        // Write the `.user-mirror` marker to CANONICAL first — cpSync will
+        // carry it into the platform-side mirror as part of the same recursive
+        // copy. This eliminates the post-cpSync writeFileSync race: if cpSync
+        // succeeds, the marker is already in target; if cpSync fails partway,
+        // canonical's marker is intact and the next autoDeliverUserPlugins
+        // call retries the copy. autoDeliverUserPlugins relies on the marker
+        // arriving with the source tree — never writes its own marker.
+        writeFileSync(resolve(canonicalPluginDir, ".user-mirror"), `pluginName=${pluginName}\nsource=${canonicalPluginDir}\n`);
+        // Mirror to <PLATFORM_ROOT>/plugins/<pluginName>/ so the change is
+        // visible to the loader without a session restart.
+        mkdirSync(mirrorPluginDir, { recursive: true });
+        cpSync(canonicalPluginDir, mirrorPluginDir, { recursive: true, force: true });
+        const bodyBytes = Buffer.byteLength(body, "utf-8");
+        console.log(`[store-skill] write pluginName=${pluginName} skillName=${skillName} publicEmbed=${publicEmbed} path=${canonicalPluginDir} bodyBytes=${bodyBytes} referenceCount=${refCount} action=${action}`);
+        return {
+            content: [{
+                    type: "text",
+                    text: `Skill "${skillName}" saved to plugin "${pluginName}" (${action}). publicEmbed=${publicEmbed}, references=${refCount}. Active immediately for the admin agent${publicEmbed ? "; surfaces in the public agent on next session start" : ""}.`,
+                }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[store-skill] ERROR pluginName=${pluginName} skillName=${skillName} reason=${msg.slice(0, 120)} path=${canonicalPluginDir}`);
+        return { content: [{ type: "text", text: `Failed to write skill: ${msg}` }], isError: true };
+    }
+});
 server.tool("plugin-read", "Read a plugin definition (PLUGIN.md) or one of its reference files.", {
     pluginName: z.string().describe("Name of the plugin directory (e.g. 'sales', 'business-assistant')"),
     file: z.string().optional().describe("Specific file to read (e.g. 'references/pricing.md'). Defaults to PLUGIN.md."),