Method execute

src/tools/browser/dev-server.ts:86–123

(args: z.infer<typeof StartArgs>, _ctx: ToolContext)

  argsSchema = StartArgs;

  async execute(args: z.infer<typeof StartArgs>, _ctx: ToolContext): Promise<ToolResult> {
    try {
      const info = await registry.start({
        name: args.name,
        command: args.command,
        cwd: args.cwd,
        env: args.env,
        replace: args.replace,
      });
      const waitMs = args.wait_ms ?? 2000;
      if (waitMs > 0) {
        await new Promise((resolve) => setTimeout(resolve, waitMs));
      }
      const tail = registry.tailLog(args.name, 'combined', 2000);
      const proc = registry.get(args.name);
      const exited = proc?.exitCode !== null && proc?.exitCode !== undefined;
      const status = !exited
        ? `running (pid ${info.pid})`
        : `exited with code ${proc?.exitCode}`;
      // If it failed to start (or the output shows a missing binary/dep), check whether the real
      // problem is a broken dependency install and, if so, return an actionable diagnosis instead
      // of the raw output the model would otherwise loop on.
      if (exited && proc?.exitCode !== 0) {
        const diag = diagnoseDevEnv(args.cwd ?? info.cwd, tail || '');
        if (diag) {
          return {
            content: `${diag}\n\n--- raw output ---\n${tail || '(no output)'}`,
            isError: true,
          };
        }
      }
      return {
        content: `Started '${args.name}' — ${status}\nCommand: ${args.command}\nCwd: ${info.cwd}\n\nInitial output:\n${tail || '(no output yet)'}`,
      };
    } catch (e: any) {
      return { content: `[DEV_SERVER_ERROR] ${e?.message ?? String(e)}`, isError: true };
    }
  }
}

const LogArgs = z.object({