@kilnai/core 0.1.0

package/dist/events/event-bus.d.ts

@@ -0,0 +1,36 @@
+import type { EventType, EventMap, KilnEvent, StreamLevel } from "./index.js";
+import type { EventStore } from "./event-store.js";
+/**
+ * Typed pub/sub event bus for orchestrator communication.
+ * Synchronous handlers only -- events are notifications, not commands.
+ */
+export declare class EventBus {
+    private readonly handlers;
+    private readonly anyHandlers;
+    private readonly buffer;
+    private readonly maxHistory;
+    private readonly store;
+    private writePointer;
+    private count;
+    constructor(maxHistory?: number, store?: EventStore);
+    /** Subscribe to a specific event type */
+    on<T extends EventType>(type: T, handler: (event: EventMap[T]) => void): void;
+    /** Unsubscribe from a specific event type */
+    off<T extends EventType>(type: T, handler: (event: EventMap[T]) => void): void;
+    /** Emit an event to all subscribers of its type and all onAny subscribers */
+    emit(event: KilnEvent): void;
+    /** Subscribe to all events */
+    onAny(handler: (event: KilnEvent) => void): void;
+    /** Unsubscribe from all events */
+    offAny(handler: (event: KilnEvent) => void): void;
+    /**
+     * Subscribe to events matching a streaming level.
+     * Subscribing to "phase" includes "state" + "phase" events.
+     */
+    onLevel(level: StreamLevel, handler: (event: KilnEvent) => void): () => void;
+    /** Return recent events from the ring buffer, oldest first */
+    history(limit?: number): readonly KilnEvent[];
+    /** Clear all subscriptions and history */
+    clear(): void;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/events/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,KAAK,CAAK;gBAEN,UAAU,SAAM,EAAE,KAAK,CAAC,EAAE,UAAU;IAMhD,yCAAyC;IACzC,EAAE,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAS7E,6CAA6C;IAC7C,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAQ9E,6EAA6E;IAC7E,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAyB5B,8BAA8B;IAC9B,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAIhD,kCAAkC;IAClC,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAIjD;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAqB5E,8DAA8D;IAC9D,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE;IAoB7C,0CAA0C;IAC1C,KAAK,IAAI,IAAI;CAOd"}

package/dist/events/event-bus.js

@@ -0,0 +1,116 @@
+import { EVENT_LEVEL_MAP, LEVEL_HIERARCHY } from "./index.js";
+/**
+ * Typed pub/sub event bus for orchestrator communication.
+ * Synchronous handlers only -- events are notifications, not commands.
+ */
+export class EventBus {
+    handlers = new Map();
+    anyHandlers = new Set();
+    buffer;
+    maxHistory;
+    store;
+    writePointer = 0;
+    count = 0;
+    constructor(maxHistory = 100, store) {
+        this.maxHistory = maxHistory;
+        this.buffer = new Array(maxHistory);
+        this.store = store ?? null;
+    }
+    /** Subscribe to a specific event type */
+    on(type, handler) {
+        let set = this.handlers.get(type);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(type, set);
+        }
+        set.add(handler);
+    }
+    /** Unsubscribe from a specific event type */
+    off(type, handler) {
+        const set = this.handlers.get(type);
+        if (set) {
+            set.delete(handler);
+            if (set.size === 0)
+                this.handlers.delete(type);
+        }
+    }
+    /** Emit an event to all subscribers of its type and all onAny subscribers */
+    emit(event) {
+        // Write to ring buffer
+        this.buffer[this.writePointer] = event;
+        this.writePointer = (this.writePointer + 1) % this.maxHistory;
+        if (this.count < this.maxHistory)
+            this.count++;
+        // Notify type-specific handlers
+        const set = this.handlers.get(event.type);
+        if (set) {
+            for (const handler of set) {
+                handler(event);
+            }
+        }
+        // Notify wildcard handlers
+        for (const handler of this.anyHandlers) {
+            handler(event);
+        }
+        // Persist fire-and-forget -- never blocks synchronous emit
+        if (this.store) {
+            this.store.save(event).catch(() => { });
+        }
+    }
+    /** Subscribe to all events */
+    onAny(handler) {
+        this.anyHandlers.add(handler);
+    }
+    /** Unsubscribe from all events */
+    offAny(handler) {
+        this.anyHandlers.delete(handler);
+    }
+    /**
+     * Subscribe to events matching a streaming level.
+     * Subscribing to "phase" includes "state" + "phase" events.
+     */
+    onLevel(level, handler) {
+        const levels = LEVEL_HIERARCHY[level];
+        const types = new Set();
+        for (const [type, eventLevel] of Object.entries(EVENT_LEVEL_MAP)) {
+            if (levels.includes(eventLevel)) {
+                types.add(type);
+            }
+        }
+        for (const type of types) {
+            this.on(type, handler);
+        }
+        return () => {
+            for (const type of types) {
+                this.off(type, handler);
+            }
+        };
+    }
+    /** Return recent events from the ring buffer, oldest first */
+    history(limit) {
+        const total = Math.min(limit ?? this.count, this.count);
+        if (total === 0)
+            return [];
+        const result = [];
+        // Start reading from the oldest entry within the requested limit
+        const startOffset = this.count < this.maxHistory
+            ? this.count - total
+            : this.writePointer + (this.count - total);
+        for (let i = 0; i < total; i++) {
+            const idx = (startOffset + i) % this.maxHistory;
+            const event = this.buffer[idx];
+            if (event)
+                result.push(event);
+        }
+        return result;
+    }
+    /** Clear all subscriptions and history */
+    clear() {
+        this.handlers.clear();
+        this.anyHandlers.clear();
+        this.buffer.fill(undefined);
+        this.writePointer = 0;
+        this.count = 0;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/events/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"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"}

package/dist/events/event-store.d.ts

@@ -0,0 +1,11 @@
+import type { KilnEvent } from "./index.js";
+/** Persistent event storage. Consumers implement this for their infrastructure (Postgres, SQLite, etc.). */
+export interface EventStore {
+    /** Persist an event. Called fire-and-forget from EventBus.emit(). */
+    save(event: KilnEvent): Promise<void>;
+    /** Retrieve all events for a session, ordered by id ascending. */
+    getBySession(sessionId: string): Promise<KilnEvent[]>;
+    /** Retrieve events after a given event id (for SSE reconnection). */
+    getAfter(sessionId: string, afterId: string): Promise<KilnEvent[]>;
+}
+//# sourceMappingURL=event-store.d.ts.map

package/dist/events/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/events/event-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,4GAA4G;AAC5G,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,kEAAkE;IAClE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACtD,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACpE"}

package/dist/events/event-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-store.js.map

package/dist/events/event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../src/events/event-store.ts"],"names":[],"mappings":""}

package/dist/events/index.d.ts

@@ -0,0 +1,295 @@
+import type { TraceSpan } from "./trace.js";
+/** Streaming granularity levels, from coarsest to finest */
+export type StreamLevel = "state" | "phase" | "tool" | "token";
+/** Map each event type to its streaming level */
+export declare const EVENT_LEVEL_MAP: Record<EventType, StreamLevel>;
+/** Level hierarchy: subscribing to "phase" includes "state" + "phase" */
+export declare const LEVEL_HIERARCHY: Record<StreamLevel, readonly StreamLevel[]>;
+/** All event types emitted by the orchestrator */
+export type EventType = "phase_changed" | "task_started" | "task_completed" | "tool_called" | "tool_result" | "thinking" | "verification_result" | "cost_update" | "memory_saved" | "memory_recalled" | "memory_sync" | "approval_requested" | "approval_received" | "worker_assigned" | "error" | "trace_span" | "handoff_requested" | "handoff_completed" | "interrupt_requested" | "interrupt_resumed" | "injection_scanned" | "guardian_reviewed" | "audit_entry" | "tenant_isolation_violation" | "security_alert" | "webhook_received" | "trigger_fired" | "trigger_failed" | "schedule_fired" | "pii_detected" | "content_classified" | "policy_evaluated";
+/** Base event interface */
+export interface KilnEvent {
+    readonly type: EventType;
+    readonly timestamp: Date;
+    readonly sessionId: string;
+}
+/** Phase transition event */
+export interface PhaseChangedEvent extends KilnEvent {
+    readonly type: "phase_changed";
+    readonly phase: string;
+    readonly phaseName: string;
+    readonly phaseDescription: string;
+}
+/** Cost update event */
+export interface CostUpdateEvent extends KilnEvent {
+    readonly type: "cost_update";
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly totalCostUsd: number;
+    readonly byRole: Record<string, {
+        model: string;
+        calls: number;
+        costUsd: number;
+    }>;
+}
+/** Tool called event */
+export interface ToolCalledEvent extends KilnEvent {
+    readonly type: "tool_called";
+    readonly toolName: string;
+    readonly taskId?: string;
+    readonly workerIndex?: number;
+}
+/** Task started event */
+export interface TaskStartedEvent extends KilnEvent {
+    readonly type: "task_started";
+    readonly taskId: string;
+    readonly statement: string;
+    readonly parentId: string | null;
+}
+/** Task completed event */
+export interface TaskCompletedEvent extends KilnEvent {
+    readonly type: "task_completed";
+    readonly taskId: string;
+    readonly status: string;
+    readonly action: string;
+}
+/** Tool result event */
+export interface ToolResultEvent extends KilnEvent {
+    readonly type: "tool_result";
+    readonly toolName: string;
+    readonly taskId?: string;
+    readonly durationMs: number;
+    readonly success: boolean;
+}
+/** Thinking event (agent reasoning) */
+export interface ThinkingEvent extends KilnEvent {
+    readonly type: "thinking";
+    readonly role: string;
+    readonly content: string;
+}
+/** Verification result event */
+export interface VerificationResultEvent extends KilnEvent {
+    readonly type: "verification_result";
+    readonly passed: boolean;
+    readonly iteration: number;
+    readonly maxIterations: number;
+    readonly checks: readonly {
+        name: string;
+        passed: boolean;
+        output: string;
+    }[];
+}
+/** Memory saved event */
+export interface MemorySavedEvent extends KilnEvent {
+    readonly type: "memory_saved";
+    readonly memoryId: string;
+    readonly layer: string;
+    readonly tags: readonly string[];
+}
+/** Memory recalled event */
+export interface MemoryRecalledEvent extends KilnEvent {
+    readonly type: "memory_recalled";
+    readonly query: string;
+    readonly resultsCount: number;
+}
+/** Memory sync event (chunks imported from git) */
+export interface MemorySyncEvent extends KilnEvent {
+    readonly type: "memory_sync";
+    readonly imported: number;
+    readonly entries: number;
+    readonly developers: number;
+}
+/** Approval requested event */
+export interface ApprovalRequestedEvent extends KilnEvent {
+    readonly type: "approval_requested";
+    readonly taskId: string;
+    readonly description: string;
+}
+/** Approval received event */
+export interface ApprovalReceivedEvent extends KilnEvent {
+    readonly type: "approval_received";
+    readonly taskId: string;
+    readonly approved: boolean;
+    readonly reason?: string;
+}
+/** Worker assigned event */
+export interface WorkerAssignedEvent extends KilnEvent {
+    readonly type: "worker_assigned";
+    readonly workerIndex: number;
+    readonly taskId: string;
+}
+/** Error event */
+export interface ErrorEvent extends KilnEvent {
+    readonly type: "error";
+    readonly message: string;
+    readonly code: string;
+    readonly taskId: string | null;
+}
+/** Trace span event */
+export interface TraceSpanEvent extends KilnEvent {
+    readonly type: "trace_span";
+    readonly span: TraceSpan;
+}
+/** Handoff requested event (swarm/supervisor delegation) */
+export interface HandoffRequestedEvent extends KilnEvent {
+    readonly type: "handoff_requested";
+    readonly fromAgent: string;
+    readonly toAgent: string;
+    readonly reason: string;
+    readonly context?: Record<string, unknown>;
+}
+/** Handoff completed event */
+export interface HandoffCompletedEvent extends KilnEvent {
+    readonly type: "handoff_completed";
+    readonly fromAgent: string;
+    readonly toAgent: string;
+    readonly accepted: boolean;
+}
+/** Interrupt requested event (execution paused for external input) */
+export interface InterruptRequestedEvent extends KilnEvent {
+    readonly type: "interrupt_requested";
+    readonly checkpointId: string;
+    readonly reason: string;
+    readonly resumeSchema?: Record<string, unknown>;
+}
+/** Interrupt resumed event (external input provided) */
+export interface InterruptResumedEvent extends KilnEvent {
+    readonly type: "interrupt_resumed";
+    readonly checkpointId: string;
+    readonly resumeValue: unknown;
+}
+/** Injection scanned event (security) */
+export interface InjectionScannedEvent extends KilnEvent {
+    readonly type: "injection_scanned";
+    readonly safe: boolean;
+    readonly threats: number;
+    readonly tier: "heuristic" | "deep";
+    readonly inputPreview: string;
+}
+/** Guardian reviewed event (security) */
+export interface GuardianReviewedEvent extends KilnEvent {
+    readonly type: "guardian_reviewed";
+    readonly approved: boolean;
+    readonly capabilityName: string;
+    readonly agentName: string;
+    readonly riskLevel: string;
+    readonly reason: string;
+}
+/** Audit entry event (security) */
+export interface AuditEntryEvent extends KilnEvent {
+    readonly type: "audit_entry";
+    readonly action: string;
+    readonly actor: string;
+    readonly outcome: string;
+    readonly resource: string;
+}
+/** Tenant isolation violation event (security) */
+export interface TenantIsolationViolationEvent extends KilnEvent {
+    readonly type: "tenant_isolation_violation";
+    readonly tenantId: string;
+    readonly attemptedResource: string;
+    readonly blockedBy: string;
+}
+/** Security alert event */
+export interface SecurityAlertEvent extends KilnEvent {
+    readonly type: "security_alert";
+    readonly severity: "low" | "medium" | "high" | "critical";
+    readonly category: string;
+    readonly message: string;
+}
+/** Webhook received event (trigger) */
+export interface WebhookReceivedEvent extends KilnEvent {
+    readonly type: "webhook_received";
+    readonly path: string;
+    readonly appName: string;
+    readonly triggerName: string;
+    readonly method: string;
+}
+/** Trigger fired event */
+export interface TriggerFiredEvent extends KilnEvent {
+    readonly type: "trigger_fired";
+    readonly triggerName: string;
+    readonly triggerType: string;
+    readonly team: string;
+    readonly task: string;
+}
+/** Trigger failed event */
+export interface TriggerFailedEvent extends KilnEvent {
+    readonly type: "trigger_failed";
+    readonly triggerName: string;
+    readonly triggerType: string;
+    readonly error: string;
+}
+/** Schedule fired event */
+export interface ScheduleFiredEvent extends KilnEvent {
+    readonly type: "schedule_fired";
+    readonly triggerName: string;
+    readonly cron: string;
+    readonly team: string;
+}
+/** PII detected event (safety) */
+export interface PiiDetectedEvent extends KilnEvent {
+    readonly type: "pii_detected";
+    readonly direction: "input" | "output";
+    readonly piiTypes: readonly string[];
+    readonly action: string;
+    readonly count: number;
+    readonly tier: "heuristic" | "deep";
+}
+/** Content classified event (safety) */
+export interface ContentClassifiedEvent extends KilnEvent {
+    readonly type: "content_classified";
+    readonly direction: "input" | "output";
+    readonly categories: Record<string, number>;
+    readonly blocked: boolean;
+    readonly tier: "heuristic" | "deep";
+}
+/** Policy evaluated event (safety) */
+export interface PolicyEvaluatedEvent extends KilnEvent {
+    readonly type: "policy_evaluated";
+    readonly railType: string;
+    readonly allowed: boolean;
+    readonly reason?: string;
+    readonly direction: "input" | "output";
+}
+/** Maps each event type to its corresponding event interface */
+export interface EventMap {
+    phase_changed: PhaseChangedEvent;
+    task_started: TaskStartedEvent;
+    task_completed: TaskCompletedEvent;
+    tool_called: ToolCalledEvent;
+    tool_result: ToolResultEvent;
+    thinking: ThinkingEvent;
+    verification_result: VerificationResultEvent;
+    cost_update: CostUpdateEvent;
+    memory_saved: MemorySavedEvent;
+    memory_recalled: MemoryRecalledEvent;
+    memory_sync: MemorySyncEvent;
+    approval_requested: ApprovalRequestedEvent;
+    approval_received: ApprovalReceivedEvent;
+    worker_assigned: WorkerAssignedEvent;
+    error: ErrorEvent;
+    trace_span: TraceSpanEvent;
+    handoff_requested: HandoffRequestedEvent;
+    handoff_completed: HandoffCompletedEvent;
+    interrupt_requested: InterruptRequestedEvent;
+    interrupt_resumed: InterruptResumedEvent;
+    injection_scanned: InjectionScannedEvent;
+    guardian_reviewed: GuardianReviewedEvent;
+    audit_entry: AuditEntryEvent;
+    tenant_isolation_violation: TenantIsolationViolationEvent;
+    security_alert: SecurityAlertEvent;
+    webhook_received: WebhookReceivedEvent;
+    trigger_fired: TriggerFiredEvent;
+    trigger_failed: TriggerFailedEvent;
+    schedule_fired: ScheduleFiredEvent;
+    pii_detected: PiiDetectedEvent;
+    content_classified: ContentClassifiedEvent;
+    policy_evaluated: PolicyEvaluatedEvent;
+}
+export { EventBus } from "./event-bus.js";
+export type { EventStore } from "./event-store.js";
+export { createTraceContext, startSpan, endSpan, addSpanEvent } from "./trace.js";
+export type { TraceSpan, SpanEvent, TraceContext } from "./trace.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"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"}

package/dist/events/index.js

@@ -0,0 +1,48 @@
+/** Map each event type to its streaming level */
+export const EVENT_LEVEL_MAP = {
+    phase_changed: "phase",
+    approval_requested: "phase",
+    approval_received: "phase",
+    task_started: "phase",
+    task_completed: "phase",
+    tool_called: "tool",
+    tool_result: "tool",
+    thinking: "token",
+    verification_result: "tool",
+    cost_update: "state",
+    memory_saved: "state",
+    memory_recalled: "state",
+    memory_sync: "state",
+    worker_assigned: "phase",
+    error: "phase",
+    trace_span: "state",
+    handoff_requested: "phase",
+    handoff_completed: "phase",
+    interrupt_requested: "phase",
+    interrupt_resumed: "phase",
+    // Security (Phase 3)
+    injection_scanned: "phase",
+    guardian_reviewed: "phase",
+    audit_entry: "state",
+    tenant_isolation_violation: "phase",
+    security_alert: "state",
+    // Triggers (Phase 5)
+    webhook_received: "phase",
+    trigger_fired: "phase",
+    trigger_failed: "phase",
+    schedule_fired: "phase",
+    // Safety (Phase 12)
+    pii_detected: "phase",
+    content_classified: "phase",
+    policy_evaluated: "phase",
+};
+/** Level hierarchy: subscribing to "phase" includes "state" + "phase" */
+export const LEVEL_HIERARCHY = {
+    state: ["state"],
+    phase: ["state", "phase"],
+    tool: ["state", "phase", "tool"],
+    token: ["state", "phase", "tool", "token"],
+};
+export { EventBus } from "./event-bus.js";
+export { createTraceContext, startSpan, endSpan, addSpanEvent } from "./trace.js";
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAKA,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC7D,aAAa,EAAE,OAAO;IACtB,kBAAkB,EAAE,OAAO;IAC3B,iBAAiB,EAAE,OAAO;IAC1B,YAAY,EAAE,OAAO;IACrB,cAAc,EAAE,OAAO;IACvB,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,MAAM;IACnB,QAAQ,EAAE,OAAO;IACjB,mBAAmB,EAAE,MAAM;IAC3B,WAAW,EAAE,OAAO;IACpB,YAAY,EAAE,OAAO;IACrB,eAAe,EAAE,OAAO;IACxB,WAAW,EAAE,OAAO;IACpB,eAAe,EAAE,OAAO;IACxB,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,OAAO;IACnB,iBAAiB,EAAE,OAAO;IAC1B,iBAAiB,EAAE,OAAO;IAC1B,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,OAAO;IAC1B,qBAAqB;IACrB,iBAAiB,EAAE,OAAO;IAC1B,iBAAiB,EAAE,OAAO;IAC1B,WAAW,EAAE,OAAO;IACpB,0BAA0B,EAAE,OAAO;IACnC,cAAc,EAAE,OAAO;IACvB,qBAAqB;IACrB,gBAAgB,EAAE,OAAO;IACzB,aAAa,EAAE,OAAO;IACtB,cAAc,EAAE,OAAO;IACvB,cAAc,EAAE,OAAO;IACvB,oBAAoB;IACpB,YAAY,EAAE,OAAO;IACrB,kBAAkB,EAAE,OAAO;IAC3B,gBAAgB,EAAE,OAAO;CAC1B,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAgD;IAC1E,KAAK,EAAE,CAAC,OAAO,CAAC;IAChB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;CAC3C,CAAC;AA8VF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/events/trace.d.ts

@@ -0,0 +1,30 @@
+export interface TraceSpan {
+    readonly spanId: string;
+    readonly traceId: string;
+    readonly parentSpanId: string | null;
+    readonly name: string;
+    readonly kind: "phase" | "agent" | "tool" | "gate" | "checkpoint";
+    readonly startTime: Date;
+    readonly endTime?: Date;
+    readonly status: "ok" | "error" | "cancelled";
+    readonly attributes: Record<string, string | number | boolean>;
+    readonly events: readonly SpanEvent[];
+}
+export interface SpanEvent {
+    readonly name: string;
+    readonly timestamp: Date;
+    readonly attributes?: Record<string, string | number | boolean>;
+}
+export interface TraceContext {
+    readonly traceId: string;
+    readonly sessionId: string;
+    readonly activeSpanId: string | null;
+}
+export declare function createTraceContext(sessionId: string): TraceContext;
+export declare function startSpan(context: TraceContext, name: string, kind: TraceSpan["kind"], attributes?: Record<string, string | number | boolean>): {
+    span: TraceSpan;
+    childContext: TraceContext;
+};
+export declare function endSpan(span: TraceSpan, status?: TraceSpan["status"]): TraceSpan;
+export declare function addSpanEvent(span: TraceSpan, name: string, attributes?: Record<string, string | number | boolean>): TraceSpan;
+//# sourceMappingURL=trace.d.ts.map

package/dist/events/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/events/trace.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;IAClE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,WAAW,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAMlE;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EACvB,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAM,GACzD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,YAAY,CAAA;CAAE,CAoBjD;AAED,wBAAgB,OAAO,CACrB,IAAI,EAAE,SAAS,EACf,MAAM,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,GAC3B,SAAS,CAMX;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,SAAS,CAWX"}

package/dist/events/trace.js

@@ -0,0 +1,45 @@
+export function createTraceContext(sessionId) {
+    return {
+        traceId: crypto.randomUUID(),
+        sessionId,
+        activeSpanId: null,
+    };
+}
+export function startSpan(context, name, kind, attributes = {}) {
+    const span = {
+        spanId: crypto.randomUUID(),
+        traceId: context.traceId,
+        parentSpanId: context.activeSpanId,
+        name,
+        kind,
+        startTime: new Date(),
+        status: "ok",
+        attributes,
+        events: [],
+    };
+    const childContext = {
+        traceId: context.traceId,
+        sessionId: context.sessionId,
+        activeSpanId: span.spanId,
+    };
+    return { span, childContext };
+}
+export function endSpan(span, status) {
+    return {
+        ...span,
+        endTime: new Date(),
+        status: status ?? span.status,
+    };
+}
+export function addSpanEvent(span, name, attributes) {
+    const event = {
+        name,
+        timestamp: new Date(),
+        attributes,
+    };
+    return {
+        ...span,
+        events: [...span.events, event],
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/events/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/events/trace.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE;QAC5B,SAAS;QACT,YAAY,EAAE,IAAI;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,OAAqB,EACrB,IAAY,EACZ,IAAuB,EACvB,aAAwD,EAAE;IAE1D,MAAM,IAAI,GAAc;QACtB,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE;QAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,IAAI;QACJ,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,MAAM,EAAE,IAAI;QACZ,UAAU;QACV,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,MAAM,YAAY,GAAiB;QACjC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,IAAI,CAAC,MAAM;KAC1B,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,IAAe,EACf,MAA4B;IAE5B,OAAO;QACL,GAAG,IAAI;QACP,OAAO,EAAE,IAAI,IAAI,EAAE;QACnB,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAe,EACf,IAAY,EACZ,UAAsD;IAEtD,MAAM,KAAK,GAAc;QACvB,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,UAAU;KACX,CAAC;IAEF,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;KAChC,CAAC;AACJ,CAAC"}