Project Files

.pydev-tools

_ast

describe.py

do_work.py

docstrings.py

extract_function.py

extract.py

legacy_handler_2.py

legacy_handler_3.py

legacy_handler.py

migration.py

reference.py

rename.py

workspace_description.md

prompt_examples

dependency_version_migration.txt

hotfix_rework.txt

new_project.txt

performance_optimization.txt

refactory.txt

security_hardening.txt

source_tree_analysis.txt

test_coverage_expansion.txt

scripts

e2e_runPytest_test.cjs

setupVenv.mjs

smokeNew6Tools.ts

smokeNewTools.ts

verify_testfile_fix.ts

verifySetupVenv.ts

skills

pydev-mcp.md

src

tools

_profiling_worker_main.py

analyzeImportsAndDependencies.ts

buildPythonPackage.ts

checkForBugs.ts

checkForBugsInFile.ts

createProjectStructure.ts

createTestFileTool.ts

editTextFile.ts

editTextFileByLine.ts

findFiles.ts

generateRequirementsTxtTool.ts

getSetupStatusTool.ts

getWorkspaceRootTool.ts

inspectEnvironmentTool.ts

installModule.ts

listDirectory.ts

listTools.ts

profileProject.ts

pydevAuditDocstringsTool.ts

pydevDescribeWorkspaceTool.ts

pydevExtractFunctionTool.ts

pydevGenerateReferenceTool.ts

pydevMigrationAuditTool.ts

pydevSafeRenameTool.ts

readTextFile.ts

runLinterAndFormatter.ts

runLinterAndFormatterInFile.ts

runProjectCoverage.ts

runPython.ts

runPythonFile.ts

runPythonFileInteractive.ts

runPythonInteractive.ts

runRepl.ts

runTests.ts

runWithDebuggerTool.ts

saveTextFile.ts

scanProjectSecurity.ts

searchDirectory.ts

setupVenvTool.ts

switchPythonVersion.ts

typeCheckProjectTool.ts

uninstallModule.ts

config.ts

index.ts

test

run_tests.cjs

tools.test.cjs

manifest.json

package-lock.json

package.json

professor_headache.jpg

README.md

setup-venv.sh

tsconfig.json

src / tools / runWithDebuggerTool.ts

import { tool } from "@lmstudio/sdk";
import { z } from "zod";

import { runWithDebugger, type RunWithDebuggerOptions } from "../utils/pythonDebugger";
import { getToolDefinition } from "../utils/toolRegistry";

const TOOL_DEFINITION = getToolDefinition("pydev_run_with_debugger")!;

export const runWithDebuggerTool = tool({
  name: TOOL_DEFINITION.name,
  description: `${TOOL_DEFINITION.description} Runs Python code and prints a full traceback with variable inspection at each frame.`,
  parameters: {
    code: z
      .string()
      .max(50000)
      .optional()
      .describe("Inline Python source to run under the debugger (use this OR filePath)."),
    filePath: z
      .string()
      .min(1)
      .max(500)
      .optional()
      .describe("Path to an existing .py file to debug."),
    args: z
      .array(z.string().max(500))
      .max(20)
      .optional()
      .describe("Command-line arguments passed to the target as sys.argv[1:]."),
    cwd: z
      .string()
      .min(1)
      .max(500)
      .optional()
      .describe("Working directory. Defaults to the target file's directory."),
    timeoutSeconds: z
      .number()
      .int()
      .min(5)
      .max(300)
      .optional()
      .describe("Timeout in seconds. Defaults to 60."),
  },
  implementation: async ({ code, filePath, args, cwd, timeoutSeconds }) => {
    const options: RunWithDebuggerOptions = {
      code,
      filePath,
      args,
      cwd,
      timeoutSeconds,
    };

    return await runWithDebugger(options);
  },
});