@sardis/ai-sdk 0.1.0

package/dist/chunk-LMCXCW32.js

@@ -0,0 +1,216 @@
+import { createSardisTools, createReadOnlySardisTools, createMinimalSardisTools } from './chunk-BVUWWUQU.js';
+
+// src/provider.ts
+var SardisProvider = class {
+  config;
+  _tools;
+  constructor(config) {
+    this.config = config;
+    switch (config.toolSet) {
+      case "minimal":
+        this._tools = createMinimalSardisTools(config);
+        break;
+      case "readonly":
+        this._tools = createReadOnlySardisTools(config);
+        break;
+      default:
+        this._tools = createSardisTools(config);
+    }
+    if (config.enableLogging || config.onTransaction) {
+      this._tools = this.wrapToolsWithLogging(this._tools);
+    }
+  }
+  /**
+   * Get the tools for Vercel AI SDK.
+   */
+  get tools() {
+    return this._tools;
+  }
+  /**
+   * Get the recommended system prompt for payment agents.
+   */
+  get systemPrompt() {
+    const basePrompt = `You are an AI assistant with access to a Sardis payment wallet.
+
+## Payment Guidelines
+
+1. **Always check policy before large payments** (>$50)
+   - Use sardis_check_policy to verify the payment would be allowed
+   - Report any policy violations to the user
+
+2. **Use holds for uncertain amounts**
+   - Create a hold when the final amount isn't known
+   - Capture the hold once the final amount is confirmed
+   - Void holds that are no longer needed
+
+3. **Provide transaction details**
+   - Always include the transaction ID and status in your response
+   - If a payment fails, explain why and suggest alternatives
+
+4. **Respect spending limits**
+   - Check remaining limits with sardis_get_spending
+   - Don't attempt payments that would exceed limits
+
+5. **Security practices**
+   - Never expose wallet IDs or API keys
+   - Verify merchant names before large payments
+   - Double-check amounts with the user for payments >$100
+
+## Available Actions
+
+- **sardis_pay**: Execute a payment
+- **sardis_create_hold**: Reserve funds for later
+- **sardis_capture_hold**: Complete a held payment
+- **sardis_void_hold**: Cancel a hold
+- **sardis_check_policy**: Check if payment is allowed
+- **sardis_get_balance**: Check wallet balance
+- **sardis_get_spending**: View spending summary`;
+    if (this.config.customInstructions) {
+      return `${basePrompt}
+
+## Additional Instructions
+
+${this.config.customInstructions}`;
+    }
+    return basePrompt;
+  }
+  /**
+   * Execute a payment directly (without AI).
+   */
+  async pay(params) {
+    const tool = this._tools.sardis_pay;
+    if (!tool || typeof tool.execute !== "function") {
+      throw new Error("Payment tool not available");
+    }
+    return tool.execute(params, { toolCallId: "direct", messages: [] });
+  }
+  /**
+   * Create a hold directly (without AI).
+   */
+  async createHold(params) {
+    const tool = this._tools.sardis_create_hold;
+    if (!tool || typeof tool.execute !== "function") {
+      throw new Error("Hold tool not available");
+    }
+    return tool.execute(params, { toolCallId: "direct", messages: [] });
+  }
+  /**
+   * Capture a hold directly (without AI).
+   */
+  async captureHold(holdId, amount) {
+    const tool = this._tools.sardis_capture_hold;
+    if (!tool || typeof tool.execute !== "function") {
+      throw new Error("Capture tool not available");
+    }
+    return tool.execute({ holdId, amount }, { toolCallId: "direct", messages: [] });
+  }
+  /**
+   * Void a hold directly (without AI).
+   */
+  async voidHold(holdId) {
+    const tool = this._tools.sardis_void_hold;
+    if (!tool || typeof tool.execute !== "function") {
+      throw new Error("Void tool not available");
+    }
+    return tool.execute({ holdId }, { toolCallId: "direct", messages: [] });
+  }
+  /**
+   * Check policy directly (without AI).
+   */
+  async checkPolicy(params) {
+    const tool = this._tools.sardis_check_policy;
+    if (!tool || typeof tool.execute !== "function") {
+      throw new Error("Policy check tool not available");
+    }
+    return tool.execute(params, { toolCallId: "direct", messages: [] });
+  }
+  /**
+   * Get balance directly (without AI).
+   */
+  async getBalance(token, chain) {
+    const tool = this._tools.sardis_get_balance;
+    if (!tool || typeof tool.execute !== "function") {
+      throw new Error("Balance tool not available");
+    }
+    return tool.execute({ token, chain }, { toolCallId: "direct", messages: [] });
+  }
+  /**
+   * Wrap tools with logging functionality.
+   */
+  wrapToolsWithLogging(tools) {
+    const wrapped = {};
+    for (const [name, tool] of Object.entries(tools)) {
+      if (tool && typeof tool.execute === "function") {
+        const originalExecute = tool.execute.bind(tool);
+        wrapped[name] = {
+          ...tool,
+          execute: async (params, options) => {
+            const startTime = Date.now();
+            let result;
+            let success = true;
+            let error;
+            try {
+              result = await originalExecute(params, options);
+              if (result && typeof result === "object" && "success" in result) {
+                success = result.success;
+                if (!success && "error" in result) {
+                  error = result.error;
+                }
+              }
+            } catch (e) {
+              success = false;
+              error = e instanceof Error ? e.message : "Unknown error";
+              throw e;
+            } finally {
+              const event = {
+                type: this.getEventType(name),
+                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                params,
+                result,
+                success,
+                error
+              };
+              if (this.config.enableLogging) {
+                const duration = Date.now() - startTime;
+                console.log(`[Sardis] ${name} ${success ? "\u2713" : "\u2717"} (${duration}ms)`, event);
+              }
+              if (this.config.onTransaction) {
+                try {
+                  await this.config.onTransaction(event);
+                } catch (callbackError) {
+                  console.error("[Sardis] Transaction callback error:", callbackError);
+                }
+              }
+            }
+            return result;
+          }
+        };
+      } else {
+        wrapped[name] = tool;
+      }
+    }
+    return wrapped;
+  }
+  /**
+   * Map tool name to event type.
+   */
+  getEventType(toolName) {
+    const mapping = {
+      sardis_pay: "payment",
+      sardis_create_hold: "hold_create",
+      sardis_capture_hold: "hold_capture",
+      sardis_void_hold: "hold_void",
+      sardis_check_policy: "policy_check",
+      sardis_get_balance: "balance_check",
+      sardis_get_spending: "balance_check"
+    };
+    return mapping[toolName] || "payment";
+  }
+};
+function createSardisProvider(config) {
+  return new SardisProvider(config);
+}
+
+export { SardisProvider, createSardisProvider };
+//# sourceMappingURL=chunk-LMCXCW32.js.map
+//# sourceMappingURL=chunk-LMCXCW32.js.map

package/dist/chunk-LMCXCW32.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.ts"],"names":[],"mappings":"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","file":"chunk-LMCXCW32.js","sourcesContent":["/**\n * Sardis Provider for Vercel AI SDK.\n *\n * Provides a higher-level abstraction for integrating Sardis payments\n * with AI agents, including automatic policy enforcement and transaction logging.\n *\n * @example\n * ```typescript\n * import { SardisProvider } from '@sardis/ai-sdk/provider'\n *\n * const sardis = new SardisProvider({\n *   apiKey: process.env.SARDIS_API_KEY!,\n *   walletId: 'wallet_abc123',\n *   agentId: 'agent_xyz789',\n * })\n *\n * // Use with Vercel AI SDK\n * const { text } = await generateText({\n *   model: openai('gpt-4o'),\n *   tools: sardis.tools,\n *   system: sardis.systemPrompt,\n *   prompt: 'Purchase $50 worth of API credits',\n * })\n *\n * // Or execute directly\n * const result = await sardis.pay({\n *   to: 'merchant_openai',\n *   amount: 50,\n *   memo: 'API credits',\n * })\n * ```\n */\n\nimport { createSardisTools, createMinimalSardisTools, createReadOnlySardisTools } from './tools'\nimport type { SardisToolsConfig, PaymentResult, HoldResult, PolicyCheckResult, BalanceResult } from './types'\nimport type { Tool, ToolExecutionOptions } from 'ai'\n\n/**\n * Extended configuration for SardisProvider.\n */\nexport interface SardisProviderConfig extends SardisToolsConfig {\n  /** Log all transactions to console */\n  enableLogging?: boolean\n  /** Callback for transaction events */\n  onTransaction?: (event: TransactionEvent) => void | Promise<void>\n  /** Custom system prompt additions */\n  customInstructions?: string\n  /** Tool set to use: 'full', 'minimal', 'readonly' */\n  toolSet?: 'full' | 'minimal' | 'readonly'\n}\n\n/**\n * Transaction event for logging/callbacks.\n */\nexport interface TransactionEvent {\n  type: 'payment' | 'hold_create' | 'hold_capture' | 'hold_void' | 'policy_check' | 'balance_check'\n  timestamp: string\n  params: Record<string, unknown>\n  result: PaymentResult | HoldResult | PolicyCheckResult | BalanceResult\n  success: boolean\n  error?: string\n}\n\n/**\n * Sardis Provider for streamlined AI agent integration.\n *\n * Provides:\n * - Pre-configured tools for Vercel AI SDK\n * - System prompt with payment guidelines\n * - Direct payment methods for programmatic access\n * - Transaction logging and callbacks\n */\nexport class SardisProvider {\n  private config: SardisProviderConfig\n  private _tools: Record<string, Tool>\n\n  constructor(config: SardisProviderConfig) {\n    this.config = config\n\n    // Create appropriate tool set\n    switch (config.toolSet) {\n      case 'minimal':\n        this._tools = createMinimalSardisTools(config)\n        break\n      case 'readonly':\n        this._tools = createReadOnlySardisTools(config)\n        break\n      default:\n        this._tools = createSardisTools(config)\n    }\n\n    // Wrap tools with logging if enabled\n    if (config.enableLogging || config.onTransaction) {\n      this._tools = this.wrapToolsWithLogging(this._tools)\n    }\n  }\n\n  /**\n   * Get the tools for Vercel AI SDK.\n   */\n  get tools(): Record<string, Tool> {\n    return this._tools\n  }\n\n  /**\n   * Get the recommended system prompt for payment agents.\n   */\n  get systemPrompt(): string {\n    const basePrompt = `You are an AI assistant with access to a Sardis payment wallet.\n\n## Payment Guidelines\n\n1. **Always check policy before large payments** (>$50)\n   - Use sardis_check_policy to verify the payment would be allowed\n   - Report any policy violations to the user\n\n2. **Use holds for uncertain amounts**\n   - Create a hold when the final amount isn't known\n   - Capture the hold once the final amount is confirmed\n   - Void holds that are no longer needed\n\n3. **Provide transaction details**\n   - Always include the transaction ID and status in your response\n   - If a payment fails, explain why and suggest alternatives\n\n4. **Respect spending limits**\n   - Check remaining limits with sardis_get_spending\n   - Don't attempt payments that would exceed limits\n\n5. **Security practices**\n   - Never expose wallet IDs or API keys\n   - Verify merchant names before large payments\n   - Double-check amounts with the user for payments >$100\n\n## Available Actions\n\n- **sardis_pay**: Execute a payment\n- **sardis_create_hold**: Reserve funds for later\n- **sardis_capture_hold**: Complete a held payment\n- **sardis_void_hold**: Cancel a hold\n- **sardis_check_policy**: Check if payment is allowed\n- **sardis_get_balance**: Check wallet balance\n- **sardis_get_spending**: View spending summary`\n\n    if (this.config.customInstructions) {\n      return `${basePrompt}\\n\\n## Additional Instructions\\n\\n${this.config.customInstructions}`\n    }\n\n    return basePrompt\n  }\n\n  /**\n   * Execute a payment directly (without AI).\n   */\n  async pay(params: {\n    to: string\n    amount: number\n    token?: string\n    chain?: 'base' | 'polygon' | 'ethereum' | 'arbitrum' | 'optimism'\n    memo?: string\n    merchant?: string\n    category?: string\n  }): Promise<PaymentResult> {\n    const tool = this._tools.sardis_pay\n    if (!tool || typeof tool.execute !== 'function') {\n      throw new Error('Payment tool not available')\n    }\n    return tool.execute(params, { toolCallId: 'direct', messages: [] }) as Promise<PaymentResult>\n  }\n\n  /**\n   * Create a hold directly (without AI).\n   */\n  async createHold(params: {\n    amount: number\n    merchant: string\n    expiresInHours?: number\n    description?: string\n  }): Promise<HoldResult> {\n    const tool = this._tools.sardis_create_hold\n    if (!tool || typeof tool.execute !== 'function') {\n      throw new Error('Hold tool not available')\n    }\n    return tool.execute(params, { toolCallId: 'direct', messages: [] }) as Promise<HoldResult>\n  }\n\n  /**\n   * Capture a hold directly (without AI).\n   */\n  async captureHold(holdId: string, amount?: number): Promise<HoldResult> {\n    const tool = this._tools.sardis_capture_hold\n    if (!tool || typeof tool.execute !== 'function') {\n      throw new Error('Capture tool not available')\n    }\n    return tool.execute({ holdId, amount }, { toolCallId: 'direct', messages: [] }) as Promise<HoldResult>\n  }\n\n  /**\n   * Void a hold directly (without AI).\n   */\n  async voidHold(holdId: string): Promise<HoldResult> {\n    const tool = this._tools.sardis_void_hold\n    if (!tool || typeof tool.execute !== 'function') {\n      throw new Error('Void tool not available')\n    }\n    return tool.execute({ holdId }, { toolCallId: 'direct', messages: [] }) as Promise<HoldResult>\n  }\n\n  /**\n   * Check policy directly (without AI).\n   */\n  async checkPolicy(params: {\n    amount: number\n    merchant?: string\n    category?: string\n  }): Promise<PolicyCheckResult> {\n    const tool = this._tools.sardis_check_policy\n    if (!tool || typeof tool.execute !== 'function') {\n      throw new Error('Policy check tool not available')\n    }\n    return tool.execute(params, { toolCallId: 'direct', messages: [] }) as Promise<PolicyCheckResult>\n  }\n\n  /**\n   * Get balance directly (without AI).\n   */\n  async getBalance(token?: string, chain?: string): Promise<BalanceResult> {\n    const tool = this._tools.sardis_get_balance\n    if (!tool || typeof tool.execute !== 'function') {\n      throw new Error('Balance tool not available')\n    }\n    return tool.execute({ token, chain }, { toolCallId: 'direct', messages: [] }) as Promise<BalanceResult>\n  }\n\n  /**\n   * Wrap tools with logging functionality.\n   */\n  private wrapToolsWithLogging(tools: Record<string, Tool>): Record<string, Tool> {\n    const wrapped: Record<string, Tool> = {}\n\n    for (const [name, tool] of Object.entries(tools)) {\n      if (tool && typeof tool.execute === 'function') {\n        const originalExecute = tool.execute.bind(tool)\n\n        wrapped[name] = {\n          ...tool,\n          execute: async (params: unknown, options: ToolExecutionOptions) => {\n            const startTime = Date.now()\n            let result: unknown\n            let success = true\n            let error: string | undefined\n\n            try {\n              result = await originalExecute(params, options)\n\n              // Check if result indicates failure\n              if (result && typeof result === 'object' && 'success' in result) {\n                success = (result as { success: boolean }).success\n                if (!success && 'error' in result) {\n                  error = (result as { error?: string }).error\n                }\n              }\n            } catch (e) {\n              success = false\n              error = e instanceof Error ? e.message : 'Unknown error'\n              throw e\n            } finally {\n              const event: TransactionEvent = {\n                type: this.getEventType(name),\n                timestamp: new Date().toISOString(),\n                params: params as Record<string, unknown>,\n                result: result as TransactionEvent['result'],\n                success,\n                error,\n              }\n\n              // Log to console if enabled\n              if (this.config.enableLogging) {\n                const duration = Date.now() - startTime\n                console.log(`[Sardis] ${name} ${success ? '✓' : '✗'} (${duration}ms)`, event)\n              }\n\n              // Call transaction callback if provided\n              if (this.config.onTransaction) {\n                try {\n                  await this.config.onTransaction(event)\n                } catch (callbackError) {\n                  console.error('[Sardis] Transaction callback error:', callbackError)\n                }\n              }\n            }\n\n            return result\n          },\n        } as Tool\n      } else {\n        wrapped[name] = tool\n      }\n    }\n\n    return wrapped\n  }\n\n  /**\n   * Map tool name to event type.\n   */\n  private getEventType(toolName: string): TransactionEvent['type'] {\n    const mapping: Record<string, TransactionEvent['type']> = {\n      sardis_pay: 'payment',\n      sardis_create_hold: 'hold_create',\n      sardis_capture_hold: 'hold_capture',\n      sardis_void_hold: 'hold_void',\n      sardis_check_policy: 'policy_check',\n      sardis_get_balance: 'balance_check',\n      sardis_get_spending: 'balance_check',\n    }\n    return mapping[toolName] || 'payment'\n  }\n}\n\n/**\n * Create a SardisProvider instance.\n *\n * Convenience function for creating a provider.\n */\nexport function createSardisProvider(config: SardisProviderConfig): SardisProvider {\n  return new SardisProvider(config)\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createMinimalSardisTools, createReadOnlySardisTools, createSardisTools } from './tools.js';
+export { SardisProvider, SardisProviderConfig, TransactionEvent, createSardisProvider } from './provider.js';
+export { B as BalanceParams, a as BalanceParamsSchema, b as BalanceResult, C as CaptureParams, c as CaptureParamsSchema, H as HoldParams, d as HoldParamsSchema, e as HoldResult, P as PaymentParams, f as PaymentParamsSchema, g as PaymentResult, h as PolicyCheckParams, i as PolicyCheckParamsSchema, j as PolicyCheckResult, S as SardisToolsConfig } from './types-Cdb1Gu2W.js';
+import 'ai';
+import 'zod';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { SardisProvider, createSardisProvider } from './chunk-LMCXCW32.js';
+export { BalanceParamsSchema, CaptureParamsSchema, HoldParamsSchema, PaymentParamsSchema, PolicyCheckParamsSchema, createMinimalSardisTools, createReadOnlySardisTools, createSardisTools } from './chunk-BVUWWUQU.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/provider.d.ts

@@ -0,0 +1,140 @@
+import { S as SardisToolsConfig, g as PaymentResult, e as HoldResult, j as PolicyCheckResult, b as BalanceResult } from './types-Cdb1Gu2W.js';
+import { Tool } from 'ai';
+import 'zod';
+
+/**
+ * Sardis Provider for Vercel AI SDK.
+ *
+ * Provides a higher-level abstraction for integrating Sardis payments
+ * with AI agents, including automatic policy enforcement and transaction logging.
+ *
+ * @example
+ * ```typescript
+ * import { SardisProvider } from '@sardis/ai-sdk/provider'
+ *
+ * const sardis = new SardisProvider({
+ *   apiKey: process.env.SARDIS_API_KEY!,
+ *   walletId: 'wallet_abc123',
+ *   agentId: 'agent_xyz789',
+ * })
+ *
+ * // Use with Vercel AI SDK
+ * const { text } = await generateText({
+ *   model: openai('gpt-4o'),
+ *   tools: sardis.tools,
+ *   system: sardis.systemPrompt,
+ *   prompt: 'Purchase $50 worth of API credits',
+ * })
+ *
+ * // Or execute directly
+ * const result = await sardis.pay({
+ *   to: 'merchant_openai',
+ *   amount: 50,
+ *   memo: 'API credits',
+ * })
+ * ```
+ */
+
+/**
+ * Extended configuration for SardisProvider.
+ */
+interface SardisProviderConfig extends SardisToolsConfig {
+    /** Log all transactions to console */
+    enableLogging?: boolean;
+    /** Callback for transaction events */
+    onTransaction?: (event: TransactionEvent) => void | Promise<void>;
+    /** Custom system prompt additions */
+    customInstructions?: string;
+    /** Tool set to use: 'full', 'minimal', 'readonly' */
+    toolSet?: 'full' | 'minimal' | 'readonly';
+}
+/**
+ * Transaction event for logging/callbacks.
+ */
+interface TransactionEvent {
+    type: 'payment' | 'hold_create' | 'hold_capture' | 'hold_void' | 'policy_check' | 'balance_check';
+    timestamp: string;
+    params: Record<string, unknown>;
+    result: PaymentResult | HoldResult | PolicyCheckResult | BalanceResult;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Sardis Provider for streamlined AI agent integration.
+ *
+ * Provides:
+ * - Pre-configured tools for Vercel AI SDK
+ * - System prompt with payment guidelines
+ * - Direct payment methods for programmatic access
+ * - Transaction logging and callbacks
+ */
+declare class SardisProvider {
+    private config;
+    private _tools;
+    constructor(config: SardisProviderConfig);
+    /**
+     * Get the tools for Vercel AI SDK.
+     */
+    get tools(): Record<string, Tool>;
+    /**
+     * Get the recommended system prompt for payment agents.
+     */
+    get systemPrompt(): string;
+    /**
+     * Execute a payment directly (without AI).
+     */
+    pay(params: {
+        to: string;
+        amount: number;
+        token?: string;
+        chain?: 'base' | 'polygon' | 'ethereum' | 'arbitrum' | 'optimism';
+        memo?: string;
+        merchant?: string;
+        category?: string;
+    }): Promise<PaymentResult>;
+    /**
+     * Create a hold directly (without AI).
+     */
+    createHold(params: {
+        amount: number;
+        merchant: string;
+        expiresInHours?: number;
+        description?: string;
+    }): Promise<HoldResult>;
+    /**
+     * Capture a hold directly (without AI).
+     */
+    captureHold(holdId: string, amount?: number): Promise<HoldResult>;
+    /**
+     * Void a hold directly (without AI).
+     */
+    voidHold(holdId: string): Promise<HoldResult>;
+    /**
+     * Check policy directly (without AI).
+     */
+    checkPolicy(params: {
+        amount: number;
+        merchant?: string;
+        category?: string;
+    }): Promise<PolicyCheckResult>;
+    /**
+     * Get balance directly (without AI).
+     */
+    getBalance(token?: string, chain?: string): Promise<BalanceResult>;
+    /**
+     * Wrap tools with logging functionality.
+     */
+    private wrapToolsWithLogging;
+    /**
+     * Map tool name to event type.
+     */
+    private getEventType;
+}
+/**
+ * Create a SardisProvider instance.
+ *
+ * Convenience function for creating a provider.
+ */
+declare function createSardisProvider(config: SardisProviderConfig): SardisProvider;
+
+export { SardisProvider, type SardisProviderConfig, type TransactionEvent, createSardisProvider };

package/dist/provider.js

@@ -0,0 +1,4 @@
+export { SardisProvider, createSardisProvider } from './chunk-LMCXCW32.js';
+import './chunk-BVUWWUQU.js';
+//# sourceMappingURL=provider.js.map
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"provider.js"}

package/dist/tools.d.ts

@@ -0,0 +1,64 @@
+import { Tool } from 'ai';
+import { S as SardisToolsConfig } from './types-Cdb1Gu2W.js';
+import 'zod';
+
+/**
+ * Sardis payment tools for Vercel AI SDK.
+ *
+ * These tools enable AI agents to make payments with policy guardrails.
+ *
+ * @example
+ * ```typescript
+ * import { generateText } from 'ai'
+ * import { openai } from '@ai-sdk/openai'
+ * import { createSardisTools } from '@sardis/ai-sdk'
+ *
+ * const sardisTools = createSardisTools({
+ *   apiKey: process.env.SARDIS_API_KEY!,
+ *   walletId: 'wallet_abc123',
+ * })
+ *
+ * const result = await generateText({
+ *   model: openai('gpt-4o'),
+ *   tools: sardisTools,
+ *   prompt: 'Pay $50 to merchant_xyz for API credits',
+ * })
+ * ```
+ */
+
+/**
+ * Create Sardis payment tools for Vercel AI SDK.
+ *
+ * Returns a set of tools that can be passed to `generateText` or `streamText`.
+ *
+ * @example
+ * ```typescript
+ * const tools = createSardisTools({
+ *   apiKey: process.env.SARDIS_API_KEY!,
+ *   walletId: 'wallet_abc123',
+ *   maxPaymentAmount: 100, // Optional: limit single payments
+ *   blockedCategories: ['gambling', 'adult'], // Optional: block categories
+ * })
+ *
+ * const { text, toolResults } = await generateText({
+ *   model: openai('gpt-4o'),
+ *   tools,
+ *   prompt: 'Check my balance and pay $25 to OpenAI for API credits',
+ * })
+ * ```
+ */
+declare function createSardisTools(config: SardisToolsConfig): Record<string, Tool>;
+/**
+ * Create a minimal set of Sardis tools (pay + balance only).
+ *
+ * Use this for simpler use cases that don't need holds or detailed policy checks.
+ */
+declare function createMinimalSardisTools(config: SardisToolsConfig): Record<string, Tool>;
+/**
+ * Create Sardis tools with only read operations (no payments).
+ *
+ * Use this for analytics, reporting, or view-only access.
+ */
+declare function createReadOnlySardisTools(config: SardisToolsConfig): Record<string, Tool>;
+
+export { createMinimalSardisTools, createReadOnlySardisTools, createSardisTools };

package/dist/tools.js

@@ -0,0 +1,3 @@
+export { createMinimalSardisTools, createReadOnlySardisTools, createSardisTools } from './chunk-BVUWWUQU.js';
+//# sourceMappingURL=tools.js.map
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"tools.js"}

package/dist/types-Cdb1Gu2W.d.ts

@@ -0,0 +1,192 @@
+import { z } from 'zod';
+
+/**
+ * Type definitions for Sardis AI SDK integration.
+ */
+
+/**
+ * Configuration for Sardis AI SDK tools.
+ */
+interface SardisToolsConfig {
+    /** Sardis API key */
+    apiKey: string;
+    /** Default wallet ID for payments */
+    walletId: string;
+    /** Default agent ID */
+    agentId?: string;
+    /** Base URL for Sardis API (default: https://api.sardis.network) */
+    baseUrl?: string;
+    /** Enable simulation mode (no real transactions) */
+    simulationMode?: boolean;
+    /** Maximum single payment amount (policy limit) */
+    maxPaymentAmount?: number;
+    /** Blocked merchant categories */
+    blockedCategories?: string[];
+    /** Allowed merchants only (whitelist mode) */
+    allowedMerchants?: string[];
+}
+/**
+ * Payment execution parameters.
+ */
+declare const PaymentParamsSchema: z.ZodObject<{
+    /** Recipient address or merchant identifier */
+    to: z.ZodString;
+    /** Amount in USD */
+    amount: z.ZodNumber;
+    /** Token to use (default: USDC) */
+    token: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Chain to execute on */
+    chain: z.ZodDefault<z.ZodOptional<z.ZodEnum<["base", "polygon", "ethereum", "arbitrum", "optimism"]>>>;
+    /** Payment description/memo */
+    memo: z.ZodOptional<z.ZodString>;
+    /** Merchant name for policy checks */
+    merchant: z.ZodOptional<z.ZodString>;
+    /** Merchant category code */
+    category: z.ZodOptional<z.ZodString>;
+    /** Idempotency key to prevent duplicates */
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    to: string;
+    amount: number;
+    token: string;
+    chain: "base" | "polygon" | "ethereum" | "arbitrum" | "optimism";
+    memo?: string | undefined;
+    merchant?: string | undefined;
+    category?: string | undefined;
+    idempotencyKey?: string | undefined;
+}, {
+    to: string;
+    amount: number;
+    token?: string | undefined;
+    chain?: "base" | "polygon" | "ethereum" | "arbitrum" | "optimism" | undefined;
+    memo?: string | undefined;
+    merchant?: string | undefined;
+    category?: string | undefined;
+    idempotencyKey?: string | undefined;
+}>;
+type PaymentParams = z.infer<typeof PaymentParamsSchema>;
+/**
+ * Hold creation parameters.
+ */
+declare const HoldParamsSchema: z.ZodObject<{
+    /** Amount to hold in USD */
+    amount: z.ZodNumber;
+    /** Merchant name */
+    merchant: z.ZodString;
+    /** Hold expiration in hours (default: 24) */
+    expiresInHours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** Description of the hold purpose */
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: number;
+    merchant: string;
+    expiresInHours: number;
+    description?: string | undefined;
+}, {
+    amount: number;
+    merchant: string;
+    expiresInHours?: number | undefined;
+    description?: string | undefined;
+}>;
+type HoldParams = z.infer<typeof HoldParamsSchema>;
+/**
+ * Hold capture parameters.
+ */
+declare const CaptureParamsSchema: z.ZodObject<{
+    /** Hold ID to capture */
+    holdId: z.ZodString;
+    /** Amount to capture (defaults to full hold amount) */
+    amount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    holdId: string;
+    amount?: number | undefined;
+}, {
+    holdId: string;
+    amount?: number | undefined;
+}>;
+type CaptureParams = z.infer<typeof CaptureParamsSchema>;
+/**
+ * Policy check parameters.
+ */
+declare const PolicyCheckParamsSchema: z.ZodObject<{
+    /** Amount to check */
+    amount: z.ZodNumber;
+    /** Merchant name */
+    merchant: z.ZodOptional<z.ZodString>;
+    /** Merchant category */
+    category: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: number;
+    merchant?: string | undefined;
+    category?: string | undefined;
+}, {
+    amount: number;
+    merchant?: string | undefined;
+    category?: string | undefined;
+}>;
+type PolicyCheckParams = z.infer<typeof PolicyCheckParamsSchema>;
+/**
+ * Balance check parameters.
+ */
+declare const BalanceParamsSchema: z.ZodObject<{
+    /** Token to check (default: USDC) */
+    token: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Chain to check */
+    chain: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    token: string;
+    chain?: string | undefined;
+}, {
+    token?: string | undefined;
+    chain?: string | undefined;
+}>;
+type BalanceParams = z.infer<typeof BalanceParamsSchema>;
+/**
+ * Payment result.
+ */
+interface PaymentResult {
+    success: boolean;
+    transactionId?: string;
+    txHash?: string;
+    amount: number;
+    token: string;
+    chain: string;
+    status: 'completed' | 'pending' | 'failed';
+    error?: string;
+    blockNumber?: number;
+    timestamp: string;
+}
+/**
+ * Hold result.
+ */
+interface HoldResult {
+    success: boolean;
+    holdId?: string;
+    amount: number;
+    merchant: string;
+    expiresAt?: string;
+    status: 'active' | 'captured' | 'voided' | 'expired' | 'failed';
+    error?: string;
+}
+/**
+ * Policy check result.
+ */
+interface PolicyCheckResult {
+    allowed: boolean;
+    reason?: string;
+    remainingDailyLimit?: number;
+    remainingMonthlyLimit?: number;
+    requiresApproval?: boolean;
+}
+/**
+ * Balance result.
+ */
+interface BalanceResult {
+    available: number;
+    pending: number;
+    held: number;
+    token: string;
+    chain: string;
+}
+
+export { type BalanceParams as B, type CaptureParams as C, type HoldParams as H, type PaymentParams as P, type SardisToolsConfig as S, BalanceParamsSchema as a, type BalanceResult as b, CaptureParamsSchema as c, HoldParamsSchema as d, type HoldResult as e, PaymentParamsSchema as f, type PaymentResult as g, type PolicyCheckParams as h, PolicyCheckParamsSchema as i, type PolicyCheckResult as j };