{"record":{"id":"b9190adf0f94bf2a","repo":"headroomlabs-ai/headroom","slug":"invalid-plugin-name-json-stringify-name","errorCode":null,"errorMessage":"invalid plugin name: ${JSON.stringify(name)}","messagePattern":"invalid plugin name: (.+?)","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"sdk/typescript/src/paths.ts","lineNumber":252,"sourceCode":"  return joinPath(workspaceDir(), `.beacon_lock_${Math.trunc(port)}`);\n}\n\n// ---------------------------------------------------------------------------\n// Per-resource helpers -- config bucket\n// ---------------------------------------------------------------------------\n\nexport function modelsConfigPath(): string {\n  if (!isNode()) return \"\";\n  return joinPath(configDir(), \"models.json\");\n}\n\n// ---------------------------------------------------------------------------\n// Plugin-author entry points\n// ---------------------------------------------------------------------------\n\nfunction assertPluginName(name: string): void {\n  if (!name || name.includes(\"/\") || name.includes(\"\\\\\")) {\n    throw new Error(`invalid plugin name: ${JSON.stringify(name)}`);\n  }\n}\n\nexport function pluginConfigDir(pluginName: string): string {\n  assertPluginName(pluginName);\n  if (!isNode()) return \"\";\n  return joinPath(configDir(), \"plugins\", pluginName);\n}\n\nexport function pluginWorkspaceDir(pluginName: string): string {\n  assertPluginName(pluginName);\n  if (!isNode()) return \"\";\n  return joinPath(workspaceDir(), \"plugins\", pluginName);\n}\n","sourceCodeStart":234,"sourceCodeEnd":267,"githubUrl":"https://github.com/headroomlabs-ai/headroom/blob/322425c43bffde1ed0b64fecf3cf5951565dd82b/sdk/typescript/src/paths.ts#L234-L267","documentation":"Error \"invalid plugin name: ${JSON.stringify(name)}\" thrown in headroomlabs-ai/headroom.","triggerScenarios":"Raised when a plugin name fails validation, typically because it contains characters that would be unsafe in a filesystem path.","commonSituations":"See trigger scenarios.","solutions":["Use a plugin name containing only valid path-safe characters (no path separators, '..', or control characters)","Check the provided name ${JSON.stringify(name)} against the plugin naming rules"],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"322425c43bffde1ed0b64fecf3cf5951565dd82b","analyzedAt":"2026-08-15T01:03:05.481Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}