@rubytech/create-realagent 1.0.608 → 1.0.610

package/package.json

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

package/payload/platform/plugins/contacts/mcp/dist/lib/resolve-person.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-person.d.ts","sourceRoot":"","sources":["../../src/lib/resolve-person.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,MAAM,GAChB,aAAa,CAsBf"}
+{"version":3,"file":"resolve-person.d.ts","sourceRoot":"","sources":["../../src/lib/resolve-person.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,MAAM,GAChB,aAAa,CA2Bf"}

package/payload/platform/plugins/contacts/mcp/dist/lib/resolve-person.js

@@ -16,8 +16,14 @@ export function resolvePersonMatch(identifier, accountId) {
     const queryParams = { accountId };
     let matchClause;
     if (nodeId) {
-        matchClause = `MATCH (p:Person) WHERE elementId(p) = $nodeId AND p.accountId = $accountId`;
-        queryParams.nodeId = nodeId;
+        if (nodeId.includes(":")) {
+            matchClause = `MATCH (p:Person) WHERE elementId(p) = $nodeId AND p.accountId = $accountId`;
+            queryParams.nodeId = nodeId;
+        }
+        else {
+            matchClause = `MATCH (p:Person) WHERE id(p) = $nodeId AND p.accountId = $accountId`;
+            queryParams.nodeId = parseInt(nodeId, 10);
+        }
     }
     else if (email) {
         matchClause = `MATCH (p:Person {email: $email, accountId: $accountId})`;

package/payload/platform/plugins/contacts/mcp/dist/lib/resolve-person.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-person.js","sourceRoot":"","sources":["../../src/lib/resolve-person.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,MAAM,UAAU,kBAAkB,CAChC,UAA4B,EAC5B,SAAiB;IAEjB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;IAEhD,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,WAAW,GAA4B,EAAE,SAAS,EAAE,CAAC;IAE3D,IAAI,WAAmB,CAAC;IACxB,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,GAAG,4EAA4E,CAAC;QAC3F,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC;IAC9B,CAAC;SAAM,IAAI,KAAK,EAAE,CAAC;QACjB,WAAW,GAAG,yDAAyD,CAAC;QACxE,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,iEAAiE,CAAC;QAChF,WAAW,CAAC,SAAS,GAAG,SAAU,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AACtC,CAAC"}
+{"version":3,"file":"resolve-person.js","sourceRoot":"","sources":["../../src/lib/resolve-person.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,MAAM,UAAU,kBAAkB,CAChC,UAA4B,EAC5B,SAAiB;IAEjB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;IAEhD,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,WAAW,GAA4B,EAAE,SAAS,EAAE,CAAC;IAE3D,IAAI,WAAmB,CAAC;IACxB,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,WAAW,GAAG,4EAA4E,CAAC;YAC3F,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,qEAAqE,CAAC;YACpF,WAAW,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,EAAE,CAAC;QACjB,WAAW,GAAG,yDAAyD,CAAC;QACxE,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,iEAAiE,CAAC;QAChF,WAAW,CAAC,SAAS,GAAG,SAAU,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AACtC,CAAC"}

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

@@ -48,13 +48,13 @@ When using WebSearch directly (not via the researcher specialist), the same disc
 
 - Always Read a file before using Edit or overwriting with Write. Writing a new file does not require a prior Read.
 - Your working directory is `$ACCOUNT_DIR` — your entire filesystem scope. Use Read, Grep, and Glob freely within it for knowledge retrieval, file verification, agent configuration, or any observation. Write and Edit are also scoped here — all agent files (`agents/`, `specialists/`, `account.json`) live in this directory. Never write to `$PLATFORM_ROOT/` or paths outside `$ACCOUNT_DIR`.
-- MCP tool schemas are deferred. Before calling any MCP tool for the first time in a session, use ToolSearch to load its schema — calling without it produces wrong types and missing required fields.
+- MCP tool schemas are deferred. Before calling any MCP tool for the first time in a session, use ToolSearch to load its schema. Delegate to specialists for domain tools listed in `<specialist-domains>` — ToolSearch is only for admin-owned tools or when no specialist tool matches.
 
 ## Tool Routing
 
 Plugins provide domain-specific tools that query their own data stores directly. `memory-search` is a general-purpose semantic search across the entire knowledge graph — it finds nodes by vector similarity, which means results are ranked by semantic closeness to the query, not by domain relevance. A query containing the word "email" will surface product documentation *about* email features before it surfaces actual Email nodes whose content is unrelated to the query wording.
 
-When the user's intent maps to a specific plugin's domain, use that plugin's tools — not `memory-search`. The `<plugin-manifest>` groups tools by plugin and describes each plugin's purpose and retrieval paths. Match user intent to the plugin domain first; fall back to `memory-search` only when the query genuinely spans multiple domains or no dedicated tool exists.
+When the user's intent maps to a specific plugin's domain, use that plugin's tools — not `memory-search`. The `<plugin-manifest>` groups tools by plugin and describes each plugin's purpose and retrieval paths. The `<specialist-domains>` block within it lists every specialist-owned tool by name. Match user intent to a tool in these registries first; fall back to `memory-search` only when the query genuinely spans multiple domains or no tool in the manifest matches the intent.
 
 For prioritisation requests — "who should I call first", "which tasks are most urgent", "rank these by risk" — use `memory-rank` instead of reasoning over raw `memory-search` results. It retrieves the same candidate pool and returns an ordered list with per-item reasoning already synthesised, keeping the response grounded in properties and relationships rather than owner-supplied prose. For informal prioritisation in the middle of a wider conversation, reasoning directly over `memory-search` results remains fine.
 
@@ -182,8 +182,11 @@ Tasks live in the graph — not in files. The tasks plugin manages them.
 
 At session start, read `agents/admin/AGENTS.md`. This file lists installed specialists and when to use each. If the file is absent or empty, handle all requests directly.
 
-- **Single-tool calls** — handle directly. No delegation overhead for simple lookups.
-- **Multi-step sequences (3+ tool calls within one domain)** — delegate to the matching specialist using the Agent tool with `subagent_type: "specialists:{name}"`.
+The `<specialist-domains>` block lists every specialist-owned tool with a description. This is your primary routing table. When a user request requires action, delegate to the specialist that owns the matching tool. ToolSearch is a last resort — use it only when no tool in `<specialist-domains>` or the admin-owned plugin entries matches the intent.
+
+- **Single-tool call** — delegate to the specialist that owns the tool. The specialist has domain knowledge and will execute correctly.
+- **Multi-step sequence** — delegate to the specialist.
+- **No matching tool in the manifest** — only then use ToolSearch or memory-search.
 - After a specialist run, synthesise its results into the final response to the user.
 - Retain all task management. Specialists do not create, update, or complete tasks.
 - To install or remove specialists, load the specialist management skill via `plugin-read` (find its path in the manifest under `admin`). Keep `agents/admin/AGENTS.md` in sync.

package/payload/server/server.js

@@ -6814,7 +6814,7 @@ async function buildPluginManifest(enabledPlugins) {
       specialistGroups.set(specialist, existing);
     }
   }
-  const specialistToolSummary = /* @__PURE__ */ new Map();
+  const specialistToolDetails = /* @__PURE__ */ new Map();
   let specialistMcpCount = 0;
   for (let i = 0; i < specialistPlugins.length; i++) {
     const { dir, parsed } = specialistPlugins[i];
@@ -6822,25 +6822,28 @@ async function buildPluginManifest(enabledPlugins) {
     if (mcpTools.length > 0) {
       specialistMcpCount++;
       const hiddenSet = new Set(parsed.hidden);
-      const toolNames = mcpTools.filter((t) => !hiddenSet.has(t.name)).map((t) => t.name);
-      totalTools += toolNames.length;
-      if (toolNames.length > 0) {
+      const visibleTools = mcpTools.filter((t) => !hiddenSet.has(t.name));
+      totalTools += visibleTools.length;
+      if (visibleTools.length > 0) {
         const desc = parsed.description ? parsed.description.split(/\.\s/)[0].replace(/\.$/, "") : "";
-        specialistToolSummary.set(
-          dir,
-          desc ? `${desc}: ${toolNames.join(", ")}` : toolNames.join(", ")
-        );
+        specialistToolDetails.set(dir, { desc, tools: visibleTools });
       }
     }
   }
   if (specialistGroups.size > 0) {
     lines.push("\n<specialist-domains>");
-    lines.push("Specialist subagents own these domains. Domain knowledge is embedded in each specialist's system prompt. Delegate by matching user intent to the specialist. Single-tool calls within these domains can be handled directly via ToolSearch.");
+    lines.push("Specialist subagents own these domains. Match user intent to a tool below, then delegate to the specialist or use ToolSearch to load the schema and call directly. Only fall back to memory-search when no tool here matches.");
     for (const [specialist, plugins] of specialistGroups) {
-      lines.push(`${specialist}: ${plugins.join(", ")}`);
+      lines.push(`
+${specialist}: ${plugins.join(", ")}`);
       for (const plugin of plugins) {
-        const summary = specialistToolSummary.get(plugin);
-        if (summary) lines.push(`  ${plugin} \u2014 ${summary}`);
+        const details = specialistToolDetails.get(plugin);
+        if (details) {
+          for (const tool of details.tools) {
+            const toolDesc = tool.description ? tool.description.split(/\.\s/)[0].replace(/\.$/, "") : "";
+            lines.push(toolDesc ? `  ${tool.name} \u2014 ${toolDesc}` : `  ${tool.name}`);
+          }
+        }
       }
     }
     lines.push("</specialist-domains>");
@@ -9783,7 +9786,7 @@ Current session key: ${sessionKey}` : systemPromptBase;
     if (gatewayResult.searchQuery) {
       gwParts.push(`  <search-query>${xmlEsc(gatewayResult.searchQuery)}</search-query>`);
     }
-    if (gatewayResult.screening.promptInjectionRisk) {
+    if (gatewayResult.screening.promptInjectionRisk && agentType !== "admin") {
       gwParts.push(`  <screening verdict="${xmlEsc(gatewayResult.screening.verdict)}" promptInjection="true">${xmlEsc(gatewayResult.screening.reason)}</screening>`);
     }
     if (gatewayResult.language !== "en") {