Skip to content

errors

An operation that requires a clean tree found uncommitted changes.

  • object & YieldableError<this>
new DirtyTree(...args): DirtyTree;

…[object, MakeOptions]

DirtyTree

Schema.TaggedError<DirtyTree>()("DirtyTree", {
paths: Schema.Array(Schema.String)
}).constructor
readonly paths: readonly string[];
Schema.TaggedError<DirtyTree>()("DirtyTree", {
paths: Schema.Array(Schema.String)
}).paths

The content hash already belongs to an active file. existingPath is what the caller wanted to create, so a deduped write is answerable without a second query.

  • object & YieldableError<this>
new DuplicateContent(...args): DuplicateContent;

…[object, MakeOptions]

DuplicateContent

Schema.TaggedError<DuplicateContent>()("DuplicateContent", {
contentHash: Schema.String,
existingPath: Schema.String
}).constructor
readonly contentHash: string = Schema.String;
Schema.TaggedError<DuplicateContent>()("DuplicateContent", {
contentHash: Schema.String,
existingPath: Schema.String
}).contentHash
readonly existingPath: string = Schema.String;
Schema.TaggedError<DuplicateContent>()("DuplicateContent", {
contentHash: Schema.String,
existingPath: Schema.String
}).existingPath

A memory that violates the file format or the type/placement vocabulary.

  • object & YieldableError<this>
new InvalidMemory(...args): InvalidMemory;

…[object, MakeOptions]

InvalidMemory

Schema.TaggedError<InvalidMemory>()("InvalidMemory", {
reason: Schema.String
}).constructor
readonly reason: string = Schema.String;
Schema.TaggedError<InvalidMemory>()("InvalidMemory", {
reason: Schema.String
}).reason

The model broke its structured-output contract: an undecodable tool payload, a max_tokens stop, or a refusal. The item is reported with no result, and a violation does not become a value.

  • object & YieldableError<this>
new LlmContractViolation(...args): LlmContractViolation;

…[object, MakeOptions]

LlmContractViolation

Schema.TaggedError<LlmContractViolation>()(
"LlmContractViolation",
{
reason: Schema.String
}
).constructor
readonly reason: string = Schema.String;
Schema.TaggedError<LlmContractViolation>()(
"LlmContractViolation",
{
reason: Schema.String
}
).reason

Bedrock refused the call: throttling, an unavailable model, or a denied region.

  • object & YieldableError<this>
new ModelUnavailable(...args): ModelUnavailable;

…[object, MakeOptions]

ModelUnavailable

Schema.TaggedError<ModelUnavailable>()("ModelUnavailable", {
modelId: Schema.String,
reason: Schema.String
}).constructor
readonly modelId: string = Schema.String;
Schema.TaggedError<ModelUnavailable>()("ModelUnavailable", {
modelId: Schema.String,
reason: Schema.String
}).modelId
readonly reason: string = Schema.String;
Schema.TaggedError<ModelUnavailable>()("ModelUnavailable", {
modelId: Schema.String,
reason: Schema.String
}).reason

A repo-root-relative path with no file behind it.

  • object & YieldableError<this>
new PathNotFound(...args): PathNotFound;

…[object, MakeOptions]

PathNotFound

Schema.TaggedError<PathNotFound>()("PathNotFound", {
path: Schema.String
}).constructor
readonly path: string = Schema.String;
Schema.TaggedError<PathNotFound>()("PathNotFound", {
path: Schema.String
}).path

A driver or filesystem rejection, reduced to the operation that failed. The payload deliberately excludes SQL text, parameters, and row contents so a storage error can be returned to an agent without leaking corpus content; the driver’s own message goes to Effect.logError at the adapter edge instead.

  • object & YieldableError<this>
new StorageFailure(...args): StorageFailure;

…[object, MakeOptions]

StorageFailure

Schema.TaggedError<StorageFailure>()("StorageFailure", {
operation: Schema.String
}).constructor
readonly operation: string = Schema.String;
Schema.TaggedError<StorageFailure>()("StorageFailure", {
operation: Schema.String
}).operation

Two writers touched the same file. ourSha is the blob sha this process wrote from, theirSha the blob sha now in the tree. Recovery belongs to the caller: re-read the current content and reapply.

  • object & YieldableError<this>
new WriteConflict(...args): WriteConflict;

…[object, MakeOptions]

WriteConflict

Schema.TaggedError<WriteConflict>()("WriteConflict", {
path: Schema.String,
ourSha: Schema.String,
theirSha: Schema.String
}).constructor
readonly ourSha: string = Schema.String;
Schema.TaggedError<WriteConflict>()("WriteConflict", {
path: Schema.String,
ourSha: Schema.String,
theirSha: Schema.String
}).ourSha
readonly path: string = Schema.String;
Schema.TaggedError<WriteConflict>()("WriteConflict", {
path: Schema.String,
ourSha: Schema.String,
theirSha: Schema.String
}).path
readonly theirSha: string = Schema.String;
Schema.TaggedError<WriteConflict>()("WriteConflict", {
path: Schema.String,
ourSha: Schema.String,
theirSha: Schema.String
}).theirSha