myaiforone 1.0.0

package/server/mcp-server/lib/api-client.ts

@@ -0,0 +1,366 @@
+/**
+ * MyAIforOne API Client
+ * Wraps all REST API endpoints for use by MCP tools.
+ */
+
+const BASE_URL = process.env.MYAGENT_API_URL || "http://localhost:4888";
+
+interface RequestOptions {
+  method?: string;
+  body?: any;
+  query?: Record<string, string | number | undefined>;
+}
+
+async function api(path: string, opts: RequestOptions = {}): Promise<any> {
+  let url = `${BASE_URL}${path}`;
+  if (opts.query) {
+    const params = new URLSearchParams();
+    for (const [k, v] of Object.entries(opts.query)) {
+      if (v !== undefined && v !== "") params.set(k, String(v));
+    }
+    const qs = params.toString();
+    if (qs) url += `?${qs}`;
+  }
+
+  const headers: Record<string, string> = {};
+  if (opts.body) headers["Content-Type"] = "application/json";
+
+  const res = await fetch(url, {
+    method: opts.method || "GET",
+    headers,
+    body: opts.body ? JSON.stringify(opts.body) : undefined,
+  });
+
+  const text = await res.text();
+  try { return JSON.parse(text); } catch { return text; }
+}
+
+// ─── Dashboard & Health ───────────────────────────────────────────
+export const health = () => api("/health");
+export const dashboard = () => api("/api/dashboard");
+export const agentRegistry = () => api("/api/agent-registry");
+
+// ─── Agents ───────────────────────────────────────────────────────
+export const listAgents = (org?: string) => api("/api/agents", { query: { org } });
+export const getAgent = (id: string) => api(`/api/agents/${id}`);
+export const getAgentInstructions = (id: string) => api(`/api/agents/${id}/instructions`);
+export const createAgent = (body: any) => api("/api/agents", { method: "POST", body });
+export const updateAgent = (id: string, body: any) => api(`/api/agents/${id}`, { method: "PUT", body });
+export const deleteAgent = (id: string, confirmAlias: string) =>
+  api(`/api/agents/${id}`, { method: "DELETE", body: { confirmAlias } });
+export const recoverAgent = (id: string, userText?: string, response?: string) =>
+  api(`/api/agents/${id}/recover`, { method: "POST", body: { userText: userText || "Session recovery triggered via MCP tool", response } });
+
+// ─── Chat ─────────────────────────────────────────────────────────
+export const sendMessage = (agentId: string, text: string, accountOverride?: string) =>
+  api(`/api/chat/${agentId}`, { method: "POST", body: { text, accountOverride } });
+export const startStream = (agentId: string, text: string, accountOverride?: string) =>
+  api(`/api/chat/${agentId}/stream`, { method: "POST", body: { text, accountOverride } });
+export const stopJob = (jobId: string) => api(`/api/chat/jobs/${jobId}/stop`, { method: "POST" });
+export const delegate = (agentId: string, text: string) =>
+  api("/api/delegate", { method: "POST", body: { agentId, text } });
+
+// ─── Sessions ─────────────────────────────────────────────────────
+export const listSessions = (agentId: string) => api(`/api/agents/${agentId}/sessions`);
+export const resetSession = (agentId: string, senderId?: string) =>
+  api(`/api/agents/${agentId}/sessions/reset`, { method: "POST", body: { senderId } });
+export const deleteSession = (agentId: string, senderId: string) =>
+  api(`/api/agents/${agentId}/sessions/${senderId}`, { method: "DELETE" });
+
+// ─── Named Session Tabs ────────────────────────────────────────────
+export const createSessionTab = (agentId: string, tabId: string, label: string, targetAgentId?: string) =>
+  api(`/api/agents/${agentId}/session-tabs`, { method: "POST", body: { tabId, label, ...(targetAgentId ? { targetAgentId } : {}) } });
+export const listSessionTabs = (agentId: string) => api(`/api/agents/${agentId}/session-tabs`);
+export const getSessionTabHistory = (agentId: string, tabId: string) =>
+  api(`/api/agents/${agentId}/session-tabs/${tabId}/history`);
+export const renameSessionTab = (agentId: string, tabId: string, label: string) =>
+  api(`/api/agents/${agentId}/session-tabs/${tabId}`, { method: "PUT", body: { label } });
+export const deleteSessionTab = (agentId: string, tabId: string) =>
+  api(`/api/agents/${agentId}/session-tabs/${tabId}`, { method: "DELETE" });
+
+// ─── Model ────────────────────────────────────────────────────────
+export const getModel = (agentId: string) => api(`/api/agents/${agentId}/model`);
+export const setModel = (agentId: string, model: string) =>
+  api(`/api/agents/${agentId}/model`, { method: "PUT", body: { model } });
+export const clearModel = (agentId: string) =>
+  api(`/api/agents/${agentId}/model`, { method: "DELETE" });
+
+// ─── Cost ─────────────────────────────────────────────────────────
+export const getAgentCost = (agentId: string) => api(`/api/agents/${agentId}/cost`);
+export const getAllCosts = () => api("/api/cost/all");
+
+// ─── Skills ───────────────────────────────────────────────────────
+export const getAgentSkills = (agentId: string) => api(`/api/agents/${agentId}/skills`);
+export const getOrgSkills = (orgName: string) => api(`/api/skills/org/${orgName}`);
+
+// ─── Tasks ────────────────────────────────────────────────────────
+export const listTasks = (agentId: string) => api(`/api/agents/${agentId}/tasks`);
+export const taskStats = (agentId: string) => api(`/api/agents/${agentId}/tasks/stats`);
+export const createTask = (agentId: string, body: any) =>
+  api(`/api/agents/${agentId}/tasks`, { method: "POST", body });
+export const updateTask = (agentId: string, taskId: string, body: any) =>
+  api(`/api/agents/${agentId}/tasks/${taskId}`, { method: "PUT", body });
+export const deleteTask = (agentId: string, taskId: string) =>
+  api(`/api/agents/${agentId}/tasks/${taskId}`, { method: "DELETE" });
+export const allTasks = () => api("/api/tasks/all");
+
+// ─── Automations ──────────────────────────────────────────────────
+export const listAutomations = () => api("/api/automations");
+export const createGoal = (agentId: string, body: any) =>
+  api(`/api/agents/${agentId}/goals`, { method: "POST", body });
+export const toggleGoal = (agentId: string, goalId: string) =>
+  api(`/api/agents/${agentId}/goals/${goalId}/toggle`, { method: "POST" });
+export const triggerGoal = (agentId: string, goalId: string) =>
+  api(`/api/agents/${agentId}/goals/${goalId}/trigger`, { method: "POST" });
+export const goalHistory = (agentId: string, goalId: string) =>
+  api(`/api/agents/${agentId}/goals/${goalId}/history`);
+export const deleteGoal = (agentId: string, goalId: string) =>
+  api(`/api/agents/${agentId}/goals/${goalId}`, { method: "DELETE" });
+export const createCron = (agentId: string, body: any) =>
+  api(`/api/agents/${agentId}/cron`, { method: "POST", body });
+export const toggleCron = (agentId: string, index: number) =>
+  api(`/api/agents/${agentId}/cron/${index}/toggle`, { method: "POST" });
+export const triggerCron = (agentId: string, index: number) =>
+  api(`/api/agents/${agentId}/cron/${index}/trigger`, { method: "POST" });
+export const cronHistory = (agentId: string, index: number) =>
+  api(`/api/agents/${agentId}/cron/${index}/history`);
+export const deleteCron = (agentId: string, index: number) =>
+  api(`/api/agents/${agentId}/cron/${index}`, { method: "DELETE" });
+
+// ─── MCPs ─────────────────────────────────────────────────────────
+export const listMcps = () => api("/api/mcps");
+export const mcpCatalog = () => api("/api/mcp-catalog");
+export const listMcpKeys = (agentId: string) => api(`/api/agents/${agentId}/mcp-keys`);
+export const saveMcpKey = (agentId: string, mcpName: string, envVar: string, value: string) =>
+  api(`/api/agents/${agentId}/mcp-keys`, { method: "POST", body: { mcpName, envVar, value } });
+export const deleteMcpKey = (agentId: string, mcpName: string) =>
+  api(`/api/agents/${agentId}/mcp-keys/${mcpName}`, { method: "DELETE" });
+export const listMcpConnections = (agentId: string) => api(`/api/agents/${agentId}/mcp-connections`);
+export const createMcpConnection = (agentId: string, body: any) =>
+  api(`/api/agents/${agentId}/mcp-connections`, { method: "POST", body });
+export const deleteMcpConnection = (agentId: string, instanceName: string) =>
+  api(`/api/agents/${agentId}/mcp-connections/${instanceName}`, { method: "DELETE" });
+
+// ─── Channels ─────────────────────────────────────────────────────
+export const listChannels = () => api("/api/channels");
+export const updateChannel = (name: string, body: any) =>
+  api(`/api/channels/${name}`, { method: "PUT", body });
+export const addAgentRoute = (channelName: string, body: any) =>
+  api(`/api/channels/${channelName}/agents`, { method: "POST", body });
+export const removeAgentRoute = (channelName: string, agentId: string) =>
+  api(`/api/channels/${channelName}/agents/${agentId}`, { method: "DELETE" });
+export const stickyRouting = () => api("/api/sticky-routing");
+
+// ─── Registry / Marketplace ───────────────────────────────────────
+export const marketplace = (type: string) => api(`/api/marketplace/${type}`);
+export const installMarketplace = (id: string, type: string) =>
+  api("/api/marketplace/install", { method: "POST", body: { id, type } });
+export const assignToAgent = (agentId: string, itemId: string, type: string) =>
+  api("/api/marketplace/assign", { method: "POST", body: { agentIds: [agentId], id: itemId, type } });
+
+// ─── Apps ─────────────────────────────────────────────────────────
+export const listApps = () => api("/api/apps");
+export const createApp = (body: any) => api("/api/apps", { method: "POST", body });
+export const updateApp = (id: string, body: any) => api(`/api/apps/${id}`, { method: "PUT", body });
+export const deleteApp = (id: string) => api(`/api/apps/${id}`, { method: "DELETE" });
+
+// ─── Activity & Logs ──────────────────────────────────────────────
+export const activity = (limit?: number) => api("/api/activity", { query: { limit } });
+export const agentLogs = (agentId: string, limit?: number, offset?: number, search?: string) =>
+  api(`/api/agents/${agentId}/logs`, { query: { limit, offset, search } });
+
+// ─── Memory ───────────────────────────────────────────────────────
+export const agentMemory = (agentId: string, limit?: number) =>
+  api(`/api/agents/${agentId}/memory`, { query: { limit } });
+export const searchMemory = (agentId: string, query: string) =>
+  api(`/api/agents/${agentId}/memory/search`, { method: "POST", body: { query } });
+export const clearMemoryContext = (agentId: string) =>
+  api(`/api/agents/${agentId}/memory/context`, { method: "DELETE" });
+
+// ─── Pairing ──────────────────────────────────────────────────────
+export const listPairing = () => api("/api/pairing");
+export const pairSender = (senderKey: string) =>
+  api("/api/pairing", { method: "POST", body: { senderKey } });
+export const unpairSender = (senderKey: string) =>
+  api(`/api/pairing/${encodeURIComponent(senderKey)}`, { method: "DELETE" });
+
+// ─── Config ───────────────────────────────────────────────────────
+export const listAccounts = () => api("/api/config/accounts");
+export const addAccount = (name: string, path: string) =>
+  api("/api/config/accounts", { method: "POST", body: { name, path } });
+export const deleteAccount = (name: string) =>
+  api(`/api/config/accounts/${encodeURIComponent(name)}`, { method: "DELETE" });
+export const accountStatus = (name: string) =>
+  api(`/api/config/accounts/${encodeURIComponent(name)}/status`);
+export const getServiceConfig = () => api("/api/config/service");
+export const updateServiceConfig = (body: any) =>
+  api("/api/config/service", { method: "PUT", body });
+export const testProvider = (provider: string) =>
+  api("/api/config/provider-test", { method: "POST", body: { provider } });
+
+// ─── Profile ────────────────────────────────────────────────────────
+export const getProfile = () => api("/api/profile");
+export const updateProfile = (body: any) => api("/api/profile", { method: "PUT", body });
+
+// ─── Files ────────────────────────────────────────────────────────
+export const listFiles = (agentId: string) => api(`/api/agents/${agentId}/files`);
+export const downloadFile = (agentId: string, path: string) =>
+  api(`/api/agents/${agentId}/download`, { query: { path } });
+
+// ─── Additional ──────────────────────────────────────────────────
+export const createProject = (agentId: string, name: string) =>
+  api(`/api/agents/${agentId}/projects`, { method: "POST", body: { id: name.toLowerCase().replace(/[^a-z0-9]+/g, "-"), name } });
+
+// ─── Projects (cross-agent initiatives) ─────────────────────────
+export const listProjects = () => api("/api/projects");
+export const getProject = (id: string) => api(`/api/projects/${id}`);
+export const createInitiative = (body: any) =>
+  api("/api/projects", { method: "POST", body });
+export const updateProject = (id: string, body: any) =>
+  api(`/api/projects/${id}`, { method: "PUT", body });
+export const deleteProject = (id: string) =>
+  api(`/api/projects/${id}`, { method: "DELETE" });
+export const linkToProject = (id: string, type: string, value: any) =>
+  api(`/api/projects/${id}/link`, { method: "POST", body: { type, value } });
+export const unlinkFromProject = (id: string, type: string, value: any) =>
+  api(`/api/projects/${id}/unlink`, { method: "POST", body: { type, value } });
+export const getProjectStatus = (id: string) => api(`/api/projects/${id}/status`);
+export const executeProject = (id: string, body?: any) =>
+  api(`/api/projects/${id}/execute`, { method: "POST", body: body || {} });
+export const pauseProject = (id: string) =>
+  api(`/api/projects/${id}/pause`, { method: "POST" });
+export const addMonitoredChat = (channelName: string, chatId: string) =>
+  api(`/api/channels/${channelName}/monitored`, { method: "POST", body: { chatId: Number(chatId) } });
+export const removeMonitoredChat = (channelName: string, chatId: string) =>
+  api(`/api/channels/${channelName}/monitored`, { method: "DELETE", body: { chatId: Number(chatId) } });
+export const scanSkills = (dir?: string) =>
+  api("/api/marketplace/scan-skills", { query: { dir } });
+export const createPrompt = (id: string, name: string, content: string) =>
+  api("/api/marketplace/create-prompt", { method: "POST", body: { id, name, content } });
+export const createSkill = (id: string, name: string, description: string, content: string, scope: string, orgName?: string, agentId?: string) =>
+  api("/api/skills/create", { method: "POST", body: { id, name, description, content, scope, orgName, agentId } });
+export const addMcpToRegistry = (body: any) =>
+  api("/api/marketplace/add-mcp", { method: "POST", body });
+export const checkAppHealth = (id: string) =>
+  api(`/api/apps/${id}/check-health`, { method: "POST" });
+export const startLogin = (name: string, path: string) =>
+  api("/api/config/accounts/login", { method: "POST", body: { name, path } });
+
+// ─── Login ───────────────────────────────────────────────────────
+export const submitLoginCode = (accountName: string, code: string) =>
+  api("/api/config/accounts/login/code", { method: "POST", body: { accountName, code } });
+
+// ─── Marketplace Extras ─────────────────────────────────────────
+export const setPlatformDefault = (type: string, id: string) =>
+  api("/api/marketplace/platform-default", { method: "POST", body: { type, id } });
+export const importSkills = (agentId: string, skills: string[]) =>
+  api("/api/marketplace/import-skills", { method: "POST", body: { agentId, skills } });
+export const getPromptTrigger = () => api("/api/marketplace/prompt-trigger");
+export const setPromptTrigger = (trigger: string) =>
+  api("/api/marketplace/prompt-trigger", { method: "POST", body: { trigger } });
+
+// ─── Chat Streaming ─────────────────────────────────────────────
+export const getChatJobRaw = (jobId: string, after?: number) =>
+  api(`/api/chat/jobs/${jobId}/raw`, { query: { after } });
+
+// ─── Heartbeat ──────────────────────────────────────────────────
+export const triggerHeartbeat = (agentId: string, triggeredBy?: string) =>
+  api(`/api/agents/${agentId}/heartbeat`, { method: "POST", body: { triggeredBy } });
+export const heartbeatHistory = (agentId: string, limit?: number) =>
+  api(`/api/agents/${agentId}/heartbeat-history`, { query: { limit } });
+
+// ─── Wiki Sync ──────────────────────────────────────────────────
+export const triggerWikiSync = (agentId: string, triggeredBy?: string) =>
+  api(`/api/agents/${agentId}/wiki-sync`, { method: "POST", body: { triggeredBy } });
+export const wikiSyncHistory = (agentId: string, limit?: number) =>
+  api(`/api/agents/${agentId}/wiki-sync-history`, { query: { limit } });
+
+// ─── Whoami ─────────────────────────────────────────────────────
+export const whoami = (agentId: string) => api(`/api/whoami/${agentId}`);
+
+// ─── Changelog ──────────────────────────────────────────────────
+export const changelog = () => api("/api/changelog");
+
+// ─── Webhook ────────────────────────────────────────────────────
+export const sendWebhook = (agentId: string, text: string, secret?: string, channel?: string, chatId?: string) => {
+  const headers: Record<string, string> = { "Content-Type": "application/json" };
+  if (secret) headers["x-webhook-secret"] = secret;
+  return api(`/webhook/${agentId}`, { method: "POST", body: { text, channel, chatId } });
+};
+
+// ─── Install xbar ───────────────────────────────────────────────
+export const installXbar = () => api("/api/install-xbar", { method: "POST" });
+
+// ─── Lab / Platform Agents ───────────────────────────────────────
+export const getPlatformAgents = () => api("/api/platform-agents");
+export const browseDirs = (path?: string) => api("/api/browse-dirs", { query: { path } });
+
+// ─── SaaS Integration ───────────────────────────────────────────
+export const getSaasConfig = () => api("/api/saas/config");
+export const updateSaasConfig = (baseUrl?: string, apiKey?: string) =>
+  api("/api/saas/config", { method: "PUT", body: { baseUrl, apiKey } });
+export const testSaasConnection = (baseUrl?: string, apiKey?: string) =>
+  api("/api/saas/test", { method: "POST", body: { baseUrl, apiKey } });
+export const publishToSaas = (type: string, id: string, destination?: string) =>
+  api("/api/saas/publish", { method: "POST", body: { type, id, destination } });
+
+// ─── File Upload ────────────────────────────────────────────────
+export const uploadFile = (agentId: string, fileName: string, base64Content: string, mode?: string) =>
+  api(`/api/upload/${agentId}/json`, { method: "POST", body: { fileName, base64Content, mode } });
+
+// ─── User Guide ─────────────────────────────────────────────────
+export const getUserGuide = () => api("/api/user-guide");
+
+// ─── Memory Write ───────────────────────────────────────────────
+export const writeMemory = (agentId: string, content: string, target?: string) =>
+  api(`/api/agents/${agentId}/memory/write`, { method: "POST", body: { content, target } });
+
+// ─── Skill Content ──────────────────────────────────────────────
+export const getSkillContent = (path: string) =>
+  api("/api/skills/content", { query: { path } });
+
+// ─── Goal/Cron Update ───────────────────────────────────────────
+export const updateGoal = (agentId: string, goalId: string, body: any) =>
+  api(`/api/agents/${agentId}/goals/${goalId}`, { method: "PUT", body });
+export const updateCron = (agentId: string, index: number, body: any) =>
+  api(`/api/agents/${agentId}/cron/${index}`, { method: "PUT", body });
+
+// ─── Service Restart ────────────────────────────────────────────
+export const restart = () => api("/api/restart", { method: "POST" });
+
+// ─── Discovery ──────────────────────────────────────────────────
+export const listCapabilities = () => api("/api/capabilities");
+
+// ─── Drive ──────────────────────────────────────────────────────
+export const browseDrive = (path?: string) => api("/api/drive/browse", { query: { path } });
+export const readDriveFile = (path: string) => api("/api/drive/read", { query: { path } });
+export const searchDrive = (q: string, path?: string, limit?: number, types?: string) =>
+  api("/api/drive/search", { query: { q, path, limit, types } });
+
+// ─── Gym ─────────────────────────────────────────────────────────
+export const getGymLearnerProfile = () => api("/api/gym/learner-profile");
+export const updateGymLearnerProfile = (body: any) => api("/api/gym/learner-profile", { method: "PUT", body });
+export const getGymPlan = () => api("/api/gym/plan");
+export const updateGymPlan = (body: any) => api("/api/gym/plan", { method: "PUT", body });
+export const getGymProgress = () => api("/api/gym/progress");
+export const updateGymProgress = (body: any) => api("/api/gym/progress", { method: "PUT", body });
+export const listGymCards = () => api("/api/gym/cards");
+export const createGymCard = (body: any) => api("/api/gym/cards", { method: "POST", body });
+export const dismissGymCard = (id: string) => api(`/api/gym/cards/${id}`, { method: "DELETE" });
+export const snapshotDimensions = (body: any) => api("/api/gym/dimensions/snapshot", { method: "POST", body });
+export const listGymPrograms = () => api("/api/gym/programs");
+export const getGymProgram = (slug: string) => api(`/api/gym/programs/${slug}`);
+export const createGymProgram = (body: any) => api("/api/gym/programs", { method: "POST", body });
+export const importGymProgram = (body: any) => api("/api/gym/programs/import-markdown", { method: "POST", body });
+export const updateGymProgram = (slug: string, body: any) => api(`/api/gym/programs/${slug}`, { method: "PATCH", body });
+export const deleteGymProgram = (slug: string) => api(`/api/gym/programs/${slug}`, { method: "DELETE" });
+export const getGymDimensionHistory = () => api("/api/gym/dimensions/history");
+export const runGymDigest = () => api("/api/gym/digest/run", { method: "POST" });
+export const getAgentActivitySummary = (id: string) => api(`/api/agents/${id}/activity-summary`);
+export const searchAgentLogs = (q: string, agentIds?: string) => api("/api/agents/logs/search", { query: { q, agentIds } });
+export const getGymFeed = () => api("/api/gym/feed");
+export const getGymConfig = () => api("/api/gym/config");
+export const listGymGuides = () => api("/api/gym/guides");
+export const createGymGuide = (data: Record<string, unknown>) => api("/api/gym/guides", { method: "POST", body: data });
+export const getGymInsights = () => api("/api/gym/insights");
+export const saveGymInsights = (data: Record<string, unknown>) => api("/api/gym/insights", { method: "POST", body: data });

package/server/mcp-server/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": ["./**/*.ts"]
+}

package/src/agent-registry.ts

@@ -0,0 +1,180 @@
+/**
+ * Agent Registry — indexes agent descriptions for RAG-based delegation.
+ * Used by group agents to find the right sub-agent for a user query.
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+import type { AppConfig } from "./config.js";
+import { log } from "./logger.js";
+
+interface AgentRegistryEntry {
+  id: string;
+  name: string;
+  description: string;
+  aliases: string[];
+  mcps: string[];
+  org: string;
+  function: string;
+  capabilities: string;
+}
+
+interface RegistryIndex {
+  entries: AgentRegistryEntry[];
+  updatedAt: string;
+}
+
+/**
+ * Build a searchable text block for an agent (used for keyword/embedding matching).
+ */
+function buildAgentSearchText(id: string, agent: AppConfig["agents"][string]): string {
+  const parts = [
+    `Agent: ${agent.name} (${id})`,
+    `Description: ${agent.description}`,
+    `Aliases: ${(agent.mentionAliases || []).join(", ")}`,
+  ];
+  if (agent.mcps?.length) parts.push(`MCPs/Integrations: ${agent.mcps.join(", ")}`);
+  if (agent.org?.length) {
+    parts.push(`Organization: ${agent.org.map(o => `${o.organization} / ${o.function} / ${o.title}`).join("; ")}`);
+  }
+  if (agent.allowedTools?.length) parts.push(`Tools: ${agent.allowedTools.join(", ")}`);
+  if (agent.goals?.length) {
+    parts.push(`Goals: ${agent.goals.map(g => g.description).join("; ")}`);
+  }
+
+  // Try to read the CLAUDE.md for richer description
+  try {
+    const home = process.env.HOME || process.env.USERPROFILE || "";
+    const claudeMdPath = agent.claudeMd.startsWith("~") ? agent.claudeMd.replace("~", home) : agent.claudeMd;
+    if (existsSync(claudeMdPath)) {
+      const claudeMd = readFileSync(claudeMdPath, "utf-8");
+      // Extract just the first section (usually the main description)
+      const firstSection = claudeMd.split("##")[0].trim();
+      if (firstSection.length > 50 && firstSection.length < 2000) {
+        parts.push(`Details: ${firstSection}`);
+      }
+    }
+  } catch { /* ignore */ }
+
+  return parts.join("\n");
+}
+
+/**
+ * Build the registry for a group agent's sub-agents.
+ */
+export function buildAgentRegistry(
+  config: AppConfig,
+  subAgents: string[] | "*",
+): AgentRegistryEntry[] {
+  const agentIds = subAgents === "*"
+    ? Object.keys(config.agents)
+    : subAgents;
+
+  return agentIds
+    .filter(id => config.agents[id] && !config.agents[id].subAgents) // exclude other group agents
+    .map(id => {
+      const agent = config.agents[id];
+      return {
+        id,
+        name: agent.name,
+        description: agent.description,
+        aliases: agent.mentionAliases || [],
+        mcps: agent.mcps || [],
+        org: agent.org?.[0]?.organization || "",
+        function: agent.org?.[0]?.function || "",
+        capabilities: buildAgentSearchText(id, agent),
+      };
+    });
+}
+
+/**
+ * Simple keyword-based search against agent registry.
+ * Returns top N matches ranked by keyword overlap.
+ * Falls back to this when vector search isn't available.
+ */
+export function searchAgentRegistry(
+  registry: AgentRegistryEntry[],
+  query: string,
+  topN: number = 5,
+): AgentRegistryEntry[] {
+  const queryWords = query.toLowerCase().split(/\s+/).filter(w => w.length > 2);
+
+  const scored = registry.map(entry => {
+    const text = entry.capabilities.toLowerCase();
+    let score = 0;
+    for (const word of queryWords) {
+      if (text.includes(word)) score++;
+      // Bonus for name/description match
+      if (entry.name.toLowerCase().includes(word)) score += 2;
+      if (entry.description.toLowerCase().includes(word)) score += 2;
+      // Bonus for MCP match
+      if (entry.mcps.some(m => m.toLowerCase().includes(word))) score += 3;
+    }
+    return { entry, score };
+  });
+
+  return scored
+    .filter(s => s.score > 0)
+    .sort((a, b) => b.score - a.score)
+    .slice(0, topN)
+    .map(s => s.entry);
+}
+
+/**
+ * Build the system prompt section for a group agent.
+ * Includes the full registry table and delegation instructions.
+ */
+export function buildGroupAgentPrompt(
+  registry: AgentRegistryEntry[],
+  query: string,
+  port: number = 4888,
+): string {
+  // Search for relevant agents
+  const relevant = searchAgentRegistry(registry, query, 5);
+  const allAgents = registry;
+
+  const lines: string[] = [
+    "\n\n## Sub-Agent Delegation",
+    "You are a **group agent**. Your job is to understand the user's request and delegate to the right specialist agent. You can delegate to multiple agents in one conversation.",
+    "",
+    "### How to Delegate",
+    "Use Bash to call the delegation API:",
+    "```bash",
+    `curl -s -X POST http://localhost:${port}/api/delegate \\`,
+    `  -H "Content-Type: application/json" \\`,
+    `  -d '{"agentId":"<agent-id>","text":"<the user\\'s question or task>"}'`,
+    "```",
+    "The response JSON has `{ ok: true, agentId, response }`. Present the `response` to the user.",
+    "",
+    "### Guidelines",
+    "- Pick the best agent based on their description, MCPs, and capabilities",
+    "- You can delegate to multiple agents in sequence if the request spans multiple domains",
+    "- If you're unsure which agent to use, pick the closest match — don't ask the user to choose",
+    "- If no agent matches, answer the question yourself using your own knowledge",
+    "- After getting a delegate's response, you can add context or synthesize across multiple responses",
+    "- NEVER reveal the delegation mechanism to the user — present responses naturally",
+    "",
+  ];
+
+  // Show relevant agents first (RAG results)
+  if (relevant.length > 0) {
+    lines.push("### Most Relevant Agents for This Query");
+    lines.push("| Agent | Alias | Description | MCPs |");
+    lines.push("|-------|-------|-------------|------|");
+    for (const a of relevant) {
+      lines.push(`| **${a.name}** | ${a.aliases[0] || a.id} | ${a.description.slice(0, 100)} | ${a.mcps.slice(0, 5).join(", ")} |`);
+    }
+    lines.push("");
+  }
+
+  // Full registry
+  lines.push("### Full Agent Registry");
+  lines.push("| ID | Name | Description | Org |");
+  lines.push("|----|------|-------------|-----|");
+  for (const a of allAgents) {
+    lines.push(`| ${a.id} | ${a.name} | ${a.description.slice(0, 80)} | ${a.org} |`);
+  }
+  lines.push("");
+
+  return lines.join("\n");
+}