JuliusBrussee/caveman · error · Error

unknown argument(s): ${unknown.sort().join(", ")}

Error message

unknown argument(s): ${unknown.sort().join(", ")}

What it means

Error "unknown argument(s): ${unknown.sort().join(", ")}" thrown in JuliusBrussee/caveman.

Source

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

  if (cursor !== undefined) {
    if (!cursor || typeof cursor !== "object" || Array.isArray(cursor)) throw new Error("cursor must be an object");
    const unknown = Object.keys(cursor).filter((key) => key !== "sort_value" && key !== "request_id" && key !== "group_key");
    if (unknown.length > 0) throw new Error(`cursor has unknown key(s): ${unknown.sort().join(", ")}`);
    if (typeof cursor.sort_value !== "string" || cursor.sort_value === "") throw new Error("cursor.sort_value is required");
    for (const key of ["request_id", "group_key"]) {
      if (cursor[key] !== undefined && typeof cursor[key] !== "string") throw new Error(`cursor.${key} must be a string`);
    }
  }
}

async function callTool(client: AgentMcpClient, name: string, rawArgs: unknown): Promise<ToolResult> {
  const started = Date.now();
  let outcome: "ok" | "error" = "ok";
  try {
    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;
      }

View on GitHub (pinned to 27d5a3981a)

Solutions

1. Remove the unknown argument(s); check the tool schema for accepted arguments.

When it happens

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