JuliusBrussee/caveman · error · Error

unknown report: ${report}

Error message

unknown report: ${report}

What it means

Error "unknown report: ${report}" thrown in JuliusBrussee/caveman.

Source

Thrown at packages/cli/src/agent-mcp.ts:561

    const args = objectArg(rawArgs);
    const allowed = TOOL_ARGUMENT_KEYS[name];
    const unknown = Object.keys(args).filter((key) => !allowed?.has(key));
    if (unknown.length > 0) throw new Error(`unknown argument(s): ${unknown.sort().join(", ")}`);
    let value: JSONValue;
    switch (name) {
      case "caveman_context": {
        const [identity, projects, selectedProjectId] = await Promise.all([
          client.request("/api/v1/auth/me"),
          client.request("/api/v1/projects"),
          client.projectId(),
        ]);
        value = { identity, projects, selected_project_id: selectedProjectId };
        break;
      }
      case "caveman_report": {
        const report = stringArg(args, "report");
        const reportPath = REPORT_PATHS[report];
        if (!reportPath) throw new Error(`unknown report: ${report}`);
        value = await client.request(await withProjectQuery(client, reportPath));
        break;
      }
      case "caveman_plan": {
        value = await client.request(`/api/v1/projects/${encodeURIComponent(await client.projectId())}/cave-plan`);
        break;
      }
      case "caveman_trace_search": {
        validateTraceSearch(args);
        const projectId = await client.projectId();
        value = await client.request(`/api/v1/traces/search?${new URLSearchParams({ project_id: projectId })}`, {
          method: "POST",
          body: args,
        });
        break;
      }
      case "caveman_trace_get": {
        const traceId = encodeURIComponent(stringArg(args, "trace_id"));

View on GitHub (pinned to 27d5a3981a)

Solutions

1. Use one of the supported report names; the requested report does not exist.

When it happens

Trigger: Thrown at packages/cli/src/agent-mcp.ts:561 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of JuliusBrussee/caveman@27d5a3981a (2026-08-15). Data as JSON: /api/errors/3308079458cd1191. Report an issue: GitHub.