{"record":{"id":"0a616860cb5af92b","repo":"koala73/worldmonitor","slug":"query-must-be-a-string","errorCode":null,"errorMessage":"query must be a string.","messagePattern":"query must be a string\\.","errorType":"validation","errorClass":"SafeWebMcpError","httpStatus":null,"severity":"error","filePath":"src/services/webmcp.ts","lineNumber":2462,"sourceCode":"            description: 'Maximum number of concise results to return.',\n            minimum: 1,\n            maximum: MAX_SEARCH_RESULTS,\n            default: DEFAULT_SEARCH_RESULTS,\n          },\n        },\n        required: ['query'],\n        additionalProperties: false,\n      },\n      annotations: { readOnlyHint: true, untrustedContentHint: true },\n      execute: withInvocationLogging(WEBMCP_SPA_TOOL.searchDashboard, async (args, extra) => {\n        if (!hasOnlyOwnKeys(args, ['query', 'scope', 'limit'])) {\n          throw new SafeWebMcpError(\n            'search_dashboard accepts only query, scope, and limit.',\n            'validation',\n          );\n        }\n        if (typeof args.query !== 'string') {\n          throw new SafeWebMcpError('query must be a string.', 'validation');\n        }\n        if (args.query.length > MAX_SEARCH_QUERY_CHARS) {\n          throw new SafeWebMcpError(\n            `query must be at most ${MAX_SEARCH_QUERY_CHARS} characters.`,\n            'validation',\n          );\n        }\n        const query = args.query.trim();\n        if (!query) throw new SafeWebMcpError('query must not be empty.', 'validation');\n\n        const scope = args.scope === undefined ? 'all' : args.scope;\n        if (typeof scope !== 'string' || !DASHBOARD_SEARCH_SCOPES.has(scope as DashboardSearchScope)) {\n          throw new SafeWebMcpError(\n            'scope must be one of: all, signals, map, panels, actions.',\n            'validation',\n          );\n        }\n        const limit = args.limit === undefined ? DEFAULT_SEARCH_RESULTS : args.limit;","sourceCodeStart":2444,"sourceCodeEnd":2480,"githubUrl":"https://github.com/koala73/worldmonitor/blob/9361220cc013571781071f0206e4d80fd14b2f7f/src/services/webmcp.ts#L2444-L2480","documentation":"SafeWebMcpError thrown by the search_dashboard tool's execute guard when the query argument is not a string (missing, number, object, etc.). It is a manual input-shape check that backstops the JSON schema, classed as a validation error for the MCP client.","triggerScenarios":"Thrown at src/services/webmcp.ts:759 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Send query as a JSON string in the tool arguments","Fix the calling MCP client's argument serialization"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"9361220cc013571781071f0206e4d80fd14b2f7f","analyzedAt":"2026-08-21T16:51:25.751Z","contentChangedAt":"2026-08-21T16:51:25.751Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}