{"record":{"id":"b7eed3d079d30de7","repo":"paperclipai/paperclip","slug":"worker-unavailable","errorCode":"WORKER_UNAVAILABLE","errorMessage":"Plugin is not ready (current status: ${plugin.status})","messagePattern":"Plugin is not ready \\(current status: (.+?)\\)","errorType":"error_code","errorClass":null,"httpStatus":502,"severity":"error","filePath":"server/src/routes/plugins.ts","lineNumber":1418,"sourceCode":"\n    if (!bridgeDeps) {\n      res.status(501).json({ error: \"Plugin bridge is not enabled\" });\n      return;\n    }\n\n    const { pluginId } = req.params;\n\n    // Resolve plugin\n    const plugin = await resolvePlugin(registry, pluginId);\n    if (!plugin) {\n      res.status(404).json({ error: \"Plugin not found\" });\n      return;\n    }\n\n    // Validate plugin is in ready state\n    if (plugin.status !== \"ready\") {\n      const bridgeError: PluginBridgeErrorResponse = {\n        code: \"WORKER_UNAVAILABLE\",\n        message: `Plugin is not ready (current status: ${plugin.status})`,\n      };\n      attachPluginBridgeErrorContext(req, res, new Error(bridgeError.message), bridgeError, {\n        pluginId: plugin.id,\n        pluginKey: plugin.pluginKey,\n        bridgeMethod: \"getData\",\n      });\n      res.status(502).json(bridgeError);\n      return;\n    }\n\n    // Validate request body\n    const body = req.body as PluginBridgeDataRequest | undefined;\n    if (!body || !body.key || typeof body.key !== \"string\") {\n      res.status(400).json({ error: '\"key\" is required and must be a string' });\n      return;\n    }\n","sourceCodeStart":1400,"sourceCodeEnd":1436,"githubUrl":"https://github.com/paperclipai/paperclip/blob/a7e689b3c35347b529cb9f54c9b9a8575a3dcab6/server/src/routes/plugins.ts#L1400-L1436","documentation":"State guard on the plugin bridge endpoint: the plugin exists in the registry but its lifecycle status is not 'ready' (e.g. installing, error, disabled), so its worker cannot accept bridged requests and the route returns WORKER_UNAVAILABLE with the current status.","triggerScenarios":"Thrown at server/src/routes/plugins.ts:1402 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Wait until the plugin reaches a ready status, or resolve the plugin's current status issue, then retry."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"a7e689b3c35347b529cb9f54c9b9a8575a3dcab6","analyzedAt":"2026-08-18T22:49:45.177Z","contentChangedAt":"2026-08-18T22:49:45.177Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}