@circuitorg/agent-sdk 1.1.3 → 1.1.6

package/README.md

@@ -2,16 +2,17 @@
 
 > **Clean, type-safe TypeScript SDK for building cross-chain agents on the circuit platform**
 
-A TypeScript SDK for building automated agents to deploy on Circuit. Features a simple API surface with just **3 main methods** and full type safety.
+A TypeScript SDK for building automated agents to deploy on Circuit. Features a simple API surface with just **2 core methods** plus **platform integrations** with full type safety.
 
 > **💡 Best used with [Circuit Agents CLI](https://github.com/circuitorg/agents-cli)** - Deploy, manage, and test your agents with ease
 
 ## ✨ Features
 
-- **🎯 Simple API**: Only 3 main methods - `sendLog()`, `signAndSend()`, and `swidge.*` (swap/bridge)
+- **🎯 Simple API**: 2 core methods (`sendLog()`, `signAndSend()`) + platform integrations
 - **🔒 Type Safety**: Network parameter determines valid request shapes automatically
 - **🚀 Cross-Chain**: Unified interface for EVM and Solana networks
 - **🌉 Cross-Chain Swaps**: Built-in Swidge integration for seamless token swaps and bridges
+- **📈 Polymarket Integration**: Trade prediction markets with `sdk.polymarket.*` methods
 
 ## 🚀 Quick Start
 ### Install the SDK
@@ -327,6 +328,255 @@ Pass the entire `quote.data` object returned from `quote()` - the SDK handles al
 - `"delayed"` - Transaction is taking longer than expected but still processing
 
 
+## 📈 Polymarket Prediction Markets
+
+The SDK includes built-in Polymarket integration for trading prediction markets on Polygon.
+
+### 4. Polymarket Trading
+
+#### Get Positions
+
+Fetch all current positions for the session wallet:
+
+```typescript
+const positions = await sdk.polymarket.positions();
+
+if (positions.success && positions.data) {
+  console.log(`Total value: $${positions.data.totalValue}`);
+  
+  for (const position of positions.data.positions) {
+    console.log(`${position.question} (${position.outcome})`);
+    console.log(`  Shares: ${position.formattedShares}`);
+    console.log(`  Value: $${position.valueUsd}`);
+    console.log(`  P&L: $${position.pnlUsd} (${position.pnlPercent}%)`);
+  }
+}
+```
+
+#### Place Market Orders
+
+Execute buy or sell market orders:
+
+```typescript
+// Buy order - size is USD amount to spend
+const buyOrder = await sdk.polymarket.marketOrder({
+  tokenId: "123456789...",  // Market token ID
+  size: 10,                  // Spend $10 to buy shares
+  side: "BUY"
+});
+
+// Sell order - size is number of shares to sell
+const sellOrder = await sdk.polymarket.marketOrder({
+  tokenId: "123456789...",
+  size: 5.5,                 // Sell 5.5 shares
+  side: "SELL"
+});
+
+if (buyOrder.success && buyOrder.data) {
+  console.log(`Order ID: ${buyOrder.data.submitOrder.orderId}`);
+  
+  if (buyOrder.data.orderInfo) {
+    console.log(`Filled at $${buyOrder.data.orderInfo.priceUsd} per share`);
+    console.log(`Total cost: $${buyOrder.data.orderInfo.totalPriceUsd}`);
+  }
+}
+```
+
+#### Redeem Positions
+
+Claim winnings from settled positions:
+
+```typescript
+// Redeem all redeemable positions
+const redemption = await sdk.polymarket.redeemPositions();
+
+if (redemption.success && redemption.data) {
+  for (const result of redemption.data) {
+    if (result.success) {
+      console.log(`✅ Redeemed: ${result.position.question}`);
+      console.log(`   TX: ${result.transactionHash}`);
+    }
+  }
+}
+
+// Redeem specific positions by token IDs
+const specificRedemption = await sdk.polymarket.redeemPositions({
+  tokenIds: ["123456", "789012"]
+});
+```
+
+### Polymarket API Reference
+
+#### `sdk.polymarket.positions(): Promise<PolymarketPositionsResponse>`
+
+Get all current positions for the session wallet.
+
+**Returns:**
+```typescript
+{
+  success: boolean,
+  data?: {
+    totalValue: number,
+    positions: Array<{
+      contractAddress: string,
+      tokenId: string,
+      question: string,
+      outcome: string,
+      formattedShares: string,
+      shares: string,
+      valueUsd: string,
+      priceUsd: string,
+      averagePriceUsd: string,
+      pnlUsd: string,
+      pnlPercent: string,
+      isRedeemable: boolean,
+      endDate: string,
+      // ... additional fields
+    }>
+  },
+  error?: string,
+  errorDetails?: { message: string, status?: number, statusText?: string }
+}
+```
+
+#### `sdk.polymarket.marketOrder(request): Promise<PolymarketMarketOrderResponse>`
+
+Place a buy or sell market order.
+
+⚠️ **Important**: The `size` parameter meaning differs by order side:
+- **BUY**: `size` is the USD amount to spend (e.g., 10 = $10 worth of shares)
+- **SELL**: `size` is the number of shares/tokens to sell (e.g., 10 = 10 shares)
+
+**Parameters:**
+```typescript
+{
+  tokenId: string,  // Market token ID for the position
+  size: number,     // For BUY: USD amount. For SELL: Number of shares
+  side: "BUY" | "SELL"
+}
+```
+
+**Returns:**
+```typescript
+{
+  success: boolean,
+  data?: {
+    order: {
+      eip712Message: { /* EIP712 typed data */ },
+      order: { /* Order details */ }
+    },
+    submitOrder: {
+      orderId: string,
+      success: boolean,
+      errorMessage: string | null
+    },
+    orderInfo?: {
+      orderId: string,
+      priceUsd: string,
+      totalPriceUsd: string,
+      side: string,
+      size: string,
+      txHashes: string[]
+    }
+  },
+  error?: string,
+  errorDetails?: { message: string, status?: number, statusText?: string }
+}
+```
+
+#### `sdk.polymarket.redeemPositions(request?): Promise<PolymarketRedeemPositionsResponse>`
+
+Redeem settled positions to claim winnings.
+
+**Parameters (optional):**
+```typescript
+{
+  tokenIds?: string[]  // Specific token IDs to redeem (default: all redeemable positions)
+}
+```
+
+**Returns:**
+```typescript
+{
+  success: boolean,
+  data?: Array<{
+    success: boolean,
+    position: { /* Full position details */ },
+    transactionHash: string | null
+  }>,
+  error?: string,
+  errorDetails?: { message: string, status?: number, statusText?: string }
+}
+```
+
+### Complete Polymarket Example
+
+```typescript
+const executionFunction: ExecutionFunctionContract = async (request) => {
+  const sdk = new AgentSdk({ sessionId: request.sessionId });
+
+  try {
+    // Get current positions
+    const positions = await sdk.polymarket.positions();
+    
+    if (!positions.success || !positions.data) {
+      throw new Error(`Failed to get positions: ${positions.error}`);
+    }
+
+    // Find specific position
+    const targetPosition = positions.data.positions.find(
+      p => p.tokenId === "YOUR_TOKEN_ID"
+    );
+
+    if (targetPosition && Number(targetPosition.formattedShares) > 0) {
+      // Sell position
+      const sellOrder = await sdk.polymarket.marketOrder({
+        tokenId: targetPosition.tokenId,
+        size: Number(targetPosition.formattedShares),
+        side: "SELL"
+      });
+
+      if (sellOrder.success && sellOrder.data?.orderInfo) {
+        await sdk.sendLog({
+          type: "observe",
+          shortMessage: `Sold ${targetPosition.outcome} for $${sellOrder.data.orderInfo.totalPriceUsd}`
+        });
+      }
+    }
+
+    return { success: true };
+  } catch (error) {
+    await sdk.sendLog({
+      type: "error",
+      shortMessage: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`
+    });
+    return { success: false, error: error instanceof Error ? error.message : "Unknown error" };
+  }
+};
+
+const stopFunction: StopFunctionContract = async (request) => {
+  const sdk = new AgentSdk({ sessionId: request.sessionId });
+
+  try {
+    // Redeem all settled positions on stop
+    const redemption = await sdk.polymarket.redeemPositions();
+
+    if (redemption.success && redemption.data) {
+      const successful = redemption.data.filter(r => r.success);
+      await sdk.sendLog({
+        type: "observe",
+        shortMessage: `✅ Redeemed ${successful.length} positions`
+      });
+    }
+
+    return { success: true };
+  } catch (error) {
+    return { success: false, error: error instanceof Error ? error.message : "Unknown error" };
+  }
+};
+```
+
+
 ## 🔧 Examples
 
 ### Barebones Agent

package/index.d.ts

@@ -66,7 +66,7 @@ declare const EIP712TypedDataSchema: z.ZodObject<{
         type: z.ZodString;
     }, z.core.$strip>>>;
     primaryType: z.ZodString;
-    message: z.ZodRecord<z.ZodString, z.ZodAny>;
+    message: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>;
 /**
  * EIP191 Message schema for simple message signing
@@ -229,9 +229,9 @@ declare const SwidgeExecuteRequestSchema: z.ZodObject<{
             chainId: z.ZodNumber;
             value: z.ZodNumber;
             data: z.ZodString;
-            gas: z.ZodNumber;
-            maxFeePerGas: z.ZodNumber;
-            maxPriorityFeePerGas: z.ZodNumber;
+            gas: z.ZodOptional<z.ZodNumber>;
+            maxFeePerGas: z.ZodOptional<z.ZodNumber>;
+            maxPriorityFeePerGas: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>, z.ZodObject<{
             type: z.ZodLiteral<"solana">;
             instructions: z.ZodArray<z.ZodObject<{
@@ -321,9 +321,9 @@ declare const SwidgeQuoteResponseWrapperSchema: z.ZodObject<{
                 chainId: z.ZodNumber;
                 value: z.ZodNumber;
                 data: z.ZodString;
-                gas: z.ZodNumber;
-                maxFeePerGas: z.ZodNumber;
-                maxPriorityFeePerGas: z.ZodNumber;
+                gas: z.ZodOptional<z.ZodNumber>;
+                maxFeePerGas: z.ZodOptional<z.ZodNumber>;
+                maxPriorityFeePerGas: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>, z.ZodObject<{
                 type: z.ZodLiteral<"solana">;
                 instructions: z.ZodArray<z.ZodObject<{
@@ -380,6 +380,166 @@ type SwidgeQuoteResponse = z.infer<typeof SwidgeQuoteResponseWrapperSchema>;
 type SwidgeExecuteRequest = z.infer<typeof SwidgeExecuteRequestSchema>;
 type SwidgeExecuteResponse = z.infer<typeof SwidgeExecuteResponseWrapperSchema>;
 
+declare const PolymarketPositionSchema: z.ZodObject<{
+    contractAddress: z.ZodString;
+    tokenId: z.ZodNullable<z.ZodString>;
+    decimals: z.ZodNumber;
+    conditionId: z.ZodString;
+    formattedShares: z.ZodString;
+    shares: z.ZodString;
+    valueUsd: z.ZodString;
+    question: z.ZodString;
+    outcome: z.ZodString;
+    priceUsd: z.ZodString;
+    averagePriceUsd: z.ZodString;
+    isRedeemable: z.ZodBoolean;
+    imageUrl: z.ZodString;
+    initialValue: z.ZodString;
+    pnlUsd: z.ZodString;
+    pnlPercent: z.ZodString;
+    pnlRealizedUsd: z.ZodString;
+    pnlRealizedPercent: z.ZodString;
+    endDate: z.ZodString;
+}, z.core.$strip>;
+declare const PolymarketMarketOrderRequestSchema: z.ZodObject<{
+    tokenId: z.ZodString;
+    size: z.ZodNumber;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+}, z.core.$strip>;
+declare const PolymarketRedeemPositionsRequestSchema: z.ZodObject<{
+    tokenIds: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
+declare const PolymarketPositionsResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        totalValue: z.ZodNumber;
+        positions: z.ZodArray<z.ZodObject<{
+            contractAddress: z.ZodString;
+            tokenId: z.ZodNullable<z.ZodString>;
+            decimals: z.ZodNumber;
+            conditionId: z.ZodString;
+            formattedShares: z.ZodString;
+            shares: z.ZodString;
+            valueUsd: z.ZodString;
+            question: z.ZodString;
+            outcome: z.ZodString;
+            priceUsd: z.ZodString;
+            averagePriceUsd: z.ZodString;
+            isRedeemable: z.ZodBoolean;
+            imageUrl: z.ZodString;
+            initialValue: z.ZodString;
+            pnlUsd: z.ZodString;
+            pnlPercent: z.ZodString;
+            pnlRealizedUsd: z.ZodString;
+            pnlRealizedPercent: z.ZodString;
+            endDate: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+    errorDetails: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        status: z.ZodOptional<z.ZodNumber>;
+        statusText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const PolymarketMarketOrderResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        order: z.ZodObject<{
+            eip712Message: z.ZodObject<{
+                types: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                }, z.core.$strip>>>;
+                domain: z.ZodObject<{
+                    name: z.ZodString;
+                    version: z.ZodString;
+                    chainId: z.ZodNumber;
+                    verifyingContract: z.ZodString;
+                }, z.core.$strip>;
+                primaryType: z.ZodString;
+                message: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>;
+            order: z.ZodObject<{
+                salt: z.ZodString;
+                maker: z.ZodString;
+                signer: z.ZodString;
+                taker: z.ZodString;
+                tokenId: z.ZodString;
+                makerAmount: z.ZodString;
+                takerAmount: z.ZodString;
+                expiration: z.ZodString;
+                nonce: z.ZodString;
+                feeRateBps: z.ZodString;
+                side: z.ZodNumber;
+                signatureType: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        submitOrder: z.ZodObject<{
+            orderId: z.ZodString;
+            success: z.ZodBoolean;
+            errorMessage: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        orderInfo: z.ZodOptional<z.ZodObject<{
+            orderId: z.ZodString;
+            side: z.ZodString;
+            size: z.ZodString;
+            priceUsd: z.ZodString;
+            totalPriceUsd: z.ZodString;
+            txHashes: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+    errorDetails: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        status: z.ZodOptional<z.ZodNumber>;
+        statusText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const PolymarketRedeemPositionsResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        success: z.ZodBoolean;
+        position: z.ZodObject<{
+            contractAddress: z.ZodString;
+            tokenId: z.ZodNullable<z.ZodString>;
+            decimals: z.ZodNumber;
+            conditionId: z.ZodString;
+            formattedShares: z.ZodString;
+            shares: z.ZodString;
+            valueUsd: z.ZodString;
+            question: z.ZodString;
+            outcome: z.ZodString;
+            priceUsd: z.ZodString;
+            averagePriceUsd: z.ZodString;
+            isRedeemable: z.ZodBoolean;
+            imageUrl: z.ZodString;
+            initialValue: z.ZodString;
+            pnlUsd: z.ZodString;
+            pnlPercent: z.ZodString;
+            pnlRealizedUsd: z.ZodString;
+            pnlRealizedPercent: z.ZodString;
+            endDate: z.ZodString;
+        }, z.core.$strip>;
+        transactionHash: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    error: z.ZodOptional<z.ZodString>;
+    errorDetails: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        status: z.ZodOptional<z.ZodNumber>;
+        statusText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type PolymarketPosition = z.infer<typeof PolymarketPositionSchema>;
+type PolymarketMarketOrderRequest = z.infer<typeof PolymarketMarketOrderRequestSchema>;
+type PolymarketRedeemPositionsRequest = z.infer<typeof PolymarketRedeemPositionsRequestSchema>;
+type PolymarketPositionsResponse = z.infer<typeof PolymarketPositionsResponseSchema>;
+type PolymarketMarketOrderResponse = z.infer<typeof PolymarketMarketOrderResponseSchema>;
+type PolymarketRedeemPositionsResponse = z.infer<typeof PolymarketRedeemPositionsResponseSchema>;
+
 /**
  * Main AgentSdk class with simplified API surface
  */
@@ -649,6 +809,208 @@ declare class AgentSdk {
          */
         execute: (executeQuote: SwidgeExecuteRequest) => Promise<SwidgeExecuteResponse>;
     };
+    /**
+     * 📈 Polymarket: Trade prediction markets seamlessly
+     *
+     * Access Polymarket positions, execute market orders, and redeem positions using your
+     * session wallet. All operations are policy-checked and signed automatically.
+     */
+    readonly polymarket: {
+        /**
+         * Get current positions on Polymarket
+         *
+         * Fetches all open positions for the session wallet, including value, PNL, and market details.
+         *
+         * @returns Wrapped response with positions array and total value
+         * @example
+         * // Usage
+         * const result = await sdk.polymarket.positions();
+         *
+         * if (result.success && result.data) {
+         *   console.log(`Total portfolio value: $${result.data.totalValue}`);
+         *   result.data.positions.forEach(pos => {
+         *     console.log(`${pos.question} - ${pos.outcome}: $${pos.valueUsd} (PNL: ${pos.pnlUsd})`);
+         *   });
+         * } else {
+         *   console.log(`Error: ${result.error}`);
+         * }
+         *
+         * // Input: None (GET request)
+         *
+         * // Output showcase (success case):
+         * {
+         *   success: true,
+         *   data: {
+         *     totalValue: 150.75,
+         *     positions: [
+         *       {
+         *         contractAddress: "0x...",
+         *         tokenId: "123456",
+         *         decimals: 6,
+         *         conditionId: "0x...",
+         *         formattedShares: "10.0",
+         *         shares: "10000000",
+         *         valueUsd: "10.5",
+         *         question: "Will event X happen?",
+         *         outcome: "Yes",
+         *         priceUsd: "1.05",
+         *         averagePriceUsd: "0.95",
+         *         isRedeemable: false,
+         *         imageUrl: "https://...",
+         *         initialValue: "9.5",
+         *         pnlUsd: "1.0",
+         *         pnlPercent: "10.53",
+         *         pnlRealizedUsd: "0",
+         *         pnlRealizedPercent: "0",
+         *         endDate: "2024-12-31"
+         *       },
+         *       // ... more positions
+         *     ]
+         *   }
+         * }
+         *
+         * // Error case:
+         * {
+         *   success: false,
+         *   error: "Could not get positions",
+         *   errorDetails: { message: "Wallet not found", status: 400 }
+         * }
+         */
+        positions: () => Promise<PolymarketPositionsResponse>;
+        /**
+         * Execute a market order on Polymarket
+         *
+         * Places a buy or sell market order for the specified token and size. Handles approvals,
+         * signing, and submission automatically.
+         *
+         * ⚠️ **Important**: The `size` parameter meaning differs by order side:
+         * - **BUY**: `size` is the USD amount to spend (e.g., 10 = $10 worth of shares)
+         * - **SELL**: `size` is the number of shares/tokens to sell (e.g., 10 = 10 shares)
+         *
+         * @param request Order parameters
+         * @param request.tokenId Market token ID for the position
+         * @param request.size For BUY: USD amount to spend. For SELL: Number of shares to sell
+         * @param request.side "BUY" or "SELL"
+         * @returns Wrapped response with order details and submission result
+         * @example
+         * // BUY order - size is USD amount
+         * const buyResult = await sdk.polymarket.marketOrder({
+         *   tokenId: "123456",
+         *   size: 10,        // Spend $10 to buy shares
+         *   side: "BUY"
+         * });
+         *
+         * // SELL order - size is number of shares
+         * const sellResult = await sdk.polymarket.marketOrder({
+         *   tokenId: "123456",
+         *   size: 5,         // Sell 5 shares
+         *   side: "SELL"
+         * });
+         *
+         * if (buyResult.success && buyResult.data) {
+         *   console.log(`Order ID: ${buyResult.data.submitOrder.orderId}`);
+         *   console.log(`Success: ${buyResult.data.submitOrder.success}`);
+         * } else {
+         *   console.log(`Error: ${buyResult.error}`);
+         * }
+         *
+         * // Input showcase:
+         * {
+         *   tokenId: "123456",  // Market token ID
+         *   size: 10,           // BUY: USD amount ($10) | SELL: Number of shares (10 shares)
+         *   side: "BUY"         // or "SELL"
+         * }
+         *
+         * // Output showcase (success case):
+         * {
+         *   success: true,
+         *   data: {
+         *     order: {
+         *       eip712Message: {
+         *         // Typed data for signing (domain, types, message)
+         *       },
+         *       order: {
+         *         salt: "123456789",
+         *         maker: "0x...",
+         *         signer: "0x...",
+         *         taker: "0x...",
+         *         tokenId: "123456",
+         *         makerAmount: "105000000", // USD amount in USDC decimals
+         *         takerAmount: "10000000",  // Shares in decimals
+         *         expiration: "0",
+         *         nonce: "0",
+         *         feeRateBps: "0",
+         *         side: 0,                 // 0 = BUY, 1 = SELL
+         *         signatureType: 0         // 0 = EIP712
+         *       }
+         *     },
+         *     submitOrder: {
+         *       orderId: "abc123",
+         *       success: true,
+         *       errorMessage: ""
+         *     }
+         *   }
+         * }
+         *
+         * // Error case:
+         * {
+         *   success: false,
+         *   error: "Could not get order",
+         *   errorDetails: { message: "Invalid request", status: 400 }
+         * }
+         */
+        marketOrder: (request: PolymarketMarketOrderRequest) => Promise<PolymarketMarketOrderResponse>;
+        /**
+         * Redeem settled positions on Polymarket
+         *
+         * Redeems one or all redeemable positions, claiming winnings. Handles multiple transactions if needed.
+         *
+         * @param request Redemption parameters (omit to redeem all, or pass tokenIds for specific positions)
+         * @returns Wrapped response with per-position redemption results
+         * @example
+         * // Redeem all positions (no arguments - default behavior)
+         * const allResult = await sdk.polymarket.redeemPositions();
+         *
+         * // Redeem specific positions
+         * const specificResult = await sdk.polymarket.redeemPositions({ tokenIds: ["123456", "789012"] });
+         *
+         * if (result.success && result.data) {
+         *   result.data.forEach(tx => {
+         *     if (tx.success) {
+         *       console.log(`Redeemed ${tx.position.question}: Tx ${tx.transactionHash}`);
+         *     }
+         *   });
+         * }
+         *
+         * // Input showcase:
+         * // No arguments - redeem all positions (default)
+         * // or
+         * { tokenIds: ["123456", "789012"] } // Redeem specific positions
+         *
+         * // Output showcase (success case):
+         * {
+         *   success: true,
+         *   data: [
+         *     {
+         *       success: true,
+         *       position: {
+         *         // Full position details as in positions response
+         *       },
+         *       transactionHash: "0xabc123..."
+         *     },
+         *     // ... more redemptions
+         *   ]
+         * }
+         *
+         * // Error case:
+         * {
+         *   success: false,
+         *   error: "Could not get positions",
+         *   errorDetails: { message: "No redeemable positions", status: 404 }
+         * }
+         */
+        redeemPositions: (request?: PolymarketRedeemPositionsRequest) => Promise<PolymarketRedeemPositionsResponse>;
+    };
     /**
      * Handle EVM transaction signing and broadcasting
      */
@@ -680,6 +1042,9 @@ declare class AgentSdk {
      * Handle swidge execute requests
      */
     private handleSwidgeExecute;
+    private handlePolymarketPositions;
+    private handlePolymarketMarketOrder;
+    private handlePolymarketRedeemPositions;
 }
 
 /**
@@ -954,4 +1319,4 @@ declare function isSolanaNetwork(network: Network): network is "solana";
  */
 declare function getChainIdFromNetwork(network: `ethereum:${number}`): number;
 
-export { APIClient, Agent, AgentSdk, type ExecutionFunctionContract, type Network, QUOTE_RESULT, type SDKConfig, type SignAndSendRequest, type SignAndSendResponse, type SignMessageRequest, type SignMessageResponse, type StopFunctionContract, type SwidgeExecuteResponse, type SwidgeQuoteRequest, type SwidgeQuoteResponse, type SwidgeQuoteResult, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork };
+export { APIClient, Agent, AgentSdk, type ExecutionFunctionContract, type Network, type PolymarketMarketOrderRequest, type PolymarketMarketOrderResponse, type PolymarketPosition, type PolymarketPositionsResponse, type PolymarketRedeemPositionsRequest, type PolymarketRedeemPositionsResponse, QUOTE_RESULT, type SDKConfig, type SignAndSendRequest, type SignAndSendResponse, type SignMessageRequest, type SignMessageResponse, type StopFunctionContract, type SwidgeExecuteResponse, type SwidgeQuoteRequest, type SwidgeQuoteResponse, type SwidgeQuoteResult, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork };

package/index.js

@@ -1 +1 @@
-var __getOwnPropNames=Object.getOwnPropertyNames,__require=(t=>"undefined"!=typeof require?require:"undefined"!=typeof Proxy?new Proxy(t,{get:(t,e)=>("undefined"!=typeof require?require:t)[e]}):t)(function(t){if("undefined"!=typeof require)return require.apply(this,arguments);throw Error('Dynamic require of "'+t+'" is not supported')}),__commonJS=(t,e)=>function(){return e||(0,t[__getOwnPropNames(t)[0]])((e={exports:{}}).exports,e),e.exports},require_auth_loader=__commonJS({"src/utils/auth-loader.cjs"(exports,module){function loadAuthFromFileSystem(){try{if("undefined"==typeof process)return;const fs=eval("require")("fs"),path=eval("require")("path"),os=eval("require")("os"),homeDir=os.homedir();let authPath=path.join(homeDir,".config","circuit","auth.json");if(!fs.existsSync(authPath)&&(authPath=path.join(homeDir,".circuit","auth.json"),!fs.existsSync(authPath)))return;const authContent=fs.readFileSync(authPath,"utf-8");return JSON.parse(authContent)}catch(t){return}}module.exports={loadAuthFromFileSystem:loadAuthFromFileSystem}}}),API_BASE_URL_LOCAL="https://agents.circuit.org",APIClient=class{config;baseUrl;isCloudflareWorker(){return"undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare}hasServiceBinding(){let t=!1;return this.isCloudflareWorker()&&(void 0!==globalThis.AGENTS_TO_API_PROXY||void 0!==globalThis.__AGENT_ENV__&&globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)&&(t=!0),this.config.verbose,t}constructor(t){this.config=t,this.baseUrl=t.baseUrl||API_BASE_URL_LOCAL}getAgentSlug(){return"undefined"!=typeof process&&process.env?.CIRCUIT_AGENT_SLUG?process.env.CIRCUIT_AGENT_SLUG:void 0!==globalThis.CIRCUIT_AGENT_SLUG?globalThis.CIRCUIT_AGENT_SLUG:void 0}getAuthHeaders(){const t={};t["X-Session-Id"]=this.config.sessionId.toString();const e=this.getAgentSlug();if(e&&(t["X-Agent-Slug"]=e),!this.hasServiceBinding())try{const e=this.loadAuthConfig();e?.sessionToken&&(t.Authorization=`Bearer ${e.sessionToken}`)}catch(t){}return t}loadAuthConfig(){try{const{loadAuthFromFileSystem:t}=require_auth_loader();return t()}catch(t){this.config.verbose}}logging(t,e){this.config.verbose}sanitizeHeaders(t){const e={},s=new Set(["report-to","server-timing","server"]),r=t&&"object"==typeof t?t:{};for(const[t,a]of Object.entries(r)){if("string"!=typeof a)continue;const r=t.toLowerCase();s.has(r)||(e[t]="authorization"===r?a.startsWith("Bearer ")?`Bearer ${a.slice(7,14)}***`:"***":a)}return e}async makeRequest(t,e={}){const s={...{"Content-Type":"application/json",...this.getAuthHeaders()},...e.headers};let r;if(this.logging("=== REQUEST DETAILS ==="),this.logging("Endpoint:",t),this.logging("Method:",e.method||"GET"),this.logging("Headers:",this.sanitizeHeaders(s)),this.logging("Body:",e.body),this.logging("Session ID:",this.config.sessionId),this.logging("Agent Slug:",this.getAgentSlug()||"not set"),this.logging("Using Service Binding:",this.hasServiceBinding()),this.logging("====================="),this.hasServiceBinding()){let a;if(void 0!==globalThis.AGENTS_TO_API_PROXY)a=globalThis.AGENTS_TO_API_PROXY;else{if(void 0===globalThis.__AGENT_ENV__||!globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)throw new Error("Service binding detected but not accessible");a=globalThis.__AGENT_ENV__.AGENTS_TO_API_PROXY}this.logging("Using service binding AGENTS_TO_API_PROXY"),this.logging("Service binding type:",typeof a);const i={...e,headers:s},o=`https://agents-to-api-proxy.circuit-0bc.workers.dev${t}`;r=await a.fetch(o,i)}else{this.logging("Using HTTP fallback to:",this.baseUrl);const a=`${this.baseUrl}${t}`,i={...e,headers:s};r=await fetch(a,i)}if(this.logging("=== RESPONSE DETAILS ==="),this.logging("Status:",r.status),this.logging("Status Text:",r.statusText),this.logging("Response Headers:",this.sanitizeHeaders(Object.fromEntries(r.headers.entries()))),this.logging("======================"),!r.ok){const t=await r.json().catch(()=>({}));throw this.logging("=== ERROR RESPONSE ==="),this.logging("Error Data:",t),this.logging("===================="),new Error(t.message||`HTTP ${r.status}: ${r.statusText}`)}const a=await r.json();return this.logging("=== SUCCESS RESPONSE ==="),this.logging("Response Data:",a),this.logging("======================"),a}async get(t){return this.makeRequest(t,{method:"GET"})}async post(t,e){return this.makeRequest(t,{method:"POST",body:e?JSON.stringify(e):void 0})}};function isEthereumNetwork(t){return t.startsWith("ethereum:")}function isSolanaNetwork(t){return"solana"===t}function getChainIdFromNetwork(t){return Number(t.split(":")[1])}var AgentSdk=class{client;config;constructor(t){this.config=t,this.client=new APIClient(t)}logging(t,e){this.config.verbose}async sendLog(t){this.logging("=== ADD MESSAGE ==="),this.logging("Message:",t),this.logging("===================");try{await this._sendLog([t])}catch(t){this.logging("=== SEND LOG ERROR ==="),this.logging("Error:",t),this.logging("======================")}}async signAndSend(t){this.logging("=== SIGN AND SEND ==="),this.logging("Request:",t),this.logging("Testing mode:",this.config.testing),this.logging("====================");try{if(this.config.testing)return{success:!0,internalTransactionId:123,txHash:isEthereumNetwork(t.network)?"0xTEST":"TEST_SOL_TX",transactionUrl:void 0};if(isEthereumNetwork(t.network)){const e=getChainIdFromNetwork(t.network);if("toAddress"in t.request)return await this.handleEvmTransaction({chainId:e,toAddress:t.request.toAddress,data:t.request.data,valueWei:t.request.value,message:t.message})}return isSolanaNetwork(t.network)&&"hexTransaction"in t.request?await this.handleSolanaTransaction({hexTransaction:t.request.hexTransaction,message:t.message}):{success:!1,error:`Unsupported network: ${t.network}`,errorDetails:{message:`Unsupported network: ${t.network}`}}}catch(t){return this.logging("=== SIGN AND SEND ERROR ==="),this.logging("Error:",t),this.logging("==========================="),{success:!1,error:t instanceof Error?t.message:"Unknown error",errorDetails:{message:t instanceof Error?t.message:"Unknown error"}}}}async signMessage(t){this.logging("=== SIGN MESSAGE ==="),this.logging("Request:",t),this.logging("Testing mode:",this.config.testing),this.logging("====================");try{return this.config.testing?{v:27,r:"0xTEST_R",s:"0xTEST_S",formattedSignature:"0xTEST_FORMATTED",type:"evm"}:isEthereumNetwork(t.network)?await this.handleEvmSignMessage(t):{v:0,r:"0x0",s:"0x0",formattedSignature:"0x0",type:"evm"}}catch(t){return this.logging("=== SIGN MESSAGE ERROR ==="),this.logging("Error:",t),this.logging("=========================="),{v:0,r:"0x0",s:"0x0",formattedSignature:"0x0",type:"evm"}}}swidge={quote:async t=>this.handleSwidgeQuote(t),execute:async t=>this.handleSwidgeExecute(t)};async handleEvmTransaction(t){try{const e=await this.client.post("/v1/transactions/evm",t),s=await this.client.post(`/v1/transactions/evm/${e.internalTransactionId}/broadcast`);return{success:!0,internalTransactionId:e.internalTransactionId,txHash:s.txHash,transactionUrl:s.transactionUrl}}catch(t){this.logging("=== EVM TRANSACTION ERROR ==="),this.logging("Error:",t),this.logging("=============================");let e,s,r,a="Unknown error";if(t instanceof Error){a=t.message;const i=t.message.match(/HTTP (\d+): (.+)/);i&&(e=Number.parseInt(i[1]),s=i[2]),t.message.includes("Failed to estimate gas")&&(r=t.message)}return{success:!1,error:a,errorDetails:{message:r||a,status:e,statusText:s}}}}async handleSolanaTransaction(t){try{const e=await this.client.post("/v1/transactions/solana",t),s=await this.client.post(`/v1/transactions/solana/${e.internalTransactionId}/broadcast`);return{success:!0,internalTransactionId:e.internalTransactionId,txHash:s.txHash,transactionUrl:s.transactionUrl}}catch(t){this.logging("=== SOLANA TRANSACTION ERROR ==="),this.logging("Error:",t),this.logging("================================");let e,s,r="Unknown error";if(t instanceof Error){r=t.message;const a=t.message.match(/HTTP (\d+): (.+)/);a&&(e=Number.parseInt(a[1]),s=a[2])}return{success:!1,error:r,errorDetails:{message:r,status:e,statusText:s}}}}async handleEvmSignMessage(t){try{return await this.client.post("/v1/messages/evm",{messageType:t.request.messageType,data:t.request.data,chainId:t.request.chainId})}catch(t){return this.logging("=== EVM SIGN MESSAGE ERROR ==="),this.logging("Error:",t),this.logging("=============================="),{v:0,r:"0x0",s:"0x0",formattedSignature:"0x0",type:"evm"}}}async _sendLog(t){return this.config.testing?{status:200,message:"Logs added successfully (TESTING)"}:this.client.post("/v1/logs",t)}async _updateJobStatus(t){if(this.logging("UPDATE_JOB_STATUS",t),this.config.testing)return{status:200,message:"Job status updated successfully (TESTING)"};try{return await this.client.post(`/v1/jobs/${t.jobId}/status`,t)}catch(t){return this.logging("=== UPDATE JOB STATUS ERROR ==="),this.logging("Error:",t),this.logging("==============================="),{status:400,message:`Failed to update job status: ${t instanceof Error?t.message:"Unknown error"}`}}}async handleSwidgeQuote(t){this.logging("=== SWIDGE QUOTE ==="),this.logging("Request:",t),this.logging("Testing mode:",this.config.testing),this.logging("===================");try{return this.config.testing?{success:!0,data:{engine:"relay",assetSend:{network:t.from.network,address:t.from.address,token:t.fromToken||null,amount:t.amount,amountFormatted:"1.0",amountUsd:"100.00"},assetReceive:{network:t.to.network,address:t.to.address,token:t.toToken||null,amount:"950000000000000000",amountFormatted:"0.95",amountUsd:"95.00"},priceImpact:{percentage:"0.5",usd:"5.00"},fees:[{name:"gas",amount:"21000000000000000",amountFormatted:"0.021",amountUsd:"2.10"}],steps:[{type:"transaction",description:"Test swap transaction",transactionDetails:{type:"evm",from:"0xtest",to:"0xtest",chainId:1,value:0,data:"0x",gas:21e3,maxFeePerGas:2e10,maxPriorityFeePerGas:1e9},metadata:{requestId:"test-request-id"}}]}}:{success:!0,data:await this.client.post("/v1/swidge/quote",t)}}catch(t){this.logging("=== SWIDGE QUOTE ERROR ==="),this.logging("Error:",t),this.logging("=========================");let e,s,r="Failed to get swidge quote";if(t instanceof Error){r=t.message;const a=t.message.match(/HTTP (\d+): (.+)/);a&&(e=Number.parseInt(a[1]),s=a[2])}return{success:!1,error:r,errorDetails:{message:r,status:e,statusText:s}}}}async handleSwidgeExecute(t){this.logging("=== SWIDGE EXECUTE ==="),this.logging("Quote:",t),this.logging("Testing mode:",this.config.testing),this.logging("=====================");try{if(this.config.testing)return{success:!0,data:{status:"success",in:{network:t.assetSend.network,txs:["0xtest_in_tx"]},out:{network:t.assetReceive.network,txs:["0xtest_out_tx"]},lastUpdated:Date.now()}};this.logging("Making execute request to /v1/swidge/execute");const e=await this.client.post("/v1/swidge/execute",t);return this.logging("Execute response received:",JSON.stringify(e,null,2)),{success:!0,data:e}}catch(t){this.logging("=== SWIDGE EXECUTE ERROR ==="),this.logging("Error:",t),this.logging("============================");let e,s,r="Failed to execute swidge swap";if(t instanceof Error){r=t.message;const a=t.message.match(/HTTP (\d+): (.+)/);a&&(e=Number.parseInt(a[1]),s=a[2])}return{success:!1,error:r,errorDetails:{message:r,status:e,statusText:s}}}}};import{zValidator}from"@hono/zod-validator";import{Hono}from"hono";import{cors}from"hono/cors";import{z}from"zod";var AgentRequestSchema=z.object({sessionId:z.number(),sessionWalletAddress:z.string(),jobId:z.string().optional(),otherParameters:z.object().optional()}),AgentResponseSchema=z.object({success:z.boolean(),error:z.string().optional(),message:z.string().optional()}),HealthResponseSchema=z.object({status:z.string()}),Agent=class{app;executionFunction;stopFunction;healthCheckFunction;constructor(t){this.app=new Hono,this.executionFunction=t.executionFunction,this.stopFunction=t.stopFunction,this.healthCheckFunction=t.healthCheckFunction||(async()=>({status:"healthy"})),this.app.use("*",cors()),this.setupRoutes()}defaultStopFunction=async t=>({success:!0,message:`Agent stopped for session ${t.sessionId}`});async executeWithJobTracking(t,e){try{const s=await e(t);if(t.jobId&&s.success)try{await this.updateJobStatus(t.sessionId,t.jobId,"success")}catch(t){}else if(t.jobId&&!s.success)try{const e=s.error||s.message||"Function returned failure";await this.updateJobStatus(t.sessionId,t.jobId,"failed",e)}catch(t){}return s}catch(e){if(t.jobId)try{const s=e instanceof Error?e.message:"Unknown error";await this.updateJobStatus(t.sessionId,t.jobId,"failed",s)}catch(t){}return{success:!1,error:e instanceof Error?e.message:"Unknown error",message:"Function execution failed"}}}async updateJobStatus(t,e,s,r){try{const a=new AgentSdk({sessionId:t}),i={jobId:e,status:s,...r&&{errorMessage:r}};await a._updateJobStatus(i)}catch(t){}}setupRoutes(){this.app.post("/execute",zValidator("json",AgentRequestSchema),async t=>{try{const e=t.req.valid("json"),s=await this.executeWithJobTracking(e,this.executionFunction);return t.json(s)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:"Unknown error",message:"Execution failed"},500)}}),this.app.post("/stop",zValidator("json",AgentRequestSchema),async t=>{try{const e=t.req.valid("json"),s=this.stopFunction||this.defaultStopFunction,r=await this.executeWithJobTracking(e,s);return t.json(r)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:"Unknown error",message:"Stop operation failed"},500)}}),this.app.get("/health",async t=>{try{const e=await(this.healthCheckFunction?.());return t.json(e)}catch(e){return t.json({status:"unhealthy",error:e instanceof Error?e.message:"Unknown error",timestamp:(new Date).toISOString()},500)}})}getPortFromPackageJson(){try{const t=__require("fs"),e=__require("path").join(process.cwd(),"package.json");if(t.existsSync(e)){const s=JSON.parse(t.readFileSync(e,"utf-8"));if(s.circuit?.port)return Number.parseInt(s.circuit.port,10)}}catch(t){}return null}run(port){const isCloudflareWorker="undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare;if(isCloudflareWorker)return this.getWorkerExport();const bunEnv=globalThis.Bun?.env,envPort=process.env.AGENT_PORT||bunEnv?.AGENT_PORT,packageJsonPort=this.getPortFromPackageJson();let finalPort=port;!finalPort&&envPort&&(finalPort=Number.parseInt(envPort,10)),!finalPort&&packageJsonPort&&(finalPort=packageJsonPort),finalPort||(finalPort=3e3);try{const req=eval("require"),{serve:serve}=req("@hono/node-server");serve({fetch:this.app.fetch,port:finalPort})}catch(t){process.exit(1)}}getWorkerExport(){return{fetch:async(t,e,s)=>(e&&"undefined"!=typeof globalThis&&(globalThis.__AGENT_ENV__=e),this.app.fetch(t,e,s))}}};function createAgentHandler(t,e,s){return new Agent({executionFunction:t,stopFunction:e,healthCheckFunction:s})}import{z as z2}from"zod";var zEthereumNetwork=z2.templateLiteral(["ethereum:",z2.coerce.number().int().nonnegative()]),SwidgeNetworkSchema=z2.union([z2.literal("solana"),zEthereumNetwork]),SwidgeWalletSchema=z2.object({address:z2.string(),network:SwidgeNetworkSchema}),SwidgeQuoteRequestSchema=z2.object({from:SwidgeWalletSchema,to:SwidgeWalletSchema,fromToken:z2.string().optional(),toToken:z2.string().optional(),amount:z2.string(),priceImpact:z2.string().optional(),slippage:z2.string().optional()}),SwidgeQuoteAssetSchema=z2.object({network:SwidgeNetworkSchema,address:z2.string(),token:z2.string().nullable(),name:z2.string().optional(),symbol:z2.string().optional(),decimals:z2.number().optional(),amount:z2.string().optional(),minimumAmount:z2.string().optional(),amountFormatted:z2.string().optional(),amountUsd:z2.string().optional()}),SwidgePriceImpactSchema=z2.object({usd:z2.string().optional(),percentage:z2.string().optional()}),SwidgeFeeSchema=z2.object({name:z2.string(),amount:z2.string().optional(),amountFormatted:z2.string().optional(),amountUsd:z2.string().optional()}),SwidgeSolanaInstructionSchema=z2.object({programId:z2.string(),keys:z2.array(z2.object({pubkey:z2.string(),isSigner:z2.boolean(),isWritable:z2.boolean()})),data:z2.union([z2.string(),z2.instanceof(Buffer)])}),SwidgeEvmTransactionDetailsSchema=z2.object({type:z2.literal("evm"),from:z2.string().regex(/^0x[a-fA-F0-9]{40}$/),to:z2.string().regex(/^0x[a-fA-F0-9]{40}$/),chainId:z2.number(),value:z2.number(),data:z2.string().regex(/^0x[a-fA-F0-9]*$/),gas:z2.number(),maxFeePerGas:z2.number(),maxPriorityFeePerGas:z2.number()}),SwidgeSolanaTransactionDetailsSchema=z2.object({type:z2.literal("solana"),instructions:z2.array(SwidgeSolanaInstructionSchema),addressLookupTableAddresses:z2.array(z2.string())}),zTransactionStep=z2.object({type:z2.literal("transaction"),description:z2.string(),transactionDetails:z2.union([SwidgeEvmTransactionDetailsSchema,SwidgeSolanaTransactionDetailsSchema]),metadata:z2.record(z2.string(),z2.string())}),zUnsignedSignatureStep=z2.object({type:z2.literal("signature"),description:z2.string(),signatureData:z2.string(),metadata:z2.record(z2.string(),z2.string())}),SwidgeUnsignedStepSchema=z2.discriminatedUnion("type",[zTransactionStep,zUnsignedSignatureStep]),SwidgeQuoteDataSchema=z2.object({engine:z2.literal("relay"),assetSend:SwidgeQuoteAssetSchema,assetReceive:SwidgeQuoteAssetSchema,priceImpact:SwidgePriceImpactSchema,fees:z2.array(SwidgeFeeSchema),steps:z2.array(SwidgeUnsignedStepSchema)}),SwidgeStatusInfoSchema=z2.object({network:z2.string(),txs:z2.array(z2.string())}),SwidgeExecuteResponseSchema=z2.object({status:z2.union([z2.literal("success"),z2.literal("failure"),z2.literal("refund"),z2.literal("delayed")]),in:SwidgeStatusInfoSchema,out:SwidgeStatusInfoSchema,lastUpdated:z2.number()}),QUOTE_RESULT={FOUND:"QUOTE_FOUND",NO_QUOTE_PROVIDED:"No quote provided",WALLET_NOT_FOUND:"Wallet not found",WALLET_MISMATCH:"From wallet does not match session wallet",PRICE_IMPACT_TOO_HIGH:"Failed to get quote. Error: Price impact is too high",NO_ROUTES_FOUND:"Failed to get quote. Error: no routes found",AMOUNT_TOO_SMALL:"Failed to get quote. APIError: Swap output amount is too small to cover fees required to execute swap"},SwidgeSDKResponseSchema=t=>z2.object({success:z2.boolean(),data:t.optional(),error:z2.string().optional(),errorDetails:z2.object({message:z2.string(),status:z2.number().optional(),statusText:z2.string().optional()}).optional()}),SwidgeQuoteResponseWrapperSchema=SwidgeSDKResponseSchema(SwidgeQuoteDataSchema),SwidgeExecuteResponseWrapperSchema=SwidgeSDKResponseSchema(SwidgeExecuteResponseSchema);export{APIClient,Agent,AgentSdk,QUOTE_RESULT,getChainIdFromNetwork,isEthereumNetwork,isSolanaNetwork};
+var __getOwnPropNames=Object.getOwnPropertyNames,__require=(t=>"undefined"!=typeof require?require:"undefined"!=typeof Proxy?new Proxy(t,{get:(t,e)=>("undefined"!=typeof require?require:t)[e]}):t)(function(t){if("undefined"!=typeof require)return require.apply(this,arguments);throw Error('Dynamic require of "'+t+'" is not supported')}),__commonJS=(t,e)=>function(){return e||(0,t[__getOwnPropNames(t)[0]])((e={exports:{}}).exports,e),e.exports},require_auth_loader=__commonJS({"src/utils/auth-loader.cjs"(exports,module){function loadAuthFromFileSystem(){try{if("undefined"==typeof process)return;const fs=eval("require")("fs"),path=eval("require")("path"),os=eval("require")("os"),homeDir=os.homedir();let authPath=path.join(homeDir,".config","circuit","auth.json");if(!fs.existsSync(authPath)&&(authPath=path.join(homeDir,".circuit","auth.json"),!fs.existsSync(authPath)))return;const authContent=fs.readFileSync(authPath,"utf-8");return JSON.parse(authContent)}catch(t){return}}module.exports={loadAuthFromFileSystem:loadAuthFromFileSystem}}}),API_BASE_URL_LOCAL="https://agents.circuit.org",APIClient=class{config;baseUrl;isCloudflareWorker(){return"undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare}hasServiceBinding(){let t=!1;return this.isCloudflareWorker()&&(void 0!==globalThis.AGENTS_TO_API_PROXY||void 0!==globalThis.__AGENT_ENV__&&globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)&&(t=!0),this.config.verbose,t}constructor(t){this.config=t,this.baseUrl=t.baseUrl||API_BASE_URL_LOCAL}getAgentSlug(){return"undefined"!=typeof process&&process.env?.CIRCUIT_AGENT_SLUG?process.env.CIRCUIT_AGENT_SLUG:void 0!==globalThis.CIRCUIT_AGENT_SLUG?globalThis.CIRCUIT_AGENT_SLUG:void 0}getAuthHeaders(){const t={};t["X-Session-Id"]=this.config.sessionId.toString();const e=this.getAgentSlug();if(e&&(t["X-Agent-Slug"]=e),!this.hasServiceBinding())try{const e=this.loadAuthConfig();e?.sessionToken&&(t.Authorization=`Bearer ${e.sessionToken}`)}catch(t){}return t}loadAuthConfig(){try{const{loadAuthFromFileSystem:t}=require_auth_loader();return t()}catch(t){this.config.verbose}}logging(t,e){this.config.verbose}sanitizeHeaders(t){const e={},s=new Set(["report-to","server-timing","server"]),r=t&&"object"==typeof t?t:{};for(const[t,a]of Object.entries(r)){if("string"!=typeof a)continue;const r=t.toLowerCase();s.has(r)||(e[t]="authorization"===r?a.startsWith("Bearer ")?`Bearer ${a.slice(7,14)}***`:"***":a)}return e}async makeRequest(t,e={}){const s={...{"Content-Type":"application/json",...this.getAuthHeaders()},...e.headers};let r;if(this.logging("=== REQUEST DETAILS ==="),this.logging("Endpoint:",t),this.logging("Method:",e.method||"GET"),this.logging("Headers:",this.sanitizeHeaders(s)),this.logging("Body:",e.body),this.logging("Session ID:",this.config.sessionId),this.logging("Agent Slug:",this.getAgentSlug()||"not set"),this.logging("Using Service Binding:",this.hasServiceBinding()),this.logging("====================="),this.hasServiceBinding()){let a;if(void 0!==globalThis.AGENTS_TO_API_PROXY)a=globalThis.AGENTS_TO_API_PROXY;else{if(void 0===globalThis.__AGENT_ENV__||!globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)throw new Error("Service binding detected but not accessible");a=globalThis.__AGENT_ENV__.AGENTS_TO_API_PROXY}this.logging("Using service binding AGENTS_TO_API_PROXY"),this.logging("Service binding type:",typeof a);const i={...e,headers:s},o=`https://agents-to-api-proxy.circuit-0bc.workers.dev${t}`;r=await a.fetch(o,i)}else{this.logging("Using HTTP fallback to:",this.baseUrl);const a=`${this.baseUrl}${t}`,i={...e,headers:s};r=await fetch(a,i)}if(this.logging("=== RESPONSE DETAILS ==="),this.logging("Status:",r.status),this.logging("Status Text:",r.statusText),this.logging("Response Headers:",this.sanitizeHeaders(Object.fromEntries(r.headers.entries()))),this.logging("======================"),!r.ok){const t=await r.json().catch(()=>({}));throw this.logging("=== ERROR RESPONSE ==="),this.logging("Error Data:",t),this.logging("===================="),new Error(t.error||t.message||`HTTP ${r.status}: ${r.statusText}`)}const a=await r.json();return this.logging("=== SUCCESS RESPONSE ==="),this.logging("Response Data:",a),this.logging("======================"),a}async get(t){return this.makeRequest(t,{method:"GET"})}async post(t,e){return this.makeRequest(t,{method:"POST",body:e?JSON.stringify(e):void 0})}};function isEthereumNetwork(t){return t.startsWith("ethereum:")}function isSolanaNetwork(t){return"solana"===t}function getChainIdFromNetwork(t){return Number(t.split(":")[1])}var AgentSdk=class{client;config;constructor(t){this.config=t,this.client=new APIClient(t)}logging(t,e){this.config.verbose}async sendLog(t){this.logging("=== ADD MESSAGE ==="),this.logging("Message:",t),this.logging("===================");try{await this._sendLog([t])}catch(t){this.logging("=== SEND LOG ERROR ==="),this.logging("Error:",t),this.logging("======================")}}async signAndSend(t){this.logging("=== SIGN AND SEND ==="),this.logging("Request:",t),this.logging("Testing mode:",this.config.testing),this.logging("====================");try{if(this.config.testing)return{success:!0,internalTransactionId:123,txHash:isEthereumNetwork(t.network)?"0xTEST":"TEST_SOL_TX",transactionUrl:void 0};if(isEthereumNetwork(t.network)){const e=getChainIdFromNetwork(t.network);if("toAddress"in t.request)return await this.handleEvmTransaction({chainId:e,toAddress:t.request.toAddress,data:t.request.data,valueWei:t.request.value,message:t.message})}return isSolanaNetwork(t.network)&&"hexTransaction"in t.request?await this.handleSolanaTransaction({hexTransaction:t.request.hexTransaction,message:t.message}):{success:!1,error:`Unsupported network: ${t.network}`,errorDetails:{message:`Unsupported network: ${t.network}`}}}catch(t){return this.logging("=== SIGN AND SEND ERROR ==="),this.logging("Error:",t),this.logging("==========================="),{success:!1,error:t instanceof Error?t.message:"Unknown error",errorDetails:{message:t instanceof Error?t.message:"Unknown error"}}}}async signMessage(t){this.logging("=== SIGN MESSAGE ==="),this.logging("Request:",t),this.logging("Testing mode:",this.config.testing),this.logging("====================");try{return this.config.testing?{v:27,r:"0xTEST_R",s:"0xTEST_S",formattedSignature:"0xTEST_FORMATTED",type:"evm"}:isEthereumNetwork(t.network)?await this.handleEvmSignMessage(t):{v:0,r:"0x0",s:"0x0",formattedSignature:"0x0",type:"evm"}}catch(t){return this.logging("=== SIGN MESSAGE ERROR ==="),this.logging("Error:",t),this.logging("=========================="),{v:0,r:"0x0",s:"0x0",formattedSignature:"0x0",type:"evm"}}}swidge={quote:async t=>this.handleSwidgeQuote(t),execute:async t=>this.handleSwidgeExecute(t)};polymarket={positions:async()=>this.handlePolymarketPositions(),marketOrder:async t=>this.handlePolymarketMarketOrder(t),redeemPositions:async t=>this.handlePolymarketRedeemPositions(t||{tokenIds:[]})};async handleEvmTransaction(t){try{const e=await this.client.post("/v1/transactions/evm",t),s=await this.client.post(`/v1/transactions/evm/${e.internalTransactionId}/broadcast`);return{success:!0,internalTransactionId:e.internalTransactionId,txHash:s.txHash,transactionUrl:s.transactionUrl}}catch(t){this.logging("=== EVM TRANSACTION ERROR ==="),this.logging("Error:",t),this.logging("=============================");let e,s,r,a="Unknown error";if(t instanceof Error){a=t.message;const i=t.message.match(/HTTP (\d+): (.+)/);i&&(e=Number.parseInt(i[1]),s=i[2]),t.message.includes("Failed to estimate gas")&&(r=t.message)}return{success:!1,error:a,errorDetails:{message:r||a,status:e,statusText:s}}}}async handleSolanaTransaction(t){try{const e=await this.client.post("/v1/transactions/solana",t),s=await this.client.post(`/v1/transactions/solana/${e.internalTransactionId}/broadcast`);return{success:!0,internalTransactionId:e.internalTransactionId,txHash:s.txHash,transactionUrl:s.transactionUrl}}catch(t){this.logging("=== SOLANA TRANSACTION ERROR ==="),this.logging("Error:",t),this.logging("================================");let e,s,r="Unknown error";if(t instanceof Error){r=t.message;const a=t.message.match(/HTTP (\d+): (.+)/);a&&(e=Number.parseInt(a[1]),s=a[2])}return{success:!1,error:r,errorDetails:{message:r,status:e,statusText:s}}}}async handleEvmSignMessage(t){try{return await this.client.post("/v1/messages/evm",{messageType:t.request.messageType,data:t.request.data,chainId:t.request.chainId})}catch(t){return this.logging("=== EVM SIGN MESSAGE ERROR ==="),this.logging("Error:",t),this.logging("=============================="),{v:0,r:"0x0",s:"0x0",formattedSignature:"0x0",type:"evm"}}}async _sendLog(t){return this.config.testing?{status:200,message:"Logs added successfully (TESTING)"}:this.client.post("/v1/logs",t)}async _updateJobStatus(t){if(this.logging("UPDATE_JOB_STATUS",t),this.config.testing)return{status:200,message:"Job status updated successfully (TESTING)"};try{return await this.client.post(`/v1/jobs/${t.jobId}/status`,t)}catch(t){return this.logging("=== UPDATE JOB STATUS ERROR ==="),this.logging("Error:",t),this.logging("==============================="),{status:400,message:`Failed to update job status: ${t instanceof Error?t.message:"Unknown error"}`}}}async handleSwidgeQuote(t){this.logging("=== SWIDGE QUOTE ==="),this.logging("Request:",t),this.logging("Testing mode:",this.config.testing),this.logging("===================");try{return this.config.testing?{success:!0,data:{engine:"relay",assetSend:{network:t.from.network,address:t.from.address,token:t.fromToken||null,amount:t.amount,amountFormatted:"1.0",amountUsd:"100.00"},assetReceive:{network:t.to.network,address:t.to.address,token:t.toToken||null,amount:"950000000000000000",amountFormatted:"0.95",amountUsd:"95.00"},priceImpact:{percentage:"0.5",usd:"5.00"},fees:[{name:"gas",amount:"21000000000000000",amountFormatted:"0.021",amountUsd:"2.10"}],steps:[{type:"transaction",description:"Test swap transaction",transactionDetails:{type:"evm",from:"0xtest",to:"0xtest",chainId:1,value:0,data:"0x",gas:21e3,maxFeePerGas:2e10,maxPriorityFeePerGas:1e9},metadata:{requestId:"test-request-id"}}]}}:{success:!0,data:await this.client.post("/v1/swidge/quote",t)}}catch(t){this.logging("=== SWIDGE QUOTE ERROR ==="),this.logging("Error:",t),this.logging("=========================");let e,s,r="Failed to get swidge quote";if(t instanceof Error){r=t.message;const a=t.message.match(/HTTP (\d+): (.+)/);a&&(e=Number.parseInt(a[1]),s=a[2])}return{success:!1,error:r,errorDetails:{message:r,status:e,statusText:s}}}}async handleSwidgeExecute(t){this.logging("=== SWIDGE EXECUTE ==="),this.logging("Quote:",t),this.logging("Testing mode:",this.config.testing),this.logging("=====================");try{if(this.config.testing)return{success:!0,data:{status:"success",in:{network:t.assetSend.network,txs:["0xtest_in_tx"]},out:{network:t.assetReceive.network,txs:["0xtest_out_tx"]},lastUpdated:Date.now()}};this.logging("Making execute request to /v1/swidge/execute");const e=await this.client.post("/v1/swidge/execute",t);return this.logging("Execute response received:",JSON.stringify(e,null,2)),{success:!0,data:e}}catch(t){this.logging("=== SWIDGE EXECUTE ERROR ==="),this.logging("Error:",t),this.logging("============================");let e,s,r="Failed to execute swidge swap";if(t instanceof Error){r=t.message;const a=t.message.match(/HTTP (\d+): (.+)/);a&&(e=Number.parseInt(a[1]),s=a[2])}return{success:!1,error:r,errorDetails:{message:r,status:e,statusText:s}}}}async handlePolymarketPositions(){this.logging("=== POLYMARKET POSITIONS ==="),this.logging("Testing mode:",this.config.testing),this.logging("===========================");try{return this.config.testing?{success:!0,data:{totalValue:0,positions:[]}}:{success:!0,data:await this.client.get("/v1/platforms/polymarket/positions")}}catch(t){this.logging("=== POLYMARKET POSITIONS ERROR ==="),this.logging("Error:",t),this.logging("=================================");let e,s,r="Failed to get polymarket positions";if(t instanceof Error){r=t.message;const a=t.message.match(/HTTP (\d+): (.+)/);a&&(e=Number.parseInt(a[1]),s=a[2])}return{success:!1,error:r,errorDetails:{message:r,status:e,statusText:s}}}}async handlePolymarketMarketOrder(t){this.logging("=== POLYMARKET MARKET ORDER ==="),this.logging("Request:",t),this.logging("Testing mode:",this.config.testing),this.logging("==============================");try{return this.config.testing?{success:!0,data:{order:{eip712Message:{types:{},domain:{name:"test",version:"1",chainId:137,verifyingContract:"0x0000000000000000000000000000000000000000"},primaryType:"Order",message:{}},order:{salt:"0",maker:"0x0000000000000000000000000000000000000000",signer:"0x0000000000000000000000000000000000000000",taker:"0x0000000000000000000000000000000000000000",tokenId:"test-token-id",makerAmount:"0",takerAmount:"0",expiration:"0",nonce:"0",feeRateBps:"0",side:0,signatureType:0}},submitOrder:{orderId:"test-order-id",success:!0}}}:{success:!0,data:await this.client.post("/v1/platforms/polymarket/market-order",t)}}catch(t){this.logging("=== POLYMARKET MARKET ORDER ERROR ==="),this.logging("Error:",t),this.logging("====================================");let e,s,r="Failed to execute polymarket market order";if(t instanceof Error){r=t.message;const a=t.message.match(/HTTP (\d+): (.+)/);a&&(e=Number.parseInt(a[1]),s=a[2])}return{success:!1,error:r,errorDetails:{message:r,status:e,statusText:s}}}}async handlePolymarketRedeemPositions(t){this.logging("=== POLYMARKET REDEEM POSITIONS ==="),this.logging("Request:",t),this.logging("Testing mode:",this.config.testing),this.logging("==================================");try{return this.config.testing?{success:!0,data:[]}:{success:!0,data:await this.client.post("/v1/platforms/polymarket/redeem-positions",t)}}catch(t){this.logging("=== POLYMARKET REDEEM POSITIONS ERROR ==="),this.logging("Error:",t),this.logging("========================================");let e,s,r="Failed to redeem polymarket positions";if(t instanceof Error){r=t.message;const a=t.message.match(/HTTP (\d+): (.+)/);a&&(e=Number.parseInt(a[1]),s=a[2])}return{success:!1,error:r,errorDetails:{message:r,status:e,statusText:s}}}}};import{zValidator}from"@hono/zod-validator";import{Hono}from"hono";import{cors}from"hono/cors";import{z}from"zod";var AgentRequestSchema=z.object({sessionId:z.number(),sessionWalletAddress:z.string(),jobId:z.string().optional(),otherParameters:z.object().optional()}),AgentResponseSchema=z.object({success:z.boolean(),error:z.string().optional(),message:z.string().optional()}),HealthResponseSchema=z.object({status:z.string()}),Agent=class{app;executionFunction;stopFunction;healthCheckFunction;constructor(t){this.app=new Hono,this.executionFunction=t.executionFunction,this.stopFunction=t.stopFunction,this.healthCheckFunction=t.healthCheckFunction||(async()=>({status:"healthy"})),this.app.use("*",cors()),this.setupRoutes()}defaultStopFunction=async t=>({success:!0,message:`Agent stopped for session ${t.sessionId}`});async executeWithJobTracking(t,e){try{const s=await e(t);if(t.jobId&&s.success)try{await this.updateJobStatus(t.sessionId,t.jobId,"success")}catch(t){}else if(t.jobId&&!s.success)try{const e=s.error||s.message||"Function returned failure";await this.updateJobStatus(t.sessionId,t.jobId,"failed",e)}catch(t){}return s}catch(e){if(t.jobId)try{const s=e instanceof Error?e.message:"Unknown error";await this.updateJobStatus(t.sessionId,t.jobId,"failed",s)}catch(t){}return{success:!1,error:e instanceof Error?e.message:"Unknown error",message:"Function execution failed"}}}async updateJobStatus(t,e,s,r){try{const a=new AgentSdk({sessionId:t}),i={jobId:e,status:s,...r&&{errorMessage:r}};await a._updateJobStatus(i)}catch(t){}}setupRoutes(){this.app.post("/execute",zValidator("json",AgentRequestSchema),async t=>{try{const e=t.req.valid("json"),s=await this.executeWithJobTracking(e,this.executionFunction);return t.json(s)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:"Unknown error",message:"Execution failed"},500)}}),this.app.post("/stop",zValidator("json",AgentRequestSchema),async t=>{try{const e=t.req.valid("json"),s=this.stopFunction||this.defaultStopFunction,r=await this.executeWithJobTracking(e,s);return t.json(r)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:"Unknown error",message:"Stop operation failed"},500)}}),this.app.get("/health",async t=>{try{const e=await(this.healthCheckFunction?.());return t.json(e)}catch(e){return t.json({status:"unhealthy",error:e instanceof Error?e.message:"Unknown error",timestamp:(new Date).toISOString()},500)}})}getPortFromPackageJson(){try{const t=__require("fs"),e=__require("path").join(process.cwd(),"package.json");if(t.existsSync(e)){const s=JSON.parse(t.readFileSync(e,"utf-8"));if(s.circuit?.port)return Number.parseInt(s.circuit.port,10)}}catch(t){}return null}run(port){const isCloudflareWorker="undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare;if(isCloudflareWorker)return this.getWorkerExport();const bunEnv=globalThis.Bun?.env,envPort=process.env.AGENT_PORT||bunEnv?.AGENT_PORT,packageJsonPort=this.getPortFromPackageJson();let finalPort=port;!finalPort&&envPort&&(finalPort=Number.parseInt(envPort,10)),!finalPort&&packageJsonPort&&(finalPort=packageJsonPort),finalPort||(finalPort=3e3);try{const req=eval("require"),{serve:serve}=req("@hono/node-server");serve({fetch:this.app.fetch,port:finalPort})}catch(t){process.exit(1)}}getWorkerExport(){return{fetch:async(t,e,s)=>(e&&"undefined"!=typeof globalThis&&(globalThis.__AGENT_ENV__=e),this.app.fetch(t,e,s))}}};function createAgentHandler(t,e,s){return new Agent({executionFunction:t,stopFunction:e,healthCheckFunction:s})}import{z as z2}from"zod";var zEthereumNetwork=z2.templateLiteral(["ethereum:",z2.coerce.number().int().nonnegative()]),SwidgeNetworkSchema=z2.union([z2.literal("solana"),zEthereumNetwork]),SwidgeWalletSchema=z2.object({address:z2.string(),network:SwidgeNetworkSchema}),SwidgeQuoteRequestSchema=z2.object({from:SwidgeWalletSchema,to:SwidgeWalletSchema,fromToken:z2.string().optional(),toToken:z2.string().optional(),amount:z2.string(),priceImpact:z2.string().optional(),slippage:z2.string().optional()}),SwidgeQuoteAssetSchema=z2.object({network:SwidgeNetworkSchema,address:z2.string(),token:z2.string().nullable(),name:z2.string().optional(),symbol:z2.string().optional(),decimals:z2.number().optional(),amount:z2.string().optional(),minimumAmount:z2.string().optional(),amountFormatted:z2.string().optional(),amountUsd:z2.string().optional()}),SwidgePriceImpactSchema=z2.object({usd:z2.string().optional(),percentage:z2.string().optional()}),SwidgeFeeSchema=z2.object({name:z2.string(),amount:z2.string().optional(),amountFormatted:z2.string().optional(),amountUsd:z2.string().optional()}),SwidgeSolanaInstructionSchema=z2.object({programId:z2.string(),keys:z2.array(z2.object({pubkey:z2.string(),isSigner:z2.boolean(),isWritable:z2.boolean()})),data:z2.union([z2.string(),z2.instanceof(Buffer)])}),SwidgeEvmTransactionDetailsSchema=z2.object({type:z2.literal("evm"),from:z2.string().regex(/^0x[a-fA-F0-9]{40}$/),to:z2.string().regex(/^0x[a-fA-F0-9]{40}$/),chainId:z2.number(),value:z2.number(),data:z2.string().regex(/^0x[a-fA-F0-9]*$/),gas:z2.number().optional(),maxFeePerGas:z2.number().optional(),maxPriorityFeePerGas:z2.number().optional()}),SwidgeSolanaTransactionDetailsSchema=z2.object({type:z2.literal("solana"),instructions:z2.array(SwidgeSolanaInstructionSchema),addressLookupTableAddresses:z2.array(z2.string())}),zTransactionStep=z2.object({type:z2.literal("transaction"),description:z2.string(),transactionDetails:z2.union([SwidgeEvmTransactionDetailsSchema,SwidgeSolanaTransactionDetailsSchema]),metadata:z2.record(z2.string(),z2.string())}),zUnsignedSignatureStep=z2.object({type:z2.literal("signature"),description:z2.string(),signatureData:z2.string(),metadata:z2.record(z2.string(),z2.string())}),SwidgeUnsignedStepSchema=z2.discriminatedUnion("type",[zTransactionStep,zUnsignedSignatureStep]),SwidgeQuoteDataSchema=z2.object({engine:z2.literal("relay"),assetSend:SwidgeQuoteAssetSchema,assetReceive:SwidgeQuoteAssetSchema,priceImpact:SwidgePriceImpactSchema,fees:z2.array(SwidgeFeeSchema),steps:z2.array(SwidgeUnsignedStepSchema)}),SwidgeStatusInfoSchema=z2.object({network:z2.string(),txs:z2.array(z2.string())}),SwidgeExecuteResponseSchema=z2.object({status:z2.union([z2.literal("success"),z2.literal("failure"),z2.literal("refund"),z2.literal("delayed")]),in:SwidgeStatusInfoSchema,out:SwidgeStatusInfoSchema,lastUpdated:z2.number()}),QUOTE_RESULT={FOUND:"QUOTE_FOUND",NO_QUOTE_PROVIDED:"No quote provided",WALLET_NOT_FOUND:"Wallet not found",WALLET_MISMATCH:"From wallet does not match session wallet",PRICE_IMPACT_TOO_HIGH:"Failed to get quote. Error: Price impact is too high",NO_ROUTES_FOUND:"Failed to get quote. Error: no routes found",AMOUNT_TOO_SMALL:"Failed to get quote. APIError: Swap output amount is too small to cover fees required to execute swap"},SwidgeSDKResponseSchema=t=>z2.object({success:z2.boolean(),data:t.optional(),error:z2.string().optional(),errorDetails:z2.object({message:z2.string(),status:z2.number().optional(),statusText:z2.string().optional()}).optional()}),SwidgeQuoteResponseWrapperSchema=SwidgeSDKResponseSchema(SwidgeQuoteDataSchema),SwidgeExecuteResponseWrapperSchema=SwidgeSDKResponseSchema(SwidgeExecuteResponseSchema);export{APIClient,Agent,AgentSdk,QUOTE_RESULT,getChainIdFromNetwork,isEthereumNetwork,isSolanaNetwork};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circuitorg/agent-sdk",
-  "version": "1.1.3",
+  "version": "1.1.6",
   "description": "typescript sdk for the Agent Toolset Service",
   "type": "module",
   "main": "index.js",