daemora 1.0.0

package/src/tools/index.js

@@ -0,0 +1,173 @@
+// ─── Existing tools ────────────────────────────────────────────────────────────
+import { executeCommand, executeCommandDescription } from "./executeCommand.js";
+import { readFile, readFileDescription } from "./readFile.js";
+import { writeFile, writeFileDescription } from "./writeFile.js";
+import { editFile, editFileDescription } from "./editFile.js";
+import { listDirectory, listDirectoryDescription } from "./listDirectory.js";
+import { searchFiles, searchFilesDescription } from "./searchFiles.js";
+import { searchContent, searchContentDescription } from "./searchContent.js";
+import { webFetch, webFetchDescription } from "./webFetch.js";
+import { webSearch, webSearchDescription } from "./webSearch.js";
+import { sendEmail, sendEmailDescription } from "./sendEmail.js";
+import { createDocument, createDocumentDescription } from "./createDocument.js";
+import { browserAction, browserActionDescription } from "./browserAutomation.js";
+import {
+  readMemory, readMemoryDescription,
+  writeMemory, writeMemoryDescription,
+  readDailyLog, readDailyLogDescription,
+  writeDailyLog, writeDailyLogDescription,
+  searchMemory, searchMemoryDescription,
+  pruneMemory, pruneMemoryDescription,
+  listMemoryCategories, listMemoryCategoriesDescription,
+} from "./memory.js";
+import { spawnSubAgent, spawnParallelAgents } from "../agents/SubAgentManager.js";
+import { delegateToAgent, delegateToAgentDescription } from "../a2a/A2AClient.js";
+
+// ─── Media tools ───────────────────────────────────────────────────────────────
+import { transcribeAudio, transcribeAudioDescription } from "./transcribeAudio.js";
+import { sendFile, sendFileDescription } from "./sendFile.js";
+import { textToSpeech, textToSpeechDescription } from "./textToSpeech.js";
+
+// ─── New tools ─────────────────────────────────────────────────────────────────
+import { globSearch, globSearchDescription } from "./glob.js";
+import { grep, grepDescription } from "./grep.js";
+import { applyPatch, applyPatchDescription } from "./applyPatch.js";
+import { imageAnalysis, imageAnalysisDescription } from "./imageAnalysis.js";
+import { screenCapture, screenCaptureDescription } from "./screenCapture.js";
+import { manageAgents, manageAgentsDescription } from "./manageAgents.js";
+import { cron, cronDescription } from "./cronTool.js";
+import { messageChannel, messageChannelDescription } from "./messageChannel.js";
+import { projectTracker, projectTrackerDescription } from "./projectTracker.js";
+import { manageMCP, manageMCPDescription } from "./manageMCP.js";
+import { useMCP, useMCPDescription } from "./useMCP.js";
+
+// ─── Wrap spawnAgent for the tool interface ────────────────────────────────────
+function spawnAgent(taskDescription, optionsJson) {
+  const options = optionsJson ? JSON.parse(optionsJson) : {};
+  return spawnSubAgent(taskDescription, options);
+}
+
+const spawnAgentDescription =
+  'spawnAgent(taskDescription: string, optionsJson?: string) - Spawn a sub-agent to handle a task independently. optionsJson: {"model":"openai:gpt-4.1-mini","tools":["readFile","searchContent"],"maxTurns":10,"parentContext":"shared spec here"}';
+
+// ─── Wrap parallelAgents for the tool interface ────────────────────────────────
+function parallelAgents(tasksJson, sharedOptionsJson) {
+  const tasks         = typeof tasksJson         === "string" ? JSON.parse(tasksJson)         : (tasksJson || []);
+  const sharedOptions = typeof sharedOptionsJson === "string" ? JSON.parse(sharedOptionsJson) : (sharedOptionsJson || {});
+  return spawnParallelAgents(tasks, sharedOptions);
+}
+
+const parallelAgentsDescription =
+  `parallelAgents(tasksJson: string, sharedOptionsJson?: string) - Spawn multiple sub-agents in parallel with a shared spec/context.
+  CRITICAL: Always pass sharedContext so agents know about each other's work (e.g. HTML class names for CSS agent).
+  tasksJson: [{"description":"Write index.html with id=app, class=todo-item"},{"description":"Write style.css for .todo-item"}]
+  sharedOptionsJson: {"sharedContext":"Shared spec: HTML uses id=app, ul#todo-list, li.todo-item, button.delete-btn, input#new-todo"}
+  Each agent gets the sharedContext as its starting context before its own task description.`;
+
+// ─── Tool Functions Map ────────────────────────────────────────────────────────
+
+export const toolFunctions = {
+  // File operations
+  readFile,
+  writeFile,
+  editFile,
+  listDirectory,
+  searchFiles,
+  searchContent,
+  // Advanced search (new)
+  glob: globSearch,
+  grep,
+  applyPatch,
+  // System
+  executeCommand,
+  // Web
+  webFetch,
+  webSearch,
+  // Browser
+  browserAction,
+  // Communication
+  sendEmail,
+  messageChannel,
+  sendFile,
+  transcribeAudio,
+  textToSpeech,
+  // Documents
+  createDocument,
+  // Memory
+  readMemory,
+  writeMemory,
+  readDailyLog,
+  writeDailyLog,
+  searchMemory,
+  pruneMemory,
+  listMemoryCategories,
+  // Agents
+  spawnAgent,
+  parallelAgents,
+  delegateToAgent,
+  manageAgents,
+  // Project tracking
+  projectTracker,
+  // Automation
+  cron,
+  // Vision / Screen
+  imageAnalysis,
+  screenCapture,
+  // MCP management
+  manageMCP,
+  useMCP,
+};
+
+// ─── Tool Descriptions Array ───────────────────────────────────────────────────
+
+export const toolDescriptions = [
+  // File operations
+  readFileDescription,
+  writeFileDescription,
+  editFileDescription,
+  listDirectoryDescription,
+  searchFilesDescription,
+  searchContentDescription,
+  // Advanced search
+  globSearchDescription,
+  grepDescription,
+  applyPatchDescription,
+  // System
+  executeCommandDescription,
+  // Web
+  webFetchDescription,
+  webSearchDescription,
+  // Browser
+  browserActionDescription,
+  // Communication
+  sendEmailDescription,
+  messageChannelDescription,
+  sendFileDescription,
+  transcribeAudioDescription,
+  textToSpeechDescription,
+  // Documents
+  createDocumentDescription,
+  // Memory
+  readMemoryDescription,
+  writeMemoryDescription,
+  readDailyLogDescription,
+  writeDailyLogDescription,
+  searchMemoryDescription,
+  pruneMemoryDescription,
+  listMemoryCategoriesDescription,
+  // Agents
+  spawnAgentDescription,
+  parallelAgentsDescription,
+  delegateToAgentDescription,
+  manageAgentsDescription,
+  // Project tracking
+  projectTrackerDescription,
+  // Automation
+  cronDescription,
+  // Vision / Screen
+  imageAnalysisDescription,
+  screenCaptureDescription,
+  // MCP management
+  manageMCPDescription,
+  useMCPDescription,
+];

package/src/tools/listDirectory.js

@@ -0,0 +1,47 @@
+import { readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import filesystemGuard from "../safety/FilesystemGuard.js";
+
+export function listDirectory(dirPath = ".") {
+  const guard = filesystemGuard.checkRead(dirPath);
+  if (!guard.allowed) {
+    console.log(`      [listDirectory] BLOCKED: ${guard.reason}`);
+    return guard.reason;
+  }
+  console.log(`      [listDirectory] Listing: ${dirPath}`);
+  try {
+    const entries = readdirSync(dirPath);
+    const results = entries
+      .filter((e) => e !== "node_modules" && e !== ".git")
+      .map((entry) => {
+        try {
+          const fullPath = join(dirPath, entry);
+          const stat = statSync(fullPath);
+          const type = stat.isDirectory() ? "[DIR]" : "[FILE]";
+          const size = stat.isFile()
+            ? ` (${formatSize(stat.size)})`
+            : "";
+          return `${type}  ${entry}${size}`;
+        } catch {
+          return `[?]   ${entry}`;
+        }
+      });
+
+    console.log(`      [listDirectory] Found ${results.length} entries`);
+    return results.length > 0
+      ? `Directory: ${dirPath}\n\n${results.join("\n")}`
+      : `Directory ${dirPath} is empty.`;
+  } catch (error) {
+    console.log(`      [listDirectory] Failed: ${error.message}`);
+    return `Error listing directory: ${error.message}`;
+  }
+}
+
+function formatSize(bytes) {
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+
+export const listDirectoryDescription =
+  "listDirectory(dirPath: string) - Lists all files and folders in a directory with their types and sizes. Skips node_modules and .git automatically.";

package/src/tools/manageAgents.js

@@ -0,0 +1,47 @@
+/**
+ * manageAgents(action, paramsJson?) — List, kill, or steer running sub-agents.
+ * Inspired by OpenClaw's subagents tool.
+ */
+import {
+  listActiveAgents,
+  killAgent,
+  steerAgent,
+} from "../agents/SubAgentManager.js";
+
+export function manageAgents(action, paramsJson) {
+  try {
+    const params = paramsJson ? JSON.parse(paramsJson) : {};
+
+    switch (action) {
+      case "list": {
+        const agents = listActiveAgents();
+        if (agents.length === 0) return "No active sub-agents running.";
+        const lines = agents.map(
+          (a) => `• ${a.id} — "${a.task}" (running ${Math.round(a.elapsedMs / 1000)}s)`
+        );
+        return `Active sub-agents (${agents.length}):\n${lines.join("\n")}`;
+      }
+
+      case "kill": {
+        if (!params.agentId) return 'Error: agentId is required for "kill" action';
+        const result = killAgent(params.agentId);
+        return result;
+      }
+
+      case "steer": {
+        if (!params.agentId) return 'Error: agentId is required for "steer" action';
+        if (!params.message) return 'Error: message is required for "steer" action';
+        const result = steerAgent(params.agentId, params.message);
+        return result;
+      }
+
+      default:
+        return `Unknown action: "${action}". Available: list, kill, steer`;
+    }
+  } catch (error) {
+    return `Error managing agents: ${error.message}`;
+  }
+}
+
+export const manageAgentsDescription =
+  'manageAgents(action: string, paramsJson?: string) - Manage running sub-agents. Actions: "list" (show all), "kill" ({"agentId":"id"}), "steer" ({"agentId":"id","message":"new instruction"}).';

package/src/tools/manageMCP.js

@@ -0,0 +1,159 @@
+import mcpManager from "../mcp/MCPManager.js";
+
+/**
+ * manageMCP — inspect, add, remove, and reload MCP server connections at runtime.
+ *
+ * Actions:
+ *   list    — all configured servers and their tool names
+ *   tools   — full tool list with descriptions for a specific server
+ *   status  — connection status summary (same as list)
+ *   add     — add a new MCP server (saved to config/mcp.json + connected immediately)
+ *   remove  — disconnect and remove a server from config
+ *   enable  — enable a disabled server (reconnects it)
+ *   disable — disable a server (disconnects it, keeps in config)
+ *   reload  — reconnect a server (useful after config changes)
+ */
+export async function manageMCP(action, paramsJson) {
+  const params = paramsJson
+    ? (typeof paramsJson === "string" ? JSON.parse(paramsJson) : paramsJson)
+    : {};
+
+  switch (action) {
+
+    case "list":
+    case "status": {
+      // Show both connected and configured-but-disabled servers
+      const connected = mcpManager.list();
+      const allConfig = mcpManager.readConfig().mcpServers || {};
+      const configuredNames = Object.keys(allConfig).filter(k => !k.startsWith("_comment"));
+
+      if (configuredNames.length === 0 && connected.length === 0) {
+        return "No MCP servers configured. Use manageMCP(\"add\", {...}) to add one.";
+      }
+
+      const lines = [];
+      for (const name of configuredNames) {
+        const cfg = allConfig[name];
+        const live = connected.find(s => s.name === name);
+        if (cfg.enabled === false) {
+          lines.push(`⏸️  disabled  ${name}`);
+        } else if (live?.connected) {
+          const toolList = live.tools.length > 0 ? live.tools.join(", ") : "(no tools)";
+          lines.push(`✅ connected ${name}: ${live.tools.length} tools — ${toolList}`);
+        } else {
+          lines.push(`❌ disconnected ${name}`);
+        }
+      }
+      // Any live servers not in config (shouldn't happen, but just in case)
+      for (const s of connected) {
+        if (!configuredNames.includes(s.name)) {
+          lines.push(`✅ connected ${s.name}: ${s.tools.length} tools (not in config)`);
+        }
+      }
+
+      return lines.join("\n");
+    }
+
+    case "tools": {
+      const { server } = params;
+      const servers = mcpManager.list();
+      if (!server) {
+        const all = servers.flatMap(s =>
+          s.tools.map(t => `mcp__${s.name}__${t}`)
+        );
+        if (all.length === 0) return "No MCP tools available. Connect servers first.";
+        return `All MCP tools (${all.length}):\n${all.map(t => `  ${t}`).join("\n")}`;
+      }
+      const srv = servers.find(s => s.name === server);
+      if (!srv) return `Server "${server}" not found or not connected. Use manageMCP("list") to see servers.`;
+      if (srv.tools.length === 0) return `No tools from server "${server}".`;
+      return `Tools from ${server}:\n${srv.tools.map(t => `  mcp__${server}__${t}`).join("\n")}`;
+    }
+
+    case "add": {
+      const { name, command, args, url, transport, env, headers } = params;
+      if (!name) return "Error: name is required";
+      if (!command && !url) return "Error: either 'command' (stdio) or 'url' (HTTP/SSE) is required";
+
+      const serverConfig = {};
+      if (command) {
+        // stdio — credentials go as env vars injected into the subprocess
+        serverConfig.command = command;
+        if (args) serverConfig.args = args;
+        if (env) serverConfig.env = env;   // { "GITHUB_TOKEN": "ghp_..." }
+      } else {
+        // http/sse — credentials go as HTTP request headers
+        serverConfig.url = url;
+        if (transport) serverConfig.transport = transport;  // "sse" or omit for HTTP
+        if (headers) serverConfig.headers = headers;        // { "Authorization": "Bearer ${TOKEN}" }
+      }
+
+      try {
+        return await mcpManager.addServer(name, serverConfig);
+      } catch (err) {
+        return `Error adding server "${name}": ${err.message}`;
+      }
+    }
+
+    case "remove": {
+      const { name } = params;
+      if (!name) return "Error: name is required";
+      try {
+        return await mcpManager.removeServer(name);
+      } catch (err) {
+        return `Error removing server "${name}": ${err.message}`;
+      }
+    }
+
+    case "enable": {
+      const { name } = params;
+      if (!name) return "Error: name is required";
+      try {
+        return await mcpManager.setEnabled(name, true);
+      } catch (err) {
+        return `Error enabling server "${name}": ${err.message}`;
+      }
+    }
+
+    case "disable": {
+      const { name } = params;
+      if (!name) return "Error: name is required";
+      try {
+        return await mcpManager.setEnabled(name, false);
+      } catch (err) {
+        return `Error disabling server "${name}": ${err.message}`;
+      }
+    }
+
+    case "reload": {
+      const { name } = params;
+      if (!name) return "Error: name is required";
+      try {
+        return await mcpManager.reloadServer(name);
+      } catch (err) {
+        return `Error reloading server "${name}": ${err.message}`;
+      }
+    }
+
+    default:
+      return `Unknown action: "${action}". Valid actions: list, tools, status, add, remove, enable, disable, reload`;
+  }
+}
+
+export const manageMCPDescription =
+  `manageMCP(action: string, paramsJson?: string) - Manage MCP server connections at runtime. Changes saved to config/mcp.json.
+  Actions:
+    list/status  - no params — all servers with connection status and tool names
+    tools        - {"server":"github"} — full tool list for a server, or {} for all servers
+    add          - Add and immediately connect a server:
+                   stdio (auth via env vars passed to subprocess):
+                     {"name":"github","command":"npx","args":["-y","@modelcontextprotocol/server-github"],"env":{"GITHUB_PERSONAL_ACCESS_TOKEN":"ghp_..."}}
+                   HTTP (auth via Authorization/custom request headers):
+                     {"name":"myapi","url":"https://api.example.com/mcp","headers":{"Authorization":"Bearer \${MY_TOKEN}"}}
+                   SSE (auth via request headers, applied to both GET stream and POST calls):
+                     {"name":"myapi","url":"https://api.example.com/sse","transport":"sse","headers":{"Authorization":"Bearer \${MY_TOKEN}","X-API-Key":"\${MY_KEY}"}}
+                   Header values support \${VAR_NAME} — expanded from process.env at connect time.
+    remove       - {"name":"github"} — disconnect and remove from config
+    enable       - {"name":"github"} — re-enable a disabled server (reconnects)
+    disable      - {"name":"github"} — disconnect and mark disabled in config
+    reload       - {"name":"github"} — reconnect (useful after editing config)`;