adhdev 0.9.62 → 0.9.64

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adhdev",
-  "version": "0.9.62",
+  "version": "0.9.64",
   "description": "ADHDev — Agent Dashboard Hub for Dev. Remote-control AI coding agents from anywhere.",
   "main": "dist/index.js",
   "bin": {

package/vendor/mcp-server/index.js

@@ -153,6 +153,55 @@ var CloudTransport = class {
     if (!res.ok) throw new Error(`Launch failed: ${res.status}`);
     return res.json();
   }
+  async gitLog(daemonId, workspace, opts = {}) {
+    const params = new URLSearchParams({ workspace });
+    if (opts.limit) params.set("limit", String(opts.limit));
+    if (opts.file) params.set("file", opts.file);
+    if (opts.since) params.set("since", opts.since);
+    if (opts.until) params.set("until", opts.until);
+    const res = await fetch(
+      `${this.baseUrl}/api/v1/shortcuts/${encodeURIComponent(daemonId)}/git-log?${params}`,
+      { headers: this.headers() }
+    );
+    if (!res.ok) throw new Error(`Git log failed: ${res.status}`);
+    return res.json();
+  }
+  async gitDiff(daemonId, workspace, opts = {}) {
+    const params = new URLSearchParams({ workspace });
+    if (opts.file) params.set("file", opts.file);
+    if (opts.maxLines) params.set("maxLines", String(opts.maxLines));
+    if (opts.staged) params.set("staged", "true");
+    const res = await fetch(
+      `${this.baseUrl}/api/v1/shortcuts/${encodeURIComponent(daemonId)}/git-diff?${params}`,
+      { headers: this.headers() }
+    );
+    if (!res.ok) throw new Error(`Git diff failed: ${res.status}`);
+    return res.json();
+  }
+  async gitPush(daemonId, opts) {
+    const res = await fetch(
+      `${this.baseUrl}/api/v1/shortcuts/${encodeURIComponent(daemonId)}/git-push`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify(opts)
+      }
+    );
+    if (!res.ok) throw new Error(`Git push failed: ${res.status}`);
+    return res.json();
+  }
+  async gitCheckpoint(daemonId, opts) {
+    const res = await fetch(
+      `${this.baseUrl}/api/v1/shortcuts/${encodeURIComponent(daemonId)}/git-checkpoint`,
+      {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify(opts)
+      }
+    );
+    if (!res.ok) throw new Error(`Git checkpoint failed: ${res.status}`);
+    return res.json();
+  }
   async ping() {
     try {
       await this.listDaemons();
@@ -163,6 +212,11 @@ var CloudTransport = class {
   }
 };
 
+// src/transports/mode.ts
+function isLocalTransport(transport) {
+  return typeof transport.command === "function";
+}
+
 // src/tools/list-sessions.ts
 var FORMAT_PROP = {
   format: {
@@ -188,7 +242,7 @@ var LIST_SESSIONS_TOOL = {
 };
 async function listSessions(transport, args = {}) {
   const asJson = args.format === "json";
-  if ("getStatus" in transport) {
+  if (isLocalTransport(transport)) {
     const status = await transport.getStatus();
     const sessions = status?.sessions ?? [];
     if (asJson) {
@@ -279,7 +333,7 @@ var LIST_DAEMONS_TOOL = {
 };
 async function listDaemons(transport, args = {}) {
   const asJson = args.format === "json";
-  if ("getStatus" in transport) {
+  if (isLocalTransport(transport)) {
     const status = await transport.getStatus();
     const daemon = {
       id: status?.id ?? status?.instanceId ?? "standalone",
@@ -347,7 +401,7 @@ var READ_CHAT_TOOL = {
 };
 async function readChat(transport, args) {
   const limit = args.limit ?? 50;
-  if ("command" in transport) {
+  if (isLocalTransport(transport)) {
     const result2 = await transport.command("read_chat", {
       ...args.session_id ? { targetSessionId: args.session_id } : {},
       limit
@@ -411,7 +465,7 @@ var SEND_CHAT_TOOL = {
 };
 async function sendChat(transport, args) {
   if (!args.message?.trim()) throw new Error("message is required");
-  if ("command" in transport) {
+  if (isLocalTransport(transport)) {
     const result2 = await transport.command("send_chat", {
       message: args.message,
       ...args.session_id ? { targetSessionId: args.session_id } : {}
@@ -454,7 +508,7 @@ var APPROVE_TOOL = {
 };
 async function approve(transport, args) {
   const action = args.action === "reject" ? "reject" : "approve";
-  if ("command" in transport) {
+  if (isLocalTransport(transport)) {
     const result2 = await transport.command("resolve_action", {
       action,
       ...args.session_id ? { targetSessionId: args.session_id } : {}
@@ -486,7 +540,7 @@ var SCREENSHOT_TOOL = {
 };
 async function screenshot(transport, args) {
   let result;
-  if ("command" in transport) {
+  if (isLocalTransport(transport)) {
     result = await transport.command("screenshot", {
       ...args.session_id ? { targetSessionId: args.session_id } : {}
     });
@@ -531,7 +585,7 @@ var GIT_STATUS_TOOL = {
 async function gitStatus(transport, args) {
   let status;
   let diffSummary;
-  if ("command" in transport) {
+  if (isLocalTransport(transport)) {
     const statusResult = await transport.command("git_status", {
       workspace: args.workspace
     });
@@ -619,6 +673,372 @@ async function gitStatus(transport, args) {
   return lines.join("\n");
 }
 
+// src/tools/git-log.ts
+var GIT_LOG_TOOL = {
+  name: "git_log",
+  description: "Get commit history for a workspace. Shows hash, message, author, and date for recent commits. Use this to track what changes an agent has made, verify checkpoint commits, or understand project history.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      workspace: {
+        type: "string",
+        description: "Absolute path to the workspace/repository directory."
+      },
+      limit: {
+        type: "number",
+        description: "Max commits to return (default: 20, max: 100)."
+      },
+      file: {
+        type: "string",
+        description: "Filter history to commits that touched this repo-relative file path (optional)."
+      },
+      since: {
+        type: "string",
+        description: "Only commits after this date (ISO 8601 or git date string, optional)."
+      },
+      until: {
+        type: "string",
+        description: "Only commits before this date (ISO 8601 or git date string, optional)."
+      },
+      daemon_id: {
+        type: "string",
+        description: "Daemon ID (cloud mode only, required)."
+      },
+      ...FORMAT_PROP
+    },
+    required: ["workspace"]
+  }
+};
+async function gitLog(transport, args) {
+  const limit = Math.max(1, Math.min(100, args.limit ?? 20));
+  let raw;
+  if (isLocalTransport(transport)) {
+    raw = await transport.command("git_log", {
+      workspace: args.workspace,
+      limit,
+      ...args.file ? { path: args.file } : {},
+      ...args.since ? { since: args.since } : {},
+      ...args.until ? { until: args.until } : {}
+    });
+    raw = raw?.log ?? raw;
+  } else {
+    if (!args.daemon_id) throw new Error("daemon_id is required in cloud mode");
+    const result = await transport.gitLog(args.daemon_id, args.workspace, {
+      limit,
+      file: args.file,
+      since: args.since,
+      until: args.until
+    });
+    raw = result?.log ?? result;
+  }
+  if (raw?.success === false || raw?.reason) {
+    const msg = raw?.error ?? raw?.reason ?? "unknown";
+    if (args.format === "json") return JSON.stringify({ error: msg }, null, 2);
+    return `Git log error: ${msg}`;
+  }
+  if (!raw?.isGitRepo) {
+    const msg = `Not a git repository: ${args.workspace}`;
+    if (args.format === "json") return JSON.stringify({ error: msg }, null, 2);
+    return msg;
+  }
+  const entries = raw?.entries ?? [];
+  if (args.format === "json") {
+    return JSON.stringify({
+      workspace: raw.workspace,
+      branch: raw.branch ?? null,
+      entries: entries.map((e) => ({
+        commit: e.commit,
+        short: e.commit?.slice(0, 7),
+        message: e.message,
+        author: e.authorName ?? null,
+        author_email: e.authorEmail ?? null,
+        authored_at: e.authoredAt ? new Date(e.authoredAt).toISOString() : null
+      })),
+      total: entries.length,
+      truncated: raw.truncated ?? false
+    }, null, 2);
+  }
+  if (entries.length === 0) return "No commits found.";
+  const lines = entries.map((e) => {
+    const hash = e.commit?.slice(0, 7) ?? "???????";
+    const date = e.authoredAt ? new Date(e.authoredAt).toISOString().slice(0, 10) : "";
+    const author = e.authorName ? ` (${e.authorName})` : "";
+    return `${hash} ${date}${author} ${e.message}`;
+  });
+  const header = `Commits (${entries.length}${raw.truncated ? ", truncated" : ""}):`;
+  return `${header}
+${lines.join("\n")}`;
+}
+
+// src/tools/git-diff.ts
+var GIT_DIFF_TOOL = {
+  name: "git_diff",
+  description: "Get the actual diff content for changed files in a workspace. Without a specific file, returns diffs for up to 5 changed files. Use this to review what an agent actually changed \u2014 file names alone (from git_status) are not enough for code review.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      workspace: {
+        type: "string",
+        description: "Absolute path to the workspace/repository directory."
+      },
+      file: {
+        type: "string",
+        description: "Specific repo-relative file path to diff (optional \u2014 if omitted, returns top 5 changed files)."
+      },
+      max_lines: {
+        type: "number",
+        description: "Max diff lines per file before truncating (default: 300)."
+      },
+      staged: {
+        type: "boolean",
+        description: "Show staged changes instead of unstaged (default: false)."
+      },
+      daemon_id: {
+        type: "string",
+        description: "Daemon ID (cloud mode only, required)."
+      },
+      ...FORMAT_PROP
+    },
+    required: ["workspace"]
+  }
+};
+async function gitDiff(transport, args) {
+  const maxLines = Math.max(10, Math.min(2e3, args.max_lines ?? 300));
+  const staged = args.staged ?? false;
+  if (isLocalTransport(transport)) {
+    return localGitDiff(transport, args.workspace, args.file, maxLines, staged, args.format);
+  }
+  if (!args.daemon_id) throw new Error("daemon_id is required in cloud mode");
+  const result = await transport.gitDiff(args.daemon_id, args.workspace, {
+    file: args.file,
+    maxLines,
+    staged
+  });
+  if (result?.error) {
+    if (args.format === "json") return JSON.stringify({ error: result.error }, null, 2);
+    return `Git diff error: ${result.error}`;
+  }
+  return formatDiffResult(result, args.format);
+}
+async function localGitDiff(transport, workspace, file, maxLines, staged, format) {
+  if (file) {
+    const raw = await transport.command("git_diff_file", { workspace, path: file, staged });
+    const d = raw?.diff ?? raw;
+    if (d?.success === false || d?.reason) {
+      const msg = d?.error ?? d?.reason ?? "unknown";
+      if (format === "json") return JSON.stringify({ error: msg }, null, 2);
+      return `Git diff error: ${msg}`;
+    }
+    const lines = (d?.diff ?? "").split("\n");
+    const truncated = lines.length > maxLines;
+    const result = {
+      files: [{
+        path: file,
+        diff: truncated ? lines.slice(0, maxLines).join("\n") + "\n... (truncated)" : d?.diff ?? "",
+        truncated,
+        binary: d?.binary ?? false
+      }],
+      total_files: 1,
+      shown_files: 1,
+      truncated
+    };
+    return formatDiffResult(result, format);
+  }
+  const summaryRaw = await transport.command("git_diff_summary", { workspace, staged });
+  const summary = summaryRaw?.diffSummary ?? summaryRaw;
+  if (summary?.success === false || summary?.reason) {
+    const msg = summary?.error ?? summary?.reason ?? "unknown";
+    if (format === "json") return JSON.stringify({ error: msg }, null, 2);
+    return `Git diff error: ${msg}`;
+  }
+  if (!summary?.isGitRepo) {
+    const msg = `Not a git repository: ${workspace}`;
+    if (format === "json") return JSON.stringify({ error: msg }, null, 2);
+    return msg;
+  }
+  const files = summary?.files ?? [];
+  if (files.length === 0) {
+    if (format === "json") return JSON.stringify({ files: [], total_files: 0, shown_files: 0, truncated: false }, null, 2);
+    return "No changed files.";
+  }
+  const topFiles = files.slice(0, 5);
+  const fileDiffs = await Promise.all(
+    topFiles.map(async (f) => {
+      try {
+        const raw = await transport.command("git_diff_file", { workspace, path: f.path, staged });
+        const d = raw?.diff ?? raw;
+        const lines = (d?.diff ?? "").split("\n");
+        const trunc = lines.length > maxLines;
+        return {
+          path: f.path,
+          old_path: f.oldPath ?? null,
+          status: f.status ?? "M",
+          diff: trunc ? lines.slice(0, maxLines).join("\n") + "\n... (truncated)" : d?.diff ?? "",
+          truncated: trunc,
+          binary: d?.binary ?? false
+        };
+      } catch {
+        return { path: f.path, diff: "", truncated: false, binary: false, error: "fetch failed" };
+      }
+    })
+  );
+  return formatDiffResult({
+    files: fileDiffs,
+    total_files: files.length,
+    shown_files: topFiles.length,
+    truncated: files.length > 5
+  }, format);
+}
+function formatDiffResult(result, format) {
+  if (format === "json") return JSON.stringify(result, null, 2);
+  const files = result?.files ?? [];
+  if (files.length === 0) return "No changed files.";
+  const parts = [];
+  const totalShown = result?.shown_files ?? files.length;
+  const totalAll = result?.total_files ?? files.length;
+  if (totalAll > totalShown) {
+    parts.push(`Showing ${totalShown} of ${totalAll} changed files:
+`);
+  }
+  for (const f of files) {
+    const header = `--- ${f.path}${f.old_path ? ` (was ${f.old_path})` : ""} ---`;
+    if (f.error) {
+      parts.push(`${header}
+(error: ${f.error})
+`);
+    } else if (f.binary) {
+      parts.push(`${header}
+(binary file)
+`);
+    } else if (!f.diff) {
+      parts.push(`${header}
+(no diff)
+`);
+    } else {
+      parts.push(`${header}
+${f.diff}${f.truncated ? "" : "\n"}`);
+    }
+  }
+  return parts.join("\n");
+}
+
+// src/tools/git-checkpoint.ts
+var GIT_CHECKPOINT_TOOL = {
+  name: "git_checkpoint",
+  description: "Create a checkpoint commit in a workspace. Stages all tracked changes (or all files including untracked) and commits with a prefixed message. Use this to save progress before a risky operation, or to create a restore point the orchestrator can reference.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      workspace: {
+        type: "string",
+        description: "Absolute path to the workspace/repository directory."
+      },
+      message: {
+        type: "string",
+        description: 'Checkpoint message (max 200 chars). Will be prefixed with "adhdev: checkpoint ".'
+      },
+      include_untracked: {
+        type: "boolean",
+        description: "Also stage and commit untracked files (default: false)."
+      },
+      daemon_id: {
+        type: "string",
+        description: "Daemon ID (cloud mode only, required)."
+      }
+    },
+    required: ["workspace", "message"]
+  }
+};
+async function gitCheckpoint(transport, args) {
+  const message = args.message?.trim();
+  if (!message) return "Error: message is required";
+  if (message.length > 200) return "Error: message must be 200 characters or fewer";
+  let raw;
+  if (isLocalTransport(transport)) {
+    raw = await transport.command("git_checkpoint", {
+      workspace: args.workspace,
+      message,
+      includeUntracked: args.include_untracked ?? false
+    });
+    raw = raw?.checkpoint ?? raw;
+  } else {
+    if (!args.daemon_id) throw new Error("daemon_id is required in cloud mode");
+    const result = await transport.gitCheckpoint(args.daemon_id, {
+      workspace: args.workspace,
+      message,
+      includeUntracked: args.include_untracked ?? false
+    });
+    raw = result?.checkpoint ?? result;
+  }
+  if (raw?.success === false || raw?.reason) {
+    const msg = raw?.error ?? raw?.reason ?? "unknown";
+    if (msg.includes("Nothing to commit") || msg.includes("nothing to commit")) {
+      return "Nothing to commit \u2014 working tree is clean.";
+    }
+    return `Git checkpoint error: ${msg}`;
+  }
+  const commit = raw?.commit?.slice(0, 7) ?? "???????";
+  const fullMsg = raw?.message ?? `adhdev: checkpoint ${message}`;
+  return `Checkpoint created: ${commit} \u2014 ${fullMsg}`;
+}
+
+// src/tools/git-push.ts
+var GIT_PUSH_TOOL = {
+  name: "git_push",
+  description: "Push a branch to a remote repository on the daemon machine. If the branch has no upstream configured, sets it automatically. Key for parallel multi-machine workflows: after git_checkpoint, push each machine's branch to origin so changes are available for PR/review.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      workspace: {
+        type: "string",
+        description: "Absolute path to the workspace/repository directory."
+      },
+      remote: {
+        type: "string",
+        description: 'Remote name (default: "origin").'
+      },
+      branch: {
+        type: "string",
+        description: "Branch to push (default: current branch)."
+      },
+      daemon_id: {
+        type: "string",
+        description: "Daemon ID (cloud mode only, required)."
+      }
+    },
+    required: ["workspace"]
+  }
+};
+async function gitPush(transport, args) {
+  let raw;
+  if (isLocalTransport(transport)) {
+    raw = await transport.command("git_push", {
+      workspace: args.workspace,
+      remote: args.remote ?? "origin",
+      ...args.branch ? { branch: args.branch } : {}
+    });
+    raw = raw?.push ?? raw;
+  } else {
+    if (!args.daemon_id) throw new Error("daemon_id is required in cloud mode");
+    const result = await transport.gitPush(args.daemon_id, {
+      workspace: args.workspace,
+      remote: args.remote,
+      branch: args.branch
+    });
+    raw = result?.push ?? result;
+  }
+  if (raw?.success === false || raw?.reason) {
+    const msg = raw?.error ?? raw?.reason ?? "unknown";
+    return `Git push error: ${msg}`;
+  }
+  const branch = raw?.branch ?? args.branch ?? "(current)";
+  const remote = raw?.remote ?? args.remote ?? "origin";
+  const newBranch = raw?.newBranch ? " [new branch]" : "";
+  const output = raw?.output ? `
+${raw.output}` : "";
+  return `Pushed ${branch} \u2192 ${remote}${newBranch}${output}`;
+}
+
 // src/tools/launch-session.ts
 var LAUNCH_SESSION_TOOL = {
   name: "launch_session",
@@ -647,7 +1067,7 @@ var LAUNCH_SESSION_TOOL = {
   }
 };
 async function launchSession(transport, args) {
-  if ("command" in transport) {
+  if (isLocalTransport(transport)) {
     const isCliOrAcp = args.type.includes("-cli") || args.type.includes("-acp") || args.type === "codex";
     const commandType = isCliOrAcp ? "launch_cli" : "launch_ide";
     const payload = isCliOrAcp ? { cliType: args.type, dir: args.workspace ?? "~", ...args.model ? { model: args.model } : {} } : { ideType: args.type, enableCdp: true };
@@ -684,14 +1104,14 @@ var STOP_SESSION_TOOL = {
       },
       type: {
         type: "string",
-        description: "Provider type (e.g. hermes-cli, claude-cli). Cloud mode: auto-resolved from session_id if omitted."
+        description: "Provider type (e.g. hermes-cli, claude-cli). Local mode auto-resolves from session_id if omitted; cloud mode forwards the session_id and omits type unless explicitly provided."
       }
     },
     required: ["session_id"]
   }
 };
 async function stopSession(transport, args) {
-  if ("command" in transport) {
+  if (isLocalTransport(transport)) {
     const local = transport;
     let resolvedType = args.type;
     if (!resolvedType) {
@@ -735,7 +1155,7 @@ var CHECK_PENDING_TOOL = {
   }
 };
 async function checkPending(transport, args) {
-  if ("getStatus" in transport) {
+  if (isLocalTransport(transport)) {
     return checkPendingLocal(transport, args.format);
   }
   return checkPendingCloud(transport, args.daemon_id, args.format);
@@ -843,10 +1263,14 @@ async function startMcpServer(opts) {
     SEND_CHAT_TOOL,
     APPROVE_TOOL,
     GIT_STATUS_TOOL,
+    GIT_LOG_TOOL,
+    GIT_DIFF_TOOL,
+    GIT_CHECKPOINT_TOOL,
+    GIT_PUSH_TOOL,
     ...isLocal ? [SCREENSHOT_TOOL] : []
   ];
   const server = new import_server.Server(
-    { name: "adhdev-mcp-server", version: "0.9.62" },
+    { name: "adhdev-mcp-server", version: "0.9.64" },
     { capabilities: { tools: {} } }
   );
   server.setRequestHandler(import_types.ListToolsRequestSchema, async () => ({ tools: allTools }));
@@ -889,6 +1313,22 @@ async function startMcpServer(opts) {
           const text = await gitStatus(transport, { workspace: a.workspace, include_diff: a.include_diff, daemon_id: a.daemon_id, format: a.format });
           return { content: [{ type: "text", text }] };
         }
+        case "git_log": {
+          const text = await gitLog(transport, { workspace: a.workspace, limit: a.limit, file: a.file, since: a.since, until: a.until, daemon_id: a.daemon_id, format: a.format });
+          return { content: [{ type: "text", text }] };
+        }
+        case "git_diff": {
+          const text = await gitDiff(transport, { workspace: a.workspace, file: a.file, max_lines: a.max_lines, staged: a.staged, daemon_id: a.daemon_id, format: a.format });
+          return { content: [{ type: "text", text }] };
+        }
+        case "git_checkpoint": {
+          const text = await gitCheckpoint(transport, { workspace: a.workspace, message: a.message, include_untracked: a.include_untracked, daemon_id: a.daemon_id });
+          return { content: [{ type: "text", text }] };
+        }
+        case "git_push": {
+          const text = await gitPush(transport, { workspace: a.workspace, remote: a.remote, branch: a.branch, daemon_id: a.daemon_id });
+          return { content: [{ type: "text", text }] };
+        }
         case "launch_session": {
           const text = await launchSession(transport, {
             type: a.type,
@@ -976,8 +1416,8 @@ Environment variables:
   ADHDEV_API_KEY      API key (cloud mode)
   ADHDEV_PASSWORD     Daemon password (local mode)
 
-Local mode tools:   list_daemons, list_sessions, launch_session, stop_session, check_pending, read_chat, send_chat, approve, git_status, screenshot
-Cloud mode tools:   list_daemons, list_sessions, launch_session, stop_session, check_pending, read_chat, send_chat, approve, git_status
+Local mode tools:   list_daemons, list_sessions, launch_session, stop_session, check_pending, read_chat, send_chat, approve, git_status, git_log, git_diff, git_checkpoint, git_push, screenshot
+Cloud mode tools:   list_daemons, list_sessions, launch_session, stop_session, check_pending, read_chat, send_chat, approve, git_status, git_log, git_diff, git_checkpoint, git_push
 `.trim());
 }
 startMcpServer(parseArgs(process.argv)).catch((err) => {