Function DebugPlugin

src/index.ts:234–439

({ directory })

}

export const DebugPlugin: Plugin = async ({ directory }) => {
  const LOG_PATH = getLogPath(directory);

  return {
    auth: {
      provider: config.authProvider,
      loader: async (getAuth) => {
        const auth = await getAuth();
        if (auth?.type === "api") storedNgrokToken = auth.key;
        return {};
      },
      methods: [
        {
          type: "api" as const,
          label: config.authLabel,
          prompts: [
            {
              type: "text" as const,
              key: "token",
              message: config.authPromptMessage,
            },
          ],
          async authorize(inputs) {
            if (!inputs?.token) return { type: "failed" as const };
            return { type: "success" as const, key: inputs.token };
          },
        },
      ],
    },
    "experimental.chat.system.transform": async (_input, output) => {
      if (debugModeActive && activeDebugUrl) {
        output.system.push(getDebugInstructions(activeDebugUrl));
      }
    },
    tool: {
      debug_start: tool({
        description: `Start debug mode to capture runtime data from the codebase.

WORKFLOW:
1. Call this tool to start the debug server
2. Insert fetch() calls at strategic locations in the code to capture runtime data
3. Ask the user to reproduce the issue
4. Use debug_read to analyze the captured logs and identify the problem

This enables runtime debugging by capturing labeled data points as the code executes.`,
        args: {
          port: tool.schema
            .number()
            .optional()
            .describe("Port for local server (default: auto-select)"),
        },
        async execute(args) {
          if (server) {
            const localUrl = buildDebugUrl(`http://localhost:${server.port}`);
            const publicUrl = tunnel?.url ? buildDebugUrl(tunnel.url) : null;
            const url = publicUrl ?? localUrl;
            return `Debug server already running!\n\nDebug URL: ${url}\n\n**Next Step:** Insert fetch() calls in the code where you need to capture data, then ask the user to reproduce the issue.`;
          }