autocart-ai-tools 1.0.0

package/README.md

@@ -0,0 +1,36 @@
+# @autocart/ai-tools
+
+The official OpenAI/LangChain tools for the AutoCart network.
+
+This package provides pre-built function-calling schemas and execution logic to instantly give your AI Agent the ability to securely search and purchase products from verified merchants on the AutoCart network.
+
+## Installation
+
+```bash
+npm install @autocart/ai-tools
+```
+
+## Usage (LangChain / LangGraph)
+
+```javascript
+import { createReactAgent } from "@langchain/langgraph";
+import { tool } from "@langchain/core/tools";
+import { AutoCartSearchTool, AutoCartBuyerTool } from "@autocart/ai-tools";
+
+const searchApi = new AutoCartSearchTool({ networkUrl: 'https://api.autocart.network' });
+const searchTool = tool(
+  async (args) => searchApi.execute(args),
+  { name: searchApi.getOpenAISchema().name, description: searchApi.getOpenAISchema().description, schema: searchApi.getOpenAISchema().parameters }
+);
+
+const buyApi = new AutoCartBuyerTool({ buyerKey: process.env.AUTOCART_BUYER_KEY });
+const buyTool = tool(
+  async (args) => buyApi.execute(args),
+  { name: buyApi.getOpenAISchema().name, description: buyApi.getOpenAISchema().description, schema: buyApi.getOpenAISchema().parameters }
+);
+
+const agent = createReactAgent({
+  llm: mistralModel,
+  tools: [searchTool, buyTool]
+});
+```

package/index.d.ts

@@ -0,0 +1,9 @@
+export interface AutoCartBuyerToolConfig {
+  buyerKey: string;
+}
+
+export class AutoCartBuyerTool {
+  constructor(config: AutoCartBuyerToolConfig);
+  getOpenAISchema(): any;
+  execute(args: { merchantUrl: string; sku: string; qty?: number }): Promise<string>;
+}

package/index.js

@@ -0,0 +1,112 @@
+import crypto from 'crypto';
+
+export class AutoCartSearchTool {
+  constructor(config = {}) {
+    this.networkUrl = config.networkUrl || 'http://localhost:5000';
+  }
+
+  getOpenAISchema() {
+    return {
+      name: 'autocart_search_catalog',
+      description: 'Search the global AutoCart network for products across all verified merchants.',
+      parameters: {
+        type: 'object',
+        properties: {
+          query: { type: 'string', description: 'The search query (e.g. "luxury watch")' }
+        },
+        required: ['query']
+      }
+    };
+  }
+
+  async execute({ query }) {
+    try {
+      const response = await fetch(`${this.networkUrl}/api/catalog/search?query=${encodeURIComponent(query)}`);
+      const data = await response.json();
+      return JSON.stringify(data.results);
+    } catch (err) {
+      return `Failed to search AutoCart network: ${err.message}`;
+    }
+  }
+}
+
+export class AutoCartBuyerTool {
+  constructor(config) {
+    if (!config.buyerKey) {
+      throw new Error('AutoCartBuyerTool requires a buyerKey');
+    }
+    this.buyerKey = config.buyerKey;
+  }
+
+  getOpenAISchema() {
+    return {
+      name: 'autocart_buy_product',
+      description: 'Purchases a product from an AutoCart-enabled merchant store.',
+      parameters: {
+        type: 'object',
+        properties: {
+          merchantUrl: {
+            type: 'string',
+            description: 'The base URL of the merchant store (returned by autocart_search_catalog)'
+          },
+          sku: {
+            type: 'string',
+            description: 'The exact SKU or product ID to purchase'
+          },
+          qty: {
+            type: 'integer',
+            description: 'The quantity to purchase (default 1)'
+          },
+          maxAuthorizedAmount: {
+            type: 'number',
+            description: 'The maximum total price the AI is willing to pay. Prevents price gouging.'
+          }
+        },
+        required: ['merchantUrl', 'sku']
+      }
+    };
+  }
+
+  async execute(args) {
+    const { merchantUrl, sku, qty = 1, maxAuthorizedAmount } = args;
+    
+    // Using a random UUID for idempotency in the tool
+    const idempotencyKey = crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).substring(7);
+
+    const payload = {
+      sku,
+      qty,
+      idempotencyKey,
+      maxAuthorizedAmount
+    };
+
+    try {
+      const response = await fetch(merchantUrl, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-buyer-key': this.buyerKey
+        },
+        body: JSON.stringify(payload)
+      });
+
+      const result = await response.json();
+      
+      if (!response.ok) {
+        return `Failed to purchase: ${result.error || result.message || JSON.stringify(result)}`;
+      }
+
+      if (result.status === 'GATED_1_CLICK' || result.status === 'GATED_2FA') {
+        return `Transaction blocked by firewall. Awaiting human approval. Audit ID: ${result.auditId}`;
+      }
+
+      if (result.status === 'PAYMENT_CAPTURED' || result.status === 'AUTO_APPROVED') {
+        return `Successfully purchased ${qty} of ${sku}. Order ID: ${result.razorpayOrderId}`;
+      }
+
+      return `Order status: ${result.status}`;
+    } catch (err) {
+      return `Error executing AutoCart transaction: ${err.message}`;
+    }
+  }
+}

package/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "autocart-ai-tools",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "description": "LangChain and OpenAI compatible tools for AI agents to buy products securely.",
+  "dependencies": {}
+}