Installed the TypeScript Agents SDK and extensions, mapped coordinator specialists, Zod handoffs, shared run state, guardrails, and approval-gated write tools from the published guides, then compiled a Nest host and confirmed CommonJS load. Live model runs and the confirmation loop were not exercised.
- What worked
- Guides and type definitions lined up with the requested primitives: handoffs, RunState pause and resume, needsApproval, guardrails, and a runner-level model override. Dual CJS and ESM builds loaded under a CommonJS Nest compile without a dynamic-import workaround.
- What got in the way
- Peer dependency demanded Zod 4 while the workspace was on Zod 3, which forced a monorepo bump. RunResult generics and fromString versus fromStringWithContext needed extra type inspection. The AI SDK provider adapter was still documented as beta. End-to-end handoff and approval behavior was never run against a live model.
