@rubytech/create-realagent-code 0.1.30 → 0.1.31

package/payload/platform/services/claude-session-manager/dist/system-prompt.js

@@ -12,7 +12,18 @@
 //                                            caller supplies an `onboarding`
 //                                            payload AND the resolved step
 //                                            is anything other than 9
-//                                            (complete). Task 043.
+//                                            (complete). State-only as of
+//                                            Task 066: the block carries
+//                                            currentStep / resumeStep
+//                                            attributes plus the script-
+//                                            resolved resume-prompt content
+//                                            quoted verbatim. No prose
+//                                            imperatives — the onboarding
+//                                            state machine is advanced by
+//                                            scripts/onboarding-advance.sh
+//                                            BEFORE the session is spawned,
+//                                            and the chat surface presents
+//                                            the script output verbatim.
 //
 // The block is the only doctrine surface that survives Claude Code SDK
 // upgrades. Per Task 037, no skill carries a copy; one edit here changes the
@@ -38,7 +49,7 @@ export function composeAppendSystemPrompt(host, onboarding) {
         '</attachment-ceiling>',
     ];
     if (onboarding) {
-        const rendered = renderOnboardingBlock(onboarding.step);
+        const rendered = renderOnboardingBlock(onboarding.step, onboarding.resumePrompt);
         if (rendered)
             sections.push(rendered.block);
     }
@@ -46,41 +57,53 @@ export function composeAppendSystemPrompt(host, onboarding) {
 }
 /** Render the onboarding-state section for a given step. Returns null when
  *  the agent should see no onboarding block (step === 9 = complete). The
- *  prose contract — declarative two-tool sequence, forbidden preamble
- *  phrasings — is pinned by tests in `__tests__/system-prompt.test.ts`
- *  and `platform/ui/app/lib/__tests__/onboarding-prompt-complete-onboarding.test.ts`. */
-export function renderOnboardingBlock(step) {
+ *  body is state-only per Task 066: currentStep + resumeStep attributes
+ *  plus an optional `<resume-prompt-shown>` child carrying the verbatim
+ *  output of the banner-click script run, so the agent has context for
+ *  the operator's next reply without any per-tool imperative. */
+export function renderOnboardingBlock(step, resumePrompt) {
     if (step === 9)
         return null;
     if (step === null) {
-        return { block: renderUnreachableBlock(), label: 'graph-unreachable' };
+        return { block: renderUnreachableBlock(resumePrompt), label: 'graph-unreachable' };
     }
     if (step < 0) {
-        return { block: renderIncompleteBlock(-1), label: 'missing' };
+        return { block: renderIncompleteBlock(-1, resumePrompt), label: 'missing' };
     }
-    return { block: renderIncompleteBlock(step), label: String(step) };
+    return { block: renderIncompleteBlock(step, resumePrompt), label: String(step) };
 }
-function renderIncompleteBlock(currentStep) {
+function renderIncompleteBlock(currentStep, resumePrompt) {
     const stepAttr = currentStep < 0 ? 'missing' : String(currentStep);
     const resumeStep = currentStep < 0 ? 0 : currentStep + 1;
-    // Task 038 Outcome E1 — declarative, no menu phrasing, no pre-skill preamble.
-    // Two-tool contract: first `skill-load(name=onboarding)`, then
-    // `render-component` for the next step. Operator-visible drift (any "let
-    // me check", "let me figure out", "let me list" preamble) is the
-    // failure mode the precision-check rule `onboarding-skill-drift` watches
-    // for; the prose below names it so the agent treats the constraint as
-    // structural rather than stylistic.
-    return [
-        `<onboarding-state currentStep="${stepAttr}" resumeStep="${resumeStep}">`,
-        `Onboarding is incomplete. Your first tool call this turn is \`skill-load\` with \`skillName=onboarding\`. Your second tool call is \`render-component\` for step ${resumeStep}, exactly as the skill body directs. Do not greet, do not summarise, do not write a preamble (\`let me check\`, \`let me figure out\`, \`let me list\` and similar phrasings are forbidden). The skill body is the only authority for what the operator sees next.`,
-        `</onboarding-state>`,
-    ].join('\n');
+    // Task 066 — state-only block. No prose imperatives, no named tools.
+    // The onboarding state machine is advanced by
+    // scripts/onboarding-advance.sh BEFORE the session is spawned; the
+    // chat surface presents that script's stdout verbatim. If the caller
+    // supplied `resumePrompt`, it is quoted here as `<resume-prompt-shown>`
+    // so the agent has the operator-visible context for the first reply
+    // without needing to derive it from the SKILL.md from scratch.
+    const lines = [`<onboarding-state currentStep="${stepAttr}" resumeStep="${resumeStep}">`];
+    if (resumePrompt && resumePrompt.trim()) {
+        lines.push('<resume-prompt-shown>');
+        lines.push(resumePrompt.trimEnd());
+        lines.push('</resume-prompt-shown>');
+    }
+    lines.push(`</onboarding-state>`);
+    return lines.join('\n');
 }
-function renderUnreachableBlock() {
-    return [
-        `<onboarding-state currentStep="unknown" graphUnreachable="true">`,
-        `Neo4j is unreachable, so onboarding state cannot be read. Do not assume onboarding is complete. Tell the operator the graph is unreachable, name the symptom in one line, and stop — do not improvise an onboarding flow without state, and do not silently skip the step the operator was on.`,
-        `</onboarding-state>`,
-    ].join('\n');
+function renderUnreachableBlock(resumePrompt) {
+    // Task 066 — state-only, no imperatives. Agent reads
+    // `graphUnreachable="true"` plus the optional resume-prompt-shown
+    // content; how to relay the situation to the operator is the agent's
+    // judgement, anchored on the IDENTITY contract rather than a
+    // per-session directive.
+    const lines = [`<onboarding-state currentStep="unknown" graphUnreachable="true">`];
+    if (resumePrompt && resumePrompt.trim()) {
+        lines.push('<resume-prompt-shown>');
+        lines.push(resumePrompt.trimEnd());
+        lines.push('</resume-prompt-shown>');
+    }
+    lines.push(`</onboarding-state>`);
+    return lines.join('\n');
 }
 //# sourceMappingURL=system-prompt.js.map

package/payload/platform/services/claude-session-manager/dist/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,4EAA4E;AAC5E,EAAE;AACF,2EAA2E;AAC3E,oEAAoE;AACpE,mDAAmD;AACnD,6EAA6E;AAC7E,4EAA4E;AAC5E,4DAA4D;AAC5D,+CAA+C;AAC/C,6EAA6E;AAC7E,6EAA6E;AAC7E,2EAA2E;AAC3E,sEAAsE;AACtE,mEAAmE;AACnE,EAAE;AACF,uEAAuE;AACvE,6EAA6E;AAC7E,0DAA0D;AAC1D,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,qEAAqE;AAoBrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAA,CAAC,mCAAmC;AAEtF,MAAM,UAAU,yBAAyB,CACvC,IAAiB,EACjB,UAA8B;IAE9B,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAA;IAC3D,MAAM,QAAQ,GAAa;QACzB,QAAQ;QACR,aAAa,IAAI,CAAC,QAAQ,EAAE;QAC5B,aAAa,IAAI,CAAC,OAAO,EAAE;QAC3B,cAAc,IAAI,CAAC,QAAQ,EAAE;QAC7B,eAAe,UAAU,EAAE;QAC3B,SAAS;QACT,sBAAsB;QACtB,maAAma;QACna,uBAAuB;KACxB,CAAA;IACD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QACvD,IAAI,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC;AAWD;;;;yFAIyF;AACzF,MAAM,UAAU,qBAAqB,CAAC,IAAmB;IACvD,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAA;IACxE,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;IAC/D,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAA;AACpE,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB;IAChD,MAAM,QAAQ,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAClE,MAAM,UAAU,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAA;IACxD,8EAA8E;IAC9E,+DAA+D;IAC/D,yEAAyE;IACzE,iEAAiE;IACjE,yEAAyE;IACzE,sEAAsE;IACtE,oCAAoC;IACpC,OAAO;QACL,kCAAkC,QAAQ,iBAAiB,UAAU,IAAI;QACzE,oKAAoK,UAAU,oQAAoQ;QAClb,qBAAqB;KACtB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO;QACL,kEAAkE;QAClE,gSAAgS;QAChS,qBAAqB;KACtB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"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"}

package/payload/platform/services/claude-session-manager/scripts/onboarding-advance.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# onboarding-advance.sh — deterministic resume-prompt resolver. Task 066.
+#
+# Maps a current onboarding step (read from Neo4j by the route that invoked
+# this script) to the operator-visible markdown prompt for the next
+# incomplete step. Emits one stderr log line, writes the prompt to stdout,
+# exits 0 on success.
+#
+# Contract:
+#   $1  accountId               UUID, used in the stderr log line
+#   $2  currentStep              integer (-1, 0..9), null sentinel, or 'null'
+#
+# Output:
+#   stdout: operator-visible markdown prompt (verbatim from prompts/step-N.md)
+#   stderr: single line "[onboarding-state] script-advance step=<N> sender=<id>"
+#   exit 0
+#
+# The route at platform/ui/server/routes/admin/claude-sessions.ts persists
+# stdout as the first assistant-role message of the new session, then
+# spawns the PTY without an initialMessage. The chat surface presents the
+# script's output verbatim; the agent's first LLM turn fires only after the
+# operator types their next reply, by which point onboarding context lives
+# in the conversation history.
+
+set -euo pipefail
+
+ACCOUNT_ID="${1:?accountId required}"
+CURRENT_STEP="${2:?currentStep required}"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROMPT_DIR="$SCRIPT_DIR/onboarding-prompts"
+
+case "$CURRENT_STEP" in
+  null|unreachable)
+    RESUME="unreachable"
+    ;;
+  -1)
+    RESUME="0"
+    ;;
+  9)
+    RESUME="complete"
+    ;;
+  0|1|2|3|4|5|6|7|8)
+    RESUME="$((CURRENT_STEP + 1))"
+    ;;
+  *)
+    printf '[onboarding-state] script-advance step=invalid sender=%s\n' "$ACCOUNT_ID" >&2
+    echo "Onboarding step value is not in the expected range. Tell the operator the state is corrupt and stop." >&2
+    exit 64
+    ;;
+esac
+
+PROMPT_FILE="$PROMPT_DIR/step-$RESUME.md"
+if [ ! -f "$PROMPT_FILE" ]; then
+  printf '[onboarding-state] script-advance step=missing-template sender=%s\n' "$ACCOUNT_ID" >&2
+  echo "Resume-prompt template missing for step $RESUME." >&2
+  exit 65
+fi
+
+cat "$PROMPT_FILE"
+printf '[onboarding-state] script-advance step=%s sender=%s\n' "$RESUME" "$ACCOUNT_ID" >&2

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-0.md

@@ -0,0 +1,5 @@
+Onboarding is at step 0 — we have not started yet.
+
+The first step is plugin selection. The other steps cover WiFi, output style, thinking view, timezone, admin personality, optional Cloudflare remote access, optional public-agent API key, and persona / business profile.
+
+Reply `start` to begin, or ask any question about what onboarding will cover.

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-1.md

@@ -0,0 +1,3 @@
+Resuming onboarding at step 1 — plugin selection.
+
+Reply `list` to see the plugins available on this brand, grouped by category, with their descriptions and which are locked, recommended, or optional. Reply with the plugin names you want to enable (or `skip` to enable none) once the list is in view.

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-2.md

@@ -0,0 +1,3 @@
+Resuming onboarding at step 2 — WiFi setup.
+
+Reply `check wifi` to see whether this device has WiFi hardware and whether it is already connected. If it is, you can keep the current network or switch. If it is not connected, you can scan visible networks and connect, or skip and stay on ethernet.

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-3.md

@@ -0,0 +1,8 @@
+Resuming onboarding at step 3 — output style.
+
+Two choices:
+
+1. `default` — efficient and task-oriented; concise responses without extra explanation.
+2. `explanatory` — adds educational insights between steps; useful when you want to understand what the agent is doing.
+
+Reply with the number or the value.

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-4.md

@@ -0,0 +1,9 @@
+Resuming onboarding at step 4 — thinking view.
+
+Three choices:
+
+1. `default` — thinking visible: reasoning expanded, tool details collapsed.
+2. `expanded` — everything visible: all reasoning and tool details expanded.
+3. `collapsed` — responses only: all reasoning and tool details collapsed.
+
+Reply with the number or the value.

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-5.md

@@ -0,0 +1,3 @@
+Resuming onboarding at step 5 — timezone confirmation.
+
+Reply `show timezone` to see the auto-detected timezone plus common alternatives. You can confirm the auto-detected value, pick from the list, or supply your own IANA identifier (for example `Asia/Tokyo`).

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-6.md

@@ -0,0 +1,5 @@
+Resuming onboarding at step 6 — admin agent personality.
+
+This step writes the agent's tone, working style, and language preferences to `agents/admin/SOUL.md`. Business identity (services, FAQs, addresses) belongs in step 9 — keep this step to personality.
+
+Reply with how you want the agent to sound (formal, casual, warm, blunt) and how you want it to collaborate (proactive vs. wait-for-instruction, terse vs. explanatory). The agent will compose a draft, show it to you, and only save once you approve.

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-7.md

@@ -0,0 +1,5 @@
+Resuming onboarding at step 7 — Cloudflare remote access.
+
+This step connects the platform to a custom domain so you and your customers can reach it from anywhere. Without it, the platform stays local-network-only — WhatsApp, Telegram, and email still work without a tunnel.
+
+Reply `yes` to set it up now (you will need a Cloudflare account and a domain), or `skip` to leave remote access for later.

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-8.md

@@ -0,0 +1,5 @@
+Resuming onboarding at step 8 — Anthropic API key.
+
+The public-facing agent uses the Anthropic API directly, so visitors can chat with the business through the public hostname. Without a key, visitors cannot chat. This step is optional.
+
+Reply `yes` to set it up now, or `skip` to leave it for later. If you set it up, you will sign in to the Anthropic Console in a browser; the agent does not handle credentials.

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-9.md

@@ -0,0 +1,8 @@
+Resuming onboarding at step 9 — operator persona and profile bootstrap.
+
+Two persona modes:
+
+1. `personal` — just for me. I am not setting this up for a business; the platform is my personal operations agent.
+2. `business-owner` — for my business. I am the owner / operator and the platform is the operations agent for my company.
+
+Reply with the number, the value, or the label.

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-complete.md

@@ -0,0 +1,3 @@
+Onboarding is already complete.
+
+Everything configured during onboarding — plugins, WiFi, output style, thinking view, timezone, personality, and the business profile — can be changed at any time through conversation. What would you like to do?

package/payload/platform/services/claude-session-manager/scripts/onboarding-prompts/step-unreachable.md

@@ -0,0 +1,3 @@
+Neo4j is unreachable, so the onboarding state cannot be read.
+
+Wait a few seconds and try the banner again. If the problem persists, ask the agent to run `system-status` and report what it sees.

package/payload/platform/templates/agents/public/IDENTITY.md

@@ -53,4 +53,4 @@ When you need to clarify intent before acting, follow two rules.
 
 Run `skill-load skillName=plainly` on the first text-producing turn of every session. Apply the AI-tells strip and the recursive plain-English rule to every reply you return to the visitor before emitting it — this is a prime-directive prerogative that overrides every other formatting preference. Customers are the highest-stakes audience this platform serves; plain English is not a polish step, it is the contract.
 
-The skill applies to prose returned to the visitor and to text content passed through `render-component`. It does NOT apply to the structured arguments you pass into `render-component` (component name, option lists, IDs) — those are agent-to-machine payloads.
+The skill applies to every prose payload returned to the visitor. It does NOT apply to structured tool arguments (IDs, option values, schema field names) — those are agent-to-machine payloads.

package/payload/platform/templates/specialists/agents/content-producer.md

@@ -3,7 +3,7 @@ name: content-producer
 description: "Visual production and static-site hosting. Reads from the populated graph to produce visual artifacts (image generation, PDF rendering, component delivery) and hosts already-prepared static sites by extracting attached archives via unzip-attachment then placing the tree under <accountDir>/sites/<slug>/ via publish-site. Delegate for: generating images, saving rendered pages as PDF, or any 'host this website' / 'publish this site' / 'put this online' intent carrying an HTML+assets archive. Not document ingestion: graph ingestion of any kind routes to specialists:database-operator. Static-site zips are extracted to disk for publication, never written to the graph."
 summary: "Produces visual output from your graph: generates images, renders pages to PDF, and hosts static websites you upload as a zip."
 model: claude-sonnet-4-6
-tools: Bash, mcp__memory__memory-search, mcp__replicate__image-generate, mcp__plugin_playwright_playwright__browser_navigate, mcp__plugin_playwright_playwright__browser_snapshot, mcp__plugin_playwright_playwright__browser_take_screenshot, mcp__plugin_playwright_playwright__browser_pdf_save, mcp__admin__render-component, mcp__admin__file-attach, mcp__admin__plugin-read, mcp__admin__public-hostname
+tools: Bash, mcp__memory__memory-search, mcp__replicate__image-generate, mcp__plugin_playwright_playwright__browser_navigate, mcp__plugin_playwright_playwright__browser_snapshot, mcp__plugin_playwright_playwright__browser_take_screenshot, mcp__plugin_playwright_playwright__browser_pdf_save, mcp__admin__file-attach, mcp__admin__plugin-read, mcp__admin__public-hostname
 ---
 
 # Content Producer
@@ -28,7 +28,7 @@ Three models via `image-generate`. Pick by output need: `recraft-v4` for design-
 
 ## PDF output
 
-Generate the HTML, deliver it via `render-component`, capture with `browser_pdf_save`. For A4 print, load `skill-load skillName=a4-print-documents`: the skill carries the print-CSS constraints (page margins, glassmorphism fallback, page-break rules, dark-background colour-adjust). Do not paraphrase those rules; load and follow.
+Generate the HTML, navigate the Playwright browser to it, and capture with `browser_pdf_save`. For A4 print, load `skill-load skillName=a4-print-documents`: the skill carries the print-CSS constraints (page margins, glassmorphism fallback, page-break rules, dark-background colour-adjust). Do not paraphrase those rules; load and follow.
 
 `file://` URLs are rewritten transparently by the `playwright-file-guard` PreToolUse hook. Pass them directly to `browser_navigate`.
 
@@ -40,7 +40,7 @@ Confirm the slug with the operator before publishing. The slug is one or more `/
 
 ## File delivery
 
-Use `file-attach` to make generated files downloadable, with `render-component` component `file-attachment` for the chat surface.
+Use `file-attach` to make generated files downloadable. The tool returns the operator-visible metadata (filename, size, attachment URL); quote that metadata back in plain chat so the operator can see the download.
 
 ## Optional capabilities
 

package/payload/platform/templates/specialists/agents/personal-assistant.md

@@ -3,7 +3,7 @@ name: personal-assistant
 description: "Your personal assistant. Scheduling, platform administration, messaging channels (Telegram, WhatsApp, email, Outlook), system health, Cloudflare tunnel setup, and browser automation. Delegate when a task involves managing your calendar, configuring the platform, operating messaging channels, setting up a tunnel or domain, or completing interactive browser tasks."
 summary: "Handles the operational tasks you'd give a personal assistant: scheduling meetings, managing your platform settings, connecting messaging channels, and completing browser-based tasks on your behalf."
 model: claude-sonnet-4-6
-tools: mcp__admin__system-status, mcp__admin__brand-settings, mcp__admin__account-manage, mcp__admin__account-update, mcp__admin__logs-read, mcp__admin__plugin-read, mcp__admin__api-key-store, mcp__admin__api-key-verify, mcp__admin__render-component, mcp__admin__file-attach, mcp__admin__wifi, mcp__contacts__contact-create, mcp__contacts__contact-lookup, mcp__contacts__contact-update, mcp__contacts__contact-delete, mcp__contacts__contact-list, mcp__contacts__contact-export, mcp__contacts__contact-erase, mcp__contacts__group-create, mcp__contacts__group-manage, mcp__telegram__message, mcp__telegram__message-history, mcp__telegram__telegram-webhook-register, mcp__whatsapp__whatsapp-login-start, mcp__whatsapp__whatsapp-login-wait, mcp__whatsapp__whatsapp-status, mcp__whatsapp__whatsapp-disconnect, mcp__whatsapp__whatsapp-send, mcp__whatsapp__whatsapp-send-document, mcp__whatsapp__whatsapp-config, mcp__whatsapp__whatsapp-activity, mcp__whatsapp__whatsapp-conversations, mcp__whatsapp__whatsapp-messages, mcp__whatsapp__whatsapp-conversation-graph-state, mcp__whatsapp__whatsapp-group-info, mcp__email__email-setup, mcp__email__email-read, mcp__email__email-send, mcp__email__email-reply, mcp__email__email-search, mcp__email__email-graph-query, mcp__email__email-otp-extract, mcp__email__email-status, mcp__email__email-auto-respond-config, mcp__outlook__outlook-account-register, mcp__outlook__outlook-mail-list, mcp__outlook__outlook-mail-search, mcp__outlook__outlook-calendar-list, mcp__outlook__outlook-calendar-event, mcp__outlook__outlook-contacts-list, mcp__outlook__outlook-mailbox-info, mcp__scheduling__schedule-event, mcp__scheduling__schedule-list, mcp__scheduling__schedule-get, mcp__scheduling__schedule-update, mcp__scheduling__schedule-cancel, mcp__scheduling__schedule-export-ics, mcp__scheduling__schedule-import-ics, mcp__scheduling__time-resolve, mcp__memory__memory-search, mcp__memory__profile-update, mcp__plugin_playwright_playwright__browser_navigate, mcp__plugin_playwright_playwright__browser_navigate_back, mcp__plugin_playwright_playwright__browser_snapshot, mcp__plugin_playwright_playwright__browser_click, mcp__plugin_playwright_playwright__browser_fill, mcp__plugin_playwright_playwright__browser_fill_form, mcp__plugin_playwright_playwright__browser_type, mcp__plugin_playwright_playwright__browser_press_key, mcp__plugin_playwright_playwright__browser_hover, mcp__plugin_playwright_playwright__browser_select_option, mcp__plugin_playwright_playwright__browser_wait_for, mcp__plugin_playwright_playwright__browser_handle_dialog, mcp__plugin_playwright_playwright__browser_evaluate, mcp__plugin_playwright_playwright__browser_console_messages, mcp__plugin_playwright_playwright__browser_resize, mcp__plugin_playwright_playwright__browser_tabs, mcp__plugin_playwright_playwright__browser_close
+tools: mcp__admin__system-status, mcp__admin__brand-settings, mcp__admin__account-manage, mcp__admin__account-update, mcp__admin__logs-read, mcp__admin__plugin-read, mcp__admin__api-key-store, mcp__admin__api-key-verify, mcp__admin__file-attach, mcp__admin__wifi, mcp__contacts__contact-create, mcp__contacts__contact-lookup, mcp__contacts__contact-update, mcp__contacts__contact-delete, mcp__contacts__contact-list, mcp__contacts__contact-export, mcp__contacts__contact-erase, mcp__contacts__group-create, mcp__contacts__group-manage, mcp__telegram__message, mcp__telegram__message-history, mcp__telegram__telegram-webhook-register, mcp__whatsapp__whatsapp-login-start, mcp__whatsapp__whatsapp-login-wait, mcp__whatsapp__whatsapp-status, mcp__whatsapp__whatsapp-disconnect, mcp__whatsapp__whatsapp-send, mcp__whatsapp__whatsapp-send-document, mcp__whatsapp__whatsapp-config, mcp__whatsapp__whatsapp-activity, mcp__whatsapp__whatsapp-conversations, mcp__whatsapp__whatsapp-messages, mcp__whatsapp__whatsapp-conversation-graph-state, mcp__whatsapp__whatsapp-group-info, mcp__email__email-setup, mcp__email__email-read, mcp__email__email-send, mcp__email__email-reply, mcp__email__email-search, mcp__email__email-graph-query, mcp__email__email-otp-extract, mcp__email__email-status, mcp__email__email-auto-respond-config, mcp__outlook__outlook-account-register, mcp__outlook__outlook-mail-list, mcp__outlook__outlook-mail-search, mcp__outlook__outlook-calendar-list, mcp__outlook__outlook-calendar-event, mcp__outlook__outlook-contacts-list, mcp__outlook__outlook-mailbox-info, mcp__scheduling__schedule-event, mcp__scheduling__schedule-list, mcp__scheduling__schedule-get, mcp__scheduling__schedule-update, mcp__scheduling__schedule-cancel, mcp__scheduling__schedule-export-ics, mcp__scheduling__schedule-import-ics, mcp__scheduling__time-resolve, mcp__memory__memory-search, mcp__memory__profile-update, mcp__plugin_playwright_playwright__browser_navigate, mcp__plugin_playwright_playwright__browser_navigate_back, mcp__plugin_playwright_playwright__browser_snapshot, mcp__plugin_playwright_playwright__browser_click, mcp__plugin_playwright_playwright__browser_fill, mcp__plugin_playwright_playwright__browser_fill_form, mcp__plugin_playwright_playwright__browser_type, mcp__plugin_playwright_playwright__browser_press_key, mcp__plugin_playwright_playwright__browser_hover, mcp__plugin_playwright_playwright__browser_select_option, mcp__plugin_playwright_playwright__browser_wait_for, mcp__plugin_playwright_playwright__browser_handle_dialog, mcp__plugin_playwright_playwright__browser_evaluate, mcp__plugin_playwright_playwright__browser_console_messages, mcp__plugin_playwright_playwright__browser_resize, mcp__plugin_playwright_playwright__browser_tabs, mcp__plugin_playwright_playwright__browser_close
 ---
 
 # Personal Assistant
@@ -40,7 +40,7 @@ Each domain has a small set of tools and, where it exists, a skill that drives t
 
 **Browser is visible.** Playwright is rendered to the operator's VNC viewer. They see every navigation, every fill, every click. After `browser_navigate`, call `browser_tabs` with `action: "select"` on the current tab index so the VNC viewer shows the page you just opened. Prefer `browser_snapshot` (accessibility tree with `ref` IDs) over `browser_take_screenshot`; take a screenshot only when you need to verify layout, colour, image, or canvas content. Use `browser_fill_form` over repeated `browser_fill`. Use `browser_evaluate` for state checks. Check `browser_console_messages` when something behaves unexpectedly. Dismiss cookie consent before the main task. Report CAPTCHA or bot detection as a blocker; do not try to solve it.
 
-**Anthropic API key acquisition is cookie-based.** Show the browser via `render-component browser-viewer`. Credits must exist before key creation; keys on zero-balance accounts are permanently rejected. The operator signs in themselves. Never fill credentials yourself. After creation, store via `api-key-store` and verify via `api-key-verify`.
+**Anthropic API key acquisition is cookie-based.** Tell the operator the Anthropic Console will appear in the VNC browser already mounted in the chat (no extra tool call). Credits must exist before key creation; keys on zero-balance accounts are permanently rejected. The operator signs in themselves. Never fill credentials yourself. After creation, store via `api-key-store` and verify via `api-key-verify`.
 
 ## Optional capabilities
 

package/payload/premium-plugins/teaching/PLUGIN.md

@@ -40,7 +40,8 @@ The user wants to:
 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
-- `render-component` — present structured choices during context gathering
+
+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
 

package/payload/premium-plugins/writer-craft/PLUGIN.md

@@ -66,7 +66,8 @@ The manuscript-reviewer agent operates in its own context window with file tools
 
 No MCP server. Skills operate via existing platform tools:
 - `memory-search` — retrieve writing-related content from the knowledge base
-- `render-component` — present structured choices during interactions
+
+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