{"record":{"id":"208bd1a15ca911ee","repo":"ruvnet/ruflo","slug":"ambiguous-inbox-message-messageid-issuer-is-re","errorCode":null,"errorMessage":"ambiguous inbox message ${messageId}; issuer is required","messagePattern":"ambiguous inbox message (.+?); issuer is required","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"v3/@claude-flow/codex/src/harness/in-memory-inbox-reference.ts","lineNumber":139,"sourceCode":"    for (const record of this.records) {\n      if (\n        BigInt(record.cursor) > after\n        && record.message.audience === audience\n        && (record.message.expiresAt === undefined || Date.parse(record.message.expiresAt) > now)\n      ) {\n        yield clone(record.message);\n      }\n    }\n  }\n\n  acknowledge(audience: string, messageId: string, issuer?: string): void {\n    const matches = this.records.filter(\n      (candidate) => candidate.message.audience === audience\n        && candidate.message.messageId === messageId\n        && (issuer === undefined || candidate.message.issuer === issuer),\n    );\n    if (!matches.length) throw new Error(`unknown inbox message ${messageId} for ${audience}`);\n    if (matches.length > 1) throw new Error(`ambiguous inbox message ${messageId}; issuer is required`);\n    const record = matches[0]!;\n    if (record.acknowledgedAt === undefined) record.acknowledgedAt = new Date(this.now()).toISOString();\n  }\n\n  pending(audience: string): InMemoryInboxRecord[] {\n    return this.records\n      .filter((record) => record.message.audience === audience && record.acknowledgedAt === undefined)\n      .map(clone);\n  }\n\n  quarantineRecords(): InMemoryQuarantinedMessage[] {\n    return this.quarantined.map(clone);\n  }\n\n  private parseCursor(cursor: string): bigint {\n    try {\n      return parseCanonicalUnsigned(cursor, 'inbox cursor');\n    } catch {","sourceCodeStart":121,"sourceCodeEnd":157,"githubUrl":"https://github.com/ruvnet/ruflo/blob/fa13ee4ad60ac2090b1480656eb233521790d640/v3/@claude-flow/codex/src/harness/in-memory-inbox-reference.ts#L121-L157","documentation":"Thrown when a message ID matches multiple issuers and no issuer was specified. Defense: always qualify lookups with the expected issuer when the inbox can contain same-ID messages from different issuers.","triggerScenarios":"Thrown at v3/@claude-flow/codex/src/harness/in-memory-inbox-reference.ts:139 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Include the issuer field when fetching the message so the id lookup is unambiguous.","Query with a fully-qualified (issuer, messageId) pair instead of messageId alone."],"exampleFix":null,"handlingStrategy":"try-catch","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"}