{"record":{"id":"bedbf2202c9e6af9","repo":"JuliusBrussee/caveman","slug":"cave-tool-search-query-required","errorCode":null,"errorMessage":"cave_tool_search_query_required","messagePattern":"cave_tool_search_query_required","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/agent/src/runtime.ts","lineNumber":3067,"sourceCode":"      };\n    },\n  };\n}\n\nfunction toolSchemaSearchTool(\n  handles: ReadonlySet<string>,\n  engineBin: string | undefined,\n  trace?: MutableTransformTrace[],\n): AgentTool<TSchema> {\n  return {\n    name: \"cave_search_tools\",\n    label: \"cave_search_tools\",\n    description: \"Search exact original tool definitions when compacted annotations are insufficient.\",\n    parameters: Type.Object({ query: Type.String() }),\n    executionMode: \"parallel\",\n    async execute(_toolCallId, params) {\n      const query = (params as { query: string }).query.trim().toLowerCase();\n      if (query === \"\") throw new Error(\"cave_tool_search_query_required\");\n      const terms = tokenize(query);\n      const hits: Array<{ score: number; value: Record<string, unknown>; handle: string }> = [];\n      for (const handle of handles) {\n        const original = await engineRetrieve(handle, undefined, engineBin);\n        let parsed: unknown;\n        try {\n          parsed = JSON.parse(new TextDecoder().decode(original));\n        } catch {\n          continue;\n        }\n        if (!isRecord(parsed) || typeof parsed.name !== \"string\" ||\n            typeof parsed.description !== \"string\" || !isRecord(parsed.input)) continue;\n        const haystack = `${parsed.name} ${parsed.description} ${JSON.stringify(parsed.input)}`.toLowerCase();\n        const score = terms.reduce((total, term) => total + (haystack.includes(term) ? 1 : 0), 0);\n        if (score > 0) hits.push({ score, value: parsed, handle });\n      }\n      hits.sort((first, second) => second.score - first.score ||\n        String(first.value.name).localeCompare(String(second.value.name)));","sourceCodeStart":3049,"sourceCodeEnd":3085,"githubUrl":"https://github.com/JuliusBrussee/caveman/blob/27d5a3981a347890211bb1bf2439e5c821a63bc9/packages/agent/src/runtime.ts#L3049-L3085","documentation":"Error \"cave_tool_search_query_required\" thrown in JuliusBrussee/caveman.","triggerScenarios":"Thrown at packages/agent/src/runtime.ts:3067 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Pass a non-empty query string to the tool search call."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"27d5a3981a347890211bb1bf2439e5c821a63bc9","analyzedAt":"2026-08-15T09:26:11.751Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}