agents 0.0.0-e48e5f9 → 0.0.0-e75ec71

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 (76) hide show
  1. package/README.md +234 -6
  2. package/dist/ai-chat-agent.d.ts +20 -18
  3. package/dist/ai-chat-agent.js +532 -260
  4. package/dist/ai-chat-agent.js.map +1 -1
  5. package/dist/ai-chat-v5-migration-DBHGW4Hv.js +155 -0
  6. package/dist/ai-chat-v5-migration-DBHGW4Hv.js.map +1 -0
  7. package/dist/ai-chat-v5-migration.d.ts +155 -0
  8. package/dist/ai-chat-v5-migration.js +3 -0
  9. package/dist/ai-react.d.ts +73 -85
  10. package/dist/ai-react.js +261 -199
  11. package/dist/ai-react.js.map +1 -1
  12. package/dist/ai-types-B3aQaFv3.js +20 -0
  13. package/dist/ai-types-B3aQaFv3.js.map +1 -0
  14. package/dist/ai-types-D5YoPrBZ.d.ts +95 -0
  15. package/dist/ai-types.d.ts +6 -74
  16. package/dist/ai-types.js +3 -1
  17. package/dist/client-9Ld2_lnt.js +786 -0
  18. package/dist/client-9Ld2_lnt.js.map +1 -0
  19. package/dist/client-BfiZ3HQd.js +117 -0
  20. package/dist/client-BfiZ3HQd.js.map +1 -0
  21. package/dist/client-CbWe9FBd.d.ts +104 -0
  22. package/dist/client-CtM-Lpn3.d.ts +5314 -0
  23. package/dist/client.d.ts +11 -92
  24. package/dist/client.js +4 -11
  25. package/dist/codemode/ai.d.ts +27 -0
  26. package/dist/codemode/ai.js +151 -0
  27. package/dist/codemode/ai.js.map +1 -0
  28. package/dist/do-oauth-client-provider-CswoD5Lu.js +93 -0
  29. package/dist/do-oauth-client-provider-CswoD5Lu.js.map +1 -0
  30. package/dist/do-oauth-client-provider-DGc5pP0l.d.ts +55 -0
  31. package/dist/{index-BIJvkfYt.d.ts → index-DgMq4s2H.d.ts} +100 -154
  32. package/dist/index-DhJCaDWd.d.ts +58 -0
  33. package/dist/index.d.ts +69 -38
  34. package/dist/index.js +7 -28
  35. package/dist/mcp/client.d.ts +4 -1055
  36. package/dist/mcp/client.js +3 -9
  37. package/dist/mcp/do-oauth-client-provider.d.ts +2 -41
  38. package/dist/mcp/do-oauth-client-provider.js +3 -7
  39. package/dist/mcp/index.d.ts +150 -81
  40. package/dist/mcp/index.js +1338 -770
  41. package/dist/mcp/index.js.map +1 -1
  42. package/dist/mcp/x402.d.ts +34 -0
  43. package/dist/mcp/x402.js +194 -0
  44. package/dist/mcp/x402.js.map +1 -0
  45. package/dist/mcp-Dw5vDrY8.d.ts +61 -0
  46. package/dist/observability/index.d.ts +3 -12
  47. package/dist/observability/index.js +7 -10
  48. package/dist/react-Cr4RjXOP.d.ts +115 -0
  49. package/dist/react.d.ts +10 -119
  50. package/dist/react.js +183 -110
  51. package/dist/react.js.map +1 -1
  52. package/dist/schedule.d.ts +91 -14
  53. package/dist/schedule.js +46 -21
  54. package/dist/schedule.js.map +1 -1
  55. package/dist/serializable-CymX8ovI.d.ts +39 -0
  56. package/dist/serializable.d.ts +7 -32
  57. package/dist/serializable.js +1 -1
  58. package/dist/src-Dz0H9hSU.js +1200 -0
  59. package/dist/src-Dz0H9hSU.js.map +1 -0
  60. package/package.json +46 -12
  61. package/dist/ai-types.js.map +0 -1
  62. package/dist/chunk-5YIRLLUX.js +0 -1264
  63. package/dist/chunk-5YIRLLUX.js.map +0 -1
  64. package/dist/chunk-KUH345EY.js +0 -116
  65. package/dist/chunk-KUH345EY.js.map +0 -1
  66. package/dist/chunk-MW5BQ2FW.js +0 -469
  67. package/dist/chunk-MW5BQ2FW.js.map +0 -1
  68. package/dist/chunk-PVQZBKN7.js +0 -106
  69. package/dist/chunk-PVQZBKN7.js.map +0 -1
  70. package/dist/client.js.map +0 -1
  71. package/dist/index.js.map +0 -1
  72. package/dist/mcp/client.js.map +0 -1
  73. package/dist/mcp/do-oauth-client-provider.js.map +0 -1
  74. package/dist/observability/index.js.map +0 -1
  75. package/dist/serializable.js.map +0 -1
  76. package/src/index.ts +0 -1878
@@ -0,0 +1 @@
1
+ {"version":3,"file":"x402.js","names":["decoded: PaymentPayload","result: CallToolResult","listTools: typeof _listTools"],"sources":["../../src/mcp/x402.ts"],"sourcesContent":["/**\n * X402 MCP Integration\n *\n * Based on:\n * - Coinbase's x402 (Apache 2.0): https://github.com/coinbase/x402\n * - @ethanniser and his work at https://github.com/ethanniser/x402-mcp\n */\n\nimport type {\n McpServer,\n RegisteredTool,\n ToolCallback\n} from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { Client as MCPClient } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport type {\n CallToolResultSchema,\n CompatibilityCallToolResultSchema,\n CallToolRequest,\n CallToolResult,\n ToolAnnotations\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ZodRawShape } from \"zod\";\nimport { base, baseSepolia, type Chain } from \"viem/chains\";\n\nimport { processPriceToAtomicAmount } from \"x402/shared\";\nimport { exact } from \"x402/schemes\";\nimport { useFacilitator } from \"x402/verify\";\nimport type {\n FacilitatorConfig,\n Network,\n PaymentPayload,\n PaymentRequirements,\n Wallet\n} from \"x402/types\";\nimport type { RequestOptions } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\nimport { createWalletClient, http, type Account } from \"viem\";\nimport { createPaymentHeader } from \"x402/client\";\n\n/*\n ======= SERVER SIDE =======\n*/\n\nexport type X402Config = {\n network: Network;\n recipient: `0x${string}`;\n facilitator: FacilitatorConfig;\n version?: number;\n};\n\nexport interface X402AugmentedServer {\n paidTool<Args extends ZodRawShape>(\n name: string,\n description: string,\n priceUSD: number,\n paramsSchema: Args,\n annotations: ToolAnnotations,\n cb: ToolCallback<Args>\n ): RegisteredTool;\n}\n\nexport function withX402<T extends McpServer>(\n server: McpServer,\n cfg: X402Config\n): T & X402AugmentedServer {\n const { verify, settle } = useFacilitator(cfg.facilitator);\n const x402Version = cfg.version ?? 1;\n\n function paidTool<Args extends ZodRawShape>(\n name: string,\n description: string,\n priceUSD: number,\n paramsSchema: Args,\n annotations: ToolAnnotations,\n cb: ToolCallback<Args>\n ): RegisteredTool {\n return server.tool(\n name,\n description,\n paramsSchema,\n { ...annotations, paymentHint: true, paymentPriceUSD: priceUSD },\n (async (args, extra) => {\n // Build PaymentRequirements for this call\n const atomic = processPriceToAtomicAmount(priceUSD, cfg.network);\n if (\"error\" in atomic) {\n const payload = { x402Version, error: \"PRICE_COMPUTE_FAILED\" };\n return {\n isError: true,\n _meta: { \"x402/error\": payload },\n content: [{ type: \"text\", text: JSON.stringify(payload) }]\n } as const;\n }\n const { maxAmountRequired, asset } = atomic;\n const requirements = {\n scheme: \"exact\" as const,\n network: cfg.network,\n maxAmountRequired,\n payTo: cfg.recipient,\n asset: asset.address,\n maxTimeoutSeconds: 300,\n resource: `x402://${name}`,\n mimeType: \"application/json\" as const,\n description,\n extra: \"eip712\" in asset ? asset.eip712 : undefined\n };\n\n // Get token either from MCP _meta or from header\n const headers = extra?.requestInfo?.headers ?? {};\n const token =\n (extra?._meta?.[\"x402/payment\"] as string | undefined) ??\n headers[\"X-PAYMENT\"];\n\n const paymentRequired = (\n reason = \"PAYMENT_REQUIRED\",\n extraFields: Record<string, unknown> = {}\n ) => {\n const payload = {\n x402Version,\n error: reason,\n accepts: [requirements],\n ...extraFields\n };\n return {\n isError: true,\n _meta: { \"x402/error\": payload },\n content: [{ type: \"text\", text: JSON.stringify(payload) }]\n } as const;\n };\n\n if (!token || typeof token !== \"string\") return paymentRequired();\n\n // Decode & verify\n let decoded: PaymentPayload;\n try {\n decoded = exact.evm.decodePayment(token);\n decoded.x402Version = x402Version;\n } catch {\n return paymentRequired(\"INVALID_PAYMENT\");\n }\n\n const vr = await verify(decoded, requirements);\n if (!vr.isValid) {\n return paymentRequired(vr.invalidReason ?? \"INVALID_PAYMENT\", {\n payer: vr.payer\n });\n }\n\n // Execute tool\n let result: CallToolResult;\n let failed = false;\n try {\n result = await cb(args, extra);\n if (\n result &&\n typeof result === \"object\" &&\n \"isError\" in result &&\n result.isError\n ) {\n failed = true;\n }\n } catch (e) {\n failed = true;\n result = {\n isError: true,\n content: [\n { type: \"text\", text: `Tool execution failed: ${String(e)}` }\n ]\n };\n }\n\n // Settle only on success\n if (!failed) {\n try {\n const s = await settle(decoded, requirements);\n if (s.success) {\n result._meta ??= {};\n result._meta[\"x402/payment-response\"] = {\n success: true,\n transaction: s.transaction,\n network: s.network,\n payer: s.payer\n };\n } else {\n return paymentRequired(s.errorReason ?? \"SETTLEMENT_FAILED\");\n }\n } catch {\n return paymentRequired(\"SETTLEMENT_FAILED\");\n }\n }\n\n return result;\n }) as ToolCallback<Args>\n );\n }\n\n Object.defineProperty(server, \"paidTool\", {\n value: paidTool,\n writable: false,\n enumerable: false,\n configurable: true\n });\n\n // Tell TS the object now also has the paidTool method\n return server as T & X402AugmentedServer;\n}\n\n/*\n ======= CLIENT SIDE =======\n*/\n\nconst toChain = (network: Network): Chain => {\n switch (network) {\n case \"base\":\n return base;\n case \"base-sepolia\":\n return baseSepolia;\n default:\n throw new Error(`Unsupported network: ${network}`);\n }\n};\n\nexport interface X402AugmentedClient {\n callTool(\n x402ConfirmationCallback:\n | ((payment: PaymentRequirements[]) => Promise<boolean>)\n | null,\n params: CallToolRequest[\"params\"],\n resultSchema?:\n | typeof CallToolResultSchema\n | typeof CompatibilityCallToolResultSchema,\n options?: RequestOptions\n ): Promise<CallToolResult>;\n}\n\nexport type X402ClientConfig = {\n network: Network; // we only support base and base-sepolia for now\n account: Account;\n maxPaymentValue?: bigint;\n version?: number;\n confirmationCallback?: (payment: PaymentRequirements[]) => Promise<boolean>; // Confirmation callback for payment\n};\n\nexport function withX402Client<T extends MCPClient>(\n client: T,\n x402Config: X402ClientConfig\n): X402AugmentedClient & T {\n const { network, account, version } = x402Config;\n const wallet = createWalletClient({\n account,\n transport: http(),\n chain: toChain(network)\n });\n\n const maxPaymentValue = x402Config.maxPaymentValue ?? BigInt(0.1 * 10 ** 6); // 0.10 USDC\n\n const _listTools = client.listTools.bind(client);\n\n // Wrap the original method to include payment information in the description\n const listTools: typeof _listTools = async (params, options) => {\n const toolsRes = await _listTools(params, options);\n toolsRes.tools = toolsRes.tools.map((tool) => {\n let description = tool.description;\n if (tool.annotations?.paymentHint) {\n const cost = tool.annotations?.paymentPriceUSD\n ? `$${tool.annotations?.paymentPriceUSD}`\n : \"an unknown amount\";\n description += ` (This is a paid tool, you will be charged ${cost} for its execution)`;\n }\n return {\n ...tool,\n description\n };\n });\n\n // Wrap each tool to add payment support\n\n return toolsRes;\n };\n\n const _callTool = client.callTool.bind(client);\n\n const callToolWithPayment = async (\n x402ConfirmationCallback:\n | ((payment: PaymentRequirements[]) => Promise<boolean>)\n | null,\n params: CallToolRequest[\"params\"],\n resultSchema?:\n | typeof CallToolResultSchema\n | typeof CompatibilityCallToolResultSchema,\n options?: RequestOptions\n ): ReturnType<typeof client.callTool> => {\n // call the tool\n const res = await _callTool(params, resultSchema, options);\n console.log(\"res\", res);\n\n // If it errored and returned accepts, we need to confirm payment\n const maybeX402Error = res._meta?.[\"x402/error\"] as\n | { accepts: PaymentRequirements[] }\n | undefined;\n\n if (\n res.isError &&\n maybeX402Error &&\n maybeX402Error.accepts &&\n Array.isArray(maybeX402Error.accepts) &&\n maybeX402Error.accepts.length > 0\n ) {\n const accepts = maybeX402Error.accepts;\n const confirmationCallback =\n x402ConfirmationCallback ?? x402Config.confirmationCallback;\n\n // Use the x402 confirmation callback if provided\n if (confirmationCallback && !(await confirmationCallback(accepts))) {\n return {\n isError: true,\n content: [{ type: \"text\", text: \"User declined payment\" }]\n };\n }\n\n // Pick the first exact-scheme requirement that matches our network\n // (we're only setting one on the McpAgent side for now)\n const req =\n accepts.find((a) => a?.scheme === \"exact\" && a?.network === network) ??\n accepts[0];\n\n if (!req || req.scheme !== \"exact\") return res;\n\n const maxAmountRequired = BigInt(req.maxAmountRequired);\n if (maxAmountRequired > maxPaymentValue) {\n return {\n isError: true,\n content: [\n {\n type: \"text\",\n text: `Payment exceeds client cap: ${maxAmountRequired} > ${maxPaymentValue}`\n }\n ]\n };\n }\n\n // Use x402/client to get the X-PAYMENT token\n const token = await createPaymentHeader(\n wallet as Wallet,\n version ?? 1,\n req\n );\n\n // Call the tool with the payment token\n return _callTool(\n {\n ...params,\n _meta: {\n ...params._meta,\n \"x402/payment\": token\n }\n },\n resultSchema,\n options\n );\n }\n\n return res;\n };\n\n const _client = client as X402AugmentedClient & T;\n _client.listTools = listTools;\n Object.defineProperty(_client, \"callTool\", {\n value: callToolWithPayment,\n writable: false,\n enumerable: false,\n configurable: true\n });\n\n return _client;\n}\n"],"mappings":"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"}
@@ -0,0 +1,61 @@
1
+ //#region src/observability/base.d.ts
2
+ /**
3
+ * Base event structure for all observability events
4
+ */
5
+ type BaseEvent<
6
+ T extends string,
7
+ Payload extends Record<string, unknown> = {}
8
+ > = {
9
+ type: T;
10
+ /**
11
+ * The unique identifier for the event
12
+ */
13
+ id: string;
14
+ /**
15
+ * The message to display in the logs for this event, should the implementation choose to display
16
+ * a human-readable message.
17
+ */
18
+ displayMessage: string;
19
+ /**
20
+ * The payload of the event
21
+ */
22
+ payload: Payload & Record<string, unknown>;
23
+ /**
24
+ * The timestamp of the event in milliseconds since epoch
25
+ */
26
+ timestamp: number;
27
+ };
28
+ //#endregion
29
+ //#region src/observability/mcp.d.ts
30
+ /**
31
+ * MCP-specific observability events
32
+ * These track the lifecycle of MCP connections and operations
33
+ */
34
+ type MCPObservabilityEvent =
35
+ | BaseEvent<
36
+ "mcp:client:preconnect",
37
+ {
38
+ serverId: string;
39
+ }
40
+ >
41
+ | BaseEvent<
42
+ "mcp:client:connect",
43
+ {
44
+ url: string;
45
+ transport: string;
46
+ state: string;
47
+ error?: string;
48
+ }
49
+ >
50
+ | BaseEvent<
51
+ "mcp:client:authorize",
52
+ {
53
+ serverId: string;
54
+ authUrl: string;
55
+ clientId?: string;
56
+ }
57
+ >
58
+ | BaseEvent<"mcp:client:discover", {}>;
59
+ //#endregion
60
+ export { BaseEvent as n, MCPObservabilityEvent as t };
61
+ //# sourceMappingURL=mcp-Dw5vDrY8.d.ts.map
@@ -1,12 +1,3 @@
1
- import 'ai';
2
- export { b as Observability, O as ObservabilityEvent, g as genericObservability } from '../index-BIJvkfYt.js';
3
- import '@modelcontextprotocol/sdk/client/index.js';
4
- import '@modelcontextprotocol/sdk/types.js';
5
- import 'partyserver';
6
- import '../mcp/client.js';
7
- import 'zod';
8
- import '@modelcontextprotocol/sdk/client/sse.js';
9
- import '@modelcontextprotocol/sdk/shared/protocol.js';
10
- import '../mcp/do-oauth-client-provider.js';
11
- import '@modelcontextprotocol/sdk/client/auth.js';
12
- import '@modelcontextprotocol/sdk/shared/auth.js';
1
+ import "../mcp-Dw5vDrY8.js";
2
+ import { n as ObservabilityEvent, r as genericObservability, t as Observability } from "../index-DhJCaDWd.js";
3
+ export { Observability, ObservabilityEvent, genericObservability };
@@ -1,10 +1,7 @@
1
- import {
2
- genericObservability
3
- } from "../chunk-5YIRLLUX.js";
4
- import "../chunk-MW5BQ2FW.js";
5
- import "../chunk-PVQZBKN7.js";
6
- import "../chunk-KUH345EY.js";
7
- export {
8
- genericObservability
9
- };
10
- //# sourceMappingURL=index.js.map
1
+ import "../ai-types-B3aQaFv3.js";
2
+ import "../client-BfiZ3HQd.js";
3
+ import "../client-9Ld2_lnt.js";
4
+ import "../do-oauth-client-provider-CswoD5Lu.js";
5
+ import { f as genericObservability } from "../src-Dz0H9hSU.js";
6
+
7
+ export { genericObservability };
@@ -0,0 +1,115 @@
1
+ import { m as MCPServersState, t as Agent } from "./index-DgMq4s2H.js";
2
+ import { n as RPCMethod, t as Method } from "./serializable-CymX8ovI.js";
3
+ import { i as StreamOptions } from "./client-CbWe9FBd.js";
4
+ import { PartySocket } from "partysocket";
5
+ import { usePartySocket } from "partysocket/react";
6
+
7
+ //#region src/react.d.ts
8
+ type QueryObject = Record<string, string | null>;
9
+ /**
10
+ * Options for the useAgent hook
11
+ * @template State Type of the Agent's state
12
+ */
13
+ type UseAgentOptions<State = unknown> = Omit<
14
+ Parameters<typeof usePartySocket>[0],
15
+ "party" | "room" | "query"
16
+ > & {
17
+ /** Name of the agent to connect to */
18
+ agent: string;
19
+ /** Name of the specific Agent instance */
20
+ name?: string;
21
+ /** Query parameters - can be static object or async function */
22
+ query?: QueryObject | (() => Promise<QueryObject>);
23
+ /** Dependencies for async query caching */
24
+ queryDeps?: unknown[];
25
+ /** Cache TTL in milliseconds for auth tokens/time-sensitive data */
26
+ cacheTtl?: number;
27
+ /** Called when the Agent's state is updated */
28
+ onStateUpdate?: (state: State, source: "server" | "client") => void;
29
+ /** Called when MCP server state is updated */
30
+ onMcpUpdate?: (mcpServers: MCPServersState) => void;
31
+ };
32
+ type AllOptional<T$1> = T$1 extends [infer A, ...infer R]
33
+ ? undefined extends A
34
+ ? AllOptional<R>
35
+ : false
36
+ : true;
37
+ type RPCMethods<T$1> = {
38
+ [K in keyof T$1 as T$1[K] extends RPCMethod<T$1[K]> ? K : never]: RPCMethod<
39
+ T$1[K]
40
+ >;
41
+ };
42
+ type OptionalParametersMethod<T$1 extends RPCMethod> =
43
+ AllOptional<Parameters<T$1>> extends true ? T$1 : never;
44
+ type AgentMethods<T$1> = Omit<RPCMethods<T$1>, keyof Agent<any, any>>;
45
+ type OptionalAgentMethods<T$1> = {
46
+ [K in keyof AgentMethods<T$1> as AgentMethods<T$1>[K] extends OptionalParametersMethod<
47
+ AgentMethods<T$1>[K]
48
+ >
49
+ ? K
50
+ : never]: OptionalParametersMethod<AgentMethods<T$1>[K]>;
51
+ };
52
+ type RequiredAgentMethods<T$1> = Omit<
53
+ AgentMethods<T$1>,
54
+ keyof OptionalAgentMethods<T$1>
55
+ >;
56
+ type AgentPromiseReturnType<T$1, K$1 extends keyof AgentMethods<T$1>> =
57
+ ReturnType<AgentMethods<T$1>[K$1]> extends Promise<any>
58
+ ? ReturnType<AgentMethods<T$1>[K$1]>
59
+ : Promise<ReturnType<AgentMethods<T$1>[K$1]>>;
60
+ type OptionalArgsAgentMethodCall<AgentT> = <
61
+ K extends keyof OptionalAgentMethods<AgentT>
62
+ >(
63
+ method: K,
64
+ args?: Parameters<OptionalAgentMethods<AgentT>[K]>,
65
+ streamOptions?: StreamOptions
66
+ ) => AgentPromiseReturnType<AgentT, K>;
67
+ type RequiredArgsAgentMethodCall<AgentT> = <
68
+ K extends keyof RequiredAgentMethods<AgentT>
69
+ >(
70
+ method: K,
71
+ args: Parameters<RequiredAgentMethods<AgentT>[K]>,
72
+ streamOptions?: StreamOptions
73
+ ) => AgentPromiseReturnType<AgentT, K>;
74
+ type AgentMethodCall<AgentT> = OptionalArgsAgentMethodCall<AgentT> &
75
+ RequiredArgsAgentMethodCall<AgentT>;
76
+ type UntypedAgentMethodCall = <T = unknown>(
77
+ method: string,
78
+ args?: unknown[],
79
+ streamOptions?: StreamOptions
80
+ ) => Promise<T>;
81
+ type AgentStub<T$1> = {
82
+ [K in keyof AgentMethods<T$1>]: (
83
+ ...args: Parameters<AgentMethods<T$1>[K]>
84
+ ) => AgentPromiseReturnType<AgentMethods<T$1>, K>;
85
+ };
86
+ type UntypedAgentStub = Record<string, Method>;
87
+ /**
88
+ * React hook for connecting to an Agent
89
+ */
90
+ declare function useAgent<State = unknown>(
91
+ options: UseAgentOptions<State>
92
+ ): PartySocket & {
93
+ agent: string;
94
+ name: string;
95
+ setState: (state: State) => void;
96
+ call: UntypedAgentMethodCall;
97
+ stub: UntypedAgentStub;
98
+ };
99
+ declare function useAgent<
100
+ AgentT extends {
101
+ get state(): State;
102
+ },
103
+ State
104
+ >(
105
+ options: UseAgentOptions<State>
106
+ ): PartySocket & {
107
+ agent: string;
108
+ name: string;
109
+ setState: (state: State) => void;
110
+ call: AgentMethodCall<AgentT>;
111
+ stub: AgentStub<AgentT>;
112
+ };
113
+ //#endregion
114
+ export { useAgent as n, UseAgentOptions as t };
115
+ //# sourceMappingURL=react-Cr4RjXOP.d.ts.map
package/dist/react.d.ts CHANGED
@@ -1,119 +1,10 @@
1
- import { PartySocket } from "partysocket";
2
- import { usePartySocket } from "partysocket/react";
3
- import { M as MCPServersState, A as Agent } from "./index-BIJvkfYt.js";
4
- import { StreamOptions } from "./client.js";
5
- import { Method, RPCMethod } from "./serializable.js";
6
- import "@modelcontextprotocol/sdk/client/index.js";
7
- import "@modelcontextprotocol/sdk/types.js";
8
- import "partyserver";
9
- import "./mcp/client.js";
10
- import "zod";
11
- import "@modelcontextprotocol/sdk/client/sse.js";
12
- import "@modelcontextprotocol/sdk/shared/protocol.js";
13
- import "ai";
14
- import "./mcp/do-oauth-client-provider.js";
15
- import "@modelcontextprotocol/sdk/client/auth.js";
16
- import "@modelcontextprotocol/sdk/shared/auth.js";
17
-
18
- /**
19
- * Options for the useAgent hook
20
- * @template State Type of the Agent's state
21
- */
22
- type UseAgentOptions<State = unknown> = Omit<
23
- Parameters<typeof usePartySocket>[0],
24
- "party" | "room"
25
- > & {
26
- /** Name of the agent to connect to */
27
- agent: string;
28
- /** Name of the specific Agent instance */
29
- name?: string;
30
- /** Called when the Agent's state is updated */
31
- onStateUpdate?: (state: State, source: "server" | "client") => void;
32
- /** Called when MCP server state is updated */
33
- onMcpUpdate?: (mcpServers: MCPServersState) => void;
34
- };
35
- type AllOptional<T> = T extends [infer A, ...infer R]
36
- ? undefined extends A
37
- ? AllOptional<R>
38
- : false
39
- : true;
40
- type RPCMethods<T> = {
41
- [K in keyof T as T[K] extends RPCMethod<T[K]> ? K : never]: RPCMethod<T[K]>;
42
- };
43
- type OptionalParametersMethod<T extends RPCMethod> =
44
- AllOptional<Parameters<T>> extends true ? T : never;
45
- type AgentMethods<T> = Omit<RPCMethods<T>, keyof Agent<any, any>>;
46
- type OptionalAgentMethods<T> = {
47
- [K in keyof AgentMethods<T> as AgentMethods<T>[K] extends OptionalParametersMethod<
48
- AgentMethods<T>[K]
49
- >
50
- ? K
51
- : never]: OptionalParametersMethod<AgentMethods<T>[K]>;
52
- };
53
- type RequiredAgentMethods<T> = Omit<
54
- AgentMethods<T>,
55
- keyof OptionalAgentMethods<T>
56
- >;
57
- type AgentPromiseReturnType<T, K extends keyof AgentMethods<T>> =
58
- ReturnType<AgentMethods<T>[K]> extends Promise<any>
59
- ? ReturnType<AgentMethods<T>[K]>
60
- : Promise<ReturnType<AgentMethods<T>[K]>>;
61
- type OptionalArgsAgentMethodCall<AgentT> = <
62
- K extends keyof OptionalAgentMethods<AgentT>
63
- >(
64
- method: K,
65
- args?: Parameters<OptionalAgentMethods<AgentT>[K]>,
66
- streamOptions?: StreamOptions
67
- ) => AgentPromiseReturnType<AgentT, K>;
68
- type RequiredArgsAgentMethodCall<AgentT> = <
69
- K extends keyof RequiredAgentMethods<AgentT>
70
- >(
71
- method: K,
72
- args: Parameters<RequiredAgentMethods<AgentT>[K]>,
73
- streamOptions?: StreamOptions
74
- ) => AgentPromiseReturnType<AgentT, K>;
75
- type AgentMethodCall<AgentT> = OptionalArgsAgentMethodCall<AgentT> &
76
- RequiredArgsAgentMethodCall<AgentT>;
77
- type UntypedAgentMethodCall = <T = unknown>(
78
- method: string,
79
- args?: unknown[],
80
- streamOptions?: StreamOptions
81
- ) => Promise<T>;
82
- type AgentStub<T> = {
83
- [K in keyof AgentMethods<T>]: (
84
- ...args: Parameters<AgentMethods<T>[K]>
85
- ) => AgentPromiseReturnType<AgentMethods<T>, K>;
86
- };
87
- type UntypedAgentStub = Record<string, Method>;
88
- /**
89
- * React hook for connecting to an Agent
90
- * @template State Type of the Agent's state
91
- * @template Agent Type of the Agent
92
- * @param options Connection options
93
- * @returns WebSocket connection with setState and call methods
94
- */
95
- declare function useAgent<State = unknown>(
96
- options: UseAgentOptions<State>
97
- ): PartySocket & {
98
- agent: string;
99
- name: string;
100
- setState: (state: State) => void;
101
- call: UntypedAgentMethodCall;
102
- stub: UntypedAgentStub;
103
- };
104
- declare function useAgent<
105
- AgentT extends {
106
- get state(): State;
107
- },
108
- State
109
- >(
110
- options: UseAgentOptions<State>
111
- ): PartySocket & {
112
- agent: string;
113
- name: string;
114
- setState: (state: State) => void;
115
- call: AgentMethodCall<AgentT>;
116
- stub: AgentStub<AgentT>;
117
- };
118
-
119
- export { type UseAgentOptions, useAgent };
1
+ import "./client-CtM-Lpn3.js";
2
+ import "./mcp-Dw5vDrY8.js";
3
+ import "./do-oauth-client-provider-DGc5pP0l.js";
4
+ import "./index-DhJCaDWd.js";
5
+ import "./ai-types-D5YoPrBZ.js";
6
+ import "./index-DgMq4s2H.js";
7
+ import "./serializable-CymX8ovI.js";
8
+ import "./client-CbWe9FBd.js";
9
+ import { n as useAgent, t as UseAgentOptions } from "./react-Cr4RjXOP.js";
10
+ export { UseAgentOptions, useAgent };