autotel-cloudflare 2.18.18 → 2.19.0

package/dist/agents.d.ts

@@ -1,50 +1,47 @@
-import { ConfigurationOption } from 'autotel-edge';
-import { Attributes } from '@opentelemetry/api';
-
-/**
- * Type definitions for Cloudflare Agents SDK observability integration
- */
+import { ConfigurationOption } from "autotel-edge";
+import { Attributes } from "@opentelemetry/api";
 
+//#region src/agents/types.d.ts
 /**
  * Base event structure from Agents SDK (mirrors agents/src/observability/base.ts)
  */
 interface BaseAgentEvent<T extends string, Payload extends Record<string, unknown> = Record<string, unknown>> {
-    type: T;
-    /** Unique identifier for the event */
-    id: string;
-    /** Human-readable message for logging */
-    displayMessage: string;
-    /** Event payload with type-specific data */
-    payload: Payload & Record<string, unknown>;
-    /** Timestamp in milliseconds since epoch */
-    timestamp: number;
+  type: T;
+  /** Unique identifier for the event */
+  id: string;
+  /** Human-readable message for logging */
+  displayMessage: string;
+  /** Event payload with type-specific data */
+  payload: Payload & Record<string, unknown>;
+  /** Timestamp in milliseconds since epoch */
+  timestamp: number;
 }
 /**
  * Agent-specific observability events
  */
 type AgentObservabilityEvent = BaseAgentEvent<'state:update', Record<string, unknown>> | BaseAgentEvent<'rpc', {
-    method: string;
-    streaming?: boolean;
+  method: string;
+  streaming?: boolean;
 }> | BaseAgentEvent<'message:request' | 'message:response', Record<string, unknown>> | BaseAgentEvent<'message:clear'> | BaseAgentEvent<'schedule:create' | 'schedule:execute' | 'schedule:cancel', {
-    callback: string;
-    id: string;
+  callback: string;
+  id: string;
 }> | BaseAgentEvent<'destroy'> | BaseAgentEvent<'connect', {
-    connectionId: string;
+  connectionId: string;
 }>;
 /**
  * MCP-specific observability events
  */
 type MCPObservabilityEvent = BaseAgentEvent<'mcp:client:preconnect', {
-    serverId: string;
+  serverId: string;
 }> | BaseAgentEvent<'mcp:client:connect', {
-    url: string;
-    transport: string;
-    state: string;
-    error?: string;
+  url: string;
+  transport: string;
+  state: string;
+  error?: string;
 }> | BaseAgentEvent<'mcp:client:authorize', {
-    serverId: string;
-    authUrl: string;
-    clientId?: string;
+  serverId: string;
+  authUrl: string;
+  clientId?: string;
 }> | BaseAgentEvent<'mcp:client:discover', Record<string, unknown>>;
 /**
  * Union of all observability event types
@@ -54,107 +51,83 @@ type ObservabilityEvent = AgentObservabilityEvent | MCPObservabilityEvent;
  * Observability interface from Agents SDK
  */
 interface Observability {
-    /**
-     * Emit an event for the Agent's observability implementation to handle.
-     * @param event - The event to emit
-     * @param ctx - The execution context of the invocation (optional)
-     */
-    emit(event: ObservabilityEvent, ctx?: DurableObjectState): void;
+  /**
+   * Emit an event for the Agent's observability implementation to handle.
+   * @param event - The event to emit
+   * @param ctx - The execution context of the invocation (optional)
+   */
+  emit(event: ObservabilityEvent, ctx?: DurableObjectState): void;
 }
 /**
  * Agent-specific instrumentation options
  */
 interface AgentInstrumentationOptions {
-    /**
-     * Whether to create spans for RPC calls
-     * @default true
-     */
-    traceRpc?: boolean;
-    /**
-     * Whether to create spans for schedule operations
-     * @default true
-     */
-    traceSchedule?: boolean;
-    /**
-     * Whether to create spans for MCP operations
-     * @default true
-     */
-    traceMcp?: boolean;
-    /**
-     * Whether to create spans for state updates
-     * @default false (can be noisy)
-     */
-    traceStateUpdates?: boolean;
-    /**
-     * Whether to create spans for message events
-     * @default true
-     */
-    traceMessages?: boolean;
-    /**
-     * Whether to create spans for connect/destroy lifecycle events
-     * @default true
-     */
-    traceLifecycle?: boolean;
-    /**
-     * Custom attribute extractor for events
-     */
-    attributeExtractor?: (event: ObservabilityEvent) => Attributes;
-    /**
-     * Custom span name formatter
-     */
-    spanNameFormatter?: (event: ObservabilityEvent) => string;
+  /**
+   * Whether to create spans for RPC calls
+   * @default true
+   */
+  traceRpc?: boolean;
+  /**
+   * Whether to create spans for schedule operations
+   * @default true
+   */
+  traceSchedule?: boolean;
+  /**
+   * Whether to create spans for MCP operations
+   * @default true
+   */
+  traceMcp?: boolean;
+  /**
+   * Whether to create spans for state updates
+   * @default false (can be noisy)
+   */
+  traceStateUpdates?: boolean;
+  /**
+   * Whether to create spans for message events
+   * @default true
+   */
+  traceMessages?: boolean;
+  /**
+   * Whether to create spans for connect/destroy lifecycle events
+   * @default true
+   */
+  traceLifecycle?: boolean;
+  /**
+   * Custom attribute extractor for events
+   */
+  attributeExtractor?: (event: ObservabilityEvent) => Attributes;
+  /**
+   * Custom span name formatter
+   */
+  spanNameFormatter?: (event: ObservabilityEvent) => string;
 }
 /**
  * Configuration for OtelObservability
  */
 type OtelObservabilityConfig = ConfigurationOption & {
-    /**
-     * Agent-specific instrumentation options
-     */
-    agents?: AgentInstrumentationOptions;
+  /**
+   * Agent-specific instrumentation options
+   */
+  agents?: AgentInstrumentationOptions;
 };
 /**
  * Semantic attributes for Agent spans
  */
 interface AgentSpanAttributes {
-    'agent.event.type': string;
-    'agent.event.id': string;
-    'agent.rpc.method'?: string;
-    'agent.rpc.streaming'?: boolean;
-    'agent.schedule.callback'?: string;
-    'agent.schedule.id'?: string;
-    'agent.connection.id'?: string;
-    'agent.mcp.server_id'?: string;
-    'agent.mcp.url'?: string;
-    'agent.mcp.transport'?: string;
-    'agent.mcp.state'?: string;
+  'agent.event.type': string;
+  'agent.event.id': string;
+  'agent.rpc.method'?: string;
+  'agent.rpc.streaming'?: boolean;
+  'agent.schedule.callback'?: string;
+  'agent.schedule.id'?: string;
+  'agent.connection.id'?: string;
+  'agent.mcp.server_id'?: string;
+  'agent.mcp.url'?: string;
+  'agent.mcp.transport'?: string;
+  'agent.mcp.state'?: string;
 }
-
-/**
- * OpenTelemetry-based Observability implementation for Cloudflare Agents SDK
- *
- * Converts Agent events into OpenTelemetry spans for distributed tracing.
- *
- * @example
- * ```typescript
- * import { Agent } from 'agents'
- * import { createOtelObservability } from 'autotel-cloudflare/agents'
- *
- * class MyAgent extends Agent<Env> {
- *   observability = createOtelObservability({
- *     service: { name: 'my-agent' },
- *     exporter: { url: env.OTLP_ENDPOINT }
- *   })
- *
- *   @callable()
- *   async doSomething() {
- *     // This RPC call will be automatically traced
- *     return 'done'
- *   }
- * }
- * ```
- */
-
+//#endregion
+//#region src/agents/otel-observability.d.ts
 /**
  * OpenTelemetry-based Observability implementation
  *
@@ -162,20 +135,20 @@ interface AgentSpanAttributes {
  * events into OpenTelemetry spans.
  */
 declare class OtelObservability implements Observability {
-    private config;
-    private options;
-    private initialized;
-    constructor(config: OtelObservabilityConfig);
-    /**
-     * Initialize the tracer provider (called lazily on first emit)
-     */
-    private initialize;
-    /**
-     * Emit an observability event
-     *
-     * Converts the event to an OpenTelemetry span based on the event type.
-     */
-    emit(event: ObservabilityEvent, ctx?: DurableObjectState): void;
+  private config;
+  private options;
+  private initialized;
+  constructor(config: OtelObservabilityConfig);
+  /**
+   * Initialize the tracer provider (called lazily on first emit)
+   */
+  private initialize;
+  /**
+   * Emit an observability event
+   *
+   * Converts the event to an OpenTelemetry span based on the event type.
+   */
+  emit(event: ObservabilityEvent, ctx?: DurableObjectState): void;
 }
 /**
  * Create an OtelObservability instance
@@ -215,5 +188,6 @@ declare function createOtelObservability(config: OtelObservabilityConfig): OtelO
  * ```
  */
 declare function createOtelObservabilityFromEnv(env: Record<string, unknown>, options?: AgentInstrumentationOptions): OtelObservability;
-
+//#endregion
 export { type AgentInstrumentationOptions, type AgentObservabilityEvent, type AgentSpanAttributes, type MCPObservabilityEvent, type Observability, type ObservabilityEvent, OtelObservability, type OtelObservabilityConfig, createOtelObservability, createOtelObservabilityFromEnv };
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","names":[],"sources":["../src/agents/types.ts","../src/agents/otel-observability.ts"],"mappings":";;;;;;;UAUiB,cAAA,mCAEC,MAAA,oBAA0B,MAAA;EAE1C,IAAA,EAAM,CAAA;EAMG;EAJT,EAAA;EAIyB;EAFzB,cAAA;EAPA;EASA,OAAA,EAAS,OAAA,GAAU,MAAA;EARH;EAUhB,SAAA;AAAA;;;;KAMU,uBAAA,GACR,cAAA,iBAA+B,MAAA,qBAC/B,cAAA;EAGI,MAAA;EACA,SAAA;AAAA,KAGJ,cAAA,yCAAuD,MAAA,qBACvD,cAAA,oBACA,cAAA;EAGI,QAAA;EACA,EAAA;AAAA,KAGJ,cAAA,cACA,cAAA;EAGI,YAAA;AAAA;;;;KAOI,qBAAA,GACR,cAAA;EAA0C,QAAA;AAAA,KAC1C,cAAA;EAEI,GAAA;EAAa,SAAA;EAAmB,KAAA;EAAe,KAAA;AAAA,KAEnD,cAAA;EAGI,QAAA;EACA,OAAA;EACA,QAAA;AAAA,KAGJ,cAAA,wBAAsC,MAAA;;;;KAK9B,kBAAA,GAAqB,uBAAA,GAA0B,qBAAqB;;;;UAK/D,aAAA;EAlCb;;;AAGgB;AAOpB;EA8BE,IAAA,CAAK,KAAA,EAAO,kBAAA,EAAoB,GAAA,GAAM,kBAAkB;AAAA;;;;UAMzC,2BAAA;EAtBb;;;;EA2BF,QAAA;EAvCE;;;;EA6CF,aAAA;EAzCE;;;;EA+CF,QAAA;EAvCwC;;AAAM;AAKhD;EAwCE,iBAAA;;;AAxC8E;AAKhF;EAyCE,aAAA;;;;;EAMA,cAAA;EAzCsC;;;EA8CtC,kBAAA,IAAsB,KAAA,EAAO,kBAAA,KAAuB,UAAA;EAxCrC;;;EA6Cf,iBAAA,IAAqB,KAAA,EAAO,kBAAA;AAAA;;;;KAMlB,uBAAA,GAA0B,mBAAA;EAxCpC;;;EA4CA,MAAA,GAAS,2BAA2B;AAAA;;;;UAMrB,mBAAA;EACf,kBAAA;EACA,gBAAA;EACA,kBAAA;EACA,qBAAA;EACA,yBAAA;EACA,mBAAA;EACA,qBAAA;EACA,qBAAA;EACA,eAAA;EACA,qBAAA;EACA,iBAAA;AAAA;;;;;AA/IS;AAMX;;;cCwSa,iBAAA,YAA6B,aAAA;EAAA,QAChC,MAAA;EAAA,QACA,OAAA;EAAA,QACA,WAAA;cAEI,MAAA,EAAQ,uBAAA;EDnSlB;;;EAAA,QC6SM,UAAA;EDpSQ;;;;;EC+ShB,IAAA,CAAK,KAAA,EAAO,kBAAA,EAAoB,GAAA,GAAM,kBAAA;AAAA;;;;;;;;;;;AD5SpB;AAOpB;;;;;iBC0WgB,uBAAA,CAAwB,MAAA,EAAQ,uBAAA,GAA0B,iBAAiB;;;;;;;;;;;;;;;;;;;AD5V3C;AAKhD;iBC+WgB,8BAAA,CACd,GAAA,EAAK,MAAA,mBACL,OAAA,GAAU,2BAAA,GACT,iBAAA"}