Skip to content
Shahryar Sabir Muhammed
Shahryar Sabir
Software & AI Engineer
← Back to Systems
Solo Engineered
TypeScriptLangGraphZodSSEOpenTelemetrynpm

langgraph-zod

The runtime type system and structural API boundary layer for LangGraphJS agents — deriving production-ready Zod boundary schemas directly from graph state channels.

View GitHub Repository Inquire / Collaborate
$ npm i langgraph-zod

langgraph-zod — the boundary layer for language agents

TypeScript gives you compile-time safety; LLMs operate in the untyped world of unstructured text. langgraph-zod bridges that gap by deriving production-ready runtime boundary schemas directly from your LangGraph state channel definitions.

Feature highlights

  • Boundary Validation (createGraphSchemas): derives inputSchema and outputSchema from state definitions — omitting internal scratchpads and keys before they leak into public API output.
  • Streaming-First SSE Validation: incremental SSE parser + TransformStream validates graph.streamEvents() payloads on the fly, drops malformed chunks, and handles backpressure — at <1ms per-chunk latency.
  • Framework-agnostic AgentBoundary: wraps any async function or async generator — LangGraph, Vercel AI SDK, AutoGen TS, or plain custom agents.
  • Zod-native channel reducers (zodChannel) and self-healing LLM output parsing (safeParseLLMOutput) with repair retries.
  • Production telemetry: OpenTelemetry spans, counters (validation.error_count, channel.failed_key), and latency histograms.
  • CLI: export OpenAPI 3.1 specs and diff schemas for breaking changes in CI.

All of it in a 36 KB bundle, with adapters for Next.js, Hono, and Express.

System Specifications

0
B
1
u
2
i
3
l
4
t
5
6
a
7
n
8
d
9
10
p
11
u
12
b
13
l
14
i
15
s
16
h
17
e
18
d
19
20
l
21
a
22
n
23
g
24
g
25
r
26
a
27
p
28
h
29
-
30
z
31
o
32
d
33
34
t
35
o
36
37
c
38
l
39
o
40
s
41
e
42
43
t
44
h
45
e
46
47
g
48
a
49
p
50
51
b
52
e
53
t
54
w
55
e
56
e
57
n
58
59
T
60
y
61
p
62
e
63
S
64
c
65
r
66
i
67
p
68
t
69
'
70
s
71
72
c
73
o
74
m
75
p
76
i
77
l
78
e
79
-
80
t
81
i
82
m
83
e
84
85
s
86
a
87
f
88
e
89
t
90
y
91
92
a
93
n
94
d
95
96
t
97
h
98
e
99
100
u
101
n
102
t
103
y
104
p
105
e
106
d
107
108
w
109
o
110
r
111
l
112
d
113
114
o
115
f
116
117
L
118
L
119
M
120
121
t
122
e
123
x
124
t
125
:
126
127
c
128
r
129
e
130
a
131
t
132
e
133
G
134
r
135
a
136
p
137
h
138
S
139
c
140
h
141
e
142
m
143
a
144
s
145
146
d
147
e
148
r
149
i
150
v
151
e
152
s
153
154
i
155
n
156
p
157
u
158
t
159
/
160
o
161
u
162
t
163
p
164
u
165
t
166
/
167
s
168
t
169
a
170
t
171
e
172
173
b
174
o
175
u
176
n
177
d
178
a
179
r
180
y
181
182
s
183
c
184
h
185
e
186
m
187
a
188
s
189
190
f
191
r
192
o
193
m
194
195
L
196
a
197
n
198
g
199
G
200
r
201
a
202
p
203
h
204
205
c
206
h
207
a
208
n
209
n
210
e
211
l
212
213
d
214
e
215
f
216
i
217
n
218
i
219
t
220
i
221
o
222
n
223
s
224
,
225
226
a
227
228
s
229
t
230
r
231
e
232
a
233
m
234
i
235
n
236
g
237
-
238
f
239
i
240
r
241
s
242
t
243
244
S
245
S
246
E
247
248
v
249
a
250
l
251
i
252
d
253
a
254
t
255
o
256
r
257
258
c
259
h
260
e
261
c
262
k
263
s
264
265
g
266
r
267
a
268
p
269
h
270
.
271
s
272
t
273
r
274
e
275
a
276
m
277
E
278
v
279
e
280
n
281
t
282
s
283
(
284
)
285
286
p
287
a
288
y
289
l
290
o
291
a
292
d
293
s
294
295
i
296
n
297
298
f
299
l
300
i
301
g
302
h
303
t
304
305
a
306
t
307
308
u
309
n
310
d
311
e
312
r
313
314
1
315
m
316
s
317
318
p
319
e
320
r
321
322
c
323
h
324
u
325
n
326
k
327
,
328
329
a
330
331
f
332
r
333
a
334
m
335
e
336
w
337
o
338
r
339
k
340
-
341
a
342
g
343
n
344
o
345
s
346
t
347
i
348
c
349
350
A
351
g
352
e
353
n
354
t
355
B
356
o
357
u
358
n
359
d
360
a
361
r
362
y
363
364
w
365
r
366
a
367
p
368
s
369
370
a
371
n
372
y
373
374
a
375
s
376
y
377
n
378
c
379
380
f
381
u
382
n
383
c
384
t
385
i
386
o
387
n
388
389
o
390
r
391
392
g
393
e
394
n
395
e
396
r
397
a
398
t
399
o
400
r
401
,
402
403
a
404
d
405
a
406
p
407
t
408
e
409
r
410
s
411
412
s
413
e
414
r
415
v
416
e
417
418
N
419
e
420
x
421
t
422
.
423
j
424
s
425
426
A
427
p
428
p
429
430
R
431
o
432
u
433
t
434
e
435
r
436
,
437
438
H
439
o
440
n
441
o
442
,
443
444
a
445
n
446
d
447
448
E
449
x
450
p
451
r
452
e
453
s
454
s
455
456
r
457
o
458
u
459
t
460
e
461
s
462
,
463
464
a
465
n
466
d
467
468
O
469
p
470
e
471
n
472
T
473
e
474
l
475
e
476
m
477
e
478
t
479
r
480
y
481
482
h
483
o
484
o
485
k
486
s
487
488
p
489
l
490
u
491
s
492
493
P
494
i
495
n
496
o
497
/
498
W
499
i
500
n
501
s
502
t
503
o
504
n
505
506
s
507
e
508
r
509
i
510
a
511
l
512
i
513
z
514
e
515
r
516
s
517
518
m
519
a
520
k
521
e
522
523
v
524
a
525
l
526
i
527
d
528
a
529
t
530
i
531
o
532
n
533
534
f
535
a
536
i
537
l
538
u
539
r
540
e
541
s
542
543
o
544
b
545
s
546
e
547
r
548
v
549
a
550
b
551
l
552
e
553
554
i
555
n
556
557
p
558
r
559
o
560
d
561
u
562
c
563
t
564
i
565
o
566
n
567
.
568
569
Z
570
o
571
d
572
573
v
574
3
575
576
a
577
n
578
d
579
580
v
581
4
582
583
a
584
r
585
e
586
587
b
588
o
589
t
590
h
591
592
s
593
u
594
p
595
p
596
o
597
r
598
t
599
e
600
d
601
602
t
603
h
604
r
605
o
606
u
607
g
608
h
609
610
a
611
612
s
613
a
614
f
615
e
616
617
z
618
o
619
d
620
-
621
a
622
s
623
t
624
625
i
626
n
627
t
628
r
629
o
630
s
631
p
632
e
633
c
634
t
635
i
636
o
637
n
638
639
l
640
a
641
y
642
e
643
r
644
.

Need this in production?

I build and deploy custom speech AI models and persistent agent systems for businesses and teams.

Schedule Architecture Call →
← Previous System Bakh Cafe Next System → Rega-liquid