@circuitorg/agent-sdk 1.1.7 → 1.1.8

package/README.md

@@ -1,18 +1,28 @@
 # Circuit Agent SDK - Typescript
 
-> **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 **2 core methods** plus **platform integrations** with full type safety.
+A TypeScript SDK for building automated agents to deploy on Circuit. Features **2 low-level core methods** for maximum flexibility, plus **built-in platform integrations** for common on-chain operations—all with full type safety.
 
 > **💡 Best used with [Circuit Agents CLI](https://github.com/circuitorg/agents-cli)** - Deploy, manage, and test your agents with ease
 
+## 📑 Table of Contents
+
+- [Features](#-features)
+- [Quick Start](#-quick-start)
+- [Core SDK API](#-core-sdk-api-only-2-methods) - Low-level transaction & event logging methods
+- [Cross-Chain Swaps with Swidge](#-cross-chain-swaps-with-swidge) - Token swaps & bridges
+- [Polymarket Prediction Markets](#-polymarket-prediction-markets) - Trading integration
+- [Session Memory Storage](#-session-memory-storage) - State management
+- [Examples](#-examples)
+
 ## ✨ Features
 
-- **🎯 Simple API**: 2 core methods (`sendLog()`, `signAndSend()`) + platform integrations
+- **🎯 Low-Level Core API**: 2 foundational methods (`sendLog()`, `signAndSend()`) for sending custom transactions
 - **🔒 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
+- **💾 Session Memory**: Key-value storage with `sdk.memory.*` methods for maintaining state
 
 ## 🚀 Quick Start
 ### Install the SDK
@@ -38,6 +48,8 @@ const sdk = new AgentSdk({
 
 ## 🎯 Core SDK API (Only 2 Methods!)
 
+> **Low-level building blocks** for direct blockchain interaction. Use these for maximum flexibility, or leverage our higher-level integrations (Swidge, Polymarket, Memory) for common operations.
+
 ### 1. Add Logs to Timeline
 
 ```typescript
@@ -86,13 +98,13 @@ await sdk.signAndSend({
 ```
 
 
-## 🌉 Cross-Chain Swaps with Swidge
+## 🌉 Cross-Chain Swaps and Bridging with Swidge
 
-The SDK includes built-in Swidge integration for seamless cross-chain token swaps and bridges.
+> **High-level abstraction** built on core SDK methods. Simplifies cross-chain token operations with a quote-and-execute pattern.
 
-Swidge provides a unified interface that handles both **swapping** (exchanging tokens within the same network) and **bridging** (moving tokens across different networks) through a single, easy-to-use API. Whether you're doing a simple token swap on Ethereum or bridging assets across chains, the same quote-and-execute pattern works for everything.
+The SDK includes built-in Swidge integration for seamless cross-chain token swaps and bridges. Swidge provides a unified interface that handles both **swapping** (exchanging tokens within the same network) and **bridging** (moving tokens across different networks) through a single API. Whether you're doing a simple token swap on Ethereum or bridging assets across chains, the same pattern works for everything.
 
-### 3. Cross-Chain Swaps & Bridges
+### Cross-Chain Swaps & Bridges
 
 #### Get a Quote
 
@@ -187,152 +199,16 @@ if (quote.success && quote.data) {
 }
 ```
 
-### Swidge API Reference
-
-#### `sdk.swidge.quote(request: SwidgeQuoteRequest): Promise<SwidgeQuoteResponse>`
-
-Get pricing and routing information for token swaps between networks or within the same network.
-
-**Parameters:**
-```typescript
-{
-  from: { network: SwidgeNetwork, address: string },
-  to: { network: SwidgeNetwork, address: string },
-  amount: string,                    // Amount in token's smallest unit
-  fromToken?: string,                // Source token contract (omit for native tokens)
-  toToken?: string,                  // Destination token contract (omit for native tokens)
-  slippage?: string,                 // Slippage tolerance % (default: "0.5")
-  priceImpact?: string               // Max price impact % (default: "0.5")
-}
-```
-
-**Returns:**
-```typescript
-{
-  success: boolean,
-  data?: {
-    engine: "relay",
-    assetSend: {
-      network: SwidgeNetwork,
-      address: string,
-      token: string | null,
-      amount: string,
-      amountFormatted: string,
-      amountUsd: string,
-      // ... additional fields
-    },
-    assetReceive: {
-      network: SwidgeNetwork,
-      address: string,
-      token: string | null,
-      amount: string,
-      amountFormatted: string,
-      amountUsd: string,
-      // ... additional fields
-    },
-    priceImpact: {
-      usd?: string,
-      percentage?: string
-    },
-    fees: Array<{
-      name: string,
-      amount?: string,
-      amountFormatted?: string,
-      amountUsd?: string
-    }>,
-    steps: Array<SwidgeUnsignedStep>  // Transaction steps to execute
-  },
-  error?: string,
-  errorDetails?: {
-    message: string,
-    status?: number,
-    statusText?: string
-  }
-}
-```
-
-**Error Handling with QUOTE_RESULT:**
-
-The SDK exports a `QUOTE_RESULT` constant that provides type-safe error checking with full IntelliSense support:
-
-```typescript
-import { QUOTE_RESULT } from "@circuitorg/agent-sdk";
-
-// Use QUOTE_RESULT constants instead of hardcoded strings
-if (quote.error === QUOTE_RESULT.WALLET_NOT_FOUND) {
-  // Handle wallet not found
-} else if (quote.error === QUOTE_RESULT.WALLET_MISMATCH) {
-  // Handle wallet mismatch
-}
-```
-
-**Possible Error Responses:**
-- `QUOTE_RESULT.FOUND` - Success case (not an error)
-- `QUOTE_RESULT.NO_QUOTE_PROVIDED` - Generic API error
-- `QUOTE_RESULT.WALLET_NOT_FOUND` - Wallet address not found
-- `QUOTE_RESULT.WALLET_MISMATCH` - From wallet does not match session wallet
-
-#### `sdk.swidge.execute(quoteData: SwidgeExecuteRequest): Promise<SwidgeExecuteResponse>`
-
-Execute a cross-chain swap or bridge using a complete quote from `sdk.swidge.quote()`.
-
-Pass the entire `quote.data` object returned from `quote()` - the SDK handles all transaction signing, broadcasting, and cross-chain coordination.
-
-**Parameters:**
-```typescript
-// The complete quote.data object from sdk.swidge.quote()
-{
-  engine: "relay",
-  assetSend: SwidgeQuoteAsset,
-  assetReceive: SwidgeQuoteAsset,
-  priceImpact: SwidgePriceImpact,
-  fees: SwidgeFee[],
-  steps: SwidgeUnsignedStep[]  // Contains transaction details for each step
-}
-```
-
-**Returns:**
-```typescript
-{
-  success: boolean,
-  data?: {
-    status: "success" | "failure" | "refund" | "delayed",
-    in: {
-      network: string,
-      txs: string[]  // Transaction hashes for sending side
-    },
-    out: {
-      network: string,
-      txs: string[]  // Transaction hashes for receiving side
-    },
-    lastUpdated: number  // Timestamp of last status update
-  },
-  error?: string,
-  errorDetails?: {
-    message: string,
-    status?: number,
-    statusText?: string
-  }
-}
-```
-
-**Execution Flow:**
-1. SDK signs and broadcasts transactions from the `steps` array
-2. Monitors cross-chain execution progress
-3. Returns final status once complete (never returns "pending" or "waiting")
+## 📈 Polymarket Prediction Markets
 
-**Status Meanings:**
-- `"success"` - All transactions completed successfully
-- `"failure"` - One or more transactions failed
-- `"refund"` - Transaction was refunded (e.g., due to timeout or failure)
-- `"delayed"` - Transaction is taking longer than expected but still processing
+> **High-level abstraction** built on core SDK methods. Simplifies prediction market trading on Polygon.
 
+> **Note:** Due to polymarket accepting buys and sells with different decimal precision, you may end up with dust positions when trying to sell to close out a position.
 
-## 📈 Polymarket Prediction Markets
 
 The SDK includes built-in Polymarket integration for trading prediction markets on Polygon.
 
-### 4. Polymarket Trading
+### Polymarket Trading
 
 #### Get Positions
 
@@ -391,7 +267,11 @@ 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}`);
+      if (result.position) {
+        console.log(`✅ Redeemed: ${result.position.question}`);
+      } else {
+        console.log(`✅ Unwrapped collateral`);
+      }
       console.log(`   TX: ${result.transactionHash}`);
     }
   }
@@ -403,102 +283,6 @@ const specificRedemption = await sdk.polymarket.redeemPositions({
 });
 ```
 
-### 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?: {
-    success: boolean,  // Whether the order was successfully submitted
-    orderInfo: {
-      orderId: string,
-      side: string,
-      size: string,
-      priceUsd: string,
-      totalPriceUsd: 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
@@ -566,6 +350,136 @@ const stopFunction: StopFunctionContract = async (request) => {
 };
 ```
 
+## 💾 Session Memory Storage
+
+> **High-level abstraction** built on core SDK methods. Provides key-value storage for maintaining state across execution cycles without external databases.
+
+Store and retrieve data for your agent's session with simple get/set/delete/list operations. Memory is **automatically scoped to your session ID** - each session has isolated storage that persists across execution cycles.
+
+### Memory Operations
+
+#### Set a Value
+
+```typescript
+// Store user preferences
+const result = await sdk.memory.set("lastSwapNetwork", "ethereum:42161");
+
+if (result.success && result.data) {
+  console.log(`Stored key: ${result.data.key}`);
+} else {
+  console.error(`Failed to store: ${result.error}`);
+}
+```
+
+#### Get a Value
+
+```typescript
+// Retrieve stored preferences
+const result = await sdk.memory.get("lastSwapNetwork");
+
+if (result.success && result.data) {
+  console.log(`Network: ${result.data.value}`);
+} else {
+  console.log(`Key not found: ${result.error}`);
+}
+```
+
+#### Delete a Value
+
+```typescript
+// Clean up temporary data
+const result = await sdk.memory.delete("tempSwapQuote");
+
+if (result.success && result.data) {
+  console.log(`Deleted key: ${result.data.key}`);
+}
+```
+
+#### List All Keys
+
+```typescript
+// List all stored keys
+const result = await sdk.memory.list();
+
+if (result.success && result.data) {
+  console.log(`Found ${result.data.count} keys:`);
+  result.data.keys.forEach(key => console.log(`  - ${key}`));
+}
+```
+
+### Complete Memory Example
+
+```typescript
+const executionFunction: ExecutionFunctionContract = async (request) => {
+  const sdk = new AgentSdk({ sessionId: request.sessionId });
+
+  try {
+    // Check if this is a first run by looking for a stored counter
+    const counterResult = await sdk.memory.get("executionCount");
+    
+    let count = 0;
+    if (counterResult.success && counterResult.data) {
+      count = parseInt(counterResult.data.value);
+      await sdk.sendLog({
+        type: "observe",
+        shortMessage: `Execution #${count + 1} - Welcome back!`
+      });
+    } else {
+      await sdk.sendLog({
+        type: "observe",
+        shortMessage: "First execution - initializing..."
+      });
+    }
+
+    // Store some session data
+    await sdk.memory.set("executionCount", String(count + 1));
+    await sdk.memory.set("lastRunTimestamp", Date.now().toString());
+    await sdk.memory.set("userPreferences", JSON.stringify({
+      network: "ethereum:42161",
+      slippage: "2.0"
+    }));
+
+    // List all stored keys
+    const listResult = await sdk.memory.list();
+    if (listResult.success && listResult.data) {
+      await sdk.sendLog({
+        type: "observe",
+        shortMessage: `Stored ${listResult.data.count} keys: ${listResult.data.keys.join(", ")}`
+      });
+    }
+
+    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 {
+    // Clean up temporary data on stop
+    const listResult = await sdk.memory.list();
+    if (listResult.success && listResult.data) {
+      // Delete all temp keys
+      for (const key of listResult.data.keys) {
+        if (key.startsWith("temp_")) {
+          await sdk.memory.delete(key);
+        }
+      }
+    }
+
+    return { success: true };
+  } catch (error) {
+    return { success: false, error: error instanceof Error ? error.message : "Unknown error" };
+  }
+};
+```
+
 
 ## 🔧 Examples
 

package/index.d.ts

@@ -393,6 +393,7 @@ declare const PolymarketPositionSchema: z.ZodObject<{
     priceUsd: z.ZodString;
     averagePriceUsd: z.ZodString;
     isRedeemable: z.ZodBoolean;
+    isNegativeRisk: z.ZodBoolean;
     imageUrl: z.ZodString;
     initialValue: z.ZodString;
     pnlUsd: z.ZodString;
@@ -429,6 +430,7 @@ declare const PolymarketPositionsResponseSchema: z.ZodObject<{
             priceUsd: z.ZodString;
             averagePriceUsd: z.ZodString;
             isRedeemable: z.ZodBoolean;
+            isNegativeRisk: z.ZodBoolean;
             imageUrl: z.ZodString;
             initialValue: z.ZodString;
             pnlUsd: z.ZodString;
@@ -469,7 +471,7 @@ declare const PolymarketRedeemPositionsResponseSchema: z.ZodObject<{
     success: z.ZodBoolean;
     data: z.ZodOptional<z.ZodArray<z.ZodObject<{
         success: z.ZodBoolean;
-        position: z.ZodObject<{
+        position: z.ZodNullable<z.ZodObject<{
             contractAddress: z.ZodString;
             tokenId: z.ZodNullable<z.ZodString>;
             decimals: z.ZodNumber;
@@ -482,6 +484,7 @@ declare const PolymarketRedeemPositionsResponseSchema: z.ZodObject<{
             priceUsd: z.ZodString;
             averagePriceUsd: z.ZodString;
             isRedeemable: z.ZodBoolean;
+            isNegativeRisk: z.ZodBoolean;
             imageUrl: z.ZodString;
             initialValue: z.ZodString;
             pnlUsd: z.ZodString;
@@ -489,7 +492,7 @@ declare const PolymarketRedeemPositionsResponseSchema: z.ZodObject<{
             pnlRealizedUsd: z.ZodString;
             pnlRealizedPercent: z.ZodString;
             endDate: z.ZodString;
-        }, z.core.$strip>;
+        }, z.core.$strip>>;
         transactionHash: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>>;
     error: z.ZodOptional<z.ZodString>;
@@ -506,6 +509,107 @@ type PolymarketPositionsResponse = z.infer<typeof PolymarketPositionsResponseSch
 type PolymarketMarketOrderResponse = z.infer<typeof PolymarketMarketOrderResponseSchema>;
 type PolymarketRedeemPositionsResponse = z.infer<typeof PolymarketRedeemPositionsResponseSchema>;
 
+/**
+ * Memory type definitions for agent session storage
+ *
+ * Memory operations provide key-value storage scoped to the current agent session.
+ * All keys are automatically namespaced by agentId and sessionId.
+ */
+
+/**
+ * Request to set a key-value pair in memory
+ */
+declare const MemorySetRequestSchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Request to get a value by key from memory
+ */
+declare const MemoryGetRequestSchema: z.ZodObject<{
+    key: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Request to delete a key from memory
+ */
+declare const MemoryDeleteRequestSchema: z.ZodObject<{
+    key: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Request to list all keys in memory (no parameters needed)
+ */
+declare const MemoryListRequestSchema: z.ZodObject<{}, z.core.$strip>;
+/**
+ * Memory set response wrapper
+ */
+declare const MemorySetResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        key: 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>;
+/**
+ * Memory get response wrapper
+ */
+declare const MemoryGetResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        value: 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>;
+/**
+ * Memory delete response wrapper
+ */
+declare const MemoryDeleteResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        key: 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>;
+/**
+ * Memory list response wrapper
+ */
+declare const MemoryListResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        keys: z.ZodArray<z.ZodString>;
+        count: z.ZodNumber;
+    }, 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 MemorySetRequest = z.infer<typeof MemorySetRequestSchema>;
+type MemoryGetRequest = z.infer<typeof MemoryGetRequestSchema>;
+type MemoryDeleteRequest = z.infer<typeof MemoryDeleteRequestSchema>;
+type MemoryListRequest = z.infer<typeof MemoryListRequestSchema>;
+type MemorySetResponse = z.infer<typeof MemorySetResponseSchema>;
+type MemoryGetResponse = z.infer<typeof MemoryGetResponseSchema>;
+type MemoryDeleteResponse = z.infer<typeof MemoryDeleteResponseSchema>;
+type MemoryListResponse = z.infer<typeof MemoryListResponseSchema>;
+
 /**
  * Main AgentSdk class with simplified API surface
  */
@@ -775,6 +879,136 @@ declare class AgentSdk {
          */
         execute: (executeQuote: SwidgeExecuteRequest) => Promise<SwidgeExecuteResponse>;
     };
+    /**
+     * 💾 Memory: Session-scoped key-value storage
+     *
+     * Store and retrieve data for your agent's session. All keys are automatically
+     * namespaced by agentId and sessionId - perfect for maintaining state across
+     * execution cycles.
+     */
+    readonly memory: {
+        /**
+         * Set a key-value pair in session memory
+         *
+         * Store a string value with a unique key. The key is automatically scoped to your
+         * agent and session, so you don't need to worry about collisions.
+         *
+         * @param key Unique identifier for the value (1-255 characters)
+         * @param value String value to store
+         * @returns Promise with success status and the stored key
+         *
+         * @example
+         * ```ts
+         * // Store user preferences
+         * const result = await sdk.memory.set("lastSwapNetwork", "ethereum:42161");
+         *
+         * if (result.success && result.data) {
+         *   console.log(`Stored key: ${result.data.key}`);
+         * } else {
+         *   console.error(`Failed to store: ${result.error}`);
+         * }
+         * ```
+         *
+         * **Input**: `{ key: string, value: string }`
+         *
+         * **Output**: `MemorySetResponse`
+         *   - `success` (bool): Whether the operation succeeded
+         *   - `data` (object | undefined): Present on success
+         *     - `key` (string): The key that was set
+         *   - `error` (string | undefined): Error message on failure
+         *   - `errorDetails` (object | undefined): Detailed error info on failure
+         */
+        set: (key: string, value: string) => Promise<MemorySetResponse>;
+        /**
+         * Get a value by key from session memory
+         *
+         * Retrieve a previously stored value. Returns an error if the key doesn't exist.
+         *
+         * @param key The key to retrieve
+         * @returns Promise with the key and its value, or error details
+         *
+         * @example
+         * ```ts
+         * // Retrieve stored preferences
+         * const result = await sdk.memory.get("lastSwapNetwork");
+         *
+         * if (result.success && result.data) {
+         *   console.log(`Network: ${result.data.value}`);
+         * } else {
+         *   console.log(`Key not found: ${result.error}`);
+         * }
+         * ```
+         *
+         * **Input**: `key: string`
+         *
+         * **Output**: `MemoryGetResponse`
+         *   - `success` (bool): Whether the operation succeeded
+         *   - `data` (object | undefined): Present on success
+         *     - `key` (string): The requested key
+         *     - `value` (string): The stored value
+         *   - `error` (string | undefined): Error message (e.g., "Key not found")
+         *   - `errorDetails` (object | undefined): Detailed error info on failure
+         */
+        get: (key: string) => Promise<MemoryGetResponse>;
+        /**
+         * Delete a key from session memory
+         *
+         * Remove a key-value pair. Succeeds even if the key doesn't exist.
+         *
+         * @param key The key to delete
+         * @returns Promise with success status and the deleted key
+         *
+         * @example
+         * ```ts
+         * // Clean up temporary data
+         * const result = await sdk.memory.delete("tempSwapQuote");
+         *
+         * if (result.success && result.data) {
+         *   console.log(`Deleted key: ${result.data.key}`);
+         * }
+         * ```
+         *
+         * **Input**: `key: string`
+         *
+         * **Output**: `MemoryDeleteResponse`
+         *   - `success` (bool): Whether the operation succeeded
+         *   - `data` (object | undefined): Present on success
+         *     - `key` (string): The key that was deleted
+         *   - `error` (string | undefined): Error message on failure
+         *   - `errorDetails` (object | undefined): Detailed error info on failure
+         */
+        delete: (key: string) => Promise<MemoryDeleteResponse>;
+        /**
+         * List all keys in session memory
+         *
+         * Get an array of all keys stored for this agent session. Useful for debugging
+         * or iterating through stored data.
+         *
+         * @returns Promise with array of keys and count
+         *
+         * @example
+         * ```ts
+         * // List all stored keys
+         * const result = await sdk.memory.list();
+         *
+         * if (result.success && result.data) {
+         *   console.log(`Found ${result.data.count} keys:`);
+         *   result.data.keys.forEach(key => console.log(`  - ${key}`));
+         * }
+         * ```
+         *
+         * **Input**: None
+         *
+         * **Output**: `MemoryListResponse`
+         *   - `success` (bool): Whether the operation succeeded
+         *   - `data` (object | undefined): Present on success
+         *     - `keys` (string[]): Array of all stored keys
+         *     - `count` (number): Number of keys
+         *   - `error` (string | undefined): Error message on failure
+         *   - `errorDetails` (object | undefined): Detailed error info on failure
+         */
+        list: () => Promise<MemoryListResponse>;
+    };
     /**
      * 📈 Polymarket: Trade prediction markets seamlessly
      *
@@ -942,8 +1176,10 @@ declare class AgentSdk {
          *
          * if (result.success && result.data) {
          *   result.data.forEach(tx => {
-         *     if (tx.success) {
+         *     if (tx.success && tx.position) {
          *       console.log(`Redeemed ${tx.position.question}: Tx ${tx.transactionHash}`);
+         *     } else if (tx.success) {
+         *       console.log(`Unwrapped collateral: Tx ${tx.transactionHash}`);
          *     }
          *   });
          * }
@@ -964,6 +1200,11 @@ declare class AgentSdk {
          *       },
          *       transactionHash: "0xabc123..."
          *     },
+         *     {
+         *       success: true,
+         *       position: null, // null for unwrap collateral transactions
+         *       transactionHash: "0xdef456..."
+         *     },
          *     // ... more redemptions
          *   ]
          * }
@@ -1011,6 +1252,22 @@ declare class AgentSdk {
     private handlePolymarketPositions;
     private handlePolymarketMarketOrder;
     private handlePolymarketRedeemPositions;
+    /**
+     * Handle memory set requests
+     */
+    private handleMemorySet;
+    /**
+     * Handle memory get requests
+     */
+    private handleMemoryGet;
+    /**
+     * Handle memory delete requests
+     */
+    private handleMemoryDelete;
+    /**
+     * Handle memory list requests
+     */
+    private handleMemoryList;
 }
 
 /**
@@ -1069,6 +1326,11 @@ declare class APIClient {
      * @param data - Optional JSON payload to serialize
      */
     post<T>(endpoint: string, data?: any): Promise<T>;
+    /**
+     * HTTP DELETE convenience method.
+     * @param endpoint - API path beginning with `/v1/...`
+     */
+    delete<T>(endpoint: string): Promise<T>;
 }
 
 /**
@@ -1292,4 +1554,4 @@ declare function isSolanaNetwork(network: Network): network is "solana";
  */
 declare function getChainIdFromNetwork(network: `ethereum:${number}`): number;
 
-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 };
+export { APIClient, Agent, AgentSdk, type ExecutionFunctionContract, type MemoryDeleteRequest, type MemoryDeleteResponse, type MemoryGetRequest, type MemoryGetResponse, type MemoryListRequest, type MemoryListResponse, type MemorySetRequest, type MemorySetResponse, 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.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:{success:!0,orderInfo:{orderId:"test-order-id",side:"BUY",size:"1.0",priceUsd:"0.50",totalPriceUsd:"0.50",txHashes:["0xtest"]}}}:{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 CurrentPositionSchema=z.object({network:z.string(),assetAddress:z.string(),tokenId:z.string().nullable(),avgUnitCost:z.string(),currentQty:z.string()}),AgentRequestSchema=z.object({sessionId:z.number(),sessionWalletAddress:z.string(),jobId:z.string().optional(),currentPositions:z.array(CurrentPositionSchema).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};
+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})}async delete(t){return this.makeRequest(t,{method:"DELETE"})}};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)};memory={set:async(t,e)=>this.handleMemorySet(t,e),get:async t=>this.handleMemoryGet(t),delete:async t=>this.handleMemoryDelete(t),list:async()=>this.handleMemoryList()};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:{success:!0,orderInfo:{orderId:"test-order-id",side:"BUY",size:"1.0",priceUsd:"0.50",totalPriceUsd:"0.50",txHashes:["0xtest"]}}}:{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}}}}async handleMemorySet(t,e){this.logging("=== MEMORY SET ==="),this.logging("Key:",t),this.logging("Testing mode:",this.config.testing),this.logging("==================");try{return this.config.testing?{success:!0,data:{key:t}}:{success:!0,data:await this.client.post(`/v1/memory/${t}`,{value:e})}}catch(t){this.logging("=== MEMORY SET ERROR ==="),this.logging("Error:",t),this.logging("========================");let e,s,r="Failed to set memory";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 handleMemoryGet(t){this.logging("=== MEMORY GET ==="),this.logging("Key:",t),this.logging("Testing mode:",this.config.testing),this.logging("==================");try{return this.config.testing?{success:!0,data:{key:t,value:"test-value"}}:{success:!0,data:await this.client.get(`/v1/memory/${t}`)}}catch(t){this.logging("=== MEMORY GET ERROR ==="),this.logging("Error:",t),this.logging("========================");let e,s,r="Failed to get memory";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 handleMemoryDelete(t){this.logging("=== MEMORY DELETE ==="),this.logging("Key:",t),this.logging("Testing mode:",this.config.testing),this.logging("=====================");try{return this.config.testing?{success:!0,data:{key:t}}:{success:!0,data:await this.client.delete(`/v1/memory/${t}`)}}catch(t){this.logging("=== MEMORY DELETE ERROR ==="),this.logging("Error:",t),this.logging("===========================");let e,s,r="Failed to delete memory";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 handleMemoryList(){this.logging("=== MEMORY LIST ==="),this.logging("Testing mode:",this.config.testing),this.logging("===================");try{return this.config.testing?{success:!0,data:{keys:[],count:0}}:{success:!0,data:await this.client.get("/v1/memory/list")}}catch(t){this.logging("=== MEMORY LIST ERROR ==="),this.logging("Error:",t),this.logging("=========================");let e,s,r="Failed to list memory keys";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 CurrentPositionSchema=z.object({network:z.string(),assetAddress:z.string(),tokenId:z.string().nullable(),avgUnitCost:z.string(),currentQty:z.string()}),AgentRequestSchema=z.object({sessionId:z.number(),sessionWalletAddress:z.string(),jobId:z.string().optional(),currentPositions:z.array(CurrentPositionSchema).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.7",
+  "version": "1.1.8",
   "description": "typescript sdk for the Agent Toolset Service",
   "type": "module",
   "main": "index.js",