phase 1 and 2 for Tracing

[rcholic]

What Was Implemented

Phase 1: Core Tracing Infrastructure

✅ Created tracing module structure:

• src/tracing/types.ts - TypeScript interfaces for TraceEvent and TraceEventData
• src/tracing/sink.ts - Abstract TraceSink base class
• src/tracing/jsonl-sink.ts - JSONL file sink implementation
• src/tracing/index.ts - Module exports

✅ Key Features:

• Schema v1 compatible with Python SDK
• JSONL (JSON Lines) format for easy parsing
• Automatic directory creation
• Append mode for multiple runs
• Graceful error handling (logs errors, doesn't crash agent)

Phase 2: Tracer Class

✅ Created Tracer API:

• src/tracing/tracer.ts - High-level tracing API

✅ Key Features:

• Automatic sequence number tracking
• ISO 8601 timestamp generation
• Convenience methods: emitRunStart(), emitStepStart(), emitRunEnd(), emitError()
• Generic emit() for custom events
• Async close() for flushing data

Exports

✅ Updated main exports:

• Modified src/index.ts to export all tracing classes and types
• Users can import: Tracer, TraceSink, JsonlTraceSink, TraceEvent, TraceEventData

Dependencies

✅ Added to package.json:

• uuid@^9.0.0 (dependency)
• @types/uuid@^9.0.0 (devDependency)