chroma-core/chroma · error · ChromaValueError

transaction already has a buffered write for id "${id}"

Error message

transaction already has a buffered write for id "${id}"

What it means

Error "transaction already has a buffered write for id "${id}"" thrown in chroma-core/chroma.

Source

Thrown at clients/new-js/packages/chromadb/src/collection.ts:1706

      operation,
      payload,
    } as ConditionalTransactionOperationPayload);
  }

  private validateBufferedWrite(
    operation: ConditionalTransactionOperationPayload["operation"],
    ids: string[],
  ): void {
    const callIds = new Set<string>();
    for (const id of ids) {
      if (callIds.has(id)) {
        throw new ChromaValueError(
          `transactional write request contains duplicate id "${id}"`,
        );
      }
      callIds.add(id);
      if (this.bufferedWriteIds.has(id)) {
        throw new ChromaValueError(
          `transaction already has a buffered write for id "${id}"`,
        );
      }
      this.validateWritePrecondition(operation, id);
    }
  }

  private validateWritePrecondition(
    operation: ConditionalTransactionOperationPayload["operation"],
    id: string,
  ): void {
    if (operation === "add" && !this.knownAbsent.has(id)) {
      throw new ChromaValueError(
        `transactional add for id "${id}" requires a prior read proving the id is absent`,
      );
    }
    if (operation === "update" && !this.knownPresent.has(id)) {
      throw new ChromaValueError(

View on GitHub (pinned to aecdd12c8a)

When it happens

Trigger: Thrown at clients/new-js/packages/chromadb/src/collection.ts:1706 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of chroma-core/chroma@aecdd12c8a (2026-08-16). Data as JSON: /api/errors/339a30ba2d894ba2. Report an issue: GitHub.