agents 0.22.0 → 0.23.0

package/dist/{current-agent-CuMErtly.d.ts → current-agent-Da_C9a3b.d.ts}

@@ -1,80 +1,42 @@
 import {
+  _ as LifecycleJobOutcome,
+  b as Connection,
+  g as LifecycleJobContext,
   i as DurableObjectCapability,
-  l as LifecycleRouteAddress,
-  t as AlarmContribution
-} from "./capability-runner-CvHGZqUu.js";
+  o as MemoryLimitContext,
+  u as LifecycleRouteAddress,
+  w as WSMessage,
+  y as LifecycleJobs
+} from "./capability-runner-Be_-PLR1.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { DurableObject } from "cloudflare:workers";
 
-//#region src/lifecycle/types.d.ts
-type ImmutablePrimitive = undefined | null | boolean | string | number;
-type Immutable<T> = T extends ImmutablePrimitive
-  ? T
-  : T extends Array<infer U>
-    ? ImmutableArray<U>
-    : T extends Map<infer K, infer V>
-      ? ImmutableMap<K, V>
-      : T extends Set<infer M>
-        ? ImmutableSet<M>
-        : ImmutableObject<T>;
-type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
-type ImmutableMap<K, V> = ReadonlyMap<Immutable<K>, Immutable<V>>;
-type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
-type ImmutableObject<T> = { readonly [K in keyof T]: Immutable<T[K]> };
-/** Immutable state persisted in a hibernating WebSocket attachment. */
-type ConnectionState<T> = ImmutableObject<T> | null;
-/** Functional update applied to a connection's current state. */
-type ConnectionSetStateFn<T> = (prevState: ConnectionState<T>) => T;
-/** Context supplied when a lifecycle accepts a WebSocket connection. */
-type ConnectionContext = {
-  /** Original WebSocket upgrade request. */ request: Request;
-};
-/** A WebSocket managed by a Durable Object lifecycle. */
-type Connection<TState = unknown> = WebSocket & {
-  /** Connection identifier */ id: string;
-  /**
-   * The URL of the original WebSocket upgrade request.
-   * Persisted in the WebSocket attachment so it survives hibernation.
-   */
-  uri: string | null;
-  /**
-   * Arbitrary state associated with this connection.
-   * Read-only — use {@link Connection.setState} to update.
-   *
-   * This property is configurable, meaning it can be redefined via
-   * `Object.defineProperty` by downstream consumers (e.g. the Cloudflare
-   * Agents SDK) to namespace or wrap internal state storage.
-   */
-  state: ConnectionState<TState>;
-  /**
-   * Update the state associated with this connection.
-   *
-   * Accepts either a new state value or an updater function that receives
-   * the previous state and returns the next state.
-   *
-   * This property is configurable, meaning it can be redefined via
-   * `Object.defineProperty` by downstream consumers that provide their own
-   * state projection.
-   */
-  setState(
-    state: TState | ConnectionSetStateFn<TState> | null
-  ): ConnectionState<TState>;
-  /**
-   * Tags returned by the owning Durable Object's `getConnectionTags` callback.
-   * Always includes the connection id as the first tag.
-   */
-  tags: readonly string[];
-};
-//#endregion
 //#region src/lifecycle/durable-object-lifecycle.d.ts
-/** Payload delivered to a lifecycle-managed WebSocket callback. */
-type WSMessage = ArrayBuffer | ArrayBufferView | string;
 /** Internal envelope transported between routed Lifecycle instances. */
 type LifecycleRouteEnvelope = {
   readonly capability: string;
   readonly source: LifecycleRouteAddress | undefined;
   readonly payload: unknown;
 };
+/** Configuration accepted when constructing a {@link Lifecycle}. */
+type LifecycleOptions = {
+  /**
+   * Consecutive alarm invocations that may end in a Durable Object
+   * memory-limit reset before the circuit breaker (#1825) seals recovery
+   * work instead of backing it off. Default: 3.
+   */
+  readonly maxAlarmMemoryLimitStrikes?: number;
+};
+/** Placement of a capability in the dispatch order. */
+type LifecycleUseOptions = {
+  /**
+   * Dispatch after every non-fallback capability, whenever it was
+   * installed. For a host's catch-all, such as a WebSockets capability
+   * that claims every upgrade, so middleware installed later still runs
+   * first.
+   */
+  readonly fallback?: boolean;
+};
 /**
  * Installs and coordinates the runtime lifecycle for a Durable Object.
  *
@@ -98,13 +60,17 @@ declare class Lifecycle<
   static install<
     Env extends object,
     Props extends Record<string, unknown> = Record<string, unknown>
-  >(host: DurableObject<Env>): Lifecycle<Env, Props>;
+  >(
+    host: DurableObject<Env>,
+    options?: LifecycleOptions
+  ): Lifecycle<Env, Props>;
   /**
    * Bind a lifecycle to a Durable Object instance without mutating its handlers.
    *
    * @param host - The Durable Object whose runtime lifecycle this object owns.
+   * @param options - Policy configuration for this lifecycle.
    */
-  constructor(host: DurableObject<Env>);
+  constructor(host: DurableObject<Env>, options?: LifecycleOptions);
   /**
    * Install platform fetch, alarm, and hibernating WebSocket handlers.
    *
@@ -116,10 +82,17 @@ declare class Lifecycle<
   /**
    * Add a reusable capability before this lifecycle starts.
    *
-   * @param capability - The capability to add in dispatch order.
+   * Capabilities dispatch in registration order, except that fallbacks
+   * always come after non-fallbacks.
+   *
+   * @param capability - The capability to add.
+   * @param options - Dispatch placement.
    * @returns This lifecycle.
    */
-  use(capability: DurableObjectCapability<Props>): this;
+  use(
+    capability: DurableObjectCapability<Props>,
+    options?: LifecycleUseOptions
+  ): this;
   /** @internal Deliver a generic capability envelope to this Lifecycle. */
   route(envelope: LifecycleRouteEnvelope): Promise<unknown>;
   /**
@@ -135,11 +108,14 @@ declare class Lifecycle<
   ): T[];
   /**
    * Handle an incoming request for the owning Durable Object.
+   *
+   * Non-upgrade requests run through the capability middleware chain first,
+   * then fall through to the host's `onRequest`.
    */
   fetch(request: Request): Promise<Response>;
   /** @internal Dispatch a hibernating WebSocket message. */
   webSocketMessage(ws: WebSocket, message: WSMessage): Promise<void>;
-  /** @internal Dispatch and reciprocate a hibernating WebSocket close. */
+  /** @internal Dispatch a hibernating WebSocket close. */
   webSocketClose(
     ws: WebSocket,
     code: number,
@@ -165,27 +141,39 @@ declare class Lifecycle<
    * name writes.
    */
   get name(): string;
-  /** Send a message to all connected clients, except connection ids listed in `without` */
-  broadcast(
-    msg: string | ArrayBuffer | ArrayBufferView,
-    without?: string[] | undefined
-  ): void;
-  /** Get a connection by connection id */
-  getConnection<TState = unknown>(id: string): Connection<TState> | undefined;
-  /** Get all managed connections, optionally filtered by tag. */
-  getConnections<TState = unknown>(tag?: string): Iterable<Connection<TState>>;
   /**
-   * Recompute the physical Durable Object alarm from every capability.
+   * The host's scoped access to the Lifecycle work queue. Items pushed here
+   * are dispatched to the host's `onJob` inside the host invocation
+   * boundary.
+   */
+  get jobs(): LifecycleJobs;
+  /**
+   * Recompute the physical Durable Object alarm from job-queue state.
    *
    * Concurrent requests are serialized so a later durable-state change cannot
-   * be overwritten by an earlier alarm calculation.
+   * be overwritten by an earlier alarm calculation. Queue mutations call this
+   * automatically; it stays public for composition roots and tests.
    */
   rearmAlarm(): Promise<void>;
+  /**
+   * Keep work a job handed off at a bounded return inside the current
+   * alarm's memory-limit breaker domain (#1825). Hosts call this where a
+   * queue-driven callback detaches long work and returns.
+   *
+   * @returns True when called during an alarm invocation; false otherwise.
+   */
+  trackAlarmWork(work: Promise<unknown>): boolean;
   /** Dispose installed capabilities in reverse registration order. */
   dispose(): Promise<void>;
   /** Permanently disable and clear alarms during explicit object teardown. */
   disableAlarms(): Promise<void>;
-  /** Dispatch lifecycle and host alarm callbacks after startup. */
+  /**
+   * Run one alarm invocation. The job driver owns the event loop — deadman
+   * pre-arm, due-job dispatch with retry and deferral policy, the alarm
+   * memory-limit circuit breaker (#1825) — and re-arms the physical alarm
+   * from queue state. The host's `onAlarm()` runs after due jobs, inside
+   * the host invocation boundary.
+   */
   alarm(): Promise<void>;
 }
 //#endregion
@@ -206,23 +194,21 @@ interface LifecycleObject<
   onStart?(props?: Props): void | Promise<void>;
   onRequest?(request: Request): Response | Promise<Response>;
   onAlarm?(): void | Promise<void>;
-  getNextAlarm?(): AlarmContribution | Promise<AlarmContribution>;
-  onConnect?(
-    connection: Connection,
-    context: ConnectionContext
-  ): void | Promise<void>;
-  onMessage?(connection: Connection, message: WSMessage): void | Promise<void>;
-  onClose?(
-    connection: Connection,
-    code: number,
-    reason: string,
-    wasClean: boolean
-  ): void | Promise<void>;
-  onError?(connection: Connection, error: unknown): void | Promise<void>;
-  getConnectionTags?(
-    connection: Connection,
-    context: ConnectionContext
-  ): string[] | Promise<string[]>;
+  onJob?(
+    context: LifecycleJobContext
+  ): LifecycleJobOutcome | void | Promise<LifecycleJobOutcome | void>;
+  /**
+   * Host domain policy applied when the alarm memory-limit circuit breaker
+   * records a strike (#1825), after every capability's `onMemoryLimit` hook.
+   *
+   * Lifecycle dispatches host hooks structurally through its internal host
+   * cast, so TS visibility is the host's to choose: a framework host whose
+   * implementation is internal machinery declares the hook `protected` (the
+   * pattern — see `AIChatAgent`/`Think`) and keeps the real work in a
+   * `private _cf_`-prefixed method, without falling out of this contract at
+   * runtime.
+   */
+  onAlarmMemoryLimit?(context: MemoryLimitContext): void | Promise<void>;
 }
 /** Values associated with the currently executing Lifecycle host. */
 type AgentContextStore = {
@@ -268,16 +254,13 @@ declare function getCurrentAgent<
 //#endregion
 export {
   getCurrentAgent as a,
-  WSMessage as c,
-  ConnectionSetStateFn as d,
-  ConnectionState as f,
+  LifecycleRouteEnvelope as c,
   __DO_NOT_USE_WILL_BREAK__agentContext as i,
-  Connection as l,
+  LifecycleUseOptions as l,
   CurrentAgentContext as n,
   Lifecycle as o,
   LifecycleObject as r,
-  LifecycleRouteEnvelope as s,
-  AgentContextStore as t,
-  ConnectionContext as u
+  LifecycleOptions as s,
+  AgentContextStore as t
 };
-//# sourceMappingURL=current-agent-CuMErtly.d.ts.map
+//# sourceMappingURL=current-agent-Da_C9a3b.d.ts.map

package/dist/current-agent-DhoDkSnH.js.map

@@ -1 +1 @@
-{"version":3,"file":"current-agent-DhoDkSnH.js","names":[],"sources":["../src/lifecycle/current-agent.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { DurableObject } from \"cloudflare:workers\";\n\nimport type { AlarmContribution } from \"./capability-runner\";\nimport type { Lifecycle, WSMessage } from \"./durable-object-lifecycle\";\nimport type { Connection, ConnectionContext } from \"./types\";\n\n/**\n * A Durable Object that has installed the Agents SDK Lifecycle.\n *\n * Pass a more specific Lifecycle Object type to {@link getCurrentAgent} when\n * shared host code needs APIs implemented by a particular object.\n *\n * @experimental The API surface may change before stabilizing.\n */\nexport interface LifecycleObject<\n  Env extends object = Cloudflare.Env,\n  Props extends Record<string, unknown> = Record<string, unknown>\n> extends DurableObject<Env> {\n  readonly lifecycle: Lifecycle<Env, Props>;\n  onStart?(props?: Props): void | Promise<void>;\n  onRequest?(request: Request): Response | Promise<Response>;\n  onAlarm?(): void | Promise<void>;\n  getNextAlarm?(): AlarmContribution | Promise<AlarmContribution>;\n  onConnect?(\n    connection: Connection,\n    context: ConnectionContext\n  ): void | Promise<void>;\n  onMessage?(connection: Connection, message: WSMessage): void | Promise<void>;\n  onClose?(\n    connection: Connection,\n    code: number,\n    reason: string,\n    wasClean: boolean\n  ): void | Promise<void>;\n  onError?(connection: Connection, error: unknown): void | Promise<void>;\n  getConnectionTags?(\n    connection: Connection,\n    context: ConnectionContext\n  ): string[] | Promise<string[]>;\n}\n\n/** Values associated with the currently executing Lifecycle host. */\nexport type AgentContextStore = {\n  /** Lifecycle host selected for this invocation. */\n  agent: unknown;\n  /** WebSocket connection selected for this invocation, when applicable. */\n  connection: Connection | undefined;\n  /** HTTP request selected for this invocation, when applicable. */\n  request: Request | undefined;\n  /** Extension-owned value selected for this invocation, when applicable. */\n  email: unknown;\n};\n\n/** Values returned by {@link getCurrentAgent}. */\nexport type CurrentAgentContext<\n  Host extends DurableObject = LifecycleObject,\n  Email = unknown\n> = {\n  agent: Host | undefined;\n  connection: Connection | undefined;\n  request: Request | undefined;\n  email: Email | undefined;\n};\n\n/**\n * Shared invocation context for Lifecycle, Agent, AIChatAgent, and Think.\n *\n * @internal Importing or relying on this symbol will break your code in a\n * future release. Use {@link getCurrentAgent} to read the public context.\n */\nexport const __DO_NOT_USE_WILL_BREAK__agentContext =\n  new AsyncLocalStorage<AgentContextStore>();\n\n/**\n * Return the current Agent or Lifecycle Object and invocation-specific values.\n *\n * Lifecycle host startup and alarm hooks receive the current object with no\n * request. Request hooks additionally receive the request being handled.\n * Lifecycle-managed WebSocket hooks receive their connection and, during\n * connect, its upgrade request. Agent extensions may also establish context\n * for email, chat turns, callable methods, and detached work. Capability hooks\n * do not run in this ambient context.\n */\nexport function getCurrentAgent<\n  Host extends DurableObject = LifecycleObject\n>(): CurrentAgentContext<Host> {\n  const store = __DO_NOT_USE_WILL_BREAK__agentContext.getStore();\n  if (!store) {\n    return {\n      agent: undefined,\n      connection: undefined,\n      request: undefined,\n      email: undefined\n    };\n  }\n\n  return {\n    agent: store.agent as Host,\n    connection: store.connection,\n    request: store.request,\n    email: store.email\n  };\n}\n\ntype LifecycleHostContext<\n  Env extends object,\n  Props extends Record<string, unknown>\n> = {\n  readonly host: LifecycleObject<Env, Props>;\n  readonly connection?: Connection;\n  readonly request?: Request;\n};\n\n/** Run one host hook in the context of its Lifecycle Object. */\nexport function runInLifecycleHostContext<\n  Env extends object,\n  Props extends Record<string, unknown>,\n  T\n>(context: LifecycleHostContext<Env, Props>, operation: () => T): T {\n  return __DO_NOT_USE_WILL_BREAK__agentContext.run(\n    {\n      agent: context.host,\n      connection: context.connection,\n      request: context.request,\n      email: undefined\n    },\n    operation\n  );\n}\n\n/** Run a capability hook without inheriting a current Agent or host context. */\nexport function runWithoutCurrentAgent<T>(operation: () => T): T {\n  return __DO_NOT_USE_WILL_BREAK__agentContext.exit(operation);\n}\n"],"mappings":";;;;;;;;AAuEA,MAAa,wCACX,IAAI,kBAAqC;;;;;;;;;;;AAY3C,SAAgB,kBAEe;CAC7B,MAAM,QAAQ,sCAAsC,SAAS;CAC7D,IAAI,CAAC,OACH,OAAO;EACL,OAAO,KAAA;EACP,YAAY,KAAA;EACZ,SAAS,KAAA;EACT,OAAO,KAAA;CACT;CAGF,OAAO;EACL,OAAO,MAAM;EACb,YAAY,MAAM;EAClB,SAAS,MAAM;EACf,OAAO,MAAM;CACf;AACF;;AAYA,SAAgB,0BAId,SAA2C,WAAuB;CAClE,OAAO,sCAAsC,IAC3C;EACE,OAAO,QAAQ;EACf,YAAY,QAAQ;EACpB,SAAS,QAAQ;EACjB,OAAO,KAAA;CACT,GACA,SACF;AACF;;AAGA,SAAgB,uBAA0B,WAAuB;CAC/D,OAAO,sCAAsC,KAAK,SAAS;AAC7D"}
+{"version":3,"file":"current-agent-DhoDkSnH.js","names":[],"sources":["../src/lifecycle/current-agent.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { DurableObject } from \"cloudflare:workers\";\n\nimport type { MemoryLimitContext } from \"./capability-runner\";\nimport type { Lifecycle } from \"./durable-object-lifecycle\";\nimport type { Connection } from \"./types\";\nimport type { LifecycleJobContext, LifecycleJobOutcome } from \"./job-queue\";\n\n/**\n * A Durable Object that has installed the Agents SDK Lifecycle.\n *\n * Pass a more specific Lifecycle Object type to {@link getCurrentAgent} when\n * shared host code needs APIs implemented by a particular object.\n *\n * @experimental The API surface may change before stabilizing.\n */\nexport interface LifecycleObject<\n  Env extends object = Cloudflare.Env,\n  Props extends Record<string, unknown> = Record<string, unknown>\n> extends DurableObject<Env> {\n  readonly lifecycle: Lifecycle<Env, Props>;\n  onStart?(props?: Props): void | Promise<void>;\n  onRequest?(request: Request): Response | Promise<Response>;\n  onAlarm?(): void | Promise<void>;\n  onJob?(\n    context: LifecycleJobContext\n  ): LifecycleJobOutcome | void | Promise<LifecycleJobOutcome | void>;\n  /**\n   * Host domain policy applied when the alarm memory-limit circuit breaker\n   * records a strike (#1825), after every capability's `onMemoryLimit` hook.\n   *\n   * Lifecycle dispatches host hooks structurally through its internal host\n   * cast, so TS visibility is the host's to choose: a framework host whose\n   * implementation is internal machinery declares the hook `protected` (the\n   * pattern — see `AIChatAgent`/`Think`) and keeps the real work in a\n   * `private _cf_`-prefixed method, without falling out of this contract at\n   * runtime.\n   */\n  onAlarmMemoryLimit?(context: MemoryLimitContext): void | Promise<void>;\n}\n\n/** Values associated with the currently executing Lifecycle host. */\nexport type AgentContextStore = {\n  /** Lifecycle host selected for this invocation. */\n  agent: unknown;\n  /** WebSocket connection selected for this invocation, when applicable. */\n  connection: Connection | undefined;\n  /** HTTP request selected for this invocation, when applicable. */\n  request: Request | undefined;\n  /** Extension-owned value selected for this invocation, when applicable. */\n  email: unknown;\n};\n\n/** Values returned by {@link getCurrentAgent}. */\nexport type CurrentAgentContext<\n  Host extends DurableObject = LifecycleObject,\n  Email = unknown\n> = {\n  agent: Host | undefined;\n  connection: Connection | undefined;\n  request: Request | undefined;\n  email: Email | undefined;\n};\n\n/**\n * Shared invocation context for Lifecycle, Agent, AIChatAgent, and Think.\n *\n * @internal Importing or relying on this symbol will break your code in a\n * future release. Use {@link getCurrentAgent} to read the public context.\n */\nexport const __DO_NOT_USE_WILL_BREAK__agentContext =\n  new AsyncLocalStorage<AgentContextStore>();\n\n/**\n * Return the current Agent or Lifecycle Object and invocation-specific values.\n *\n * Lifecycle host startup and alarm hooks receive the current object with no\n * request. Request hooks additionally receive the request being handled.\n * Lifecycle-managed WebSocket hooks receive their connection and, during\n * connect, its upgrade request. Agent extensions may also establish context\n * for email, chat turns, callable methods, and detached work. Capability hooks\n * do not run in this ambient context.\n */\nexport function getCurrentAgent<\n  Host extends DurableObject = LifecycleObject\n>(): CurrentAgentContext<Host> {\n  const store = __DO_NOT_USE_WILL_BREAK__agentContext.getStore();\n  if (!store) {\n    return {\n      agent: undefined,\n      connection: undefined,\n      request: undefined,\n      email: undefined\n    };\n  }\n\n  return {\n    agent: store.agent as Host,\n    connection: store.connection,\n    request: store.request,\n    email: store.email\n  };\n}\n\ntype LifecycleHostContext<\n  Env extends object,\n  Props extends Record<string, unknown>\n> = {\n  readonly host: LifecycleObject<Env, Props>;\n  readonly connection?: Connection;\n  readonly request?: Request;\n};\n\n/** Run one host hook in the context of its Lifecycle Object. */\nexport function runInLifecycleHostContext<\n  Env extends object,\n  Props extends Record<string, unknown>,\n  T\n>(context: LifecycleHostContext<Env, Props>, operation: () => T): T {\n  return __DO_NOT_USE_WILL_BREAK__agentContext.run(\n    {\n      agent: context.host,\n      connection: context.connection,\n      request: context.request,\n      email: undefined\n    },\n    operation\n  );\n}\n\n/** Run a capability hook without inheriting a current Agent or host context. */\nexport function runWithoutCurrentAgent<T>(operation: () => T): T {\n  return __DO_NOT_USE_WILL_BREAK__agentContext.exit(operation);\n}\n"],"mappings":";;;;;;;;AAsEA,MAAa,wCACX,IAAI,kBAAqC;;;;;;;;;;;AAY3C,SAAgB,kBAEe;CAC7B,MAAM,QAAQ,sCAAsC,SAAS;CAC7D,IAAI,CAAC,OACH,OAAO;EACL,OAAO,KAAA;EACP,YAAY,KAAA;EACZ,SAAS,KAAA;EACT,OAAO,KAAA;CACT;CAGF,OAAO;EACL,OAAO,MAAM;EACb,YAAY,MAAM;EAClB,SAAS,MAAM;EACf,OAAO,MAAM;CACf;AACF;;AAYA,SAAgB,0BAId,SAA2C,WAAuB;CAClE,OAAO,sCAAsC,IAC3C;EACE,OAAO,QAAQ;EACf,YAAY,QAAQ;EACpB,SAAS,QAAQ;EACjB,OAAO,KAAA;CACT,GACA,SACF;AACF;;AAGA,SAAgB,uBAA0B,WAAuB;CAC/D,OAAO,sCAAsC,KAAK,SAAS;AAC7D"}

package/dist/{diagnostics-CaBjfz4J.js → diagnostics-BzvaX2UT.js}

@@ -8,6 +8,8 @@ const channels = {
 	chat: channel("agents:chat"),
 	transcript: channel("agents:transcript"),
 	fiber: channel("agents:fiber"),
+	task: channel("agents:task"),
+	stream: channel("agents:stream"),
 	agentTool: channel("agents:agent_tool"),
 	schedule: channel("agents:schedule"),
 	lifecycle: channel("agents:lifecycle"),
@@ -20,6 +22,8 @@ function getChannel(type) {
 	if (type.startsWith("mcp:")) return channels.mcp;
 	if (type.startsWith("workflow:")) return channels.workflow;
 	if (type.startsWith("fiber:")) return channels.fiber;
+	if (type.startsWith("task:")) return channels.task;
+	if (type.startsWith("stream:")) return channels.stream;
 	if (type.startsWith("transcript:") || type.startsWith("chat:transcript:")) return channels.transcript;
 	if (type.startsWith("chat:")) return channels.chat;
 	if (type.startsWith("agent_tool:")) return channels.agentTool;
@@ -38,4 +42,4 @@ function publishDiagnosticsEvent(event) {
 //#endregion
 export { publishDiagnosticsEvent as n, channels as t };
 
-//# sourceMappingURL=diagnostics-CaBjfz4J.js.map
+//# sourceMappingURL=diagnostics-BzvaX2UT.js.map

package/dist/diagnostics-BzvaX2UT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-BzvaX2UT.js","names":[],"sources":["../src/observability/diagnostics.ts"],"sourcesContent":["import { channel, type Channel } from \"node:diagnostics_channel\";\n\n/** Event shape accepted by the diagnostics-channel publisher. */\nexport type DiagnosticsEvent = {\n  readonly type: string;\n  readonly source?: string;\n  readonly agent?: string;\n  readonly name?: string;\n  readonly payload: unknown;\n  readonly timestamp: number;\n};\n\n/** Diagnostics channels for Agent and Lifecycle telemetry. */\nexport const channels = {\n  state: channel(\"agents:state\"),\n  rpc: channel(\"agents:rpc\"),\n  message: channel(\"agents:message\"),\n  chat: channel(\"agents:chat\"),\n  transcript: channel(\"agents:transcript\"),\n  fiber: channel(\"agents:fiber\"),\n  task: channel(\"agents:task\"),\n  stream: channel(\"agents:stream\"),\n  agentTool: channel(\"agents:agent_tool\"),\n  schedule: channel(\"agents:schedule\"),\n  lifecycle: channel(\"agents:lifecycle\"),\n  workflow: channel(\"agents:workflow\"),\n  mcp: channel(\"agents:mcp\"),\n  email: channel(\"agents:email\"),\n  channel: channel(\"agents:channel\")\n} as const;\n\nfunction getChannel(type: string): Channel {\n  if (type.startsWith(\"mcp:\")) return channels.mcp;\n  if (type.startsWith(\"workflow:\")) return channels.workflow;\n  if (type.startsWith(\"fiber:\")) return channels.fiber;\n  if (type.startsWith(\"task:\")) return channels.task;\n  if (type.startsWith(\"stream:\")) return channels.stream;\n  if (type.startsWith(\"transcript:\") || type.startsWith(\"chat:transcript:\"))\n    return channels.transcript;\n  if (type.startsWith(\"chat:\")) return channels.chat;\n  if (type.startsWith(\"agent_tool:\")) return channels.agentTool;\n  if (type.startsWith(\"schedule:\") || type.startsWith(\"queue:\"))\n    return channels.schedule;\n  if (\n    type.startsWith(\"message:\") ||\n    type.startsWith(\"tool:\") ||\n    type.startsWith(\"submission:\") ||\n    type.startsWith(\"action:\")\n  )\n    return channels.message;\n  if (type === \"rpc\" || type.startsWith(\"rpc:\")) return channels.rpc;\n  if (type.startsWith(\"state:\")) return channels.state;\n  if (type.startsWith(\"email:\")) return channels.email;\n  if (type.startsWith(\"channel:\") || type.startsWith(\"notice:\"))\n    return channels.channel;\n  return channels.lifecycle;\n}\n\n/** Publish one event to its existing diagnostics channel. */\nexport function publishDiagnosticsEvent(event: DiagnosticsEvent): void {\n  getChannel(event.type).publish(event);\n}\n"],"mappings":";;;AAaA,MAAa,WAAW;CACtB,OAAO,QAAQ,cAAc;CAC7B,KAAK,QAAQ,YAAY;CACzB,SAAS,QAAQ,gBAAgB;CACjC,MAAM,QAAQ,aAAa;CAC3B,YAAY,QAAQ,mBAAmB;CACvC,OAAO,QAAQ,cAAc;CAC7B,MAAM,QAAQ,aAAa;CAC3B,QAAQ,QAAQ,eAAe;CAC/B,WAAW,QAAQ,mBAAmB;CACtC,UAAU,QAAQ,iBAAiB;CACnC,WAAW,QAAQ,kBAAkB;CACrC,UAAU,QAAQ,iBAAiB;CACnC,KAAK,QAAQ,YAAY;CACzB,OAAO,QAAQ,cAAc;CAC7B,SAAS,QAAQ,gBAAgB;AACnC;AAEA,SAAS,WAAW,MAAuB;CACzC,IAAI,KAAK,WAAW,MAAM,GAAG,OAAO,SAAS;CAC7C,IAAI,KAAK,WAAW,WAAW,GAAG,OAAO,SAAS;CAClD,IAAI,KAAK,WAAW,QAAQ,GAAG,OAAO,SAAS;CAC/C,IAAI,KAAK,WAAW,OAAO,GAAG,OAAO,SAAS;CAC9C,IAAI,KAAK,WAAW,SAAS,GAAG,OAAO,SAAS;CAChD,IAAI,KAAK,WAAW,aAAa,KAAK,KAAK,WAAW,kBAAkB,GACtE,OAAO,SAAS;CAClB,IAAI,KAAK,WAAW,OAAO,GAAG,OAAO,SAAS;CAC9C,IAAI,KAAK,WAAW,aAAa,GAAG,OAAO,SAAS;CACpD,IAAI,KAAK,WAAW,WAAW,KAAK,KAAK,WAAW,QAAQ,GAC1D,OAAO,SAAS;CAClB,IACE,KAAK,WAAW,UAAU,KAC1B,KAAK,WAAW,OAAO,KACvB,KAAK,WAAW,aAAa,KAC7B,KAAK,WAAW,SAAS,GAEzB,OAAO,SAAS;CAClB,IAAI,SAAS,SAAS,KAAK,WAAW,MAAM,GAAG,OAAO,SAAS;CAC/D,IAAI,KAAK,WAAW,QAAQ,GAAG,OAAO,SAAS;CAC/C,IAAI,KAAK,WAAW,QAAQ,GAAG,OAAO,SAAS;CAC/C,IAAI,KAAK,WAAW,UAAU,KAAK,KAAK,WAAW,SAAS,GAC1D,OAAO,SAAS;CAClB,OAAO,SAAS;AAClB;;AAGA,SAAgB,wBAAwB,OAA+B;CACrE,WAAW,MAAM,IAAI,CAAC,CAAC,QAAQ,KAAK;AACtC"}