agents 0.31.0 → 0.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (105) hide show
  1. package/dist/{agent-routing-wS1TimZ_.d.ts → agent-routing-vVMA7m8Y.d.ts} +6 -6
  2. package/dist/agent-routing.d.ts +1 -1
  3. package/dist/agent-tool-types.d.ts +1 -1
  4. package/dist/{agent-tools-Bamxxb6Y.d.ts → agent-tools-gGXXkf1z.d.ts} +2 -2
  5. package/dist/agent-tools.d.ts +1 -1
  6. package/dist/agent-tools.js +0 -1
  7. package/dist/agent-tools.js.map +1 -1
  8. package/dist/browser/ai.js +1 -1
  9. package/dist/browser/tools/ai-sdk.d.ts +66 -1
  10. package/dist/browser/tools/ai-sdk.js +2 -2
  11. package/dist/browser/tools/pi.js +2 -2
  12. package/dist/browser/tools/tanstack-ai.d.ts +2 -2
  13. package/dist/browser/tools/tanstack-ai.js +2 -2
  14. package/dist/browser/tools/tanstack-ai.js.map +1 -1
  15. package/dist/{browser-tool-lGnvEBLJ.js → browser-tool-DRan7Lk6.js} +2 -2
  16. package/dist/{browser-tool-lGnvEBLJ.js.map → browser-tool-DRan7Lk6.js.map} +1 -1
  17. package/dist/catalog-BpOejOsE.js +239 -0
  18. package/dist/catalog-BpOejOsE.js.map +1 -0
  19. package/dist/catalog-BpiVV1OF.d.ts +173 -0
  20. package/dist/chat/index.d.ts +2 -2
  21. package/dist/chat-sdk/index.d.ts +1 -1
  22. package/dist/chat-sdk/index.js +1 -1
  23. package/dist/{client-wn4-yqGz.d.ts → client-eSfgYvd3.d.ts} +2 -2
  24. package/dist/client.d.ts +1 -1
  25. package/dist/{cloudflare-Dzvc7V2N.js → cloudflare-CUUm_9q9.js} +26 -4
  26. package/dist/cloudflare-CUUm_9q9.js.map +1 -0
  27. package/dist/{do-oauth-client-provider-DfsUcpc3.d.ts → do-oauth-client-provider-DtNqv7oj.d.ts} +26 -2
  28. package/dist/{index-YSKgfgg9.d.ts → emitter-BJZtCVjQ.d.ts} +6 -140
  29. package/dist/emitter-DPOVcCln.js +15 -0
  30. package/dist/emitter-DPOVcCln.js.map +1 -0
  31. package/dist/experimental/channels/web/index.js +1 -1
  32. package/dist/harness/container/index.js +0 -1
  33. package/dist/harness/container/index.js.map +1 -1
  34. package/dist/harness/container/runtime/index.js +2 -2
  35. package/dist/harness/opencode/index.js +0 -1
  36. package/dist/harness/opencode/index.js.map +1 -1
  37. package/dist/harness/pi/index.d.ts +11 -4
  38. package/dist/harness/pi/index.js +43 -141
  39. package/dist/harness/pi/index.js.map +1 -1
  40. package/dist/index.d.ts +2 -3
  41. package/dist/index.js +2 -2
  42. package/dist/markdown-BZ-VLtA1.js +86 -0
  43. package/dist/markdown-BZ-VLtA1.js.map +1 -0
  44. package/dist/mcp/client/do-oauth-client-provider.d.ts +4 -2
  45. package/dist/mcp/client/do-oauth-client-provider.js +15 -1
  46. package/dist/mcp/client/do-oauth-client-provider.js.map +1 -1
  47. package/dist/mcp/client/index.d.ts +1 -1
  48. package/dist/mcp/index.d.ts +1 -1
  49. package/dist/mcp/index.js +1 -1
  50. package/dist/models/pi-ai/index.js +129 -2
  51. package/dist/models/pi-ai/index.js.map +1 -1
  52. package/dist/observability/ai/index.js +1 -2
  53. package/dist/observability/ai/index.js.map +1 -1
  54. package/dist/observability/index.d.ts +170 -9
  55. package/dist/observability/index.js +386 -11
  56. package/dist/observability/index.js.map +1 -1
  57. package/dist/react.d.ts +2 -2
  58. package/dist/resource-B59OV2a2.js +325 -0
  59. package/dist/resource-B59OV2a2.js.map +1 -0
  60. package/dist/routing/index.d.ts +1 -1
  61. package/dist/script-CFDLTk5b.d.ts +91 -0
  62. package/dist/script-workspace-BpdAYq1R.d.ts +41 -0
  63. package/dist/serializable.d.ts +1 -1
  64. package/dist/skill-DRBcIBjC.d.ts +221 -0
  65. package/dist/skills/index.d.ts +275 -36
  66. package/dist/skills/index.js +265 -1534
  67. package/dist/skills/index.js.map +1 -1
  68. package/dist/skills/runner.d.ts +37 -0
  69. package/dist/skills/runner.js +912 -0
  70. package/dist/skills/runner.js.map +1 -0
  71. package/dist/skills/tools/ai-sdk.d.ts +36 -0
  72. package/dist/skills/tools/ai-sdk.js +94 -0
  73. package/dist/skills/tools/ai-sdk.js.map +1 -0
  74. package/dist/source-9RQzlEhM.d.ts +112 -0
  75. package/dist/{src-BGolXG_H.js → src-DoGNJ4Ud.js} +4 -5
  76. package/dist/src-DoGNJ4Ud.js.map +1 -0
  77. package/dist/sub-routing.d.ts +1 -1
  78. package/dist/tool-CxKsvxjm.js.map +1 -1
  79. package/dist/tool-DkT_DJBm.js.map +1 -1
  80. package/dist/{tool-helpers-BodWi4gd.js → tool-helpers-BI7ifO2S.js} +1 -2
  81. package/dist/{tool-helpers-BodWi4gd.js.map → tool-helpers-BI7ifO2S.js.map} +1 -1
  82. package/dist/vite.d.ts +2 -2
  83. package/dist/vite.js +10 -258
  84. package/dist/vite.js.map +1 -1
  85. package/dist/voice/index.d.ts +1 -1
  86. package/dist/websockets/index.js +1 -1
  87. package/dist/{websockets-CyoeosdO.js → websockets-C6SJtWCJ.js} +1 -2
  88. package/dist/{websockets-CyoeosdO.js.map → websockets-C6SJtWCJ.js.map} +1 -1
  89. package/dist/workflow-types.d.ts +1 -1
  90. package/dist/workflows.d.ts +1 -1
  91. package/dist/workflows.js +0 -1
  92. package/dist/workflows.js.map +1 -1
  93. package/docs/harnesses/pi.md +9 -3
  94. package/docs/mcp-client.md +23 -1
  95. package/docs/mcp-servers.md +2 -2
  96. package/docs/observability.md +5 -3
  97. package/package.json +24 -15
  98. package/dist/ai-sdk-hW3vntnk.d.ts +0 -72
  99. package/dist/cloudflare-Dzvc7V2N.js.map +0 -1
  100. package/dist/index-iv9FTXX9.d.ts +0 -311
  101. package/dist/skills/compile.d.ts +0 -40
  102. package/dist/skills/compile.js +0 -65
  103. package/dist/skills/compile.js.map +0 -1
  104. package/dist/src-BGolXG_H.js.map +0 -1
  105. package/skills-module.d.ts +0 -22
@@ -28,6 +28,20 @@ interface AgentMcpOAuthProvider extends OAuthClientProvider {
28
28
  * @deprecated Use {@link AgentMcpOAuthProvider} instead.
29
29
  */
30
30
  type AgentsOAuthProvider = AgentMcpOAuthProvider;
31
+ interface DurableObjectOAuthClientProviderOptions {
32
+ /**
33
+ * HTTPS URL of this client's OAuth Client ID Metadata Document.
34
+ *
35
+ * When an authorization server advertises
36
+ * `client_id_metadata_document_supported`, the client uses this URL as its
37
+ * `client_id` instead of dynamic client registration. Other servers still
38
+ * use dynamic client registration. Serve
39
+ * {@link DurableObjectOAuthClientProvider.clientMetadataDocument} at this
40
+ * URL, and use a stable `callbackPath` so the document's `redirect_uris`
41
+ * match every authorization request.
42
+ */
43
+ clientMetadataUrl?: string;
44
+ }
31
45
  declare class DurableObjectOAuthClientProvider implements AgentMcpOAuthProvider {
32
46
  storage: DurableObjectStorage;
33
47
  clientName: string;
@@ -35,11 +49,20 @@ declare class DurableObjectOAuthClientProvider implements AgentMcpOAuthProvider
35
49
  private _authUrl_;
36
50
  private _serverId_;
37
51
  private _clientId_;
52
+ readonly clientMetadataUrl: string | undefined;
38
53
  constructor(
39
54
  storage: DurableObjectStorage,
40
55
  clientName: string,
41
- baseRedirectUrl: string
56
+ baseRedirectUrl: string,
57
+ options?: DurableObjectOAuthClientProviderOptions
42
58
  );
59
+ /**
60
+ * The Client ID Metadata Document to serve at `clientMetadataUrl`.
61
+ * Throws when the provider has no `clientMetadataUrl`.
62
+ */
63
+ get clientMetadataDocument(): OAuthClientMetadata & {
64
+ client_id: string;
65
+ };
43
66
  get clientMetadata(): OAuthClientMetadata;
44
67
  get clientUri(): string;
45
68
  get redirectUrl(): string;
@@ -109,8 +132,9 @@ declare class DurableObjectOAuthClientProvider implements AgentMcpOAuthProvider
109
132
  }
110
133
  //#endregion
111
134
  export {
135
+ DurableObjectOAuthClientProviderOptions as i,
112
136
  AgentsOAuthProvider as n,
113
137
  DurableObjectOAuthClientProvider as r,
114
138
  AgentMcpOAuthProvider as t
115
139
  };
116
- //# sourceMappingURL=do-oauth-client-provider-DfsUcpc3.d.ts.map
140
+ //# sourceMappingURL=do-oauth-client-provider-DtNqv7oj.d.ts.map
@@ -1,5 +1,3 @@
1
- import { Channel } from "node:diagnostics_channel";
2
-
3
1
  //#region src/observability/base.d.ts
4
2
  /**
5
3
  * Base event structure for all observability events
@@ -776,27 +774,7 @@ type AgentObservabilityEvent =
776
774
  }
777
775
  >;
778
776
  //#endregion
779
- //#region src/observability/diagnostics.d.ts
780
- /** Diagnostics channels for Agent and Lifecycle telemetry. */
781
- declare const channels: {
782
- readonly state: Channel<any, any>;
783
- readonly rpc: Channel<any, any>;
784
- readonly message: Channel<any, any>;
785
- readonly chat: Channel<any, any>;
786
- readonly transcript: Channel<any, any>;
787
- readonly fiber: Channel<any, any>;
788
- readonly task: Channel<any, any>;
789
- readonly stream: Channel<any, any>;
790
- readonly agentTool: Channel<any, any>;
791
- readonly schedule: Channel<any, any>;
792
- readonly lifecycle: Channel<any, any>;
793
- readonly workflow: Channel<any, any>;
794
- readonly mcp: Channel<any, any>;
795
- readonly email: Channel<any, any>;
796
- readonly channel: Channel<any, any>;
797
- };
798
- //#endregion
799
- //#region src/observability/index.d.ts
777
+ //#region src/observability/emitter.d.ts
800
778
  /**
801
779
  * Union of all observability event types from different domains
802
780
  */
@@ -815,123 +793,11 @@ interface Observability {
815
793
  * a subscriber is registered or a Tail Worker is attached.
816
794
  */
817
795
  declare const genericObservability: Observability;
818
- /**
819
- * Maps each channel key to the observability events it carries.
820
- */
821
- type ChannelEventMap = {
822
- state: Extract<
823
- ObservabilityEvent,
824
- {
825
- type: `state:${string}`;
826
- }
827
- >;
828
- rpc: Extract<
829
- ObservabilityEvent,
830
- {
831
- type: "rpc" | `rpc:${string}`;
832
- }
833
- >;
834
- message: Extract<
835
- ObservabilityEvent,
836
- {
837
- type:
838
- | `message:${string}`
839
- | `tool:${string}`
840
- | `submission:${string}`
841
- | `action:${string}`;
842
- }
843
- >;
844
- chat: Exclude<
845
- Extract<
846
- ObservabilityEvent,
847
- {
848
- type: `chat:${string}`;
849
- }
850
- >,
851
- {
852
- type: `chat:transcript:${string}`;
853
- }
854
- >;
855
- transcript: Extract<
856
- ObservabilityEvent,
857
- {
858
- type: `transcript:${string}` | `chat:transcript:${string}`;
859
- }
860
- >;
861
- fiber: Extract<
862
- ObservabilityEvent,
863
- {
864
- type: `fiber:${string}`;
865
- }
866
- >;
867
- agentTool: Extract<
868
- ObservabilityEvent,
869
- {
870
- type: `agent_tool:${string}`;
871
- }
872
- >;
873
- schedule: Extract<
874
- ObservabilityEvent,
875
- {
876
- type: `schedule:${string}` | `queue:${string}`;
877
- }
878
- >;
879
- lifecycle: Extract<
880
- ObservabilityEvent,
881
- {
882
- type: "connect" | "disconnect" | "destroy";
883
- }
884
- >;
885
- workflow: Extract<
886
- ObservabilityEvent,
887
- {
888
- type: `workflow:${string}`;
889
- }
890
- >;
891
- mcp: Extract<
892
- ObservabilityEvent,
893
- {
894
- type: `mcp:${string}`;
895
- }
896
- >;
897
- email: Extract<
898
- ObservabilityEvent,
899
- {
900
- type: `email:${string}`;
901
- }
902
- >;
903
- channel: Extract<
904
- ObservabilityEvent,
905
- {
906
- type: `channel:${string}` | `notice:${string}`;
907
- }
908
- >;
909
- };
910
- /**
911
- * Subscribe to a typed observability channel.
912
- *
913
- * ```ts
914
- * import { subscribe } from "agents/observability";
915
- *
916
- * const unsub = subscribe("rpc", (event) => {
917
- * console.log(event.payload.method); // fully typed
918
- * });
919
- * ```
920
- *
921
- * @returns A function that unsubscribes the callback.
922
- */
923
- declare function subscribe$1<K extends keyof ChannelEventMap>(
924
- channelKey: K,
925
- callback: (event: ChannelEventMap[K]) => void
926
- ): () => void;
927
796
  //#endregion
928
797
  export {
929
- subscribe$1 as a,
930
- genericObservability as i,
931
- Observability as n,
932
- channels as o,
933
- ObservabilityEvent as r,
934
- MCPObservabilityEvent as s,
935
- ChannelEventMap as t
798
+ MCPObservabilityEvent as i,
799
+ ObservabilityEvent as n,
800
+ genericObservability as r,
801
+ Observability as t
936
802
  };
937
- //# sourceMappingURL=index-YSKgfgg9.d.ts.map
803
+ //# sourceMappingURL=emitter-BJZtCVjQ.d.ts.map
@@ -0,0 +1,15 @@
1
+ import { n as publishDiagnosticsEvent } from "./diagnostics-BzvaX2UT.js";
2
+ //#region src/observability/emitter.ts
3
+ /**
4
+ * The default observability implementation.
5
+ *
6
+ * Publishes events to diagnostics_channel. Events are silent unless
7
+ * a subscriber is registered or a Tail Worker is attached.
8
+ */
9
+ const genericObservability = { emit(event) {
10
+ publishDiagnosticsEvent(event);
11
+ } };
12
+ //#endregion
13
+ export { genericObservability as t };
14
+
15
+ //# sourceMappingURL=emitter-DPOVcCln.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"emitter-DPOVcCln.js","names":[],"sources":["../src/observability/emitter.ts"],"sourcesContent":["import type { AgentObservabilityEvent } from \"./agent\";\nimport type { MCPObservabilityEvent } from \"./mcp\";\nimport { publishDiagnosticsEvent } from \"./diagnostics\";\n\n/**\n * Union of all observability event types from different domains\n */\nexport type ObservabilityEvent =\n | AgentObservabilityEvent\n | MCPObservabilityEvent;\n\nexport interface Observability {\n /**\n * Emit an event for the Agent's observability implementation to handle.\n * @param event - The event to emit\n */\n emit(event: ObservabilityEvent): void;\n}\n\n/**\n * The default observability implementation.\n *\n * Publishes events to diagnostics_channel. Events are silent unless\n * a subscriber is registered or a Tail Worker is attached.\n */\nexport const genericObservability: Observability = {\n emit(event) {\n publishDiagnosticsEvent(event);\n }\n};\n"],"mappings":";;;;;;;;AAyBA,MAAa,uBAAsC,EACjD,KAAK,OAAO;CACV,wBAAwB,KAAK;AAC/B,EACF"}
@@ -1,6 +1,6 @@
1
1
  import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "../../../classPrivateFieldGet2-DZBYAB34.js";
2
2
  import { t as _classPrivateMethodInitSpec } from "../../../classPrivateMethodInitSpec-qMjJ6sHQ.js";
3
- import { a as getConnectionFlag, l as registerInternalConnectionKeys, t as WebSockets, u as setConnectionFlag } from "../../../websockets-CyoeosdO.js";
3
+ import { a as getConnectionFlag, l as registerInternalConnectionKeys, t as WebSockets, u as setConnectionFlag } from "../../../websockets-C6SJtWCJ.js";
4
4
  import { i as participantRoute } from "../../../internal-kmw70xwR.js";
5
5
  import { n as parseClientFrame, t as WEB_IDENTITY_HEADER } from "../../../protocol-y2sSY584.js";
6
6
  //#region src/experimental/channels/web/channel.ts
@@ -1,7 +1,6 @@
1
1
  import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "../../classPrivateFieldGet2-DZBYAB34.js";
2
2
  import { t as _classPrivateMethodInitSpec } from "../../classPrivateMethodInitSpec-qMjJ6sHQ.js";
3
3
  import { t as LifecycleCapability } from "../../capability-DBAKc6UZ.js";
4
- import "../../lifecycle-v1rKHV2C.js";
5
4
  import { n as openHarnessStore } from "../../store-CslVzfN7.js";
6
5
  import { d as parseDaemonMessage, i as CONTAINER_HEALTH_PATH, l as chunkEntries, o as CONTAINER_SESSION_PATH, r as CONTAINER_ENV, s as CONTAINER_TOKEN_HEADER } from "../../protocol-cOklVBBD.js";
7
6
  import { WorkerEntrypoint } from "cloudflare:workers";