## v1.31.1 - 2026-09-03 ### Security - Bumped `qs` to 6.16.0 to address GHSA-4mjr-xmp4-gh2g and GHSA-x5fp-wj9c-mxmx. ## v1.31.0 - 2026-09-03 ### Added - Added support for tenant-scoped shared concurrency strategies. Declare a `Concurrency` entry with `isTenantScoped: true` and a `name`, and reference the same name from tasks in different workflows so they share a single concurrency limit. Tenant-scoped entries can be mixed with ordinary workflow-scoped entries on the same task. - `Concurrency.maxRuns` now accepts `number | string`: a string is a CEL expression over task input computing the max runs for each concurrency group, so different groups (e.g. pricing tiers) can have different limits. ## v1.30.1 - 2026-09-01 ### Fixed - Fixes another durable callback ordering bug which would cause NonDeterminismErrors to be raised on replay in the case where e.g. children were spawned recursively, concurrently. ## v1.30.0 - 2026-08-26 ### Added - Added support for `CANCEL_QUEUED_EXCEPT_NEWEST` and `CANCEL_QUEUED_EXCEPT_OLDEST` concurrency strategies. ## v1.29.3 - 2026-08-31 ### Changed - The missing-token configuration error now explains how to run Hatchet embedded for local development, via `HatchetEmbeddedClient.init()`, with a link to the embedded mode docs. ## v1.29.2 - 2026-08-10 ### Fixed - Improved error handling around failed heartbeats ## v1.29.1 - 2026-08-25 ### Added - Added `stopEmbedded()` on clients returned by `HatchetEmbeddedClient.init()` and a standalone `stopEmbeddedSidecar()` export, which gracefully stop the embedded engine (including its bundled Postgres) and resolve once it has fully exited. ## v1.29.0 - 2026-08-24 ### Added - Added embedded mode (early beta): `HatchetEmbeddedClient.init()` from the `@hatchet-dev/typescript-sdk/v1/embedded` entry point downloads and spawns the `hatchet-embedded` sidecar (checksum-verified, cached under `~/.hatchet/embedded`), runs a full Hatchet engine locally with a bundled Postgres by default (pass `databaseUrl` to use your own), and returns a client wired to it. The separate entry point keeps embedded support out of production bundles. ## v1.28.2 - 2026-08-10 ### Fixed - Changed `hatchet.task` constructor concurrency options handling so that it does not set concurrency options at the workflow level, which would cause slow concurrency strategy handling in the engine ## v1.28.1 - 2026-07-30 ### Fixed - Fixed heartbeat worker logging to ignore Node watch-mode worker reload messages that don’t match the heartbeat message protocol. - Improved heartbeat worker and action listener logging to ignore first network error, warn log on second error, and only error log past 3 errors to reduce false alarms due to transient network errors. ## v1.28.0 - 2026-07-23 ### Changed - Adds beta `batchTask` methods to both tasks and workflows, allowing for dynamic batching based on either time or batch size. ## v1.27.0 - 2026-07-22 ### Added - Adds support for terminal status-based idempotency keys, which are released when the task holding the key reaches a terminal state (either completed, cancelled, or having failed and exhausted all retries). ## v1.26.2 - 2026-07-21 ### Added - Added a `retrier` config option to `ClientConfig` (and corresponding `HATCHET_CLIENT_RETRIER_MAX_ATTEMPTS`, `HATCHET_CLIENT_RETRIER_INITIAL_INTERVAL`, `HATCHET_CLIENT_RETRIER_MAX_JITTER` env vars) to control retry behavior for user-facing gRPC calls — event pushes and workflow triggers. Internal engine communications (action events, stream events, workflow registration) are unaffected and continue using hardcoded defaults. ## v1.26.1 - 2026-07-20 ### Added - Added `ctx.workflowNameV1()` to return the current workflow name. ### Deprecated - Deprecated `ctx.workflowName()`, which continues to return the task name for backward compatibility. Use `ctx.workflowNameV1()` for the workflow name or `ctx.taskName()` for the task name. ### Fixed - Fixed workflow name values in context log metadata and OpenTelemetry attributes. ## v1.26.0 - 2026-07-16 ### Added - Adds support for defining **idempotency keys** on workflows and standalone tasks via an `idempotency` option, which ensures that they're only run once in a provided time window, based on a CEL expression. Triggers that collide with an existing run throw an `IdempotencyCollisionError` containing the existing run's ID. ## v1.25.0 - 2026-07-09 ### Added - Added `slotCost` to task options, so a task that needs more memory or CPU can consume more than one worker slot and a worker runs fewer of them at once. Durable tasks do not accept it, and on older engines it has no effect. See [Task Slot Cost](https://docs.hatchet.run/v1/advanced-assignment/slot-cost). ## v1.24.3 - 2026-06-17 ### Removed - Removed the unused `_isV1` field and `isV1` getter from `HatchetClient`. The getter always returned a hardcoded value and was not referenced anywhere in the codebase. ## v1.24.2 - 2026-06-15 ### Fixed - Fixed a bug where the durable event listener's request iterator could survive a stream reconnect and drain items from the new queue into the dead stream, causing durable tasks to hang indefinitely after an engine restart. The iterator now captures its queue and abort signal at creation time and terminates cleanly when the connection is replaced. ## v1.24.1 - 2026-06-12 ### Fixed - Fixed an issue where errors raised by child tasks spawned inside a durable parent task were not propagated back to the parent. The parent can now catch the child's error and handle it gracefully. ## v1.24.0 - 2026-06-11 ### Added - Added a `getDetails` method to `hatchet.runs` to retrieve task details. ## v1.23.1 - 2026-06-09 ### Added - Added an `individualRunSpansForBulkRun` OpenTelemetry config option. When enabled, a child `hatchet.run_workflow` span is created for each item in a bulk run (`runWorkflows`), nested under the parent `hatchet.run_workflows` span, with each item's traceparent pointing at its own span. Defaults to `false` to preserve the existing span structure. ### Fixed - `WorkflowsClient.get()` now finds the exact workflow name match from list results instead of taking the first result, preventing incorrect workflow ID resolution when a name prefix-match returns multiple workflows. ## v1.23.0 - 2026-05-27 ### Added - Fixes `cancellation_grace_period` and `cancellation_warning_threshold` not being propagated from client config to Hatchet config. - Adds `grpc_max_recv_message_length` and `grpc_max_send_message_length` to client config, also configurable via env vars. Defaults to 4MB. ### Fixed - SDK import deprecation warnings to route via `process.emitWarning` with code `HATCHET_V0_REMOVED`. - `EventClient.BulkPush` call uses `options` argument as fallback when no `input` is present. ## v1.22.4 - 2026-05-22 ### Fixed - Bumped `@anthropic-ai/claude-agent-sdk` to `^0.3.148` so Claude agent SDK integrations resolve the correct Linux native binary on glibc systems. - Updated the TypeScript Claude agent example to load the ESM-only Claude Agent SDK dynamically. ## v1.22.3 - 2026-05-18 ### Fixed - Fixed `@openai/agents` import that was not inside try block and caused errors when installing with Bun. ## v1.22.2 - 2026-05-13 ### Fixed - Fixed `DurableContext.waitForEvent` overload ordering so calls without a payload schema infer the untyped event payload return type. ## v1.22.1 - 2026-05-05 ### Fixed Moved optional dependencies from `optionalDependencies` to `peerDependencies`. ## v1.22.0 - 2026-04-28 ### Added - Adds `mcpTool` method to Workflow objects for integration with Claude and OpenAI agent SDKs. Requires Zod v4. - Bumps minimum Zod version to `3.25.0`. Zod schemas provided to the SDK must be Zod 4 schemas, but you can still use Zod 3 in your application code. ## v1.21.2 - 2026-04-22 ### Added - Adds `triggeringEventId` and `triggeringEventKey` to the `Context` ## v1.21.1 - 2026-04-21 ### Fixed - Adds an optional `label` on durable event waits, which will propagate through to the dashboard ## v1.21.0 - 2026-04-08 ### Added - runMany and runManyNoWait APIs for workflows and standalone tasks to support bulk runs with per-run options. - RunManyOpt input shape containing an input object and an options object. ### Changed - Bulk docs to include runMany and runManyNoWait examples. ## v1.20.1 - 2026-04-07 ### Fixed - Fixed duplicate child run deduplication when mixing `ctx.runChild()` and `workflow.runNoWait()` (or deeply nested recursive spawns). `Context.spawnIndex` and `ParentRunContextManager.childIndex` were tracked independently, causing both APIs to emit overlapping `childIndex` values and silently deduplicate children that should have been unique. The two counters now share a single source of truth via `AsyncLocalStorage`, and `incrementChildIndex` mutates the context object in place instead of replacing it with `enterWith`, which lost updates across `await` boundaries. ## v1.20.0 - 2026-04-07 ### Added - Adds `scope` and `lookbackWindow` arguments for the `DurableContext.waitForEvent`, which allows durable tasks to look back in time for events that may have been emitted before the task started. ## v1.19.1 - 2026-03-25 ### Changed - Event source info (`hatchet__source_workflow_run_id`, `hatchet__source_step_run_id`) is now injected into event metadata at the `EventClient` level, so cross-workflow trace linking works even without the OTel instrumentor enabled. ## v1.19.0 - 2026-03-25 ### Fixed - Fixed OpenTelemetry version mismatch causing `TypeError: Cannot read properties of undefined (reading 'name')` when exporting spans. The SDK now requires OpenTelemetry JS SDK 2.x (`@opentelemetry/sdk-trace-base@^2.0.0`, `@opentelemetry/core@^2.0.0`) to match the `@opentelemetry/exporter-trace-otlp-grpc@^0.208.0` dependency. ### Changed - Updated OpenTelemetry optional dependencies to the unified 2.x release set. ## v1.18.0 - 2026-03-18 ### Added - OpenTelemetry instrumentation via `HatchetInstrumentor` with automatic tracing for workflow runs, event pushes, and step executions - OpenTelemetry example demonstrating automatic and custom span instrumentation (`examples/opentelemetry_instrumentation`) ## v1.17.2 - 2026-03-17 ### Added - Added `getTaskStats` and `scrapePrometheusMetrics` methods to the metrics client. ## v1.17.1 - 2026-03-17 ### Changed - Updates the `DurableTaskRunAckEntryResult` interface to include `workflowRunExternalId` field, to enable spawning children from durable tasks fire-and-forget style. ## v1.17.0 - 2026-03-16 ### Added - Added a `DurableContext.waitForEvent` helper which returns the payload of the awaited event. - Added an `EvictionPolicy`, which allows durable tasks to be evicted from the worker when idle. ### Changed - Makes a bunch of internal-facing changes for new durable execution features ## v1.16.0 - 2026-03-11 ### Added - Added logs client for retrieving task run logs. ## v1.15.2 - 2026-03-06 ### Fixed - `waitFor` and task conditions (e.g. user event keys) are correctly namespaced when using a non-default namespace. - Cron expressions now support an optional leading seconds field (6-part expressions), e.g. `30 * * * * *` to trigger at 30 seconds past every minute. ## v1.15.1 - 2026-03-04 ### Fixed - Fix npm publish so the package includes compiled JavaScript at the correct paths. ## v1.15.0 - 2026-03-03 ### Added - Adds a `desiredWorkerLabels` option to `RunOpts` to allow dynamically routing task runs to a specific worker at trigger time ## v1.14.0 - 2026-02-28 ### Deprecated - v0 SDK is now deprecated. Migrate to the v1 API for ongoing support. ### Added - Internal legacy transformer for backwards compatibility with existing v0 workflows and workers. ## v1.13.1 - 2026-02-27 ### Changed - Updated internal dependencies to address security advisories. ## v1.13.0 - 2026-02-23 ### Added - Introduced client middleware support with composable `before`/`after` hooks to customize request handling and response processing. - Added middleware examples and recipes to demonstrate practical client-side patterns. ## v1.12.1 - 2026-02-18 ### Fixed - Restored `ctx.taskRunId()` as a deprecated alias for `ctx.taskRunExternalId()` on both v0 and v1 worker contexts, so existing code calling `ctx.taskRunId()` continues to work after the proto naming changes in 1.11.0. ## v1.12.0 - 2026-02-13 ### Added - Webhooks client for managing incoming webhooks: create, list, get, update, and delete methods for webhooks, so external systems (e.g. GitHub, Stripe) can trigger workflows via HTTP. ## v1.11.0 - 2026-02-05 ### Internal Only - Updated gRPC/REST contract field names to lowerCamelCase for consistency across SDKs. ## v1.11.0 - 2026-02-04 ### Changed - Updated the metrics client for the latest server metrics APIs (including adding `getTaskStatusMetrics` for tenant task/run status counts). - Removes deprecated metrics methods. ## v1.10.8 - 2026-02-02 ### Changed - Improved cancellation log messages: cancellation-related logs now use `debug` level instead of `error` level since cancellation is expected behavior, not a failure. - Updated terminology in log messages from "step run" to "task run" for consistency. - Added link to cancellation docs (https://docs.hatchet.run/home/cancellation) in error messages when task completion fails. ## v1.10.7 - 2026-01-27 ### Added - Adds support for an `inputValidator` prop on the various workflow definitions, e.g. `hatchet.workflow` and `hatchet.task`, which accepts a Zod schema to validate the input to the workflow or task. Used on the dashboard to provide autocomplete on the trigger workflow form. ## v1.10.6 - 2026-01-27 ### Changed - Improves handling of cancellations for tasks to limit how often tasks receive a cancellation but then are marked as succeeded anyways.