@zhivex-ai/core 1.5.0 → 1.7.0

package/dist/runtime.js

@@ -27,22 +27,49 @@ const isRetryableError = (error) => {
     }
     return false;
 };
-export const mergeAbortSignals = (...signals) => {
-    const activeSignals = signals.filter(Boolean);
+export const createMergedAbortSignal = (...signals) => {
+    const activeSignals = [...new Set(signals.filter((signal) => signal !== undefined))];
     if (!activeSignals.length) {
-        return undefined;
+        return { signal: undefined, cleanup: () => undefined };
+    }
+    if (activeSignals.length === 1) {
+        return { signal: activeSignals[0], cleanup: () => undefined };
+    }
+    const abortSignalWithAny = AbortSignal;
+    if (typeof abortSignalWithAny.any === "function") {
+        return {
+            signal: abortSignalWithAny.any(activeSignals),
+            cleanup: () => undefined
+        };
     }
     const controller = new AbortController();
-    const abort = () => controller.abort();
+    const listeners = new Map();
+    const cleanup = () => {
+        for (const [signal, listener] of listeners) {
+            signal.removeEventListener("abort", listener);
+        }
+        listeners.clear();
+    };
     for (const signal of activeSignals) {
-        if (signal?.aborted) {
-            controller.abort();
+        if (signal.aborted) {
+            controller.abort(signal.reason);
+            cleanup();
             break;
         }
-        signal?.addEventListener("abort", abort, { once: true });
+        const abort = () => {
+            controller.abort(signal.reason);
+            cleanup();
+        };
+        listeners.set(signal, abort);
+        signal.addEventListener("abort", abort, { once: true });
     }
-    return controller.signal;
+    return { signal: controller.signal, cleanup };
 };
+/**
+ * Convenience composition for operations that end when the merged signal aborts. For operations
+ * that can complete without aborting, use createMergedAbortSignal and call cleanup in a finally block.
+ */
+export const mergeAbortSignals = (...signals) => createMergedAbortSignal(...signals).signal;
 export const withTimeoutSignal = (options) => {
     if (options.timeoutMs !== undefined &&
         (!Number.isSafeInteger(options.timeoutMs) || options.timeoutMs <= 0 || options.timeoutMs > 24 * 60 * 60 * 1_000)) {

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGjE,MAAM,cAAc,GAAG,CAAC,MAA+B,EAAE,EAAE;IACzD,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,YAAY,KAAK,EAAE,CAAC;QACnC,MAAM,MAAM,CAAC,MAAM,CAAC;IACtB,CAAC;IACD,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC;AACrE,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,MAAoB,EAAE,EAAE,CACjD,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IACpC,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC,CAAC;IACzH,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC;AAEL,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAW,EAAE;IACnD,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;IAC7E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,OAAuC,EAGhF,EAAE;IACF,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAyB,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5G,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,kBAAkB,GAAG,WAE1B,CAAC;IACF,IAAI,OAAO,kBAAkB,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACjD,OAAO;YACL,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,aAAa,CAAC;YAC7C,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IACrD,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;YAC3C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QACD,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,EAAE,CAAC;YACV,MAAM;QACR,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAChD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,OAAuC,EAA2B,EAAE,CACvG,uBAAuB,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC;AAE7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAqB,EAAE,EAAE;IACzD,IACE,OAAO,CAAC,SAAS,KAAK,SAAS;QAC/B,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,IAAI,OAAO,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,EAChH,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,kFAAkF,CAAC,CAAC;IAChH,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC5E,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;QACjC,eAAe,EAAE,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS;QAC7C,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAExH,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,KAAK,EAAE,CAAC,MAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;QACrD,OAAO,EAAE,GAAG,EAAE;YACZ,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YACnE,IAAI,OAAO,EAAE,CAAC;gBACZ,YAAY,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAK,SAA2B,EAAE,UAAwB,EAAE,EAAc,EAAE;IACxG,MAAM,oBAAoB,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,IAAI,oBAAoB,GAAG,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,eAAe,CAAC,8DAA8D,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,iBAAiB,GAAG,OAAO,CAAC,cAAc,IAAI,GAAG,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,eAAe,CAAC,kEAAkE,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAC3D,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC1D,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,IAAI,UAAU,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,YAAY,GAChB,KAAK,YAAY,iBAAiB;gBAClC,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;gBACtC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC;gBACnC,KAAK,CAAC,YAAY,IAAI,CAAC;gBACrB,CAAC,CAAC,KAAK,CAAC,YAAY;gBACpB,CAAC,CAAC,CAAC,CAAC;YACR,MAAM,KAAK,CACT,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,EACxE,OAAO,CAAC,WAAW,CACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,OAAiB,EAC4E,EAAE;IAC/F,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAG3D,CAAC;IAEX,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC1F,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/secure-id-node.d.ts

@@ -0,0 +1,2 @@
+export declare const createSecureId: (prefix: string) => string;
+//# sourceMappingURL=secure-id-node.d.ts.map

package/dist/secure-id-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-id-node.d.ts","sourceRoot":"","sources":["../src/secure-id-node.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAqC,CAAC"}

package/dist/secure-id-node.js

@@ -0,0 +1,3 @@
+import { randomUUID } from "node:crypto";
+export const createSecureId = (prefix) => `${prefix}_${randomUUID()}`;
+//# sourceMappingURL=secure-id-node.js.map

package/dist/secure-id-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-id-node.js","sourceRoot":"","sources":["../src/secure-id-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,GAAG,MAAM,IAAI,UAAU,EAAE,EAAE,CAAC"}

package/dist/secure-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"secure-id.d.ts","sourceRoot":"","sources":["../src/secure-id.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAqC,CAAC"}
+{"version":3,"file":"secure-id.d.ts","sourceRoot":"","sources":["../src/secure-id.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAK/C,CAAC"}

package/dist/secure-id.js

@@ -1,3 +1,7 @@
-import { randomUUID } from "node:crypto";
-export const createSecureId = (prefix) => `${prefix}_${randomUUID()}`;
+export const createSecureId = (prefix) => {
+    if (typeof globalThis.crypto?.randomUUID !== "function") {
+        throw new Error("Secure IDs require a runtime with the Web Crypto randomUUID API.");
+    }
+    return `${prefix}_${globalThis.crypto.randomUUID()}`;
+};
 //# sourceMappingURL=secure-id.js.map

package/dist/secure-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"secure-id.js","sourceRoot":"","sources":["../src/secure-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,GAAG,MAAM,IAAI,UAAU,EAAE,EAAE,CAAC"}
+{"version":3,"file":"secure-id.js","sourceRoot":"","sources":["../src/secure-id.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAU,EAAE;IACvD,IAAI,OAAO,UAAU,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,GAAG,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;AACvD,CAAC,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,4 @@
+/** Evaluation harnesses and deterministic test doubles. */
+export * from "./agent-evaluation.js";
+export * from "./workflow-evaluation.js";
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/testing.js

@@ -0,0 +1,4 @@
+/** Evaluation harnesses and deterministic test doubles. */
+export * from "./agent-evaluation.js";
+export * from "./workflow-evaluation.js";
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/types.d.ts

@@ -167,6 +167,8 @@ export interface ToolRuntimeContext<TContext = any> {
     /** Durable run that owns this execution, when invoked by the agent runtime. */
     runId?: string;
     agentId?: string;
+    /** Human-readable, low-cardinality agent name used for telemetry. */
+    agentName?: string;
     scope?: AgentStoreScope;
     metadata?: Record<string, JsonValue>;
     /** Acquired execution boundary for this run. Callbacks and secrets are never persisted. */
@@ -1005,9 +1007,9 @@ export interface EmbeddingModel {
     readonly capabilities: ModelCapabilities;
     embed(input: EmbedInput & RetryOptions): Promise<EmbedResult>;
 }
-export interface ProviderAdapter {
+export interface ProviderAdapter<TLanguageModel extends LanguageModel = LanguageModel> {
     readonly name: string;
-    languageModel(modelId: string): LanguageModel;
+    languageModel(modelId: string): TLanguageModel;
     embeddingModel?: (modelId: string) => EmbeddingModel;
     transcriptionModel?: (modelId: string) => TranscriptionModel;
     speechModel?: (modelId: string) => SpeechModel;
@@ -1023,7 +1025,7 @@ export interface ProviderAdapter {
     interactions?: InteractionsClient;
     predictionModel?: (modelId: string) => PredictionModel;
 }
-export type CallableProviderAdapter = ProviderAdapter & ((modelId: string) => LanguageModel);
+export type CallableProviderAdapter<TLanguageModel extends LanguageModel = LanguageModel> = ProviderAdapter<TLanguageModel> & ((modelId: string) => TLanguageModel);
 export interface ToolDefinition<TSchema extends ZodTypeAny = any, TResult = JsonValue, TContext = any> {
     name: string;
     description?: string;
@@ -1546,15 +1548,19 @@ export interface AgentTelemetryRunStartEvent {
     type: "run-start";
     runId: string;
     agentId?: string;
+    agentName?: string;
     provider: string;
     modelId: string;
     maxSteps: number;
+    startedAt?: number;
 }
 export interface AgentTelemetryStepStartEvent {
     type: "step-start";
     runId: string;
     agentId?: string;
+    agentName?: string;
     stepIndex: number;
+    startedAt?: number;
 }
 export interface AgentTelemetryStepFinishEvent {
     type: "step-finish";
@@ -1562,6 +1568,15 @@ export interface AgentTelemetryStepFinishEvent {
     agentId?: string;
     step: AgentStep;
 }
+export interface AgentTelemetryToolStartEvent {
+    type: "tool-start";
+    runId: string;
+    agentId?: string;
+    agentName?: string;
+    stepIndex: number;
+    toolCall: ToolCall;
+    startedAt?: number;
+}
 export interface AgentTelemetryApprovalRequestEvent {
     type: "approval-request";
     runId: string;
@@ -1649,11 +1664,39 @@ export interface AgentTelemetryRunFinishEvent {
     type: "run-finish";
     runId: string;
     agentId?: string;
+    agentName?: string;
     status: AgentStatus;
     state: AgentRunState;
+    finishedAt?: number;
 }
-export type AgentTelemetryEvent = AgentTelemetryRunStartEvent | AgentTelemetryStepStartEvent | AgentTelemetryStepFinishEvent | AgentTelemetryApprovalRequestEvent | AgentTelemetryApprovalResolvedEvent | AgentTelemetryToolApprovalEvent | AgentTelemetryMemoryLoadedEvent | AgentTelemetryGuardrailTriggeredEvent | AgentTelemetryStateSavedEvent | AgentTelemetryHandoffEvent | AgentTelemetrySubAgentStartEvent | AgentTelemetrySubAgentFinishEvent | AgentTelemetryRunFinishEvent;
-export type AgentTelemetryObserver = (event: AgentTelemetryEvent) => void | Promise<void>;
+export type AgentTelemetryEvent = AgentTelemetryRunStartEvent | AgentTelemetryStepStartEvent | AgentTelemetryStepFinishEvent | AgentTelemetryToolStartEvent | AgentTelemetryApprovalRequestEvent | AgentTelemetryApprovalResolvedEvent | AgentTelemetryToolApprovalEvent | AgentTelemetryMemoryLoadedEvent | AgentTelemetryGuardrailTriggeredEvent | AgentTelemetryStateSavedEvent | AgentTelemetryHandoffEvent | AgentTelemetrySubAgentStartEvent | AgentTelemetrySubAgentFinishEvent | AgentTelemetryRunFinishEvent;
+export interface AgentTelemetryInvocationStart {
+    runId: string;
+    agentId?: string;
+    agentName?: string;
+    provider: string;
+    modelId: string;
+    maxSteps: number;
+    startedAt: number;
+}
+export interface AgentTelemetryInvocationFinish {
+    runId: string;
+    agentId?: string;
+    agentName?: string;
+    status: AgentStatus;
+    error?: Error;
+    finishedAt: number;
+}
+export type AgentTelemetryObserver = ((event: AgentTelemetryEvent) => void | Promise<void>) & {
+    /** Starts an invocation boundary before context, store, lease, and preflight work. */
+    startInvocation?(event: AgentTelemetryInvocationStart): void | Promise<void>;
+    /** Closes that boundary even when setup fails before the normal run lifecycle starts. */
+    finishInvocation?(event: AgentTelemetryInvocationFinish): void | Promise<void>;
+    /** Runs work with the matching agent invocation span active when supported. */
+    withRunContext?<T>(runId: string, callback: () => T | Promise<T>): Promise<T>;
+    /** Runs work with the matching agent step span active when supported. */
+    withStepContext?<T>(runId: string, stepIndex: number, callback: () => T | Promise<T>): Promise<T>;
+};
 export type AgentHookFailureMode = "ignore" | "fail";
 export interface AgentOperationalError {
     source: "telemetry" | "memory";
@@ -1670,6 +1713,8 @@ export interface AgentHookFailurePolicy {
 }
 export interface AgentDefinition<TModel extends LanguageModel = LanguageModel, TContext = any, TOutput = any> {
     id?: string;
+    /** Human-readable, low-cardinality name. `id` remains the stable definition identifier. */
+    name?: string;
     model: TModel;
     instructions?: string;
     contextSchema?: z.ZodType<TContext>;
@@ -1702,6 +1747,8 @@ export interface AgentDefinition<TModel extends LanguageModel = LanguageModel, T
 }
 export interface LiveAgentDefinition<TModel extends RealtimeModel = RealtimeModel> {
     id?: string;
+    /** Human-readable, low-cardinality name. `id` remains the stable definition identifier. */
+    name?: string;
     model: TModel;
     instructions?: string;
     tools?: ToolCollection;
@@ -2120,12 +2167,14 @@ export interface CircuitBreakerState {
 }
 export interface TelemetryGenerateStartEvent<TProviderOptions extends ProviderOptions = ProviderOptions> {
     type: "generate-start";
+    generateId?: number;
     model: LanguageModel<TProviderOptions>;
     input: ModelGenerateInput<TProviderOptions>;
     startedAt: number;
 }
 export interface TelemetryGenerateFinishEvent<TProviderOptions extends ProviderOptions = ProviderOptions> {
     type: "generate-finish";
+    generateId?: number;
     model: LanguageModel<TProviderOptions>;
     input: ModelGenerateInput<TProviderOptions>;
     output: GenerateResult;
@@ -2135,6 +2184,7 @@ export interface TelemetryGenerateFinishEvent<TProviderOptions extends ProviderO
 }
 export interface TelemetryGenerateErrorEvent<TProviderOptions extends ProviderOptions = ProviderOptions> {
     type: "generate-error";
+    generateId?: number;
     model: LanguageModel<TProviderOptions>;
     input: ModelGenerateInput<TProviderOptions>;
     error: Error;
@@ -2144,12 +2194,26 @@ export interface TelemetryGenerateErrorEvent<TProviderOptions extends ProviderOp
 }
 export interface TelemetryStreamStartEvent<TProviderOptions extends ProviderOptions = ProviderOptions> {
     type: "stream-start";
+    streamId?: number;
+    model: LanguageModel<TProviderOptions>;
+    input: ModelGenerateInput<TProviderOptions>;
+    startedAt: number;
+}
+/** Timing-only signal for one logical non-terminal stream chunk; never includes model output content. */
+export interface TelemetryStreamChunkEvent<TProviderOptions extends ProviderOptions = ProviderOptions> {
+    type: "stream-chunk";
+    streamId?: number;
     model: LanguageModel<TProviderOptions>;
     input: ModelGenerateInput<TProviderOptions>;
     startedAt: number;
+    chunkAt: number;
+    chunkIndex: number;
+    timeToFirstChunkMs?: number;
+    timeSincePreviousChunkMs?: number;
 }
 export interface TelemetryStreamFinishEvent<TProviderOptions extends ProviderOptions = ProviderOptions> {
     type: "stream-finish";
+    streamId?: number;
     model: LanguageModel<TProviderOptions>;
     input: ModelGenerateInput<TProviderOptions>;
     startedAt: number;
@@ -2158,15 +2222,19 @@ export interface TelemetryStreamFinishEvent<TProviderOptions extends ProviderOpt
     finishReason?: FinishReason;
     providerFinishReason?: string;
     usage?: TokenUsage;
+    /** Number of non-terminal output chunks observed. */
+    outputChunkCount?: number;
 }
 export interface TelemetryStreamErrorEvent<TProviderOptions extends ProviderOptions = ProviderOptions> {
     type: "stream-error";
+    streamId?: number;
     model: LanguageModel<TProviderOptions>;
     input: ModelGenerateInput<TProviderOptions>;
     error: Error;
     startedAt: number;
     finishedAt: number;
     latencyMs: number;
+    outputChunkCount?: number;
 }
 export interface TelemetryToolExecutionStartEvent<TProviderOptions extends ProviderOptions = ProviderOptions> {
     type: "tool-execution-start";
@@ -2198,7 +2266,7 @@ export interface TelemetryToolExecutionErrorEvent<TProviderOptions extends Provi
     finishedAt: number;
     latencyMs: number;
 }
-export type LanguageModelTelemetryEvent<TProviderOptions extends ProviderOptions = ProviderOptions> = TelemetryGenerateStartEvent<TProviderOptions> | TelemetryGenerateFinishEvent<TProviderOptions> | TelemetryGenerateErrorEvent<TProviderOptions> | TelemetryStreamStartEvent<TProviderOptions> | TelemetryStreamFinishEvent<TProviderOptions> | TelemetryStreamErrorEvent<TProviderOptions> | TelemetryToolExecutionStartEvent<TProviderOptions> | TelemetryToolExecutionFinishEvent<TProviderOptions> | TelemetryToolExecutionErrorEvent<TProviderOptions>;
+export type LanguageModelTelemetryEvent<TProviderOptions extends ProviderOptions = ProviderOptions> = TelemetryGenerateStartEvent<TProviderOptions> | TelemetryGenerateFinishEvent<TProviderOptions> | TelemetryGenerateErrorEvent<TProviderOptions> | TelemetryStreamStartEvent<TProviderOptions> | TelemetryStreamChunkEvent<TProviderOptions> | TelemetryStreamFinishEvent<TProviderOptions> | TelemetryStreamErrorEvent<TProviderOptions> | TelemetryToolExecutionStartEvent<TProviderOptions> | TelemetryToolExecutionFinishEvent<TProviderOptions> | TelemetryToolExecutionErrorEvent<TProviderOptions>;
 export interface UIMessage {
     id: string;
     role: MessageRole;