@rubytech/create-realagent-code 0.1.113 → 0.1.115

package/payload/server/server.js

@@ -60,7 +60,9 @@ import {
   requireAdminSession,
   requirePortEnv,
   resolveAccount,
+  resolveAgentConfig,
   resolveClientIp,
+  resolveDefaultAgentSlug,
   resolveUserAccounts,
   runAdminUserSelfHeal,
   safeJson,
@@ -80,7 +82,7 @@ import {
   vncLog,
   walkPremiumBundles,
   writeAdminUserAndPerson
-} from "./chunk-FSPPVVWM.js";
+} from "./chunk-FJCI6X3H.js";
 import {
   __commonJS,
   __toESM
@@ -4415,6 +4417,8 @@ async function managerSpawn(opts) {
       role: opts.role,
       channel: opts.channel,
       accountId: opts.accountId,
+      agentSlug: opts.agentSlug,
+      liveMemory: opts.liveMemory,
       attachmentDir: opts.attachmentDir,
       aboutOwner: opts.aboutOwner,
       dormantPlugins: opts.dormantPlugins,
@@ -4540,12 +4544,12 @@ function publicIdleMs() {
   return Number(process.env.CHANNEL_PTY_IDLE_MS ?? String(30 * 6e4));
 }
 var index = /* @__PURE__ */ new Map();
-function indexKey(accountId, senderId) {
-  return `${accountId}:${senderId}`;
+function indexKey(accountId, agentSlug, senderId, liveMemory) {
+  return `${accountId}:${agentSlug}:${liveMemory ? "lm1" : "lm0"}:${senderId}`;
 }
 async function ensureEntry(input) {
   startReaper();
-  const key = indexKey(input.accountId, input.senderId);
+  const key = indexKey(input.accountId, input.agentSlug, input.senderId, input.liveMemory);
   const existing = index.get(key);
   const tag = tagFor(input.channel);
   if (existing) {
@@ -4567,6 +4571,8 @@ async function ensureEntry(input) {
     role: input.role,
     channel: input.channel,
     accountId: input.accountId,
+    agentSlug: input.agentSlug,
+    liveMemory: input.liveMemory,
     attachmentDir
   });
   if ("error" in spawned) {
@@ -4581,12 +4587,14 @@ async function ensureEntry(input) {
     channel: input.channel,
     accountId: input.accountId,
     senderId: input.senderId,
+    agentSlug: input.agentSlug,
     lastInboundAt: Date.now(),
     writeChain: Promise.resolve(),
     subscribers: /* @__PURE__ */ new Set(),
     pendingTurnText: "",
     followerAbort: null,
-    followerRunning: false
+    followerRunning: false,
+    liveMemory: input.liveMemory
   };
   entry.followerAbort = startFollower({
     entry,
@@ -4613,12 +4621,14 @@ async function writeInput(entry, text) {
           `${tag} session-resolved senderId=${entry.senderId} action=respawn reason=session-gone-${result.status} sessionId=${entry.sessionId.slice(0, 8)}`
         );
         if (entry.followerAbort) entry.followerAbort.abort();
-        index.delete(indexKey(entry.accountId, entry.senderId));
+        index.delete(indexKey(entry.accountId, entry.agentSlug, entry.senderId, entry.liveMemory));
         const respawned = await ensureEntry({
           accountId: entry.accountId,
           senderId: entry.senderId,
           role: entry.role,
-          channel: entry.channel
+          channel: entry.channel,
+          agentSlug: entry.agentSlug,
+          liveMemory: entry.liveMemory
         });
         if (!respawned) return false;
         for (const cb of entry.subscribers) respawned.subscribers.add(cb);
@@ -4654,7 +4664,9 @@ async function dispatchOnce(input) {
     accountId: input.accountId,
     senderId: input.senderId,
     role: input.role,
-    channel: input.channel
+    channel: input.channel,
+    agentSlug: input.agentSlug,
+    liveMemory: input.liveMemory
   });
   if (!entry) return { error: "spawn-failed" };
   entry.lastInboundAt = Date.now();
@@ -4860,6 +4872,18 @@ ${lines}]`;
   if (!account) {
     return c.json({ error: "No account configured" }, 500);
   }
+  const agentSlug = resolveDefaultAgentSlug(account.accountDir);
+  if (!agentSlug) {
+    return c.json({ error: "No default agent configured" }, 500);
+  }
+  let liveMemory = false;
+  try {
+    liveMemory = resolveAgentConfig(account.accountDir, agentSlug).liveMemory;
+  } catch (err) {
+    const m = err instanceof Error ? err.message : String(err);
+    console.error(`${WEBCHAT_TAG} reject reason=agent-config-failed agentSlug=${agentSlug} message=${m}`);
+    return c.json({ error: "Agent config invalid" }, 500);
+  }
   const sk = session_key.slice(0, 8);
   console.error(
     `${WEBCHAT_TAG} inbound from=${sk} bytes=${Buffer.byteLength(fullMessage, "utf8")} attachments=${attachmentCount} accountId=${account.accountId}`
@@ -4872,6 +4896,8 @@ ${lines}]`;
           senderId: session_key,
           role: "public",
           channel: "webchat",
+          agentSlug,
+          liveMemory,
           text: fullMessage,
           timeoutMs: webchatTurnTimeoutMs()
         });
@@ -12134,6 +12160,55 @@ app34.get("/:rel{.*}", (c) => {
 });
 var sites_default = app34;
 
+// server/routes/listings.ts
+var SAFE_SLUG_RE = /^[a-z0-9](?:[a-z0-9-]{0,118}[a-z0-9])?$/;
+var CHAT_SESSION_KEY_RE = /^[A-Za-z0-9][A-Za-z0-9_-]{7,127}$/;
+var app35 = new Hono();
+app35.get("/:slug/click", async (c) => {
+  const slug = c.req.param("slug") ?? "";
+  const rawSession = c.req.query("session") ?? "";
+  const sessionKey = CHAT_SESSION_KEY_RE.test(rawSession) ? rawSession : "invalid";
+  if (!SAFE_SLUG_RE.test(slug)) {
+    console.error(`[property-card-click] reject reason=bad-slug-shape slug=${JSON.stringify(slug)} status=400`);
+    return c.text("Bad Request", 400);
+  }
+  const account = resolveAccount();
+  if (!account) {
+    console.error(`[property-card-click] reject reason=no-account slug=${slug} status=404`);
+    return c.text("Not Found", 404);
+  }
+  let pageUrl = null;
+  const session = getSession();
+  try {
+    const result = await session.run(
+      `MATCH (l:Listing {accountId: $accountId, slug: $slug})
+       WHERE l.scope = 'public'
+       RETURN l.pageUrl AS pageUrl
+       LIMIT 1`,
+      { accountId: account.accountId, slug }
+    );
+    const record = result.records[0];
+    const raw = record?.get("pageUrl");
+    pageUrl = typeof raw === "string" && raw.length > 0 ? raw : null;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`[property-card-click] reject reason=neo4j-error slug=${slug} sessionKey=${sessionKey} err=${JSON.stringify(message)} status=503`);
+    await session.close().catch(() => {
+    });
+    return c.text("Service Unavailable", 503);
+  } finally {
+    await session.close().catch(() => {
+    });
+  }
+  if (!pageUrl) {
+    console.error(`[property-card-click] reject reason=listing-not-found slug=${slug} sessionKey=${sessionKey} accountId=${account.accountId} status=404`);
+    return c.text("Not Found", 404);
+  }
+  console.log(`[property-card-click] sessionKey=${sessionKey} listingSlug=${slug} ts=${(/* @__PURE__ */ new Date()).toISOString()}`);
+  return c.redirect(pageUrl, 302);
+});
+var listings_default = app35;
+
 // app/lib/graph-health.ts
 var HOUR_MS = 60 * 60 * 1e3;
 var timer = null;
@@ -12227,6 +12302,8 @@ async function dispatchToClaude(input) {
     senderId: input.senderId,
     role: input.role,
     channel: "whatsapp",
+    agentSlug: input.agentSlug,
+    liveMemory: input.liveMemory,
     text: input.text,
     timeoutMs: whatsappTurnTimeoutMs()
   });
@@ -12567,9 +12644,9 @@ watchFile(ALIAS_DOMAINS_PATH, { interval: 2e3 }, () => {
 function isPublicHost(host) {
   return host.startsWith("public.") || aliasDomains.has(host);
 }
-var app35 = new Hono();
-app35.use("*", clientIpMiddleware);
-app35.use("*", async (c, next) => {
+var app36 = new Hono();
+app36.use("*", clientIpMiddleware);
+app36.use("*", async (c, next) => {
   await next();
   c.header("X-Content-Type-Options", "nosniff");
   c.header("Referrer-Policy", "strict-origin-when-cross-origin");
@@ -12579,7 +12656,7 @@ app35.use("*", async (c, next) => {
   );
 });
 var HTTP_LOG_PATHS = /* @__PURE__ */ new Set(["/vnc-viewer.html", "/vnc-popout.html"]);
-app35.use("*", async (c, next) => {
+app36.use("*", async (c, next) => {
   if (!HTTP_LOG_PATHS.has(c.req.path)) {
     await next();
     return;
@@ -12612,7 +12689,7 @@ var PUBLIC_ALLOWED_PREFIXES = [
   "/sites/"
 ];
 var PUBLIC_ALLOWED_EXACT = ["/favicon.ico"];
-app35.use("*", async (c, next) => {
+app36.use("*", async (c, next) => {
   const host = (c.req.header("host") ?? "").split(":")[0];
   if (!isPublicHost(host)) {
     await next();
@@ -12652,7 +12729,7 @@ function resolveRemoteAuthOpts() {
   return brandLoginOpts;
 }
 var MAX_LOGIN_BODY = 8 * 1024;
-app35.post("/__remote-auth/login", async (c) => {
+app36.post("/__remote-auth/login", async (c) => {
   const client = clientFrom(c);
   const clientIp = client.ip || "unknown";
   if (!requestIsTlsTerminated(c)) {
@@ -12697,7 +12774,7 @@ app35.post("/__remote-auth/login", async (c) => {
     }
   });
 });
-app35.get("/__remote-auth/logout", (c) => {
+app36.get("/__remote-auth/logout", (c) => {
   const client = clientFrom(c);
   const clientIp = client.ip || "unknown";
   console.error(`[remote-auth] logout ip=${clientIp}`);
@@ -12710,7 +12787,7 @@ app35.get("/__remote-auth/logout", (c) => {
     }
   });
 });
-app35.post("/__remote-auth/change-password", async (c) => {
+app36.post("/__remote-auth/change-password", async (c) => {
   const client = clientFrom(c);
   const clientIp = client.ip || "unknown";
   const rateLimited = checkRateLimit(client);
@@ -12761,13 +12838,13 @@ app35.post("/__remote-auth/change-password", async (c) => {
     return c.html(renderLoginPage({ ...resolveRemoteAuthOpts(), mode: "change", changeError: "Failed to save password", redirect }), 200);
   }
 });
-app35.get("/__remote-auth/setup", (c) => {
+app36.get("/__remote-auth/setup", (c) => {
   if (isRemoteAuthConfigured()) {
     return c.redirect("/");
   }
   return c.html(renderLoginPage({ ...resolveRemoteAuthOpts(), mode: "setup" }), 200);
 });
-app35.post("/__remote-auth/set-initial-password", async (c) => {
+app36.post("/__remote-auth/set-initial-password", async (c) => {
   if (isRemoteAuthConfigured()) {
     return c.redirect("/");
   }
@@ -12805,10 +12882,10 @@ app35.post("/__remote-auth/set-initial-password", async (c) => {
     return c.html(renderLoginPage({ ...resolveRemoteAuthOpts(), mode: "setup", setupError: "Failed to save password. Please try again." }), 200);
   }
 });
-app35.get("/api/remote-auth/status", (c) => {
+app36.get("/api/remote-auth/status", (c) => {
   return c.json({ configured: isRemoteAuthConfigured() });
 });
-app35.post("/api/remote-auth/set-password", async (c) => {
+app36.post("/api/remote-auth/set-password", async (c) => {
   let body;
   try {
     body = await c.req.json();
@@ -12839,9 +12916,9 @@ app35.post("/api/remote-auth/set-password", async (c) => {
     return c.json({ error: "Failed to save password" }, 500);
   }
 });
-app35.route("/api/_client-error", client_error_default);
+app36.route("/api/_client-error", client_error_default);
 console.log("[client-error-route] mounted");
-app35.use("*", async (c, next) => {
+app36.use("*", async (c, next) => {
   const host = (c.req.header("host") ?? "").split(":")[0];
   const path2 = c.req.path;
   if (path2 === "/favicon.ico" || path2.startsWith("/assets/") || path2.startsWith("/brand/")) {
@@ -12874,12 +12951,12 @@ app35.use("*", async (c, next) => {
   console.error(`[remote-auth] login required ip=${clientIp} path=${path2} ${disambig}`);
   return c.html(renderLoginPage({ ...resolveRemoteAuthOpts(), redirect: path2 }), 200);
 });
-app35.route("/api/health", health_default);
-app35.route("/api/chat", chat_default);
-app35.route("/api/whatsapp", whatsapp_default);
-app35.route("/api/onboarding", onboarding_default);
-app35.route("/api/admin", admin_default);
-var SAFE_SLUG_RE = /^[a-z][a-z0-9-]{2,49}$/;
+app36.route("/api/health", health_default);
+app36.route("/api/chat", chat_default);
+app36.route("/api/whatsapp", whatsapp_default);
+app36.route("/api/onboarding", onboarding_default);
+app36.route("/api/admin", admin_default);
+var SAFE_SLUG_RE2 = /^[a-z][a-z0-9-]{2,49}$/;
 var SAFE_FILENAME_RE = /^[a-z0-9_][a-z0-9_.-]{0,99}$/i;
 var IMAGE_MIME = {
   ".png": "image/png",
@@ -12890,10 +12967,10 @@ var IMAGE_MIME = {
   ".svg": "image/svg+xml",
   ".ico": "image/x-icon"
 };
-app35.get("/agent-assets/:slug/:filename", (c) => {
+app36.get("/agent-assets/:slug/:filename", (c) => {
   const slug = c.req.param("slug");
   const filename = c.req.param("filename");
-  if (!SAFE_SLUG_RE.test(slug)) {
+  if (!SAFE_SLUG_RE2.test(slug)) {
     console.error(`[agent-assets] invalid-slug slug=${slug}`);
     return c.text("Not found", 404);
   }
@@ -12925,7 +13002,7 @@ app35.get("/agent-assets/:slug/:filename", (c) => {
     "Cache-Control": "public, max-age=3600"
   });
 });
-app35.get("/generated/:filename", (c) => {
+app36.get("/generated/:filename", (c) => {
   const filename = c.req.param("filename");
   if (!SAFE_FILENAME_RE.test(filename) || filename.includes("..")) {
     console.error(`[generated] serve file=${filename} status=403`);
@@ -12955,7 +13032,8 @@ app35.get("/generated/:filename", (c) => {
     "Cache-Control": "public, max-age=86400"
   });
 });
-app35.route("/sites", sites_default);
+app36.route("/sites", sites_default);
+app36.route("/listings", listings_default);
 var htmlCache = /* @__PURE__ */ new Map();
 var brandLogoPath = "/brand/maxy-monochrome.png";
 var brandIconPath = "/brand/maxy-monochrome.png";
@@ -13092,7 +13170,7 @@ function brandedPublicHtml(agentSlug) {
 function escapeHtml(s) {
   return s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
-app35.get("/", (c) => {
+app36.get("/", (c) => {
   const host = (c.req.header("host") ?? "").split(":")[0];
   if (isPublicHost(host)) {
     const defaultSlug = resolveDefaultSlug();
@@ -13100,12 +13178,12 @@ app35.get("/", (c) => {
   }
   return c.html(cachedHtml("index.html"));
 });
-app35.get("/public", (c) => {
+app36.get("/public", (c) => {
   const host = (c.req.header("host") ?? "").split(":")[0];
   if (isPublicHost(host)) return c.text("Not found", 404);
   return c.html(cachedHtml("public.html"));
 });
-app35.get("/chat", (c) => {
+app36.get("/chat", (c) => {
   const host = (c.req.header("host") ?? "").split(":")[0];
   if (isPublicHost(host)) return c.text("Not found", 404);
   return c.html(cachedHtml("public.html"));
@@ -13124,9 +13202,9 @@ async function logViewerFetch(c, next) {
     duration_ms: Date.now() - start
   });
 }
-app35.use("/vnc-viewer.html", logViewerFetch);
-app35.use("/vnc-popout.html", logViewerFetch);
-app35.get("/vnc-popout.html", (c) => {
+app36.use("/vnc-viewer.html", logViewerFetch);
+app36.use("/vnc-popout.html", logViewerFetch);
+app36.get("/vnc-popout.html", (c) => {
   let html = htmlCache.get("vnc-popout.html");
   if (!html) {
     html = readFileSync19(resolve21(process.cwd(), "public", "vnc-popout.html"), "utf-8");
@@ -13139,7 +13217,7 @@ app35.get("/vnc-popout.html", (c) => {
   }
   return c.html(html);
 });
-app35.post("/api/vnc/client-event", async (c) => {
+app36.post("/api/vnc/client-event", async (c) => {
   let body;
   try {
     body = await c.req.json();
@@ -13160,25 +13238,25 @@ app35.post("/api/vnc/client-event", async (c) => {
   });
   return c.json({ ok: true });
 });
-app35.get("/g/:slug", (c) => {
+app36.get("/g/:slug", (c) => {
   return c.html(brandedPublicHtml());
 });
-app35.get("/graph", (c) => {
+app36.get("/graph", (c) => {
   const host = (c.req.header("host") ?? "").split(":")[0];
   if (isPublicHost(host)) return c.text("Not found", 404);
   return c.html(cachedHtml("graph.html"));
 });
-app35.get("/sessions", (c) => {
+app36.get("/sessions", (c) => {
   const host = (c.req.header("host") ?? "").split(":")[0];
   if (isPublicHost(host)) return c.text("Not found", 404);
   return c.html(cachedHtml("sessions.html"));
 });
-app35.get("/data", (c) => {
+app36.get("/data", (c) => {
   const host = (c.req.header("host") ?? "").split(":")[0];
   if (isPublicHost(host)) return c.text("Not found", 404);
   return c.html(cachedHtml("data.html"));
 });
-app35.get("/:slug", async (c, next) => {
+app36.get("/:slug", async (c, next) => {
   const slug = c.req.param("slug");
   if (AGENT_SLUG_PATTERN.test(`/${slug}`)) {
     const branding = loadBrandingCache(slug);
@@ -13188,15 +13266,15 @@ app35.get("/:slug", async (c, next) => {
   await next();
 });
 if (brandFaviconPath !== "/favicon.ico") {
-  app35.get("/favicon.ico", (c) => {
+  app36.get("/favicon.ico", (c) => {
     c.header("Cache-Control", "public, max-age=300");
     return c.redirect(brandFaviconPath, 302);
   });
 }
-app35.use("/*", serveStatic({ root: "./public" }));
+app36.use("/*", serveStatic({ root: "./public" }));
 var port = requirePortEnv("MAXY_UI_INTERNAL_PORT", { tag: "ui-server" });
 var hostname = process.env.HOSTNAME ?? "127.0.0.1";
-var httpServer = serve({ fetch: app35.fetch, port, hostname });
+var httpServer = serve({ fetch: app36.fetch, port, hostname });
 console.log(`${BRAND.productName} listening on http://${hostname}:${port}`);
 {
   const loopHist = monitorEventLoopDelay({ resolution: 50 });
@@ -13220,7 +13298,8 @@ var SUBAPP_MANIFEST = [
   { prefix: "/api/whatsapp", file: "server/routes/whatsapp.ts", subapp: whatsapp_default },
   { prefix: "/api/onboarding", file: "server/routes/onboarding.ts", subapp: onboarding_default },
   { prefix: "/api/admin", file: "server/routes/admin/index.ts", subapp: admin_default },
-  { prefix: "/api/_client-error", file: "server/routes/client-error.ts", subapp: client_error_default }
+  { prefix: "/api/_client-error", file: "server/routes/client-error.ts", subapp: client_error_default },
+  { prefix: "/listings", file: "server/routes/listings.ts", subapp: listings_default }
 ];
 for (const m of SUBAPP_MANIFEST) {
   const routeCount = Array.isArray(m.subapp.routes) ? m.subapp.routes.length : 0;
@@ -13228,7 +13307,7 @@ for (const m of SUBAPP_MANIFEST) {
 }
 try {
   const registered = [];
-  for (const r of app35.routes ?? []) {
+  for (const r of app36.routes ?? []) {
     if (typeof r.path !== "string" || r.path.includes(":") || r.path.includes("*")) continue;
     if (AGENT_SLUG_PATTERN.test(r.path)) {
       registered.push({ method: (r.method ?? "ALL").toUpperCase(), path: r.path });
@@ -13348,11 +13427,27 @@ init({
   onMessage: async (msg) => {
     if (process.env.WHATSAPP_PTY_BRIDGE_ENABLED === "true" && msg.text && !msg.isOwnerMirror) {
       try {
+        let agentSlugForBridge;
+        let liveMemoryForBridge;
+        if (msg.agentType === "admin") {
+          agentSlugForBridge = "admin";
+          liveMemoryForBridge = true;
+        } else {
+          const resolved = bootAccount ? resolvePublicAgent(bootAccount.accountDir, { accountId: msg.accountId, groupJid: msg.groupJid }) : null;
+          if (!resolved) {
+            console.error(`[whatsapp-adaptor] reject reason=no-public-agent senderId=${msg.senderPhone} accountId=${msg.accountId} groupJid=${msg.groupJid ?? "none"}`);
+            return;
+          }
+          agentSlugForBridge = resolved.slug;
+          liveMemoryForBridge = bootAccount ? resolveAgentConfig(bootAccount.accountDir, resolved.slug).liveMemory : false;
+        }
         startReaper2();
         await dispatchToClaude({
           accountId: msg.accountId,
           senderId: msg.senderPhone,
           role: msg.agentType,
+          agentSlug: agentSlugForBridge,
+          liveMemory: liveMemoryForBridge,
           text: msg.text,
           reply: msg.reply
         });

package/payload/platform/plugins/teaching/.claude-plugin/plugin.json

@@ -1,8 +0,0 @@
-{
-  "name": "teaching",
-  "description": "Interactive tutoring, lesson planning, and study pack generation. Teaches any subject from the knowledge base, adapting to learner age and pace. Three skills: live tutoring, parent-delivered lesson plans, and independent revision packs.",
-  "version": "0.1.0",
-  "author": {
-    "name": "Rubytech LLC"
-  }
-}

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

@@ -1,58 +0,0 @@
----
-name: teaching
-description: "Interactive tutoring, lesson planning, and study pack generation. Teaches any subject from the knowledge base, adapting to learner age and pace. Three skills: live tutoring, parent-delivered lesson plans, and independent revision packs."
-icon: 🎓
-tools: []
-always: false
-metadata: {"platform":{"optional":true,"pluginKey":"teaching","embed":["public","admin"]}}
----
-
-# Teaching
-
-Three skills for knowledge-based teaching and learning. Each skill draws content exclusively from the account's knowledge base — never from training data — and adapts to the learner's age (5–18).
-
-## Skills
-
-| Skill | Purpose | Audience |
-|-------|---------|----------|
-| `interactive-tutor` | Teaches a learner directly through conversation, adapting in real time | Student (via chat) |
-| `lesson-planner` | Generates self-contained lesson plans a parent or instructor can deliver | Parent / instructor |
-| `study-pack-builder` | Produces structured revision packs (flashcards, summaries, assessments) | Student (independent study) |
-
-## When to Activate
-
-The user wants to:
-- Teach a child or student a topic from the knowledge base
-- Create a lesson plan for home education or tutoring
-- Build revision materials, flashcards, or study packs from stored content
-- Prepare a student for an assessment using knowledge base content
-
-## Shared Principles
-
-- **Content from knowledge base only.** Every skill searches memory first. If the knowledge base lacks sufficient material, the skill says so — it never fills gaps from training data.
-- **Conversational context gathering.** Each skill collects requirements one question at a time, confirming before generating.
-- **Age-appropriate adaptation.** Language, examples, and complexity scale to the learner's age (5–18 years).
-- **Self-contained output.** Lesson plans, study packs, and tutoring sessions require no external resources.
-- **Domain-neutral.** The skills work for any subject present in the knowledge base — not limited to any specific curriculum, exam board, or educational system.
-
-## Tools Used
-
-No MCP server. Skills operate via existing platform tools:
-- `memory-search` — retrieve subject content from the knowledge base
-- `image_generate` — create visual aids, diagrams, and infographics
-
-Structured choices are presented as numbered lists in plain chat — the platform has no inline-UI component primitive on the admin / native-CC surface.
-
-## References
-
-Domain knowledge files loaded on demand by each skill:
-
-| Reference | Used By | Purpose |
-|-----------|---------|---------|
-| `references/assessment.md` | interactive-tutor | Prior knowledge assessment and comprehension checking |
-| `references/classroom-conduct.md` | interactive-tutor | Standing rules for language, output format, and boundaries |
-| `references/teaching-modes.md` | interactive-tutor | Four teaching approaches (Socratic, Direct, Guided Discovery, Adaptive) |
-| `references/context-gathering.md` | lesson-planner | Student context fields and teaching mode descriptions |
-| `references/plan-structure.md` | lesson-planner | Lesson plan format, content requirements, and quality standards |
-| `references/disaggregation.md` | study-pack-builder | Building topic hierarchies from knowledge base content |
-| `references/materials.md` | study-pack-builder | Per-topic revision material generation (summaries, flashcards, assessments) |

package/payload/platform/plugins/teaching/skills/interactive-tutor/SKILL.md

@@ -1,59 +0,0 @@
----
-name: interactive-tutor
-description: "Teach learners interactively through conversation. Adapts to the student's age, assesses prior knowledge, teaches using four modes (Socratic, Direct, Guided Discovery, Adaptive), checks comprehension, and adjusts complexity in real time."
----
-
-# Interactive Tutor
-
-You teach learners directly through conversation. When a student wants to learn something, you become their teacher — engaging, age-appropriate, and responsive to their understanding.
-
-## Teaching Flow
-
-```
-1. Gather basics (age, topic, lesson length, teaching mode)
-2. Assess prior knowledge (warm greeting, 1-2 questions)
-3. Teach with adaptive complexity (main loop)
-```
-
-## Step 1: Gather Basics
-
-Collect from the parent or student:
-- **Student's age**
-- **Topic** to learn
-- **Lesson length** (10-20 minutes)
-- **Teaching mode** (Socratic, Direct, Guided Discovery, or Adaptive)
-
-If the parent is present, gather from them. If the student is chatting directly, ask in age-appropriate language.
-
-## Step 2: Assess Prior Knowledge
-
-Greet the student warmly. You are now speaking DIRECTLY to the child, not the parent.
-- Brief introduction about what you'll learn together
-- 1-2 engaging questions to gauge what they already know
-- Then transition directly into teaching — don't announce a plan
-
-Load `references/assessment.md` for the full assessment approach.
-
-## Step 3: Teach
-
-Search memory for content on the topic before teaching. Teach from what the knowledge base provides — do not teach from training data.
-
-Use the selected mode. Load `references/teaching-modes.md` for mode-specific strategies.
-
-During teaching:
-- Use concrete, age-appropriate examples (toys, games, food, animals — things they know)
-- Check comprehension periodically
-- Adjust complexity based on their responses
-- Celebrate their thinking process and effort
-- Generate images with `image_generate` when a visual would help — diagrams, illustrations, worked examples. Don't narrate that you're generating; just include the image naturally in the teaching flow.
-
-Load `references/classroom-conduct.md` for conduct rules that apply at all times.
-
-## Critical Rules
-
-1. **Speak only dialogue** — no action descriptions, no asterisks, no stage directions. Only words you would say out loud.
-2. **Don't ask permission** — "Would you like me to teach you?" is wrong. Just teach.
-3. **Lead with confidence** — you are the teacher. Ask questions, guide discovery, explain concepts.
-4. **Adapt immediately** — if they struggle once, simplify. If they excel once, increase the challenge. Don't wait for patterns.
-5. **Stay on topic** — if the student goes off-topic, redirect warmly but firmly.
-6. **Content from memory only** — search the knowledge base for topic content. Do not teach from training data.

package/payload/platform/plugins/teaching/skills/interactive-tutor/references/assessment.md

@@ -1,70 +0,0 @@
-# Assessment and Comprehension
-
-## Initial Assessment (Prior Knowledge)
-
-When transitioning from gathering basics to teaching, assess what the student already knows.
-
-**You are speaking DIRECTLY to the student, not the parent.**
-
-### Opening
-1. Warm greeting: "Hello! I'm excited to teach you about [topic] today."
-2. Brief introduction: explain what you'll be learning together in simple terms
-3. Transition to assessment: "Before we dive in, I'd like to understand what you already know."
-
-### Assessment Questions
-- Ask open, engaging questions — not test questions
-- "What do you know about [topic]?" not "Can you define [topic]?"
-- "Have you ever noticed..." or "What happens when you..."
-- Keep it light — this isn't a test
-- Build on what they say with follow-up questions
-
-### Quick Assessment (1-2 Questions Max)
-1. Start with an open question about what they know
-2. Based on their answer, ask one follow-up to gauge depth
-3. Then START TEACHING immediately — don't announce a plan
-
-### Transition to Teaching
-- Wrong: "I'll now create a lesson plan for you..."
-- Right: "Let me show you something cool about [topic]..."
-- Wrong: "Would you like me to start teaching?"
-- Right: "Here's an interesting question..."
-
-## Comprehension Checks During Teaching
-
-Periodically assess whether the student understands the current concept.
-
-### How to Check
-Ask a question that tests understanding, not recall:
-- "If I changed [variable], what would happen?"
-- "Can you explain that to me in your own words?"
-- "Why do you think [concept] works that way?"
-
-### Interpreting Responses
-
-| Level | Signs | Action |
-|-------|-------|--------|
-| Full understanding | Explains concept accurately, applies it to new examples | Move on. Increase complexity. |
-| Partial understanding | Gets the idea but misses details or can't apply it | Clarify the gaps. Try a different example. |
-| Minimal understanding | Vague or partially wrong answers | Simplify. Reteach with a different approach. |
-| No understanding | Confused, silent, or completely wrong | Step back. Start from a more basic concept. |
-
-### Complexity Adjustment
-
-Track complexity on a 1-10 scale (1 = very simple, 10 = advanced).
-
-**Decrease complexity when:** Multiple wrong answers, asks for explanations, says "I don't understand", long pauses.
-
-**Increase complexity when:** Answers quickly and correctly, asks advanced questions, shows mastery, seems bored.
-
-**Maintain when:** Appropriately challenged, engaged, occasional mistakes but learning.
-
-Adjustments should be decisive (+/-2-3 levels) when the signal is clear, gradual (+/-1) when uncertain.
-
-## Mastery Tracking
-
-Throughout the session, mentally track:
-- **Concepts introduced** — what you've taught
-- **Concepts mastered** — what the student demonstrated understanding of
-- **Concepts needing work** — where they struggled
-
-Use this to guide what to focus on next. Don't move on from a concept the student hasn't grasped — reteach it differently before progressing.