{"record":{"id":"760901cab3fc008b","repo":"ruvnet/ruflo","slug":"agent-card-not-ready","errorCode":null,"errorMessage":"agent_card_not_ready","messagePattern":"agent_card_not_ready","errorType":"http","errorClass":null,"httpStatus":503,"severity":"error","filePath":"v3/@claude-flow/plugin-agent-federation/src/a2a/well-known.ts","lineNumber":83,"sourceCode":"      `A2A agent-card server: refusing non-loopback bind ${host} without allowNonLoopback: true (ADR-166)`,\n    ));\n  }\n\n  const server: Server = createServer((req, res) => {\n    const reqPath = (req.url ?? '').split('?')[0];\n    if (reqPath !== path) {\n      res.writeHead(404, { 'content-type': 'application/json' });\n      res.end(JSON.stringify({ error: 'not_found', agentCardPath: path }));\n      return;\n    }\n    if (req.method !== 'GET' && req.method !== 'HEAD') {\n      res.writeHead(405, { allow: 'GET, HEAD', 'content-type': 'application/json' });\n      res.end(JSON.stringify({ error: 'method_not_allowed' }));\n      return;\n    }\n    const card = options.getCard();\n    if (!card) {\n      res.writeHead(503, { 'content-type': 'application/json', 'retry-after': '5' });\n      res.end(JSON.stringify({ error: 'agent_card_not_ready' }));\n      return;\n    }\n    const body = JSON.stringify(card, null, 2);\n    const etag = `\"${createHash('sha256').update(body).digest('hex').slice(0, 32)}\"`;\n    if (req.headers['if-none-match'] === etag) {\n      res.writeHead(304, { etag });\n      res.end();\n      return;\n    }\n    res.writeHead(200, {\n      'content-type': 'application/json',\n      'cache-control': `public, max-age=${maxAge}`,\n      etag,\n    });\n    res.end(req.method === 'HEAD' ? undefined : body);\n  });\n","sourceCodeStart":65,"sourceCodeEnd":101,"githubUrl":"https://github.com/ruvnet/ruflo/blob/fa13ee4ad60ac2090b1480656eb233521790d640/v3/@claude-flow/plugin-agent-federation/src/a2a/well-known.ts#L65-L101","documentation":"JSON error body returned by the A2A agent-card server when the card provider callback cannot produce a manifest yet (e.g. plugin still initializing or manifest build failed), so the server cannot serve agent-card JSON for the well-known path.","triggerScenarios":"Thrown at v3/@claude-flow/plugin-agent-federation/src/a2a/well-known.ts:83 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Wait for the agent card to finish initializing before requesting the well-known endpoint; retry with backoff."],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fa13ee4ad60ac2090b1480656eb233521790d640","analyzedAt":"2026-08-18T21:34:22.708Z","contentChangedAt":"2026-08-18T21:34:22.708Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}