agents 0.0.0-e4a2352 → 0.0.0-e8f693b

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 (77) hide show
  1. package/README.md +129 -7
  2. package/dist/ai-chat-agent.d.ts +20 -20
  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 -87
  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-B17XUTV7.d.ts +5313 -0
  20. package/dist/client-BfiZ3HQd.js +117 -0
  21. package/dist/client-BfiZ3HQd.js.map +1 -0
  22. package/dist/client-CbWe9FBd.d.ts +104 -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-BCJclX6q.d.ts → index-B6MjW6n-.d.ts} +100 -155
  32. package/dist/index-DhJCaDWd.d.ts +58 -0
  33. package/dist/index.d.ts +69 -40
  34. package/dist/index.js +7 -28
  35. package/dist/mcp/client.d.ts +4 -11
  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 +126 -99
  40. package/dist/mcp/index.js +1222 -901
  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 -14
  47. package/dist/observability/index.js +7 -10
  48. package/dist/react-CRBsIQ1z.d.ts +115 -0
  49. package/dist/react.d.ts +10 -121
  50. package/dist/react.js +183 -110
  51. package/dist/react.js.map +1 -1
  52. package/dist/schedule.d.ts +87 -10
  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 +45 -11
  61. package/dist/ai-types.js.map +0 -1
  62. package/dist/chunk-HY7ZLHJB.js +0 -598
  63. package/dist/chunk-HY7ZLHJB.js.map +0 -1
  64. package/dist/chunk-JXN5WZFQ.js +0 -1287
  65. package/dist/chunk-JXN5WZFQ.js.map +0 -1
  66. package/dist/chunk-KUH345EY.js +0 -116
  67. package/dist/chunk-KUH345EY.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-DgyzBU_8.d.ts +0 -4601
  71. package/dist/client.js.map +0 -1
  72. package/dist/index.js.map +0 -1
  73. package/dist/mcp/client.js.map +0 -1
  74. package/dist/mcp/do-oauth-client-provider.js.map +0 -1
  75. package/dist/observability/index.js.map +0 -1
  76. package/dist/serializable.js.map +0 -1
  77. package/src/index.ts +0 -1917
@@ -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":";;;;;;;;AA4DA,SAAgB,SACd,QACA,KACyB;CACzB,MAAM,EAAE,QAAQ,WAAW,eAAe,IAAI,YAAY;CAC1D,MAAM,cAAc,IAAI,WAAW;CAEnC,SAAS,SACP,MACA,aACA,UACA,cACA,aACA,IACgB;AAChB,SAAO,OAAO,KACZ,MACA,aACA,cACA;GAAE,GAAG;GAAa,aAAa;GAAM,iBAAiB;GAAU,GAC/D,OAAO,MAAM,UAAU;GAEtB,MAAM,SAAS,2BAA2B,UAAU,IAAI,QAAQ;AAChE,OAAI,WAAW,QAAQ;IACrB,MAAM,UAAU;KAAE;KAAa,OAAO;KAAwB;AAC9D,WAAO;KACL,SAAS;KACT,OAAO,EAAE,cAAc,SAAS;KAChC,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,KAAK,UAAU,QAAQ;MAAE,CAAC;KAC3D;;GAEH,MAAM,EAAE,mBAAmB,UAAU;GACrC,MAAM,eAAe;IACnB,QAAQ;IACR,SAAS,IAAI;IACb;IACA,OAAO,IAAI;IACX,OAAO,MAAM;IACb,mBAAmB;IACnB,UAAU,UAAU;IACpB,UAAU;IACV;IACA,OAAO,YAAY,QAAQ,MAAM,SAAS;IAC3C;GAGD,MAAM,UAAU,OAAO,aAAa,WAAW,EAAE;GACjD,MAAM,QACH,OAAO,QAAQ,mBAChB,QAAQ;GAEV,MAAM,mBACJ,SAAS,oBACT,cAAuC,EAAE,KACtC;IACH,MAAM,UAAU;KACd;KACA,OAAO;KACP,SAAS,CAAC,aAAa;KACvB,GAAG;KACJ;AACD,WAAO;KACL,SAAS;KACT,OAAO,EAAE,cAAc,SAAS;KAChC,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,KAAK,UAAU,QAAQ;MAAE,CAAC;KAC3D;;AAGH,OAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO,iBAAiB;GAGjE,IAAIA;AACJ,OAAI;AACF,cAAU,MAAM,IAAI,cAAc,MAAM;AACxC,YAAQ,cAAc;WAChB;AACN,WAAO,gBAAgB,kBAAkB;;GAG3C,MAAM,KAAK,MAAM,OAAO,SAAS,aAAa;AAC9C,OAAI,CAAC,GAAG,QACN,QAAO,gBAAgB,GAAG,iBAAiB,mBAAmB,EAC5D,OAAO,GAAG,OACX,CAAC;GAIJ,IAAIC;GACJ,IAAI,SAAS;AACb,OAAI;AACF,aAAS,MAAM,GAAG,MAAM,MAAM;AAC9B,QACE,UACA,OAAO,WAAW,YAClB,aAAa,UACb,OAAO,QAEP,UAAS;YAEJ,GAAG;AACV,aAAS;AACT,aAAS;KACP,SAAS;KACT,SAAS,CACP;MAAE,MAAM;MAAQ,MAAM,0BAA0B,OAAO,EAAE;MAAI,CAC9D;KACF;;AAIH,OAAI,CAAC,OACH,KAAI;IACF,MAAM,IAAI,MAAM,OAAO,SAAS,aAAa;AAC7C,QAAI,EAAE,SAAS;AACb,YAAO,UAAU,EAAE;AACnB,YAAO,MAAM,2BAA2B;MACtC,SAAS;MACT,aAAa,EAAE;MACf,SAAS,EAAE;MACX,OAAO,EAAE;MACV;UAED,QAAO,gBAAgB,EAAE,eAAe,oBAAoB;WAExD;AACN,WAAO,gBAAgB,oBAAoB;;AAI/C,UAAO;KAEV;;AAGH,QAAO,eAAe,QAAQ,YAAY;EACxC,OAAO;EACP,UAAU;EACV,YAAY;EACZ,cAAc;EACf,CAAC;AAGF,QAAO;;AAOT,MAAM,WAAW,YAA4B;AAC3C,SAAQ,SAAR;EACE,KAAK,OACH,QAAO;EACT,KAAK,eACH,QAAO;EACT,QACE,OAAM,IAAI,MAAM,wBAAwB,UAAU;;;AAyBxD,SAAgB,eACd,QACA,YACyB;CACzB,MAAM,EAAE,SAAS,SAAS,YAAY;CACtC,MAAM,SAAS,mBAAmB;EAChC;EACA,WAAW,MAAM;EACjB,OAAO,QAAQ,QAAQ;EACxB,CAAC;CAEF,MAAM,kBAAkB,WAAW,mBAAmB,OAAO,KAAM,MAAM,EAAE;CAE3E,MAAM,aAAa,OAAO,UAAU,KAAK,OAAO;CAGhD,MAAMC,YAA+B,OAAO,QAAQ,YAAY;EAC9D,MAAM,WAAW,MAAM,WAAW,QAAQ,QAAQ;AAClD,WAAS,QAAQ,SAAS,MAAM,KAAK,SAAS;GAC5C,IAAI,cAAc,KAAK;AACvB,OAAI,KAAK,aAAa,aAAa;IACjC,MAAM,OAAO,KAAK,aAAa,kBAC3B,IAAI,KAAK,aAAa,oBACtB;AACJ,mBAAe,8CAA8C,KAAK;;AAEpE,UAAO;IACL,GAAG;IACH;IACD;IACD;AAIF,SAAO;;CAGT,MAAM,YAAY,OAAO,SAAS,KAAK,OAAO;CAE9C,MAAM,sBAAsB,OAC1B,0BAGA,QACA,cAGA,YACuC;EAEvC,MAAM,MAAM,MAAM,UAAU,QAAQ,cAAc,QAAQ;AAC1D,UAAQ,IAAI,OAAO,IAAI;EAGvB,MAAM,iBAAiB,IAAI,QAAQ;AAInC,MACE,IAAI,WACJ,kBACA,eAAe,WACf,MAAM,QAAQ,eAAe,QAAQ,IACrC,eAAe,QAAQ,SAAS,GAChC;GACA,MAAM,UAAU,eAAe;GAC/B,MAAM,uBACJ,4BAA4B,WAAW;AAGzC,OAAI,wBAAwB,CAAE,MAAM,qBAAqB,QAAQ,CAC/D,QAAO;IACL,SAAS;IACT,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM;KAAyB,CAAC;IAC3D;GAKH,MAAM,MACJ,QAAQ,MAAM,MAAM,GAAG,WAAW,WAAW,GAAG,YAAY,QAAQ,IACpE,QAAQ;AAEV,OAAI,CAAC,OAAO,IAAI,WAAW,QAAS,QAAO;GAE3C,MAAM,oBAAoB,OAAO,IAAI,kBAAkB;AACvD,OAAI,oBAAoB,gBACtB,QAAO;IACL,SAAS;IACT,SAAS,CACP;KACE,MAAM;KACN,MAAM,+BAA+B,kBAAkB,KAAK;KAC7D,CACF;IACF;GAIH,MAAM,QAAQ,MAAM,oBAClB,QACA,WAAW,GACX,IACD;AAGD,UAAO,UACL;IACE,GAAG;IACH,OAAO;KACL,GAAG,OAAO;KACV,gBAAgB;KACjB;IACF,EACD,cACA,QACD;;AAGH,SAAO;;CAGT,MAAM,UAAU;AAChB,SAAQ,YAAY;AACpB,QAAO,eAAe,SAAS,YAAY;EACzC,OAAO;EACP,UAAU;EACV,YAAY;EACZ,cAAc;EACf,CAAC;AAEF,QAAO"}
@@ -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,14 +1,3 @@
1
- import 'ai';
2
- export { b as Observability, O as ObservabilityEvent, g as genericObservability } from '../index-BCJclX6q.js';
3
- import 'cloudflare:workers';
4
- import '@modelcontextprotocol/sdk/client/index.js';
5
- import '@modelcontextprotocol/sdk/types.js';
6
- import 'partyserver';
7
- import '../client-DgyzBU_8.js';
8
- import 'zod';
9
- import '@modelcontextprotocol/sdk/shared/protocol.js';
10
- import '@modelcontextprotocol/sdk/client/sse.js';
11
- import '@modelcontextprotocol/sdk/client/streamableHttp.js';
12
- import '../mcp/do-oauth-client-provider.js';
13
- import '@modelcontextprotocol/sdk/client/auth.js';
14
- 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-JXN5WZFQ.js";
4
- import "../chunk-HY7ZLHJB.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-B6MjW6n-.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-CRBsIQ1z.d.ts.map
package/dist/react.d.ts CHANGED
@@ -1,121 +1,10 @@
1
- import { PartySocket } from "partysocket";
2
- import { usePartySocket } from "partysocket/react";
3
- import { M as MCPServersState, A as Agent } from "./index-BCJclX6q.js";
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-DgyzBU_8.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
-
20
- /**
21
- * Options for the useAgent hook
22
- * @template State Type of the Agent's state
23
- */
24
- type UseAgentOptions<State = unknown> = Omit<
25
- Parameters<typeof usePartySocket>[0],
26
- "party" | "room"
27
- > & {
28
- /** Name of the agent to connect to */
29
- agent: string;
30
- /** Name of the specific Agent instance */
31
- name?: string;
32
- /** Called when the Agent's state is updated */
33
- onStateUpdate?: (state: State, source: "server" | "client") => void;
34
- /** Called when MCP server state is updated */
35
- onMcpUpdate?: (mcpServers: MCPServersState) => void;
36
- };
37
- type AllOptional<T> = T extends [infer A, ...infer R]
38
- ? undefined extends A
39
- ? AllOptional<R>
40
- : false
41
- : true;
42
- type RPCMethods<T> = {
43
- [K in keyof T as T[K] extends RPCMethod<T[K]> ? K : never]: RPCMethod<T[K]>;
44
- };
45
- type OptionalParametersMethod<T extends RPCMethod> =
46
- AllOptional<Parameters<T>> extends true ? T : never;
47
- type AgentMethods<T> = Omit<RPCMethods<T>, keyof Agent<any, any>>;
48
- type OptionalAgentMethods<T> = {
49
- [K in keyof AgentMethods<T> as AgentMethods<T>[K] extends OptionalParametersMethod<
50
- AgentMethods<T>[K]
51
- >
52
- ? K
53
- : never]: OptionalParametersMethod<AgentMethods<T>[K]>;
54
- };
55
- type RequiredAgentMethods<T> = Omit<
56
- AgentMethods<T>,
57
- keyof OptionalAgentMethods<T>
58
- >;
59
- type AgentPromiseReturnType<T, K extends keyof AgentMethods<T>> =
60
- ReturnType<AgentMethods<T>[K]> extends Promise<any>
61
- ? ReturnType<AgentMethods<T>[K]>
62
- : Promise<ReturnType<AgentMethods<T>[K]>>;
63
- type OptionalArgsAgentMethodCall<AgentT> = <
64
- K extends keyof OptionalAgentMethods<AgentT>
65
- >(
66
- method: K,
67
- args?: Parameters<OptionalAgentMethods<AgentT>[K]>,
68
- streamOptions?: StreamOptions
69
- ) => AgentPromiseReturnType<AgentT, K>;
70
- type RequiredArgsAgentMethodCall<AgentT> = <
71
- K extends keyof RequiredAgentMethods<AgentT>
72
- >(
73
- method: K,
74
- args: Parameters<RequiredAgentMethods<AgentT>[K]>,
75
- streamOptions?: StreamOptions
76
- ) => AgentPromiseReturnType<AgentT, K>;
77
- type AgentMethodCall<AgentT> = OptionalArgsAgentMethodCall<AgentT> &
78
- RequiredArgsAgentMethodCall<AgentT>;
79
- type UntypedAgentMethodCall = <T = unknown>(
80
- method: string,
81
- args?: unknown[],
82
- streamOptions?: StreamOptions
83
- ) => Promise<T>;
84
- type AgentStub<T> = {
85
- [K in keyof AgentMethods<T>]: (
86
- ...args: Parameters<AgentMethods<T>[K]>
87
- ) => AgentPromiseReturnType<AgentMethods<T>, K>;
88
- };
89
- type UntypedAgentStub = Record<string, Method>;
90
- /**
91
- * React hook for connecting to an Agent
92
- * @template State Type of the Agent's state
93
- * @template Agent Type of the Agent
94
- * @param options Connection options
95
- * @returns WebSocket connection with setState and call methods
96
- */
97
- declare function useAgent<State = unknown>(
98
- options: UseAgentOptions<State>
99
- ): PartySocket & {
100
- agent: string;
101
- name: string;
102
- setState: (state: State) => void;
103
- call: UntypedAgentMethodCall;
104
- stub: UntypedAgentStub;
105
- };
106
- declare function useAgent<
107
- AgentT extends {
108
- get state(): State;
109
- },
110
- State
111
- >(
112
- options: UseAgentOptions<State>
113
- ): PartySocket & {
114
- agent: string;
115
- name: string;
116
- setState: (state: State) => void;
117
- call: AgentMethodCall<AgentT>;
118
- stub: AgentStub<AgentT>;
119
- };
120
-
121
- export { type UseAgentOptions, useAgent };
1
+ import "./client-B17XUTV7.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-B6MjW6n-.js";
7
+ import "./serializable-CymX8ovI.js";
8
+ import "./client-CbWe9FBd.js";
9
+ import { n as useAgent, t as UseAgentOptions } from "./react-CRBsIQ1z.js";
10
+ export { UseAgentOptions, useAgent };