@hatchet-dev/typescript-sdk 1.22.2 → 1.23.0

package/clients/event/event-client.js

@@ -70,7 +70,7 @@ class EventClient {
     bulkPush(type, inputs, options = {}) {
         const namespacedType = (0, apply_namespace_1.applyNamespace)(type, this.config.namespace);
         const events = inputs.map((input) => {
-            var _a, _b;
+            var _a, _b, _c, _d;
             const baseMeta = (_b = (_a = input.additionalMetadata) !== null && _a !== void 0 ? _a : options.additionalMetadata) !== null && _b !== void 0 ? _b : {};
             const enhanced = injectSourceInfo(baseMeta);
             return {
@@ -78,8 +78,8 @@ class EventClient {
                 payload: JSON.stringify(input.payload),
                 eventTimestamp: new Date(),
                 additionalMetadata: Object.keys(enhanced).length > 0 ? JSON.stringify(enhanced) : undefined,
-                priority: input.priority,
-                scope: input.scope,
+                priority: (_c = input.priority) !== null && _c !== void 0 ? _c : options.priority,
+                scope: (_d = input.scope) !== null && _d !== void 0 ? _d : options.scope,
             };
         });
         const req = {

package/clients/hatchet-client/client-config.d.ts

@@ -56,6 +56,8 @@ export declare const ClientConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
     cancellation_grace_period: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     cancellation_warning_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    grpc_max_recv_message_length: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    grpc_max_send_message_length: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
 export type LogConstructor = (context: string, logLevel?: LogLevel) => Logger;
 /**
@@ -98,9 +100,11 @@ export type InferMiddlewareAfter<M> = M extends {
     after: infer P;
 } ? P extends (...args: any[]) => any ? NonVoidReturn<P> : P extends readonly any[] ? MergeReturns<P> : {} : {};
 type ClientConfigInferred = z.infer<typeof ClientConfigSchema>;
-export type ClientConfig = Omit<ClientConfigInferred, 'cancellation_grace_period' | 'cancellation_warning_threshold'> & {
+export type ClientConfig = Omit<ClientConfigInferred, 'cancellation_grace_period' | 'cancellation_warning_threshold' | 'grpc_max_recv_message_length' | 'grpc_max_send_message_length'> & {
     cancellation_grace_period?: number;
     cancellation_warning_threshold?: number;
+    grpc_max_recv_message_length?: number;
+    grpc_max_send_message_length?: number;
 } & {
     credentials?: ChannelCredentials;
 } & {

package/clients/hatchet-client/client-config.js

@@ -45,4 +45,16 @@ exports.ClientConfigSchema = v4_1.z.object({
     middleware: TaskMiddlewareSchema,
     cancellation_grace_period: DurationMsSchema.optional().default(1000),
     cancellation_warning_threshold: DurationMsSchema.optional().default(300),
+    grpc_max_recv_message_length: v4_1.z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(4 * 1024 * 1024),
+    grpc_max_send_message_length: v4_1.z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .default(4 * 1024 * 1024),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatchet-dev/typescript-sdk",
-  "version": "1.22.2",
+  "version": "1.23.0",
   "description": "Background task orchestration & visibility for developers",
   "types": "dist/index.d.ts",
   "files": [
@@ -40,6 +40,16 @@
     "ts-proto": "^2.11.4",
     "tsconfig-paths": "^4.2.0",
     "tsx": "^4.21.0",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.148",
+    "@grpc/grpc-js": "^1.14.3",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@openai/agents": "0.11.4",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^2.0.0",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.218.0",
+    "@opentelemetry/instrumentation": "^0.218.0",
+    "@opentelemetry/sdk-trace-base": "^2.0.0",
+    "prom-client": "^15.1.3",
     "typedoc": "^0.28.17",
     "typedoc-plugin-markdown": "^4.10.0",
     "typedoc-plugin-no-inherit": "^1.6.1",
@@ -62,14 +72,14 @@
   },
   "peerDependencies": {
     "zod": "^3.25.0 || ^4.0.0",
-    "@anthropic-ai/claude-agent-sdk": "^0.2.87",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.148",
     "@grpc/grpc-js": "^1.14.3",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@openai/agents": "0.8.5",
+    "@openai/agents": "0.11.4",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/core": "^2.0.0",
-    "@opentelemetry/exporter-trace-otlp-grpc": "^0.215.0",
-    "@opentelemetry/instrumentation": "^0.215.0",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.218.0",
+    "@opentelemetry/instrumentation": "^0.218.0",
     "@opentelemetry/sdk-trace-base": "^2.0.0",
     "prom-client": "^15.1.3"
   },

package/step.js

@@ -14,7 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const v0_deprecation_warning_1 = require("./util/v0-deprecation-warning");
 __exportStar(require("./legacy/step"), exports);
-console.warn('\x1b[31mDeprecation warning: The v0 sdk, including the step module has been deprecated and has been removed in release v1.14.0.\x1b[0m');
-console.warn('\x1b[32mPlease migrate to v1 SDK instead: https://docs.hatchet.run/home/v1-sdk-improvements\x1b[0m');
-console.warn('--------------------------------');
+(0, v0_deprecation_warning_1.emitV0RemovedWarning)('step');

package/util/config-loader/config-loader.d.ts

@@ -5,6 +5,7 @@ interface LoadClientConfigOptions {
 }
 export declare class ConfigLoader {
     static loadClientConfig(override?: Partial<ClientConfig>, config?: LoadClientConfigOptions): Partial<ClientConfig>;
+    private static parseIntEnv;
     private static parseJsonArray;
     static get default_yaml_config_path(): string;
     static createCredentials(config: ClientConfig['tls_config']): ChannelCredentials;

package/util/config-loader/config-loader.js

@@ -44,7 +44,7 @@ const token_1 = require("./token");
 const DEFAULT_CONFIG_FILE = '.hatchet.yaml';
 class ConfigLoader {
     static loadClientConfig(override, config) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18;
         const yaml = this.loadYamlConfig(config === null || config === void 0 ? void 0 : config.path);
         const tlsConfig = (_a = override === null || override === void 0 ? void 0 : override.tls_config) !== null && _a !== void 0 ? _a : {
             tls_strategy: (_d = (_c = (_b = yaml === null || yaml === void 0 ? void 0 : yaml.tls_config) === null || _b === void 0 ? void 0 : _b.tls_strategy) !== null && _c !== void 0 ? _c : this.env('HATCHET_CLIENT_TLS_STRATEGY')) !== null && _d !== void 0 ? _d : 'tls',
@@ -74,7 +74,7 @@ class ConfigLoader {
             apiUrl =
                 (_x = (_w = (_v = override === null || override === void 0 ? void 0 : override.api_url) !== null && _v !== void 0 ? _v : yaml === null || yaml === void 0 ? void 0 : yaml.api_url) !== null && _w !== void 0 ? _w : this.env('HATCHET_CLIENT_API_URL')) !== null && _x !== void 0 ? _x : addresses.serverUrl;
         }
-        catch (_11) {
+        catch (_19) {
             grpcBroadcastAddress =
                 (_z = (_y = override === null || override === void 0 ? void 0 : override.host_port) !== null && _y !== void 0 ? _y : yaml === null || yaml === void 0 ? void 0 : yaml.host_port) !== null && _z !== void 0 ? _z : this.env('HATCHET_CLIENT_HOST_PORT');
             apiUrl = (_1 = (_0 = override === null || override === void 0 ? void 0 : override.api_url) !== null && _0 !== void 0 ? _0 : yaml === null || yaml === void 0 ? void 0 : yaml.api_url) !== null && _1 !== void 0 ? _1 : this.env('HATCHET_CLIENT_API_URL');
@@ -87,18 +87,33 @@ class ConfigLoader {
             excludedAttributes: this.parseJsonArray(this.env('HATCHET_CLIENT_OPENTELEMETRY_EXCLUDED_ATTRIBUTES') || '[]'),
             includeTaskNameInSpanName: this.env('HATCHET_CLIENT_OPENTELEMETRY_INCLUDE_TASK_NAME_IN_SPAN_NAME') === 'true',
         };
+        const grpcMaxRecvMessageLength = (_8 = (_7 = (_6 = override === null || override === void 0 ? void 0 : override.grpc_max_recv_message_length) !== null && _6 !== void 0 ? _6 : yaml === null || yaml === void 0 ? void 0 : yaml.grpc_max_recv_message_length) !== null && _7 !== void 0 ? _7 : this.parseIntEnv('HATCHET_CLIENT_GRPC_MAX_RECV_MESSAGE_LENGTH')) !== null && _8 !== void 0 ? _8 : 4 * 1024 * 1024;
+        const grpcMaxSendMessageLength = (_11 = (_10 = (_9 = override === null || override === void 0 ? void 0 : override.grpc_max_send_message_length) !== null && _9 !== void 0 ? _9 : yaml === null || yaml === void 0 ? void 0 : yaml.grpc_max_send_message_length) !== null && _10 !== void 0 ? _10 : this.parseIntEnv('HATCHET_CLIENT_GRPC_MAX_SEND_MESSAGE_LENGTH')) !== null && _11 !== void 0 ? _11 : 4 * 1024 * 1024;
         return {
-            token: (_7 = (_6 = override === null || override === void 0 ? void 0 : override.token) !== null && _6 !== void 0 ? _6 : yaml === null || yaml === void 0 ? void 0 : yaml.token) !== null && _7 !== void 0 ? _7 : this.env('HATCHET_CLIENT_TOKEN'),
+            token: (_13 = (_12 = override === null || override === void 0 ? void 0 : override.token) !== null && _12 !== void 0 ? _12 : yaml === null || yaml === void 0 ? void 0 : yaml.token) !== null && _13 !== void 0 ? _13 : this.env('HATCHET_CLIENT_TOKEN'),
             host_port: grpcBroadcastAddress,
             api_url: apiUrl,
             tls_config: tlsConfig,
             healthcheck: healthCheckConfig,
-            log_level: (_10 = (_9 = (_8 = override === null || override === void 0 ? void 0 : override.log_level) !== null && _8 !== void 0 ? _8 : yaml === null || yaml === void 0 ? void 0 : yaml.log_level) !== null && _9 !== void 0 ? _9 : this.env('HATCHET_CLIENT_LOG_LEVEL')) !== null && _10 !== void 0 ? _10 : 'INFO',
+            log_level: (_16 = (_15 = (_14 = override === null || override === void 0 ? void 0 : override.log_level) !== null && _14 !== void 0 ? _14 : yaml === null || yaml === void 0 ? void 0 : yaml.log_level) !== null && _15 !== void 0 ? _15 : this.env('HATCHET_CLIENT_LOG_LEVEL')) !== null && _16 !== void 0 ? _16 : 'INFO',
             tenant_id: tenantId,
             namespace: namespace ? `${namespace}`.toLowerCase() : '',
             otel: otelConfig,
+            grpc_max_recv_message_length: grpcMaxRecvMessageLength,
+            grpc_max_send_message_length: grpcMaxSendMessageLength,
+            cancellation_grace_period: (_17 = override === null || override === void 0 ? void 0 : override.cancellation_grace_period) !== null && _17 !== void 0 ? _17 : yaml === null || yaml === void 0 ? void 0 : yaml.cancellation_grace_period,
+            cancellation_warning_threshold: (_18 = override === null || override === void 0 ? void 0 : override.cancellation_warning_threshold) !== null && _18 !== void 0 ? _18 : yaml === null || yaml === void 0 ? void 0 : yaml.cancellation_warning_threshold,
         };
     }
+    static parseIntEnv(envName) {
+        const value = this.env(envName);
+        if (value === undefined || value === '')
+            return undefined;
+        if (!/^\d+$/.test(value.trim())) {
+            throw new Error(`Invalid value for ${envName}: "${value}". Expected a positive integer.`);
+        }
+        return parseInt(value, 10);
+    }
     static parseJsonArray(value) {
         try {
             const parsed = JSON.parse(value);

package/util/grpc-helpers.js

@@ -29,17 +29,22 @@ exports.createGrpcClient = exports.addTokenMiddleware = exports.channelFactory =
 const nice_grpc_1 = require("nice-grpc");
 const nice_grpc_common_1 = require("nice-grpc-common");
 const config_loader_1 = require("./config-loader");
-const channelFactory = (config, credentials) => (0, nice_grpc_1.createChannel)(config.host_port, credentials, {
-    'grpc.ssl_target_name_override': config.tls_config.server_name,
-    'grpc.keepalive_timeout_ms': 60 * 1000,
-    'grpc.client_idle_timeout_ms': 60 * 1000,
-    // Send keepalive pings every 10 seconds, default is 2 hours.
-    'grpc.keepalive_time_ms': 10 * 1000,
-    // Allow keepalive pings when there are no gRPC calls.
-    'grpc.keepalive_permit_without_calls': 1,
-    // Enable gzip compression for all calls on this channel
-    'grpc.default_compression_algorithm': 2, // 2 = Gzip compression
-});
+const channelFactory = (config, credentials) => {
+    var _a, _b;
+    return (0, nice_grpc_1.createChannel)(config.host_port, credentials, {
+        'grpc.ssl_target_name_override': config.tls_config.server_name,
+        'grpc.keepalive_timeout_ms': 60 * 1000,
+        'grpc.client_idle_timeout_ms': 60 * 1000,
+        // Send keepalive pings every 10 seconds, default is 2 hours.
+        'grpc.keepalive_time_ms': 10 * 1000,
+        // Allow keepalive pings when there are no gRPC calls.
+        'grpc.keepalive_permit_without_calls': 1,
+        // Enable gzip compression for all calls on this channel
+        'grpc.default_compression_algorithm': 2, // 2 = Gzip compression
+        'grpc.max_send_message_length': (_a = config.grpc_max_send_message_length) !== null && _a !== void 0 ? _a : 4 * 1024 * 1024,
+        'grpc.max_receive_message_length': (_b = config.grpc_max_recv_message_length) !== null && _b !== void 0 ? _b : 4 * 1024 * 1024,
+    });
+};
 exports.channelFactory = channelFactory;
 const addTokenMiddleware = (token) => function _(call, options) {
     return __asyncGenerator(this, arguments, function* _1() {

package/util/v0-deprecation-warning.d.ts

@@ -0,0 +1,44 @@
+/**
+ * v0 SDK root-import deprecation warnings.
+ *
+ * The legacy `workflow` and `step` re-exports under the root specifier need
+ * to keep nagging consumers to migrate to v1, but the original implementation
+ * used `console.warn` at module evaluation time, which:
+ *   - cannot be silenced by Node's standard `--no-deprecation`,
+ *     `--no-warnings`, or `--no-warnings=DeprecationWarning` flags;
+ *   - has no stable `code` for `process.on('warning', ...)` handlers; and
+ *   - is duplicated when both submodules are loaded (which happens for
+ *     anyone importing from the root, since `index.ts` re-exports both).
+ *
+ * Switching to `process.emitWarning` with a fixed code makes the warnings
+ * filterable, dedupable, and consistent with the rest of Node's deprecation
+ * surface, while still being visible by default.
+ */
+export declare const V0_DEPRECATION_CODE = "HATCHET_V0_REMOVED";
+/** Reset hook for tests. Not part of the public API. */
+export declare function _resetEmittedV0Warnings(): void;
+/**
+ * Emit a deduplicated v0-removal deprecation warning for a given submodule.
+ *
+ * Each unique `submodule` is emitted at most once per process. Uses
+ * `process.emitWarning` when available so consumers can suppress or filter
+ * via standard Node mechanisms.
+ *
+ * Importing the SDK must never abort module evaluation, since the root
+ * specifier still re-exports v0 `workflow` and `step` for transitive
+ * consumers who only use v1 APIs. Two cases would otherwise crash them:
+ *
+ *   1. `process.throwDeprecation` (set by `--throw-deprecation` or directly).
+ *      Node queues a `throw warning` on the next tick after `emitWarning`
+ *      returns, so a `try`/`catch` around the call would not catch it. We
+ *      check the flag up front and route to `console.warn` instead.
+ *   2. Runtimes that don't expose `process.emitWarning` at all (older
+ *      browsers, certain bundler shims). Same fallback applies.
+ *
+ * The remaining `try`/`catch` is belt-and-suspenders for non-Node hosts
+ * where a polyfilled `emitWarning` could throw synchronously.
+ *
+ * @param submodule - The legacy v0 submodule being imported (e.g. "workflow", "step").
+ * @param detail    - Optional follow-up sentence appended to the warning detail.
+ */
+export declare function emitV0RemovedWarning(submodule: string, detail?: string): void;

package/util/v0-deprecation-warning.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * v0 SDK root-import deprecation warnings.
+ *
+ * The legacy `workflow` and `step` re-exports under the root specifier need
+ * to keep nagging consumers to migrate to v1, but the original implementation
+ * used `console.warn` at module evaluation time, which:
+ *   - cannot be silenced by Node's standard `--no-deprecation`,
+ *     `--no-warnings`, or `--no-warnings=DeprecationWarning` flags;
+ *   - has no stable `code` for `process.on('warning', ...)` handlers; and
+ *   - is duplicated when both submodules are loaded (which happens for
+ *     anyone importing from the root, since `index.ts` re-exports both).
+ *
+ * Switching to `process.emitWarning` with a fixed code makes the warnings
+ * filterable, dedupable, and consistent with the rest of Node's deprecation
+ * surface, while still being visible by default.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V0_DEPRECATION_CODE = void 0;
+exports._resetEmittedV0Warnings = _resetEmittedV0Warnings;
+exports.emitV0RemovedWarning = emitV0RemovedWarning;
+exports.V0_DEPRECATION_CODE = 'HATCHET_V0_REMOVED';
+const MIGRATION_URL = 'https://docs.hatchet.run/home/v1-sdk-improvements';
+const emittedSubmodules = new Set();
+/** Reset hook for tests. Not part of the public API. */
+function _resetEmittedV0Warnings() {
+    emittedSubmodules.clear();
+}
+function fallbackConsoleWarn(message, detail) {
+    console.warn(`[${exports.V0_DEPRECATION_CODE}] ${message}${detail ? `\n${detail}` : ''}`);
+}
+/**
+ * Emit a deduplicated v0-removal deprecation warning for a given submodule.
+ *
+ * Each unique `submodule` is emitted at most once per process. Uses
+ * `process.emitWarning` when available so consumers can suppress or filter
+ * via standard Node mechanisms.
+ *
+ * Importing the SDK must never abort module evaluation, since the root
+ * specifier still re-exports v0 `workflow` and `step` for transitive
+ * consumers who only use v1 APIs. Two cases would otherwise crash them:
+ *
+ *   1. `process.throwDeprecation` (set by `--throw-deprecation` or directly).
+ *      Node queues a `throw warning` on the next tick after `emitWarning`
+ *      returns, so a `try`/`catch` around the call would not catch it. We
+ *      check the flag up front and route to `console.warn` instead.
+ *   2. Runtimes that don't expose `process.emitWarning` at all (older
+ *      browsers, certain bundler shims). Same fallback applies.
+ *
+ * The remaining `try`/`catch` is belt-and-suspenders for non-Node hosts
+ * where a polyfilled `emitWarning` could throw synchronously.
+ *
+ * @param submodule - The legacy v0 submodule being imported (e.g. "workflow", "step").
+ * @param detail    - Optional follow-up sentence appended to the warning detail.
+ */
+function emitV0RemovedWarning(submodule, detail) {
+    if (emittedSubmodules.has(submodule)) {
+        return;
+    }
+    emittedSubmodules.add(submodule);
+    const message = `The v0 SDK, including the ${submodule} module, has been deprecated and was removed in v1.14.0. ` +
+        `Please migrate to the v1 SDK: ${MIGRATION_URL}`;
+    const hasProcess = typeof process !== 'undefined';
+    const hasEmitWarning = hasProcess && typeof process.emitWarning === 'function';
+    const willThrowAsync = hasProcess && process.throwDeprecation === true;
+    if (!hasEmitWarning || willThrowAsync) {
+        fallbackConsoleWarn(message, detail);
+        return;
+    }
+    try {
+        process.emitWarning(message, {
+            type: 'DeprecationWarning',
+            code: exports.V0_DEPRECATION_CODE,
+            detail,
+        });
+    }
+    catch (_a) {
+        fallbackConsoleWarn(message, detail);
+    }
+}

package/v1/agent/openai.js

@@ -49,8 +49,11 @@ const OpenAIToolFunc = (runnable) => {
     // z is imported from 'zod', so '_zod' in z.string() reflects the user's actual installed version.
     const hasZodV4 = '_zod' in z.string();
     let hasOpenAIAgents = true;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let tool;
     try {
-        require.resolve('@openai/agents');
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        ({ tool } = require('@openai/agents'));
     }
     catch (_a) {
         hasOpenAIAgents = false;
@@ -61,8 +64,6 @@ const OpenAIToolFunc = (runnable) => {
     if (!runnable.definition.inputValidator) {
         throw new Error('inputValidator must be defined');
     }
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { tool } = require('@openai/agents');
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const inputValidatorV4 = runnable.definition.inputValidator;
     const { description } = runnable.definition;

package/v1/client/admin.js

@@ -114,6 +114,7 @@ class AdminClient {
      */
     runWorkflows(workflowRuns_1) {
         return __awaiter(this, arguments, void 0, function* (workflowRuns, batchSize = 500) {
+            var _a;
             // Prepare workflows to be triggered in bulk
             const workflowRequests = workflowRuns.map(({ workflowName, input, options }) => {
                 const computedName = (0, apply_namespace_1.applyNamespace)(workflowName, this.config.namespace).toLowerCase();
@@ -126,8 +127,7 @@ class AdminClient {
                         ? convertDesiredWorkerLabels(desiredWorkerLabels)
                         : {} });
             });
-            const limit = 4 * 1024 * 1024; // FIXME configurable GRPC limit
-            const batches = (0, batch_1.batch)(workflowRequests, batchSize, limit);
+            const batches = (0, batch_1.batch)(workflowRequests, batchSize, (_a = this.config.grpc_max_send_message_length) !== null && _a !== void 0 ? _a : 4 * 1024 * 1024);
             this.logger.debug(`batching ${batches.length} batches`);
             try {
                 const results = [];

package/v1/examples/affinity/affinity-workers.js

@@ -24,8 +24,8 @@ workflow.task({
             const result = yield childWorkflow.run({});
             results.push(result);
         }
-        console.log('Spawned 50 child workflows');
-        console.log('Results:', yield Promise.all(results));
+        ctx.logger.info('Spawned 50 child workflows');
+        ctx.logger.info('Results', { results });
         return { step1: 'step1 results!' };
     }),
 });

package/v1/examples/agent/agent-claude.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -16,25 +49,22 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
     function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-// eslint-disable-next-line
 const workflow_1 = require("./workflow");
-const claude_agent_sdk_1 = require("@anthropic-ai/claude-agent-sdk");
-const claude_agent_sdk_2 = require("@anthropic-ai/claude-agent-sdk");
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
-        // Generate a tool from a standalone task
-        // const temperatureTool = getTemperature.mcpTool('claude');
         var _a, e_1, _b, _c;
-        // Or from a workflow
-        const temperatureTool = workflow_1.getTemperatureWorkflow.mcpTool('claude');
+        const temperatureTool = (0, workflow_1.createTemperatureWorkflowToolClaude)();
+        // The Claude Agent SDK is ESM-only, so avoid loading it at module import time.
+        // Run this example with an ESM-compatible TypeScript runner.
+        const { query, createSdkMcpServer } = yield Promise.resolve().then(() => __importStar(require('@anthropic-ai/claude-agent-sdk')));
         // Wrap the tool in an in-process MCP server
-        const weatherServer = (0, claude_agent_sdk_2.createSdkMcpServer)({
+        const weatherServer = createSdkMcpServer({
             name: 'weather',
             version: '1.0.0',
             tools: [temperatureTool],
         });
         try {
-            for (var _d = true, _e = __asyncValues((0, claude_agent_sdk_1.query)({
+            for (var _d = true, _e = __asyncValues(query({
                 prompt: "What's the temperature in San Francisco?",
                 options: {
                     mcpServers: { weather: weatherServer },

package/v1/examples/agent/agent-openai.js

@@ -42,16 +42,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-// eslint-disable-next-line
 const workflow_1 = require("./workflow");
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
-        // Generate a tool from a standalone task
-        // const temperatureTool = getTemperature.mcpTool('openai');
-        // Or from a workflow.
         // mcpTool validates Zod v4 is installed before loading @openai/agents, so call it first
         // to get a clear error message if the wrong Zod version is present.
-        const temperatureTool = workflow_1.getTemperatureWorkflow.mcpTool('openai');
+        const temperatureTool = (0, workflow_1.createTemperatureWorkflowToolOpenai)();
         // Dynamic import — @openai/agents crashes at load time with Zod v3, so we delay
         // the import until after mcpTool has already verified Zod v4 is available.
         const { Agent, run } = yield Promise.resolve().then(() => __importStar(require('@openai/agents')));

package/v1/examples/agent/workflow.d.ts

@@ -7,20 +7,24 @@ declare const TemperatureInput: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type TemperatureInputWithZod = z.infer<typeof TemperatureInput>;
-export declare const getTemperature: import("../..").TaskWorkflowDeclaration<{
+export declare const getTemperatureWorkflow: import("../..").WorkflowDeclaration<{
     locationName: string;
     coords: {
         latitude: number;
         longitude: number;
     };
-}, {
-    text: string;
-}, {}, {}, {}, {}>;
-export declare const getTemperatureWorkflow: import("../..").WorkflowDeclaration<{
+}, {}, {}>;
+export declare const getTemperature: import("../..").TaskWorkflowDeclaration<{
     locationName: string;
     coords: {
         latitude: number;
         longitude: number;
     };
-}, {}, {}>;
+}, {
+    text: string;
+}, {}, {}, {}, {}>;
+export declare function createTemperatureWorkflowToolClaude(): import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition;
+export declare function createTemperatureWorkflowToolOpenai(): import("@openai/agents").FunctionTool;
+export declare function createTemperatureTaskToolClaude(): import("@anthropic-ai/claude-agent-sdk").SdkMcpToolDefinition;
+export declare function createTemperatureTaskToolOpenai(): import("@openai/agents").FunctionTool;
 export {};

package/v1/examples/agent/workflow.js

@@ -9,11 +9,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTemperatureWorkflow = exports.getTemperature = void 0;
-// > Declaring a Task
+exports.getTemperature = exports.getTemperatureWorkflow = void 0;
+exports.createTemperatureWorkflowToolClaude = createTemperatureWorkflowToolClaude;
+exports.createTemperatureWorkflowToolOpenai = createTemperatureWorkflowToolOpenai;
+exports.createTemperatureTaskToolClaude = createTemperatureTaskToolClaude;
+exports.createTemperatureTaskToolOpenai = createTemperatureTaskToolOpenai;
 const hatchet_client_1 = require("../hatchet-client");
 const v4_1 = require("zod/v4");
-// Note that for agent tools, Zod must be used to create the input and output types for workflows/tasks
+// > Models
+// Agent tools require a Zod v4 inputValidator so the SDK can generate the tool input schema.
 const TemperatureCoordinates = v4_1.z.object({
     latitude: v4_1.z.number(),
     longitude: v4_1.z.number(),
@@ -22,20 +26,15 @@ const TemperatureInput = v4_1.z.object({
     locationName: v4_1.z.string(),
     coords: TemperatureCoordinates,
 });
+// !!
 const temperatureRequest = (input) => __awaiter(void 0, void 0, void 0, function* () {
     const response = yield fetch(`https://api.open-meteo.com/v1/forecast?latitude=${input.coords.latitude}&longitude=${input.coords.longitude}&current=temperature_2m&temperature_unit=fahrenheit`);
     const data = yield response.json();
     return {
-        text: `Temperature: ${data.current.temperature_2m}°F`,
+        text: `Temperature in ${input.locationName}: ${data.current.temperature_2m}°F`,
     };
 });
-exports.getTemperature = hatchet_client_1.hatchet.task({
-    name: 'getTemperature',
-    retries: 3,
-    fn: temperatureRequest,
-    inputValidator: TemperatureInput,
-    description: 'Get the current temperature at a location',
-});
+// > Workflow definition
 exports.getTemperatureWorkflow = hatchet_client_1.hatchet.workflow({
     name: 'getTemperatureWorkflow',
     inputValidator: TemperatureInput,
@@ -46,3 +45,26 @@ exports.getTemperatureWorkflow.task({
     fn: temperatureRequest,
 });
 // !!
+// > Standalone task
+exports.getTemperature = hatchet_client_1.hatchet.task({
+    name: 'getTemperature',
+    retries: 3,
+    fn: temperatureRequest,
+    inputValidator: TemperatureInput,
+    description: 'Get the current temperature at a location',
+});
+// !!
+// > Create MCP tools
+function createTemperatureWorkflowToolClaude() {
+    return exports.getTemperatureWorkflow.mcpTool('claude');
+}
+function createTemperatureWorkflowToolOpenai() {
+    return exports.getTemperatureWorkflow.mcpTool('openai');
+}
+function createTemperatureTaskToolClaude() {
+    return exports.getTemperature.mcpTool('claude');
+}
+function createTemperatureTaskToolOpenai() {
+    return exports.getTemperature.mcpTool('openai');
+}
+// !!

package/v1/examples/bulk_operations/workflow.js

@@ -15,7 +15,7 @@ exports.bulkReplayTest1 = hatchet_client_1.hatchet.task({
     name: 'bulk-replay-test-1',
     retries: 1,
     fn: (_input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('retrying bulk replay test task', ctx.retryCount());
+        ctx.logger.info('retrying bulk replay test task', { retryCount: ctx.retryCount() });
         if (ctx.retryCount() === 0) {
             throw new Error('This is a test error to trigger a retry.');
         }
@@ -25,7 +25,7 @@ exports.bulkReplayTest2 = hatchet_client_1.hatchet.task({
     name: 'bulk-replay-test-2',
     retries: 1,
     fn: (_input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('retrying bulk replay test task', ctx.retryCount());
+        ctx.logger.info('retrying bulk replay test task', { retryCount: ctx.retryCount() });
         if (ctx.retryCount() === 0) {
             throw new Error('This is a test error to trigger a retry.');
         }
@@ -35,7 +35,7 @@ exports.bulkReplayTest3 = hatchet_client_1.hatchet.task({
     name: 'bulk-replay-test-3',
     retries: 1,
     fn: (_input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('retrying bulk replay test task', ctx.retryCount());
+        ctx.logger.info('retrying bulk replay test task', { retryCount: ctx.retryCount() });
         if (ctx.retryCount() === 0) {
             throw new Error('This is a test error to trigger a retry.');
         }

package/v1/examples/cancellation/cancellation-workflow.js

@@ -47,17 +47,17 @@ exports.cancellationWorkflow.task({
 // > Abort Signal
 exports.abortSignal = hatchet_client_1.hatchet.task({
     name: 'abort-signal',
-    fn: (_1, _a) => __awaiter(void 0, [_1, _a], void 0, function* (_, { abortController }) {
+    fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         try {
             const response = yield axios_1.default.get('https://api.example.com/data', {
-                signal: abortController.signal,
+                signal: ctx.abortController.signal,
             });
             // Handle the response
         }
         catch (error) {
             if (axios_1.default.isCancel(error)) {
                 // Request was canceled
-                console.log('Request canceled');
+                ctx.logger.info('Request canceled');
             }
             else {
                 // Handle other errors

package/v1/examples/cancellations/workflow.js

@@ -33,17 +33,17 @@ exports.cancellation = hatchet_client_1.hatchet.task({
 // > Abort Signal
 exports.abortSignal = hatchet_client_1.hatchet.task({
     name: 'abort-signal',
-    fn: (_1, _a) => __awaiter(void 0, [_1, _a], void 0, function* (_, { abortController }) {
+    fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         try {
             const response = yield axios_1.default.get('https://api.example.com/data', {
-                signal: abortController.signal,
+                signal: ctx.abortController.signal,
             });
             // Handle the response
         }
         catch (error) {
             if (axios_1.default.isCancel(error)) {
                 // Request was canceled
-                console.log('Request canceled');
+                ctx.logger.info('Request canceled');
             }
             else {
                 // Handle other errors

package/v1/examples/conditions/workflow.js

@@ -33,7 +33,7 @@ exports.dagWithConditions.task({
     parents: [firstTask],
     waitFor: (0, conditions_1.Or)({ eventKey: 'user:event' }, { sleepFor: '10s' }),
     fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('triggered by condition', ctx.triggers());
+        ctx.logger.info('triggered by condition', { triggers: ctx.triggers() });
         return {
             Completed: true,
         };

package/v1/examples/dag_match_condition/workflow.js

@@ -33,7 +33,7 @@ exports.dagWithConditions.task({
     parents: [firstTask],
     waitFor: (0, conditions_1.Or)({ eventKey: 'user:event' }, { sleepFor: '10s' }),
     fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('triggered by condition', ctx.triggers());
+        ctx.logger.info('triggered by condition', { triggers: ctx.triggers() });
         return {
             Completed: true,
         };

package/v1/examples/durable/workflow.js

@@ -29,20 +29,20 @@ exports.durableWorkflow = hatchet_client_1.hatchet.workflow({
 // !!
 exports.durableWorkflow.task({
     name: 'ephemeral_task',
-    fn: () => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('Running non-durable task');
+    fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
+        ctx.logger.info('Running non-durable task');
     }),
 });
 exports.durableWorkflow.durableTask({
     name: 'durable_task',
     executionTimeout: '10m',
     fn: (_input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('Waiting for sleep');
+        ctx.logger.info('Waiting for sleep');
         const sleepResult = yield ctx.sleepFor(exports.SLEEP_TIME, { label: 'waiting for sleep' });
-        console.log('Sleep finished');
-        console.log('Waiting for event');
+        ctx.logger.info('Sleep finished');
+        ctx.logger.info('Waiting for event');
         const event = yield ctx.waitForEvent(exports.EVENT_KEY, 'true');
-        console.log('Event received');
+        ctx.logger.info('Event received');
         return {
             status: 'success',
             event: event,

package/v1/examples/durable-event/workflow.js

@@ -18,7 +18,7 @@ exports.durableEvent = hatchet_client_1.hatchet.durableTask({
     executionTimeout: '10m',
     fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         const res = yield ctx.waitForEvent('user:update');
-        console.log('res', res);
+        ctx.logger.info('res', { res });
         return {
             Value: 'done',
         };
@@ -32,7 +32,7 @@ exports.durableEventWithFilter = hatchet_client_1.hatchet.durableTask({
         // > Durable Event With Filter
         const res = yield ctx.waitForEvent('user:update', "input.userId == '1234'");
         // !!
-        console.log('res', res);
+        ctx.logger.info('res', { res });
         return {
             Value: 'done',
         };

package/v1/examples/durable-sleep/workflow.js

@@ -20,9 +20,9 @@ exports.durableSleep.durableTask({
     name: 'durable-sleep',
     executionTimeout: '10m',
     fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('sleeping for 5s');
+        ctx.logger.info('sleeping for 5s');
         const sleepRes = yield ctx.sleepFor('5s');
-        console.log('done sleeping for 5s', sleepRes);
+        ctx.logger.info('done sleeping for 5s', { sleepRes });
         return {
             Value: 'done',
         };

package/v1/examples/durable_event/workflow.js

@@ -19,7 +19,7 @@ exports.durableEvent = hatchet_client_1.hatchet.durableTask({
     executionTimeout: '10m',
     fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         const res = yield ctx.waitForEvent(exports.EVENT_KEY);
-        console.log('res', res);
+        ctx.logger.info('res', { res });
         return {
             Value: 'done',
         };
@@ -33,7 +33,7 @@ exports.durableEventWithFilter = hatchet_client_1.hatchet.durableTask({
         // > Durable Event With Filter
         const res = yield ctx.waitForEvent(exports.EVENT_KEY, "input.userId == '1234'");
         // !!
-        console.log('res', res);
+        ctx.logger.info('res', { res });
         return {
             Value: 'done',
         };
@@ -46,7 +46,7 @@ exports.durableEventWithLookback = hatchet_client_1.hatchet.durableTask({
     executionTimeout: '10m',
     fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         const res = yield ctx.waitForEvent(exports.EVENT_KEY, undefined, undefined, exports.SCOPE, '1m');
-        console.log('res', res);
+        ctx.logger.info('res', { res });
         return {
             Value: 'done',
         };

package/v1/examples/durable_sleep/workflow.js

@@ -20,9 +20,9 @@ exports.durableSleep.durableTask({
     name: 'durable-sleep',
     executionTimeout: '10m',
     fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('sleeping for 5s');
+        ctx.logger.info('sleeping for 5s');
         const sleepRes = yield ctx.sleepFor('5s');
-        console.log('done sleeping for 5s', sleepRes);
+        ctx.logger.info('done sleeping for 5s', { sleepRes });
         return {
             Value: 'done',
         };

package/v1/examples/events/workflow.js

@@ -54,7 +54,7 @@ exports.upper.task({
 exports.lowerWithFilter.task({
     name: 'lowerWithFilter',
     fn: (input, ctx) => {
-        console.log(ctx.filterPayload());
+        ctx.logger.info('filterPayload', { filterPayload: ctx.filterPayload() });
     },
 });
 // !!

package/v1/examples/middleware/client.js

@@ -5,7 +5,7 @@ exports.hatchetWithMiddlewareChaining = exports.hatchetWithMiddleware = void 0;
 const v1_1 = require("../..");
 const myMiddleware = {
     before: (input, ctx) => {
-        console.log('before', input.first);
+        ctx.logger.info('before', { first: input.first });
         return Object.assign(Object.assign({}, input), { dependency: 'abc-123' });
     },
     after: (output, ctx, input) => {
@@ -17,7 +17,7 @@ exports.hatchetWithMiddleware = v1_1.HatchetClient.init().withMiddleware(myMiddl
 // > Chaining middleware
 const firstMiddleware = {
     before: (input, ctx) => {
-        console.log('before', input.first);
+        ctx.logger.info('before', { first: input.first });
         return Object.assign(Object.assign({}, input), { dependency: 'abc-123' });
     },
     after: (output, ctx, input) => {
@@ -26,7 +26,7 @@ const firstMiddleware = {
 };
 const secondMiddleware = {
     before: (input, ctx) => {
-        console.log('before', input.dependency); // available from previous middleware
+        ctx.logger.info('before', { dependency: input.dependency }); // available from previous middleware
         return Object.assign(Object.assign({}, input), { anotherDep: true });
     },
     after: (output, ctx, input) => {

package/v1/examples/middleware/workflow.js

@@ -4,11 +4,11 @@ exports.taskWithMiddleware = void 0;
 const client_1 = require("./client");
 exports.taskWithMiddleware = client_1.hatchetWithMiddleware.task({
     name: 'task-with-middleware',
-    fn: (input, _ctx) => {
-        console.log('task', input.message); // string  (from TaskInput)
-        console.log('task', input.first); // number  (from GlobalInputType)
-        console.log('task', input.second); // number  (from GlobalInputType)
-        console.log('task', input.dependency); // string  (from Pre Middleware)
+    fn: (input, ctx) => {
+        ctx.logger.info('task', { message: input.message }); // string  (from TaskInput)
+        ctx.logger.info('task', { first: input.first }); // number  (from GlobalInputType)
+        ctx.logger.info('task', { second: input.second }); // number  (from GlobalInputType)
+        ctx.logger.info('task', { dependency: input.dependency }); // string  (from Pre Middleware)
         return {
             message: input.message,
             extra: 1,

package/v1/examples/on_event/workflow.js

@@ -54,7 +54,7 @@ exports.upper.task({
 exports.lowerWithFilter.task({
     name: 'lowerWithFilter',
     fn: (input, ctx) => {
-        console.log(ctx.filterPayload());
+        ctx.logger.info('filterPayload', { filterPayload: ctx.filterPayload() });
     },
 });
 // !!

package/v1/examples/on_failure/workflow.js

@@ -28,8 +28,8 @@ exports.failureWorkflow.task({
 exports.failureWorkflow.onFailure({
     name: 'on_failure',
     fn: (_input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('onFailure for run:', ctx.workflowRunId());
-        console.log('upstream errors:', ctx.errors());
+        ctx.logger.info(`onFailure for run: ${ctx.workflowRunId()}`);
+        ctx.logger.info('upstream errors', { errors: ctx.errors() });
         return {
             status: 'success',
         };

package/v1/examples/on_success/workflow.js

@@ -34,7 +34,7 @@ exports.onSuccessDag.task({
 // 👀 onSuccess handler will run if all tasks in the workflow succeed
 exports.onSuccessDag.onSuccess({
     fn: (_, ctx) => {
-        console.log('onSuccess for run:', ctx.workflowRunId());
+        ctx.logger.info(`onSuccess for run: ${ctx.workflowRunId()}`);
         return {
             'on-success': 'success',
         };

package/v1/examples/rate_limit/workflow.js

@@ -19,16 +19,16 @@ const task1 = hatchet_client_1.hatchet.task({
             units: 1,
         },
     ],
-    fn: (input) => {
-        console.log('executed task1');
+    fn: (_input, ctx) => {
+        ctx.logger.info('executed task1');
     },
 });
 // !!
 // > Dynamic
 const task2 = hatchet_client_1.hatchet.task({
     name: 'task2',
-    fn: (input) => {
-        console.log('executed task2 for user: ', input.userId);
+    fn: (input, ctx) => {
+        ctx.logger.info(`executed task2 for user: ${input.userId}`);
     },
     rateLimits: [
         {

package/v1/examples/retries/workflow.js

@@ -27,7 +27,7 @@ exports.retriesWithCount = hatchet_client_1.hatchet.task({
     fn: (_, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         // > Get the current retry count
         const retryCount = ctx.retryCount();
-        console.log(`Retry count: ${retryCount}`);
+        ctx.logger.info(`Retry count: ${retryCount}`);
         if (retryCount < 2) {
             throw new Error('intentional failure');
         }

package/v1/examples/webhooks/workflow.js

@@ -26,9 +26,9 @@ exports.handleStripePayment = hatchet_client_1.hatchet.task({
     on: {
         event: 'stripe:payment_intent.succeeded',
     },
-    fn: (input) => __awaiter(void 0, void 0, void 0, function* () {
+    fn: (input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         const { customer, amount } = input.data.object;
-        console.log(`Payment of ${amount} from ${customer}`);
+        ctx.logger.info(`Payment of ${amount} from ${customer}`);
         return { customer, amount };
     }),
 });
@@ -37,11 +37,11 @@ exports.handleGitHubPR = hatchet_client_1.hatchet.task({
     on: {
         event: 'github:pull_request:opened',
     },
-    fn: (input) => __awaiter(void 0, void 0, void 0, function* () {
+    fn: (input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         const repo = input.repository.full_name;
         const prNumber = input.pull_request.number;
         const { title } = input.pull_request;
-        console.log(`PR #${prNumber} opened on ${repo}: ${title}`);
+        ctx.logger.info(`PR #${prNumber} opened on ${repo}: ${title}`);
         return { repo, pr: prNumber };
     }),
 });
@@ -50,9 +50,9 @@ exports.handleSlackMention = hatchet_client_1.hatchet.task({
     on: {
         event: 'slack:event:app_mention',
     },
-    fn: (input) => __awaiter(void 0, void 0, void 0, function* () {
+    fn: (input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         const { user, text, channel } = input.event;
-        console.log(`Mentioned by ${user} in ${channel}: ${text}`);
+        ctx.logger.info(`Mentioned by ${user} in ${channel}: ${text}`);
         return { handled: true };
     }),
 });
@@ -61,8 +61,8 @@ exports.handleSlackCommand = hatchet_client_1.hatchet.task({
     on: {
         event: 'slack:command:/deploy',
     },
-    fn: (input) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log(`${input.user_name} ran ${input.command} ${input.text}`);
+    fn: (input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
+        ctx.logger.info(`${input.user_name} ran ${input.command} ${input.text}`);
         return { command: input.command, args: input.text };
     }),
 });
@@ -71,9 +71,9 @@ exports.handleSlackInteraction = hatchet_client_1.hatchet.task({
     on: {
         event: 'slack:interaction:block_actions',
     },
-    fn: (input) => __awaiter(void 0, void 0, void 0, function* () {
+    fn: (input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         const [action] = input.actions;
-        console.log(`${input.user.username} clicked button: ${action.action_id}`);
+        ctx.logger.info(`${input.user.username} clicked button: ${action.action_id}`);
         return { action: action.action_id };
     }),
 });

package/v1/examples/welcome_email/workflow.js

@@ -25,7 +25,7 @@ exports.welcomeEmail = hatchet_client_1.hatchet.durableTask({
     fn: (input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
         var _a, _b;
         // Step 1: Send the welcome email
-        console.log(`Sending welcome email to ${input.email}: finish your first onboarding step`);
+        ctx.logger.info(`Sending welcome email to ${input.email}: finish your first onboarding step`);
         // Step 2: Wait for the user to complete onboarding, or time out
         // (use a longer duration for a more realistic workflow)
         const now = yield ctx.now();
@@ -41,11 +41,11 @@ exports.welcomeEmail = hatchet_client_1.hatchet.durableTask({
         const onboardingCompleted = resolvedKey === exports.ONBOARDING_EVENT_KEY;
         if (onboardingCompleted) {
             // Step 3a: User completed onboarding -> skip follow-up
-            console.log(`User ${input.user_id} completed onboarding, skipping follow-up`);
+            ctx.logger.info(`User ${input.user_id} completed onboarding, skipping follow-up`);
             return { userId: input.user_id, welcomeSent: true, followUpSent: false };
         }
         // Step 3b: Timeout -> send follow-up email
-        console.log(`Sending follow-up email to ${input.email}: need help finishing onboarding?`);
+        ctx.logger.info(`Sending follow-up email to ${input.email}: need help finishing onboarding?`);
         return { userId: input.user_id, welcomeSent: true, followUpSent: true };
     }),
 });

package/version.d.ts

@@ -1 +1 @@
-export declare const HATCHET_VERSION = "1.22.2";
+export declare const HATCHET_VERSION = "1.23.0";

package/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HATCHET_VERSION = void 0;
-exports.HATCHET_VERSION = '1.22.2';
+exports.HATCHET_VERSION = '1.23.0';

package/workflow.js

@@ -18,8 +18,6 @@ exports.StickyStrategy = exports.ConcurrencyLimitStrategy = void 0;
 const v1_1 = require("./v1");
 Object.defineProperty(exports, "ConcurrencyLimitStrategy", { enumerable: true, get: function () { return v1_1.ConcurrencyLimitStrategy; } });
 Object.defineProperty(exports, "StickyStrategy", { enumerable: true, get: function () { return v1_1.StickyStrategy; } });
+const v0_deprecation_warning_1 = require("./util/v0-deprecation-warning");
 __exportStar(require("./legacy/workflow"), exports);
-console.warn('\x1b[31mDeprecation warning: The v0 sdk, including the workflow module has been deprecated and has been removed in release v1.14.0.\x1b[0m');
-console.warn('\x1b[31mPlease migrate to v1 SDK instead: https://docs.hatchet.run/home/v1-sdk-improvements\x1b[0m');
-console.warn('ConcurrencyLimitStrategy, StickyStrategy have been moved to @hatchet-dev/typescript-sdk/v1');
-console.warn('--------------------------------');
+(0, v0_deprecation_warning_1.emitV0RemovedWarning)('workflow', 'ConcurrencyLimitStrategy and StickyStrategy have been moved to @hatchet-dev/typescript-sdk/v1.');