@naturalpay/sdk 0.0.4 → 0.0.5

package/dist/mcp/cli.js

@@ -211,6 +211,22 @@ function logToolCall(logger4, toolName, options) {
     logger4.info(`Tool call: ${toolName}`, extra);
   }
 }
+var toolCallStorage = new AsyncLocalStorage();
+function getToolCallHeader() {
+  const data = toolCallStorage.getStore();
+  if (!data) return void 0;
+  return btoa(JSON.stringify(data));
+}
+function runWithToolCall(name, args, fn) {
+  return toolCallStorage.run(
+    {
+      tool: name,
+      arguments: args,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    },
+    fn
+  );
+}
 
 // src/http.ts
 var logger = getLogger("http");
@@ -444,9 +460,15 @@ var HTTPClient = class {
       const headers = {
         Authorization: `Bearer ${jwt}`,
         "Content-Type": "application/json",
-        "User-Agent": `naturalpay-ts/${SDK_VERSION2}`,
-        ...options?.headers
+        "User-Agent": `naturalpay-ts/${SDK_VERSION2}`
       };
+      const toolCallHeader = getToolCallHeader();
+      if (toolCallHeader) {
+        headers["X-Tool-Call"] = toolCallHeader;
+      }
+      if (options?.headers) {
+        Object.assign(headers, options.headers);
+      }
       const response = await fetch(url, {
         method,
         headers,
@@ -562,9 +584,16 @@ var PaymentsResource = class extends BaseResource {
     };
     if (params.memo) attributes["description"] = params.memo;
     const body = { data: { attributes } };
+    const headers = { "Idempotency-Key": idempotencyKey };
+    if (params.agentId) {
+      headers["X-Agent-ID"] = params.agentId;
+    }
+    if (params.instanceId) {
+      headers["X-Instance-ID"] = params.instanceId;
+    }
     const response = await this.http.post("/payments", {
       body,
-      headers: { "Idempotency-Key": idempotencyKey }
+      headers
     });
     return unwrapPayment(response);
   }
@@ -574,8 +603,14 @@ var PaymentsResource = class extends BaseResource {
    * @param transferId - The transfer ID to look up
    * @returns Payment object with current status
    */
-  async retrieve(transferId) {
-    const response = await this.http.get(`/payments/${transferId}`);
+  async retrieve(transferId, options) {
+    const headers = {};
+    if (options?.instanceId) {
+      headers["X-Instance-ID"] = options.instanceId;
+    }
+    const response = await this.http.get(`/payments/${transferId}`, {
+      headers: Object.keys(headers).length > 0 ? headers : void 0
+    });
     return unwrapPayment(response);
   }
 };
@@ -658,8 +693,14 @@ var WalletResource = class extends BaseResource {
    *
    * @returns AccountBalance with available, current, pending amounts
    */
-  async balance() {
-    const response = await this.http.get("/wallet/balance");
+  async balance(options) {
+    const headers = {};
+    if (options?.instanceId) {
+      headers["X-Instance-ID"] = options.instanceId;
+    }
+    const response = await this.http.get("/wallet/balance", {
+      headers: Object.keys(headers).length > 0 ? headers : void 0
+    });
     return unwrapBalance(response);
   }
   /**
@@ -753,6 +794,9 @@ var TransactionsResource = class extends BaseResource {
     if (params?.customerPartyId) {
       headers["X-On-Behalf-Of"] = params.customerPartyId;
     }
+    if (params?.instanceId) {
+      headers["X-Instance-ID"] = params.instanceId;
+    }
     const response = await this.http.get("/transactions", {
       params: {
         limit: params?.limit ?? 50,
@@ -824,13 +868,18 @@ var AgentsResource = class extends BaseResource {
    * @returns AgentListResponse with list of agents
    */
   async list(params) {
+    const headers = {};
+    if (params?.instanceId) {
+      headers["X-Instance-ID"] = params.instanceId;
+    }
     const response = await this.http.get("/agents", {
       params: {
         status: params?.status,
         partyId: params?.partyId,
         limit: params?.limit ?? 50,
         cursor: params?.cursor
-      }
+      },
+      headers: Object.keys(headers).length > 0 ? headers : void 0
     });
     return unwrapAgentList(response);
   }
@@ -1099,7 +1148,8 @@ var NaturalClient = class {
 
 // src/mcp/server.ts
 var logger2 = getLogger("mcp.server");
-function createServer(apiKey) {
+function createServer(apiKeyOrOptions) {
+  const options = typeof apiKeyOrOptions === "string" ? { apiKey: apiKeyOrOptions } : apiKeyOrOptions ?? {};
   logger2.info("Creating Natural Payments MCP server");
   const server = new FastMCP({
     name: "Natural Payments",
@@ -1108,7 +1158,7 @@ function createServer(apiKey) {
   let client = null;
   const getClient = () => {
     if (!client) {
-      client = new NaturalClient({ apiKey });
+      client = new NaturalClient({ apiKey: options.apiKey });
     }
     return client;
   };
@@ -1119,11 +1169,13 @@ function createServer(apiKey) {
       amount: z.number().positive().describe("Payment amount"),
       memo: z.string().describe("Payment memo (required)"),
       customerPartyId: z.string().describe("Customer party ID on whose behalf (pty_xxx)"),
+      agentId: z.string().optional().describe("Agent ID (agt_xxx) for agent-initiated payments"),
       recipientEmail: z.string().email().optional().describe("Recipient email address"),
       recipientPhone: z.string().optional().describe("Recipient phone number"),
-      recipientPartyId: z.string().optional().describe("Recipient party ID (pty_xxx)")
+      recipientPartyId: z.string().optional().describe("Recipient party ID (pty_xxx)"),
+      instanceId: z.string().optional().describe("Developer's session/conversation ID for observability grouping")
     }),
-    execute: async (args) => {
+    execute: async (args) => runWithToolCall("create_payment", args, async () => {
       const startTime = Date.now();
       try {
         const result = await getClient().payments.create({
@@ -1132,7 +1184,9 @@ function createServer(apiKey) {
           recipientPartyId: args.recipientPartyId,
           amount: args.amount,
           memo: args.memo,
-          customerPartyId: args.customerPartyId
+          customerPartyId: args.customerPartyId,
+          agentId: args.agentId,
+          instanceId: args.instanceId
         });
         const durationMs = Date.now() - startTime;
         logToolCall(logger2, "create_payment", { success: true, durationMs });
@@ -1146,18 +1200,21 @@ function createServer(apiKey) {
         });
         throw error;
       }
-    }
+    })
   });
   server.addTool({
     name: "get_payment_status",
     description: "Check the status of a payment by transfer ID",
     parameters: z.object({
-      transferId: z.string().describe("The transfer ID returned from create_payment")
+      transferId: z.string().describe("The transfer ID returned from create_payment"),
+      instanceId: z.string().optional().describe("Developer's session/conversation ID for observability grouping")
     }),
-    execute: async (args) => {
+    execute: async (args) => runWithToolCall("get_payment_status", args, async () => {
       const startTime = Date.now();
       try {
-        const result = await getClient().payments.retrieve(args.transferId);
+        const result = await getClient().payments.retrieve(args.transferId, {
+          instanceId: args.instanceId
+        });
         const durationMs = Date.now() - startTime;
         logToolCall(logger2, "get_payment_status", { success: true, durationMs });
         return JSON.stringify(result, null, 2);
@@ -1170,16 +1227,18 @@ function createServer(apiKey) {
         });
         throw error;
       }
-    }
+    })
   });
   server.addTool({
     name: "get_account_balance",
     description: "Get the current wallet balance",
-    parameters: z.object({}),
-    execute: async () => {
+    parameters: z.object({
+      instanceId: z.string().optional().describe("Developer's session/conversation ID for observability grouping")
+    }),
+    execute: async (args) => runWithToolCall("get_account_balance", args, async () => {
       const startTime = Date.now();
       try {
-        const result = await getClient().wallet.balance();
+        const result = await getClient().wallet.balance({ instanceId: args.instanceId });
         const balances = result.balances.map((bal) => ({
           assetCode: bal.assetCode,
           available: bal.available.amountDollars,
@@ -1210,7 +1269,7 @@ function createServer(apiKey) {
         });
         throw error;
       }
-    }
+    })
   });
   server.addTool({
     name: "list_transactions",
@@ -1219,16 +1278,18 @@ function createServer(apiKey) {
       limit: z.number().min(1).max(100).default(50).describe("Maximum number of transactions"),
       cursor: z.string().optional().describe("Pagination cursor from previous response"),
       agentId: z.string().optional().describe("Agent ID for agent-context authentication"),
-      customerPartyId: z.string().optional().describe("Customer party ID when acting on behalf of customer")
+      customerPartyId: z.string().optional().describe("Customer party ID when acting on behalf of customer"),
+      instanceId: z.string().optional().describe("Developer's session/conversation ID for observability grouping")
     }),
-    execute: async (args) => {
+    execute: async (args) => runWithToolCall("list_transactions", args, async () => {
       const startTime = Date.now();
       try {
         const result = await getClient().transactions.list({
           limit: args.limit,
           cursor: args.cursor,
           agentId: args.agentId,
-          customerPartyId: args.customerPartyId
+          customerPartyId: args.customerPartyId,
+          instanceId: args.instanceId
         });
         const durationMs = Date.now() - startTime;
         logToolCall(logger2, "list_transactions", { success: true, durationMs });
@@ -1242,21 +1303,23 @@ function createServer(apiKey) {
         });
         throw error;
       }
-    }
+    })
   });
   server.addTool({
     name: "list_agents",
     description: "List agents for the partner",
     parameters: z.object({
       status: z.enum(["ACTIVE", "REVOKED"]).optional().describe("Filter by status"),
-      limit: z.number().min(1).max(100).default(50).describe("Maximum number of agents")
+      limit: z.number().min(1).max(100).default(50).describe("Maximum number of agents"),
+      instanceId: z.string().optional().describe("Developer's session/conversation ID for observability grouping")
     }),
-    execute: async (args) => {
+    execute: async (args) => runWithToolCall("list_agents", args, async () => {
       const startTime = Date.now();
       try {
         const result = await getClient().agents.list({
           status: args.status,
-          limit: args.limit
+          limit: args.limit,
+          instanceId: args.instanceId
         });
         const durationMs = Date.now() - startTime;
         logToolCall(logger2, "list_agents", { success: true, durationMs });
@@ -1270,7 +1333,7 @@ function createServer(apiKey) {
         });
         throw error;
       }
-    }
+    })
   });
   return server;
 }
@@ -1295,7 +1358,7 @@ mcpCommand.command("serve").description("Start the MCP server").option("-t, --tr
   if (options.serverUrl) {
     process.env["NATURAL_SERVER_URL"] = options.serverUrl;
   }
-  const server = createServer(options.apiKey);
+  const server = createServer({ apiKey: options.apiKey });
   if (options.transport === "stdio") {
     logger3.info("Running with stdio transport");
     server.start({ transportType: "stdio" });