CLAUDE.md

1# Core Package
2 
3`@trigger.dev/core` - shared types, schemas, and utilities used across the SDK, CLI, and webapp.
4 
5## Critical Import Rule
6 
7**NEVER import the root** (`@trigger.dev/core`). Always use subpath imports:
8 
9```typescript
10import { ... } from "@trigger.dev/core/v3";
11import { ... } from "@trigger.dev/core/v3/utils";
12import { ... } from "@trigger.dev/core/logger";
13import { ... } from "@trigger.dev/core/schemas";
14```
15 
16## Cross-Cutting Impact
17 
18Changes here affect both the customer-facing SDK and the server-side webapp. Exercise caution - breaking changes can affect deployed user tasks and the platform simultaneously.
19 
20## Contents
21 
22- Protocol definitions and message types
23- API schemas (Zod validation)
24- Shared constants and enums
25- Utility functions used across packages
26