letagentpay 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LetAgentPay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,208 @@
+# letagentpay
+
+TypeScript SDK for [LetAgentPay](https://letagentpay.com) — AI agent spending policy middleware. Set budgets, define spending policies, and control AI agent purchases.
+
+**Zero dependencies.** Uses the built-in `fetch` API (Node.js 18+, Bun, Deno).
+
+## Installation
+
+```bash
+npm install letagentpay
+```
+
+## Quick Start
+
+```typescript
+import { LetAgentPay } from "letagentpay";
+
+const client = new LetAgentPay({ token: "agt_xxx" });
+
+// Create a purchase request
+const result = await client.requestPurchase({
+  amount: 15.0,
+  category: "api_calls",
+  description: "OpenAI GPT-4 call",
+});
+console.log(result.status); // "auto_approved" | "pending" | "rejected"
+
+// Check budget
+const budget = await client.checkBudget();
+console.log(`Remaining: $${budget.remaining}`);
+```
+
+## API
+
+### `requestPurchase(options)`
+
+Create a purchase request. The policy engine runs 8 deterministic checks (budget, category, per-request limit, schedule, daily/weekly/monthly limits).
+
+```typescript
+const result = await client.requestPurchase({
+  amount: 25.0,
+  category: "software",
+  merchantName: "GitHub",         // optional
+  description: "Copilot license", // optional
+  agentComment: "Monthly renewal", // optional, shown to reviewers
+});
+
+// result.status: "auto_approved" | "pending" | "rejected"
+// result.requestId: "uuid"
+// result.policyCheck: { passed: true, checks: [...] }
+// result.budgetRemaining: 475.0 (only if auto_approved)
+// result.expiresAt: "2026-..." (only if pending)
+```
+
+### `checkRequest(requestId)`
+
+Check the status of a purchase request.
+
+```typescript
+const status = await client.checkRequest("request-uuid");
+// status.status: "auto_approved" | "pending" | "approved" | "rejected" | "expired"
+```
+
+### `confirmPurchase(requestId, options)`
+
+Confirm a purchase after approval. Use this to report the actual amount spent.
+
+```typescript
+await client.confirmPurchase("request-uuid", {
+  success: true,
+  actualAmount: 24.99,             // optional, if different from requested
+  receiptUrl: "https://example.com/receipt", // optional
+});
+```
+
+### `checkBudget()`
+
+Get current budget breakdown.
+
+```typescript
+const budget = await client.checkBudget();
+// budget.budget: 500.0
+// budget.spent: 125.5
+// budget.held: 25.0   (reserved for pending requests)
+// budget.remaining: 349.5
+// budget.currency: "USD"
+```
+
+### `getPolicy()`
+
+Get the current spending policy.
+
+```typescript
+const policy = await client.getPolicy();
+```
+
+### `listCategories()`
+
+List valid purchase categories.
+
+```typescript
+const categories = await client.listCategories();
+// ["groceries", "hardware", "software", "travel", ...]
+```
+
+### `myRequests(options?)`
+
+List agent's purchase requests with optional filters.
+
+```typescript
+const list = await client.myRequests({ status: "pending", limit: 10 });
+// list.requests: [{ requestId, status, amount, category, ... }]
+// list.total: 42
+```
+
+## guard()
+
+Wrap an async function so it checks spending policy before executing:
+
+```typescript
+import { guard } from "letagentpay";
+
+const callOpenAI = guard(
+  async (prompt: string, cost: number) => {
+    // your OpenAI call here
+    return "response";
+  },
+  { token: "agt_xxx", category: "api_calls" }
+);
+
+// Automatically sends a purchase request for $0.03 before executing
+await callOpenAI("Analyze this document", 0.03);
+```
+
+With a fixed amount:
+
+```typescript
+const sendEmail = guard(
+  async (to: string, body: string) => { /* ... */ },
+  { token: "agt_xxx", category: "email", amount: 0.01 }
+);
+```
+
+## Self-Hosted
+
+Point the SDK to your own LetAgentPay instance:
+
+```typescript
+const client = new LetAgentPay({
+  token: "agt_xxx",
+  baseUrl: "http://localhost:8000/api/v1/agent-api",
+});
+```
+
+## Environment Variables
+
+```bash
+export LETAGENTPAY_TOKEN=agt_xxx
+export LETAGENTPAY_BASE_URL=https://api.letagentpay.com/api/v1/agent-api  # optional
+```
+
+```typescript
+// Token is taken from LETAGENTPAY_TOKEN
+const client = new LetAgentPay();
+```
+
+## Error Handling
+
+```typescript
+import { LetAgentPay, LetAgentPayError } from "letagentpay";
+
+try {
+  await client.requestPurchase({ amount: 100, category: "hardware" });
+} catch (e) {
+  if (e instanceof LetAgentPayError) {
+    console.log(e.status); // 403
+    console.log(e.detail); // "Daily limit exceeded"
+  }
+}
+```
+
+## Security Model
+
+LetAgentPay uses **server-side cooperative enforcement**. When your agent calls `requestPurchase()`, the request is evaluated by the policy engine on the LetAgentPay server. The agent receives only the result (approved/denied/pending) and cannot:
+
+- Modify its own policies (the `agt_` token grants access only to the Agent API)
+- Override policy check results (they come from the server)
+- Approve its own pending requests (only a human can do that via the dashboard)
+
+This is a **cooperative model** — it protects against budget overruns, category violations, and scheduling mistakes by well-behaved agents. It does not sandbox a malicious agent that has direct access to payment APIs.
+
+### Best Practices
+
+- **Don't give your agent raw payment credentials** (Stripe keys, credit card numbers). LetAgentPay should be the only spending channel
+- Use `pending` + manual approval for high-value purchases
+- Set per-request limits as an additional barrier
+- Review the audit trail in the dashboard regularly
+
+## Documentation
+
+- [LetAgentPay docs](https://letagentpay.com/developers)
+- [Agent API Reference](https://letagentpay.com/developers)
+- [Python SDK](https://github.com/LetAgentPay/letagentpay-python)
+- [GitHub](https://github.com/LetAgentPay/letagentpay-js)
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,168 @@
+/** Individual policy check result. */
+interface PolicyCheck {
+    rule: string;
+    result: "pass" | "fail";
+    detail: string;
+}
+/** Aggregated policy check result. */
+interface PolicyResult {
+    passed: boolean;
+    checks: PolicyCheck[];
+}
+/** Response from creating a purchase request. */
+interface PurchaseResult {
+    requestId: string;
+    status: "auto_approved" | "pending" | "rejected";
+    currency: string | null;
+    category: string | null;
+    originalCategory: string | null;
+    policyCheck: PolicyResult | null;
+    autoApproved: boolean;
+    budgetRemaining: number | null;
+    expiresAt: string | null;
+}
+/** Response from checking a purchase request status. */
+interface RequestStatus {
+    requestId: string;
+    status: string;
+    amount: number;
+    category: string;
+    createdAt: string;
+    reviewedAt: string | null;
+}
+/** Response from confirming a purchase. */
+interface ConfirmResult {
+    requestId: string;
+    status: "completed" | "failed";
+    actualAmount: number | null;
+}
+/** Current budget information. */
+interface BudgetInfo {
+    budget: number;
+    spent: number;
+    held: number;
+    remaining: number;
+    currency: string | null;
+}
+/** Purchase request in a list response. */
+interface PurchaseRequestInfo {
+    requestId: string;
+    status: string;
+    amount: number;
+    currency: string;
+    category: string;
+    merchant: string | null;
+    description: string | null;
+    createdAt: string | null;
+    reviewedAt: string | null;
+    expiresAt: string | null;
+}
+/** Paginated list of purchase requests. */
+interface RequestList {
+    requests: PurchaseRequestInfo[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/** Options for creating a purchase request. */
+interface PurchaseOptions {
+    amount: number;
+    category: string;
+    merchantName?: string;
+    description?: string;
+    agentComment?: string;
+}
+/** Options for confirming a purchase. */
+interface ConfirmOptions {
+    success: boolean;
+    actualAmount?: number;
+    receiptUrl?: string;
+}
+/** Options for listing requests. */
+interface ListRequestsOptions {
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Client configuration. */
+interface LetAgentPayConfig {
+    token?: string;
+    baseUrl?: string;
+}
+
+/**
+ * Client for the LetAgentPay Agent API.
+ *
+ * @example
+ * ```ts
+ * const client = new LetAgentPay({ token: "agt_..." });
+ * const result = await client.requestPurchase({
+ *   amount: 25.00,
+ *   category: "groceries",
+ *   description: "Weekly supplies",
+ * });
+ * console.log(result.status); // "auto_approved" | "pending" | "rejected"
+ * ```
+ */
+declare class LetAgentPay {
+    private readonly token;
+    private readonly baseUrl;
+    constructor(config?: LetAgentPayConfig);
+    private request;
+    /** Create a purchase request. */
+    requestPurchase(options: PurchaseOptions): Promise<PurchaseResult>;
+    /** Check the status of a purchase request. */
+    checkRequest(requestId: string): Promise<RequestStatus>;
+    /** Confirm a purchase result after approval. */
+    confirmPurchase(requestId: string, options: ConfirmOptions): Promise<ConfirmResult>;
+    /** Get current budget, spent, and remaining. */
+    checkBudget(): Promise<BudgetInfo>;
+    /** Get the current spending policy. */
+    getPolicy(): Promise<Record<string, unknown>>;
+    /** List valid purchase categories. */
+    listCategories(): Promise<string[]>;
+    /** List agent's purchase requests. */
+    myRequests(options?: ListRequestsOptions): Promise<RequestList>;
+}
+
+/** Error returned by the LetAgentPay API. */
+declare class LetAgentPayError extends Error {
+    readonly status: number;
+    readonly detail: string;
+    constructor(status: number, detail: string);
+}
+
+/** Options for the guard wrapper. */
+interface GuardOptions extends LetAgentPayConfig {
+    /** Existing client instance. Takes priority over token/baseUrl. */
+    client?: LetAgentPay;
+    /** Purchase category for the request. */
+    category?: string;
+    /** Fixed amount per call. If not set, must be passed to the guarded function. */
+    amount?: number;
+    /** Purchase description. */
+    description?: string;
+    /** Optional comment explaining the purchase. */
+    agentComment?: string;
+}
+/**
+ * Wrap an async function so it checks spending policy before executing.
+ *
+ * @example
+ * ```ts
+ * const guardedBuy = guard(
+ *   async (item: string, amount: number) => {
+ *     return `Bought ${item} for $${amount}`;
+ *   },
+ *   { token: "agt_...", category: "groceries" }
+ * );
+ *
+ * // amount is extracted from the last numeric argument
+ * await guardedBuy("apples", 9.99);
+ * ```
+ */
+declare function guard<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn | Promise<TReturn>, options: GuardOptions & {
+    amount?: number;
+}): (...args: TArgs) => Promise<TReturn>;
+
+export { type BudgetInfo, type ConfirmOptions, type ConfirmResult, type GuardOptions, LetAgentPay, type LetAgentPayConfig, LetAgentPayError, type ListRequestsOptions, type PolicyCheck, type PolicyResult, type PurchaseOptions, type PurchaseRequestInfo, type PurchaseResult, type RequestList, type RequestStatus, guard };

package/dist/index.d.ts

@@ -0,0 +1,168 @@
+/** Individual policy check result. */
+interface PolicyCheck {
+    rule: string;
+    result: "pass" | "fail";
+    detail: string;
+}
+/** Aggregated policy check result. */
+interface PolicyResult {
+    passed: boolean;
+    checks: PolicyCheck[];
+}
+/** Response from creating a purchase request. */
+interface PurchaseResult {
+    requestId: string;
+    status: "auto_approved" | "pending" | "rejected";
+    currency: string | null;
+    category: string | null;
+    originalCategory: string | null;
+    policyCheck: PolicyResult | null;
+    autoApproved: boolean;
+    budgetRemaining: number | null;
+    expiresAt: string | null;
+}
+/** Response from checking a purchase request status. */
+interface RequestStatus {
+    requestId: string;
+    status: string;
+    amount: number;
+    category: string;
+    createdAt: string;
+    reviewedAt: string | null;
+}
+/** Response from confirming a purchase. */
+interface ConfirmResult {
+    requestId: string;
+    status: "completed" | "failed";
+    actualAmount: number | null;
+}
+/** Current budget information. */
+interface BudgetInfo {
+    budget: number;
+    spent: number;
+    held: number;
+    remaining: number;
+    currency: string | null;
+}
+/** Purchase request in a list response. */
+interface PurchaseRequestInfo {
+    requestId: string;
+    status: string;
+    amount: number;
+    currency: string;
+    category: string;
+    merchant: string | null;
+    description: string | null;
+    createdAt: string | null;
+    reviewedAt: string | null;
+    expiresAt: string | null;
+}
+/** Paginated list of purchase requests. */
+interface RequestList {
+    requests: PurchaseRequestInfo[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/** Options for creating a purchase request. */
+interface PurchaseOptions {
+    amount: number;
+    category: string;
+    merchantName?: string;
+    description?: string;
+    agentComment?: string;
+}
+/** Options for confirming a purchase. */
+interface ConfirmOptions {
+    success: boolean;
+    actualAmount?: number;
+    receiptUrl?: string;
+}
+/** Options for listing requests. */
+interface ListRequestsOptions {
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Client configuration. */
+interface LetAgentPayConfig {
+    token?: string;
+    baseUrl?: string;
+}
+
+/**
+ * Client for the LetAgentPay Agent API.
+ *
+ * @example
+ * ```ts
+ * const client = new LetAgentPay({ token: "agt_..." });
+ * const result = await client.requestPurchase({
+ *   amount: 25.00,
+ *   category: "groceries",
+ *   description: "Weekly supplies",
+ * });
+ * console.log(result.status); // "auto_approved" | "pending" | "rejected"
+ * ```
+ */
+declare class LetAgentPay {
+    private readonly token;
+    private readonly baseUrl;
+    constructor(config?: LetAgentPayConfig);
+    private request;
+    /** Create a purchase request. */
+    requestPurchase(options: PurchaseOptions): Promise<PurchaseResult>;
+    /** Check the status of a purchase request. */
+    checkRequest(requestId: string): Promise<RequestStatus>;
+    /** Confirm a purchase result after approval. */
+    confirmPurchase(requestId: string, options: ConfirmOptions): Promise<ConfirmResult>;
+    /** Get current budget, spent, and remaining. */
+    checkBudget(): Promise<BudgetInfo>;
+    /** Get the current spending policy. */
+    getPolicy(): Promise<Record<string, unknown>>;
+    /** List valid purchase categories. */
+    listCategories(): Promise<string[]>;
+    /** List agent's purchase requests. */
+    myRequests(options?: ListRequestsOptions): Promise<RequestList>;
+}
+
+/** Error returned by the LetAgentPay API. */
+declare class LetAgentPayError extends Error {
+    readonly status: number;
+    readonly detail: string;
+    constructor(status: number, detail: string);
+}
+
+/** Options for the guard wrapper. */
+interface GuardOptions extends LetAgentPayConfig {
+    /** Existing client instance. Takes priority over token/baseUrl. */
+    client?: LetAgentPay;
+    /** Purchase category for the request. */
+    category?: string;
+    /** Fixed amount per call. If not set, must be passed to the guarded function. */
+    amount?: number;
+    /** Purchase description. */
+    description?: string;
+    /** Optional comment explaining the purchase. */
+    agentComment?: string;
+}
+/**
+ * Wrap an async function so it checks spending policy before executing.
+ *
+ * @example
+ * ```ts
+ * const guardedBuy = guard(
+ *   async (item: string, amount: number) => {
+ *     return `Bought ${item} for $${amount}`;
+ *   },
+ *   { token: "agt_...", category: "groceries" }
+ * );
+ *
+ * // amount is extracted from the last numeric argument
+ * await guardedBuy("apples", 9.99);
+ * ```
+ */
+declare function guard<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn | Promise<TReturn>, options: GuardOptions & {
+    amount?: number;
+}): (...args: TArgs) => Promise<TReturn>;
+
+export { type BudgetInfo, type ConfirmOptions, type ConfirmResult, type GuardOptions, LetAgentPay, type LetAgentPayConfig, LetAgentPayError, type ListRequestsOptions, type PolicyCheck, type PolicyResult, type PurchaseOptions, type PurchaseRequestInfo, type PurchaseResult, type RequestList, type RequestStatus, guard };

package/dist/index.js

@@ -0,0 +1,259 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  LetAgentPay: () => LetAgentPay,
+  LetAgentPayError: () => LetAgentPayError,
+  guard: () => guard
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var LetAgentPayError = class extends Error {
+  status;
+  detail;
+  constructor(status, detail) {
+    super(`[${status}] ${detail}`);
+    this.name = "LetAgentPayError";
+    this.status = status;
+    this.detail = detail;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.letagentpay.com/api/v1/agent-api";
+function getEnv(name) {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env[name];
+  }
+  return void 0;
+}
+function parsePolicyCheck(data) {
+  return {
+    rule: data.rule,
+    result: data.result,
+    detail: data.detail
+  };
+}
+function parsePolicyResult(data) {
+  if (!data) return null;
+  const checks = data.checks || [];
+  return {
+    passed: data.passed,
+    checks: checks.map(parsePolicyCheck)
+  };
+}
+function parsePurchaseResult(data) {
+  return {
+    requestId: data.request_id,
+    status: data.status,
+    currency: data.currency ?? null,
+    category: data.category ?? null,
+    originalCategory: data.original_category ?? null,
+    policyCheck: parsePolicyResult(
+      data.policy_check ?? null
+    ),
+    autoApproved: data.auto_approved ?? false,
+    budgetRemaining: data.budget_remaining != null ? Number(data.budget_remaining) : null,
+    expiresAt: data.expires_at ?? null
+  };
+}
+function parseRequestStatus(data) {
+  return {
+    requestId: data.request_id,
+    status: data.status,
+    amount: Number(data.amount),
+    category: data.category,
+    createdAt: String(data.created_at),
+    reviewedAt: data.reviewed_at ? String(data.reviewed_at) : null
+  };
+}
+function parseConfirmResult(data) {
+  return {
+    requestId: data.request_id,
+    status: data.status,
+    actualAmount: data.actual_amount != null ? Number(data.actual_amount) : null
+  };
+}
+function parseBudgetInfo(data) {
+  return {
+    budget: Number(data.budget),
+    spent: Number(data.spent),
+    held: Number(data.held),
+    remaining: Number(data.remaining),
+    currency: data.currency ?? null
+  };
+}
+function parsePurchaseRequestInfo(data) {
+  return {
+    requestId: data.request_id,
+    status: data.status,
+    amount: Number(data.amount),
+    currency: data.currency ?? "USD",
+    category: data.category ?? "",
+    merchant: data.merchant ?? null,
+    description: data.description ?? null,
+    createdAt: data.created_at ? String(data.created_at) : null,
+    reviewedAt: data.reviewed_at ? String(data.reviewed_at) : null,
+    expiresAt: data.expires_at ? String(data.expires_at) : null
+  };
+}
+function parseRequestList(data) {
+  const requests = data.requests || [];
+  return {
+    requests: requests.map(parsePurchaseRequestInfo),
+    total: data.total ?? 0,
+    limit: data.limit ?? 20,
+    offset: data.offset ?? 0
+  };
+}
+var LetAgentPay = class {
+  token;
+  baseUrl;
+  constructor(config = {}) {
+    const resolvedToken = config.token ?? getEnv("LETAGENTPAY_TOKEN");
+    if (!resolvedToken) {
+      throw new Error(
+        "Token is required. Pass token in config or set LETAGENTPAY_TOKEN env var."
+      );
+    }
+    this.token = resolvedToken;
+    this.baseUrl = (config.baseUrl ?? getEnv("LETAGENTPAY_BASE_URL") ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  }
+  async request(method, path, options) {
+    let url = `${this.baseUrl}${path}`;
+    if (options?.params) {
+      const searchParams = new URLSearchParams(options.params);
+      url += `?${searchParams.toString()}`;
+    }
+    const response = await fetch(url, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.token}`,
+        "Content-Type": "application/json"
+      },
+      body: options?.body ? JSON.stringify(options.body) : void 0
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const detail = data.detail ?? response.statusText;
+      throw new LetAgentPayError(response.status, detail);
+    }
+    return data;
+  }
+  /** Create a purchase request. */
+  async requestPurchase(options) {
+    const body = {
+      amount: options.amount,
+      category: options.category
+    };
+    if (options.merchantName) body.merchant_name = options.merchantName;
+    if (options.description) body.description = options.description;
+    if (options.agentComment) body.agent_comment = options.agentComment;
+    const data = await this.request("POST", "/requests", { body });
+    return parsePurchaseResult(data);
+  }
+  /** Check the status of a purchase request. */
+  async checkRequest(requestId) {
+    const data = await this.request("GET", `/requests/${requestId}`);
+    return parseRequestStatus(data);
+  }
+  /** Confirm a purchase result after approval. */
+  async confirmPurchase(requestId, options) {
+    const body = { success: options.success };
+    if (options.actualAmount != null) body.actual_amount = options.actualAmount;
+    if (options.receiptUrl) body.receipt_url = options.receiptUrl;
+    const data = await this.request("POST", `/requests/${requestId}/confirm`, {
+      body
+    });
+    return parseConfirmResult(data);
+  }
+  /** Get current budget, spent, and remaining. */
+  async checkBudget() {
+    const data = await this.request("GET", "/budget");
+    return parseBudgetInfo(data);
+  }
+  /** Get the current spending policy. */
+  async getPolicy() {
+    return this.request("GET", "/policy");
+  }
+  /** List valid purchase categories. */
+  async listCategories() {
+    const data = await this.request("GET", "/categories");
+    return data.categories;
+  }
+  /** List agent's purchase requests. */
+  async myRequests(options = {}) {
+    const params = {};
+    if (options.status) params.status = options.status;
+    params.limit = String(options.limit ?? 20);
+    params.offset = String(options.offset ?? 0);
+    const data = await this.request("GET", "/requests", { params });
+    return parseRequestList(data);
+  }
+};
+
+// src/guard.ts
+function guard(fn, options) {
+  return async (...args) => {
+    let resolvedAmount = options.amount;
+    if (resolvedAmount == null) {
+      for (const arg of args) {
+        if (typeof arg === "number") {
+          resolvedAmount = arg;
+          break;
+        }
+      }
+    }
+    if (resolvedAmount == null) {
+      throw new Error(
+        "guard: could not determine amount from arguments. Pass amount in guard options or as a numeric function argument."
+      );
+    }
+    const client = options.client ?? new LetAgentPay(options);
+    const result = await client.requestPurchase({
+      amount: resolvedAmount,
+      category: options.category ?? "other",
+      description: options.description ?? `Auto-guarded call to ${fn.name || "anonymous"}`,
+      agentComment: options.agentComment
+    });
+    if (result.status === "auto_approved" || result.status === "pending") {
+      if (result.status === "pending") {
+        throw new LetAgentPayError(
+          403,
+          `Purchase request pending approval: ${result.requestId}`
+        );
+      }
+      return fn(...args);
+    }
+    throw new LetAgentPayError(
+      403,
+      `Purchase request ${result.status}: ${result.requestId}`
+    );
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LetAgentPay,
+  LetAgentPayError,
+  guard
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts","../src/guard.ts"],"sourcesContent":["export { LetAgentPay } from \"./client.js\";\nexport { LetAgentPayError } from \"./errors.js\";\nexport { guard } from \"./guard.js\";\nexport type { GuardOptions } from \"./guard.js\";\nexport type {\n  BudgetInfo,\n  ConfirmOptions,\n  ConfirmResult,\n  LetAgentPayConfig,\n  ListRequestsOptions,\n  PolicyCheck,\n  PolicyResult,\n  PurchaseOptions,\n  PurchaseRequestInfo,\n  PurchaseResult,\n  RequestList,\n  RequestStatus,\n} from \"./types.js\";\n","/** Error returned by the LetAgentPay API. */\nexport class LetAgentPayError extends Error {\n  readonly status: number;\n  readonly detail: string;\n\n  constructor(status: number, detail: string) {\n    super(`[${status}] ${detail}`);\n    this.name = \"LetAgentPayError\";\n    this.status = status;\n    this.detail = detail;\n  }\n}\n","import { LetAgentPayError } from \"./errors.js\";\nimport type {\n  BudgetInfo,\n  ConfirmOptions,\n  ConfirmResult,\n  LetAgentPayConfig,\n  ListRequestsOptions,\n  PolicyCheck,\n  PolicyResult,\n  PurchaseOptions,\n  PurchaseRequestInfo,\n  PurchaseResult,\n  RequestList,\n  RequestStatus,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.letagentpay.com/api/v1/agent-api\";\n\nfunction getEnv(name: string): string | undefined {\n  if (typeof process !== \"undefined\" && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n\nfunction parsePolicyCheck(data: Record<string, unknown>): PolicyCheck {\n  return {\n    rule: data.rule as string,\n    result: data.result as \"pass\" | \"fail\",\n    detail: data.detail as string,\n  };\n}\n\nfunction parsePolicyResult(\n  data: Record<string, unknown> | null,\n): PolicyResult | null {\n  if (!data) return null;\n  const checks = (data.checks as Record<string, unknown>[]) || [];\n  return {\n    passed: data.passed as boolean,\n    checks: checks.map(parsePolicyCheck),\n  };\n}\n\nfunction parsePurchaseResult(data: Record<string, unknown>): PurchaseResult {\n  return {\n    requestId: data.request_id as string,\n    status: data.status as PurchaseResult[\"status\"],\n    currency: (data.currency as string) ?? null,\n    category: (data.category as string) ?? null,\n    originalCategory: (data.original_category as string) ?? null,\n    policyCheck: parsePolicyResult(\n      (data.policy_check as Record<string, unknown>) ?? null,\n    ),\n    autoApproved: (data.auto_approved as boolean) ?? false,\n    budgetRemaining:\n      data.budget_remaining != null ? Number(data.budget_remaining) : null,\n    expiresAt: (data.expires_at as string) ?? null,\n  };\n}\n\nfunction parseRequestStatus(data: Record<string, unknown>): RequestStatus {\n  return {\n    requestId: data.request_id as string,\n    status: data.status as string,\n    amount: Number(data.amount),\n    category: data.category as string,\n    createdAt: String(data.created_at),\n    reviewedAt: data.reviewed_at ? String(data.reviewed_at) : null,\n  };\n}\n\nfunction parseConfirmResult(data: Record<string, unknown>): ConfirmResult {\n  return {\n    requestId: data.request_id as string,\n    status: data.status as ConfirmResult[\"status\"],\n    actualAmount:\n      data.actual_amount != null ? Number(data.actual_amount) : null,\n  };\n}\n\nfunction parseBudgetInfo(data: Record<string, unknown>): BudgetInfo {\n  return {\n    budget: Number(data.budget),\n    spent: Number(data.spent),\n    held: Number(data.held),\n    remaining: Number(data.remaining),\n    currency: (data.currency as string) ?? null,\n  };\n}\n\nfunction parsePurchaseRequestInfo(\n  data: Record<string, unknown>,\n): PurchaseRequestInfo {\n  return {\n    requestId: data.request_id as string,\n    status: data.status as string,\n    amount: Number(data.amount),\n    currency: (data.currency as string) ?? \"USD\",\n    category: (data.category as string) ?? \"\",\n    merchant: (data.merchant as string) ?? null,\n    description: (data.description as string) ?? null,\n    createdAt: data.created_at ? String(data.created_at) : null,\n    reviewedAt: data.reviewed_at ? String(data.reviewed_at) : null,\n    expiresAt: data.expires_at ? String(data.expires_at) : null,\n  };\n}\n\nfunction parseRequestList(data: Record<string, unknown>): RequestList {\n  const requests = (data.requests as Record<string, unknown>[]) || [];\n  return {\n    requests: requests.map(parsePurchaseRequestInfo),\n    total: (data.total as number) ?? 0,\n    limit: (data.limit as number) ?? 20,\n    offset: (data.offset as number) ?? 0,\n  };\n}\n\n/**\n * Client for the LetAgentPay Agent API.\n *\n * @example\n * ```ts\n * const client = new LetAgentPay({ token: \"agt_...\" });\n * const result = await client.requestPurchase({\n *   amount: 25.00,\n *   category: \"groceries\",\n *   description: \"Weekly supplies\",\n * });\n * console.log(result.status); // \"auto_approved\" | \"pending\" | \"rejected\"\n * ```\n */\nexport class LetAgentPay {\n  private readonly token: string;\n  private readonly baseUrl: string;\n\n  constructor(config: LetAgentPayConfig = {}) {\n    const resolvedToken = config.token ?? getEnv(\"LETAGENTPAY_TOKEN\");\n    if (!resolvedToken) {\n      throw new Error(\n        \"Token is required. Pass token in config or set LETAGENTPAY_TOKEN env var.\",\n      );\n    }\n\n    this.token = resolvedToken;\n    this.baseUrl = (\n      config.baseUrl ??\n      getEnv(\"LETAGENTPAY_BASE_URL\") ??\n      DEFAULT_BASE_URL\n    ).replace(/\\/+$/, \"\");\n  }\n\n  private async request(\n    method: string,\n    path: string,\n    options?: { body?: unknown; params?: Record<string, string> },\n  ): Promise<Record<string, unknown>> {\n    let url = `${this.baseUrl}${path}`;\n\n    if (options?.params) {\n      const searchParams = new URLSearchParams(options.params);\n      url += `?${searchParams.toString()}`;\n    }\n\n    const response = await fetch(url, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.token}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: options?.body ? JSON.stringify(options.body) : undefined,\n    });\n\n    const data = (await response.json()) as Record<string, unknown>;\n\n    if (!response.ok) {\n      const detail = (data.detail as string) ?? response.statusText;\n      throw new LetAgentPayError(response.status, detail);\n    }\n\n    return data;\n  }\n\n  /** Create a purchase request. */\n  async requestPurchase(options: PurchaseOptions): Promise<PurchaseResult> {\n    const body: Record<string, unknown> = {\n      amount: options.amount,\n      category: options.category,\n    };\n    if (options.merchantName) body.merchant_name = options.merchantName;\n    if (options.description) body.description = options.description;\n    if (options.agentComment) body.agent_comment = options.agentComment;\n\n    const data = await this.request(\"POST\", \"/requests\", { body });\n    return parsePurchaseResult(data);\n  }\n\n  /** Check the status of a purchase request. */\n  async checkRequest(requestId: string): Promise<RequestStatus> {\n    const data = await this.request(\"GET\", `/requests/${requestId}`);\n    return parseRequestStatus(data);\n  }\n\n  /** Confirm a purchase result after approval. */\n  async confirmPurchase(\n    requestId: string,\n    options: ConfirmOptions,\n  ): Promise<ConfirmResult> {\n    const body: Record<string, unknown> = { success: options.success };\n    if (options.actualAmount != null) body.actual_amount = options.actualAmount;\n    if (options.receiptUrl) body.receipt_url = options.receiptUrl;\n\n    const data = await this.request(\"POST\", `/requests/${requestId}/confirm`, {\n      body,\n    });\n    return parseConfirmResult(data);\n  }\n\n  /** Get current budget, spent, and remaining. */\n  async checkBudget(): Promise<BudgetInfo> {\n    const data = await this.request(\"GET\", \"/budget\");\n    return parseBudgetInfo(data);\n  }\n\n  /** Get the current spending policy. */\n  async getPolicy(): Promise<Record<string, unknown>> {\n    return this.request(\"GET\", \"/policy\");\n  }\n\n  /** List valid purchase categories. */\n  async listCategories(): Promise<string[]> {\n    const data = await this.request(\"GET\", \"/categories\");\n    return data.categories as string[];\n  }\n\n  /** List agent's purchase requests. */\n  async myRequests(options: ListRequestsOptions = {}): Promise<RequestList> {\n    const params: Record<string, string> = {};\n    if (options.status) params.status = options.status;\n    params.limit = String(options.limit ?? 20);\n    params.offset = String(options.offset ?? 0);\n\n    const data = await this.request(\"GET\", \"/requests\", { params });\n    return parseRequestList(data);\n  }\n}\n","import { LetAgentPay } from \"./client.js\";\nimport { LetAgentPayError } from \"./errors.js\";\nimport type { LetAgentPayConfig } from \"./types.js\";\n\n/** Options for the guard wrapper. */\nexport interface GuardOptions extends LetAgentPayConfig {\n  /** Existing client instance. Takes priority over token/baseUrl. */\n  client?: LetAgentPay;\n  /** Purchase category for the request. */\n  category?: string;\n  /** Fixed amount per call. If not set, must be passed to the guarded function. */\n  amount?: number;\n  /** Purchase description. */\n  description?: string;\n  /** Optional comment explaining the purchase. */\n  agentComment?: string;\n}\n\n/**\n * Wrap an async function so it checks spending policy before executing.\n *\n * @example\n * ```ts\n * const guardedBuy = guard(\n *   async (item: string, amount: number) => {\n *     return `Bought ${item} for $${amount}`;\n *   },\n *   { token: \"agt_...\", category: \"groceries\" }\n * );\n *\n * // amount is extracted from the last numeric argument\n * await guardedBuy(\"apples\", 9.99);\n * ```\n */\nexport function guard<TArgs extends unknown[], TReturn>(\n  fn: (...args: TArgs) => TReturn | Promise<TReturn>,\n  options: GuardOptions & { amount?: number },\n): (...args: TArgs) => Promise<TReturn> {\n  return async (...args: TArgs): Promise<TReturn> => {\n    let resolvedAmount = options.amount;\n    if (resolvedAmount == null) {\n      // Try to find a numeric argument (first one)\n      for (const arg of args) {\n        if (typeof arg === \"number\") {\n          resolvedAmount = arg;\n          break;\n        }\n      }\n    }\n\n    if (resolvedAmount == null) {\n      throw new Error(\n        \"guard: could not determine amount from arguments. \" +\n          \"Pass amount in guard options or as a numeric function argument.\",\n      );\n    }\n\n    const client = options.client ?? new LetAgentPay(options);\n\n    const result = await client.requestPurchase({\n      amount: resolvedAmount,\n      category: options.category ?? \"other\",\n      description:\n        options.description ?? `Auto-guarded call to ${fn.name || \"anonymous\"}`,\n      agentComment: options.agentComment,\n    });\n\n    if (result.status === \"auto_approved\" || result.status === \"pending\") {\n      if (result.status === \"pending\") {\n        throw new LetAgentPayError(\n          403,\n          `Purchase request pending approval: ${result.requestId}`,\n        );\n      }\n      return fn(...args);\n    }\n\n    throw new LetAgentPayError(\n      403,\n      `Purchase request ${result.status}: ${result.requestId}`,\n    );\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,230 @@
+// src/errors.ts
+var LetAgentPayError = class extends Error {
+  status;
+  detail;
+  constructor(status, detail) {
+    super(`[${status}] ${detail}`);
+    this.name = "LetAgentPayError";
+    this.status = status;
+    this.detail = detail;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.letagentpay.com/api/v1/agent-api";
+function getEnv(name) {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env[name];
+  }
+  return void 0;
+}
+function parsePolicyCheck(data) {
+  return {
+    rule: data.rule,
+    result: data.result,
+    detail: data.detail
+  };
+}
+function parsePolicyResult(data) {
+  if (!data) return null;
+  const checks = data.checks || [];
+  return {
+    passed: data.passed,
+    checks: checks.map(parsePolicyCheck)
+  };
+}
+function parsePurchaseResult(data) {
+  return {
+    requestId: data.request_id,
+    status: data.status,
+    currency: data.currency ?? null,
+    category: data.category ?? null,
+    originalCategory: data.original_category ?? null,
+    policyCheck: parsePolicyResult(
+      data.policy_check ?? null
+    ),
+    autoApproved: data.auto_approved ?? false,
+    budgetRemaining: data.budget_remaining != null ? Number(data.budget_remaining) : null,
+    expiresAt: data.expires_at ?? null
+  };
+}
+function parseRequestStatus(data) {
+  return {
+    requestId: data.request_id,
+    status: data.status,
+    amount: Number(data.amount),
+    category: data.category,
+    createdAt: String(data.created_at),
+    reviewedAt: data.reviewed_at ? String(data.reviewed_at) : null
+  };
+}
+function parseConfirmResult(data) {
+  return {
+    requestId: data.request_id,
+    status: data.status,
+    actualAmount: data.actual_amount != null ? Number(data.actual_amount) : null
+  };
+}
+function parseBudgetInfo(data) {
+  return {
+    budget: Number(data.budget),
+    spent: Number(data.spent),
+    held: Number(data.held),
+    remaining: Number(data.remaining),
+    currency: data.currency ?? null
+  };
+}
+function parsePurchaseRequestInfo(data) {
+  return {
+    requestId: data.request_id,
+    status: data.status,
+    amount: Number(data.amount),
+    currency: data.currency ?? "USD",
+    category: data.category ?? "",
+    merchant: data.merchant ?? null,
+    description: data.description ?? null,
+    createdAt: data.created_at ? String(data.created_at) : null,
+    reviewedAt: data.reviewed_at ? String(data.reviewed_at) : null,
+    expiresAt: data.expires_at ? String(data.expires_at) : null
+  };
+}
+function parseRequestList(data) {
+  const requests = data.requests || [];
+  return {
+    requests: requests.map(parsePurchaseRequestInfo),
+    total: data.total ?? 0,
+    limit: data.limit ?? 20,
+    offset: data.offset ?? 0
+  };
+}
+var LetAgentPay = class {
+  token;
+  baseUrl;
+  constructor(config = {}) {
+    const resolvedToken = config.token ?? getEnv("LETAGENTPAY_TOKEN");
+    if (!resolvedToken) {
+      throw new Error(
+        "Token is required. Pass token in config or set LETAGENTPAY_TOKEN env var."
+      );
+    }
+    this.token = resolvedToken;
+    this.baseUrl = (config.baseUrl ?? getEnv("LETAGENTPAY_BASE_URL") ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  }
+  async request(method, path, options) {
+    let url = `${this.baseUrl}${path}`;
+    if (options?.params) {
+      const searchParams = new URLSearchParams(options.params);
+      url += `?${searchParams.toString()}`;
+    }
+    const response = await fetch(url, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.token}`,
+        "Content-Type": "application/json"
+      },
+      body: options?.body ? JSON.stringify(options.body) : void 0
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const detail = data.detail ?? response.statusText;
+      throw new LetAgentPayError(response.status, detail);
+    }
+    return data;
+  }
+  /** Create a purchase request. */
+  async requestPurchase(options) {
+    const body = {
+      amount: options.amount,
+      category: options.category
+    };
+    if (options.merchantName) body.merchant_name = options.merchantName;
+    if (options.description) body.description = options.description;
+    if (options.agentComment) body.agent_comment = options.agentComment;
+    const data = await this.request("POST", "/requests", { body });
+    return parsePurchaseResult(data);
+  }
+  /** Check the status of a purchase request. */
+  async checkRequest(requestId) {
+    const data = await this.request("GET", `/requests/${requestId}`);
+    return parseRequestStatus(data);
+  }
+  /** Confirm a purchase result after approval. */
+  async confirmPurchase(requestId, options) {
+    const body = { success: options.success };
+    if (options.actualAmount != null) body.actual_amount = options.actualAmount;
+    if (options.receiptUrl) body.receipt_url = options.receiptUrl;
+    const data = await this.request("POST", `/requests/${requestId}/confirm`, {
+      body
+    });
+    return parseConfirmResult(data);
+  }
+  /** Get current budget, spent, and remaining. */
+  async checkBudget() {
+    const data = await this.request("GET", "/budget");
+    return parseBudgetInfo(data);
+  }
+  /** Get the current spending policy. */
+  async getPolicy() {
+    return this.request("GET", "/policy");
+  }
+  /** List valid purchase categories. */
+  async listCategories() {
+    const data = await this.request("GET", "/categories");
+    return data.categories;
+  }
+  /** List agent's purchase requests. */
+  async myRequests(options = {}) {
+    const params = {};
+    if (options.status) params.status = options.status;
+    params.limit = String(options.limit ?? 20);
+    params.offset = String(options.offset ?? 0);
+    const data = await this.request("GET", "/requests", { params });
+    return parseRequestList(data);
+  }
+};
+
+// src/guard.ts
+function guard(fn, options) {
+  return async (...args) => {
+    let resolvedAmount = options.amount;
+    if (resolvedAmount == null) {
+      for (const arg of args) {
+        if (typeof arg === "number") {
+          resolvedAmount = arg;
+          break;
+        }
+      }
+    }
+    if (resolvedAmount == null) {
+      throw new Error(
+        "guard: could not determine amount from arguments. Pass amount in guard options or as a numeric function argument."
+      );
+    }
+    const client = options.client ?? new LetAgentPay(options);
+    const result = await client.requestPurchase({
+      amount: resolvedAmount,
+      category: options.category ?? "other",
+      description: options.description ?? `Auto-guarded call to ${fn.name || "anonymous"}`,
+      agentComment: options.agentComment
+    });
+    if (result.status === "auto_approved" || result.status === "pending") {
+      if (result.status === "pending") {
+        throw new LetAgentPayError(
+          403,
+          `Purchase request pending approval: ${result.requestId}`
+        );
+      }
+      return fn(...args);
+    }
+    throw new LetAgentPayError(
+      403,
+      `Purchase request ${result.status}: ${result.requestId}`
+    );
+  };
+}
+export {
+  LetAgentPay,
+  LetAgentPayError,
+  guard
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/guard.ts"],"sourcesContent":["/** Error returned by the LetAgentPay API. */\nexport class LetAgentPayError extends Error {\n  readonly status: number;\n  readonly detail: string;\n\n  constructor(status: number, detail: string) {\n    super(`[${status}] ${detail}`);\n    this.name = \"LetAgentPayError\";\n    this.status = status;\n    this.detail = detail;\n  }\n}\n","import { LetAgentPayError } from \"./errors.js\";\nimport type {\n  BudgetInfo,\n  ConfirmOptions,\n  ConfirmResult,\n  LetAgentPayConfig,\n  ListRequestsOptions,\n  PolicyCheck,\n  PolicyResult,\n  PurchaseOptions,\n  PurchaseRequestInfo,\n  PurchaseResult,\n  RequestList,\n  RequestStatus,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.letagentpay.com/api/v1/agent-api\";\n\nfunction getEnv(name: string): string | undefined {\n  if (typeof process !== \"undefined\" && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n\nfunction parsePolicyCheck(data: Record<string, unknown>): PolicyCheck {\n  return {\n    rule: data.rule as string,\n    result: data.result as \"pass\" | \"fail\",\n    detail: data.detail as string,\n  };\n}\n\nfunction parsePolicyResult(\n  data: Record<string, unknown> | null,\n): PolicyResult | null {\n  if (!data) return null;\n  const checks = (data.checks as Record<string, unknown>[]) || [];\n  return {\n    passed: data.passed as boolean,\n    checks: checks.map(parsePolicyCheck),\n  };\n}\n\nfunction parsePurchaseResult(data: Record<string, unknown>): PurchaseResult {\n  return {\n    requestId: data.request_id as string,\n    status: data.status as PurchaseResult[\"status\"],\n    currency: (data.currency as string) ?? null,\n    category: (data.category as string) ?? null,\n    originalCategory: (data.original_category as string) ?? null,\n    policyCheck: parsePolicyResult(\n      (data.policy_check as Record<string, unknown>) ?? null,\n    ),\n    autoApproved: (data.auto_approved as boolean) ?? false,\n    budgetRemaining:\n      data.budget_remaining != null ? Number(data.budget_remaining) : null,\n    expiresAt: (data.expires_at as string) ?? null,\n  };\n}\n\nfunction parseRequestStatus(data: Record<string, unknown>): RequestStatus {\n  return {\n    requestId: data.request_id as string,\n    status: data.status as string,\n    amount: Number(data.amount),\n    category: data.category as string,\n    createdAt: String(data.created_at),\n    reviewedAt: data.reviewed_at ? String(data.reviewed_at) : null,\n  };\n}\n\nfunction parseConfirmResult(data: Record<string, unknown>): ConfirmResult {\n  return {\n    requestId: data.request_id as string,\n    status: data.status as ConfirmResult[\"status\"],\n    actualAmount:\n      data.actual_amount != null ? Number(data.actual_amount) : null,\n  };\n}\n\nfunction parseBudgetInfo(data: Record<string, unknown>): BudgetInfo {\n  return {\n    budget: Number(data.budget),\n    spent: Number(data.spent),\n    held: Number(data.held),\n    remaining: Number(data.remaining),\n    currency: (data.currency as string) ?? null,\n  };\n}\n\nfunction parsePurchaseRequestInfo(\n  data: Record<string, unknown>,\n): PurchaseRequestInfo {\n  return {\n    requestId: data.request_id as string,\n    status: data.status as string,\n    amount: Number(data.amount),\n    currency: (data.currency as string) ?? \"USD\",\n    category: (data.category as string) ?? \"\",\n    merchant: (data.merchant as string) ?? null,\n    description: (data.description as string) ?? null,\n    createdAt: data.created_at ? String(data.created_at) : null,\n    reviewedAt: data.reviewed_at ? String(data.reviewed_at) : null,\n    expiresAt: data.expires_at ? String(data.expires_at) : null,\n  };\n}\n\nfunction parseRequestList(data: Record<string, unknown>): RequestList {\n  const requests = (data.requests as Record<string, unknown>[]) || [];\n  return {\n    requests: requests.map(parsePurchaseRequestInfo),\n    total: (data.total as number) ?? 0,\n    limit: (data.limit as number) ?? 20,\n    offset: (data.offset as number) ?? 0,\n  };\n}\n\n/**\n * Client for the LetAgentPay Agent API.\n *\n * @example\n * ```ts\n * const client = new LetAgentPay({ token: \"agt_...\" });\n * const result = await client.requestPurchase({\n *   amount: 25.00,\n *   category: \"groceries\",\n *   description: \"Weekly supplies\",\n * });\n * console.log(result.status); // \"auto_approved\" | \"pending\" | \"rejected\"\n * ```\n */\nexport class LetAgentPay {\n  private readonly token: string;\n  private readonly baseUrl: string;\n\n  constructor(config: LetAgentPayConfig = {}) {\n    const resolvedToken = config.token ?? getEnv(\"LETAGENTPAY_TOKEN\");\n    if (!resolvedToken) {\n      throw new Error(\n        \"Token is required. Pass token in config or set LETAGENTPAY_TOKEN env var.\",\n      );\n    }\n\n    this.token = resolvedToken;\n    this.baseUrl = (\n      config.baseUrl ??\n      getEnv(\"LETAGENTPAY_BASE_URL\") ??\n      DEFAULT_BASE_URL\n    ).replace(/\\/+$/, \"\");\n  }\n\n  private async request(\n    method: string,\n    path: string,\n    options?: { body?: unknown; params?: Record<string, string> },\n  ): Promise<Record<string, unknown>> {\n    let url = `${this.baseUrl}${path}`;\n\n    if (options?.params) {\n      const searchParams = new URLSearchParams(options.params);\n      url += `?${searchParams.toString()}`;\n    }\n\n    const response = await fetch(url, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.token}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: options?.body ? JSON.stringify(options.body) : undefined,\n    });\n\n    const data = (await response.json()) as Record<string, unknown>;\n\n    if (!response.ok) {\n      const detail = (data.detail as string) ?? response.statusText;\n      throw new LetAgentPayError(response.status, detail);\n    }\n\n    return data;\n  }\n\n  /** Create a purchase request. */\n  async requestPurchase(options: PurchaseOptions): Promise<PurchaseResult> {\n    const body: Record<string, unknown> = {\n      amount: options.amount,\n      category: options.category,\n    };\n    if (options.merchantName) body.merchant_name = options.merchantName;\n    if (options.description) body.description = options.description;\n    if (options.agentComment) body.agent_comment = options.agentComment;\n\n    const data = await this.request(\"POST\", \"/requests\", { body });\n    return parsePurchaseResult(data);\n  }\n\n  /** Check the status of a purchase request. */\n  async checkRequest(requestId: string): Promise<RequestStatus> {\n    const data = await this.request(\"GET\", `/requests/${requestId}`);\n    return parseRequestStatus(data);\n  }\n\n  /** Confirm a purchase result after approval. */\n  async confirmPurchase(\n    requestId: string,\n    options: ConfirmOptions,\n  ): Promise<ConfirmResult> {\n    const body: Record<string, unknown> = { success: options.success };\n    if (options.actualAmount != null) body.actual_amount = options.actualAmount;\n    if (options.receiptUrl) body.receipt_url = options.receiptUrl;\n\n    const data = await this.request(\"POST\", `/requests/${requestId}/confirm`, {\n      body,\n    });\n    return parseConfirmResult(data);\n  }\n\n  /** Get current budget, spent, and remaining. */\n  async checkBudget(): Promise<BudgetInfo> {\n    const data = await this.request(\"GET\", \"/budget\");\n    return parseBudgetInfo(data);\n  }\n\n  /** Get the current spending policy. */\n  async getPolicy(): Promise<Record<string, unknown>> {\n    return this.request(\"GET\", \"/policy\");\n  }\n\n  /** List valid purchase categories. */\n  async listCategories(): Promise<string[]> {\n    const data = await this.request(\"GET\", \"/categories\");\n    return data.categories as string[];\n  }\n\n  /** List agent's purchase requests. */\n  async myRequests(options: ListRequestsOptions = {}): Promise<RequestList> {\n    const params: Record<string, string> = {};\n    if (options.status) params.status = options.status;\n    params.limit = String(options.limit ?? 20);\n    params.offset = String(options.offset ?? 0);\n\n    const data = await this.request(\"GET\", \"/requests\", { params });\n    return parseRequestList(data);\n  }\n}\n","import { LetAgentPay } from \"./client.js\";\nimport { LetAgentPayError } from \"./errors.js\";\nimport type { LetAgentPayConfig } from \"./types.js\";\n\n/** Options for the guard wrapper. */\nexport interface GuardOptions extends LetAgentPayConfig {\n  /** Existing client instance. Takes priority over token/baseUrl. */\n  client?: LetAgentPay;\n  /** Purchase category for the request. */\n  category?: string;\n  /** Fixed amount per call. If not set, must be passed to the guarded function. */\n  amount?: number;\n  /** Purchase description. */\n  description?: string;\n  /** Optional comment explaining the purchase. */\n  agentComment?: string;\n}\n\n/**\n * Wrap an async function so it checks spending policy before executing.\n *\n * @example\n * ```ts\n * const guardedBuy = guard(\n *   async (item: string, amount: number) => {\n *     return `Bought ${item} for $${amount}`;\n *   },\n *   { token: \"agt_...\", category: \"groceries\" }\n * );\n *\n * // amount is extracted from the last numeric argument\n * await guardedBuy(\"apples\", 9.99);\n * ```\n */\nexport function guard<TArgs extends unknown[], TReturn>(\n  fn: (...args: TArgs) => TReturn | Promise<TReturn>,\n  options: GuardOptions & { amount?: number },\n): (...args: TArgs) => Promise<TReturn> {\n  return async (...args: TArgs): Promise<TReturn> => {\n    let resolvedAmount = options.amount;\n    if (resolvedAmount == null) {\n      // Try to find a numeric argument (first one)\n      for (const arg of args) {\n        if (typeof arg === \"number\") {\n          resolvedAmount = arg;\n          break;\n        }\n      }\n    }\n\n    if (resolvedAmount == null) {\n      throw new Error(\n        \"guard: could not determine amount from arguments. \" +\n          \"Pass amount in guard options or as a numeric function argument.\",\n      );\n    }\n\n    const client = options.client ?? new LetAgentPay(options);\n\n    const result = await client.requestPurchase({\n      amount: resolvedAmount,\n      category: options.category ?? \"other\",\n      description:\n        options.description ?? `Auto-guarded call to ${fn.name || \"anonymous\"}`,\n      agentComment: options.agentComment,\n    });\n\n    if (result.status === \"auto_approved\" || result.status === \"pending\") {\n      if (result.status === \"pending\") {\n        throw new LetAgentPayError(\n          403,\n          `Purchase request pending approval: ${result.requestId}`,\n        );\n      }\n      return fn(...args);\n    }\n\n    throw new LetAgentPayError(\n      403,\n      `Purchase request ${result.status}: ${result.requestId}`,\n    );\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "letagentpay",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for LetAgentPay — AI agent spending policy middleware",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "spending",
+    "policy",
+    "budget",
+    "llm",
+    "openclaw",
+    "letagentpay"
+  ],
+  "author": "LetAgentPay <hello@letagentpay.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LetAgentPay/letagentpay-js"
+  },
+  "homepage": "https://letagentpay.com",
+  "bugs": {
+    "url": "https://github.com/LetAgentPay/letagentpay-js/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.0.0"
+  }
+}