@hatchet-dev/typescript-sdk 1.22.3 → 1.23.1

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

@@ -16,6 +16,7 @@ declare const ClientTLSConfigSchema: z.ZodObject<{
 export declare const OpenTelemetryConfigSchema: z.ZodObject<{
     excludedAttributes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     includeTaskNameInSpanName: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    individualRunSpansForBulkRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type OpenTelemetryConfig = z.infer<typeof OpenTelemetryConfigSchema>;
 export declare const ClientConfigSchema: z.ZodObject<{
@@ -49,6 +50,7 @@ export declare const ClientConfigSchema: z.ZodObject<{
     otel: z.ZodOptional<z.ZodObject<{
         excludedAttributes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
         includeTaskNameInSpanName: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        individualRunSpansForBulkRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>>;
     middleware: z.ZodOptional<z.ZodObject<{
         before: z.ZodOptional<z.ZodAny>;
@@ -56,6 +58,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 +102,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

@@ -24,6 +24,14 @@ exports.OpenTelemetryConfigSchema = v4_1.z.object({
      * e.g., "hatchet.start_step_run.my_task" instead of "hatchet.start_step_run"
      */
     includeTaskNameInSpanName: v4_1.z.boolean().optional().default(false),
+    /**
+     * If true, a child `hatchet.run_workflow` span is created for each item in a
+     * bulk run (`runWorkflows`), nested under the parent `hatchet.run_workflows`
+     * span, and each item's traceparent points at its own span. Defaults to false
+     * to preserve the existing span structure for downstream OpenTelemetry
+     * collectors.
+     */
+    individualRunSpansForBulkRun: v4_1.z.boolean().optional().default(false),
 });
 const TaskMiddlewareSchema = v4_1.z
     .object({
@@ -45,4 +53,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/opentelemetry/instrumentor.js

@@ -35,7 +35,7 @@ catch (_a) {
 const otelApi = require('@opentelemetry/api');
 const otelInstrumentation = require('@opentelemetry/instrumentation');
 /* eslint-enable @typescript-eslint/no-require-imports */
-const { context, propagation, SpanKind, SpanStatusCode, diag } = otelApi;
+const { context, propagation, SpanKind, SpanStatusCode, diag, trace } = otelApi;
 const { InstrumentationBase, InstrumentationNodeModuleDefinition, InstrumentationNodeModuleFile, isWrapped, } = otelInstrumentation;
 const INSTRUMENTOR_NAME = '@hatchet-dev/typescript-sdk';
 // FIXME: refactor version check to use the new pattern introduced in #2954
@@ -354,23 +354,84 @@ class HatchetInstrumentor extends InstrumentationBase {
                     return tracer.startActiveSpan('hatchet.run_workflows', {
                         kind: SpanKind.PRODUCER,
                         attributes,
-                    }, (span) => {
-                        const enhancedWorkflowRuns = workflowRuns.map((run) => {
-                            var _a, _b;
-                            const enhancedMetadata = Object.assign({}, ((_b = (_a = run.options) === null || _a === void 0 ? void 0 : _a.additionalMetadata) !== null && _b !== void 0 ? _b : {}));
-                            injectContext(enhancedMetadata);
-                            return Object.assign(Object.assign({}, run), { options: Object.assign(Object.assign({}, run.options), { additionalMetadata: enhancedMetadata }) });
-                        });
-                        return original
-                            .call(this, enhancedWorkflowRuns, batchSize)
-                            .catch((error) => {
-                            span.recordException(error);
-                            span.setStatus({ code: SpanStatusCode.ERROR, message: error === null || error === void 0 ? void 0 : error.message });
+                    }, (batchSpan) => {
+                        const individualSpans = getConfig().individualRunSpansForBulkRun;
+                        const itemSpans = [];
+                        let enhancedWorkflowRuns;
+                        try {
+                            enhancedWorkflowRuns = workflowRuns.map((run) => {
+                                var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+                                const enhancedMetadata = Object.assign({}, ((_b = (_a = run.options) === null || _a === void 0 ? void 0 : _a.additionalMetadata) !== null && _b !== void 0 ? _b : {}));
+                                if (individualSpans) {
+                                    const itemAttributes = filterAttributes({
+                                        [opentelemetry_1.OTelAttribute.WORKFLOW_NAME]: run.workflowName,
+                                        [opentelemetry_1.OTelAttribute.ACTION_PAYLOAD]: JSON.stringify(run.input),
+                                        [opentelemetry_1.OTelAttribute.PARENT_ID]: (_c = run.options) === null || _c === void 0 ? void 0 : _c.parentId,
+                                        [opentelemetry_1.OTelAttribute.PARENT_STEP_RUN_ID]: (_d = run.options) === null || _d === void 0 ? void 0 : _d.parentStepRunId,
+                                        [opentelemetry_1.OTelAttribute.CHILD_INDEX]: (_e = run.options) === null || _e === void 0 ? void 0 : _e.childIndex,
+                                        [opentelemetry_1.OTelAttribute.CHILD_KEY]: (_f = run.options) === null || _f === void 0 ? void 0 : _f.childKey,
+                                        [opentelemetry_1.OTelAttribute.ADDITIONAL_METADATA]: ((_g = run.options) === null || _g === void 0 ? void 0 : _g.additionalMetadata)
+                                            ? JSON.stringify(run.options.additionalMetadata)
+                                            : undefined,
+                                        [opentelemetry_1.OTelAttribute.PRIORITY]: (_h = run.options) === null || _h === void 0 ? void 0 : _h.priority,
+                                        [opentelemetry_1.OTelAttribute.DESIRED_WORKER_ID]: (_j = run.options) === null || _j === void 0 ? void 0 : _j.desiredWorkerId,
+                                    }, getConfig().excludedAttributes);
+                                    const itemSpan = tracer.startSpan('hatchet.run_workflow', {
+                                        kind: SpanKind.PRODUCER,
+                                        attributes: itemAttributes,
+                                    });
+                                    itemSpans.push(itemSpan);
+                                    propagation.inject(trace.setSpan(context.active(), itemSpan), enhancedMetadata);
+                                }
+                                else {
+                                    // Legacy behaviour: inject the active (batch) span context so the
+                                    // span structure seen by downstream collectors is unchanged.
+                                    injectContext(enhancedMetadata);
+                                }
+                                return Object.assign(Object.assign({}, run), { options: Object.assign(Object.assign({}, run.options), { additionalMetadata: enhancedMetadata }) });
+                            });
+                        }
+                        catch (error) {
+                            const err = error;
+                            batchSpan.recordException(err);
+                            batchSpan.setStatus({ code: SpanStatusCode.ERROR, message: err === null || err === void 0 ? void 0 : err.message });
+                            itemSpans.forEach((s) => {
+                                s.recordException(err);
+                                s.setStatus({ code: SpanStatusCode.ERROR, message: err === null || err === void 0 ? void 0 : err.message });
+                                s.end();
+                            });
+                            batchSpan.end();
                             throw error;
-                        })
-                            .finally(() => {
-                            span.end();
-                        });
+                        }
+                        try {
+                            return original
+                                .call(this, enhancedWorkflowRuns, batchSize)
+                                .catch((error) => {
+                                batchSpan.recordException(error);
+                                batchSpan.setStatus({ code: SpanStatusCode.ERROR, message: error === null || error === void 0 ? void 0 : error.message });
+                                itemSpans.forEach((s) => {
+                                    s.recordException(error);
+                                    s.setStatus({ code: SpanStatusCode.ERROR, message: error === null || error === void 0 ? void 0 : error.message });
+                                });
+                                throw error;
+                            })
+                                .finally(() => {
+                                itemSpans.forEach((s) => s.end());
+                                batchSpan.end();
+                            });
+                        }
+                        catch (error) {
+                            const err = error;
+                            batchSpan.recordException(err);
+                            batchSpan.setStatus({ code: SpanStatusCode.ERROR, message: err === null || err === void 0 ? void 0 : err.message });
+                            itemSpans.forEach((s) => {
+                                s.recordException(err);
+                                s.setStatus({ code: SpanStatusCode.ERROR, message: err === null || err === void 0 ? void 0 : err.message });
+                                s.end();
+                            });
+                            batchSpan.end();
+                            throw error;
+                        }
                     });
                 });
             };

package/opentelemetry/types.d.ts

@@ -2,5 +2,6 @@ export type { OpenTelemetryConfig } from '../clients/hatchet-client/client-confi
 export declare const DEFAULT_CONFIG: {
     excludedAttributes: string[];
     includeTaskNameInSpanName: boolean;
+    individualRunSpansForBulkRun: boolean;
     enableHatchetCollector: boolean;
 };

package/opentelemetry/types.js

@@ -4,5 +4,6 @@ exports.DEFAULT_CONFIG = void 0;
 exports.DEFAULT_CONFIG = {
     excludedAttributes: [],
     includeTaskNameInSpanName: false,
+    individualRunSpansForBulkRun: false,
     enableHatchetCollector: true,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatchet-dev/typescript-sdk",
-  "version": "1.22.3",
+  "version": "1.23.1",
   "description": "Background task orchestration & visibility for developers",
   "types": "dist/index.d.ts",
   "files": [
@@ -19,6 +19,7 @@
   "author": "",
   "license": "MIT",
   "devDependencies": {
+    "@aws-sdk/client-s3": "^3.1042.0",
     "@eslint/js": "^10.0.1",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.13.14",
@@ -40,6 +41,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.6",
+    "@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 +73,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.6",
     "@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');
@@ -86,19 +86,35 @@ class ConfigLoader {
         const otelConfig = (_5 = (_4 = override === null || override === void 0 ? void 0 : override.otel) !== null && _4 !== void 0 ? _4 : yaml === null || yaml === void 0 ? void 0 : yaml.otel) !== null && _5 !== void 0 ? _5 : {
             excludedAttributes: this.parseJsonArray(this.env('HATCHET_CLIENT_OPENTELEMETRY_EXCLUDED_ATTRIBUTES') || '[]'),
             includeTaskNameInSpanName: this.env('HATCHET_CLIENT_OPENTELEMETRY_INCLUDE_TASK_NAME_IN_SPAN_NAME') === 'true',
+            individualRunSpansForBulkRun: this.env('HATCHET_CLIENT_OPENTELEMETRY_INDIVIDUAL_RUN_SPANS_FOR_BULK_RUN') === '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/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/client/features/workflows.js

@@ -79,6 +79,7 @@ class WorkflowsClient {
      */
     get(workflow) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             // Get workflow name string
             const name = (0, exports.workflowNameString)(workflow);
             // Check cache first
@@ -94,8 +95,7 @@ class WorkflowsClient {
                     name,
                 });
                 if (data && data.rows && data.rows.length > 0) {
-                    const [wf] = data.rows;
-                    // Cache the result
+                    const wf = (_a = data.rows.find((row) => row.name === name)) !== null && _a !== void 0 ? _a : data.rows[0];
                     this.workflowCache.set(name, {
                         workflow: wf,
                         expiry: Date.now() + this.cacheTTL,

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 },