JS SDK Changelog File — Inngest

inngest

4.21.0

Minor Changes

#1725 76015387 Thanks @jakobevangelista! - Add secrets to sandbox create options as an array of exact workspace secret names, for example secrets: ["OPENAI_API_KEY"]. Save each secret under the environment variable name the application expects. Duplicate names and collisions with literal environment variables are rejected. Names resolve to secret identities at creation, including across create retries. Values are fetched at launch and inherited by commands, managed processes, and snapshots.

Patch Changes

#1722 1e539057 Thanks @jakobevangelista! - Handle sandbox list responses that omit a false hasMore value.
#1730 228a928a Thanks @amh4r! - Fix duplicate execution in parallel race mode

4.20.0

Minor Changes

#1672 37813011 Thanks @jakobevangelista! - Add sandbox snapshot create, list, get, wait, delete, and clone APIs to both the direct client and step.sandbox.
#1683 3b5ddba5 Thanks @jakobevangelista! - Add sandbox pause and resume APIs to both the direct client and step.sandbox.

4.19.0

Minor Changes

#1701 f4fa1eb8 Thanks @jakobevangelista! - Wait for newly created sandboxes to reach RUNNING by default, with runningTimeout: false as an explicit opt-out.

Patch Changes

#1713 f7c49003 Thanks @KiKoS0! - Route signing-key API requests to the correct branch environment and include SDK identification headers.
#1700 8f5dceb4 Thanks @jakobevangelista! - Return captured sandbox command stdout and stderr as UTF-8 strings.
#1705 28603273 Thanks @jakobevangelista! - Allow sandbox commands to use executable names and relative paths.
#1684 dde88e4d Thanks @jakobevangelista! - Support shell command strings in the experimental sandbox command and managed process APIs.
#1693 a2cd5b48 Thanks @scottnuma! - Validate propagated sessions with step.invoke and defer
#1712 a9975874 Thanks @jakobevangelista! - Export SandboxCommand from inngest/experimental.
Updated dependencies [abc4a63f]:
- @inngest/ai@0.1.8

4.18.1

Patch Changes

#1686 ca7dff0e Thanks @jakobevangelista! - Allow sandbox names up to 255 characters, including uppercase ULIDs and human-readable names.
#1704 e72b89c7 Thanks @jacobheric! - Prevent AI metadata tracking from retaining executions after an SDK request ends, including when OpenTelemetry excludes the root span from sampling.
#1698 282106a5 Thanks @Linell! - Fix function-level middleware silently skipped on adapters whose url() drops the query string (AWS Lambda, Redwood, DigitalOcean): resolve fnId the same way execution does

4.18.0

Minor Changes

#1688 610e7395 Thanks @scottnuma! - Enable sessions propagation by default

Patch Changes

#1666 c1014932 Thanks @Linell! - Remove the unmaintained serialize-error-cjs dependency

4.17.0

Minor Changes

#1645 aeae58dd Thanks @scottnuma! - Add a toggle to clients to control sessions propagation
#1646 39aee6f7 Thanks @scottnuma! - Add sessions support to deferred runs
#1678 c838b982 Thanks @scottnuma! - Sessions propagate into child runs, gated behind an opt-in client config

4.16.0

Minor Changes

#1671 3608c52d Thanks @amh4r! - Add SDK feature observations

Patch Changes

#1674 6b0ae370 Thanks @Linell! - Fix TS2742 errors in projects that use declaration or composite true by exporting SendSignalResponse appropriately.
#1658 edcb6536 Thanks @amh4r! - Fix wrapStep middleware hook sometimes skipped for parallel steps

4.15.0

Minor Changes

#1667 961d2807 Thanks @jakobevangelista! - Allow sandbox Create to configure environment variables inherited by commands and managed processes.
#1654 23ddbc2e Thanks @jakobevangelista! - Add experimental sandbox APIs, including the direct inngest.sandboxes client and the opt-in durable step.sandbox surface enabled by sandboxMiddleware().

Patch Changes

#1663 0bec14ee Thanks @mar-inngest! - Prevent Connect lease renewals from using a draining or replaced connection.
#1665 3f25b191 Thanks @Linell! - Sub-second durations no longer get dropped. step.sleep("id", 500) used to resolve immediately; it now rounds up and sleeps a full second, the minimum resolution of a durable wait. The same rounding applies to waitForEvent, invoke, waitForSignal, and cancelOn timeouts.

4.14.0

Minor Changes

#1647 3cc9a110 Thanks @rhino1998! - feat(metadata): Extract AI call latency

Patch Changes

#1648 106aaaf9 Thanks @Linell! - Fix errant step.ai.wrap warning
#1649 690c0544 Thanks @Linell! - More informative errors for invalid functions

4.13.0

Minor Changes

#1630 7b5907e4 Thanks @Linell! - Added support for aborting deferred runs via defer().abort()

4.12.1

Patch Changes

#1622 0706a1f5 Thanks @amh4r! - Fix step.run not JSON-serializing during checkpointing

4.12.0

Minor Changes

#1376 525a6743 Thanks @gwax! - Add streaming support to inngest/sveltekit serve handlers.

Patch Changes

#1620 08ef03b9 Thanks @KiKoS0! - Fix run hangs on parallel steps when optimizeParallelism is off
#1615 9b5ea64c Thanks @Linell! - Fix a crash when using serve({ streaming: true }) and the client disconnects before a run completes
#1618 922e2024 Thanks @Linell! - Fix step.run and step.invoke output types collapsing to {} for objects with optional properties when using two or more middleware

4.11.0

Minor Changes

#1601 2b800c73 Thanks @scottnuma! - Support parsing operation name for AI Metadata Extraction

4.10.0

Minor Changes

#1599 c02cc265 Thanks @scottnuma! - Support deprecated gen_ai.system for AI Metadata Extraction
#1600 2462e875 Thanks @scottnuma! - Support parsing finish reasons for AI Metadata Extraction

Patch Changes

#1605 cd18ed18 Thanks @Linell! - Suppress unnecessary warning log for inngest.experiment.score.
#1602 e2e89ead Thanks @amh4r! - Fix Extended Traces not appearing when checkpointing disabled

4.9.0

Minor Changes

#1594 124e55f8 Thanks @scottnuma! - Expand AI step metadata extraction to more OTel GenAI span attributes. The SDK now records additional model, provider, response id, token, and request parameter fields from OTel GenAI spans while continuing to ignore prompt and response content.

This removes the previous metadata extraction for Open Inference, Vercel AI SDK-specific, and Langfuse-specific span attributes.

4.8.0

Minor Changes

#1595 aa315c7e Thanks @amh4r! - Add opt-out for AI metadata extraction
#1521 a69ec0e2 Thanks @jakobevangelista! - Add experimental createScorer function
#1521 a69ec0e2 Thanks @jakobevangelista! - Add experimental scoring primitives for writing run- and step-scoped inngest.score metadata via inngest.score() and scoreMiddleware()-gated step.score().

Patch Changes

#1592 748c6cc4 Thanks @amh4r! - Deprecate Extended Traces provider creation. behaviour: "createProvider" and the "auto" fallback remain functional, but now direct users to preload @inngest/otel/node and extend that provider instead.

4.7.0

Minor Changes

#1577 1bc2ac7c Thanks @scottnuma! - Add metadata to steps containing LLM calls instrumented with OTel by Langfuse
#1547 04a79c95 Thanks @jakobevangelista! - Add sessions to event payloads

Patch Changes

#1588 50a349b7 Thanks @rhino1998! - fix(extended traces): Emit extended trace spans parented to the finalized step span

4.6.0

Minor Changes

#1567 1c3ad876 Thanks @Linell! - Deprecate optimizeParallelism: false — use group.parallel({ mode: "race" }) for race semantics instead. Opting out prevents runs from resuming checkpointing after a Promise.all.
#1568 bd6016c1 Thanks @scottnuma! - Add metadata to steps containing OTel instrumented LLM calls

Patch Changes

#1561 ba9874dc Thanks @rhino1998! - feat(experiments): Rename experiment_name -> experiment in metadata

4.5.1

Patch Changes

#1551 0af90c3c Thanks @rhino1998! - fix: Add step attribution attributes to all extended trace spans
#1556 5bd87775 Thanks @Linell! - Update internal tracing values used for identifying checkpointed data.
#1548 7be1cee3 Thanks @amh4r! - Fix unnecessary outgoing Durable Endpoint request
#1511 79558be2 Thanks @Linell! - Fix duplicate execution when response terminates early

4.5.0

Minor Changes

#1522 ebeb4516 Thanks @Linell! - Bump minimum @opentelemetry/auto-instrumentations-node to 0.75.0 to address GHSA-q7rr-3cgh-j5r3 in the transitive @opentelemetry/sdk-node / @opentelemetry/exporter-prometheus packages.

Note that upstream auto-instrumentations-node@0.72.0 dropped bundled Fastify, instrumentation, so if you relied on it for tracing your Fastify routes, add @opentelemetry/instrumentation-fastify directly.

Patch Changes

#1540 10dad398 Thanks @amh4r! - Fix attempt count not resetting during checkpointing
#1544 f1ee6f34 Thanks @jacobheric! - Allow useRealtime to accept direct client subscription tokens from getClientSubscriptionToken() when channel and topics are provided as hook options, and avoid reconnecting solely because an inline token factory or token object gets a new render identity.
#1506 342a7369 Thanks @amh4r! - Add option to disable unauthed PUT requests
#1518 fd71a95b Thanks @Linell! - Fix RetryAfterError not respected

4.4.0

Minor Changes

#1508 4771b424 Thanks @amh4r! - Add experimental support for deferred functions

Patch Changes

#1512 be675a3d Thanks @amh4r! - Fix waitForSignal not in middleware StepType union
#1513 cbad05c3 Thanks @jakobevangelista! - Standardize variant naming to variant instead of variant_selected
#1516 1bca44a8 Thanks @BrunoScheufler! - - Add Request ID & Job ID to context and logs

4.3.0

Minor Changes

#1504 5c8f50e1 Thanks @scottnuma! - Accept Temporal.Duration, Temporal.Instant, and Temporal.ZonedDateTime (and their *Like variants) wherever a timeout or sleep duration is taken: step.sleep(), step.waitForEvent(), step.waitForSignal(), step.invoke(), and function-level cancelOn timeouts. Durations are treated as relative waits; instants and zoned date-times as absolute deadlines.

Patch Changes

#1480 60cda73f Thanks @mar-inngest! - Fix Connect shutdown getting stuck when a late lease-extension ACK recreates a stale in-flight lease entry after request completion or lease loss

4.2.6

Patch Changes

#1492 68dcd8aa Thanks @amh4r! - Reduce response info when unauthorized
#1490 a8027116 Thanks @amh4r! - Authed introspection returns partial signing key hash

4.2.5

Patch Changes

#1479 6b9769ca Thanks @scottnuma! - Fix step.sendSignal() return type to match runtime: Promise<InngestApi.SendSignalResponse> ({ runId: string | undefined }) instead of Promise<null>
#1483 d0a59629 Thanks @Linell! - Fix run IDs not URL encoded in Durable Endpoints
#1481 970ded9b Thanks @Linell! - Improves HMAC signature verification by using a constant-time comparison, which mitigates a potential timing-based signature-recovery attack against the request signature. Also improves handling of timestamps in signatures, including malformed or future-dated values.
#1472 9df36dee Thanks @Linell! - Fix empty body on Vercel serverless Node handlers
#1482 e34972d3 Thanks @Linell! - Hash the signing key used when exporting OTel traces

4.2.4

Patch Changes

#1466 68de9150 Thanks @amh4r! - Fix checkpointing maxRuntime causing duplicate execution

4.2.3

Patch Changes

#1460 ce5110de Thanks @amh4r! - Fix multi-byte UTF-8 chars corrupted when split over chunks
#1461 d75b59ce Thanks @amh4r! - Fix CountQueuingStrategy erroring when stubbed in edge runtimes

4.2.2

Patch Changes

#1366 aca72f88 Thanks @Linell! - Fix extendProvider() for OTel SDK v2 where addSpanProcessor() was removed.

Move @opentelemetry/auto-instrumentations-node and related imports from static top-level to dynamic await import() inside createProvider(). This prevents module-level monkey-patching side effects that broke inngest.send() when combined with host app OTel setups (e.g. Sentry). See #1324.
#1457 d151b404 Thanks @amh4r! - Fix using CountQueuingStrategy when not available
#1455 15495e03 Thanks @amh4r! - Fix dependencyInjection not working statically at function level

4.2.1

Patch Changes

#1453 3645404f Thanks @amh4r! - Add default checkpointing maxRuntime

4.2.0

Minor Changes

#1424 14fc7ef4 Thanks @Linell! - Add streaming support to Durable Endpoints

4.1.2

Patch Changes

#1435 d8fc84b2 Thanks @KiKoS0! - Fix Connect worker blocking flushing & termination issues
#1437 ad7ae27a Thanks @amh4r! - Fix worker thread strategy missing graceful shutdown

4.1.1

Patch Changes

#1420 38c6e27c Thanks @BrunoScheufler! - Connect: Refactor internal architecture
#1412 556a32eb Thanks @rhino1998! - Extended Traces: Include step attributes in userland spans
#1414 7e699a06 Thanks @rhino1998! - Step Metadata: Collapse step/step_attempt behavior
#1418 31300308 Thanks @BrunoScheufler! - Fix graceful shutdown cleanup in case of draining connection replacement
494364eb Thanks @jpwilliams! - Fix type exports not being available for composite: true projects

4.1.0

Minor Changes

#1342 627c0720 Thanks @jacobheric! - Adds first class, internal realtime support with improved DX for publishing and subscribing to typed channels and topics. See: https://www.inngest.com/docs/features/realtime

4.0.5

Patch Changes

#1400 a545f98e Thanks @amh4r! - Fix triggers applying to onFailure handler

4.0.4

Patch Changes

#1397 103a7212 Thanks @amh4r! - Fix eventType can't be combined with if expression

4.0.3

Patch Changes

#1395 c4861ff8 Thanks @amh4r! - Error when function config is v3-style
#1389 905d4b24 Thanks @amh4r! - Ensure we track retries when creating a new run
#1396 9baa304f Thanks @amh4r! - Fix onRunError hook's isFinalAttempt not true on final attempt

4.0.2

Patch Changes

#1387 983f527b Thanks @amh4r! - Fix checkpointing maxRuntime causing function run hang
#1387 983f527b Thanks @amh4r! - Fallback to async flow on checkpoint error

4.0.1

Patch Changes

#1384 02759eb6 Thanks @Linell! - fix: wrap AssertNoTransform to prevent union distribution

4.0.0

Major Changes

#1346 e8024132 Thanks @amh4r! - See list of changes in the migration guide: https://www.inngest.com/docs/reference/typescript/v4/migrations/v3-to-v4

3.52.7

Patch Changes

#1359 b4d9833f Thanks @Linell! - fix: use deterministic IDs for correct checkpointed parenting
#1370 037336dc Thanks @amh4r! - Fix mishandling drain message (Connect only)

3.52.6

Patch Changes

#1350 470fdb98 Thanks @amh4r! - Fix false NESTING_STEPS error
#1356 2e961c21 Thanks @amh4r! - Fix checkpointing maxRuntime causing function run hang

3.52.5

Patch Changes

#1340 335703d7 Thanks @Linell! - fix: fallback to async flow on checkpoint error

3.52.4

Patch Changes

#1338 4f45adb7 Thanks @jakobevangelista! - Fix signing key propagation from serve() options to InngestApi for outgoing API calls

3.52.3

Patch Changes

#1329 d079c0be Thanks @Linell! - fix: flush checkpoint buffer

3.52.2

Patch Changes

#1318 d81d29bc Thanks @amh4r! - Fix undefined step in transformOutput middleware

3.52.1

Patch Changes

#1258 e17a148f Thanks @amh4r! - Connect: add worker thread support
#1313 bbdab785 Thanks @tonyhb! - Add step names and IDs to step not found error
#1306 b74bd1b9 Thanks @amh4r! - Add a log before the 405 response

3.52.0

Minor Changes

#1288 daf858f0 Thanks @jpwilliams! - Add the ability to create Durable Endpoint Proxies, used to redirect to Inngest run results using a user's own domain.

import { Inngest, step } from "inngest";
import { endpointAdapter } from "inngest/edge";

const inngest = new Inngest({
  id: "bun-sync-example",
  endpointAdapter: endpointAdapter.withOptions({
    asyncRedirectUrl: "/poll",
  }),
});

const server = Bun.serve({
  port: 3000,
  routes: {
    "/": inngest.endpoint(async (_req) => {
      const foo = await step.run("example/step", async () => {
        return "Hello from step!";
      });

      return new Response(`Step result: ${foo}`);
    }),

    // Proxy endpoint - fetches results from Inngest and decrypts if needed
    "/poll": inngest.endpointProxy(),
  },
});

console.log(`Listening on ${server.hostname}:${server.port}`);

#1284 5717c64b Thanks @jpwilliams! - Add a Durable Endpoints Next.js Adapter

// app/api/my-endpoint/route.ts
import { Inngest, step } from "inngest";
import { endpointAdapter } from "inngest/next";

const inngest = new Inngest({
  id: "my-app",
  endpointAdapter,
});

export const GET = inngest.endpoint(async (req) => {
  const foo = await step.run("my-step", () => ({ foo: "bar" }));

  return new Response(`Result: ${JSON.stringify(foo)}`);
});

Patch Changes

#1297 32b59507 Thanks @ptts! - Fix extendProvider() failing to extend existing OTel providers by unwrapping the ProxyTracerProvider returned by trace.getTracerProvider(). Previously, the proxy wrapper hid the underlying provider's addSpanProcessor method, causing "auto" mode to fall through to createProvider() and register duplicate instrumentations.
#1292 9c8f5d94 Thanks @jpwilliams! - Fix Durable Endpoints not capturing and obeying step plan forcing, resulting in strange behaviour during parallel flows
#1285 9a7b0528 Thanks @jpwilliams! - Handle checkpointing failures more gracefully across async checkpointing and Durable Endpoints

3.51.0

Minor Changes

#1269 8e377c27 Thanks @jpwilliams! - Add isInngestRequest() export for lightly checking if a Request looks like it comes from Inngest

import { Inngest, step } from "inngest"; import { endpointAdapter } from "inngest/edge"; const inngest = new Inngest({ id: "bun-sync-example", endpointAdapter: endpointAdapter.withOptions({ asyncRedirectUrl: "/poll", }), }); const server = Bun.serve({ port: 3000, routes: { "/": inngest.endpoint(async (_req) => { const foo = await step.run("example/step", async () => { return "Hello from step!"; }); return new Response(`Step result: ${foo}`); }), // Proxy endpoint - fetches results from Inngest and decrypts if needed "/poll": inngest.endpointProxy(), }, }); console.log(`Listening on ${server.hostname}:${server.port}`);

// app/api/my-endpoint/route.ts import { Inngest, step } from "inngest"; import { endpointAdapter } from "inngest/next"; const inngest = new Inngest({ id: "my-app", endpointAdapter, }); export const GET = inngest.endpoint(async (req) => { const foo = await step.run("my-step", () => ({ foo: "bar" })); return new Response(`Result: ${JSON.stringify(foo)}`); });