NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #2106 most downloaded on npm
The missing standard library for TypeScript, for writing production-grade software.
Latest stable
4.1.4
Last release 9 days ago
11 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Some releases are documented
notes for 16 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
499 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Updated dependencies [`8567117`, `3f5c6aa`, `29b89b6`, `0b4cfbc`, `088510f`, `ad62cd7`, `ba406a5`, `5e56eba`, `6a95d51`, `24d5acd`, `c38dfa0`, `f2755e
8567117, 3f5c6aa, 29b89b6, 0b4cfbc, 088510f, ad62cd7, ba406a5, 5e56eba, 6a95d51, 24d5acd, c38dfa0, f2755e7, a40cb20, bd6b9c2, 49d84d6, a8f77d5, 7a9c22f, efcb8cc, 378f5f0, d4272bd, 7d6ead4, 59178ce, 9394b6d, 5d3f066, 49d84d6, 2863a22, 49d84d6, 49d84d6, 20cca92, 1f22f02, dd2b7a3, 52f4e42, 194dd79, c5de00a, 460827e, 0325583, 20bef50, 2f50b91, b41529e, 80954c9, 5daca23, c96c31e, 136ddf9, 5ca262e, 898b049, 73e6ea1, 937f170, f5f96b2, 1946637, 197ce1d, b49120e, 33d3088]:
Your coding agent can read these notes before it upgrades. Set up the MCP server →
#10186 8567117 Thanks @effect-bot! - Restore SchemaBinary.toCodec derivation for Prompt.FilePart and the AI response part schemas that include it.
#10119 3f5c6aa Thanks @Marve10s! - Fix AtomRegistry.subscribe without immediate never notifying for an atom that has not been read yet. Subscribing now builds the atom, so the listener hears later changes. This also fixes get.subscribe, get.stream with withoutInitialValue, and useAtomSubscribe in @effect/atom-react.
A failed build no longer makes subscribe throw: the next read reports the failure, and the listener hears the recovery. An error thrown by a failed build's finalizer no longer aborts the next build; it is reported once that build has its value.
#10189 29b89b6 Thanks @tim-smart! - Speed up Base64Url.decode and Base64Url.decodeString by decoding the URL-safe alphabet directly, instead of transliterating the input and decoding it again as standard Base64.
#10188 0b4cfbc Thanks @effect-bot! - Limit BigDecimal scales to prevent resource exhaustion.
BigDecimal.fromString and Schema.BigDecimalFromString reject strings whose scale, before or after removing trailing zeros, is outside ±10,000, such as "1e300000000", "10e10000" or more than 10,000 fractional digits. BigDecimal.fromStringUnsafe throws for them.sum, subtract, remainder, scale, round, truncate, ceil, floor) throw a RangeError when the scales differ by more than 20,000.round returns values already at or below the target scale unchanged.#10192 088510f Thanks @effect-bot! - Enforce MaxBodySize on buffered request body reads in BunHttpServer, DenoHttpServer, and HttpServerRequest.fromClientRequest.
#10142 ad62cd7 Thanks @effect-bot! - Add onRejection to CircuitBreaker.execute. With "allow", a call the circuit would refuse with CircuitOpen or CircuitHalfOpen runs unrecorded instead, while a call the circuit admits, probe included, is recorded as usual. Calls that must always run can then still count towards the breaker's state. Defaults to "fail", which keeps the current behavior.
#10169 ba406a5 Thanks @tim-smart! - Pass { probe } to CircuitBreaker classify callbacks, including HttpClient.withCircuitBreaker. probe is true when the call is the HalfOpen probe, so a classifier can count an outcome it otherwise ignores, such as a rate-limited response, as a failure that reopens the circuit. Existing one-argument classifiers are unchanged. The callback type is exported as CircuitBreaker.Classifier.
#10126 5e56eba Thanks @baptisteArno! - Fix ClickhouseMigrator failing to create its migrations table or record applied migrations, by running those statements as ClickHouse commands instead of queries. Migrator.make accepts an optional transformWrites option for these statements, defaulting to identity.
#10206 6a95d51 Thanks @effect-bot! - Retry transient PersistenceErrors when a cluster workflow sends an activity or reads its reply during a pending interrupt, instead of storing the failure as a workflow defect. A request whose save was committed but not acknowledged is deduplicated, so the activity still runs once.
A cluster client request whose send fails is no longer retained by Sharding.
#10205 24d5acd Thanks @effect-bot! - Fix local callers of persisted entity requests hanging when a reply save commits but reports a failure, for example when the connection drops before the COMMIT acknowledgement arrives. The runner now checks storage for the committed reply and lets the caller read it, without replaying the request.
#10163 c38dfa0 Thanks @effect-bot! - Fix persisted success replies being stored after a ClusterSchema.WithTransaction request transaction rolled back. A failed save inside the request transaction is no longer retried, since a retry could autocommit the reply outside the aborted transaction (for example after a MySQL deadlock). The failed transaction now replays the request instead.
#10197 f2755e7 Thanks @effect-bot! - Fix type-checking the effect crypto declarations with @types/node 22 or 24 and without the DOM library. The *FromCryptoKey constructors in Aead, Cipher, KeyAgreement, KeyWrap, Mac and Signature now accept the new structural WebCrypto.CryptoKey type instead of the global CryptoKey, and DOM and Node Web Crypto keys are both assignable to it. The WebCrypto reference and WebCrypto.layer now use the type of globalThis.crypto instead of the global Crypto type.
#10137 a40cb20 Thanks @effect-bot! - Fix DateTime.Zoned exposing its adjustedEpochMilliseconds cache as an enumerable property after DateTime.toDate, which broke Object.keys, spread and deep equality.
#10174 bd6b9c2 Thanks @effect-bot! - Speed up DateTime construction by creating the partsUtc, adjustedEpochMilliseconds and partsAdjusted cache properties on first use. Reading and writing these fields is unchanged, but Object.hasOwn, Object.getOwnPropertyNames and Object.getOwnPropertyDescriptor no longer report them before the caches are populated, or at all on instances sealed or frozen before first use. Reading the parts of, or writing these fields on, an instance frozen before first use no longer throws.
#10082 49d84d6 Thanks @typedrat! - Fix Equal.equals and Hash.hash throwing on plain objects whose "~effect/Equal" or "~effect/Hash" key is not a function. Such values are now treated as data.
#10185 a8f77d5 Thanks @effect-bot! - Verify the session authentication signature before an EventLog server binds a signing key to an identity, and reject a verified key that differs from the identity's existing binding. A request with an invalid signature no longer creates a binding.
EventLogServerUnencrypted.EventLogServerAuthorization.authorizeIdentity and the authorizeIdentity option of EventLogServer.layerRpcHandlers now also receive the presented signing public key. Use the new EventLogSessionAuth.deriveSigningPublicKey to record an identity's signing key at provisioning time and reject any other key.
#10164 7a9c22f Thanks @effect-bot! - Stop finished fibers from retaining their last span and stack frame. A finished fiber kept alive by a cache entry, observer or Deferred no longer keeps the ended span's parent chain, and the success values recorded on those spans, from being garbage collected.
#10145 efcb8cc Thanks @jpowersdev! - Fix Host.domainNameFromString rejecting decomposed Unicode domain names.
#10125 378f5f0 Thanks @pujitha24! - Fix Effect.request retaining completed requests and their async context in its batch pool.
#10208 d4272bd Thanks @effect-bot! - Stop GraphQL calls from succeeding on non-2xx HTTP responses. A non-2xx GraphQL body without errors, including { data: null }, now fails with a TransportError carrying the HTTP status, headers and Retry-After, so retry policies on isRetryable apply. A non-2xx body with data and errors fails with a ResponseError even with { partial: true }.
#10207 7d6ead4 Thanks @effect-bot! - Add HttpClient.timeout, which fails requests that receive no response within the given duration with an HttpClientError wrapping a TransportError, so the timed client keeps the standard HttpClient service type and is retried by retryTransient. The timeout covers the wrapped client until it returns a response, which for a plain client is when the response headers arrive; body reads after that are not covered.
#10166 59178ce Thanks @tkr109! - Fix Iterable.takeWhile iterators yielding values or pulling from the source after they have returned done.
#10070 9394b6d Thanks @effect-bot! - Fix SchemaRepresentation.fromJsonSchemaDocument rejecting objects whose anyOf / oneOf branches are combined with sibling properties that contain an enum, such as branches redeclaring an enum property already declared by the object.
#10116 5d3f066 Thanks @skyaara! - Declare KeyFormat.JsonWebKey instead of referencing the DOM library's global JsonWebKey, so effect declarations type-check with Node-only types.
#10082 49d84d6 Thanks @typedrat! - Add MCP Skills extension (SEP-2640) support. Servers publish skills with McpServer.skill or McpServer.registerSkill. Clients opt in with extensions: { skills: true } and use listSkills, getSkill, readResourceDirectory and readSkillResource, which verifies files against the listed digests and frontmatter.
#10089 2863a22 Thanks @creatifcoding! - Fix McpServer toolkit results whose encoded success is not JSON, such as a Schema.Void, Schema.Date or Schema.optional field, failing tools/call with an internal error. structuredContent and its text mirror now use the same JSON encoding as the advertised outputSchema.
#10082 49d84d6 Thanks @typedrat! - Fix McpServer returning an internal error from resources/list and resources/templates/list on v2026_07_28 when an optional resource field is undefined.
#10082 49d84d6 Thanks @typedrat! - Recognize .py and .sh files in Mime.getType.
#10204 20cca92 Thanks @jpowersdev! - Ndjson.decode and Ndjson.decodeString now also skip lines containing only spaces or tabs when ignoreEmptyLines is enabled.
#10191 1f22f02 Thanks @jpowersdev! - Fix OtlpSerialization.layerJson writing bytesValue data as plain objects instead of base64 strings. Uint8Array views and Node Buffers are now encoded as OTLP/JSON expects.
#10152 dd2b7a3 Thanks @jpowersdev! - Fix Path.format dropping the dot before extensions given without one, such as ext: "csv".
#10157 52f4e42 Thanks @effect-bot! - Stop PgClient transactions from staying open after a pooler drops their prepared statements.
#10129 194dd79 Thanks @Gourav224! - Fix Pool.get and Pool.use hanging in finalizers registered after the pool once its idle items expire. The pool now runs in a child scope that stays open until the pool shuts down.
#10104 c5de00a Thanks @tim-smart! - Speed up FileSystem.glob by reading subdirectories concurrently, in at most 16 forked fibers per call plus the calling fiber, and only forking a fiber for directory entries that need a stat or readLink. Results and their order are unchanged.
#10098 460827e Thanks @effect-bot! - Reclaim expired keys in RateLimiter.layerStoreMemory. Each entry now expires once its state is indistinguishable from an unseen key, matching the TTLs of the Redis store, and a background sweep scoped to the layer removes expired entries every minute, so an idle store drains to empty instead of retaining every key it has seen.
#10103 0325583 Thanks @effect-bot! - Fix RateLimiter handling of zero and negative limits:
RateLimiterStore.fixedWindow now honors a zero limit in the memory and Redis stores.RateLimiter.consume now returns an infinite delay for a nonpositive limit instead of admitting requests.#10167 20bef50 Thanks @tim-smart! - Remove the Effect.request batch pool and allocate a new batch for each batch key.
#10171 2f50b91 Thanks @effect-bot! - Document that a request accepted by an RpcClient.Protocol stays pending until a reply names it, and how a transport that only delivers requests acknowledges discard calls and rejects the rest.
#10121 b41529e Thanks @Marve10s! - Fail discarded RPC calls (discard: true) promptly on transport errors.
A discarded call waited for its pending send to finish before reporting any failure. While a socket was disconnected the call hung instead of failing, and once it reconnected the request was still sent and the handler ran. Failures now complete the call immediately and interrupt the pending send. Successful acknowledgements still wait for the send to finish.
#10138 80954c9 Thanks @effect-bot! - Fix RpcClient acknowledging stream chunks dropped by an interrupted consumer, which could drain the entire server stream before the interrupt was sent.
#10133 5daca23 Thanks @aidenlx! - Fix Rpc.SuccessChunk resolving to never for a union of RPCs.
#10120 c96c31e Thanks @Marve10s! - Fail only the affected calls when an RpcClient.layerProtocolWorker worker crashes.
#10190 136ddf9 Thanks @effect-bot! - Brand SQL fragments and segments with the new Statement.FragmentTypeId and Statement.SegmentTypeId symbols, so sql interpolation binds plain objects shaped like fragments or segments as parameters instead of SQL; build fragments and segments with the Statement constructors.
#10141 5ca262e Thanks @effect-bot! - Document how to retry serialization failures and deadlocks with SqlClient.withTransaction.
#10148 898b049 Thanks @effect-bot! - Encode HttpApiSchema.StreamSse data values with the schema's JSON codec, so schemas such as Schema.Date, Schema.BigInt and Schema.Option round-trip through SSE events and are documented accurately in OpenAPI.
#10182 73e6ea1 Thanks @effect-bot! - Sse.encoder now removes CR and LF from event id and event values, and NUL from id values, so they cannot add fields or events to the encoded stream.
#10105 937f170 Thanks @tim-smart! - Speed up Glob.match by tracking match states as a bitmask and reading path segments without splitting the path. Patterns such as *.ts that are a literal prefix and suffix around one * are also checked without backtracking, which helps FileSystem.glob too.
#10177 f5f96b2 Thanks @jpowersdev! - Fix OtlpSerialization.layerProtobuf throwing on metric data points without startTimeUnixNano.
#10049 1946637 Thanks @lloydrichards! - Add McpClient server capabilities, discovery page and item limits, and toolkit options for approved tool snapshots, complete results, returned failures, trusted annotations and tool customization.
#10181 197ce1d Thanks @effect-bot! - Fix Tool.unsafeSecureJsonParse accepting Unicode-escaped __proto__ and constructor keys. JSON text containing a \u escape is now always scanned, so escaped spellings throw a SyntaxError like their literal forms. Objects with a null constructor value are accepted instead of throwing a TypeError.
#9883 b49120e Thanks @danieljvdm! - Add unstable effect/jose modules for JWKs (generation, PEM/DER conversion and thumbprints), compact JWS and JWE, schema-typed signed and encrypted JWTs with decryption key resolvers, and local or remote JWKS resolution.
#10146 33d3088 Thanks @effect-bot! - Wake a parent workflow when its suspended child is interrupted with ClusterWorkflowEngine, and surface the child's interruption to the parent as a defect from Child.execute so the parent completes instead of replaying.
bf785db Thanks @Marve10s! - Fix insert commands failing to decode for AnthropicTool.TextEditor_20250429 and TextEditor_20250728, which send insert_text. These versions now use the new TextEditorInsertTextCommand schema. TextEditorInsertCommand is unchanged and keeps new_str for TextEditor_20241022 and TextEditor_20250124.8567117, 3f5c6aa, 29b89b6, 0b4cfbc, 088510f, ad62cd7, ba406a5, 5e56eba, 6a95d51, 24d5acd, c38dfa0, f2755e7, a40cb20, bd6b9c2, 49d84d6, a8f77d5, 7a9c22f, efcb8cc, 378f5f0, d4272bd, 7d6ead4, 59178ce, 9394b6d, 5d3f066, 49d84d6, 2863a22, 49d84d6, 49d84d6, 20cca92, 1f22f02, dd2b7a3, 52f4e42, 194dd79, c5de00a, 460827e, 0325583, 20bef50, 2f50b91, b41529e, 80954c9, 5daca23, c96c31e, 136ddf9, 5ca262e, 898b049, 73e6ea1, 937f170, f5f96b2, 1946637, 197ce1d, b49120e, 33d3088]:
52f4e42 Thanks @effect-bot! - Stop PgClient transactions from staying open after a pooler drops their prepared statements.8567117, 3f5c6aa, 29b89b6, 0b4cfbc, 088510f, ad62cd7, ba406a5, 5e56eba, 6a95d51, 24d5acd, c38dfa0, f2755e7, a40cb20, bd6b9c2, 49d84d6, a8f77d5, 7a9c22f, efcb8cc, 378f5f0, d4272bd, 7d6ead4, 59178ce, 9394b6d, 5d3f066, 49d84d6, 2863a22, 49d84d6, 49d84d6, 20cca92, 1f22f02, dd2b7a3, 52f4e42, 194dd79, c5de00a, 460827e, 0325583, 20bef50, 2f50b91, b41529e, 80954c9, 5daca23, c96c31e, 136ddf9, 5ca262e, 898b049, 73e6ea1, 937f170, f5f96b2, 1946637, 197ce1d, b49120e, 33d3088]:
5e56eba Thanks @baptisteArno! - Fix ClickhouseMigrator failing to create its migrations table or record applied migrations, by running those statements as ClickHouse commands instead of queries. Migrator.make accepts an optional transformWrites option for these statements, defaulting to identity.8567117, 3f5c6aa, 29b89b6, 0b4cfbc, 088510f, ad62cd7, ba406a5, 5e56eba, 6a95d51, 24d5acd, c38dfa0, f2755e7, a40cb20, bd6b9c2, 49d84d6, a8f77d5, 7a9c22f, efcb8cc, e1b4d37, 378f5f0, d4272bd, 7d6ead4, 59178ce, 9394b6d, 5d3f066, 49d84d6, 2863a22, 49d84d6, 49d84d6, 20cca92, 7a4f627, dee85c4, 1f22f02, dd2b7a3, 52f4e42, 194dd79, c5de00a, 460827e, 0325583, 20bef50, 2f50b91, b41529e, 80954c9, 5daca23, c96c31e, 136ddf9, 5ca262e, 898b049, 73e6ea1, 937f170, f5f96b2, 1946637, 197ce1d, b49120e, 33d3088]:
#10100 e1b4d37 Thanks @niieani! - Fix NodeRedis scope finalization hanging on pending handshakes or stalled commands. The shared client is now destroyed immediately when its scope closes, failing in-flight commands and aborting pending connection attempts.
#10153 7a4f627 Thanks @effect-bot! - Raise the redis peer dependency minimum to 5.1.0. NodeRedis imports SocketTimeoutError, which redis 5.0.x does not export, so it failed to load under native ESM with those versions.
#10156 dee85c4 Thanks @effect-bot! - Make NodeRedis subscriber and reserved-connection acquisition interruptible. Interrupting Redis.subscribe while its connection or SUBSCRIBE is stalled now completes promptly and closes the connection. Closing the layer scope while a reserved connection is still being established now closes it promptly instead of waiting for the attempt to settle or leaking it.
Updated dependencies [8567117, 3f5c6aa, 29b89b6, 0b4cfbc, 088510f, ad62cd7, ba406a5, 5e56eba, 6a95d51, 24d5acd, c38dfa0, f2755e7, a40cb20, bd6b9c2, 49d84d6, a8f77d5, 7a9c22f, efcb8cc, 378f5f0, d4272bd, 7d6ead4, 59178ce, 9394b6d, 5d3f066, 49d84d6, 2863a22, 49d84d6, 49d84d6, 20cca92, 1f22f02, dd2b7a3, 52f4e42, 194dd79, c5de00a, 460827e, 0325583, 20bef50, 2f50b91, b41529e, 80954c9, 5daca23, c96c31e, 136ddf9, 5ca262e, 898b049, 73e6ea1, 937f170, f5f96b2, 1946637, 197ce1d, b49120e, 33d3088]:
088510f Thanks @effect-bot! - Enforce MaxBodySize on buffered request body reads in BunHttpServer, DenoHttpServer, and HttpServerRequest.fromClientRequest.8567117, 3f5c6aa, 29b89b6, 0b4cfbc, 088510f, ad62cd7, ba406a5, 5e56eba, 6a95d51, 24d5acd, c38dfa0, f2755e7, a40cb20, bd6b9c2, 49d84d6, a8f77d5, 7a9c22f, efcb8cc, 378f5f0, d4272bd, 7d6ead4, 59178ce, 9394b6d, 5d3f066, 49d84d6, 2863a22, 49d84d6, 49d84d6, 20cca92, 1f22f02, dd2b7a3, 52f4e42, 194dd79, c5de00a, 460827e, 0325583, 20bef50, 2f50b91, b41529e, 80954c9, 5daca23, c96c31e, 136ddf9, 5ca262e, 898b049, 73e6ea1, 937f170, f5f96b2, 1946637, 197ce1d, b49120e, 33d3088]:
Updated dependencies [`631d4f4`, `7ea1ea2`, `a2ccc14`, `ed20129`, `20795b9`, `a8e5e6c`, `c4d298d`, `fb5dbee`, `8309b94`, `ac10e55`, `af23904`, `df8dce
631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
be9895b Thanks @bezff! - Move fromFileSystem from effect/sql/Migrator to effect/sql/MigratorFileSystem, so React Native apps can import effect/sql/Migrator and effect/sql under Metro. The effect/sql barrel and @effect/sql-sqlite-react-native/SqliteMigrator no longer export fromFileSystem; the other SQL adapter migrators still re-export it.631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
#8829 631d4f4 Thanks @harrysolovay! - Add Schema.isAscii, a check that accepts only ASCII strings, and the matching SchemaRepresentation.isAsciiReviver.
#8829 7ea1ea2 Thanks @wmaurer! - Add an optional cause to the AI NetworkError. It holds the HttpClientError the request failed with, stored unchanged and not redacted, so the reason a request failed is no longer lost. The new NetworkError.fromHttpClientError sets it, and all AI providers now use it. NetworkError.fromRequestError is unchanged.
#8829 a2ccc14 Thanks @fubhy! - Fix Atom.Serializable to encode to and decode from Schema.Json, matching the JSON codec used by Atom.serializable. Encoded results may now require narrowing; runtime behavior is unchanged.
#8829 c4d298d Thanks @okarin1511! - Render inherited CLI flags in a separate INHERITED FLAGS section and add "full", "summary", and "none" modes for inherited and global flags in CliOutput.defaultFormatter. HelpDoc adds inheritedFlags, commandPath, and globalFlagsScope provenance so summaries can point to the appropriate help, with globals always listed on their declaring command. Custom formatters must read ancestor shared flags from HelpDoc.inheritedFlags instead of HelpDoc.flags.
#10087 ac10e55 Thanks @effect-bot! - Add runnerJoinDebounce to ShardingConfig. When set, a runner joining the cluster is only added to shard assignments once the healthy runners have stayed unchanged for that duration, or at most four times that duration after the first pending join. A scale-up or a deployment with a large surge then hands each shard off once instead of once per join. Runners that already hold shards and leave or become unhealthy are still published immediately; a pending runner that leaves only restarts the quiet period. While joins are pending, runners take no new shards, so a shard can stay unlocked briefly until each runner publishes. Defaults to 0, which keeps the current behavior.
#8829 df8dce5 Thanks @tim-smart! - Add trim and keepEmptyValues options to SchemaGetter.splitKeyValue, SchemaTransformation.splitKeyValue and Config.Record. Both default to false, so existing callers are unaffected.
OtlpResource.fromConfig now trims OTEL_RESOURCE_ATTRIBUTES keys and values and keeps entries with an empty value as "".
#8829 0c24a8f Thanks @sledorze! - Add a maxDepth option to Context.makeUnsafe, controlling how many Context.add calls are kept as overlays before the context is rebased into a flat map. Defaults to 8.
#8829 2d1fcd4 Thanks @effect-bot! - Add an onDstOverlap option to Cron and Schedule.cron that chooses which occurrences of local times repeated when clocks fall back are included: "earlier" (default), "later" or "both". It applies to every repeated local time, including ones not caused by daylight saving time.
Cron.prev now returns the latest matching instant before its input when starting inside a repeated hour. Near a spring-forward gap it no longer throws or returns an instant at or after its input.
#8829 8f23668 Thanks @fubhy! - Replace effect/Crypto with family-specific effect/crypto/* services, opaque keys, CryptoError, a configurable WebCrypto reference and key schemas in effect/Schema. Encoding secret or private keys through byte/format schemas requires { allowEncode: true }.
SecureRandom for randomness and UUIDs, and Digest with algorithm values such as Digest.sha256 for hashing. Replace effect/testing/TestCrypto with Layer.mock for the required services.*Services bundles. NodeCrypto, BunCrypto, DenoCrypto and BrowserCrypto offer individual family layers and a combined layer, supplying SecureRandom where needed. Core modules offer layerWebCrypto.Digest.Digest instead of Crypto.Crypto to SqlMessageStorage and SingleRunner, and instead of EventLogEncryption to SqlEventLogServerEncrypted.makeStorage and layerStorage. Replace EventLogEncryption.sha256String with digest.digestHex(Digest.sha256, bytes).Existing workflow ID, activity idempotency key and event log table-name encodings are unchanged.
Event log encryption, identity key derivation and session authentication now run on Aead, Digest, Signature and SecureRandom. EventLogEncryption.make and EventLogEncryption.layer take those services from context, so Node apps can use the NodeCrypto layers. EventLogEncryption.layerSubtle and the session auth functions use the Web Crypto layers on the WebCrypto reference instead of globalThis.crypto. Existing identities, derived signing keys and encrypted batches are unchanged.
UUIDv7 and ULID generation is now monotonic below the maximum 48-bit timestamp, including within a millisecond and across clock rollback. Ordering is per SecureRandom instance; the unsafe helpers and model UUIDv7 defaults share per-realm ordering.
#8829 3f8f359 Thanks @jem-computer! - Declare decision images as input fields with Decision.Image, and add Decision.locate, which answers with a bounding box around one target in an image field.
DecideOptions.images is removed. Add Decision.Image fields to the input schema and refer to each image by its path in instructions:
// Before
DecisionModel.decide(Triage, { input: "Checkout error", images: [screenshot] })
// After
const Triage = Decision.make({
input: Schema.Struct({ report: Schema.String, screenshot: Decision.Image }),
decisions
})
DecisionModel.decide(Triage, { input: { report: "Checkout error", screenshot } })
Custom providers receive images as { reference, path, image }, with each image replaced by its reference in state and its data as a base64 string or URL.
Decision.locate({ image: "photo", instructions }) takes a path that Decision.make checks against the input's image fields. Providers opt in with supportsLocate: true. Decision.Any and DecisionModel.ProviderAnswer gain locate variants, so exhaustive switches over them need a Locate case.
TypeSafeDecisionModel supports images, sent as assets keyed by reference, and sends locate decisions as Box questions, which need jev-preview or jev-1.14.0. OpenAI and Cloudflare label each image with its reference.
#8829 2a03584 Thanks @jayhemnani9910! - Add Duration.formatIso, Duration.fromIso and Schema.DurationFromIsoString for ISO 8601 durations. Only exact units are supported: weeks, days, hours, minutes and seconds. Years and months are rejected because they have no fixed length.
#8829 40e145e Thanks @yordis! - Add Duration.toMicros for converting durations to microseconds.
#8829 7217410 Thanks @tim-smart! - Add encrypted remote compaction to the event log.
#8829 cf249fe Thanks @tim-smart! - Detect unsupported streaming request bodies in FetchHttpClient and fail with an EncodeError instead of silently sending [object ReadableStream]. Set FetchHttpClient.StreamBodyFallback to "buffer" to buffer the body in memory on those runtimes instead.
#8829 4f0fad1 Thanks @effect-bot! - Fence Redis PersistedQueue settlements and lock refreshes on a per-acquisition lock, so a stale handler can no longer release another live claim, including one with the same custom id in another queue. The lock format is incompatible with older workers on the same prefix: stop every old worker and let its locks expire before starting upgraded workers.
#8829 f74db37 Thanks @smit153! - Accept { self } before the generator body in Effect.fnUntraced and Effect.fnUntracedEager to bind this, matching Effect.fn.
#8829 069cf72 Thanks @effect-bot! - Add opt-in RFC 9457 Problem Details support to HttpApi.
ProblemDetails in effect/http provides the application/problem+json media type, a lenient codec for problem details objects, and a response constructor.HttpApiError.Problem<Self>()(tag, { type, status, title }, fields?) declares a typed problem as a yieldable error class that endpoints render, document and decode as application/problem+json, discriminated by type.HttpApiSchema.asProblem renders a built-in error such as HttpApiError.NotFound as a problem.HttpApiMiddleware.ProblemDetails with HttpApiMiddleware.layerProblemDetails renders request decoding failures as a generic 400 problem (with per-field errors when includeDetails is enabled) and response encoding failures as a 500 problem.The default behaviour is unchanged: without the opt-in, built-in errors and decoding failures still produce the same responses as before.
#8829 9a07ebc Thanks @effect-bot! - Allow HttpApiSchema.Upgrade alongside ordinary success responses, for servers that decline the upgrade, and add HttpApiClient.isUpgraded to narrow the client result.
HttpApiClient.Upgraded values now carry a [HttpApiClient.UpgradedTypeId] brand. Code that builds Upgraded values by hand, such as client mocks, must add [HttpApiClient.UpgradedTypeId]: HttpApiClient.UpgradedTypeId to the object literal.
#8829 f40dc4e Thanks @bezff! - HttpClient.withCookiesRef now takes a Ref<ReadonlyArray<Cookie>> and sends stored response cookies only to a matching host, path and scheme, using the new Cookies.mergeIntoArray and Cookies.toRequestCookieHeader. Seed the ref with Cookies.mergeIntoArray or with cookies that set a domain.
#8829 fa516c6 Thanks @Tarekkharsa! - Export HttpClient.isTransientError and HttpClient.isTransientResponse, the predicates retryTransient uses to decide what to retry.
#8829 ffd9237 Thanks @effect-bot! - Add log: "Unhandled" to Effect.ignore, Effect.ignoreCause, and their Stream and Channel variants. This resolves References.UnhandledLogLevel when a failure occurs and suppresses logging when that reference is undefined, while preserving each combinator's existing failure semantics.
#8829 93895b9 Thanks @tim-smart! - Add keys to KeyValueStore and SchemaStore. It returns a snapshot of the keys in the store, in no particular order, and is implemented by the memory, file system, SQL, Web Storage and IndexedDB stores. Custom stores built with KeyValueStore.make or KeyValueStore.makeStringOnly must now provide keys.
KeyValueStore.prefix(...) now scopes keys, size and isEmpty to keys under the prefix, with the prefix removed from the returned keys. Previously size and isEmpty reported on the whole backing store.
Stores built with KeyValueStore.make that don't provide clearPrefix now derive it from keys and remove instead of failing for non-empty prefixes.
#8829 e5a1479 Thanks @effect-bot! - Add the unstable Match.literals and Match.literalsExhaustive APIs for matching string and number literal unions with a record of handlers.
#8829 65db606 Thanks @effect-bot! - Add request-level dependencies and middleware to McpServer so handler services can be supplied per request. Breaking: pass registration layers through the transport's registrations option, and capture construction-time handler services in Layer.unwrap instead of Layer.provide.
#8829 7c42335 Thanks @tim-smart! - Add McpServer.visibility to hide tools, resources and prompts per request based on services provided by MCP middleware. Middleware that wraps a visibility now runs on list requests, once for each registration, so MiddlewareMethod includes the list methods. Middleware provided both locally and globally now runs once.
#8829 cb21d14 Thanks @effect-bot! - Add a cacheHints option to the McpServer layers to set how long clients may treat v2026_07_28 discovery and list results as fresh, for example cacheHints: { tools: { ttl: "1 minute", cacheScope: "private" } }. Results without a hint, and resources/read, keep { ttlMs: 0, cacheScope: "private" }.
#8829 c32eb78 Thanks @effect-bot! - Expose SqlMessageStorage.makeEncodedStorage to construct an encoded SQL message storage driver without running migrations or executing startup SQL. Run layerMigrations separately with the same table prefix before using the driver; makeEncoded continues to run migrations by default.
#8829 be9895b Thanks @bezff! - Move fromFileSystem from effect/sql/Migrator to effect/sql/MigratorFileSystem, so React Native apps can import effect/sql/Migrator and effect/sql under Metro. The effect/sql barrel and @effect/sql-sqlite-react-native/SqliteMigrator no longer export fromFileSystem; the other SQL adapter migrators still re-export it.
#8829 26b4bfe Thanks @fubhy! - Type received and forwarded HTTP request methods as string so methods such as PROPFIND are represented accurately, including in AI HTTP error details. Exhaustive matches on request methods now need a fallback or a guard using HttpMethod.isHttpMethod.
#8829 f97711f Thanks @effect-bot! - Isolate Persistence stores on the KeyValueStore and Redis backings. Clearing a store now only removes that store's entries, and different store / key pairs no longer map to the same backing key.
Add KeyValueStore.clearPrefix, implemented by the memory, file system, SQL, Web Storage and IndexedDB stores. KeyValueStore.prefix(...).clear now only removes keys under the prefix. Stores built with KeyValueStore.make that don't provide clearPrefix remove the matching keys one by one instead of clearing everything.
Both backings now store entries under <storeId>:<key>, with % and : in the store id percent-encoded.
Key layout change. Entries written by earlier versions are not read back:
Persistence.layerKvs / layerBackingKvs: every existing entry becomes unreachable, because keys used to be <storeId><key> with no separator. Cached results are recomputed. Chat.layerPersisted on a KeyValueStore backing loses its stored chat histories.Persistence.layerRedis / layerBackingRedis: keys are unchanged unless the store id contains % or :. Entries for those store ids become unreachable.Old entries are not migrated or removed automatically.
#8829 4f16778 Thanks @effect-bot! - Add the unstable Pool.Stats and Pool.stats APIs for sampling how many pool items are idle or in use and how many borrowers are waiting. PgPool.stats and PgClient.poolStats expose the same snapshot for PostgreSQL sessions, so applications can export connection pool metrics without reaching into pool internals.
#8829 d2b6bc7 Thanks @jpowersdev! - Add experimental Glob path matching and a shared FileSystem.glob implementation for Node, Bun, and Deno.
FileSystem implementations, including inputs to FileSystem.make, must provide readDirectoryEntries; mapping readDirectory names to { name, type: "Unknown" } is supported. Wrappers must apply directory-listing changes to both methods.FileSystem.make now derives glob instead of accepting it. Apply custom overrides afterward with FileSystem.of({ ...fs, glob: customGlob })./ separators and backslash escapes; Node extglobs no longer expand. Results use / separators and are relative to root unless the pattern is absolute. Deno wildcards now skip dotfiles unless explicitly named or dot: true; unreadable wildcard-reached directories are skipped, while read failures at the root or a leading literal directory propagate.#8829 3d88452 Thanks @fubhy! - Add CommandLine to effect/process for quoting and joining command lines, and support Redacted arguments and env values in ChildProcess.
Migration:
ChildProcess.make templates keep quoted words together and throw a CommandLineError for shell syntax such as |, $HOME or *. Quote such characters or pass them with ${}.shell option, templates cannot contain ${} values and extra arguments fail with BadArgument. Pass the whole script as the command, built with CommandLine.join.StandardCommand.args and env values can be Redacted strings.ChildProcess.TemplateExpression and ChildProcess.TemplateExpressionItem are removed. Use the CommandLine types of the same name.#8829 3c42058 Thanks @effect-bot! - Remove AiError.HttpRequestDetails and Response.HttpRequestDetails, so AI errors and response metadata no longer carry request headers or query parameters. AiError.NetworkError records the request as method and url fields instead of request, and the request field is gone from AiError.HttpContext and Response.ResponseMetadataPart.
#8829 2ae4045 Thanks @tim-smart! - Calls made with discard: true now complete when the server acknowledges them, instead of when the request is written.
SchemaBinary peers must be upgraded together because the new discard field changes the envelope fingerprint.
#8829 e853fa1 Thanks @effect-bot! - Add an onDisconnect option to RpcServer.make and its layer and HTTP wrappers, so applications can observe client disconnects without taking from Protocol.disconnects and preventing the server from interrupting the disconnected client's requests.
#8829 1194a4c Thanks @bezff! - sql.insert and sql.updateValues now require a non-empty array of rows at the type level. Narrow array inputs with Array.isReadonlyArrayNonEmpty before passing them to these helpers.
#8829 2cb498e Thanks @effect-bot! - Fix a SQLite client hanging forever after a queued withTransaction or reserve was interrupted just as it received the connection. The interrupted acquisition could keep the connection's only permit without registering its release.
Add Semaphore.takeScoped, which holds permits until the current scope closes. Waiting can be interrupted unless the caller is uninterruptible, and acquired permits are always returned when the scope closes.
#8829 89e5443 Thanks @jpowersdev! - Add Terminal.size, a scoped queue that starts with the current terminal dimensions and receives each resize. Custom terminals passed to Terminal.make must now supply size.
#8829 2a9a425 Thanks @jayhemnani9910! - Toml.parse now returns a Result instead of throwing, failing with an EncodingError on invalid input. It also rejects documents that extend an inline table or a statically defined array, which TOML 1.0 forbids.
#8829 ed20129 Thanks @effect-bot! - Report unobserved release failures at UnhandledLogLevel for RcMap and RcRef idle expiry, abandoned interrupted RcMap lookups, and ScopedCache expiry discovered by keys, values, or entries scans. Preserve failure propagation when cleanup is observed by a caller.
#10076 20795b9 Thanks @jpowersdev! - Base64Url.decode and Base64Url.decodeString now reject partially padded input such as Zg=. Unpadded input (Zg) and fully padded input (Zg==) still decode.
#10083 a8e5e6c Thanks @jpowersdev! - Fix BigDecimal.fromString and BigDecimal.fromStringUnsafe accepting a sign after the decimal point.
#10093 fb5dbee Thanks @tim-smart! - Release a frozen runner's MySQL shard locks after shardLockExpiration. SqlRunnerStorage sets wait_timeout on its MySQL lock connection, and restores it before returning the connection to the pool, so a runner that stops refreshing loses its named locks instead of holding them until the server drops its TCP connection. Vitess ignores wait_timeout, so runners behind Vitess keep the previous behavior.
#10095 8309b94 Thanks @tim-smart! - Restore idle_session_timeout on the PostgreSQL shard-lock connection before SqlRunnerStorage returns it to the pool, so other queries on that connection no longer have their session ended after shardLockExpiration idle.
#8829 af23904 Thanks @devangpratap! - Reject an append assignment such as FOO+=bar cmd in CommandLine.template and ChildProcess.make with UnsupportedSyntax, as FOO=bar cmd already is, instead of running FOO+=bar as the program.
#8829 468c6ee Thanks @tim-smart! - Keep the source context's maxDepth when Context.pick is given zero or one key, and reduce the bundle size of Context.makeUnsafe.
#8829 fe6b748 Thanks @effect-bot! - Support duplex additionalFds through getInputFd and getOutputFd, preserving both directions when used with pipeTo.
#10064 e75708c Thanks @gcanti! - Fix SchemaRepresentation.toCodeDocument losing __proto__ properties or changing object prototypes in generated annotations.
#10086 7890077 Thanks @jpowersdev! - HttpTraceContext.fromHeaders now rejects uppercase hex trace and span IDs in traceparent, b3 and X-B3-* headers, matching the lowercase encodings required by W3C Trace Context and B3. Previously they were accepted and propagated unchanged, which conforming downstream receivers reject.
#10085 c4a00fc Thanks @jpowersdev! - Reject traceparent headers with malformed trace flags in HttpTraceContext. Flags that are not two lowercase hexadecimal digits now return Option.none() instead of continuing the trace.
#8829 8938b19 Thanks @effect-bot! - Make remove on KeyValueStore.layerFileSystem succeed when the key does not exist, matching the other backends.
#8829 89e1e1e Thanks @tim-smart! - Stop McpServer from sending stateful clients list-change notifications for changes made before the server handled their initialize request, over stdio, HTTP sessions and custom transports.
#8829 eda0960 Thanks @effect-bot! - Let McpServer middleware and visibility layers receive per-request services from HttpRouter.middleware under layerHttp. Unmet per-request services now stay as McpRequest<"Requires", S> layer requirements, replacing MissingRequestDependencies.
#8829 89e1e1e Thanks @tim-smart! - Add McpTest.makeClient, an in-memory MCP client for testing McpServer registrations over the JSON-RPC wire encoding.
#10062 e19c611 Thanks @duailibe! - Otlp.layer, Otlp.layerFromConfig, Otlp.layerJson and Otlp.layerProtobuf now declare the shared OtlpExporter.Flusher they provide, instead of Layer<never>.
#10065 8e668fe Thanks @jpowersdev! - Preserve a leading UTF-8 BOM in URL-encoded body field names.
#10067 ce9e999 Thanks @jpowersdev! - Preserve a leading ? in URL-encoded form field names. urlParamsBody previously dropped it as a query-string prefix, so ?name=value decoded to name.
#8829 6dc3f7c Thanks @jpowersdev! - Add the unstable Csv module to effect/encoding for streaming CSV parsing and writing over text or UTF-8 bytes, with header records and schema adapters that convert cells through Schema.toCodecStringTree.
#10050 1513bbd Thanks @gcanti! - Prevent excessive CPU use when Schema.fromFormData and Schema.fromURLSearchParams decode field names containing unmatched opening brackets.
#10061 c065ed7 Thanks @gcanti! - Fix Schema.TaggedUnion.match and matchOrElse return inference and handler input types, and narrow matchOrElse fallbacks to unhandled variants.
Remove explicit output type arguments from Schema.TaggedUnion.match and matchOrElse calls; annotate handler return types when an explicit output is needed.
#8829 e710bbb Thanks @devangpratap! - Fix Toml.parse accepting out of range dates and times such as 1979-02-30 or 24:00:00, and rolling 1979-02-30T07:32:00Z over to March 2 instead of rejecting it.
#8829 b0d6e75 Thanks @jayhemnani9910! - Fix Toml.parse rejecting multiline basic and literal strings ending with one or two content quotes.
#10068 32b3570 Thanks @effect-bot! - Store the empty string key in Trie instead of silently discarding it. Construction, lookup, replacement, modification, removal, iteration and longestPrefixOf now treat "" like any other key.
#10051 9f93f4f Thanks @okarin1511! - Support YAML 1.1 merge keys (<<) in Yaml.parse. An unquoted << key merges a mapping, or a sequence of mappings, into the enclosing mapping. Explicit keys take precedence over merged keys, and earlier merge sources over later ones. Quote the key ("<<") to keep it as an ordinary key.
#10069 27370c7 Thanks @effect-bot! - Fix Yaml.parse rejecting block sequence entry mappings whose first key sits more than one space after the dash. Later keys in the entry must now align with the first key, and a tab before the first key is rejected.
5ff2d05 Thanks @tim-smart! - Keep an interrupted MSSQL request's connection leased until Tedious settles the cancellation, so the next statement, rollback, or stored procedure on that connection no longer fails with EINVALIDSTATE.631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
#8829 8f23668 Thanks @fubhy! - Replace effect/Crypto with family-specific effect/crypto/* services, opaque keys, CryptoError, a configurable WebCrypto reference and key schemas in effect/Schema. Encoding secret or private keys through byte/format schemas requires { allowEncode: true }.
SecureRandom for randomness and UUIDs, and Digest with algorithm values such as Digest.sha256 for hashing. Replace effect/testing/TestCrypto with Layer.mock for the required services.*Services bundles. NodeCrypto, BunCrypto, DenoCrypto and BrowserCrypto offer individual family layers and a combined layer, supplying SecureRandom where needed. Core modules offer layerWebCrypto.Digest.Digest instead of Crypto.Crypto to SqlMessageStorage and SingleRunner, and instead of EventLogEncryption to SqlEventLogServerEncrypted.makeStorage and layerStorage. Replace EventLogEncryption.sha256String with digest.digestHex(Digest.sha256, bytes).Existing workflow ID, activity idempotency key and event log table-name encodings are unchanged.
Event log encryption, identity key derivation and session authentication now run on Aead, Digest, Signature and SecureRandom. EventLogEncryption.make and EventLogEncryption.layer take those services from context, so Node apps can use the NodeCrypto layers. EventLogEncryption.layerSubtle and the session auth functions use the Web Crypto layers on the WebCrypto reference instead of globalThis.crypto. Existing identities, derived signing keys and encrypted batches are unchanged.
UUIDv7 and ULID generation is now monotonic below the maximum 48-bit timestamp, including within a millisecond and across clock rollback. Ordering is per SecureRandom instance; the unsafe helpers and model UUIDv7 defaults share per-realm ordering.
#10087 472c469 Thanks @effect-bot! - Node.js 22.19.0 (required by undici 8) is now the minimum for @effect/platform-node, @effect/platform-node-shared, @effect/opentelemetry and @effect/docgen, up from 18.
NodeSocket WebSocket clients now use Node's global WebSocket instead of ws, so client-only usage no longer bundles ws.
Breaking: ws moved to a new NodeWS module.
NodeSocket.NodeWS and BunSocket.NodeWS are removed. Import NodeWS from @effect/platform-node or @effect/platform-node-shared (on Bun, import ws directly). Use NodeWS.WebSocket in place of NodeSocket.NodeWS.default.NodeSocket.layerWebSocketConstructorWS is removed. Use NodeWS.layerWebSocketConstructor.Behaviour changes for clients that pass handshake headers, which previously used ws. Use NodeWS.layerWebSocketConstructor to keep the old behaviour:
highWaterMark fails the socket with a SocketReadError.ErrorEvent, so SocketOpenError causes lack the underlying error code.Socket.WebSocket service is a global WebSocket, so ws instanceof checks and ws-only methods such as terminate() and ping() no longer apply.Host header is ignored.permessage-deflate messages are still decompressed.http.globalAgent / https.globalAgent.#10081 438ce72 Thanks @effect-bot! - NodeHttpClient.layerNodeHttp now encodes FormData request bodies with the global Response, so it no longer loads the undici package. Bundles that use the node:http client no longer include undici. File contents are still streamed as the upload needs them, and a file that cannot be read still fails the request with a TransportError. The Undici-backed client is unchanged.
#10071 19d36b8 Thanks @effect-bot! - Convert Node HTTP server request headers to Headers instead of casting them, so configured header redaction applies when request headers are logged or inspected.
#10065 8e668fe Thanks @jpowersdev! - Preserve a leading UTF-8 BOM in URL-encoded body field names.
#10067 ce9e999 Thanks @jpowersdev! - Preserve a leading ? in URL-encoded form field names. urlParamsBody previously dropped it as a query-string prefix, so ?name=value decoded to name.
Updated dependencies [631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, 66c796a, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 472c469, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
#8829 66c796a Thanks @effect-bot! - Bound Node stream and socket pulls to at most chunkSize chunks (default 4096), preventing synchronously refilling sources from draining indefinitely in one pull. Add a chunkSize option to Node socket constructors and a separate readSize option for Node stream read(size) calls; callers previously using chunkSize for byte read sizes should use readSize instead. Set chunkSize: Infinity to opt into unbounded batching.
#8829 8f23668 Thanks @fubhy! - Replace effect/Crypto with family-specific effect/crypto/* services, opaque keys, CryptoError, a configurable WebCrypto reference and key schemas in effect/Schema. Encoding secret or private keys through byte/format schemas requires { allowEncode: true }.
SecureRandom for randomness and UUIDs, and Digest with algorithm values such as Digest.sha256 for hashing. Replace effect/testing/TestCrypto with Layer.mock for the required services.*Services bundles. NodeCrypto, BunCrypto, DenoCrypto and BrowserCrypto offer individual family layers and a combined layer, supplying SecureRandom where needed. Core modules offer layerWebCrypto.Digest.Digest instead of Crypto.Crypto to SqlMessageStorage and SingleRunner, and instead of EventLogEncryption to SqlEventLogServerEncrypted.makeStorage and layerStorage. Replace EventLogEncryption.sha256String with digest.digestHex(Digest.sha256, bytes).Existing workflow ID, activity idempotency key and event log table-name encodings are unchanged.
Event log encryption, identity key derivation and session authentication now run on Aead, Digest, Signature and SecureRandom. EventLogEncryption.make and EventLogEncryption.layer take those services from context, so Node apps can use the NodeCrypto layers. EventLogEncryption.layerSubtle and the session auth functions use the Web Crypto layers on the WebCrypto reference instead of globalThis.crypto. Existing identities, derived signing keys and encrypted batches are unchanged.
UUIDv7 and ULID generation is now monotonic below the maximum 48-bit timestamp, including within a millisecond and across clock rollback. Ordering is per SecureRandom instance; the unsafe helpers and model UUIDv7 defaults share per-realm ordering.
#10087 472c469 Thanks @effect-bot! - Node.js 22.19.0 (required by undici 8) is now the minimum for @effect/platform-node, @effect/platform-node-shared, @effect/opentelemetry and @effect/docgen, up from 18.
NodeSocket WebSocket clients now use Node's global WebSocket instead of ws, so client-only usage no longer bundles ws.
Breaking: ws moved to a new NodeWS module.
NodeSocket.NodeWS and BunSocket.NodeWS are removed. Import NodeWS from @effect/platform-node or @effect/platform-node-shared (on Bun, import ws directly). Use NodeWS.WebSocket in place of NodeSocket.NodeWS.default.NodeSocket.layerWebSocketConstructorWS is removed. Use NodeWS.layerWebSocketConstructor.Behaviour changes for clients that pass handshake headers, which previously used ws. Use NodeWS.layerWebSocketConstructor to keep the old behaviour:
highWaterMark fails the socket with a SocketReadError.ErrorEvent, so SocketOpenError causes lack the underlying error code.Socket.WebSocket service is a global WebSocket, so ws instanceof checks and ws-only methods such as terminate() and ping() no longer apply.Host header is ignored.permessage-deflate messages are still decompressed.http.globalAgent / https.globalAgent.#8829 d2b6bc7 Thanks @jpowersdev! - Add experimental Glob path matching and a shared FileSystem.glob implementation for Node, Bun, and Deno.
FileSystem implementations, including inputs to FileSystem.make, must provide readDirectoryEntries; mapping readDirectory names to { name, type: "Unknown" } is supported. Wrappers must apply directory-listing changes to both methods.FileSystem.make now derives glob instead of accepting it. Apply custom overrides afterward with FileSystem.of({ ...fs, glob: customGlob })./ separators and backslash escapes; Node extglobs no longer expand. Results use / separators and are relative to root unless the pattern is absolute. Deno wildcards now skip dotfiles unless explicitly named or dot: true; unreadable wildcard-reached directories are skipped, while read failures at the root or a leading literal directory propagate.#8829 3d88452 Thanks @fubhy! - Add CommandLine to effect/process for quoting and joining command lines, and support Redacted arguments and env values in ChildProcess.
Migration:
ChildProcess.make templates keep quoted words together and throw a CommandLineError for shell syntax such as |, $HOME or *. Quote such characters or pass them with ${}.shell option, templates cannot contain ${} values and extra arguments fail with BadArgument. Pass the whole script as the command, built with CommandLine.join.StandardCommand.args and env values can be Redacted strings.ChildProcess.TemplateExpression and ChildProcess.TemplateExpressionItem are removed. Use the CommandLine types of the same name.#8829 89e5443 Thanks @jpowersdev! - Add Terminal.size, a scoped queue that starts with the current terminal dimensions and receives each resize. Custom terminals passed to Terminal.make must now supply size.
fe6b748 Thanks @effect-bot! - Support duplex additionalFds through getInputFd and getOutputFd, preserving both directions when used with pipeTo.631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
#8829 8f23668 Thanks @fubhy! - Replace effect/Crypto with family-specific effect/crypto/* services, opaque keys, CryptoError, a configurable WebCrypto reference and key schemas in effect/Schema. Encoding secret or private keys through byte/format schemas requires { allowEncode: true }.
SecureRandom for randomness and UUIDs, and Digest with algorithm values such as Digest.sha256 for hashing. Replace effect/testing/TestCrypto with Layer.mock for the required services.*Services bundles. NodeCrypto, BunCrypto, DenoCrypto and BrowserCrypto offer individual family layers and a combined layer, supplying SecureRandom where needed. Core modules offer layerWebCrypto.Digest.Digest instead of Crypto.Crypto to SqlMessageStorage and SingleRunner, and instead of EventLogEncryption to SqlEventLogServerEncrypted.makeStorage and layerStorage. Replace EventLogEncryption.sha256String with digest.digestHex(Digest.sha256, bytes).Existing workflow ID, activity idempotency key and event log table-name encodings are unchanged.
Event log encryption, identity key derivation and session authentication now run on Aead, Digest, Signature and SecureRandom. EventLogEncryption.make and EventLogEncryption.layer take those services from context, so Node apps can use the NodeCrypto layers. EventLogEncryption.layerSubtle and the session auth functions use the Web Crypto layers on the WebCrypto reference instead of globalThis.crypto. Existing identities, derived signing keys and encrypted batches are unchanged.
UUIDv7 and ULID generation is now monotonic below the maximum 48-bit timestamp, including within a millisecond and across clock rollback. Ordering is per SecureRandom instance; the unsafe helpers and model UUIDv7 defaults share per-realm ordering.
#8829 93895b9 Thanks @tim-smart! - Add keys to KeyValueStore and SchemaStore. It returns a snapshot of the keys in the store, in no particular order, and is implemented by the memory, file system, SQL, Web Storage and IndexedDB stores. Custom stores built with KeyValueStore.make or KeyValueStore.makeStringOnly must now provide keys.
KeyValueStore.prefix(...) now scopes keys, size and isEmpty to keys under the prefix, with the prefix removed from the returned keys. Previously size and isEmpty reported on the whole backing store.
Stores built with KeyValueStore.make that don't provide clearPrefix now derive it from keys and remove instead of failing for non-empty prefixes.
#8829 f97711f Thanks @effect-bot! - Isolate Persistence stores on the KeyValueStore and Redis backings. Clearing a store now only removes that store's entries, and different store / key pairs no longer map to the same backing key.
Add KeyValueStore.clearPrefix, implemented by the memory, file system, SQL, Web Storage and IndexedDB stores. KeyValueStore.prefix(...).clear now only removes keys under the prefix. Stores built with KeyValueStore.make that don't provide clearPrefix remove the matching keys one by one instead of clearing everything.
Both backings now store entries under <storeId>:<key>, with % and : in the store id percent-encoded.
Key layout change. Entries written by earlier versions are not read back:
Persistence.layerKvs / layerBackingKvs: every existing entry becomes unreachable, because keys used to be <storeId><key> with no separator. Cached results are recomputed. Chat.layerPersisted on a KeyValueStore backing loses its stored chat histories.Persistence.layerRedis / layerBackingRedis: keys are unchanged unless the store id contains % or :. Entries for those store ids become unreachable.Old entries are not migrated or removed automatically.
#10065 8e668fe Thanks @jpowersdev! - Preserve a leading UTF-8 BOM in URL-encoded body field names.
#10067 ce9e999 Thanks @jpowersdev! - Preserve a leading ? in URL-encoded form field names. urlParamsBody previously dropped it as a query-string prefix, so ?name=value decoded to name.
Updated dependencies [631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
#10087 472c469 Thanks @effect-bot! - Node.js 22.19.0 (required by undici 8) is now the minimum for @effect/platform-node, @effect/platform-node-shared, @effect/opentelemetry and @effect/docgen, up from 18.
NodeSocket WebSocket clients now use Node's global WebSocket instead of ws, so client-only usage no longer bundles ws.
Breaking: ws moved to a new NodeWS module.
NodeSocket.NodeWS and BunSocket.NodeWS are removed. Import NodeWS from @effect/platform-node or @effect/platform-node-shared (on Bun, import ws directly). Use NodeWS.WebSocket in place of NodeSocket.NodeWS.default.NodeSocket.layerWebSocketConstructorWS is removed. Use NodeWS.layerWebSocketConstructor.Behaviour changes for clients that pass handshake headers, which previously used ws. Use NodeWS.layerWebSocketConstructor to keep the old behaviour:
highWaterMark fails the socket with a SocketReadError.ErrorEvent, so SocketOpenError causes lack the underlying error code.Socket.WebSocket service is a global WebSocket, so ws instanceof checks and ws-only methods such as terminate() and ping() no longer apply.Host header is ignored.permessage-deflate messages are still decompressed.http.globalAgent / https.globalAgent.#8829 0edad49 Thanks @effect-bot! - Fix importing @effect/opentelemetry when the optional @opentelemetry/sdk-trace-node or @opentelemetry/sdk-trace-web peers are not installed. NodeSdk and WebSdk are no longer re-exported from the package root; import them from @effect/opentelemetry/NodeSdk and @effect/opentelemetry/WebSdk.
#8829 df8dce5 Thanks @tim-smart! - Percent-decode OTEL_RESOURCE_ATTRIBUTES keys and values in Resource.layerFromEnv, discarding the variable with a warning when its encoding is invalid. Thanks to @Marve10s for the original fix.
Resource.layerFromEnv now reads the variable with Config.Record, so it also accepts a structured config value for OTEL_RESOURCE_ATTRIBUTES.
Updated dependencies [631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
#8829 611e3e3 Thanks @ojhaujjwal! - Generated httpclient clients now keep the error and requirement types of the HttpClient passed to make, so errors and services added by client middleware appear in each operation's signature. The generated interface gains E and R type parameters that default to HttpClientError and never, so existing clients are unchanged.
#8829 38f96d8 Thanks @effect-bot! - Add an includeSchemas generation option that emits component schemas no operation references, and support the RFC 6902 move operation in OpenAPI patches.
631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 472c469, 438ce72, 19d36b8, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
#8829 3f8f359 Thanks @jem-computer! - Declare decision images as input fields with Decision.Image, and add Decision.locate, which answers with a bounding box around one target in an image field.
DecideOptions.images is removed. Add Decision.Image fields to the input schema and refer to each image by its path in instructions:
// Before
DecisionModel.decide(Triage, { input: "Checkout error", images: [screenshot] })
// After
const Triage = Decision.make({
input: Schema.Struct({ report: Schema.String, screenshot: Decision.Image }),
decisions
})
DecisionModel.decide(Triage, { input: { report: "Checkout error", screenshot } })
Custom providers receive images as { reference, path, image }, with each image replaced by its reference in state and its data as a base64 string or URL.
Decision.locate({ image: "photo", instructions }) takes a path that Decision.make checks against the input's image fields. Providers opt in with supportsLocate: true. Decision.Any and DecisionModel.ProviderAnswer gain locate variants, so exhaustive switches over them need a Locate case.
TypeSafeDecisionModel supports images, sent as assets keyed by reference, and sends locate decisions as Box questions, which need jev-preview or jev-1.14.0. OpenAI and Cloudflare label each image with its reference.
#8829 3c42058 Thanks @effect-bot! - Remove AiError.HttpRequestDetails and Response.HttpRequestDetails, so AI errors and response metadata no longer carry request headers or query parameters. AiError.NetworkError records the request as method and url fields instead of request, and the request field is gone from AiError.HttpContext and Response.ResponseMetadataPart.
7ea1ea2 Thanks @wmaurer! - Add an optional cause to the AI NetworkError. It holds the HttpClientError the request failed with, stored unchanged and not redacted, so the reason a request failed is no longer lost. The new NetworkError.fromHttpClientError sets it, and all AI providers now use it. NetworkError.fromRequestError is unchanged.631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
3c42058 Thanks @effect-bot! - Remove AiError.HttpRequestDetails and Response.HttpRequestDetails, so AI errors and response metadata no longer carry request headers or query parameters. AiError.NetworkError records the request as method and url fields instead of request, and the request field is gone from AiError.HttpContext and Response.ResponseMetadataPart.#8829 7ea1ea2 Thanks @wmaurer! - Add an optional cause to the AI NetworkError. It holds the HttpClientError the request failed with, stored unchanged and not redacted, so the reason a request failed is no longer lost. The new NetworkError.fromHttpClientError sets it, and all AI providers now use it. NetworkError.fromRequestError is unchanged.
#8829 3f8f359 Thanks @jem-computer! - Declare decision images as input fields with Decision.Image, and add Decision.locate, which answers with a bounding box around one target in an image field.
DecideOptions.images is removed. Add Decision.Image fields to the input schema and refer to each image by its path in instructions:
// Before
DecisionModel.decide(Triage, { input: "Checkout error", images: [screenshot] })
// After
const Triage = Decision.make({
input: Schema.Struct({ report: Schema.String, screenshot: Decision.Image }),
decisions
})
DecisionModel.decide(Triage, { input: { report: "Checkout error", screenshot } })
Custom providers receive images as { reference, path, image }, with each image replaced by its reference in state and its data as a base64 string or URL.
Decision.locate({ image: "photo", instructions }) takes a path that Decision.make checks against the input's image fields. Providers opt in with supportsLocate: true. Decision.Any and DecisionModel.ProviderAnswer gain locate variants, so exhaustive switches over them need a Locate case.
TypeSafeDecisionModel supports images, sent as assets keyed by reference, and sends locate decisions as Box questions, which need jev-preview or jev-1.14.0. OpenAI and Cloudflare label each image with its reference.
#10087 472c469 Thanks @effect-bot! - Node.js 22.19.0 (required by undici 8) is now the minimum for @effect/platform-node, @effect/platform-node-shared, @effect/opentelemetry and @effect/docgen, up from 18.
NodeSocket WebSocket clients now use Node's global WebSocket instead of ws, so client-only usage no longer bundles ws.
Breaking: ws moved to a new NodeWS module.
NodeSocket.NodeWS and BunSocket.NodeWS are removed. Import NodeWS from @effect/platform-node or @effect/platform-node-shared (on Bun, import ws directly). Use NodeWS.WebSocket in place of NodeSocket.NodeWS.default.NodeSocket.layerWebSocketConstructorWS is removed. Use NodeWS.layerWebSocketConstructor.Behaviour changes for clients that pass handshake headers, which previously used ws. Use NodeWS.layerWebSocketConstructor to keep the old behaviour:
highWaterMark fails the socket with a SocketReadError.ErrorEvent, so SocketOpenError causes lack the underlying error code.Socket.WebSocket service is a global WebSocket, so ws instanceof checks and ws-only methods such as terminate() and ping() no longer apply.Host header is ignored.permessage-deflate messages are still decompressed.http.globalAgent / https.globalAgent.Updated dependencies [631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
#8829 38f96d8 Thanks @effect-bot! - Regenerate the unstable Generated module from the pinned anthropic-sdk-typescript 0.135.0 spec, so newer request settings such as adaptive thinking display can be configured. Every released Generated export name still exists. The released Skills schemas, such as Skill and CreateSkillResponse, keep their released definitions. Other released types follow the current API: they gain fields and union members, and fields added since the release stay optional, so older responses still decode. The Files and Skills changes below are the exception: they follow Anthropic's migration of those APIs to their GA shapes and do not decode the previous beta shapes.
The Skills client methods decode the current API shapes, exported under new *Resource names. No method decodes with the released Skills schemas.
createSkillV1SkillsPost, getSkillV1SkillsSkillIdGet and their beta* variants return SkillResource / BetaSkillResource. Read display_name instead of display_title, and latest_version_id instead of latest_version.createSkillVersionV1SkillsSkillIdVersionsPost, getSkillVersionV1SkillsSkillIdVersionsVersionGet and their beta* variants return SkillVersionResource / BetaSkillVersionResource, which no longer include directory or version.List*ResourcesResponse. Page with next_page instead of has_more.type as the literal the API always sends, such as "skill_deleted" and "skill_version", instead of string.The Files list methods listFilesV1FilesGet and betaListFilesV1FilesGet page with page and next_page. Their params no longer include before_id or after_id, and FileListResponse / BetaFileListResponse no longer include has_more, first_id or last_id. Pass the previous response's next_page as page to fetch the next page.
When migrating to the current Files and Skills shapes, remove the dated files-api-2025-04-14 and skills-2025-10-02 tokens from any anthropic-beta header you send, and keep any other beta tokens. The API still returns the previous beta shapes to requests that send these tokens, and the Files and Skills methods cannot decode them. See the upstream migration guides for Files and Skills.
Uploads take files instead of strings. UploadFileV1FilesPostRequestFormData.file and each Skills files entry are a File or Blob. Skills files is now required and non-null. As before, every file must be in one top-level directory that has a SKILL.md. The Skills create input renames display_title to display_name:
const created = client.betaCreateSkillV1SkillsPost({
payload: {
display_name: "My skill",
files: [new File([skillMd], "my-skill/SKILL.md", { type: "text/markdown" })]
},
config: undefined
})
BetaMessageIterationUsage.model can be null as well as missing. Read it with a fallback, such as usage.model ?? "unknown".
Text blocks in BetaResponseMCPToolResultBlock content have optional citations. Read them with a fallback, such as part.citations ?? [].
Response unions gain members. Exhaustive switches without a default need new cases:
error_code adds "content_too_large";"model_context_window_exceeded";#8829 3c42058 Thanks @effect-bot! - Remove AiError.HttpRequestDetails and Response.HttpRequestDetails, so AI errors and response metadata no longer carry request headers or query parameters. AiError.NetworkError records the request as method and url fields instead of request, and the request field is gone from AiError.HttpContext and Response.ResponseMetadataPart.
7ea1ea2 Thanks @wmaurer! - Add an optional cause to the AI NetworkError. It holds the HttpClientError the request failed with, stored unchanged and not redacted, so the reason a request failed is no longer lost. The new NetworkError.fromHttpClientError sets it, and all AI providers now use it. NetworkError.fromRequestError is unchanged.631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
4f16778 Thanks @effect-bot! - Add the unstable Pool.Stats and Pool.stats APIs for sampling how many pool items are idle or in use and how many borrowers are waiting. PgPool.stats and PgClient.poolStats expose the same snapshot for PostgreSQL sessions, so applications can export connection pool metrics without reaching into pool internals.631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
One column per quarter.