@hatchet-dev/typescript-sdk 1.21.1 → 1.22.0

package/protoc/dispatcher/dispatcher.js

@@ -1262,6 +1262,8 @@ function createBaseAssignedAction() {
         workflowId: undefined,
         workflowVersionId: undefined,
         durableTaskInvocationCount: undefined,
+        triggeringEventExternalId: undefined,
+        triggeringEventKey: undefined,
     };
 }
 exports.AssignedAction = {
@@ -1329,6 +1331,12 @@ exports.AssignedAction = {
         if (message.durableTaskInvocationCount !== undefined) {
             writer.uint32(168).int32(message.durableTaskInvocationCount);
         }
+        if (message.triggeringEventExternalId !== undefined) {
+            writer.uint32(178).string(message.triggeringEventExternalId);
+        }
+        if (message.triggeringEventKey !== undefined) {
+            writer.uint32(186).string(message.triggeringEventKey);
+        }
         return writer;
     },
     decode(input, length) {
@@ -1485,6 +1493,20 @@ exports.AssignedAction = {
                     message.durableTaskInvocationCount = reader.int32();
                     continue;
                 }
+                case 22: {
+                    if (tag !== 178) {
+                        break;
+                    }
+                    message.triggeringEventExternalId = reader.string();
+                    continue;
+                }
+                case 23: {
+                    if (tag !== 186) {
+                        break;
+                    }
+                    message.triggeringEventKey = reader.string();
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -1596,6 +1618,16 @@ exports.AssignedAction = {
                 : isSet(object.durable_task_invocation_count)
                     ? globalThis.Number(object.durable_task_invocation_count)
                     : undefined,
+            triggeringEventExternalId: isSet(object.triggeringEventExternalId)
+                ? globalThis.String(object.triggeringEventExternalId)
+                : isSet(object.triggering_event_external_id)
+                    ? globalThis.String(object.triggering_event_external_id)
+                    : undefined,
+            triggeringEventKey: isSet(object.triggeringEventKey)
+                ? globalThis.String(object.triggeringEventKey)
+                : isSet(object.triggering_event_key)
+                    ? globalThis.String(object.triggering_event_key)
+                    : undefined,
         };
     },
     toJSON(message) {
@@ -1663,13 +1695,19 @@ exports.AssignedAction = {
         if (message.durableTaskInvocationCount !== undefined) {
             obj.durableTaskInvocationCount = Math.round(message.durableTaskInvocationCount);
         }
+        if (message.triggeringEventExternalId !== undefined) {
+            obj.triggeringEventExternalId = message.triggeringEventExternalId;
+        }
+        if (message.triggeringEventKey !== undefined) {
+            obj.triggeringEventKey = message.triggeringEventKey;
+        }
         return obj;
     },
     create(base) {
         return exports.AssignedAction.fromPartial(base !== null && base !== void 0 ? base : {});
     },
     fromPartial(object) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
         const message = createBaseAssignedAction();
         message.tenantId = (_a = object.tenantId) !== null && _a !== void 0 ? _a : '';
         message.workflowRunId = (_b = object.workflowRunId) !== null && _b !== void 0 ? _b : '';
@@ -1692,6 +1730,8 @@ exports.AssignedAction = {
         message.workflowId = (_u = object.workflowId) !== null && _u !== void 0 ? _u : undefined;
         message.workflowVersionId = (_v = object.workflowVersionId) !== null && _v !== void 0 ? _v : undefined;
         message.durableTaskInvocationCount = (_w = object.durableTaskInvocationCount) !== null && _w !== void 0 ? _w : undefined;
+        message.triggeringEventExternalId = (_x = object.triggeringEventExternalId) !== null && _x !== void 0 ? _x : undefined;
+        message.triggeringEventKey = (_y = object.triggeringEventKey) !== null && _y !== void 0 ? _y : undefined;
         return message;
     },
 };

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

@@ -37,7 +37,7 @@ exports.ConfigLoader = void 0;
 const yaml_1 = require("yaml");
 const fs_1 = require("fs");
 const p = __importStar(require("path"));
-const zod_1 = require("zod");
+const v4_1 = require("zod/v4");
 const hatchet_client_1 = require("../../clients/hatchet-client");
 const nice_grpc_1 = require("nice-grpc");
 const token_1 = require("./token");
@@ -136,7 +136,7 @@ class ConfigLoader {
             if (!path) {
                 return undefined;
             }
-            if (e instanceof zod_1.z.ZodError) {
+            if (e instanceof v4_1.z.ZodError) {
                 throw new Error(`Invalid yaml config: ${e.message}`, { cause: e });
             }
             throw e;

package/util/uuid.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isValidUUID = isValidUUID;
-const zod_1 = require("zod");
+const v4_1 = require("zod/v4");
 function isValidUUID(uuid) {
-    return zod_1.z.string().uuid().safeParse(uuid).success;
+    return v4_1.z.uuid().safeParse(uuid).success;
 }

package/v1/agent/claude.d.ts

@@ -0,0 +1,17 @@
+import { BaseWorkflowDeclaration, InputType, OutputType } from './..';
+import type { SdkMcpToolDefinition } from '@anthropic-ai/claude-agent-sdk';
+import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+export type ClaudeToolFuncT = <I extends InputType, O extends OutputType>(runnable: BaseWorkflowDeclaration<I, O>, annotations?: ToolAnnotations) => SdkMcpToolDefinition;
+export declare const ClaudeToolFunc: <I extends InputType, O extends OutputType>(runnable: BaseWorkflowDeclaration<I, O>, annotations?: ToolAnnotations) => {
+    annotations: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    description: string;
+    handler: (args: any, _: unknown) => Promise<CallToolResult>;
+    name: string;
+    inputSchema: any;
+};

package/v1/agent/claude.js

@@ -0,0 +1,83 @@
+"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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeToolFunc = void 0;
+const z = __importStar(require("zod/v4"));
+const ClaudeToolFunc = (runnable, annotations) => {
+    const hasZodV4 = '_zod' in z.string();
+    let hasClaudeAgentSdk = true;
+    try {
+        require.resolve('@anthropic-ai/claude-agent-sdk');
+    }
+    catch (_a) {
+        hasClaudeAgentSdk = false;
+    }
+    if (!hasZodV4 || !hasClaudeAgentSdk) {
+        throw new Error("To use Hatchet's Claude agent SDK integration, you must install Zod v4 and @anthropic-ai/claude-agent-sdk: npm install zod@^4.0.0 @anthropic-ai/claude-agent-sdk @modelcontextprotocol/sdk");
+    }
+    if (!runnable.definition.inputValidator) {
+        throw new Error('inputValidator must be defined');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const inputValidatorV4 = runnable.definition.inputValidator;
+    const { description } = runnable.definition;
+    if (description === undefined) {
+        throw new Error('Runnable description must be defined');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const handler = (args, _) => __awaiter(void 0, void 0, void 0, function* () {
+        const result = yield runnable.run(args);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    });
+    return {
+        annotations: annotations,
+        description: description,
+        handler: handler,
+        name: runnable.name,
+        inputSchema: inputValidatorV4.shape,
+    };
+};
+exports.ClaudeToolFunc = ClaudeToolFunc;

package/v1/agent/openai.d.ts

@@ -0,0 +1,4 @@
+import { BaseWorkflowDeclaration, InputType, OutputType } from './..';
+import type { FunctionTool } from '@openai/agents';
+export type OpenAIToolFuncT = <I extends InputType, O extends OutputType>(runnable: BaseWorkflowDeclaration<I, O>) => FunctionTool;
+export declare const OpenAIToolFunc: <I extends InputType, O extends OutputType>(runnable: BaseWorkflowDeclaration<I, O>) => any;

package/v1/agent/openai.js

@@ -0,0 +1,83 @@
+"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) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIToolFunc = void 0;
+const z = __importStar(require("zod/v4"));
+const OpenAIToolFunc = (runnable) => {
+    // Check both requirements before loading @openai/agents — it crashes at load time with Zod v3.
+    // 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;
+    try {
+        require.resolve('@openai/agents');
+    }
+    catch (_a) {
+        hasOpenAIAgents = false;
+    }
+    if (!hasZodV4 || !hasOpenAIAgents) {
+        throw new Error("To use Hatchet's OpenAI agent SDK integration, you must install Zod v4 and @openai/agents: npm install zod@^4.0.0 @openai/agents");
+    }
+    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;
+    if (description === undefined) {
+        throw new Error('Runnable description must be defined');
+    }
+    return tool({
+        name: runnable.name,
+        description: description,
+        parameters: z.toJSONSchema(inputValidatorV4),
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        execute: (input) => __awaiter(void 0, void 0, void 0, function* () {
+            const result = yield runnable.run(input);
+            return JSON.stringify(result);
+        }),
+    });
+};
+exports.OpenAIToolFunc = OpenAIToolFunc;

package/v1/client/client.js

@@ -23,7 +23,7 @@ const hatchet_client_1 = require("../../clients/hatchet-client");
 const rest_1 = __importDefault(require("../../clients/rest"));
 const config_loader_1 = require("../../util/config-loader");
 const hatchet_logger_1 = require("../../clients/hatchet-client/hatchet-logger");
-const zod_1 = require("zod");
+const v4_1 = require("zod/v4");
 const event_client_1 = require("../../clients/event/event-client");
 const dispatcher_client_1 = require("../../clients/dispatcher/dispatcher-client");
 const child_listener_client_1 = require("../../clients/listeners/run-listener/child-listener-client");
@@ -89,7 +89,7 @@ class HatchetClient {
             this._axiosConfig = axiosConfig;
         }
         catch (e) {
-            if (e instanceof zod_1.z.ZodError) {
+            if (e instanceof v4_1.z.ZodError) {
                 throw new Error(`Invalid client config: ${e.message}`, { cause: e });
             }
             throw e;

package/v1/client/features/crons.d.ts

@@ -1,5 +1,5 @@
 import { CronWorkflows, CronWorkflowsList } from '../../../clients/rest/generated/data-contracts';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { BaseWorkflowDeclaration } from '../..';
 import type { LegacyWorkflow } from '../../../legacy/legacy-transformer';
 import { HatchetClient } from '../client';
@@ -11,22 +11,10 @@ import { WorkflowsClient } from './workflows';
 export declare const CreateCronTriggerSchema: z.ZodObject<{
     name: z.ZodString;
     expression: z.ZodString;
-    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    input: z.ZodOptional<z.ZodRecord<z.ZodAny, z.ZodAny>>;
     additionalMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     priority: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    expression: string;
-    additionalMetadata?: Record<string, string> | undefined;
-    priority?: number | undefined;
-    input?: Record<string, any> | undefined;
-}, {
-    name: string;
-    expression: string;
-    additionalMetadata?: Record<string, string> | undefined;
-    priority?: number | undefined;
-    input?: Record<string, any> | undefined;
-}>;
+}, z.core.$strip>;
 /**
  * Type representing the input for creating a Cron.
  * @internal

package/v1/client/features/crons.js

@@ -21,7 +21,7 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CronClient = exports.CreateCronTriggerSchema = void 0;
-const zod_1 = require("zod");
+const v4_1 = require("zod/v4");
 const axios_1 = require("axios");
 const uuid_1 = require("../../../util/uuid");
 const apply_namespace_1 = require("../../../util/apply-namespace");
@@ -30,12 +30,12 @@ const workflows_1 = require("./workflows");
  * Schema for creating a Cron Trigger.
  * @internal
  */
-exports.CreateCronTriggerSchema = zod_1.z.object({
-    name: zod_1.z.string(),
-    expression: zod_1.z.string(),
-    input: zod_1.z.record(zod_1.z.any()).optional(),
-    additionalMetadata: zod_1.z.record(zod_1.z.string()).optional(),
-    priority: zod_1.z.number().optional(),
+exports.CreateCronTriggerSchema = v4_1.z.object({
+    name: v4_1.z.string(),
+    expression: v4_1.z.string(),
+    input: v4_1.z.record(v4_1.z.any(), v4_1.z.any()).optional(),
+    additionalMetadata: v4_1.z.record(v4_1.z.string(), v4_1.z.string()).optional(),
+    priority: v4_1.z.number().optional(),
 });
 /**
  * The cron client is a client for managing cron workflows within Hatchet.
@@ -83,7 +83,7 @@ class CronClient {
                 return response.data;
             }
             catch (err) {
-                if (err instanceof zod_1.z.ZodError) {
+                if (err instanceof v4_1.z.ZodError) {
                     throw new Error(`Invalid cron input: ${err.message}`, { cause: err });
                 }
                 if (err instanceof axios_1.AxiosError) {

package/v1/client/features/schedules.d.ts

@@ -1,5 +1,5 @@
 import { ScheduledWorkflows, ScheduledWorkflowsBulkDeleteFilter, ScheduledWorkflowsBulkDeleteResponse, ScheduledWorkflowsBulkUpdateResponse, ScheduledWorkflowsList } from '../../../clients/rest/generated/data-contracts';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { Workflow } from '../../../workflow';
 import { BaseWorkflowDeclaration, WorkflowDefinition } from '../..';
 import { HatchetClient } from '../client';
@@ -9,21 +9,11 @@ import { WorkflowsClient } from './workflows';
  * @internal
  */
 export declare const CreateScheduledRunTriggerSchema: z.ZodObject<{
-    triggerAt: z.ZodDate;
-    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    triggerAt: z.ZodCoercedDate<unknown>;
+    input: z.ZodOptional<z.ZodRecord<z.ZodAny, z.ZodAny>>;
     additionalMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     priority: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    triggerAt: Date;
-    additionalMetadata?: Record<string, string> | undefined;
-    priority?: number | undefined;
-    input?: Record<string, any> | undefined;
-}, {
-    triggerAt: Date;
-    additionalMetadata?: Record<string, string> | undefined;
-    priority?: number | undefined;
-    input?: Record<string, any> | undefined;
-}>;
+}, z.core.$strip>;
 /**
  * Type representing the input for creating a Cron.
  * @internal
@@ -34,12 +24,8 @@ export type CreateScheduledRunInput = z.infer<typeof CreateScheduledRunTriggerSc
  * @internal
  */
 export declare const UpdateScheduledRunTriggerSchema: z.ZodObject<{
-    triggerAt: z.ZodDate;
-}, "strip", z.ZodTypeAny, {
-    triggerAt: Date;
-}, {
-    triggerAt: Date;
-}>;
+    triggerAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strip>;
 export type UpdateScheduledRunInput = z.infer<typeof UpdateScheduledRunTriggerSchema>;
 /**
  * The scheduled client is a client for managing scheduled workflows within Hatchet

package/v1/client/features/schedules.js

@@ -21,7 +21,7 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ScheduleClient = exports.UpdateScheduledRunTriggerSchema = exports.CreateScheduledRunTriggerSchema = void 0;
-const zod_1 = require("zod");
+const v4_1 = require("zod/v4");
 const axios_1 = require("axios");
 const uuid_1 = require("../../../util/uuid");
 const apply_namespace_1 = require("../../../util/apply-namespace");
@@ -30,18 +30,18 @@ const workflows_1 = require("./workflows");
  * Schema for creating a Scheduled Run Trigger.
  * @internal
  */
-exports.CreateScheduledRunTriggerSchema = zod_1.z.object({
-    triggerAt: zod_1.z.coerce.date(),
-    input: zod_1.z.record(zod_1.z.any()).optional(),
-    additionalMetadata: zod_1.z.record(zod_1.z.string()).optional(),
-    priority: zod_1.z.number().optional(),
+exports.CreateScheduledRunTriggerSchema = v4_1.z.object({
+    triggerAt: v4_1.z.coerce.date(),
+    input: v4_1.z.record(v4_1.z.any(), v4_1.z.any()).optional(),
+    additionalMetadata: v4_1.z.record(v4_1.z.string(), v4_1.z.string()).optional(),
+    priority: v4_1.z.number().optional(),
 });
 /**
  * Schema for updating (rescheduling) a Scheduled Run Trigger.
  * @internal
  */
-exports.UpdateScheduledRunTriggerSchema = zod_1.z.object({
-    triggerAt: zod_1.z.coerce.date(),
+exports.UpdateScheduledRunTriggerSchema = v4_1.z.object({
+    triggerAt: v4_1.z.coerce.date(),
 });
 /**
  * The scheduled client is a client for managing scheduled workflows within Hatchet
@@ -91,7 +91,7 @@ class ScheduleClient {
                 return response.data;
             }
             catch (err) {
-                if (err instanceof zod_1.z.ZodError) {
+                if (err instanceof v4_1.z.ZodError) {
                     throw new Error(`Invalid cron input: ${err.message}`, { cause: err });
                 }
                 if (err instanceof axios_1.AxiosError) {
@@ -119,7 +119,7 @@ class ScheduleClient {
                 return response.data;
             }
             catch (err) {
-                if (err instanceof zod_1.z.ZodError) {
+                if (err instanceof v4_1.z.ZodError) {
                     throw new Error(`Invalid update input: ${err.message}`, { cause: err });
                 }
                 if (err instanceof axios_1.AxiosError) {

package/v1/client/worker/context.d.ts

@@ -18,7 +18,7 @@ import { HatchetClient } from '../..';
 import { WorkerLabels } from '../../../clients/dispatcher/dispatcher-client';
 import { NextStep } from '../../../legacy/step';
 import { DurableListenerClient } from '../../../clients/listeners/durable-listener/durable-listener-client';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { InternalWorker } from './worker-internal';
 import { Duration } from '../duration';
 import { DurableEvictionManager } from './eviction/eviction-manager';
@@ -306,6 +306,16 @@ export declare class Context<T, K = {}> {
      */
     parentWorkflowRunId(): string | undefined;
     priority(): Priority | undefined;
+    /**
+     * Gets the external ID of the event that triggered this workflow run, if any.
+     * @returns The triggering event external ID, or undefined if the workflow was not triggered by an event.
+     */
+    triggeringEventId(): string | undefined;
+    /**
+     * Gets the key of the event that triggered this workflow run, if any.
+     * @returns The triggering event key, or undefined if the workflow was not triggered by an event.
+     */
+    triggeringEventKey(): string | undefined;
     /**
      * Get the output of a task.
      * @param task - The name of the task to get the output for.

package/v1/client/worker/context.js

@@ -506,6 +506,20 @@ class Context {
                 return undefined;
         }
     }
+    /**
+     * Gets the external ID of the event that triggered this workflow run, if any.
+     * @returns The triggering event external ID, or undefined if the workflow was not triggered by an event.
+     */
+    triggeringEventId() {
+        return this.action.triggeringEventExternalId;
+    }
+    /**
+     * Gets the key of the event that triggered this workflow run, if any.
+     * @returns The triggering event key, or undefined if the workflow was not triggered by an event.
+     */
+    triggeringEventKey() {
+        return this.action.triggeringEventKey;
+    }
     // FIXME: drop these at some point soon
     /**
      * Get the output of a task.

package/v1/client/worker/worker-internal.js

@@ -64,7 +64,7 @@ const workflows_1 = require("../../../protoc/workflows");
 const logger_1 = require("../../../util/logger");
 const task_1 = require("../../task");
 const transformer_1 = require("../../conditions/transformer");
-const zod_to_json_schema_1 = require("zod-to-json-schema");
+const z = __importStar(require("zod/v4"));
 const apply_namespace_1 = require("../../../util/apply-namespace");
 const sleep_1 = __importDefault(require("../../../util/sleep"));
 const abort_error_1 = require("../../../util/abort-error");
@@ -263,7 +263,7 @@ class InternalWorker {
                 // Convert Zod schema to JSON Schema if provided
                 let inputJsonSchema;
                 if (workflow.inputValidator) {
-                    const jsonSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(workflow.inputValidator);
+                    const jsonSchema = z.toJSONSchema(workflow.inputValidator);
                     inputJsonSchema = new TextEncoder().encode(JSON.stringify(jsonSchema));
                 }
                 const durableTaskSet = new Set(workflow._durableTasks);

package/v1/declaration.d.ts

@@ -7,7 +7,7 @@
  */
 import WorkflowRunRef from '../util/workflow-run-ref';
 import { CronWorkflows, ScheduledWorkflows, V1CreateFilterRequest } from '../clients/rest/generated/data-contracts';
-import { z } from 'zod';
+import * as z from 'zod/v4';
 import { IHatchetClient } from './client/client.interface';
 import { CreateWorkflowTaskOpts, CreateOnFailureTaskOpts, TaskFn, CreateWorkflowDurableTaskOpts, CreateBaseTaskOpts, CreateOnSuccessTaskOpts, Concurrency, DurableTaskFn, WorkerLabelComparator } from './task';
 import { Duration } from './client/duration';
@@ -15,11 +15,20 @@ import { MetricsClient } from './client/features/metrics';
 import { InputType, OutputType, UnknownInputType, JsonObject, Resolved } from './types';
 import { Context, DurableContext } from './client/worker/context';
 import { EvictionPolicy } from './client/worker/eviction/eviction-policy';
+import type { FunctionTool } from '@openai/agents';
+import type { SdkMcpToolDefinition } from '@anthropic-ai/claude-agent-sdk';
+import type { OpenAIToolFuncT } from './agent/openai';
+import type { ClaudeToolFuncT } from './agent/claude';
 export declare enum Priority {
     LOW = 1,
     MEDIUM = 2,
     HIGH = 3
 }
+type AgentSdkFuncMap = {
+    claude: ClaudeToolFuncT;
+    openai: OpenAIToolFuncT;
+};
+type Tail<T extends any[]> = T extends [any, ...infer R] ? R : never;
 /**
  * Additional metadata that can be attached to a workflow run.
  */
@@ -358,6 +367,14 @@ export declare class BaseWorkflowDeclaration<I extends InputType = UnknownInputT
      * @returns The name of the workflow.
      */
     get name(): string;
+    /**
+     * Create an MCP tool from a workflow. Supports both Claude and OpenAI agent sdks.
+     * @param sdk The agent SDK the tool will be used with.
+     * @param args Optional arguments passed to create the MCP tool object.
+     * @returns The MCP tool object.
+     **/
+    mcpTool(sdk: 'claude', ...args: Tail<Parameters<AgentSdkFuncMap['claude']>>): SdkMcpToolDefinition;
+    mcpTool(sdk: 'openai', ...args: Tail<Parameters<AgentSdkFuncMap['openai']>>): FunctionTool;
 }
 /**
  * A Hatchet workflow, which lets you define tasks and perform actions on the workflow.

package/v1/declaration.js

@@ -409,6 +409,16 @@ class BaseWorkflowDeclaration {
     get name() {
         return this.definition.name;
     }
+    mcpTool(sdk, ...args) {
+        if (sdk === 'openai') {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { OpenAIToolFunc } = require('./agent/openai');
+            return OpenAIToolFunc(this, ...args);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { ClaudeToolFunc } = require('./agent/claude');
+        return ClaudeToolFunc(this, ...args);
+    }
 }
 exports.BaseWorkflowDeclaration = BaseWorkflowDeclaration;
 /**

package/v1/examples/agent/agent-claude.d.ts

@@ -0,0 +1 @@
+export {};