@economic/agents 3.2.1 → 3.3.0

package/dist/index.d.mts

@@ -12,6 +12,7 @@ import { EventEmitter } from "node:events";
 import { TaskHandlers, TaskStep, TaskValue } from "agents/tasks";
 import { JSONWebKeySet, JWTPayload } from "jose";
 import { ReadableSpan } from "@opentelemetry/sdk-trace-base";
+import { Context, Span, SpanOptions, Tracer } from "@opentelemetry/api";
 import { Observability, ObservabilityEvent } from "agents/observability";
 import { Streams } from "agents/streams";
 //#region src/extensions/types.d.ts
@@ -13359,4 +13360,24 @@ export declare class AnalyticsHandler implements TracingHandler {
   handle(event: TracingEvent): Promise<void>;
   private _events;
 }
+export declare const TURN_SPAN_NAME = "ai.streamText";
+/**
+ * Starts every span of a turn as a child of the turn's `ai.streamText` span.
+ *
+ * The `ai` SDK takes a span's parent from OpenTelemetry's active context, and
+ * nothing tracks that here, so each of its spans would otherwise start a trace
+ * of its own. A tracer is created per turn, so the turn span is known. With a
+ * `parent`, the turn span itself starts under that span, e.g. the first turn
+ * of the exchange it continues.
+ */
+export declare class TurnTracer implements Tracer {
+  private readonly tracer;
+  private readonly parent?;
+  private turnSpan?;
+  constructor(tracer: Tracer, parent?: SpanIds | undefined);
+  startSpan(name: string, options?: SpanOptions, ctx?: Context): Span;
+  startActiveSpan<F extends (span: Span) => unknown>(name: string, fn: F): ReturnType<F>;
+  startActiveSpan<F extends (span: Span) => unknown>(name: string, options: SpanOptions, fn: F): ReturnType<F>;
+  startActiveSpan<F extends (span: Span) => unknown>(name: string, options: SpanOptions, ctx: Context, fn: F): ReturnType<F>;
+}
 export { type Action, type ActionContext, type AgentConfig, type AgentConnectionStatus, type AgentConnectionType, type AgentEnv, type Auth, type Authenticator, type Claims, type Credential, type CredentialProvider, type Identity, type InvocableSkill, type JwtAuthenticatorOptions, type JwtOptions, type RegisteredAction, type RunResult, type Skill, type SkillActivation, type SkillInvoked, type SkillSource, type TokenExchangeOptions, type Tool, type ToolContext, type ToolSet, type TracedFeedback, type TracedSpan, type TracedTurn, type TracingEvent, type TracingHandler, type TurnEnded, type TurnInspection, type TurnSnapshot, type TurnStarted, type UnauthorizedPolicy, getCurrentAgent };

package/dist/index.mjs

@@ -69881,7 +69881,7 @@ var TurnTracer = class {
 		this.parent = parent;
 	}
 	startSpan(name, options, ctx = context.active()) {
-		if (name === TURN_SPAN_NAME) {
+		if (name === "ai.streamText") {
 			const parent = this.parent && {
 				traceId: this.parent.traceId,
 				spanId: this.parent.spanId,
@@ -74311,4 +74311,4 @@ function createEvent(event, payload) {
 		actorId: event.actorId
 	};
 }
-export { Agent, AnalyticsHandler, Assistant, AuditLogHandler, AuthenticationError, ChatAgent, TokenExchange, TokenExchangeError, UserStore, action, bearerToken, file, getCurrentAgent, jwtAuthenticator, routeAgentRequest, skill, tool, verifyJwt };
+export { Agent, AnalyticsHandler, Assistant, AuditLogHandler, AuthenticationError, ChatAgent, TURN_SPAN_NAME, TokenExchange, TokenExchangeError, TurnTracer, UserStore, action, bearerToken, file, getCurrentAgent, jwtAuthenticator, routeAgentRequest, skill, tool, verifyJwt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@economic/agents",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "A starter for creating a TypeScript package.",
   "license": "MIT",
   "files": [