PartialStreamSubmissionError

Error raised when a streamed commit submission fails after an ambiguous or partial append.

The completedOperations field contains operations the SDK knows completed. Before retrying manually, inspect repository state because the failed append may have committed additional operations that were not reflected locally.

See

https://docs.warmhub.ai/sdk/transient-retry/#partial-submissions

Extends

• Error

Constructors

Constructor

new PartialStreamSubmissionError(input): PartialStreamSubmissionError

Parameters

input

cause

unknown

completedOperations

object[]

Returns

PartialStreamSubmissionError

Overrides

Error.constructor

Properties

code

readonly code: "PARTIAL_STREAM_SUBMISSION" = 'PARTIAL_STREAM_SUBMISSION'

Stable error code. Always 'PARTIAL_STREAM_SUBMISSION'.

---

completedOperations

readonly completedOperations: object[]

Operations the SDK confirmed completed before the ambiguous or failing append. The remaining operations may or may not have landed; inspect repository state before retrying manually.

opIndex?

optional opIndex?: number

name

name: string

operation

operation: "add" | "revise" | "retract" | "noop"

dataHash

dataHash: string

version

version: number

status?

optional status?: "noop" | "applied" | "error"

error?

optional error?: object

error.code

code: string

error.message

message: string

error.details?

optional details?: { reason: "expected_version_mismatch"; expectedVersion: number; currentVersion: number; } | { reason: "lease_held"; leaseExpiresAt: string; }

submittedName?

optional submittedName?: string

resolvedName?

optional resolvedName?: string

retryable?

optional retryable?: boolean

warnings?

optional warnings?: object

Non-blocking warnings collected during shape validation — see GH-1418. Aliased to the generated wire shape so this type cannot drift from the backend’s streamMutationResultEntrySchema.warnings.

warnings.undeclaredFields

undeclaredFields: string[]

warnings.undeclaredFieldsTruncated?

optional undeclaredFieldsTruncated?: true

warnings.totalUndeclared?

optional totalUndeclared?: number

---

cause

readonly cause: unknown

Underlying error that triggered the partial submission, preserved for diagnostics. Inspect via isWarmHubError(err.cause) / err.cause.kind.

Overrides

Error.cause