agents 0.20.1 → 0.22.0

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

@@ -0,0 +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"}

package/dist/diagnostics-CaBjfz4J.js

@@ -0,0 +1,41 @@
+import { channel } from "node:diagnostics_channel";
+//#region src/observability/diagnostics.ts
+/** Diagnostics channels for Agent and Lifecycle telemetry. */
+const channels = {
+	state: channel("agents:state"),
+	rpc: channel("agents:rpc"),
+	message: channel("agents:message"),
+	chat: channel("agents:chat"),
+	transcript: channel("agents:transcript"),
+	fiber: channel("agents:fiber"),
+	agentTool: channel("agents:agent_tool"),
+	schedule: channel("agents:schedule"),
+	lifecycle: channel("agents:lifecycle"),
+	workflow: channel("agents:workflow"),
+	mcp: channel("agents:mcp"),
+	email: channel("agents:email"),
+	channel: channel("agents:channel")
+};
+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("transcript:") || type.startsWith("chat:transcript:")) return channels.transcript;
+	if (type.startsWith("chat:")) return channels.chat;
+	if (type.startsWith("agent_tool:")) return channels.agentTool;
+	if (type.startsWith("schedule:") || type.startsWith("queue:")) return channels.schedule;
+	if (type.startsWith("message:") || type.startsWith("tool:") || type.startsWith("submission:") || type.startsWith("action:")) return channels.message;
+	if (type === "rpc" || type.startsWith("rpc:")) return channels.rpc;
+	if (type.startsWith("state:")) return channels.state;
+	if (type.startsWith("email:")) return channels.email;
+	if (type.startsWith("channel:") || type.startsWith("notice:")) return channels.channel;
+	return channels.lifecycle;
+}
+/** Publish one event to its existing diagnostics channel. */
+function publishDiagnosticsEvent(event) {
+	getChannel(event.type).publish(event);
+}
+//#endregion
+export { publishDiagnosticsEvent as n, channels as t };
+
+//# sourceMappingURL=diagnostics-CaBjfz4J.js.map

package/dist/diagnostics-CaBjfz4J.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-CaBjfz4J.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  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(\"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,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,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"}

package/dist/{do-oauth-client-provider-VTZj2VtM.d.ts → do-oauth-client-provider-Tmf1vgKz.d.ts}

@@ -7,7 +7,7 @@ import {
   StoredOAuthTokens
 } from "@modelcontextprotocol/client";
 
-//#region src/mcp/do-oauth-client-provider.d.ts
+//#region src/mcp/client/do-oauth-client-provider.d.ts
 interface AgentMcpOAuthProvider extends OAuthClientProvider {
   authUrl: string | undefined;
   clientId: string | undefined;
@@ -107,4 +107,4 @@ export {
   DurableObjectOAuthClientProvider as r,
   AgentMcpOAuthProvider as t
 };
-//# sourceMappingURL=do-oauth-client-provider-VTZj2VtM.d.ts.map
+//# sourceMappingURL=do-oauth-client-provider-Tmf1vgKz.d.ts.map