autodebug 0.5.1__py3-none-any.whl

autodebug/extension/README.md

@@ -0,0 +1,16 @@
+# AutoDebug
+
+Lets an AI agent debug your program with this window's own debugger: build,
+set breakpoints, run, step, read variables, and write a root-cause report into
+your project.
+
+- Nothing runs until you click **Approve** in the dialog, which shows the build
+  command, preLaunchTask, postDebugTask, the launch configuration as JSON, the
+  breakpoints and the limits. Remote hosts and `${input}` / `${command}`
+  substitutions are refused. Attach sessions detach and leave the program running.
+- The agent cannot evaluate code or change variables. Secret-looking values are
+  hidden from it.
+- The connection is 127.0.0.1 only, protected by a random token.
+
+Set up with `autodebug setup vscode` or `autodebug setup cursor`.
+Log: Command Palette → **AutoDebug: Show Log**.

autodebug/extension/extension.js

@@ -0,0 +1,40 @@
+'use strict';
+// AutoDebug extension entry point. The relay is in relay.js; the logic is in the Python server.
+const path = require('path');
+const vscode = require('vscode');
+const { Relay } = require('./relay');
+const mcp = require('./mcp');
+
+let relay;
+
+function activate(context) {
+  const output = vscode.window.createOutputChannel('AutoDebug');
+  const log = (line) => output.appendLine(`${new Date().toISOString()} ${line}`);
+  const status = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Left, 0);
+  status.text = '$(debug-alt) AutoDebug';
+  status.tooltip = 'AutoDebug is ready. An AI agent can debug here only after you click Approve.';
+  status.command = 'autodebug.showLog';
+  const folder = vscode.workspace.getConfiguration('autodebug').get('bridgesFolder') || undefined;
+  relay = new Relay(vscode, { folder, log });
+  context.subscriptions.push(
+    output, status,
+    vscode.commands.registerCommand('autodebug.showLog', () => output.show()),
+    vscode.debug.registerDebugAdapterTrackerFactory('*', { createDebugAdapterTracker: (s) => relay.tracker(s) }),
+    vscode.debug.onDidStartDebugSession((s) => relay.sessionStarted(s)),
+    vscode.debug.onDidTerminateDebugSession((s) => relay.sessionEnded(s)),
+    vscode.workspace.onDidChangeWorkspaceFolders(() => relay.announce()),
+    { dispose: () => relay.stop() },
+  );
+  relay.start().then(() => status.show(), (error) => log(`could not start: ${error.message}`));
+  try {
+    mcp.register(vscode, context, { stateFolder: path.dirname(relay.folder), log });
+  } catch (error) {
+    log(`MCP: could not register the autodebug server: ${error.message}`);
+  }
+}
+
+function deactivate() {
+  return relay && relay.stop();
+}
+
+module.exports = { activate, deactivate };

autodebug/extension/mcp.js

@@ -0,0 +1,98 @@
+'use strict';
+// Registers the `autodebug` MCP server with the IDE itself, so the agent gets the tools without an
+// mcp.json entry. `autodebug setup` writes <state folder>/server.json: how to start the server
+// ({command, args, env}). Cursor: vscode.cursor.mcp.registerServer. VS Code 1.101+:
+// vscode.lm.registerMcpServerDefinitionProvider. A window whose mcp.json files already name
+// `autodebug` is left alone, so the agent never sees the tools twice.
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const NAME = 'autodebug';
+const PROVIDER = 'autodebug.server'; // contributes.mcpServerDefinitionProviders in package.json
+
+function readJson(file) {
+  try {
+    const text = fs.readFileSync(file, 'utf8').replace(/^/, '');
+    return JSON.parse(text);
+  } catch (_) {
+    return undefined;
+  }
+}
+
+/** The server.json written by setup, or undefined (with the reason logged) when it is missing or wrong. */
+function serverConfig(stateFolder, log) {
+  const file = path.join(stateFolder, 'server.json');
+  const data = readJson(file);
+  if (!data) {
+    log(`MCP: no ${file}; run \`autodebug setup\` to let this window register the autodebug server`);
+    return undefined;
+  }
+  const env = data.env && typeof data.env === 'object' ? data.env : {};
+  if (typeof data.command !== 'string' || !Array.isArray(data.args) || !data.args.every((a) => typeof a === 'string')) {
+    log(`MCP: ${file} has no command and args; run \`autodebug setup\` again`);
+    return undefined;
+  }
+  return { command: data.command, args: data.args, env, version: String(data.version || '') };
+}
+
+/** Every mcp.json this IDE reads for the open folders, with the key that holds its servers. */
+function configFiles(ide, folders, userDir, home = os.homedir()) {
+  const files = [];
+  if (ide === 'cursor') {
+    files.push([path.join(home, '.cursor', 'mcp.json'), 'mcpServers']);
+    for (const f of folders) files.push([path.join(f, '.cursor', 'mcp.json'), 'mcpServers']);
+  } else {
+    if (userDir) files.push([path.join(userDir, 'mcp.json'), 'servers']);
+    for (const f of folders) {
+      files.push([path.join(f, '.vscode', 'mcp.json'), 'servers']);
+      files.push([path.join(f, '.mcp.json'), 'mcpServers']);
+    }
+  }
+  return files;
+}
+
+function configuredElsewhere(files) {
+  return files.find(([file, key]) => {
+    const data = readJson(file);
+    return Boolean(data && data[key] && typeof data[key] === 'object' && data[key][NAME]);
+  });
+}
+
+/**
+ * Register the server for this window. Returns what happened, for the log and the tests:
+ * 'cursor', 'vscode', 'configured' (an mcp.json already has it), 'no-config' or 'unsupported'.
+ */
+function register(vscode, context, { stateFolder, log, home = os.homedir() }) {
+  const isCursor = Boolean(vscode.cursor && vscode.cursor.mcp && typeof vscode.cursor.mcp.registerServer === 'function');
+  const hasProvider = Boolean(vscode.lm && typeof vscode.lm.registerMcpServerDefinitionProvider === 'function'
+    && typeof vscode.McpStdioServerDefinition === 'function');
+  if (!isCursor && !hasProvider) {
+    log('MCP: this IDE has no API to register MCP servers; use `autodebug setup` (it writes mcp.json)');
+    return 'unsupported';
+  }
+  const folders = (vscode.workspace.workspaceFolders || []).map((f) => f.uri.fsPath);
+  const userDir = context.globalStorageUri ? path.dirname(path.dirname(context.globalStorageUri.fsPath)) : undefined;
+  const found = configuredElsewhere(configFiles(isCursor ? 'cursor' : 'vscode', folders, userDir, home));
+  if (found) {
+    log(`MCP: ${found[0]} already starts autodebug; not registering it a second time`);
+    return 'configured';
+  }
+  const server = serverConfig(stateFolder, log);
+  if (!server) return 'no-config';
+  if (isCursor) {
+    vscode.cursor.mcp.registerServer({ name: NAME, server: { command: server.command, args: server.args, env: server.env } });
+    context.subscriptions.push({ dispose: () => { try { vscode.cursor.mcp.unregisterServer(NAME); } catch (_) { /* window closing */ } } });
+    log(`MCP: registered autodebug with Cursor (${server.command})`);
+    return 'cursor';
+  }
+  const definition = new vscode.McpStdioServerDefinition('AutoDebug', server.command, server.args, server.env, server.version);
+  context.subscriptions.push(vscode.lm.registerMcpServerDefinitionProvider(PROVIDER, {
+    provideMcpServerDefinitions: () => [definition],
+    resolveMcpServerDefinition: (d) => d,
+  }));
+  log(`MCP: registered autodebug with VS Code (${server.command})`);
+  return 'vscode';
+}
+
+module.exports = { register, configFiles, serverConfig, NAME, PROVIDER };

autodebug/extension/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "autodebug",
+  "displayName": "AutoDebug",
+  "description": "Lets an AI agent debug your program with this window's debugger, after you click Approve, and write a root-cause report.",
+  "version": "0.5.0",
+  "publisher": "SwagatTeejoram",
+  "license": "MIT",
+  "repository": {"type": "git", "url": "https://github.com/TEEJORAM/AutoDebug"},
+  "engines": {"vscode": "^1.80.0"},
+  "categories": ["Debuggers", "AI"],
+  "extensionKind": ["workspace"],
+  "activationEvents": ["onStartupFinished"],
+  "main": "./extension.js",
+  "contributes": {
+    "commands": [{"command": "autodebug.showLog", "title": "AutoDebug: Show Log"}],
+    "mcpServerDefinitionProviders": [{"id": "autodebug.server", "label": "AutoDebug"}],
+    "configuration": {
+      "title": "AutoDebug",
+      "properties": {
+        "autodebug.bridgesFolder": {
+          "type": "string",
+          "default": "",
+          "description": "Folder where this window announces itself to the AutoDebug server. Leave empty for the default."
+        }
+      }
+    }
+  }
+}