agents 0.0.0-ff68550 → 0.0.0-ff9329f

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 (73) hide show
  1. package/README.md +257 -33
  2. package/dist/_esm-LV5FJ3HK.js +3922 -0
  3. package/dist/_esm-LV5FJ3HK.js.map +1 -0
  4. package/dist/ai-chat-agent.d.ts +56 -6
  5. package/dist/ai-chat-agent.js +287 -94
  6. package/dist/ai-chat-agent.js.map +1 -1
  7. package/dist/ai-chat-v5-migration.d.ts +152 -0
  8. package/dist/ai-chat-v5-migration.js +20 -0
  9. package/dist/ai-react.d.ts +77 -65
  10. package/dist/ai-react.js +287 -120
  11. package/dist/ai-react.js.map +1 -1
  12. package/dist/ai-types.d.ts +41 -18
  13. package/dist/ai-types.js +7 -0
  14. package/dist/ccip-CMBYN64O.js +15 -0
  15. package/dist/ccip-CMBYN64O.js.map +1 -0
  16. package/dist/chunk-5Y6BEZDY.js +276 -0
  17. package/dist/chunk-5Y6BEZDY.js.map +1 -0
  18. package/dist/chunk-BER7KXUJ.js +18 -0
  19. package/dist/chunk-BER7KXUJ.js.map +1 -0
  20. package/dist/chunk-JJBFIGUC.js +5202 -0
  21. package/dist/chunk-JJBFIGUC.js.map +1 -0
  22. package/dist/chunk-PR4QN5HX.js +43 -0
  23. package/dist/chunk-PR4QN5HX.js.map +1 -0
  24. package/dist/chunk-QEPGNUG6.js +650 -0
  25. package/dist/chunk-QEPGNUG6.js.map +1 -0
  26. package/dist/chunk-QEVM4BVL.js +116 -0
  27. package/dist/chunk-QEVM4BVL.js.map +1 -0
  28. package/dist/chunk-RS5OCNEQ.js +1323 -0
  29. package/dist/chunk-RS5OCNEQ.js.map +1 -0
  30. package/dist/chunk-TYAY6AU6.js +159 -0
  31. package/dist/chunk-TYAY6AU6.js.map +1 -0
  32. package/dist/chunk-UJVEAURM.js +150 -0
  33. package/dist/chunk-UJVEAURM.js.map +1 -0
  34. package/dist/chunk-XFS5ERG3.js +127 -0
  35. package/dist/chunk-XFS5ERG3.js.map +1 -0
  36. package/dist/client-BohGLma8.d.ts +5041 -0
  37. package/dist/client.d.ts +16 -2
  38. package/dist/client.js +8 -133
  39. package/dist/client.js.map +1 -1
  40. package/dist/index.d.ts +291 -22
  41. package/dist/index.js +16 -4
  42. package/dist/mcp/client.d.ts +11 -0
  43. package/dist/mcp/client.js +10 -0
  44. package/dist/mcp/client.js.map +1 -0
  45. package/dist/mcp/do-oauth-client-provider.d.ts +50 -0
  46. package/dist/mcp/do-oauth-client-provider.js +8 -0
  47. package/dist/mcp/do-oauth-client-provider.js.map +1 -0
  48. package/dist/mcp/index.d.ts +78 -0
  49. package/dist/mcp/index.js +1099 -0
  50. package/dist/mcp/index.js.map +1 -0
  51. package/dist/mcp/x402.d.ts +31 -0
  52. package/dist/mcp/x402.js +3195 -0
  53. package/dist/mcp/x402.js.map +1 -0
  54. package/dist/observability/index.d.ts +46 -0
  55. package/dist/observability/index.js +12 -0
  56. package/dist/observability/index.js.map +1 -0
  57. package/dist/react.d.ts +89 -5
  58. package/dist/react.js +54 -32
  59. package/dist/react.js.map +1 -1
  60. package/dist/schedule.d.ts +81 -7
  61. package/dist/schedule.js +20 -7
  62. package/dist/schedule.js.map +1 -1
  63. package/dist/secp256k1-M22GZP2U.js +2193 -0
  64. package/dist/secp256k1-M22GZP2U.js.map +1 -0
  65. package/dist/serializable.d.ts +32 -0
  66. package/dist/serializable.js +1 -0
  67. package/dist/serializable.js.map +1 -0
  68. package/package.json +100 -43
  69. package/src/index.ts +1283 -184
  70. package/dist/chunk-HMLY7DHA.js +0 -16
  71. package/dist/chunk-X6BBKLSC.js +0 -568
  72. package/dist/chunk-X6BBKLSC.js.map +0 -1
  73. /package/dist/{chunk-HMLY7DHA.js.map → ai-chat-v5-migration.js.map} +0 -0
@@ -0,0 +1,46 @@
1
+ type BaseEvent<T extends string, Payload extends Record<string, unknown> = {}> = {
2
+ type: T;
3
+ /**
4
+ * The unique identifier for the event
5
+ */
6
+ id: string;
7
+ /**
8
+ * The message to display in the logs for this event, should the implementation choose to display
9
+ * a human-readable message.
10
+ */
11
+ displayMessage: string;
12
+ /**
13
+ * The payload of the event
14
+ */
15
+ payload: Payload;
16
+ /**
17
+ * The timestamp of the event in milliseconds since epoch
18
+ */
19
+ timestamp: number;
20
+ };
21
+ /**
22
+ * The type of events that can be emitted by an Agent
23
+ */
24
+ type ObservabilityEvent = BaseEvent<"state:update", {}> | BaseEvent<"rpc", {
25
+ method: string;
26
+ streaming?: boolean;
27
+ }> | BaseEvent<"message:request" | "message:response", {}> | BaseEvent<"message:clear"> | BaseEvent<"schedule:create" | "schedule:execute" | "schedule:cancel", {
28
+ callback: string;
29
+ id: string;
30
+ }> | BaseEvent<"destroy"> | BaseEvent<"connect", {
31
+ connectionId: string;
32
+ }>;
33
+ interface Observability {
34
+ /**
35
+ * Emit an event for the Agent's observability implementation to handle.
36
+ * @param event - The event to emit
37
+ * @param ctx - The execution context of the invocation
38
+ */
39
+ emit(event: ObservabilityEvent, ctx: DurableObjectState): void;
40
+ }
41
+ /**
42
+ * A generic observability implementation that logs events to the console.
43
+ */
44
+ declare const genericObservability: Observability;
45
+
46
+ export { type Observability, type ObservabilityEvent, genericObservability };
@@ -0,0 +1,12 @@
1
+ import {
2
+ genericObservability
3
+ } from "../chunk-RS5OCNEQ.js";
4
+ import "../chunk-QEPGNUG6.js";
5
+ import "../chunk-XFS5ERG3.js";
6
+ import "../chunk-QEVM4BVL.js";
7
+ import "../chunk-BER7KXUJ.js";
8
+ import "../chunk-PR4QN5HX.js";
9
+ export {
10
+ genericObservability
11
+ };
12
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
package/dist/react.d.ts CHANGED
@@ -1,6 +1,23 @@
1
1
  import { PartySocket } from "partysocket";
2
2
  import { usePartySocket } from "partysocket/react";
3
+ import { MCPServersState, Agent } from "./index.js";
3
4
  import { StreamOptions } from "./client.js";
5
+ import { Method, RPCMethod } from "./serializable.js";
6
+ import "cloudflare:workers";
7
+ import "@modelcontextprotocol/sdk/client/index.js";
8
+ import "@modelcontextprotocol/sdk/types.js";
9
+ import "partyserver";
10
+ import "./client-BohGLma8.js";
11
+ import "zod";
12
+ import "@modelcontextprotocol/sdk/shared/protocol.js";
13
+ import "ai";
14
+ import "@modelcontextprotocol/sdk/client/sse.js";
15
+ import "@modelcontextprotocol/sdk/client/streamableHttp.js";
16
+ import "./mcp/do-oauth-client-provider.js";
17
+ import "@modelcontextprotocol/sdk/client/auth.js";
18
+ import "@modelcontextprotocol/sdk/shared/auth.js";
19
+ import "./observability/index.js";
20
+ import "./ai-types.js";
4
21
 
5
22
  /**
6
23
  * Options for the useAgent hook
@@ -16,10 +33,66 @@ type UseAgentOptions<State = unknown> = Omit<
16
33
  name?: string;
17
34
  /** Called when the Agent's state is updated */
18
35
  onStateUpdate?: (state: State, source: "server" | "client") => void;
36
+ /** Called when MCP server state is updated */
37
+ onMcpUpdate?: (mcpServers: MCPServersState) => void;
19
38
  };
39
+ type AllOptional<T> = T extends [infer A, ...infer R]
40
+ ? undefined extends A
41
+ ? AllOptional<R>
42
+ : false
43
+ : true;
44
+ type RPCMethods<T> = {
45
+ [K in keyof T as T[K] extends RPCMethod<T[K]> ? K : never]: RPCMethod<T[K]>;
46
+ };
47
+ type OptionalParametersMethod<T extends RPCMethod> =
48
+ AllOptional<Parameters<T>> extends true ? T : never;
49
+ type AgentMethods<T> = Omit<RPCMethods<T>, keyof Agent<any, any>>;
50
+ type OptionalAgentMethods<T> = {
51
+ [K in keyof AgentMethods<T> as AgentMethods<T>[K] extends OptionalParametersMethod<
52
+ AgentMethods<T>[K]
53
+ >
54
+ ? K
55
+ : never]: OptionalParametersMethod<AgentMethods<T>[K]>;
56
+ };
57
+ type RequiredAgentMethods<T> = Omit<
58
+ AgentMethods<T>,
59
+ keyof OptionalAgentMethods<T>
60
+ >;
61
+ type AgentPromiseReturnType<T, K extends keyof AgentMethods<T>> =
62
+ ReturnType<AgentMethods<T>[K]> extends Promise<any>
63
+ ? ReturnType<AgentMethods<T>[K]>
64
+ : Promise<ReturnType<AgentMethods<T>[K]>>;
65
+ type OptionalArgsAgentMethodCall<AgentT> = <
66
+ K extends keyof OptionalAgentMethods<AgentT>
67
+ >(
68
+ method: K,
69
+ args?: Parameters<OptionalAgentMethods<AgentT>[K]>,
70
+ streamOptions?: StreamOptions
71
+ ) => AgentPromiseReturnType<AgentT, K>;
72
+ type RequiredArgsAgentMethodCall<AgentT> = <
73
+ K extends keyof RequiredAgentMethods<AgentT>
74
+ >(
75
+ method: K,
76
+ args: Parameters<RequiredAgentMethods<AgentT>[K]>,
77
+ streamOptions?: StreamOptions
78
+ ) => AgentPromiseReturnType<AgentT, K>;
79
+ type AgentMethodCall<AgentT> = OptionalArgsAgentMethodCall<AgentT> &
80
+ RequiredArgsAgentMethodCall<AgentT>;
81
+ type UntypedAgentMethodCall = <T = unknown>(
82
+ method: string,
83
+ args?: unknown[],
84
+ streamOptions?: StreamOptions
85
+ ) => Promise<T>;
86
+ type AgentStub<T> = {
87
+ [K in keyof AgentMethods<T>]: (
88
+ ...args: Parameters<AgentMethods<T>[K]>
89
+ ) => AgentPromiseReturnType<AgentMethods<T>, K>;
90
+ };
91
+ type UntypedAgentStub = Record<string, Method>;
20
92
  /**
21
93
  * React hook for connecting to an Agent
22
94
  * @template State Type of the Agent's state
95
+ * @template Agent Type of the Agent
23
96
  * @param options Connection options
24
97
  * @returns WebSocket connection with setState and call methods
25
98
  */
@@ -29,11 +102,22 @@ declare function useAgent<State = unknown>(
29
102
  agent: string;
30
103
  name: string;
31
104
  setState: (state: State) => void;
32
- call: <T = unknown>(
33
- method: string,
34
- args?: unknown[],
35
- streamOptions?: StreamOptions
36
- ) => Promise<T>;
105
+ call: UntypedAgentMethodCall;
106
+ stub: UntypedAgentStub;
107
+ };
108
+ declare function useAgent<
109
+ AgentT extends {
110
+ get state(): State;
111
+ },
112
+ State
113
+ >(
114
+ options: UseAgentOptions<State>
115
+ ): PartySocket & {
116
+ agent: string;
117
+ name: string;
118
+ setState: (state: State) => void;
119
+ call: AgentMethodCall<AgentT>;
120
+ stub: AgentStub<AgentT>;
37
121
  };
38
122
 
39
123
  export { type UseAgentOptions, useAgent };
package/dist/react.js CHANGED
@@ -1,35 +1,28 @@
1
- import "./chunk-HMLY7DHA.js";
1
+ import "./chunk-BER7KXUJ.js";
2
+ import "./chunk-PR4QN5HX.js";
2
3
 
3
4
  // src/react.tsx
4
5
  import { usePartySocket } from "partysocket/react";
5
6
  import { useCallback, useRef } from "react";
7
+ function camelCaseToKebabCase(str) {
8
+ if (str === str.toUpperCase() && str !== str.toLowerCase()) {
9
+ return str.toLowerCase().replace(/_/g, "-");
10
+ }
11
+ let kebabified = str.replace(
12
+ /[A-Z]/g,
13
+ (letter) => `-${letter.toLowerCase()}`
14
+ );
15
+ kebabified = kebabified.startsWith("-") ? kebabified.slice(1) : kebabified;
16
+ return kebabified.replace(/_/g, "-").replace(/-$/, "");
17
+ }
6
18
  function useAgent(options) {
19
+ const agentNamespace = camelCaseToKebabCase(options.agent);
7
20
  const pendingCallsRef = useRef(
8
21
  /* @__PURE__ */ new Map()
9
22
  );
10
- const call = useCallback(
11
- (method, args = [], streamOptions) => {
12
- return new Promise((resolve, reject) => {
13
- const id = Math.random().toString(36).slice(2);
14
- pendingCallsRef.current.set(id, {
15
- resolve,
16
- reject,
17
- stream: streamOptions
18
- });
19
- const request = {
20
- type: "rpc",
21
- id,
22
- method,
23
- args
24
- };
25
- agent.send(JSON.stringify(request));
26
- });
27
- },
28
- []
29
- );
30
23
  const agent = usePartySocket({
24
+ party: agentNamespace,
31
25
  prefix: "agents",
32
- party: options.agent,
33
26
  room: options.name || "default",
34
27
  ...options,
35
28
  onMessage: (message) => {
@@ -37,14 +30,18 @@ function useAgent(options) {
37
30
  let parsedMessage;
38
31
  try {
39
32
  parsedMessage = JSON.parse(message.data);
40
- } catch (error) {
33
+ } catch (_error) {
41
34
  return options.onMessage?.(message);
42
35
  }
43
- if (parsedMessage.type === "cf_agent_state") {
36
+ if (parsedMessage.type === "cf_agent_state" /* CF_AGENT_STATE */) {
44
37
  options.onStateUpdate?.(parsedMessage.state, "server");
45
38
  return;
46
39
  }
47
- if (parsedMessage.type === "rpc") {
40
+ if (parsedMessage.type === "cf_agent_mcp_servers" /* CF_AGENT_MCP_SERVERS */) {
41
+ options.onMcpUpdate?.(parsedMessage.mcp);
42
+ return;
43
+ }
44
+ if (parsedMessage.type === "rpc" /* RPC */) {
48
45
  const response = parsedMessage;
49
46
  const pending = pendingCallsRef.current.get(response.id);
50
47
  if (!pending) return;
@@ -72,23 +69,48 @@ function useAgent(options) {
72
69
  options.onMessage?.(message);
73
70
  }
74
71
  });
72
+ const call = useCallback(
73
+ (method, args = [], streamOptions) => {
74
+ return new Promise((resolve, reject) => {
75
+ const id = Math.random().toString(36).slice(2);
76
+ pendingCallsRef.current.set(id, {
77
+ reject,
78
+ resolve,
79
+ stream: streamOptions
80
+ });
81
+ const request = {
82
+ args,
83
+ id,
84
+ method,
85
+ type: "rpc" /* RPC */
86
+ };
87
+ agent.send(JSON.stringify(request));
88
+ });
89
+ },
90
+ [agent]
91
+ );
75
92
  agent.setState = (state) => {
76
- agent.send(JSON.stringify({ type: "cf_agent_state", state }));
93
+ agent.send(JSON.stringify({ state, type: "cf_agent_state" /* CF_AGENT_STATE */ }));
77
94
  options.onStateUpdate?.(state, "client");
78
95
  };
79
96
  agent.call = call;
80
- agent.agent = options.agent;
97
+ agent.agent = agentNamespace;
81
98
  agent.name = options.name || "default";
99
+ agent.stub = new Proxy(
100
+ {},
101
+ {
102
+ get: (_target, method) => {
103
+ return (...args) => {
104
+ return call(method, args);
105
+ };
106
+ }
107
+ }
108
+ );
82
109
  if (agent.agent !== agent.agent.toLowerCase()) {
83
110
  console.warn(
84
111
  `Agent name: ${agent.agent} should probably be in lowercase. Received: ${agent.agent}`
85
112
  );
86
113
  }
87
- if (agent.name !== agent.name.toLowerCase()) {
88
- console.warn(
89
- `Agent instance name: ${agent.name} should probably be in lowercase. Received: ${agent.name}`
90
- );
91
- }
92
114
  return agent;
93
115
  }
94
116
  export {
package/dist/react.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/react.tsx"],"sourcesContent":["import type { PartySocket } from \"partysocket\";\nimport { usePartySocket } from \"partysocket/react\";\nimport { useCallback, useRef } from \"react\";\nimport type { RPCRequest, RPCResponse } from \"./\";\nimport type { StreamOptions } from \"./client\";\n\n/**\n * Options for the useAgent hook\n * @template State Type of the Agent's state\n */\nexport type UseAgentOptions<State = unknown> = Omit<\n Parameters<typeof usePartySocket>[0],\n \"party\" | \"room\"\n> & {\n /** Name of the agent to connect to */\n agent: string;\n /** Name of the specific Agent instance */\n name?: string;\n /** Called when the Agent's state is updated */\n onStateUpdate?: (state: State, source: \"server\" | \"client\") => void;\n};\n\n/**\n * React hook for connecting to an Agent\n * @template State Type of the Agent's state\n * @param options Connection options\n * @returns WebSocket connection with setState and call methods\n */\nexport function useAgent<State = unknown>(\n options: UseAgentOptions<State>\n): PartySocket & {\n agent: string;\n name: string;\n setState: (state: State) => void;\n call: <T = unknown>(\n method: string,\n args?: unknown[],\n streamOptions?: StreamOptions\n ) => Promise<T>;\n} {\n // Keep track of pending RPC calls\n const pendingCallsRef = useRef(\n new Map<\n string,\n {\n resolve: (value: unknown) => void;\n reject: (error: Error) => void;\n stream?: StreamOptions;\n }\n >()\n );\n\n // Create the call method\n const call = useCallback(\n <T = unknown,>(\n method: string,\n args: unknown[] = [],\n streamOptions?: StreamOptions\n ): Promise<T> => {\n return new Promise((resolve, reject) => {\n const id = Math.random().toString(36).slice(2);\n pendingCallsRef.current.set(id, {\n resolve: resolve as (value: unknown) => void,\n reject,\n stream: streamOptions,\n });\n\n const request: RPCRequest = {\n type: \"rpc\",\n id,\n method,\n args,\n };\n\n agent.send(JSON.stringify(request));\n });\n },\n []\n );\n\n const agent = usePartySocket({\n prefix: \"agents\",\n party: options.agent,\n room: options.name || \"default\",\n ...options,\n onMessage: (message) => {\n if (typeof message.data === \"string\") {\n let parsedMessage: Record<string, unknown>;\n try {\n parsedMessage = JSON.parse(message.data);\n } catch (error) {\n // silently ignore invalid messages for now\n // TODO: log errors with log levels\n return options.onMessage?.(message);\n }\n if (parsedMessage.type === \"cf_agent_state\") {\n options.onStateUpdate?.(parsedMessage.state as State, \"server\");\n return;\n }\n if (parsedMessage.type === \"rpc\") {\n const response = parsedMessage as RPCResponse;\n const pending = pendingCallsRef.current.get(response.id);\n if (!pending) return;\n\n if (!response.success) {\n pending.reject(new Error(response.error));\n pendingCallsRef.current.delete(response.id);\n pending.stream?.onError?.(response.error);\n return;\n }\n\n // Handle streaming responses\n if (\"done\" in response) {\n if (response.done) {\n pending.resolve(response.result);\n pendingCallsRef.current.delete(response.id);\n pending.stream?.onDone?.(response.result);\n } else {\n pending.stream?.onChunk?.(response.result);\n }\n } else {\n // Non-streaming response\n pending.resolve(response.result);\n pendingCallsRef.current.delete(response.id);\n }\n return;\n }\n }\n options.onMessage?.(message);\n },\n }) as PartySocket & {\n agent: string;\n name: string;\n setState: (state: State) => void;\n call: <T = unknown>(\n method: string,\n args?: unknown[],\n streamOptions?: StreamOptions\n ) => Promise<T>;\n };\n\n agent.setState = (state: State) => {\n agent.send(JSON.stringify({ type: \"cf_agent_state\", state }));\n options.onStateUpdate?.(state, \"client\");\n };\n\n agent.call = call;\n agent.agent = options.agent;\n agent.name = options.name || \"default\";\n\n // warn if agent or name isn't in lowercase\n if (agent.agent !== agent.agent.toLowerCase()) {\n console.warn(\n `Agent name: ${agent.agent} should probably be in lowercase. Received: ${agent.agent}`\n );\n }\n if (agent.name !== agent.name.toLowerCase()) {\n console.warn(\n `Agent instance name: ${agent.name} should probably be in lowercase. Received: ${agent.name}`\n );\n }\n\n return agent;\n}\n"],"mappings":";;;AACA,SAAS,sBAAsB;AAC/B,SAAS,aAAa,cAAc;AA0B7B,SAAS,SACd,SAUA;AAEA,QAAM,kBAAkB;AAAA,IACtB,oBAAI,IAOF;AAAA,EACJ;AAGA,QAAM,OAAO;AAAA,IACX,CACE,QACA,OAAkB,CAAC,GACnB,kBACe;AACf,aAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,cAAM,KAAK,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC;AAC7C,wBAAgB,QAAQ,IAAI,IAAI;AAAA,UAC9B;AAAA,UACA;AAAA,UACA,QAAQ;AAAA,QACV,CAAC;AAED,cAAM,UAAsB;AAAA,UAC1B,MAAM;AAAA,UACN;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAEA,cAAM,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,MACpC,CAAC;AAAA,IACH;AAAA,IACA,CAAC;AAAA,EACH;AAEA,QAAM,QAAQ,eAAe;AAAA,IAC3B,QAAQ;AAAA,IACR,OAAO,QAAQ;AAAA,IACf,MAAM,QAAQ,QAAQ;AAAA,IACtB,GAAG;AAAA,IACH,WAAW,CAAC,YAAY;AACtB,UAAI,OAAO,QAAQ,SAAS,UAAU;AACpC,YAAI;AACJ,YAAI;AACF,0BAAgB,KAAK,MAAM,QAAQ,IAAI;AAAA,QACzC,SAAS,OAAO;AAGd,iBAAO,QAAQ,YAAY,OAAO;AAAA,QACpC;AACA,YAAI,cAAc,SAAS,kBAAkB;AAC3C,kBAAQ,gBAAgB,cAAc,OAAgB,QAAQ;AAC9D;AAAA,QACF;AACA,YAAI,cAAc,SAAS,OAAO;AAChC,gBAAM,WAAW;AACjB,gBAAM,UAAU,gBAAgB,QAAQ,IAAI,SAAS,EAAE;AACvD,cAAI,CAAC,QAAS;AAEd,cAAI,CAAC,SAAS,SAAS;AACrB,oBAAQ,OAAO,IAAI,MAAM,SAAS,KAAK,CAAC;AACxC,4BAAgB,QAAQ,OAAO,SAAS,EAAE;AAC1C,oBAAQ,QAAQ,UAAU,SAAS,KAAK;AACxC;AAAA,UACF;AAGA,cAAI,UAAU,UAAU;AACtB,gBAAI,SAAS,MAAM;AACjB,sBAAQ,QAAQ,SAAS,MAAM;AAC/B,8BAAgB,QAAQ,OAAO,SAAS,EAAE;AAC1C,sBAAQ,QAAQ,SAAS,SAAS,MAAM;AAAA,YAC1C,OAAO;AACL,sBAAQ,QAAQ,UAAU,SAAS,MAAM;AAAA,YAC3C;AAAA,UACF,OAAO;AAEL,oBAAQ,QAAQ,SAAS,MAAM;AAC/B,4BAAgB,QAAQ,OAAO,SAAS,EAAE;AAAA,UAC5C;AACA;AAAA,QACF;AAAA,MACF;AACA,cAAQ,YAAY,OAAO;AAAA,IAC7B;AAAA,EACF,CAAC;AAWD,QAAM,WAAW,CAAC,UAAiB;AACjC,UAAM,KAAK,KAAK,UAAU,EAAE,MAAM,kBAAkB,MAAM,CAAC,CAAC;AAC5D,YAAQ,gBAAgB,OAAO,QAAQ;AAAA,EACzC;AAEA,QAAM,OAAO;AACb,QAAM,QAAQ,QAAQ;AACtB,QAAM,OAAO,QAAQ,QAAQ;AAG7B,MAAI,MAAM,UAAU,MAAM,MAAM,YAAY,GAAG;AAC7C,YAAQ;AAAA,MACN,eAAe,MAAM,KAAK,+CAA+C,MAAM,KAAK;AAAA,IACtF;AAAA,EACF;AACA,MAAI,MAAM,SAAS,MAAM,KAAK,YAAY,GAAG;AAC3C,YAAQ;AAAA,MACN,wBAAwB,MAAM,IAAI,+CAA+C,MAAM,IAAI;AAAA,IAC7F;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}
1
+ {"version":3,"sources":["../src/react.tsx"],"sourcesContent":["import type { PartySocket } from \"partysocket\";\nimport { usePartySocket } from \"partysocket/react\";\nimport { useCallback, useRef } from \"react\";\nimport type { Agent, MCPServersState, RPCRequest, RPCResponse } from \"./\";\nimport type { StreamOptions } from \"./client\";\nimport type { Method, RPCMethod } from \"./serializable\";\nimport { MessageType } from \"./ai-types\";\n\n/**\n * Convert a camelCase string to a kebab-case string\n * @param str The string to convert\n * @returns The kebab-case string\n */\nfunction camelCaseToKebabCase(str: string): string {\n // If string is all uppercase, convert to lowercase\n if (str === str.toUpperCase() && str !== str.toLowerCase()) {\n return str.toLowerCase().replace(/_/g, \"-\");\n }\n\n // Otherwise handle camelCase to kebab-case\n let kebabified = str.replace(\n /[A-Z]/g,\n (letter) => `-${letter.toLowerCase()}`\n );\n kebabified = kebabified.startsWith(\"-\") ? kebabified.slice(1) : kebabified;\n // Convert any remaining underscores to hyphens and remove trailing -'s\n return kebabified.replace(/_/g, \"-\").replace(/-$/, \"\");\n}\n\n/**\n * Options for the useAgent hook\n * @template State Type of the Agent's state\n */\nexport type UseAgentOptions<State = unknown> = Omit<\n Parameters<typeof usePartySocket>[0],\n \"party\" | \"room\"\n> & {\n /** Name of the agent to connect to */\n agent: string;\n /** Name of the specific Agent instance */\n name?: string;\n /** Called when the Agent's state is updated */\n onStateUpdate?: (state: State, source: \"server\" | \"client\") => void;\n /** Called when MCP server state is updated */\n onMcpUpdate?: (mcpServers: MCPServersState) => void;\n};\n\ntype AllOptional<T> = T extends [infer A, ...infer R]\n ? undefined extends A\n ? AllOptional<R>\n : false\n : true; // no params means optional by default\n\ntype RPCMethods<T> = {\n [K in keyof T as T[K] extends RPCMethod<T[K]> ? K : never]: RPCMethod<T[K]>;\n};\n\ntype OptionalParametersMethod<T extends RPCMethod> =\n AllOptional<Parameters<T>> extends true ? T : never;\n\n// all methods of the Agent, excluding the ones that are declared in the base Agent class\n// biome-ignore lint: suppressions/parse\ntype AgentMethods<T> = Omit<RPCMethods<T>, keyof Agent<any, any>>;\n\ntype OptionalAgentMethods<T> = {\n [K in keyof AgentMethods<T> as AgentMethods<T>[K] extends OptionalParametersMethod<\n AgentMethods<T>[K]\n >\n ? K\n : never]: OptionalParametersMethod<AgentMethods<T>[K]>;\n};\n\ntype RequiredAgentMethods<T> = Omit<\n AgentMethods<T>,\n keyof OptionalAgentMethods<T>\n>;\n\ntype AgentPromiseReturnType<T, K extends keyof AgentMethods<T>> =\n // biome-ignore lint: suppressions/parse\n ReturnType<AgentMethods<T>[K]> extends Promise<any>\n ? ReturnType<AgentMethods<T>[K]>\n : Promise<ReturnType<AgentMethods<T>[K]>>;\n\ntype OptionalArgsAgentMethodCall<AgentT> = <\n K extends keyof OptionalAgentMethods<AgentT>\n>(\n method: K,\n args?: Parameters<OptionalAgentMethods<AgentT>[K]>,\n streamOptions?: StreamOptions\n) => AgentPromiseReturnType<AgentT, K>;\n\ntype RequiredArgsAgentMethodCall<AgentT> = <\n K extends keyof RequiredAgentMethods<AgentT>\n>(\n method: K,\n args: Parameters<RequiredAgentMethods<AgentT>[K]>,\n streamOptions?: StreamOptions\n) => AgentPromiseReturnType<AgentT, K>;\n\ntype AgentMethodCall<AgentT> = OptionalArgsAgentMethodCall<AgentT> &\n RequiredArgsAgentMethodCall<AgentT>;\n\ntype UntypedAgentMethodCall = <T = unknown>(\n method: string,\n args?: unknown[],\n streamOptions?: StreamOptions\n) => Promise<T>;\n\ntype AgentStub<T> = {\n [K in keyof AgentMethods<T>]: (\n ...args: Parameters<AgentMethods<T>[K]>\n ) => AgentPromiseReturnType<AgentMethods<T>, K>;\n};\n\n// we neet to use Method instead of RPCMethod here for retro-compatibility\ntype UntypedAgentStub = Record<string, Method>;\n\n/**\n * React hook for connecting to an Agent\n * @template State Type of the Agent's state\n * @template Agent Type of the Agent\n * @param options Connection options\n * @returns WebSocket connection with setState and call methods\n */\nexport function useAgent<State = unknown>(\n options: UseAgentOptions<State>\n): PartySocket & {\n agent: string;\n name: string;\n setState: (state: State) => void;\n call: UntypedAgentMethodCall;\n stub: UntypedAgentStub;\n};\nexport function useAgent<\n AgentT extends {\n get state(): State;\n },\n State\n>(\n options: UseAgentOptions<State>\n): PartySocket & {\n agent: string;\n name: string;\n setState: (state: State) => void;\n call: AgentMethodCall<AgentT>;\n stub: AgentStub<AgentT>;\n};\nexport function useAgent<State>(\n options: UseAgentOptions<unknown>\n): PartySocket & {\n agent: string;\n name: string;\n setState: (state: State) => void;\n call: UntypedAgentMethodCall | AgentMethodCall<unknown>;\n stub: UntypedAgentStub;\n} {\n const agentNamespace = camelCaseToKebabCase(options.agent);\n // Keep track of pending RPC calls\n const pendingCallsRef = useRef(\n new Map<\n string,\n {\n resolve: (value: unknown) => void;\n reject: (error: Error) => void;\n stream?: StreamOptions;\n }\n >()\n );\n\n // TODO: if options.query is a function, then use\n // \"use()\" to get the value and pass it\n // as a query parameter to usePartySocket\n const agent = usePartySocket({\n party: agentNamespace,\n prefix: \"agents\",\n room: options.name || \"default\",\n ...options,\n onMessage: (message) => {\n if (typeof message.data === \"string\") {\n let parsedMessage: Record<string, unknown>;\n try {\n parsedMessage = JSON.parse(message.data);\n } catch (_error) {\n // silently ignore invalid messages for now\n // TODO: log errors with log levels\n return options.onMessage?.(message);\n }\n if (parsedMessage.type === MessageType.CF_AGENT_STATE) {\n options.onStateUpdate?.(parsedMessage.state as State, \"server\");\n return;\n }\n if (parsedMessage.type === MessageType.CF_AGENT_MCP_SERVERS) {\n options.onMcpUpdate?.(parsedMessage.mcp as MCPServersState);\n return;\n }\n if (parsedMessage.type === MessageType.RPC) {\n const response = parsedMessage as RPCResponse;\n const pending = pendingCallsRef.current.get(response.id);\n if (!pending) return;\n\n if (!response.success) {\n pending.reject(new Error(response.error));\n pendingCallsRef.current.delete(response.id);\n pending.stream?.onError?.(response.error);\n return;\n }\n\n // Handle streaming responses\n if (\"done\" in response) {\n if (response.done) {\n pending.resolve(response.result);\n pendingCallsRef.current.delete(response.id);\n pending.stream?.onDone?.(response.result);\n } else {\n pending.stream?.onChunk?.(response.result);\n }\n } else {\n // Non-streaming response\n pending.resolve(response.result);\n pendingCallsRef.current.delete(response.id);\n }\n return;\n }\n }\n options.onMessage?.(message);\n }\n }) as PartySocket & {\n agent: string;\n name: string;\n setState: (state: State) => void;\n call: UntypedAgentMethodCall;\n stub: UntypedAgentStub;\n };\n // Create the call method\n const call = useCallback(\n <T = unknown,>(\n method: string,\n args: unknown[] = [],\n streamOptions?: StreamOptions\n ): Promise<T> => {\n return new Promise((resolve, reject) => {\n const id = Math.random().toString(36).slice(2);\n pendingCallsRef.current.set(id, {\n reject,\n resolve: resolve as (value: unknown) => void,\n stream: streamOptions\n });\n\n const request: RPCRequest = {\n args,\n id,\n method,\n type: MessageType.RPC\n };\n\n agent.send(JSON.stringify(request));\n });\n },\n [agent]\n );\n\n agent.setState = (state: State) => {\n agent.send(JSON.stringify({ state, type: MessageType.CF_AGENT_STATE }));\n options.onStateUpdate?.(state, \"client\");\n };\n\n agent.call = call;\n agent.agent = agentNamespace;\n agent.name = options.name || \"default\";\n // biome-ignore lint: suppressions/parse\n agent.stub = new Proxy<any>(\n {},\n {\n get: (_target, method) => {\n return (...args: unknown[]) => {\n return call(method as string, args);\n };\n }\n }\n );\n\n // warn if agent isn't in lowercase\n if (agent.agent !== agent.agent.toLowerCase()) {\n console.warn(\n `Agent name: ${agent.agent} should probably be in lowercase. Received: ${agent.agent}`\n );\n }\n\n return agent;\n}\n"],"mappings":"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","names":[]}
@@ -1,30 +1,43 @@
1
1
  import { z } from "zod";
2
2
 
3
- type Schedule = z.infer<typeof unstable_scheduleSchema>;
3
+ /**
4
+ * Get the schedule prompt for a given event
5
+ * @param event - The event to get the schedule prompt for
6
+ * @returns The schedule prompt
7
+ */
8
+ declare function getSchedulePrompt(event: { date: Date }): string;
9
+ /**
10
+ * @deprecated this has been renamed to getSchedulePrompt, and unstable_getSchedulePrompt will be removed in the next major version
11
+ * @param event - The event to get the schedule prompt for
12
+ * @returns The schedule prompt
13
+ */
4
14
  declare function unstable_getSchedulePrompt(event: { date: Date }): string;
5
- declare const unstable_scheduleSchema: z.ZodObject<
15
+ /**
16
+ * The schema for the schedule prompt
17
+ */
18
+ declare const scheduleSchema: z.ZodObject<
6
19
  {
7
20
  description: z.ZodString;
8
21
  when: z.ZodObject<
9
22
  {
10
- type: z.ZodEnum<["scheduled", "delayed", "cron", "no-schedule"]>;
23
+ cron: z.ZodOptional<z.ZodString>;
11
24
  date: z.ZodOptional<z.ZodDate>;
12
25
  delayInSeconds: z.ZodOptional<z.ZodNumber>;
13
- cron: z.ZodOptional<z.ZodString>;
26
+ type: z.ZodEnum<["scheduled", "delayed", "cron", "no-schedule"]>;
14
27
  },
15
28
  "strip",
16
29
  z.ZodTypeAny,
17
30
  {
18
31
  type: "scheduled" | "delayed" | "cron" | "no-schedule";
32
+ date?: Date | undefined;
19
33
  cron?: string | undefined;
20
34
  delayInSeconds?: number | undefined;
21
- date?: Date | undefined;
22
35
  },
23
36
  {
24
37
  type: "scheduled" | "delayed" | "cron" | "no-schedule";
38
+ date?: Date | undefined;
25
39
  cron?: string | undefined;
26
40
  delayInSeconds?: number | undefined;
27
- date?: Date | undefined;
28
41
  }
29
42
  >;
30
43
  },
@@ -34,20 +47,81 @@ declare const unstable_scheduleSchema: z.ZodObject<
34
47
  description: string;
35
48
  when: {
36
49
  type: "scheduled" | "delayed" | "cron" | "no-schedule";
50
+ date?: Date | undefined;
37
51
  cron?: string | undefined;
38
52
  delayInSeconds?: number | undefined;
53
+ };
54
+ },
55
+ {
56
+ description: string;
57
+ when: {
58
+ type: "scheduled" | "delayed" | "cron" | "no-schedule";
39
59
  date?: Date | undefined;
60
+ cron?: string | undefined;
61
+ delayInSeconds?: number | undefined;
40
62
  };
63
+ }
64
+ >;
65
+ /**
66
+ * The type for the schedule prompt
67
+ */
68
+ type Schedule = z.infer<typeof scheduleSchema>;
69
+ /**
70
+ * @deprecated this has been renamed to scheduleSchema, and unstable_scheduleSchema will be removed in the next major version
71
+ * @returns The schedule schema
72
+ */
73
+ declare const unstable_scheduleSchema: z.ZodObject<
74
+ {
75
+ description: z.ZodString;
76
+ when: z.ZodObject<
77
+ {
78
+ cron: z.ZodOptional<z.ZodString>;
79
+ date: z.ZodOptional<z.ZodDate>;
80
+ delayInSeconds: z.ZodOptional<z.ZodNumber>;
81
+ type: z.ZodEnum<["scheduled", "delayed", "cron", "no-schedule"]>;
82
+ },
83
+ "strip",
84
+ z.ZodTypeAny,
85
+ {
86
+ type: "scheduled" | "delayed" | "cron" | "no-schedule";
87
+ date?: Date | undefined;
88
+ cron?: string | undefined;
89
+ delayInSeconds?: number | undefined;
90
+ },
91
+ {
92
+ type: "scheduled" | "delayed" | "cron" | "no-schedule";
93
+ date?: Date | undefined;
94
+ cron?: string | undefined;
95
+ delayInSeconds?: number | undefined;
96
+ }
97
+ >;
41
98
  },
99
+ "strip",
100
+ z.ZodTypeAny,
42
101
  {
43
102
  description: string;
44
103
  when: {
45
104
  type: "scheduled" | "delayed" | "cron" | "no-schedule";
105
+ date?: Date | undefined;
46
106
  cron?: string | undefined;
47
107
  delayInSeconds?: number | undefined;
108
+ };
109
+ },
110
+ {
111
+ description: string;
112
+ when: {
113
+ type: "scheduled" | "delayed" | "cron" | "no-schedule";
48
114
  date?: Date | undefined;
115
+ cron?: string | undefined;
116
+ delayInSeconds?: number | undefined;
49
117
  };
50
118
  }
51
119
  >;
52
120
 
53
- export { type Schedule, unstable_getSchedulePrompt, unstable_scheduleSchema };
121
+ export {
122
+ type Schedule,
123
+ getSchedulePrompt,
124
+ scheduleSchema,
125
+ unstable_getSchedulePrompt,
126
+ unstable_scheduleSchema
127
+ };
package/dist/schedule.js CHANGED
@@ -1,8 +1,8 @@
1
- import "./chunk-HMLY7DHA.js";
1
+ import "./chunk-PR4QN5HX.js";
2
2
 
3
3
  // src/schedule.ts
4
4
  import { z } from "zod";
5
- function unstable_getSchedulePrompt(event) {
5
+ function getSchedulePrompt(event) {
6
6
  return `
7
7
  [Schedule Parser Component]
8
8
 
@@ -51,22 +51,35 @@ Example outputs:
51
51
  [End Schedule Parser Component]
52
52
  `;
53
53
  }
54
- var unstable_scheduleSchema = z.object({
54
+ var didWarnAboutUnstableGetSchedulePrompt = false;
55
+ function unstable_getSchedulePrompt(event) {
56
+ if (!didWarnAboutUnstableGetSchedulePrompt) {
57
+ didWarnAboutUnstableGetSchedulePrompt = true;
58
+ console.warn(
59
+ "unstable_getSchedulePrompt is deprecated, use getSchedulePrompt instead. unstable_getSchedulePrompt will be removed in the next major version."
60
+ );
61
+ }
62
+ return getSchedulePrompt(event);
63
+ }
64
+ var scheduleSchema = z.object({
55
65
  description: z.string().describe("A description of the task"),
56
66
  when: z.object({
57
- type: z.enum(["scheduled", "delayed", "cron", "no-schedule"]).describe("The type of scheduling details"),
67
+ cron: z.string().optional().describe(
68
+ "execute task on a recurring interval specified as cron syntax (only use if the type is cron)"
69
+ ),
58
70
  date: z.coerce.date().optional().describe(
59
71
  "execute task at the specified date and time (only use if the type is scheduled)"
60
72
  ),
61
73
  delayInSeconds: z.number().optional().describe(
62
74
  "execute task after a delay in seconds (only use if the type is delayed)"
63
75
  ),
64
- cron: z.string().optional().describe(
65
- "execute task on a recurring interval specified as cron syntax (only use if the type is cron)"
66
- )
76
+ type: z.enum(["scheduled", "delayed", "cron", "no-schedule"]).describe("The type of scheduling details")
67
77
  })
68
78
  });
79
+ var unstable_scheduleSchema = scheduleSchema;
69
80
  export {
81
+ getSchedulePrompt,
82
+ scheduleSchema,
70
83
  unstable_getSchedulePrompt,
71
84
  unstable_scheduleSchema
72
85
  };
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/schedule.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport type Schedule = z.infer<typeof unstable_scheduleSchema>;\n\nexport function unstable_getSchedulePrompt(event: { date: Date }) {\n return `\n[Schedule Parser Component]\n\nCurrent time: ${event.date.toUTCString()}\n\nThis component parses natural language scheduling requests into a structured format. It extracts:\n1. A clean task description (without timing information)\n2. Scheduling details in one of these formats:\n - scheduled: Specific date/time events\n - delayed: Relative time delays (in seconds)\n - cron: Recurring patterns\n - no-schedule: Tasks without timing\n\nRules:\n- Task descriptions should be clean and focused on the action\n- Use numbers (0-6) for days in cron patterns (0=Sunday)\n- For recurring tasks, use standard cron syntax\n- For relative times, convert to seconds\n- For specific dates, use the current time as reference\n\nExample outputs:\n{\n \"description\": \"meeting with team\",\n \"when\": {\n \"type\": \"scheduled\",\n \"date\": \"tomorrow at 14:00\"\n }\n}\n\n{\n \"description\": \"backup database\",\n \"when\": {\n \"type\": \"cron\",\n \"cron\": \"0 0 * * *\"\n }\n}\n\n{\n \"description\": \"send report\",\n \"when\": {\n \"type\": \"delayed\",\n \"delayInSeconds\": 1800\n }\n}\n\n[End Schedule Parser Component]\n`;\n}\n\nexport const unstable_scheduleSchema = z.object({\n description: z.string().describe(\"A description of the task\"),\n when: z.object({\n type: z\n .enum([\"scheduled\", \"delayed\", \"cron\", \"no-schedule\"])\n .describe(\"The type of scheduling details\"),\n date: z.coerce\n .date()\n .optional()\n .describe(\n \"execute task at the specified date and time (only use if the type is scheduled)\"\n ),\n delayInSeconds: z\n .number()\n .optional()\n .describe(\n \"execute task after a delay in seconds (only use if the type is delayed)\"\n ),\n cron: z\n .string()\n .optional()\n .describe(\n \"execute task on a recurring interval specified as cron syntax (only use if the type is cron)\"\n ),\n }),\n});\n"],"mappings":";;;AAAA,SAAS,SAAS;AAIX,SAAS,2BAA2B,OAAuB;AAChE,SAAO;AAAA;AAAA;AAAA,gBAGO,MAAM,KAAK,YAAY,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4CxC;AAEO,IAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,aAAa,EAAE,OAAO,EAAE,SAAS,2BAA2B;AAAA,EAC5D,MAAM,EAAE,OAAO;AAAA,IACb,MAAM,EACH,KAAK,CAAC,aAAa,WAAW,QAAQ,aAAa,CAAC,EACpD,SAAS,gCAAgC;AAAA,IAC5C,MAAM,EAAE,OACL,KAAK,EACL,SAAS,EACT;AAAA,MACC;AAAA,IACF;AAAA,IACF,gBAAgB,EACb,OAAO,EACP,SAAS,EACT;AAAA,MACC;AAAA,IACF;AAAA,IACF,MAAM,EACH,OAAO,EACP,SAAS,EACT;AAAA,MACC;AAAA,IACF;AAAA,EACJ,CAAC;AACH,CAAC;","names":[]}
1
+ {"version":3,"sources":["../src/schedule.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Get the schedule prompt for a given event\n * @param event - The event to get the schedule prompt for\n * @returns The schedule prompt\n */\nexport function getSchedulePrompt(event: { date: Date }) {\n return `\n[Schedule Parser Component]\n\nCurrent time: ${event.date.toUTCString()}\n\nThis component parses natural language scheduling requests into a structured format. It extracts:\n1. A clean task description (without timing information)\n2. Scheduling details in one of these formats:\n - scheduled: Specific date/time events\n - delayed: Relative time delays (in seconds)\n - cron: Recurring patterns\n - no-schedule: Tasks without timing\n\nRules:\n- Task descriptions should be clean and focused on the action\n- Use numbers (0-6) for days in cron patterns (0=Sunday)\n- For recurring tasks, use standard cron syntax\n- For relative times, convert to seconds\n- For specific dates, use the current time as reference\n\nExample outputs:\n{\n \"description\": \"meeting with team\",\n \"when\": {\n \"type\": \"scheduled\",\n \"date\": \"tomorrow at 14:00\"\n }\n}\n\n{\n \"description\": \"backup database\",\n \"when\": {\n \"type\": \"cron\",\n \"cron\": \"0 0 * * *\"\n }\n}\n\n{\n \"description\": \"send report\",\n \"when\": {\n \"type\": \"delayed\",\n \"delayInSeconds\": 1800\n }\n}\n\n[End Schedule Parser Component]\n`;\n}\n\nlet didWarnAboutUnstableGetSchedulePrompt = false;\n\n/**\n * @deprecated this has been renamed to getSchedulePrompt, and unstable_getSchedulePrompt will be removed in the next major version\n * @param event - The event to get the schedule prompt for\n * @returns The schedule prompt\n */\nexport function unstable_getSchedulePrompt(event: { date: Date }) {\n if (!didWarnAboutUnstableGetSchedulePrompt) {\n didWarnAboutUnstableGetSchedulePrompt = true;\n console.warn(\n \"unstable_getSchedulePrompt is deprecated, use getSchedulePrompt instead. unstable_getSchedulePrompt will be removed in the next major version.\"\n );\n }\n return getSchedulePrompt(event);\n}\n\n/**\n * The schema for the schedule prompt\n */\nexport const scheduleSchema = z.object({\n description: z.string().describe(\"A description of the task\"),\n when: z.object({\n cron: z\n .string()\n .optional()\n .describe(\n \"execute task on a recurring interval specified as cron syntax (only use if the type is cron)\"\n ),\n date: z.coerce\n .date()\n .optional()\n .describe(\n \"execute task at the specified date and time (only use if the type is scheduled)\"\n ),\n delayInSeconds: z\n .number()\n .optional()\n .describe(\n \"execute task after a delay in seconds (only use if the type is delayed)\"\n ),\n type: z\n .enum([\"scheduled\", \"delayed\", \"cron\", \"no-schedule\"])\n .describe(\"The type of scheduling details\")\n })\n});\n\n/**\n * The type for the schedule prompt\n */\nexport type Schedule = z.infer<typeof scheduleSchema>;\n\n/**\n * @deprecated this has been renamed to scheduleSchema, and unstable_scheduleSchema will be removed in the next major version\n * @returns The schedule schema\n */\nexport const unstable_scheduleSchema = scheduleSchema;\n"],"mappings":";;;AAAA,SAAS,SAAS;AAOX,SAAS,kBAAkB,OAAuB;AACvD,SAAO;AAAA;AAAA;AAAA,gBAGO,MAAM,KAAK,YAAY,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4CxC;AAEA,IAAI,wCAAwC;AAOrC,SAAS,2BAA2B,OAAuB;AAChE,MAAI,CAAC,uCAAuC;AAC1C,4CAAwC;AACxC,YAAQ;AAAA,MACN;AAAA,IACF;AAAA,EACF;AACA,SAAO,kBAAkB,KAAK;AAChC;AAKO,IAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,aAAa,EAAE,OAAO,EAAE,SAAS,2BAA2B;AAAA,EAC5D,MAAM,EAAE,OAAO;AAAA,IACb,MAAM,EACH,OAAO,EACP,SAAS,EACT;AAAA,MACC;AAAA,IACF;AAAA,IACF,MAAM,EAAE,OACL,KAAK,EACL,SAAS,EACT;AAAA,MACC;AAAA,IACF;AAAA,IACF,gBAAgB,EACb,OAAO,EACP,SAAS,EACT;AAAA,MACC;AAAA,IACF;AAAA,IACF,MAAM,EACH,KAAK,CAAC,aAAa,WAAW,QAAQ,aAAa,CAAC,EACpD,SAAS,gCAAgC;AAAA,EAC9C,CAAC;AACH,CAAC;AAWM,IAAM,0BAA0B;","names":[]}