{"record":{"id":"f458515172a1edad","repo":"JuliusBrussee/caveman","slug":"tool-schema-transform-invalid-segmentid","errorCode":null,"errorMessage":"tool_schema_transform_invalid:${segmentID}","messagePattern":"tool_schema_transform_invalid:(.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/agent/src/runtime.ts","lineNumber":3804,"sourceCode":"              : \"Use cave_retrieve for omitted detail.\",\n          ].join(\"\\n\"),\n        }],\n        details: {\n          effect: definition.effect,\n          resultPolicy: definition.result,\n          recoveryHandle: transformed.handle,\n          recoveryVerified: true,\n        },\n      };\n    },\n  };\n}\n\nfunction validatedToolSchemaBytes(output: Uint8Array, segmentID: string): Uint8Array {\n  const parsed = JSON.parse(new TextDecoder().decode(output)) as unknown;\n  if (!isRecord(parsed) || typeof parsed.name !== \"string\" ||\n      typeof parsed.description !== \"string\" || !isRecord(parsed.input)) {\n    throw new Error(`tool_schema_transform_invalid:${segmentID}`);\n  }\n  return output;\n}\n\nfunction providerToolDefinition(\n  definition: ToolDefinition,\n  lowered: LoweredContext,\n  appliedPlan: AppliedPlan,\n): { description: string; input: TSchema } {\n  const segment = lowered.ir.segments.find((item) => item.id === `tool.${definition.name}`);\n  if (!segment) throw new Error(`cave_context_segment_missing:tool.${definition.name}`);\n  const body = appliedPlan.bodies.get(segment.bodyHandle);\n  if (!body) throw new Error(`cave_context_body_missing:tool.${definition.name}`);\n  const parsed = JSON.parse(new TextDecoder().decode(body)) as unknown;\n  if (!isRecord(parsed) || parsed.name !== definition.name ||\n      typeof parsed.description !== \"string\" || !isRecord(parsed.input)) {\n    throw new Error(`cave_tool_schema_invalid:${definition.name}`);\n  }","sourceCodeStart":3786,"sourceCodeEnd":3822,"githubUrl":"https://github.com/JuliusBrussee/caveman/blob/27d5a3981a347890211bb1bf2439e5c821a63bc9/packages/agent/src/runtime.ts#L3786-L3822","documentation":"Error \"tool_schema_transform_invalid:${segmentID}\" thrown in JuliusBrussee/caveman.","triggerScenarios":"Thrown at packages/agent/src/runtime.ts:3804 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["The tool schema transform for the segment is invalid; fix the transform definition for that segment."],"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"}