Add Typescript support for Claude/OpenAI MCP server tools (#3443)

Author: juliusgeo

.github/workflows/sdk-typescript.yml

@@ -49,7 +49,7 @@ jobs:
         run: pnpm lint:check
 
       - name: Type check
-        run: npx tsc
+        run: pnpm exec tsc
 
   test-unit:
     runs-on: ubicloud-standard-4

examples/typescript/durable/workflow.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { Or, SleepCondition, UserEventCondition } from '@hatchet-dev/typescript-sdk/v1/conditions';
 import { NonDeterminismError } from '@hatchet-dev/typescript-sdk/util/errors/non-determinism-error';
 import sleep from '@hatchet-dev/typescript-sdk/util/sleep';
@@ -254,6 +254,10 @@ const lookbackEventPayloadSchema = z.object({
   user_id: z.number(),
 });
 
+const twoEventsPayloadSchema = z.object({
+  order: z.string(),
+});
+
 export const waitForEventLookback = hatchet.durableTask({
   name: 'wait-for-event-lookback',
   executionTimeout: '10m',
@@ -312,14 +316,14 @@ export const waitForTwoEventsSecondPushedFirst = hatchet.durableTask({
     const event1 = await ctx.waitForEvent(
       'key1',
       undefined,
-      undefined,
+      twoEventsPayloadSchema,
       input.scope,
       LOOKBACK_WINDOW
     );
     const event2 = await ctx.waitForEvent(
       'key2',
       undefined,
-      undefined,
+      twoEventsPayloadSchema,
       input.scope,
       LOOKBACK_WINDOW
     );

examples/typescript/simple/run.ts

@@ -1,6 +1,7 @@
 import { hatchet } from '../hatchet-client';
 import { simple } from './workflow';
 import { parent } from './workflow-with-child';
+import { simpleWithZod } from './zod';
 
 async function main() {
   // > Running a Task
@@ -15,6 +16,11 @@ async function main() {
     }
   );
 
+  const res3 = await simpleWithZod.run({
+    Message: 'HeLlO WoRlD',
+  });
+  console.log(res3.TransformedMessage);
+
   // 👀 Access the results of the Task
   console.log(res.TransformedMessage);
 }

examples/typescript/simple/zod.ts

@@ -1,5 +1,5 @@
 // > Declaring a Task
-import * as z from 'zod';
+import * as z from 'zod/v4';
 import { hatchet } from '../hatchet-client';
 
 const SimpleInputSchema = z.object({

sdks/typescript/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to Hatchet's TypeScript SDK will be documented in this chang
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.22.0] - 2026-04-28
+
+### Added
+
+- Adds `mcpTool` method to Workflow objects for integration with Claude and OpenAI agent SDKs. Requires Zod v4.
+- Bumps minimum Zod version to `3.25.0`. Zod schemas provided to the SDK must be Zod 4 schemas, but you can still use Zod 3 in your application
+code.
+
 ## [1.21.2] - 2026-04-22
 
 ### Added

sdks/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatchet-dev/typescript-sdk",
-  "version": "1.21.2",
+  "version": "1.22.0",
   "description": "Background task orchestration & visibility for developers",
   "types": "dist/index.d.ts",
   "files": [
@@ -44,7 +44,6 @@
   "license": "MIT",
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@tsd/typescript": "^5.9.3",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.13.14",
     "autoprefixer": "^10.4.27",
@@ -63,6 +62,8 @@
     "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
     "ts-proto": "^2.11.4",
+    "tsconfig-paths": "^4.2.0",
+    "tsx": "^4.21.0",
     "typedoc": "^0.28.17",
     "typedoc-plugin-markdown": "^4.10.0",
     "typedoc-plugin-no-inherit": "^1.6.1",
@@ -81,11 +82,16 @@
     "qs": "^6.14.2",
     "semver": "^7.7.4",
     "yaml": "^2.8.2",
-    "zod": "^3.24.2",
-    "zod-to-json-schema": "^3.24.1"
+    "zod-to-json-schema": "^3.24.2"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.0 || ^4.0.0"
   },
   "optionalDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.87",
     "@grpc/grpc-js": "^1.14.3",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@openai/agents": "0.8.3",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/core": "^2.0.0",
     "@opentelemetry/exporter-trace-otlp-grpc": "^0.215.0",