v0.18.0
Version v0.18.0, dated October 16, 2026, introduces the TypeSafe Jev decision component and comprehensive security, concurrency, and reliability remediations across the core routing engine, components, and observability modules. Every component and observability module at v0.18.0 requires core v0.18.0.
Jev Decision Component
The new Jev component (components/jev, jev:decisions) integrates the TypeSafe Jev decision model through the OpenRouter Decisions API (/api/alpha/decisions). It operates as a producer-only component with zero third-party dependencies:
- The exchange body contains the state to evaluate.
- Questions are specified via the
questionsURI parameter (JSON, with question typesnoul,choice, orscore). - Structured answers are returned as
map[string]jev.Answerin the message body. - Supported options:
apiKey(falls back toOPENROUTER_API_KEY, masked inURI()),model(defaults totypesafe/jev-1.13),baseURL,timeout, andallowHeaderOverride(forJevQuestionsandJevModelheader overrides). - Payload and error responses are bounded to protect against memory exhaustion.
Security & Hardening Remediations
- WinZip AES Deflate HMAC Verification: Enforced strict HMAC-SHA1 verification and premature EOF validation on deflate and store streams (
aesDeflateReadCloserandaesStoreReadCloser) inZipDataFormat, closing authentication bypass risks on truncated archives. - Path Traversal Protection: Enforced
ValidatePathandValidateRemotePathchecks onmoveandmoveFailedpost-processing parameters infile,ftp,sftp, andsmb. SFTP directory consumer now skips symbolic links during recursive scans. - Dynamic Routing Injection Protection: Eliminated second-pass interpolation in
RecipientList,RoutingSlip, andDynamicRouter, ensuring dynamic recipient expressions evaluate safely in a single pass. - Resource Protection & Bounded Reads: Replaced unbounded readers in
bodyToBytes,normalizeJSONSource,CSVDataFormat, and remote file producers (FTPProducer,SFTPProducer,SMBProducer) withReadLimitedbounded byDefaultMaxBodySize. - Simple Language Hardening: Bounded
padstart,padend, and regex evaluation input lengths byMaxSimpleInputBytes, and hoisted package-level compiled regular expressions. - Credential Redaction: Added
passcodeto default sensitive URI keys for automatic masking in STOMP endpoints.
Concurrency & Lifecycle Improvements
- Connection Leasing: Added exclusive connection leasing (
connCh) toSFTPProducerandSMBProducerto eliminate data races during concurrent message processing and endpoint shutdown. - Connection Reference Counting: Added
connUsersreference counting to shared connections ingrpc,nats, andstompendpoints, preventing premature connection teardown while active producers or consumers are using them. - Redis Consumer Cleanup: Properly closed
pubSuband released Redis clients on consumer start subscription errors. - Mail Hardening: Safe quoted-printable encoding with
mime/quotedprintable.Writer, bounded MIME parts, and dial timeouts on IMAP/POP3 connections. - EIP Concurrency Safety: Adopted
DeepCopy()inMemoryAggregationRepositoryandResequencerto prevent exchange state mutations across concurrent aggregation branches. - Route Builder Error Preservation: Preserved the first build error in
RouteBuilderandChoiceBuilder.
Observability
- OpenTelemetry Interceptor: Added
TracingWith(tp)to configure customTracerProviderinstances, restored previousExchange.Contexton route exit, and set span statuscodes.Erroron unhandled route errors.
See the CHANGELOG for the full list of changes.