@stripe/link-sdk 0.8.0 → 0.9.1

package/dist/tools/__tests__/tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.test.d.ts.map

package/dist/tools/__tests__/tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/tools.test.ts"],"names":[],"mappings":""}

package/dist/tools/index.d.ts

@@ -0,0 +1,299 @@
+import type { z } from 'zod';
+import type { Link } from '../client';
+export { linkToolSchemas } from './schemas';
+/**
+ * Standard Schema tools with no agent-framework dependency. A resolver runs
+ * for each execution, so a shared catalog can safely serve multiple users.
+ * Credentials are never resolved during tool discovery.
+ */
+export declare function createLinkTools<Context = unknown>(client: Link | ((context: Context) => Link | Promise<Link>)): {
+    retrieve_user_info: {
+        description: string;
+        inputSchema: z.ZodObject<{}, z.core.$strict>;
+        execute(input: Record<string, never>, context: Context): Promise<import("..").UserInfo>;
+    };
+    list_payment_methods: {
+        description: string;
+        inputSchema: z.ZodObject<{}, z.core.$strict>;
+        execute(input: Record<string, never>, context: Context): Promise<import("..").PaymentMethod[]>;
+    };
+    list_shipping_addresses: {
+        description: string;
+        inputSchema: z.ZodObject<{}, z.core.$strict>;
+        execute(input: Record<string, never>, context: Context): Promise<import("..").ShippingAddressRecord[]>;
+    };
+    list_spend_requests: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            include_history: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+        execute(input: {
+            include_history?: boolean | undefined;
+        }, context: Context): Promise<import("..").SpendRequest[]>;
+    };
+    create_spend_request: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            idempotency_key: z.ZodOptional<z.ZodString>;
+            payment_details: z.ZodOptional<z.ZodString>;
+            credential_type: z.ZodDefault<z.ZodEnum<{
+                card: "card";
+                shared_payment_token: "shared_payment_token";
+            }>>;
+            network_id: z.ZodOptional<z.ZodString>;
+            execution_method: z.ZodOptional<z.ZodLiteral<"link_pay_token">>;
+            merchant_account_id: z.ZodOptional<z.ZodString>;
+            amount: z.ZodNumber;
+            currency: z.ZodDefault<z.ZodString>;
+            merchant_name: z.ZodOptional<z.ZodString>;
+            merchant_url: z.ZodOptional<z.ZodURL>;
+            context: z.ZodString;
+            line_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                quantity: z.ZodOptional<z.ZodNumber>;
+                unit_amount: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+                sku: z.ZodOptional<z.ZodString>;
+                url: z.ZodOptional<z.ZodString>;
+                image_url: z.ZodOptional<z.ZodString>;
+                product_url: z.ZodOptional<z.ZodString>;
+                totals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    display_text: z.ZodString;
+                    amount: z.ZodNumber;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>>;
+            totals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                display_text: z.ZodString;
+                amount: z.ZodNumber;
+            }, z.core.$strict>>>;
+            request_approval: z.ZodDefault<z.ZodBoolean>;
+            test: z.ZodDefault<z.ZodBoolean>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>;
+        execute(input: {
+            idempotency_key?: string | undefined;
+            payment_details?: string | undefined;
+            credential_type?: "card" | "shared_payment_token" | undefined;
+            network_id?: string | undefined;
+            execution_method?: "link_pay_token" | undefined;
+            merchant_account_id?: string | undefined;
+            amount: number;
+            currency?: string | undefined;
+            merchant_name?: string | undefined;
+            merchant_url?: string | undefined;
+            context: string;
+            line_items?: {
+                name: string;
+                quantity?: number | undefined;
+                unit_amount?: number | undefined;
+                description?: string | undefined;
+                sku?: string | undefined;
+                url?: string | undefined;
+                image_url?: string | undefined;
+                product_url?: string | undefined;
+                totals?: {
+                    type: string;
+                    display_text: string;
+                    amount: number;
+                }[] | undefined;
+            }[] | undefined;
+            totals?: {
+                type: string;
+                display_text: string;
+                amount: number;
+            }[] | undefined;
+            request_approval?: boolean | undefined;
+            test?: boolean | undefined;
+            metadata?: Record<string, string> | undefined;
+        }, context: Context): Promise<import("..").SpendRequest>;
+    };
+    retrieve_spend_request: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        execute(input: {
+            id: string;
+            include?: string[] | undefined;
+        }, context: Context): Promise<import("..").SpendRequest | null>;
+    };
+    update_spend_request: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            payment_details: z.ZodOptional<z.ZodString>;
+            amount: z.ZodOptional<z.ZodNumber>;
+            currency: z.ZodOptional<z.ZodString>;
+            merchant_url: z.ZodOptional<z.ZodURL>;
+            profile_id: z.ZodOptional<z.ZodString>;
+            merchant_id: z.ZodOptional<z.ZodString>;
+            line_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                quantity: z.ZodOptional<z.ZodNumber>;
+                unit_amount: z.ZodOptional<z.ZodNumber>;
+                description: z.ZodOptional<z.ZodString>;
+                sku: z.ZodOptional<z.ZodString>;
+                url: z.ZodOptional<z.ZodString>;
+                image_url: z.ZodOptional<z.ZodString>;
+                product_url: z.ZodOptional<z.ZodString>;
+                totals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    type: z.ZodString;
+                    display_text: z.ZodString;
+                    amount: z.ZodNumber;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>>;
+            totals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                display_text: z.ZodString;
+                amount: z.ZodNumber;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        execute(input: {
+            id: string;
+            payment_details?: string | undefined;
+            amount?: number | undefined;
+            currency?: string | undefined;
+            merchant_url?: string | undefined;
+            profile_id?: string | undefined;
+            merchant_id?: string | undefined;
+            line_items?: {
+                name: string;
+                quantity?: number | undefined;
+                unit_amount?: number | undefined;
+                description?: string | undefined;
+                sku?: string | undefined;
+                url?: string | undefined;
+                image_url?: string | undefined;
+                product_url?: string | undefined;
+                totals?: {
+                    type: string;
+                    display_text: string;
+                    amount: number;
+                }[] | undefined;
+            }[] | undefined;
+            totals?: {
+                type: string;
+                display_text: string;
+                amount: number;
+            }[] | undefined;
+        }, context: Context): Promise<import("..").SpendRequest>;
+    };
+    request_spend_approval: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strict>;
+        execute(input: {
+            id: string;
+        }, context: Context): Promise<import("..").RequestApprovalResponse>;
+    };
+    cancel_spend_request: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strict>;
+        execute(input: {
+            id: string;
+        }, context: Context): Promise<import("..").SpendRequest>;
+    };
+    list_transactions: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            limit: z.ZodOptional<z.ZodNumber>;
+            starting_after: z.ZodOptional<z.ZodString>;
+            ending_before: z.ZodOptional<z.ZodString>;
+            start_date: z.ZodOptional<z.ZodISODate>;
+            end_date: z.ZodOptional<z.ZodISODate>;
+            category: z.ZodOptional<z.ZodString>;
+            origin: z.ZodOptional<z.ZodEnum<{
+                external_connection: "external_connection";
+                link: "link";
+            }>>;
+            sources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        execute(input: {
+            limit?: number | undefined;
+            starting_after?: string | undefined;
+            ending_before?: string | undefined;
+            start_date?: string | undefined;
+            end_date?: string | undefined;
+            category?: string | undefined;
+            origin?: "external_connection" | "link" | undefined;
+            sources?: string[] | undefined;
+        }, context: Context): Promise<import("..").TransactionsPage>;
+    };
+    list_sources: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            limit: z.ZodOptional<z.ZodNumber>;
+            starting_after: z.ZodOptional<z.ZodString>;
+            ending_before: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        execute(input: {
+            limit?: number | undefined;
+            starting_after?: string | undefined;
+            ending_before?: string | undefined;
+        }, context: Context): Promise<import("..").SourcesPage>;
+    };
+    list_balances: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            limit: z.ZodOptional<z.ZodNumber>;
+            starting_after: z.ZodOptional<z.ZodString>;
+            ending_before: z.ZodOptional<z.ZodString>;
+            sources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        execute(input: {
+            limit?: number | undefined;
+            starting_after?: string | undefined;
+            ending_before?: string | undefined;
+            sources?: string[] | undefined;
+        }, context: Context): Promise<import("..").BalancesPage>;
+    };
+    create_report: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            domain: z.ZodString;
+            outcome: z.ZodEnum<{
+                abandoned: "abandoned";
+                blocked: "blocked";
+                success: "success";
+            }>;
+            spend_request_id: z.ZodString;
+            tags: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "3ds_challenge": "3ds_challenge";
+                anti_bot_script: "anti_bot_script";
+                captcha: "captcha";
+                cdn_block: "cdn_block";
+                dns_block: "dns_block";
+                login_required: "login_required";
+                other: "other";
+                page_inaccessible: "page_inaccessible";
+                payment_declined: "payment_declined";
+                rate_limited: "rate_limited";
+                site_error: "site_error";
+                stripe_checkout: "stripe_checkout";
+                timeout: "timeout";
+                waf_block: "waf_block";
+            }>>>;
+            step: z.ZodOptional<z.ZodString>;
+            freeform_context: z.ZodOptional<z.ZodString>;
+            attempt_trace: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        execute(input: {
+            domain: string;
+            outcome: "abandoned" | "blocked" | "success";
+            spend_request_id: string;
+            tags?: ("3ds_challenge" | "anti_bot_script" | "captcha" | "cdn_block" | "dns_block" | "login_required" | "other" | "page_inaccessible" | "payment_declined" | "rate_limited" | "site_error" | "stripe_checkout" | "timeout" | "waf_block")[] | undefined;
+            step?: string | undefined;
+            freeform_context?: string | undefined;
+            attempt_trace?: string | undefined;
+        }, context: Context): Promise<import("..").ReportRecord>;
+    };
+};
+export type LinkTools<Context = unknown> = ReturnType<typeof createLinkTools<Context>>;
+export type LinkToolName = keyof LinkTools;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAqB5C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAG,OAAO,EAC/C,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAoBzD,kBAAkB;;;uDAV+B,OAAO;;IAexD,oBAAoB;;;uDAf6B,OAAO;;IAoBxD,uBAAuB;;;uDApB0B,OAAO;;IAyBxD,mBAAmB;;;;;;;oBAzB8B,OAAO;;IAmCxD,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAnC6B,OAAO;;IAwCxD,sBAAsB;;;;;;;;;oBAxC2B,OAAO;;IA6CxD,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA7C6B,OAAO;;IAkDxD,sBAAsB;;;;;;;oBAlD2B,OAAO;;IAuDxD,oBAAoB;;;;;;;oBAvD6B,OAAO;;IA4DxD,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;oBA5DgC,OAAO;;IAiExD,YAAY;;;;;;;;;;;oBAjEqC,OAAO;;IAsExD,aAAa;;;;;;;;;;;;;oBAtEoC,OAAO;;IA2ExD,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA3EoC,OAAO;;EAiF3D;AAED,MAAM,MAAM,SAAS,CAAC,OAAO,GAAG,OAAO,IAAI,UAAU,CACnD,OAAO,eAAe,CAAC,OAAO,CAAC,CAChC,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,233 @@
+import {
+  REPORT_OUTCOMES,
+  REPORT_TAGS
+} from "../chunk-TYOT25QK.js";
+
+// src/tools/schemas.ts
+import { z } from "zod";
+var id = z.string().min(1);
+var money = z.number().int();
+var total = z.strictObject({
+  type: z.string(),
+  display_text: z.string(),
+  amount: money
+});
+var lineItem = z.strictObject({
+  name: z.string(),
+  quantity: z.number().int().positive().optional(),
+  unit_amount: money.optional(),
+  description: z.string().optional(),
+  sku: z.string().optional(),
+  url: z.string().optional(),
+  image_url: z.string().optional(),
+  product_url: z.string().optional(),
+  totals: z.array(total).optional()
+});
+var pagination = {
+  limit: z.number().int().min(1).max(100).optional(),
+  starting_after: id.optional(),
+  ending_before: id.optional()
+};
+var linkToolSchemas = {
+  empty: z.strictObject({}),
+  spendRequestId: z.strictObject({ id: id.describe("Link spend request ID") }),
+  listSpendRequests: z.strictObject({
+    include_history: z.boolean().optional().describe("Include expired and terminal requests")
+  }),
+  retrieveSpendRequest: z.strictObject({
+    id: id.describe("Link spend request ID"),
+    include: z.array(z.string()).optional().describe(
+      "Extra data to return, such as card credentials. Request only when needed for checkout."
+    )
+  }),
+  createSpendRequest: z.strictObject({
+    idempotency_key: id.refine(
+      (key) => new TextEncoder().encode(key).length <= 255,
+      "At most 255 UTF-8 bytes"
+    ).optional().describe("Reuse only when retrying the same logical creation."),
+    payment_details: id.optional().describe("Payment method ID; omit to use the default."),
+    credential_type: z.enum(["card", "shared_payment_token"]).default("card"),
+    network_id: id.optional().describe("Required for shared payment tokens."),
+    execution_method: z.literal("link_pay_token").optional(),
+    merchant_account_id: id.optional().describe(
+      "For link_pay_token, read data-stripe-merchant-account from the checkout DOM."
+    ),
+    amount: money.positive().max(5e5).describe("Amount in cents."),
+    currency: z.string().length(3).default("usd"),
+    merchant_name: z.string().min(1).optional(),
+    merchant_url: z.url().optional(),
+    context: z.string().min(100).describe(
+      "Describe the purchase and rationale. The user reads this when approving."
+    ),
+    line_items: z.array(lineItem).optional(),
+    totals: z.array(total).optional(),
+    request_approval: z.boolean().default(true).describe(
+      "Ask Link for user approval; return the approval URL without polling."
+    ),
+    test: z.boolean().default(false).describe("Create test credentials instead of live credentials."),
+    metadata: z.record(z.string().max(40), z.string().max(500)).refine(
+      (value) => Object.keys(value).length <= 50,
+      "At most 50 metadata entries"
+    ).optional()
+  }).superRefine((value, ctx) => {
+    if (value.execution_method === "link_pay_token") {
+      if (!value.merchant_account_id || value.credential_type !== "card" || value.test || value.network_id || value.merchant_name || value.merchant_url) {
+        ctx.addIssue({
+          code: "custom",
+          message: "link_pay_token requires merchant_account_id and card credentials; omit merchant_name, merchant_url, network_id, and test mode."
+        });
+      }
+    } else if (value.merchant_account_id) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["merchant_account_id"],
+        message: "Requires execution_method: link_pay_token."
+      });
+    } else if (value.credential_type === "shared_payment_token") {
+      if (!value.network_id)
+        ctx.addIssue({
+          code: "custom",
+          path: ["network_id"],
+          message: "Required for shared payment tokens."
+        });
+    } else if (!value.merchant_name || !value.merchant_url) {
+      ctx.addIssue({
+        code: "custom",
+        message: "Card requests require merchant_name and merchant_url."
+      });
+    }
+  }),
+  updateSpendRequest: z.strictObject({
+    id,
+    payment_details: id.optional(),
+    amount: money.positive().max(5e5).optional(),
+    currency: z.string().length(3).optional(),
+    merchant_url: z.url().optional(),
+    profile_id: id.optional(),
+    merchant_id: id.optional(),
+    line_items: z.array(lineItem).optional(),
+    totals: z.array(total).optional()
+  }),
+  listTransactions: z.strictObject({
+    ...pagination,
+    start_date: z.iso.date().optional(),
+    end_date: z.iso.date().optional(),
+    category: z.string().optional(),
+    origin: z.enum(["link", "external_connection"]).optional(),
+    sources: z.array(id).optional()
+  }),
+  listSources: z.strictObject(pagination),
+  listBalances: z.strictObject({
+    ...pagination,
+    sources: z.array(id).optional()
+  }),
+  createReport: z.strictObject({
+    domain: z.string().min(1),
+    outcome: z.enum(REPORT_OUTCOMES),
+    spend_request_id: id,
+    tags: z.array(z.enum(REPORT_TAGS)).optional(),
+    step: z.string().max(500).optional(),
+    freeform_context: z.string().max(500).optional(),
+    attempt_trace: z.string().optional().describe(
+      "Ordered account of the attempt. The API truncates long traces."
+    )
+  })
+};
+
+// src/tools/index.ts
+function defined(value) {
+  if (Array.isArray(value)) return value.map(defined);
+  if (value !== null && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).filter(([, item]) => item !== void 0).map(([key, item]) => [key, defined(item)])
+    );
+  }
+  return value;
+}
+function createLinkTools(client) {
+  function tool(description, inputSchema, execute) {
+    return {
+      description,
+      inputSchema,
+      async execute(input, context) {
+        const params = defined(inputSchema.parse(input));
+        const link = typeof client === "function" ? await client(context) : client;
+        return execute(link, params);
+      }
+    };
+  }
+  return {
+    retrieve_user_info: tool(
+      "Retrieve the connected Link user profile, wallet limits, and verification requirements.",
+      linkToolSchemas.empty,
+      (link) => link.userInfo.retrieve()
+    ),
+    list_payment_methods: tool(
+      "List saved Link payment methods and identify the default method.",
+      linkToolSchemas.empty,
+      (link) => link.paymentMethods.list()
+    ),
+    list_shipping_addresses: tool(
+      "List the connected Link user\u2019s saved shipping addresses.",
+      linkToolSchemas.empty,
+      (link) => link.shippingAddresses.list()
+    ),
+    list_spend_requests: tool(
+      "List Link spend requests and their current statuses.",
+      linkToolSchemas.listSpendRequests,
+      (link, input) => link.spendRequests.list(
+        input.include_history === void 0 ? {} : { includeHistory: input.include_history }
+      )
+    ),
+    create_spend_request: tool(
+      "Create a Link spend request for a purchase. Show approval_url to the user; creating a request does not establish approval. Retrieve the same request after approval or required actions.",
+      linkToolSchemas.createSpendRequest,
+      (link, input) => link.spendRequests.create(input)
+    ),
+    retrieve_spend_request: tool(
+      "Retrieve a Link spend request, its approval status, and requested credentials. Follow status_details.requires_action instructions; never assume approval from an earlier status.",
+      linkToolSchemas.retrieveSpendRequest,
+      (link, { id: id2, ...options }) => link.spendRequests.retrieve(id2, options)
+    ),
+    update_spend_request: tool(
+      "Update an existing Link spend request. Check the returned approval status before using credentials.",
+      linkToolSchemas.updateSpendRequest,
+      (link, { id: id2, ...params }) => link.spendRequests.update(id2, params)
+    ),
+    request_spend_approval: tool(
+      "Request human approval for a Link spend request. Show the returned approval URL to the user.",
+      linkToolSchemas.spendRequestId,
+      (link, { id: id2 }) => link.spendRequests.requestApproval(id2)
+    ),
+    cancel_spend_request: tool(
+      "Cancel a Link spend request.",
+      linkToolSchemas.spendRequestId,
+      (link, { id: id2 }) => link.spendRequests.cancel(id2)
+    ),
+    list_transactions: tool(
+      "List Link transactions. Requires the user\u2019s grant to include access to the requested sources.",
+      linkToolSchemas.listTransactions,
+      (link, input) => link.transactions.list(input)
+    ),
+    list_sources: tool(
+      "List connected financial sources available to the Link grant.",
+      linkToolSchemas.listSources,
+      (link, input) => link.sources.list(input)
+    ),
+    list_balances: tool(
+      "List balances for financial sources available to the Link grant.",
+      linkToolSchemas.listBalances,
+      (link, input) => link.balances.list(input)
+    ),
+    create_report: tool(
+      "Report the outcome of a purchase attempt associated with a Link spend request.",
+      linkToolSchemas.createReport,
+      (link, input) => link.reports.create(input)
+    )
+  };
+}
+export {
+  createLinkTools,
+  linkToolSchemas
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tools/schemas.ts","../../src/tools/index.ts"],"sourcesContent":["import { z } from 'zod';\nimport { REPORT_OUTCOMES, REPORT_TAGS } from '../resources/interfaces';\n\nconst id = z.string().min(1);\nconst money = z.number().int();\nconst total = z.strictObject({\n  type: z.string(),\n  display_text: z.string(),\n  amount: money,\n});\nconst lineItem = z.strictObject({\n  name: z.string(),\n  quantity: z.number().int().positive().optional(),\n  unit_amount: money.optional(),\n  description: z.string().optional(),\n  sku: z.string().optional(),\n  url: z.string().optional(),\n  image_url: z.string().optional(),\n  product_url: z.string().optional(),\n  totals: z.array(total).optional(),\n});\nconst pagination = {\n  limit: z.number().int().min(1).max(100).optional(),\n  starting_after: id.optional(),\n  ending_before: id.optional(),\n};\n\n/** API inputs, independent of CLI flags and framework execution context. */\nexport const linkToolSchemas = {\n  empty: z.strictObject({}),\n  spendRequestId: z.strictObject({ id: id.describe('Link spend request ID') }),\n  listSpendRequests: z.strictObject({\n    include_history: z\n      .boolean()\n      .optional()\n      .describe('Include expired and terminal requests'),\n  }),\n  retrieveSpendRequest: z.strictObject({\n    id: id.describe('Link spend request ID'),\n    include: z\n      .array(z.string())\n      .optional()\n      .describe(\n        'Extra data to return, such as card credentials. Request only when needed for checkout.',\n      ),\n  }),\n  createSpendRequest: z\n    .strictObject({\n      idempotency_key: id\n        .refine(\n          (key) => new TextEncoder().encode(key).length <= 255,\n          'At most 255 UTF-8 bytes',\n        )\n        .optional()\n        .describe('Reuse only when retrying the same logical creation.'),\n      payment_details: id\n        .optional()\n        .describe('Payment method ID; omit to use the default.'),\n      credential_type: z.enum(['card', 'shared_payment_token']).default('card'),\n      network_id: id.optional().describe('Required for shared payment tokens.'),\n      execution_method: z.literal('link_pay_token').optional(),\n      merchant_account_id: id\n        .optional()\n        .describe(\n          'For link_pay_token, read data-stripe-merchant-account from the checkout DOM.',\n        ),\n      amount: money.positive().max(500000).describe('Amount in cents.'),\n      currency: z.string().length(3).default('usd'),\n      merchant_name: z.string().min(1).optional(),\n      merchant_url: z.url().optional(),\n      context: z\n        .string()\n        .min(100)\n        .describe(\n          'Describe the purchase and rationale. The user reads this when approving.',\n        ),\n      line_items: z.array(lineItem).optional(),\n      totals: z.array(total).optional(),\n      request_approval: z\n        .boolean()\n        .default(true)\n        .describe(\n          'Ask Link for user approval; return the approval URL without polling.',\n        ),\n      test: z\n        .boolean()\n        .default(false)\n        .describe('Create test credentials instead of live credentials.'),\n      metadata: z\n        .record(z.string().max(40), z.string().max(500))\n        .refine(\n          (value) => Object.keys(value).length <= 50,\n          'At most 50 metadata entries',\n        )\n        .optional(),\n    })\n    .superRefine((value, ctx) => {\n      if (value.execution_method === 'link_pay_token') {\n        if (\n          !value.merchant_account_id ||\n          value.credential_type !== 'card' ||\n          value.test ||\n          value.network_id ||\n          value.merchant_name ||\n          value.merchant_url\n        ) {\n          ctx.addIssue({\n            code: 'custom',\n            message:\n              'link_pay_token requires merchant_account_id and card credentials; omit merchant_name, merchant_url, network_id, and test mode.',\n          });\n        }\n      } else if (value.merchant_account_id) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['merchant_account_id'],\n          message: 'Requires execution_method: link_pay_token.',\n        });\n      } else if (value.credential_type === 'shared_payment_token') {\n        if (!value.network_id)\n          ctx.addIssue({\n            code: 'custom',\n            path: ['network_id'],\n            message: 'Required for shared payment tokens.',\n          });\n      } else if (!value.merchant_name || !value.merchant_url) {\n        ctx.addIssue({\n          code: 'custom',\n          message: 'Card requests require merchant_name and merchant_url.',\n        });\n      }\n    }),\n  updateSpendRequest: z.strictObject({\n    id,\n    payment_details: id.optional(),\n    amount: money.positive().max(500000).optional(),\n    currency: z.string().length(3).optional(),\n    merchant_url: z.url().optional(),\n    profile_id: id.optional(),\n    merchant_id: id.optional(),\n    line_items: z.array(lineItem).optional(),\n    totals: z.array(total).optional(),\n  }),\n  listTransactions: z.strictObject({\n    ...pagination,\n    start_date: z.iso.date().optional(),\n    end_date: z.iso.date().optional(),\n    category: z.string().optional(),\n    origin: z.enum(['link', 'external_connection']).optional(),\n    sources: z.array(id).optional(),\n  }),\n  listSources: z.strictObject(pagination),\n  listBalances: z.strictObject({\n    ...pagination,\n    sources: z.array(id).optional(),\n  }),\n  createReport: z.strictObject({\n    domain: z.string().min(1),\n    outcome: z.enum(REPORT_OUTCOMES),\n    spend_request_id: id,\n    tags: z.array(z.enum(REPORT_TAGS)).optional(),\n    step: z.string().max(500).optional(),\n    freeform_context: z.string().max(500).optional(),\n    attempt_trace: z\n      .string()\n      .optional()\n      .describe(\n        'Ordered account of the attempt. The API truncates long traces.',\n      ),\n  }),\n};\n","import type { z } from 'zod';\nimport type { Link } from '../client';\nimport { linkToolSchemas as schemas } from './schemas';\n\nexport { linkToolSchemas } from './schemas';\n\ntype Defined<T> = T extends readonly (infer Item)[]\n  ? Defined<Item>[]\n  : T extends object\n    ? { [Key in keyof T]: Defined<Exclude<T[Key], undefined>> }\n    : T;\n\n// Zod permits explicit undefined on optional inputs; API parameter types do not.\nfunction defined<T>(value: T): Defined<T> {\n  if (Array.isArray(value)) return value.map(defined) as Defined<T>;\n  if (value !== null && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.entries(value)\n        .filter(([, item]) => item !== undefined)\n        .map(([key, item]) => [key, defined(item)]),\n    ) as Defined<T>;\n  }\n  return value as Defined<T>;\n}\n\n/**\n * Standard Schema tools with no agent-framework dependency. A resolver runs\n * for each execution, so a shared catalog can safely serve multiple users.\n * Credentials are never resolved during tool discovery.\n */\nexport function createLinkTools<Context = unknown>(\n  client: Link | ((context: Context) => Link | Promise<Link>),\n) {\n  function tool<Schema extends z.ZodType, Output>(\n    description: string,\n    inputSchema: Schema,\n    execute: (link: Link, input: Defined<z.output<Schema>>) => Promise<Output>,\n  ) {\n    return {\n      description,\n      inputSchema,\n      async execute(input: z.input<Schema>, context: Context): Promise<Output> {\n        const params = defined(inputSchema.parse(input));\n        const link =\n          typeof client === 'function' ? await client(context) : client;\n        return execute(link, params);\n      },\n    };\n  }\n\n  return {\n    retrieve_user_info: tool(\n      'Retrieve the connected Link user profile, wallet limits, and verification requirements.',\n      schemas.empty,\n      (link) => link.userInfo.retrieve(),\n    ),\n    list_payment_methods: tool(\n      'List saved Link payment methods and identify the default method.',\n      schemas.empty,\n      (link) => link.paymentMethods.list(),\n    ),\n    list_shipping_addresses: tool(\n      'List the connected Link user’s saved shipping addresses.',\n      schemas.empty,\n      (link) => link.shippingAddresses.list(),\n    ),\n    list_spend_requests: tool(\n      'List Link spend requests and their current statuses.',\n      schemas.listSpendRequests,\n      (link, input) =>\n        link.spendRequests.list(\n          input.include_history === undefined\n            ? {}\n            : { includeHistory: input.include_history },\n        ),\n    ),\n    create_spend_request: tool(\n      'Create a Link spend request for a purchase. Show approval_url to the user; creating a request does not establish approval. Retrieve the same request after approval or required actions.',\n      schemas.createSpendRequest,\n      (link, input) => link.spendRequests.create(input),\n    ),\n    retrieve_spend_request: tool(\n      'Retrieve a Link spend request, its approval status, and requested credentials. Follow status_details.requires_action instructions; never assume approval from an earlier status.',\n      schemas.retrieveSpendRequest,\n      (link, { id, ...options }) => link.spendRequests.retrieve(id, options),\n    ),\n    update_spend_request: tool(\n      'Update an existing Link spend request. Check the returned approval status before using credentials.',\n      schemas.updateSpendRequest,\n      (link, { id, ...params }) => link.spendRequests.update(id, params),\n    ),\n    request_spend_approval: tool(\n      'Request human approval for a Link spend request. Show the returned approval URL to the user.',\n      schemas.spendRequestId,\n      (link, { id }) => link.spendRequests.requestApproval(id),\n    ),\n    cancel_spend_request: tool(\n      'Cancel a Link spend request.',\n      schemas.spendRequestId,\n      (link, { id }) => link.spendRequests.cancel(id),\n    ),\n    list_transactions: tool(\n      'List Link transactions. Requires the user’s grant to include access to the requested sources.',\n      schemas.listTransactions,\n      (link, input) => link.transactions.list(input),\n    ),\n    list_sources: tool(\n      'List connected financial sources available to the Link grant.',\n      schemas.listSources,\n      (link, input) => link.sources.list(input),\n    ),\n    list_balances: tool(\n      'List balances for financial sources available to the Link grant.',\n      schemas.listBalances,\n      (link, input) => link.balances.list(input),\n    ),\n    create_report: tool(\n      'Report the outcome of a purchase attempt associated with a Link spend request.',\n      schemas.createReport,\n      (link, input) => link.reports.create(input),\n    ),\n  };\n}\n\nexport type LinkTools<Context = unknown> = ReturnType<\n  typeof createLinkTools<Context>\n>;\nexport type LinkToolName = keyof LinkTools;\n"],"mappings":"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","names":["id"]}