JuliusBrussee/caveman · error · Error

unknown experiment read action: ${action}

Error message

unknown experiment read action: ${action}

What it means

Error "unknown experiment read action: ${action}" thrown in JuliusBrussee/caveman.

Source

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

        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"));
        const projectQuery = `?${new URLSearchParams({ project_id: await client.projectId() })}`;
        const [trace, spans] = await Promise.all([
          client.request(`/api/v1/traces/${traceId}${projectQuery}`),
          client.request(`/api/v1/traces/${traceId}/spans${projectQuery}`),
        ]);
        value = { trace: metadataOnlyTrace(trace), spans: metadataOnlySpans(spans) };
        break;
      }
      case "caveman_experiment_get": {
        const action = stringArg(args, "action");
        if (!["list", "get", "results"].includes(action)) throw new Error(`unknown experiment read action: ${action}`);
        if (action === "list") {
          value = await client.request(await withProjectQuery(client, "/api/v1/experiments"));
          break;
        }
        const experimentId = encodeURIComponent(stringArg(args, "experiment_id"));
        const query = new URLSearchParams({ project_id: await client.projectId() });
        value = await client.request(`/api/v1/experiments/${experimentId}${action === "results" ? "/results" : ""}?${query}`);
        break;
      }
      default:
        throw new Error(`unknown tool: ${name}`);
    }
    return result(value);
  } catch (error) {
    outcome = "error";
    return errorResult(error);
  } finally {
    client.recordToolCall?.({ tool: name, result: outcome, durationMs: Date.now() - started });

View on GitHub (pinned to 27d5a3981a)

Solutions

1. Use a supported experiment read action; the requested action is unknown.

When it happens

Trigger: Thrown at packages/cli/src/agent-mcp.ts:590 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/ad70e11d5d2f08ac. Report an issue: GitHub.