@bradygaster/squad-sdk 0.8.0 → 0.8.2

package/dist/runtime/event-payloads.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Typed Event Payloads for SquadEventType (Issue #304)
+ *
+ * Canonical payload types for every EventBus event type.
+ * These are the SDK-owned contracts that downstream consumers
+ * (e.g., SquadOffice visualization) depend on.
+ *
+ * @module runtime/event-payloads
+ */
+import type { SquadEventType, SquadEvent } from './event-bus.js';
+export interface SessionCreatedPayload {
+    agentName: string;
+    priority: 'low' | 'normal' | 'high' | 'critical';
+}
+export interface SessionIdlePayload {
+    agentName: string;
+    idleSince?: number;
+}
+export interface SessionErrorPayload {
+    agentName: string;
+    error: string;
+}
+export interface SessionDestroyedPayload {
+    agentName: string;
+    reason?: 'complete' | 'error' | 'abort' | 'timeout' | 'user_exit';
+}
+export interface SessionMessagePayload {
+    message: string;
+    role?: string;
+    content?: string;
+}
+export interface SessionToolCallPayload {
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    resultType?: 'success' | 'failure' | 'rejected' | 'denied';
+}
+/** Multi-phase coordinator routing - discriminated by `phase`. */
+export type CoordinatorRoutingPayload = {
+    phase: 'start';
+    messageLength: number;
+} | {
+    phase: 'routed';
+    agents: string[];
+    confidence: 'high' | 'medium' | 'low';
+    reason: string;
+} | {
+    phase: 'spawning';
+    strategy: 'direct' | 'single' | 'multi' | 'fallback';
+    agentCount: number;
+} | {
+    phase: 'complete';
+    strategy: string;
+    spawnCount: number;
+    successCount: number;
+};
+export type AgentMilestonePayload = {
+    event: 'model.fallback';
+    agentName: string;
+    failedModel: string;
+    failedTier: 'premium' | 'standard' | 'fast';
+    error: string;
+    attemptNumber: number;
+} | {
+    event: 'model.exhausted';
+    agentName: string;
+    originalModel: string;
+    originalTier: string;
+    totalAttempts: number;
+};
+export interface PoolHealthPayload {
+    activeSessions: number;
+    availableSlots: number;
+    queuedRequests: number;
+}
+export interface SquadEventPayloadMap {
+    'session:created': SessionCreatedPayload;
+    'session:idle': SessionIdlePayload;
+    'session:error': SessionErrorPayload;
+    'session:destroyed': SessionDestroyedPayload;
+    'session:message': SessionMessagePayload;
+    'session:tool_call': SessionToolCallPayload;
+    'agent:milestone': AgentMilestonePayload;
+    'coordinator:routing': CoordinatorRoutingPayload;
+    'pool:health': PoolHealthPayload;
+}
+/**
+ * A strongly-typed SquadEvent where the payload type is inferred from the
+ * event type discriminant. Use this for type-safe event construction.
+ */
+export interface TypedSquadEvent<T extends SquadEventType = SquadEventType> {
+    type: T;
+    sessionId?: string;
+    agentName?: string;
+    payload: T extends keyof SquadEventPayloadMap ? SquadEventPayloadMap[T] : unknown;
+    timestamp: Date;
+}
+/**
+ * Type guard: narrows a SquadEvent to a specific typed event.
+ */
+export declare function isSquadEventOfType<T extends SquadEventType>(event: SquadEvent, type: T): event is TypedSquadEvent<T>;
+/**
+ * Helper to construct a typed SquadEvent with payload validation at compile time.
+ */
+export declare function createSquadEvent<T extends SquadEventType>(type: T, payload: T extends keyof SquadEventPayloadMap ? SquadEventPayloadMap[T] : unknown, options?: {
+    sessionId?: string;
+    agentName?: string;
+}): TypedSquadEvent<T>;
+//# sourceMappingURL=event-payloads.d.ts.map

package/dist/runtime/event-payloads.d.ts.map

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

package/dist/runtime/event-payloads.js

@@ -0,0 +1,28 @@
+/**
+ * Typed Event Payloads for SquadEventType (Issue #304)
+ *
+ * Canonical payload types for every EventBus event type.
+ * These are the SDK-owned contracts that downstream consumers
+ * (e.g., SquadOffice visualization) depend on.
+ *
+ * @module runtime/event-payloads
+ */
+/**
+ * Type guard: narrows a SquadEvent to a specific typed event.
+ */
+export function isSquadEventOfType(event, type) {
+    return event.type === type;
+}
+/**
+ * Helper to construct a typed SquadEvent with payload validation at compile time.
+ */
+export function createSquadEvent(type, payload, options) {
+    return {
+        type,
+        sessionId: options?.sessionId,
+        agentName: options?.agentName,
+        payload,
+        timestamp: new Date(),
+    };
+}
+//# sourceMappingURL=event-payloads.js.map

package/dist/runtime/event-payloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-payloads.js","sourceRoot":"","sources":["../../src/runtime/event-payloads.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsHH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAiB,EACjB,IAAO;IAEP,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAO,EACP,OAAiF,EACjF,OAAoD;IAEpD,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/dist/runtime/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/runtime/health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAE7C,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IAExB,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IAEnB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,6BAA6B;IAC7B,SAAS,EAAE,IAAI,CAAC;IAEhB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,MAAM,EAAE,WAAW,CAAC;IAEpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAU;gBAEpB,MAAM,EAAE,mBAAmB;IAMvC;;;;;;;;;;OAUG;IACG,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAgDzC;;;;OAIG;IACH,SAAS,IAAI,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,iBAAiB,GAAG,WAAW,GAAG,WAAW,CAAC;IAqB9F;;OAEG;IACH,OAAO,CAAC,aAAa;CAQtB"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/runtime/health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAE7C,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IAExB,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IAEnB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,6BAA6B;IAC7B,SAAS,EAAE,IAAI,CAAC;IAEhB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,MAAM,EAAE,WAAW,CAAC;IAEpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAU;gBAEpB,MAAM,EAAE,mBAAmB;IAMvC;;;;;;;;;;OAUG;IACG,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAgDzC;;;;OAIG;IACH,SAAS,IAAI,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,iBAAiB,GAAG,WAAW,GAAG,WAAW,CAAC;IAqB9F;;OAEG;IACH,OAAO,CAAC,aAAa;CAQtB"}

package/dist/runtime/health.js

@@ -4,6 +4,7 @@
  * Monitors the health of SquadClient connections and provides diagnostics.
  * Exposes health status for external monitoring and startup validation.
  */
+import { TIMEOUTS } from './constants.js';
 /**
  * Health Monitor for SquadClient connections.
  *
@@ -16,7 +17,7 @@ export class HealthMonitor {
     logDiagnostics;
     constructor(config) {
         this.client = config.client;
-        this.timeout = config.timeout ?? 5000;
+        this.timeout = config.timeout ?? TIMEOUTS.HEALTH_CHECK_MS;
         this.logDiagnostics = config.logDiagnostics ?? true;
     }
     /**

package/dist/runtime/health.js.map

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

package/dist/runtime/otel-bridge.d.ts

@@ -0,0 +1,52 @@
+/**
+ * OTel Bridge for TelemetryCollector (Issue #256)
+ *
+ * Converts TelemetryEvents into OpenTelemetry spans, providing a
+ * TelemetryTransport that can be registered via setTelemetryTransport().
+ * Additive — the existing transport pipeline is unaffected.
+ *
+ * @module runtime/otel-bridge
+ */
+import type { TelemetryTransport } from './telemetry.js';
+import type { EventBus, UnsubscribeFn } from './event-bus.js';
+/**
+ * Create a TelemetryTransport that emits OTel spans for each event.
+ *
+ * Usage:
+ * ```ts
+ * import { setTelemetryTransport } from './telemetry.js';
+ * import { createOTelTransport } from './otel-bridge.js';
+ *
+ * setTelemetryTransport(createOTelTransport());
+ * ```
+ *
+ * The bridge ignores the `endpoint` parameter — OTel exporter config is
+ * managed by the OTel provider initialized via `initializeOTel()`.
+ */
+export declare function createOTelTransport(): TelemetryTransport;
+/**
+ * Subscribe an {@link EventBus} to OpenTelemetry, creating a span for every
+ * event that flows through the bus.
+ *
+ * This is the **mid-level** OTel integration point — it wires the Squad
+ * event bus directly into the OTel trace pipeline. If no `TracerProvider`
+ * has been registered (e.g. via {@link initializeOTel}), all spans are
+ * automatically no-ops with zero overhead.
+ *
+ * @param bus - The EventBus instance to bridge.
+ * @returns An unsubscribe function. Call it to detach the bridge.
+ *
+ * @example
+ * ```ts
+ * import { EventBus, initializeOTel, bridgeEventBusToOTel } from 'squad-sdk';
+ *
+ * const bus = new EventBus();
+ * initializeOTel({ endpoint: 'http://localhost:4318' });
+ * const detach = bridgeEventBusToOTel(bus);
+ *
+ * // Later, to stop bridging:
+ * detach();
+ * ```
+ */
+export declare function bridgeEventBusToOTel(bus: EventBus): UnsubscribeFn;
+//# sourceMappingURL=otel-bridge.d.ts.map

package/dist/runtime/otel-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-bridge.d.ts","sourceRoot":"","sources":["../../src/runtime/otel-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAkB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAsE1E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,CAMxD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,GAAG,aAAa,CAejE"}

package/dist/runtime/otel-bridge.js

@@ -0,0 +1,132 @@
+/**
+ * OTel Bridge for TelemetryCollector (Issue #256)
+ *
+ * Converts TelemetryEvents into OpenTelemetry spans, providing a
+ * TelemetryTransport that can be registered via setTelemetryTransport().
+ * Additive — the existing transport pipeline is unaffected.
+ *
+ * @module runtime/otel-bridge
+ */
+import { SpanStatusCode } from '@opentelemetry/api';
+import { getTracer } from './otel.js';
+// ============================================================================
+// Span mapping
+// ============================================================================
+function recordSpan(event) {
+    const tracer = getTracer('squad-sdk');
+    const attrs = {};
+    if (event.properties) {
+        for (const [k, v] of Object.entries(event.properties)) {
+            attrs[k] = v;
+        }
+    }
+    if (event.timestamp) {
+        attrs['event.timestamp'] = event.timestamp;
+    }
+    switch (event.name) {
+        case 'squad.init': {
+            const span = tracer.startSpan('squad.init', { attributes: attrs });
+            span.end();
+            break;
+        }
+        case 'squad.agent.spawn': {
+            const span = tracer.startSpan('squad.agent.spawn', { attributes: attrs });
+            span.end();
+            break;
+        }
+        case 'squad.error': {
+            const span = tracer.startSpan('squad.error', { attributes: attrs });
+            span.setStatus({ code: SpanStatusCode.ERROR, message: String(attrs['error'] ?? 'unknown') });
+            span.addEvent('exception', {
+                'exception.message': String(attrs['error'] ?? attrs['message'] ?? 'unknown error'),
+                ...(attrs['stack'] ? { 'exception.stacktrace': String(attrs['stack']) } : {}),
+            });
+            span.end();
+            break;
+        }
+        case 'squad.run': {
+            // Root span for the entire session — start and immediately end
+            // (the real duration would be managed by the caller if needed)
+            const span = tracer.startSpan('squad.run', { attributes: attrs });
+            span.end();
+            break;
+        }
+        case 'squad.upgrade': {
+            const span = tracer.startSpan('squad.upgrade', { attributes: attrs });
+            span.end();
+            break;
+        }
+        default: {
+            // Forward unknown events as generic spans
+            const span = tracer.startSpan(event.name, { attributes: attrs });
+            span.end();
+            break;
+        }
+    }
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Create a TelemetryTransport that emits OTel spans for each event.
+ *
+ * Usage:
+ * ```ts
+ * import { setTelemetryTransport } from './telemetry.js';
+ * import { createOTelTransport } from './otel-bridge.js';
+ *
+ * setTelemetryTransport(createOTelTransport());
+ * ```
+ *
+ * The bridge ignores the `endpoint` parameter — OTel exporter config is
+ * managed by the OTel provider initialized via `initializeOTel()`.
+ */
+export function createOTelTransport() {
+    return async (events, _endpoint) => {
+        for (const event of events) {
+            recordSpan(event);
+        }
+    };
+}
+/**
+ * Subscribe an {@link EventBus} to OpenTelemetry, creating a span for every
+ * event that flows through the bus.
+ *
+ * This is the **mid-level** OTel integration point — it wires the Squad
+ * event bus directly into the OTel trace pipeline. If no `TracerProvider`
+ * has been registered (e.g. via {@link initializeOTel}), all spans are
+ * automatically no-ops with zero overhead.
+ *
+ * @param bus - The EventBus instance to bridge.
+ * @returns An unsubscribe function. Call it to detach the bridge.
+ *
+ * @example
+ * ```ts
+ * import { EventBus, initializeOTel, bridgeEventBusToOTel } from 'squad-sdk';
+ *
+ * const bus = new EventBus();
+ * initializeOTel({ endpoint: 'http://localhost:4318' });
+ * const detach = bridgeEventBusToOTel(bus);
+ *
+ * // Later, to stop bridging:
+ * detach();
+ * ```
+ */
+export function bridgeEventBusToOTel(bus) {
+    return bus.subscribeAll((event) => {
+        const tracer = getTracer('squad-sdk');
+        const attrs = {
+            'event.type': event.type,
+        };
+        if (event.sessionId)
+            attrs['session.id'] = event.sessionId;
+        if (event.agentName)
+            attrs['agent.name'] = event.agentName;
+        const span = tracer.startSpan(`squad.${event.type}`, { attributes: attrs });
+        if (event.type === 'session:error') {
+            span.setStatus({ code: SpanStatusCode.ERROR });
+        }
+        span.end();
+    });
+}
+//# sourceMappingURL=otel-bridge.js.map

package/dist/runtime/otel-bridge.js.map

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

package/dist/runtime/otel-init.d.ts

@@ -0,0 +1,72 @@
+/**
+ * High-Level OTel Initialization (Issue #266)
+ *
+ * One-call setup that wires OTel providers, the EventBus bridge, and
+ * the TelemetryCollector transport in a single invocation. Consumers
+ * who don't use OTel pay nothing — if no provider is registered all
+ * instrumentation is a no-op.
+ *
+ * @module runtime/otel-init
+ */
+import type { OTelConfig } from './otel.js';
+import type { EventBus } from './event-bus.js';
+/** Options for the high-level {@link initSquadTelemetry} helper. */
+export interface SquadTelemetryOptions extends OTelConfig {
+    /**
+     * When provided, all EventBus events are automatically forwarded
+     * as OTel spans via {@link bridgeEventBusToOTel}.
+     */
+    eventBus?: EventBus;
+    /**
+     * When `true`, the OTel-backed TelemetryTransport is registered
+     * as the active transport for {@link TelemetryCollector}.
+     * @default true
+     */
+    installTransport?: boolean;
+}
+/** Handle returned by {@link initSquadTelemetry} for lifecycle control. */
+export interface SquadTelemetryHandle {
+    /** Whether tracing was activated. */
+    tracing: boolean;
+    /** Whether metrics were activated. */
+    metrics: boolean;
+    /**
+     * Flush pending telemetry, detach the EventBus bridge (if any),
+     * and shut down OTel providers. Safe to call multiple times.
+     */
+    shutdown: () => Promise<void>;
+}
+/**
+ * One-call OTel setup for Squad SDK consumers.
+ *
+ * This is the **high-level** entry point. It:
+ * 1. Initializes tracing and metrics via `initializeOTel()`.
+ * 2. Optionally bridges an {@link EventBus} so every Squad event
+ *    becomes an OTel span.
+ * 3. Optionally installs an OTel-backed `TelemetryTransport` so
+ *    the existing `TelemetryCollector` pipeline emits spans too.
+ *
+ * If no `OTEL_EXPORTER_OTLP_ENDPOINT` env var is set **and** no
+ * `endpoint` is provided in `options`, everything remains a no-op.
+ *
+ * @param options - Configuration and optional EventBus.
+ * @returns A handle with `tracing`, `metrics` status booleans and a
+ *          `shutdown()` method for graceful cleanup.
+ *
+ * @example
+ * ```ts
+ * import { initSquadTelemetry, EventBus } from 'squad-sdk';
+ *
+ * const bus = new EventBus();
+ * const telemetry = initSquadTelemetry({
+ *   endpoint: 'http://localhost:4318',
+ *   eventBus: bus,
+ * });
+ *
+ * // … run your squad …
+ *
+ * await telemetry.shutdown();
+ * ```
+ */
+export declare function initSquadTelemetry(options?: SquadTelemetryOptions): SquadTelemetryHandle;
+//# sourceMappingURL=otel-init.d.ts.map

package/dist/runtime/otel-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-init.d.ts","sourceRoot":"","sources":["../../src/runtime/otel-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAU/C,oEAAoE;AACpE,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,qBAA0B,GAAG,oBAAoB,CAsB5F"}

package/dist/runtime/otel-init.js

@@ -0,0 +1,68 @@
+/**
+ * High-Level OTel Initialization (Issue #266)
+ *
+ * One-call setup that wires OTel providers, the EventBus bridge, and
+ * the TelemetryCollector transport in a single invocation. Consumers
+ * who don't use OTel pay nothing — if no provider is registered all
+ * instrumentation is a no-op.
+ *
+ * @module runtime/otel-init
+ */
+import { initializeOTel, shutdownOTel } from './otel.js';
+import { bridgeEventBusToOTel, createOTelTransport } from './otel-bridge.js';
+import { setTelemetryTransport } from './telemetry.js';
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * One-call OTel setup for Squad SDK consumers.
+ *
+ * This is the **high-level** entry point. It:
+ * 1. Initializes tracing and metrics via `initializeOTel()`.
+ * 2. Optionally bridges an {@link EventBus} so every Squad event
+ *    becomes an OTel span.
+ * 3. Optionally installs an OTel-backed `TelemetryTransport` so
+ *    the existing `TelemetryCollector` pipeline emits spans too.
+ *
+ * If no `OTEL_EXPORTER_OTLP_ENDPOINT` env var is set **and** no
+ * `endpoint` is provided in `options`, everything remains a no-op.
+ *
+ * @param options - Configuration and optional EventBus.
+ * @returns A handle with `tracing`, `metrics` status booleans and a
+ *          `shutdown()` method for graceful cleanup.
+ *
+ * @example
+ * ```ts
+ * import { initSquadTelemetry, EventBus } from 'squad-sdk';
+ *
+ * const bus = new EventBus();
+ * const telemetry = initSquadTelemetry({
+ *   endpoint: 'http://localhost:4318',
+ *   eventBus: bus,
+ * });
+ *
+ * // … run your squad …
+ *
+ * await telemetry.shutdown();
+ * ```
+ */
+export function initSquadTelemetry(options = {}) {
+    const { eventBus, installTransport = true, ...otelConfig } = options;
+    const result = initializeOTel(otelConfig);
+    let unsubscribeBridge;
+    if (eventBus) {
+        unsubscribeBridge = bridgeEventBusToOTel(eventBus);
+    }
+    if (installTransport) {
+        setTelemetryTransport(createOTelTransport());
+    }
+    return {
+        tracing: result.tracing,
+        metrics: result.metrics,
+        shutdown: async () => {
+            unsubscribeBridge?.();
+            await shutdownOTel();
+        },
+    };
+}
+//# sourceMappingURL=otel-init.js.map

package/dist/runtime/otel-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-init.js","sourceRoot":"","sources":["../../src/runtime/otel-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAmCvD,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAiC,EAAE;IACpE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAErE,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAE1C,IAAI,iBAA4C,CAAC;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,iBAAiB,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,qBAAqB,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,KAAK,IAAI,EAAE;YACnB,iBAAiB,EAAE,EAAE,CAAC;YACtB,MAAM,YAAY,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/otel-metrics.d.ts

@@ -0,0 +1,42 @@
+/**
+ * OTel Metrics (Issues #261, #262, #263, #264)
+ *
+ * Provides counters, histograms, and gauges for token usage,
+ * agent performance, session pool, and response latency.
+ * No-op when OTel is not configured (getMeter returns a no-op meter).
+ *
+ * @module runtime/otel-metrics
+ */
+import type { UsageEvent } from './streaming.js';
+/**
+ * Record token usage from a UsageEvent.
+ * Safe to call when OTel is not configured — metrics are no-ops.
+ */
+export declare function recordTokenUsage(event: UsageEvent): void;
+/** Record an agent spawn event. */
+export declare function recordAgentSpawn(agentName: string, mode?: string): void;
+/** Record agent task completion with duration. */
+export declare function recordAgentDuration(agentName: string, durationMs: number, status?: 'success' | 'error'): void;
+/** Record an agent error. */
+export declare function recordAgentError(agentName: string, errorType: string): void;
+/** Record agent session destruction (decrements active count). */
+export declare function recordAgentDestroy(agentName: string): void;
+/** Record a new session being created. */
+export declare function recordSessionCreated(): void;
+/** Record a session becoming idle. */
+export declare function recordSessionIdle(): void;
+/** Record an idle session becoming active again. */
+export declare function recordSessionReactivated(): void;
+/** Record a session being closed. */
+export declare function recordSessionClosed(): void;
+/** Record a session error. */
+export declare function recordSessionError(): void;
+/** Record time to first token. */
+export declare function recordTimeToFirstToken(ttftMs: number): void;
+/** Record total response duration. */
+export declare function recordResponseDuration(durationMs: number): void;
+/** Record streaming throughput. */
+export declare function recordTokensPerSecond(tokensPerSec: number): void;
+/** Reset all cached metric instances. Used in tests only. */
+export declare function _resetMetrics(): void;
+//# sourceMappingURL=otel-metrics.d.ts.map

package/dist/runtime/otel-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-metrics.d.ts","sourceRoot":"","sources":["../../src/runtime/otel-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAwCjD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAUxD;AAqCD,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,MAAe,GAAG,IAAI,CAI/E;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,GAAG,OAAmB,GAAG,IAAI,CAMxH;AAED,6BAA6B;AAC7B,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAG3E;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAG1D;AAwCD,0CAA0C;AAC1C,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAED,oDAAoD;AACpD,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,8BAA8B;AAC9B,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAmCD,kCAAkC;AAClC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAG3D;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAG/D;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAGhE;AAMD,6DAA6D;AAC7D,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}