@anvia/core 1.0.3 → 1.0.4

package/README.md

@@ -500,6 +500,43 @@ const { runId, output } = await pipeline.run({
 });
 ```
 
+Pipelines use the same named observability configuration as Agents. Pipeline observers receive the
+root run and every composed, parallel, Agent, extraction, and custom stage. A primary stage trace is
+propagated into an Agent stage so its generations and tools become children of that stage. This
+requires the Pipeline and Agent `primaryTrace` names to match. When they differ, Anvia leaves the
+Agent trace unchanged without raising an error:
+
+```ts
+const pipeline = new Pipeline({
+  id: "support-flow",
+  inputSchema: z.string(),
+  observability: {
+    observers: { telemetry: pipelineObserver },
+    primaryTrace: "telemetry",
+  },
+}).agent({
+  id: "draft",
+  agent,
+  suspension: "reject",
+  request: ({ input }) => ({ prompt: input }),
+});
+
+const result = await pipeline.run({
+  input: "Customer cannot complete checkout.",
+  trace: { sessionId: "support-session" },
+});
+
+console.log(result.trace);
+```
+
+The `observer` passed to `pipeline.run()` remains a separate stage-event sink intended for Studio,
+logging, and other operational consumers. Its errors are isolated unless `failOnObserverError` is
+enabled.
+
+`observability.errorPolicy` controls named observer failures instead. It accepts `"ignore"` or
+`"throw"` and defaults to `"ignore"`. With `"throw"`, the run rejects with a
+`PipelineObserverDispatchError` containing the failed phase and per-observer failures.
+
 ## Documents
 
 Applications own file discovery, file reads, source metadata, and per-file error policy. Core only

package/dist/agent/index.d.ts

@@ -1,9 +1,9 @@
 export { M as ModelCallOptions } from '../model-call-options-CZkSw_xN.js';
 export { R as RetryContext, a as RetryOptions, b as RetrySetting } from '../retry-CjvSlKGW.js';
-export { A as Agent, a as AgentContextInput, b as AgentMemory, c as AgentMemoryOptions, d as AgentOptions, e as AgentToolInput, f as AgentToolOptions, C as CreateHybridVectorContextOptions, g as CreateVectorContextOptions, V as VectorContext, h as VectorContextBaseOptions, i as createVectorContext, j as isVectorContext } from '../agent-DYfzP-n5.js';
+export { A as Agent, a as AgentContextInput, b as AgentMemory, c as AgentMemoryOptions, d as AgentOptions, e as AgentToolInput, f as AgentToolOptions, C as CreateHybridVectorContextOptions, g as CreateVectorContextOptions, V as VectorContext, h as VectorContextBaseOptions, i as createVectorContext, j as isVectorContext } from '../agent-fvQIBLBk.js';
 import { M as Message, U as Usage, C as CompletionFinishReason } from '../types-DgvozfPc.js';
-import { A as AgentBlockedOutcome, g as AgentInteractionOutcome } from '../types-BUEZMBhO.js';
-export { a as AgentChildStreamEvent, b as AgentDeltaEvent, c as AgentErrorEvent, d as AgentErrorStreamEvent, e as AgentFinishEvent, f as AgentInput, h as AgentLifecycle, i as AgentMemoryCompactionEvent, j as AgentMemoryCompactionOptions, k as AgentOutcome, l as AgentPrompt, m as AgentResponse, n as AgentRunOptions, o as AgentRunSettings, p as AgentStartEvent, q as AgentSteerInput, r as AgentSteerReceipt, s as AgentStepFinishEvent, t as AgentStream, u as AgentStreamEvent, v as AgentToolCallDeltaEvent, w as AgentToolFinishEvent, x as AgentToolStartEvent } from '../types-BUEZMBhO.js';
+import { A as AgentBlockedOutcome, g as AgentInteractionOutcome } from '../types-ChH_bdtR.js';
+export { a as AgentChildStreamEvent, b as AgentDeltaEvent, c as AgentErrorEvent, d as AgentErrorStreamEvent, e as AgentFinishEvent, f as AgentInput, h as AgentLifecycle, i as AgentMemoryCompactionEvent, j as AgentMemoryCompactionOptions, k as AgentOutcome, l as AgentPrompt, m as AgentResponse, n as AgentRunOptions, o as AgentRunSettings, p as AgentStartEvent, q as AgentSteerInput, r as AgentSteerReceipt, s as AgentStepFinishEvent, t as AgentStream, u as AgentStreamEvent, v as AgentToolCallDeltaEvent, w as AgentToolFinishEvent, x as AgentToolStartEvent } from '../types-ChH_bdtR.js';
 import '../zod-schema-C7F4clpm.js';
 import 'zod';
 import '../types-DhkodEft.js';

package/dist/agent/index.js

@@ -2,11 +2,12 @@ import {
   Agent,
   createVectorContext,
   isVectorContext
-} from "../chunk-5TIXGU5U.js";
+} from "../chunk-NMVCGWQY.js";
 import "../chunk-OJBFDBLG.js";
 import "../chunk-J6LVLV6P.js";
 import "../chunk-XMVOBX43.js";
-import "../chunk-AR2K73CJ.js";
+import "../chunk-34EDX4ZL.js";
+import "../chunk-KSKST3KP.js";
 import "../chunk-YK4WAAS4.js";
 import "../chunk-OIB3URVG.js";
 import "../chunk-LZD36ZAP.js";

package/dist/{agent-DYfzP-n5.d.ts → agent-fvQIBLBk.d.ts}

@@ -4,7 +4,7 @@ import { Z as ZodSchema } from './zod-schema-C7F4clpm.js';
 import { d as GuardrailPolicyInput, c as GuardrailPolicy } from './types-DhkodEft.js';
 import { a as McpServer } from './types-DjqRHeAi.js';
 import { E as MemoryStore, z as MemorySavePolicy, F as MemoryTokenCounter, n as MemoryCompactor, d as MemoryCompactionConflictRetryOptions, y as MemoryOptions, k as MemoryCompactionResult } from './types-CSYt7-It.js';
-import { h as AgentLifecycle, F as AgentObservabilityOptions, n as AgentRunOptions, k as AgentOutcome, o as AgentRunSettings, t as AgentStream, j as AgentMemoryCompactionOptions } from './types-BUEZMBhO.js';
+import { h as AgentLifecycle, F as AgentObservabilityOptions, n as AgentRunOptions, k as AgentOutcome, o as AgentRunSettings, t as AgentStream, j as AgentMemoryCompactionOptions } from './types-ChH_bdtR.js';
 import { A as AgentMiddleware } from './middleware-kcF8AusP.js';
 import { A as AnyTool, T as Tool, c as ToolCallContext, N as NormalizedToolOutput } from './tool-BpqpoRSE.js';
 import { AgentContinuation, AgentInteractionResponse } from './agent/interactions/index.js';

package/dist/{chunk-AR2K73CJ.js → chunk-34EDX4ZL.js}

@@ -1,89 +1,10 @@
+import {
+  observerSnapshot
+} from "./chunk-KSKST3KP.js";
 import {
   Usage
 } from "./chunk-TB5EKZM7.js";
 
-// src/observability/snapshot.ts
-function observerSnapshot(value) {
-  if (containsError(value, /* @__PURE__ */ new WeakSet())) {
-    return cloneObserverFallback(value, /* @__PURE__ */ new WeakMap());
-  }
-  try {
-    return globalThis.structuredClone(value);
-  } catch {
-    return cloneObserverFallback(value, /* @__PURE__ */ new WeakMap());
-  }
-}
-function cloneObserverFallback(value, seen) {
-  if (typeof value !== "object" || value === null) {
-    return value;
-  }
-  const existing = seen.get(value);
-  if (existing !== void 0) {
-    return existing;
-  }
-  if (Array.isArray(value)) {
-    const clone2 = [];
-    seen.set(value, clone2);
-    clone2.push(...value.map((item) => cloneObserverFallback(item, seen)));
-    return clone2;
-  }
-  if (value instanceof Date) {
-    return new Date(value.getTime());
-  }
-  if (value instanceof Error) {
-    const clone2 = Object.create(Object.getPrototypeOf(value));
-    seen.set(value, clone2);
-    Object.defineProperties(clone2, {
-      name: { configurable: true, writable: true, value: value.name },
-      message: { configurable: true, writable: true, value: value.message }
-    });
-    if (value.stack !== void 0) {
-      Object.defineProperty(clone2, "stack", {
-        configurable: true,
-        writable: true,
-        value: value.stack
-      });
-    }
-    if (value.cause !== void 0) {
-      Object.defineProperty(clone2, "cause", {
-        configurable: true,
-        writable: true,
-        value: cloneObserverFallback(value.cause, seen)
-      });
-    }
-    for (const key of Object.getOwnPropertyNames(value)) {
-      if (key === "name" || key === "message" || key === "stack" || key === "cause") continue;
-      const descriptor = Object.getOwnPropertyDescriptor(value, key);
-      if (descriptor === void 0) continue;
-      if ("value" in descriptor) {
-        descriptor.value = cloneObserverFallback(descriptor.value, seen);
-      }
-      Object.defineProperty(clone2, key, descriptor);
-    }
-    return clone2;
-  }
-  if (Object.getPrototypeOf(value) !== Object.prototype) {
-    return value;
-  }
-  const clone = {};
-  seen.set(value, clone);
-  for (const [key, item] of Object.entries(value)) {
-    clone[key] = cloneObserverFallback(item, seen);
-  }
-  return clone;
-}
-function containsError(value, seen) {
-  if (typeof value !== "object" || value === null) return false;
-  if (value instanceof Error) return true;
-  if (seen.has(value)) return false;
-  seen.add(value);
-  if (Array.isArray(value)) {
-    return value.some((item) => containsError(item, seen));
-  }
-  if (Object.getPrototypeOf(value) !== Object.prototype) return false;
-  return Object.values(value).some((item) => containsError(item, seen));
-}
-
 // src/observability/group.ts
 var AgentObserverDispatchError = class extends AggregateError {
   phase;
@@ -321,4 +242,4 @@ export {
   AgentObserverDispatchError,
   startAgentRunObservers
 };
-//# sourceMappingURL=chunk-AR2K73CJ.js.map
+//# sourceMappingURL=chunk-34EDX4ZL.js.map

package/dist/chunk-34EDX4ZL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observability/group.ts"],"sourcesContent":["import { Usage } from \"../completion\";\nimport { observerSnapshot } from \"./snapshot\";\nimport type {\n  AgentGenerationEndArgs,\n  AgentGenerationErrorArgs,\n  AgentGenerationObserver,\n  AgentGenerationStartArgs,\n  AgentGenerationUpdateArgs,\n  AgentObserverErrorPolicy,\n  AgentObserverMap,\n  AgentRunEndArgs,\n  AgentRunErrorArgs,\n  AgentRunEventArgs,\n  AgentRunObserver,\n  AgentRunStartArgs,\n  AgentToolEndArgs,\n  AgentToolErrorArgs,\n  AgentToolObserver,\n  AgentToolStartArgs,\n  AgentToolStreamEventArgs,\n  AgentToolSuspendedArgs,\n  AgentTraceInfo,\n} from \"./types\";\n\nexport type AgentObserverFailure = {\n  readonly observer: string;\n  readonly error: unknown;\n};\n\nexport class AgentObserverDispatchError extends AggregateError {\n  readonly phase: string;\n  readonly failures: readonly AgentObserverFailure[];\n\n  constructor(phase: string, failures: readonly AgentObserverFailure[]) {\n    super(\n      failures.map((failure) => failure.error),\n      `Agent observer ${phase} failed for ${failures.map((failure) => failure.observer).join(\", \")}.`,\n    );\n    this.name = \"AgentObserverDispatchError\";\n    this.phase = phase;\n    this.failures = Object.freeze([...failures]);\n  }\n}\n\ntype NamedObserver<T> = {\n  readonly name: string;\n  readonly observer: T;\n};\n\ntype ActiveNamedObserver<T> = NamedObserver<T> & {\n  terminal: boolean;\n};\n\nexport async function startAgentRunObservers(\n  observers: AgentObserverMap,\n  args: AgentRunStartArgs,\n  options: {\n    readonly primaryTrace?: string | undefined;\n    readonly errorPolicy: AgentObserverErrorPolicy;\n  },\n): Promise<ActiveAgentRunObservers> {\n  const runObservers: ActiveNamedObserver<AgentRunObserver>[] = [];\n  const failures: AgentObserverFailure[] = [];\n  for (const [name, observer] of Object.entries(observers)) {\n    try {\n      const runObserver = await observer.startRun(observerSnapshot(args));\n      if (runObserver !== undefined) {\n        runObservers.push({ name, observer: runObserver, terminal: false });\n      }\n    } catch (error) {\n      failures.push({ observer: name, error });\n    }\n  }\n  if (options.errorPolicy === \"throw\" && failures.length > 0) {\n    const startupError = new AgentObserverDispatchError(\"startRun\", failures);\n    const cleanupFailures = await terminateObservers(runObservers, (observer) =>\n      observer.error?.(\n        observerSnapshot({\n          status: \"failed\",\n          error: startupError,\n          usage: Usage.empty(),\n          messages: [...args.history, args.prompt],\n        }),\n      ),\n    );\n    throw new AgentObserverDispatchError(\"startRun\", [...failures, ...cleanupFailures]);\n  }\n  return new ActiveAgentRunObservers(runObservers, options);\n}\n\nexport class ActiveAgentRunObservers {\n  readonly trace: AgentTraceInfo | undefined;\n\n  constructor(\n    private readonly runObservers: readonly ActiveNamedObserver<AgentRunObserver>[],\n    private readonly options: {\n      readonly primaryTrace?: string | undefined;\n      readonly errorPolicy: AgentObserverErrorPolicy;\n    },\n  ) {\n    const primary =\n      options.primaryTrace === undefined\n        ? undefined\n        : runObservers.find((entry) => entry.name === options.primaryTrace);\n    this.trace =\n      primary?.observer.trace === undefined\n        ? undefined\n        : Object.freeze({ observer: primary.name, ...primary.observer.trace });\n  }\n\n  async startGeneration(args: AgentGenerationStartArgs): Promise<ActiveGenerationObservers> {\n    const generationObservers: ActiveNamedObserver<AgentGenerationObserver>[] = [];\n    const failures: AgentObserverFailure[] = [];\n    for (const entry of this.runObservers) {\n      if (entry.observer.startGeneration === undefined) continue;\n      try {\n        const observer = await entry.observer.startGeneration(observerSnapshot(args));\n        if (observer !== undefined) {\n          generationObservers.push({ name: entry.name, observer, terminal: false });\n        }\n      } catch (error) {\n        failures.push({ observer: entry.name, error });\n      }\n    }\n    if (this.options.errorPolicy === \"throw\" && failures.length > 0) {\n      const startupError = new AgentObserverDispatchError(\"startGeneration\", failures);\n      const cleanupFailures = await terminateObservers(generationObservers, (observer) =>\n        observer.error?.(observerSnapshot({ turn: args.turn, error: startupError })),\n      );\n      throw new AgentObserverDispatchError(\"startGeneration\", [...failures, ...cleanupFailures]);\n    }\n    return new ActiveGenerationObservers(generationObservers, this.options.errorPolicy);\n  }\n\n  async startTool(args: AgentToolStartArgs): Promise<ActiveToolObservers> {\n    const toolObservers: ActiveNamedObserver<AgentToolObserver>[] = [];\n    const failures: AgentObserverFailure[] = [];\n    for (const entry of this.runObservers) {\n      if (entry.observer.startTool === undefined) continue;\n      try {\n        const observer = await entry.observer.startTool(observerSnapshot(args));\n        if (observer !== undefined) {\n          toolObservers.push({ name: entry.name, observer, terminal: false });\n        }\n      } catch (error) {\n        failures.push({ observer: entry.name, error });\n      }\n    }\n    if (this.options.errorPolicy === \"throw\" && failures.length > 0) {\n      const startupError = new AgentObserverDispatchError(\"startTool\", failures);\n      const cleanupFailures = await terminateObservers(toolObservers, (observer) =>\n        observer.error?.(observerSnapshot({ ...args, error: startupError })),\n      );\n      throw new AgentObserverDispatchError(\"startTool\", [...failures, ...cleanupFailures]);\n    }\n    return new ActiveToolObservers(toolObservers, this.options.errorPolicy);\n  }\n\n  async end(args: AgentRunEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.runObservers,\n      \"end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.options.errorPolicy,\n    );\n  }\n\n  async error(args: AgentRunErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.runObservers,\n      \"error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n\n  async event(args: AgentRunEventArgs): Promise<void> {\n    await dispatchObservers(\n      this.runObservers,\n      \"event\",\n      (observer) => observer.event?.(observerSnapshot(args)),\n      this.options.errorPolicy,\n    );\n  }\n}\n\nexport class ActiveGenerationObservers {\n  constructor(\n    private readonly observers: readonly ActiveNamedObserver<AgentGenerationObserver>[],\n    private readonly errorPolicy: AgentObserverErrorPolicy,\n  ) {}\n\n  async end(args: AgentGenerationEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"generation.end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async error(args: AgentGenerationErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"generation.error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n\n  async update(args: AgentGenerationUpdateArgs): Promise<void> {\n    await dispatchObservers(\n      this.observers,\n      \"generation.update\",\n      (observer) => observer.update?.(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n}\n\nexport class ActiveToolObservers {\n  constructor(\n    private readonly observers: readonly ActiveNamedObserver<AgentToolObserver>[],\n    private readonly errorPolicy: AgentObserverErrorPolicy,\n  ) {}\n\n  async streamEvent(args: AgentToolStreamEventArgs): Promise<void> {\n    await dispatchObservers(\n      this.observers,\n      \"tool.streamEvent\",\n      (observer) => observer.streamEvent?.(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async end(args: AgentToolEndArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"tool.end\",\n      (observer) => observer.end(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async suspend(args: AgentToolSuspendedArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"tool.suspend\",\n      (observer) => observer.suspend?.(observerSnapshot(args)),\n      this.errorPolicy,\n    );\n  }\n\n  async error(args: AgentToolErrorArgs): Promise<void> {\n    await dispatchTerminalObservers(\n      this.observers,\n      \"tool.error\",\n      (observer) => observer.error?.(observerSnapshot(args)),\n      \"ignore\",\n    );\n  }\n}\n\nasync function dispatchObservers<T>(\n  observers: readonly NamedObserver<T>[],\n  phase: string,\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n  errorPolicy: AgentObserverErrorPolicy,\n): Promise<void> {\n  const failures: AgentObserverFailure[] = [];\n  for (const entry of observers) {\n    try {\n      await dispatch(entry.observer);\n    } catch (error) {\n      failures.push({ observer: entry.name, error });\n    }\n  }\n  throwObserverFailures(phase, failures, errorPolicy);\n}\n\nasync function dispatchTerminalObservers<T>(\n  observers: readonly ActiveNamedObserver<T>[],\n  phase: string,\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n  errorPolicy: AgentObserverErrorPolicy,\n): Promise<void> {\n  const failures = await terminateObservers(observers, dispatch);\n  throwObserverFailures(phase, failures, errorPolicy);\n}\n\nasync function terminateObservers<T>(\n  observers: readonly ActiveNamedObserver<T>[],\n  dispatch: (observer: T) => void | Promise<void> | undefined,\n): Promise<AgentObserverFailure[]> {\n  const failures: AgentObserverFailure[] = [];\n  for (const entry of observers) {\n    if (entry.terminal) continue;\n    entry.terminal = true;\n    try {\n      await dispatch(entry.observer);\n    } catch (error) {\n      failures.push({ observer: entry.name, error });\n    }\n  }\n  return failures;\n}\n\nfunction throwObserverFailures(\n  phase: string,\n  failures: readonly AgentObserverFailure[],\n  errorPolicy: AgentObserverErrorPolicy,\n): void {\n  if (errorPolicy === \"throw\" && failures.length > 0) {\n    throw new AgentObserverDispatchError(phase, failures);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-KSKST3KP.js

@@ -0,0 +1,86 @@
+// src/observability/snapshot.ts
+function observerSnapshot(value) {
+  if (containsError(value, /* @__PURE__ */ new WeakSet())) {
+    return cloneObserverFallback(value, /* @__PURE__ */ new WeakMap());
+  }
+  try {
+    return globalThis.structuredClone(value);
+  } catch {
+    return cloneObserverFallback(value, /* @__PURE__ */ new WeakMap());
+  }
+}
+function cloneObserverFallback(value, seen) {
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  const existing = seen.get(value);
+  if (existing !== void 0) {
+    return existing;
+  }
+  if (Array.isArray(value)) {
+    const clone2 = [];
+    seen.set(value, clone2);
+    clone2.push(...value.map((item) => cloneObserverFallback(item, seen)));
+    return clone2;
+  }
+  if (value instanceof Date) {
+    return new Date(value.getTime());
+  }
+  if (value instanceof Error) {
+    const clone2 = Object.create(Object.getPrototypeOf(value));
+    seen.set(value, clone2);
+    Object.defineProperties(clone2, {
+      name: { configurable: true, writable: true, value: value.name },
+      message: { configurable: true, writable: true, value: value.message }
+    });
+    if (value.stack !== void 0) {
+      Object.defineProperty(clone2, "stack", {
+        configurable: true,
+        writable: true,
+        value: value.stack
+      });
+    }
+    if (value.cause !== void 0) {
+      Object.defineProperty(clone2, "cause", {
+        configurable: true,
+        writable: true,
+        value: cloneObserverFallback(value.cause, seen)
+      });
+    }
+    for (const key of Object.getOwnPropertyNames(value)) {
+      if (key === "name" || key === "message" || key === "stack" || key === "cause") continue;
+      const descriptor = Object.getOwnPropertyDescriptor(value, key);
+      if (descriptor === void 0) continue;
+      if ("value" in descriptor) {
+        descriptor.value = cloneObserverFallback(descriptor.value, seen);
+      }
+      Object.defineProperty(clone2, key, descriptor);
+    }
+    return clone2;
+  }
+  if (Object.getPrototypeOf(value) !== Object.prototype) {
+    return value;
+  }
+  const clone = {};
+  seen.set(value, clone);
+  for (const [key, item] of Object.entries(value)) {
+    clone[key] = cloneObserverFallback(item, seen);
+  }
+  return clone;
+}
+function containsError(value, seen) {
+  if (typeof value !== "object" || value === null) return false;
+  if (value instanceof Error) return true;
+  if (seen.has(value)) return false;
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return value.some((item) => containsError(item, seen));
+  }
+  if (Object.getPrototypeOf(value) !== Object.prototype) return false;
+  return Object.values(value).some((item) => containsError(item, seen));
+}
+
+export {
+  observerSnapshot
+};
+//# sourceMappingURL=chunk-KSKST3KP.js.map

package/dist/chunk-KSKST3KP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/observability/snapshot.ts"],"sourcesContent":["export function observerSnapshot<T>(value: T): T {\n  if (containsError(value, new WeakSet<object>())) {\n    return cloneObserverFallback(value, new WeakMap<object, object>());\n  }\n  try {\n    return globalThis.structuredClone(value);\n  } catch {\n    return cloneObserverFallback(value, new WeakMap<object, object>());\n  }\n}\n\nfunction cloneObserverFallback<T>(value: T, seen: WeakMap<object, object>): T {\n  if (typeof value !== \"object\" || value === null) {\n    return value;\n  }\n  const existing = seen.get(value);\n  if (existing !== undefined) {\n    return existing as T;\n  }\n  if (Array.isArray(value)) {\n    const clone: unknown[] = [];\n    seen.set(value, clone);\n    clone.push(...value.map((item) => cloneObserverFallback(item, seen)));\n    return clone as T;\n  }\n  if (value instanceof Date) {\n    return new Date(value.getTime()) as T;\n  }\n  if (value instanceof Error) {\n    const clone = Object.create(Object.getPrototypeOf(value)) as Error;\n    seen.set(value, clone);\n    Object.defineProperties(clone, {\n      name: { configurable: true, writable: true, value: value.name },\n      message: { configurable: true, writable: true, value: value.message },\n    });\n    if (value.stack !== undefined) {\n      Object.defineProperty(clone, \"stack\", {\n        configurable: true,\n        writable: true,\n        value: value.stack,\n      });\n    }\n    if (value.cause !== undefined) {\n      Object.defineProperty(clone, \"cause\", {\n        configurable: true,\n        writable: true,\n        value: cloneObserverFallback(value.cause, seen),\n      });\n    }\n    for (const key of Object.getOwnPropertyNames(value)) {\n      if (key === \"name\" || key === \"message\" || key === \"stack\" || key === \"cause\") continue;\n      const descriptor = Object.getOwnPropertyDescriptor(value, key);\n      if (descriptor === undefined) continue;\n      if (\"value\" in descriptor) {\n        descriptor.value = cloneObserverFallback(descriptor.value, seen);\n      }\n      Object.defineProperty(clone, key, descriptor);\n    }\n    return clone as T;\n  }\n  if (Object.getPrototypeOf(value) !== Object.prototype) {\n    return value;\n  }\n  const clone: Record<string, unknown> = {};\n  seen.set(value, clone);\n  for (const [key, item] of Object.entries(value)) {\n    clone[key] = cloneObserverFallback(item, seen);\n  }\n  return clone as T;\n}\n\nfunction containsError(value: unknown, seen: WeakSet<object>): boolean {\n  if (typeof value !== \"object\" || value === null) return false;\n  if (value instanceof Error) return true;\n  if (seen.has(value)) return false;\n  seen.add(value);\n  if (Array.isArray(value)) {\n    return value.some((item) => containsError(item, seen));\n  }\n  if (Object.getPrototypeOf(value) !== Object.prototype) return false;\n  return Object.values(value).some((item) => containsError(item, seen));\n}\n"],"mappings":"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","names":["clone"]}

package/dist/{chunk-5TIXGU5U.js → chunk-NMVCGWQY.js}

@@ -16,7 +16,7 @@ import {
 } from "./chunk-XMVOBX43.js";
 import {
   startAgentRunObservers
-} from "./chunk-AR2K73CJ.js";
+} from "./chunk-34EDX4ZL.js";
 import {
   isSkillTool
 } from "./chunk-YK4WAAS4.js";
@@ -4772,4 +4772,4 @@ export {
   markResolvedAgentOptions,
   Agent
 };
-//# sourceMappingURL=chunk-5TIXGU5U.js.map
+//# sourceMappingURL=chunk-NMVCGWQY.js.map

package/dist/evals/index.d.ts

@@ -1,7 +1,7 @@
 import { U as Usage, J as JsonObject, c as CompletionModel, M as Message } from '../types-DgvozfPc.js';
 import { Z as ZodSchema } from '../zod-schema-C7F4clpm.js';
 import { AgentInteractionRequest, AgentInteractionResponse } from '../agent/interactions/index.js';
-import { g as AgentInteractionOutcome, m as AgentResponse, n as AgentRunOptions, k as AgentOutcome } from '../types-BUEZMBhO.js';
+import { g as AgentInteractionOutcome, m as AgentResponse, n as AgentRunOptions, k as AgentOutcome } from '../types-ChH_bdtR.js';
 import { E as EmbeddingModel } from '../types-Cr4uiYo5.js';
 import '../model-call-options-CZkSw_xN.js';
 import 'zod';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { A as Agent, a as AgentContextInput, b as AgentMemory, c as AgentMemoryOptions, d as AgentOptions, e as AgentToolInput, f as AgentToolOptions, C as CreateHybridVectorContextOptions, g as CreateVectorContextOptions, V as VectorContext, h as VectorContextBaseOptions, i as createVectorContext, j as isVectorContext } from './agent-DYfzP-n5.js';
+export { A as Agent, a as AgentContextInput, b as AgentMemory, c as AgentMemoryOptions, d as AgentOptions, e as AgentToolInput, f as AgentToolOptions, C as CreateHybridVectorContextOptions, g as CreateVectorContextOptions, V as VectorContext, h as VectorContextBaseOptions, i as createVectorContext, j as isVectorContext } from './agent-fvQIBLBk.js';
 export { AgentRunBlockedError, AgentRunCancelledError, AgentStreamClosedError, AgentStructuredOutputError, AgentStructuredOutputFormat, AgentStructuredOutputPhase, AgentToolSuspensionError, MaxTurnsError } from './agent/index.js';
-export { A as AgentBlockedOutcome, a as AgentChildStreamEvent, b as AgentDeltaEvent, c as AgentErrorEvent, d as AgentErrorStreamEvent, e as AgentFinishEvent, f as AgentInput, g as AgentInteractionOutcome, h as AgentLifecycle, i as AgentMemoryCompactionEvent, j as AgentMemoryCompactionOptions, k as AgentOutcome, l as AgentPrompt, m as AgentResponse, n as AgentRunOptions, o as AgentRunSettings, p as AgentStartEvent, q as AgentSteerInput, r as AgentSteerReceipt, s as AgentStepFinishEvent, t as AgentStream, u as AgentStreamEvent, v as AgentToolCallDeltaEvent, w as AgentToolFinishEvent, x as AgentToolStartEvent } from './types-BUEZMBhO.js';
+export { A as AgentBlockedOutcome, a as AgentChildStreamEvent, b as AgentDeltaEvent, c as AgentErrorEvent, d as AgentErrorStreamEvent, e as AgentFinishEvent, f as AgentInput, g as AgentInteractionOutcome, h as AgentLifecycle, i as AgentMemoryCompactionEvent, j as AgentMemoryCompactionOptions, k as AgentOutcome, l as AgentPrompt, m as AgentResponse, n as AgentRunOptions, o as AgentRunSettings, p as AgentStartEvent, q as AgentSteerInput, r as AgentSteerReceipt, s as AgentStepFinishEvent, t as AgentStream, u as AgentStreamEvent, v as AgentToolCallDeltaEvent, w as AgentToolFinishEvent, x as AgentToolStartEvent } from './types-ChH_bdtR.js';
 export { M as ModelCallOptions } from './model-call-options-CZkSw_xN.js';
 export { R as RetryContext, a as RetryOptions, b as RetrySetting } from './retry-CjvSlKGW.js';
 export { A as AssistantContentPart, a as AssistantGenerationMetadata, b as AssistantMessage, C as CompletionFinishReason, c as CompletionModel, d as CompletionModelInfo, e as CompletionModelStreamEvent, f as CompletionRequest, g as CompletionResponse, h as CompletionResult, i as CompletionSource, j as CompletionStreamEvent, k as CompletionTool, l as ContextUsage, D as Document, F as FileData, m as FilePart, I as ImageDetail, n as ImagePart, J as JsonObject, o as JsonPrimitive, p as JsonValue, M as Message, q as ModelContextLimits, P as ProviderTool, r as ProviderToolCall, R as ReasoningContentType, s as ReasoningDetail, t as ReasoningPart, S as SystemMessage, T as TextPart, u as ToolCallPart, v as ToolChoice, w as ToolDefinition, x as ToolMessage, y as ToolResultContentPart, z as ToolResultOutput, B as ToolResultPart, U as Usage, E as UserContentPart, G as UserMessage, H as calculateContextUsage, K as getAssistantGenerationMetadata, L as isProviderTool, N as resolveModelContextLimits, O as withContextUsage } from './types-DgvozfPc.js';

package/dist/index.js

@@ -19,7 +19,7 @@ import {
   Agent,
   createVectorContext,
   isVectorContext
-} from "./chunk-5TIXGU5U.js";
+} from "./chunk-NMVCGWQY.js";
 import "./chunk-OJBFDBLG.js";
 import "./chunk-J6LVLV6P.js";
 import {
@@ -29,7 +29,8 @@ import {
   estimateMemoryTokens,
   isMemoryCompactionMessage
 } from "./chunk-XMVOBX43.js";
-import "./chunk-AR2K73CJ.js";
+import "./chunk-34EDX4ZL.js";
+import "./chunk-KSKST3KP.js";
 import "./chunk-YK4WAAS4.js";
 import {
   createMiddleware,

package/dist/internal/agent.d.ts

@@ -1,4 +1,4 @@
-import { R as ResolvedAgentOptions, A as Agent } from '../agent-DYfzP-n5.js';
+import { R as ResolvedAgentOptions, A as Agent } from '../agent-fvQIBLBk.js';
 import { c as CompletionModel, P as ProviderTool, M as Message, U as Usage, g as CompletionResponse, y as ToolResultContentPart } from '../types-DgvozfPc.js';
 import { T as ToolIndex } from '../dynamic-tools-aIZlg5x1.js';
 import { A as AnyTool } from '../tool-BpqpoRSE.js';
@@ -9,7 +9,7 @@ import 'zod';
 import '../types-DhkodEft.js';
 import '../type-utils-CtHVDRn_.js';
 import '../types-DjqRHeAi.js';
-import '../types-BUEZMBhO.js';
+import '../types-ChH_bdtR.js';
 import '../agent/interactions/index.js';
 import '../middleware-kcF8AusP.js';
 import '../types-DC1U1XwW.js';

package/dist/internal/agent.js

@@ -4,11 +4,12 @@ import {
   getAgentToolState,
   markResolvedAgentOptions,
   withInternalAgentRunOptions
-} from "../chunk-5TIXGU5U.js";
+} from "../chunk-NMVCGWQY.js";
 import "../chunk-OJBFDBLG.js";
 import "../chunk-J6LVLV6P.js";
 import "../chunk-XMVOBX43.js";
-import "../chunk-AR2K73CJ.js";
+import "../chunk-34EDX4ZL.js";
+import "../chunk-KSKST3KP.js";
 import "../chunk-YK4WAAS4.js";
 import "../chunk-OIB3URVG.js";
 import "../chunk-LZD36ZAP.js";

package/dist/internal/agent.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent/resolved-agent.ts"],"sourcesContent":["import type { CompletionModel } from \"../completion\";\nimport { Agent } from \"./agent\";\nimport { markResolvedAgentOptions } from \"./resolve-options\";\nimport { getAgentToolState } from \"./tool-state\";\nimport type { ResolvedAgentOptions } from \"./types\";\n\nexport function createResolvedAgent<\n  Output = string,\n  M extends CompletionModel = CompletionModel,\n  ContextDocument = unknown,\n>(options: ResolvedAgentOptions<Output, M, ContextDocument>): Agent<Output, M, ContextDocument> {\n  return new Agent(markResolvedAgentOptions(options));\n}\n\nexport function getResolvedAgentOptions<Output, M extends CompletionModel, ContextDocument>(\n  agent: Agent<Output, M, ContextDocument>,\n): ResolvedAgentOptions<Output, M, ContextDocument> {\n  const toolState = getAgentToolState(agent);\n  return {\n    id: agent.id,\n    name: agent.name,\n    description: agent.description,\n    model: agent.model,\n    instructions: agent.instructions,\n    context: [...agent.context],\n    temperature: agent.temperature,\n    maxTokens: agent.maxTokens,\n    providerOptions: agent.providerOptions,\n    retries: agent.retries,\n    tools: [...toolState.configuredTools],\n    mcpServers: [...agent.mcpServers],\n    providerTools: [...toolState.providerTools],\n    toolIndexes: [...toolState.toolIndexes],\n    toolChoice: agent.toolChoice,\n    defaultMaxTurns: agent.defaultMaxTurns,\n    lifecycle: agent.lifecycle,\n    outputSchema: agent.outputSchema,\n    observability: agent.observability,\n    guardrails: [...agent.guardrails],\n    middlewares: [...agent.middlewares],\n    memory: agent.memory,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAMO,SAAS,oBAId,SAA8F;AAC9F,SAAO,IAAI,MAAM,yBAAyB,OAAO,CAAC;AACpD;AAEO,SAAS,wBACd,OACkD;AAClD,QAAM,YAAY,kBAAkB,KAAK;AACzC,SAAO;AAAA,IACL,IAAI,MAAM;AAAA,IACV,MAAM,MAAM;AAAA,IACZ,aAAa,MAAM;AAAA,IACnB,OAAO,MAAM;AAAA,IACb,cAAc,MAAM;AAAA,IACpB,SAAS,CAAC,GAAG,MAAM,OAAO;AAAA,IAC1B,aAAa,MAAM;AAAA,IACnB,WAAW,MAAM;AAAA,IACjB,iBAAiB,MAAM;AAAA,IACvB,SAAS,MAAM;AAAA,IACf,OAAO,CAAC,GAAG,UAAU,eAAe;AAAA,IACpC,YAAY,CAAC,GAAG,MAAM,UAAU;AAAA,IAChC,eAAe,CAAC,GAAG,UAAU,aAAa;AAAA,IAC1C,aAAa,CAAC,GAAG,UAAU,WAAW;AAAA,IACtC,YAAY,MAAM;AAAA,IAClB,iBAAiB,MAAM;AAAA,IACvB,WAAW,MAAM;AAAA,IACjB,cAAc,MAAM;AAAA,IACpB,eAAe,MAAM;AAAA,IACrB,YAAY,CAAC,GAAG,MAAM,UAAU;AAAA,IAChC,aAAa,CAAC,GAAG,MAAM,WAAW;AAAA,IAClC,QAAQ,MAAM;AAAA,EAChB;AACF;","names":[]}
+{"version":3,"sources":["../../src/agent/resolved-agent.ts"],"sourcesContent":["import type { CompletionModel } from \"../completion\";\nimport { Agent } from \"./agent\";\nimport { markResolvedAgentOptions } from \"./resolve-options\";\nimport { getAgentToolState } from \"./tool-state\";\nimport type { ResolvedAgentOptions } from \"./types\";\n\nexport function createResolvedAgent<\n  Output = string,\n  M extends CompletionModel = CompletionModel,\n  ContextDocument = unknown,\n>(options: ResolvedAgentOptions<Output, M, ContextDocument>): Agent<Output, M, ContextDocument> {\n  return new Agent(markResolvedAgentOptions(options));\n}\n\nexport function getResolvedAgentOptions<Output, M extends CompletionModel, ContextDocument>(\n  agent: Agent<Output, M, ContextDocument>,\n): ResolvedAgentOptions<Output, M, ContextDocument> {\n  const toolState = getAgentToolState(agent);\n  return {\n    id: agent.id,\n    name: agent.name,\n    description: agent.description,\n    model: agent.model,\n    instructions: agent.instructions,\n    context: [...agent.context],\n    temperature: agent.temperature,\n    maxTokens: agent.maxTokens,\n    providerOptions: agent.providerOptions,\n    retries: agent.retries,\n    tools: [...toolState.configuredTools],\n    mcpServers: [...agent.mcpServers],\n    providerTools: [...toolState.providerTools],\n    toolIndexes: [...toolState.toolIndexes],\n    toolChoice: agent.toolChoice,\n    defaultMaxTurns: agent.defaultMaxTurns,\n    lifecycle: agent.lifecycle,\n    outputSchema: agent.outputSchema,\n    observability: agent.observability,\n    guardrails: [...agent.guardrails],\n    middlewares: [...agent.middlewares],\n    memory: agent.memory,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMO,SAAS,oBAId,SAA8F;AAC9F,SAAO,IAAI,MAAM,yBAAyB,OAAO,CAAC;AACpD;AAEO,SAAS,wBACd,OACkD;AAClD,QAAM,YAAY,kBAAkB,KAAK;AACzC,SAAO;AAAA,IACL,IAAI,MAAM;AAAA,IACV,MAAM,MAAM;AAAA,IACZ,aAAa,MAAM;AAAA,IACnB,OAAO,MAAM;AAAA,IACb,cAAc,MAAM;AAAA,IACpB,SAAS,CAAC,GAAG,MAAM,OAAO;AAAA,IAC1B,aAAa,MAAM;AAAA,IACnB,WAAW,MAAM;AAAA,IACjB,iBAAiB,MAAM;AAAA,IACvB,SAAS,MAAM;AAAA,IACf,OAAO,CAAC,GAAG,UAAU,eAAe;AAAA,IACpC,YAAY,CAAC,GAAG,MAAM,UAAU;AAAA,IAChC,eAAe,CAAC,GAAG,UAAU,aAAa;AAAA,IAC1C,aAAa,CAAC,GAAG,UAAU,WAAW;AAAA,IACtC,YAAY,MAAM;AAAA,IAClB,iBAAiB,MAAM;AAAA,IACvB,WAAW,MAAM;AAAA,IACjB,cAAc,MAAM;AAAA,IACpB,eAAe,MAAM;AAAA,IACrB,YAAY,CAAC,GAAG,MAAM,UAAU;AAAA,IAChC,aAAa,CAAC,GAAG,MAAM,WAAW;AAAA,IAClC,QAAQ,MAAM;AAAA,EAChB;AACF;","names":[]}

package/dist/observability/index.d.ts

@@ -1,4 +1,4 @@
-export { y as AgentGenerationEndArgs, z as AgentGenerationErrorArgs, B as AgentGenerationModelInfo, C as AgentGenerationObserver, D as AgentGenerationStartArgs, E as AgentGenerationUpdateArgs, F as AgentObservabilityOptions, G as AgentObserver, H as AgentObserverErrorPolicy, I as AgentObserverMap, J as AgentObserverTraceInfo, K as AgentRunEndArgs, L as AgentRunErrorArgs, M as AgentRunEventArgs, N as AgentRunObserver, O as AgentRunPromptRef, P as AgentRunStartArgs, Q as AgentToolEndArgs, R as AgentToolErrorArgs, S as AgentToolObserver, T as AgentToolStartArgs, U as AgentToolStreamEventArgs, V as AgentToolSuspendedArgs, W as AgentTraceInfo, X as AgentTraceOptions } from '../types-BUEZMBhO.js';
+export { y as AgentGenerationEndArgs, z as AgentGenerationErrorArgs, B as AgentGenerationModelInfo, C as AgentGenerationObserver, D as AgentGenerationStartArgs, E as AgentGenerationUpdateArgs, F as AgentObservabilityOptions, G as AgentObserver, H as AgentObserverErrorPolicy, I as AgentObserverMap, J as AgentObserverTraceInfo, K as AgentRunEndArgs, L as AgentRunErrorArgs, M as AgentRunEventArgs, N as AgentRunObserver, O as AgentRunPromptRef, P as AgentRunStartArgs, Q as AgentToolEndArgs, R as AgentToolErrorArgs, S as AgentToolObserver, T as AgentToolStartArgs, U as AgentToolStreamEventArgs, V as AgentToolSuspendedArgs, W as AgentTraceInfo, X as AgentTraceOptions } from '../types-ChH_bdtR.js';
 import '../agent/interactions/index.js';
 import 'zod';
 import '../types-DgvozfPc.js';

package/dist/observability/index.js

@@ -1,6 +1,7 @@
 import {
   AgentObserverDispatchError
-} from "../chunk-AR2K73CJ.js";
+} from "../chunk-34EDX4ZL.js";
+import "../chunk-KSKST3KP.js";
 import "../chunk-D4PACGPA.js";
 import "../chunk-TB5EKZM7.js";
 import "../chunk-7JLAIN6E.js";

package/dist/pipeline/index.d.ts

@@ -1,5 +1,5 @@
-import { g as AgentInteractionOutcome, f as AgentInput, o as AgentRunSettings } from '../types-BUEZMBhO.js';
-import { A as Agent } from '../agent-DYfzP-n5.js';
+import { g as AgentInteractionOutcome, X as AgentTraceOptions, J as AgentObserverTraceInfo, H as AgentObserverErrorPolicy, W as AgentTraceInfo, f as AgentInput, o as AgentRunSettings } from '../types-ChH_bdtR.js';
+import { A as Agent } from '../agent-fvQIBLBk.js';
 import { J as JsonObject, c as CompletionModel } from '../types-DgvozfPc.js';
 import { ExtractOptions } from '../extractor/index.js';
 import { z } from 'zod';
@@ -22,6 +22,15 @@ declare class PipelineAgentSuspensionError extends Error {
     readonly result: AgentInteractionOutcome;
     constructor(result: AgentInteractionOutcome);
 }
+type PipelineObserverFailure = {
+    readonly observer: string;
+    readonly error: unknown;
+};
+declare class PipelineObserverDispatchError extends AggregateError {
+    readonly phase: string;
+    readonly failures: readonly PipelineObserverFailure[];
+    constructor(phase: string, failures: readonly PipelineObserverFailure[]);
+}
 
 type PipelineMetadata = {
     id?: string | undefined;
@@ -35,6 +44,7 @@ type PipelineOptions<Input, Parsed = Input> = {
     name?: string | undefined;
     description?: string | undefined;
     metadata?: JsonObject | undefined;
+    observability?: PipelineObservabilityOptions | undefined;
 };
 type PipelineStageMetadata = {
     id: string;
@@ -93,10 +103,69 @@ type PipelineRunEvent = (PipelineRunEventBase & {
 type PipelineRunObserver = {
     onEvent(event: PipelineRunEvent): void | Promise<void>;
 };
+type PipelineTraceOptions = Omit<AgentTraceOptions, "promptRef">;
+type PipelineTraceInfo = AgentTraceInfo;
+type PipelineObserverTraceInfo = AgentObserverTraceInfo;
+type PipelineObserverErrorPolicy = AgentObserverErrorPolicy;
+type PipelineRunStartArgs = {
+    readonly runId: string;
+    readonly pipelineId: string;
+    readonly pipelineName?: string | undefined;
+    readonly pipelineDescription?: string | undefined;
+    readonly pipelineMetadata?: JsonObject | undefined;
+    readonly runMetadata?: JsonObject | undefined;
+    readonly trace?: PipelineTraceOptions | undefined;
+    readonly input: unknown;
+};
+type PipelineRunEndArgs = {
+    readonly runId: string;
+    readonly pipelineId: string;
+    readonly output: unknown;
+    readonly durationMs: number;
+};
+type PipelineRunErrorArgs = {
+    readonly runId: string;
+    readonly pipelineId: string;
+    readonly status: "failed" | "cancelled";
+    readonly error: unknown;
+    readonly durationMs: number;
+};
+type PipelineStageStartArgs = Readonly<PipelineRunEventBase> & {
+    readonly input: unknown;
+};
+type PipelineStageEndArgs = Readonly<PipelineRunEventBase> & {
+    readonly output: unknown;
+    readonly durationMs: number;
+};
+type PipelineStageErrorArgs = Readonly<PipelineRunEventBase> & {
+    readonly error: unknown;
+    readonly durationMs: number;
+};
+interface PipelineStageObservation {
+    readonly trace?: PipelineObserverTraceInfo | undefined;
+    end(args: PipelineStageEndArgs): void | Promise<void>;
+    error?(args: PipelineStageErrorArgs): void | Promise<void>;
+}
+interface PipelineRunObservation {
+    readonly trace?: PipelineObserverTraceInfo | undefined;
+    startStage?(args: PipelineStageStartArgs): PipelineStageObservation | undefined | Promise<PipelineStageObservation | undefined>;
+    end(args: PipelineRunEndArgs): void | Promise<void>;
+    error?(args: PipelineRunErrorArgs): void | Promise<void>;
+}
+interface PipelineObserver {
+    startRun(args: PipelineRunStartArgs): PipelineRunObservation | undefined | Promise<PipelineRunObservation | undefined>;
+}
+type PipelineObserverMap = Readonly<Record<string, PipelineObserver>>;
+type PipelineObservabilityOptions<Observers extends PipelineObserverMap = PipelineObserverMap> = {
+    readonly observers: Observers;
+    readonly primaryTrace?: Extract<keyof Observers, string> | undefined;
+    readonly errorPolicy?: PipelineObserverErrorPolicy | undefined;
+};
 type PipelineRunOptions<Input> = {
     input: Input;
     runId?: string | undefined;
     metadata?: JsonObject | undefined;
+    trace?: PipelineTraceOptions | undefined;
     abortSignal?: AbortSignal | undefined;
     observer?: PipelineRunObserver | undefined;
     failOnObserverError?: boolean | undefined;
@@ -104,11 +173,13 @@ type PipelineRunOptions<Input> = {
 type PipelineRunResult<Output> = {
     runId: string;
     output: Awaited<Output>;
+    trace?: PipelineTraceInfo | undefined;
 };
 type PipelineBatchOptions<Input> = {
     inputs: Iterable<Input>;
     concurrency: number;
     metadata?: JsonObject | undefined;
+    trace?: PipelineTraceOptions | undefined;
     abortSignal?: AbortSignal | undefined;
     observer?: PipelineRunObserver | undefined;
     failOnObserverError?: boolean | undefined;
@@ -117,6 +188,7 @@ type PipelineBatchItem<Output> = {
     status: "completed";
     runId: string;
     output: Awaited<Output>;
+    trace?: PipelineTraceInfo | undefined;
 } | {
     status: "failed";
     runId: string;
@@ -152,6 +224,7 @@ declare class Pipeline<Input, Output = Input> {
     readonly name: string | undefined;
     readonly description: string | undefined;
     readonly metadata: JsonObject | undefined;
+    readonly observability: PipelineOptions<Input>["observability"];
     private readonly executor;
     private readonly state;
     constructor(options: PipelineOptions<Input, Output>);
@@ -167,4 +240,4 @@ declare class Pipeline<Input, Output = Input> {
     private execute;
 }
 
-export { type ParallelOutput, Pipeline, type PipelineAgentOptions, PipelineAgentSuspensionError, type PipelineBatchItem, type PipelineBatchOptions, type PipelineComposeOptions, type PipelineExtractOptions, type PipelineGraph, type PipelineGraphEdge, type PipelineGraphNode, type PipelineMetadata, type PipelineNodePath, type PipelineOptions, type PipelineParallelOptions, type PipelineRunEvent, type PipelineRunObserver, type PipelineRunOptions, type PipelineRunResult, type PipelineStageContext, type PipelineStageKind, type PipelineStageMetadata, type PipelineStepOptions };
+export { type ParallelOutput, Pipeline, type PipelineAgentOptions, PipelineAgentSuspensionError, type PipelineBatchItem, type PipelineBatchOptions, type PipelineComposeOptions, type PipelineExtractOptions, type PipelineGraph, type PipelineGraphEdge, type PipelineGraphNode, type PipelineMetadata, type PipelineNodePath, type PipelineObservabilityOptions, type PipelineObserver, PipelineObserverDispatchError, type PipelineObserverErrorPolicy, type PipelineObserverFailure, type PipelineObserverMap, type PipelineObserverTraceInfo, type PipelineOptions, type PipelineParallelOptions, type PipelineRunEndArgs, type PipelineRunErrorArgs, type PipelineRunEvent, type PipelineRunObservation, type PipelineRunObserver, type PipelineRunOptions, type PipelineRunResult, type PipelineRunStartArgs, type PipelineStageContext, type PipelineStageEndArgs, type PipelineStageErrorArgs, type PipelineStageKind, type PipelineStageMetadata, type PipelineStageObservation, type PipelineStageStartArgs, type PipelineStepOptions, type PipelineTraceInfo, type PipelineTraceOptions };