@circuitorg/agent-sdk 1.2.1 → 1.2.3

package/README.md

@@ -13,6 +13,7 @@ A simplified TypeScript SDK for building automated agents to deploy on Circuit.
   - [🚀 Quick Start](#-quick-start)
     - [Install the SDK](#install-the-sdk)
     - [Create Your First Agent](#create-your-first-agent)
+      - [Required Asset setup](#required-asset-setup)
   - [🎯 Core Concepts](#-core-concepts)
     - [The AgentContext Object](#the-agentcontext-object)
     - [Run/Stop Function Requirements](#runstop-function-requirements)
@@ -23,6 +24,7 @@ A simplified TypeScript SDK for building automated agents to deploy on Circuit.
   - [📈 Polymarket Prediction Markets](#-polymarket-prediction-markets)
     - [Place Market Orders](#place-market-orders)
     - [Redeem Positions](#redeem-positions)
+  - [📊 Transaction History](#-transaction-history)
   - [🚀 Sign \& Send Transactions](#-sign--send-transactions)
     - [Ethereum (any EVM chain)](#ethereum-any-evm-chain)
     - [Solana](#solana)
@@ -65,9 +67,27 @@ Every agent receives a single `AgentContext` object that provides:
 - `agent.swidge` - Cross-chain swaps and bridges (`.quote()`, `.execute()`)
 - `agent.signAndSend()` - Execute custom built transactions on any supported chain
 - `agent.signMessage()` - Sign messages (EVM only)
+- `agent.transactions()` - Get transaction history with asset changes
 
 **Important:** `currentPositions` reflects your allocated assets at the **start** of each execution. To avoid failed transactions, you should be tracking intra-run position changes based on transactions the agent makes during the execution. Circuit will provide updated positions on the next execution request.
 
+
+#### Required Asset setup
+> Note: For native tokens, use the following null addresses for solana/ethereum
+```toml
+// Requiring 1 SOL
+[[requiredAssets]]
+network = "solana"
+address = "11111111111111111111111111111111"
+minimumAmount = "1000000000"
+
+// Requiring 1 ETH
+[[requiredAssets]]
+network = "ethereum:<chainId>"
+address = "0x0000000000000000000000000000000000000000"
+minimumAmount = "1000000000000000000"
+```
+
 ```typescript
 import { Agent, AgentContext } from "@circuitorg/agent-sdk";
 
@@ -121,6 +141,7 @@ Every agent function receives a single `AgentContext` object that contains:
 - `agent.swidge` - Cross-chain swap operations
 - `agent.signAndSend()` - Sign and broadcast transactions
 - `agent.signMessage()` - Sign messages on EVM
+- `agent.transactions()` - Get transaction history with asset changes
 
 ### Run/Stop Function Requirements
 
@@ -215,6 +236,8 @@ Built-in Swidge integration for seamless cross-chain token swaps and bridges.
 ### Get and execute a quote
 > Note: It is important to always validate quotes before executing. Circuit will always do its best to return a quote, and as of now, will only filter out quotes with price impacts exceeding 100% to ensure maximum flexibility. It is on the agent to makes sure a quote is valid, given its own parameters
 
+> **Bulk Execution:** `execute()` accepts both single quotes and arrays. Pass an array to execute multiple swaps in parallel: `await agent.swidge.execute([quote1.data, quote2.data])` returns an array of results.
+
 ```typescript
 async function run(agent: AgentContext): Promise<void> {
   // 1. Get quote
@@ -305,6 +328,66 @@ async function stop(agent: AgentContext): Promise<void> {
 }
 ```
 
+## 📊 Transaction History
+
+Get a list of asset changes for all confirmed transactions during your session. This is useful for tracking what assets have moved in and out of the agent's wallet.
+
+> **Note:** The system needs to index new transactions, so there may be a slight delay between when you execute a transaction and when the resulting asset changes are returned in this method. Make sure you are taking that into consideration if dealing with assets the agent just transacted with.
+
+```typescript
+async function run(agent: AgentContext): Promise<void> {
+  // Get all transaction history for this session
+  const result = await agent.transactions();
+
+  if (result.success && result.data) {
+    await agent.log(`Found ${result.data.length} asset changes`);
+
+    // Filter for outgoing transfers
+    const outgoing = result.data.filter(
+      (change) => change.from === agent.sessionWalletAddress
+    );
+    await agent.log(`Outgoing transfers: ${outgoing.length}`);
+
+    // Calculate total USD value (where price data is available)
+    const totalUsd = result.data
+      .filter((c) => c.tokenUsdPrice)
+      .reduce((sum, c) => {
+        const amount = parseFloat(c.amount);
+        const price = parseFloat(c.tokenUsdPrice!);
+        return sum + amount * price;
+      }, 0);
+    await agent.log(`Total USD value: $${totalUsd.toFixed(2)}`);
+
+    // View specific transaction details
+    for (const change of result.data) {
+      await agent.log(`${change.network}: ${change.from} → ${change.to}`);
+      await agent.log(`  Amount: ${change.amount} ${change.tokenType}`);
+      if (change.token) {
+        await agent.log(`  Token: ${change.token}`);
+      }
+      await agent.log(`  Tx: ${change.transactionHash}`);
+      await agent.log(`  Time: ${change.timestamp}`);
+    }
+  } else {
+    await agent.log(result.error || "Failed to fetch transactions", { error: true });
+  }
+}
+```
+
+**AssetChange Structure:**
+
+Each asset change in the response contains:
+- `network` - Network identifier (e.g., `"ethereum:1"`, `"solana"`)
+- `transactionHash` - Transaction hash
+- `from` - Sender address
+- `to` - Recipient address
+- `amount` - Amount transferred (as string to preserve precision)
+- `token` - Token contract address (`null` for native tokens)
+- `tokenId` - Token ID for NFTs (`null` for fungible tokens)
+- `tokenType` - Token type (e.g., `"native"`, `"ERC20"`, `"ERC721"`)
+- `tokenUsdPrice` - Token price in USD at time of transaction (`null` if unavailable)
+- `timestamp` - Transaction timestamp
+
 ## 🚀 Sign & Send Transactions
 
 ### Ethereum (any EVM chain)

package/index.d.ts

@@ -182,6 +182,94 @@ type TransactionsResponse = {
         status?: number;
     };
 };
+/**
+ * Current position with optional Polymarket metadata enrichment
+ */
+type EnrichedPosition = {
+    /** Network identifier (e.g., "ethereum:1", "solana") */
+    network: string;
+    /** Asset contract address */
+    assetAddress: string;
+    /** Token ID for NFTs/ERC1155 (null for fungible tokens) */
+    tokenId: string | null;
+    /** Average unit cost in USD */
+    avgUnitCost: string;
+    /** Current quantity held (raw amount) */
+    currentQty: string;
+    /** Optional Polymarket metadata (only present for ERC1155 positions) */
+    polymarketMetadata?: {
+        /** ERC1155 contract address for the market */
+        contractAddress: string;
+        /** Token ID for the specific outcome */
+        tokenId: string | null;
+        /** Token decimals (typically 6) */
+        decimals: number;
+        /** Unique condition identifier */
+        conditionId: string;
+        /** Human-readable share count */
+        formattedShares: string;
+        /** Raw share count in smallest unit */
+        shares: string;
+        /** Current position value in USD */
+        valueUsd: string;
+        /** Market question text */
+        question: string;
+        /** Outcome name (e.g., "Yes", "No") */
+        outcome: string;
+        /** Current price per share in USD */
+        priceUsd: string;
+        /** Average purchase price per share in USD */
+        averagePriceUsd: string;
+        /** Whether position can be redeemed */
+        isRedeemable: boolean;
+        /** Whether position uses negative risk collateral */
+        isNegativeRisk: boolean;
+        /** Market image URL */
+        imageUrl: string;
+        /** Initial position value in USD */
+        initialValue: string;
+        /** Unrealized profit/loss in USD */
+        pnlUsd: string;
+        /** Unrealized profit/loss percentage */
+        pnlPercent: string;
+        /** Realized profit/loss in USD */
+        pnlRealizedUsd: string;
+        /** Realized profit/loss percentage */
+        pnlRealizedPercent: string;
+        /** Market end date (ISO 8601 string) */
+        endDate: string;
+    };
+};
+/**
+ * Data returned from getCurrentPositions() method
+ */
+type CurrentPositionsData = {
+    /** Array of current positions with optional Polymarket metadata */
+    positions: EnrichedPosition[];
+    /** Whether there are pending transactions that may affect position balances */
+    hasPendingTxs: boolean;
+};
+/**
+ * Response from getCurrentPositions() method
+ *
+ * Returns the current live positions for the session with optional Polymarket
+ * metadata enrichment for ERC1155 positions.
+ */
+type CurrentPositionsResponse = {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Current positions data (only present on success) */
+    data?: CurrentPositionsData;
+    /** Error message (only present on failure) */
+    error?: string;
+    /** Detailed error message (only present on failure) */
+    errorMessage?: string;
+    /** Detailed error information (only present on failure) */
+    errorDetails?: {
+        message?: string;
+        status?: number;
+    };
+};
 
 /**
  * Agent log type definitions for agent communication
@@ -522,6 +610,7 @@ declare const SwidgeExecuteResponseWrapperSchema: z.ZodObject<{
             txs: z.ZodArray<z.ZodString>;
         }, z.core.$strip>;
         lastUpdated: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     error: z.ZodOptional<z.ZodString>;
     errorMessage: z.ZodOptional<z.ZodString>;
@@ -939,6 +1028,10 @@ declare class AgentSdk {
          * `sdk.swidge.quote()` and let the magic happen. Signs transactions, broadcasts them,
          * and waits for completion.
          *
+         * Supports both single and bulk execution:
+         * - Pass a single quote → get a single response
+         * - Pass an array of quotes → get an array of responses
+         *
          * ⚠️ **What happens:**
          * - Signs transactions using your wallet's policy engine
          * - Broadcasts to the blockchain(s)
@@ -947,8 +1040,8 @@ declare class AgentSdk {
          *
          * 💡 **Pro tip**: The backend handles all the complexity - you just pass the quote!
          *
-         * @param quote Complete quote object from `sdk.swidge.quote()` (the entire `data` field from the quote response)
-         * @returns SwidgeExecuteResponse with transaction status and details
+         * @param quote Complete quote object(s) from `sdk.swidge.quote()` (the entire `data` field from the quote response)
+         * @returns SwidgeExecuteResponse or array of responses (matching input type) with transaction status and details
          *   - `success` (boolean): Whether the execution was successful
          *   - `data` (SwidgeExecuteData | undefined): Execution result containing:
          *     - `status`: "success" | "failure" | "refund" | "delayed" - Final transaction status
@@ -969,7 +1062,7 @@ declare class AgentSdk {
          *   toToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
          * });
          *
-         * // 2️⃣ Execute the swap
+         * // 2️⃣ Execute the swap (single)
          * if (quote.success && quote.data) {
          *   const result = await sdk.swidge.execute(quote.data);
          *
@@ -991,9 +1084,18 @@ declare class AgentSdk {
          *     console.log(`❌ Execute failed: ${result.error}`);
          *   }
          * }
+         *
+         * // 3️⃣ Bulk execution (multiple quotes)
+         * const results = await sdk.swidge.execute([quote.data, quote.data]);
+         * results.forEach((result, index) => {
+         *   console.log(`Swap ${index + 1}: ${result.success ? result.data?.status : result.error}`);
+         * });
          * ```
          */
-        execute: (executeQuote: SwidgeExecuteRequest) => Promise<SwidgeExecuteResponse>;
+        execute: {
+            (executeQuote: SwidgeExecuteRequest): Promise<SwidgeExecuteResponse>;
+            (executeQuotes: SwidgeExecuteRequest[]): Promise<SwidgeExecuteResponse[]>;
+        };
     };
     /**
      * 💾 Memory: Session-scoped key-value storage
@@ -1356,7 +1458,7 @@ declare class AgentSdk {
      */
     private handleSwidgeQuote;
     /**
-     * Handle swidge execute requests
+     * Handle swidge execute requests (single or bulk)
      */
     private handleSwidgeExecute;
     private handlePolymarketMarketOrder;
@@ -1416,6 +1518,107 @@ declare class AgentSdk {
      * ```
      */
     transactions(): Promise<TransactionsResponse>;
+    /**
+     * 💼 Get current live positions for the session
+     *
+     * Retrieves all current positions held by the session wallet with live balance data.
+     * For ERC1155 positions (e.g., Polymarket), optionally enriches the response with
+     * detailed market metadata including PNL, current prices, and redeemability status.
+     *
+     * **Key Features**:
+     * - Live balance data from the analytics service
+     * - Automatic Polymarket metadata enrichment for ERC1155 positions
+     * - Pending transaction detection to warn of potentially stale balances
+     *
+     * **Returns**: `CurrentPositionsResponse`
+     *   - `success` (boolean): Whether the operation succeeded
+     *   - `data` (CurrentPositionsData | undefined): Current positions data on success
+     *     - `positions` (EnrichedPosition[]): Array of current positions
+     *       - `network` (string): Network identifier (e.g., "ethereum:137")
+     *       - `assetAddress` (string): Token/asset contract address
+     *       - `tokenId` (string | null): Token ID for NFTs/ERC1155 (null for fungible)
+     *       - `avgUnitCost` (string): Average unit cost in USD
+     *       - `currentQty` (string): Current quantity held (raw amount)
+     *       - `polymarketMetadata` (optional): Detailed Polymarket position data
+     *         - `question` (string): Market question text
+     *         - `outcome` (string): Outcome name (e.g., "Yes", "No")
+     *         - `formattedShares` (string): Human-readable share count
+     *         - `valueUsd` (string): Current position value in USD
+     *         - `priceUsd` (string): Current price per share
+     *         - `averagePriceUsd` (string): Average purchase price
+     *         - `pnlUsd` (string): Unrealized profit/loss in USD
+     *         - `pnlPercent` (string): Unrealized profit/loss percentage
+     *         - `isRedeemable` (boolean): Whether position can be redeemed
+     *         - `endDate` (string): Market end date
+     *         - Plus additional market details
+     *     - `hasPendingTxs` (boolean): Whether there are pending transactions
+     *   - `error` (string | undefined): Error message on failure
+     *   - `errorMessage` (string | undefined): Detailed error message on failure
+     *
+     * @returns Promise resolving to CurrentPositionsResponse with enriched positions
+     *
+     * @example
+     * ```ts
+     * const result = await sdk.getCurrentPositions();
+     *
+     * if (result.success && result.data) {
+     *   console.log(`Found ${result.data.positions.length} positions`);
+     *
+     *   if (result.data.hasPendingTxs) {
+     *     console.log('⚠️  Warning: Pending transactions may affect balances');
+     *   }
+     *
+     *   result.data.positions.forEach(position => {
+     *     console.log(`${position.assetAddress}: ${position.currentQty} units`);
+     *     console.log(`  Average cost: $${position.avgUnitCost}`);
+     *
+     *     // Check for Polymarket enrichment
+     *     if (position.polymarketMetadata) {
+     *       const pm = position.polymarketMetadata;
+     *       console.log(`  📈 ${pm.question}`);
+     *       console.log(`  Outcome: ${pm.outcome}`);
+     *       console.log(`  Shares: ${pm.formattedShares}`);
+     *       console.log(`  Value: $${pm.valueUsd}`);
+     *       console.log(`  PNL: $${pm.pnlUsd} (${pm.pnlPercent}%)`);
+     *       console.log(`  Redeemable: ${pm.isRedeemable ? 'Yes' : 'No'}`);
+     *     }
+     *   });
+     * } else {
+     *   console.error(`Failed to get positions: ${result.error}`);
+     * }
+     * ```
+     *
+     * **Success Response Example**:
+     * ```json
+     * {
+     *   "success": true,
+     *   "data": {
+     *     "positions": [
+     *       {
+     *         "network": "ethereum:137",
+     *         "assetAddress": "0x4d97dcd97eC945f40cF65F87097ACe5EA0476045",
+     *         "tokenId": "123456",
+     *         "avgUnitCost": "0.52",
+     *         "currentQty": "10.5",
+     *         "polymarketMetadata": {
+     *           "question": "Will event X happen?",
+     *           "outcome": "Yes",
+     *           "formattedShares": "10.5",
+     *           "valueUsd": "5.46",
+     *           "priceUsd": "0.52",
+     *           "averagePriceUsd": "0.50",
+     *           "pnlUsd": "0.21",
+     *           "pnlPercent": "4.00",
+     *           "isRedeemable": false
+     *         }
+     *       }
+     *     ],
+     *     "hasPendingTxs": false
+     *   }
+     * }
+     * ```
+     */
+    getCurrentPositions(): Promise<CurrentPositionsResponse>;
 }
 
 /**
@@ -2050,18 +2253,23 @@ declare class AgentContext {
          *
          * Takes your quote and signs/broadcasts transactions automatically.
          *
-         * **Input**: `SwidgeQuoteData` - Complete quote object from agent.swidge.quote()
+         * Supports both single and bulk execution:
+         * - Pass a single quote → get a single response
+         * - Pass an array of quotes → get an array of responses
          *
-         * **Output**: `SwidgeExecuteResponse`
+         * **Input**: `SwidgeQuoteData | SwidgeQuoteData[]` - Complete quote object(s) from agent.swidge.quote()
+         *
+         * **Output**: `SwidgeExecuteResponse | SwidgeExecuteResponse[]` (matching input type)
          *   - `success`: Whether the execution was successful
          *   - `data`: Execution result with status ("success", "failure", "refund", "delayed") and transaction hashes
          *   - `error`: Error message if execution failed
          *
-         * @param quoteData - Complete quote object from agent.swidge.quote()
+         * @param quoteData - Complete quote object(s) from agent.swidge.quote()
          * @returns Promise resolving to SwidgeExecuteResponse with transaction status
          *
          * @example
          * ```typescript
+         * // Single execution
          * const quote = await agent.swidge.quote({...});
          * if (quote.success && quote.data) {
          *   const result = await agent.swidge.execute(quote.data);
@@ -2072,9 +2280,20 @@ declare class AgentContext {
          *     }
          *   }
          * }
+         *
+         * // Bulk execution
+         * const results = await agent.swidge.execute([quote.data, quote2.data]);
+         * results.forEach((result, index) => {
+         *   if (result.success && result.data) {
+         *     console.log(`Swap ${index + 1} status: ${result.data.status}`);
+         *   }
+         * });
          * ```
          */
-        execute: (quoteData: SwidgeQuoteData) => Promise<SwidgeExecuteResponse>;
+        execute: {
+            (quoteData: SwidgeQuoteData): Promise<SwidgeExecuteResponse>;
+            (quoteData: SwidgeQuoteData[]): Promise<SwidgeExecuteResponse[]>;
+        };
     };
     /**
      * Get transaction ledger with asset changes.
@@ -2125,6 +2344,76 @@ declare class AgentContext {
      * ```
      */
     transactions(): Promise<TransactionsResponse>;
+    /**
+     * Get current live positions for the session.
+     *
+     * Retrieves all current positions held by the session wallet with live balance data.
+     * For ERC1155 positions (e.g., Polymarket), automatically enriches the response with
+     * detailed market metadata including PNL, current prices, and redeemability status.
+     *
+     * **Output**: `CurrentPositionsResponse`
+     *   - `success` (boolean): Whether the operation succeeded
+     *   - `data` (CurrentPositionsData | undefined): Current positions data on success
+     *     - `hasPendingTxs` (boolean): Whether there are pending transactions
+     *     - `positions` (EnrichedPosition[]): Array of current positions
+     *       - `network` (string): Network identifier (e.g., "ethereum:137")
+     *       - `assetAddress` (string): Token/asset contract address
+     *       - `tokenId` (string | null): Token ID for NFTs/ERC1155 (null for fungible)
+     *       - `avgUnitCost` (string): Average unit cost in USD
+     *       - `currentQty` (string): Current quantity held (raw amount)
+     *       - `polymarketMetadata` (optional): Detailed Polymarket position data
+     *         - `question` (string): Market question text
+     *         - `outcome` (string): Outcome name (e.g., "Yes", "No")
+     *         - `formattedShares` (string): Human-readable share count
+     *         - `valueUsd` (string): Current position value in USD
+     *         - `priceUsd` (string): Current price per share
+     *         - `averagePriceUsd` (string): Average purchase price
+     *         - `pnlUsd` (string): Unrealized profit/loss in USD
+     *         - `pnlPercent` (string): Unrealized profit/loss percentage
+     *         - `isRedeemable` (boolean): Whether position can be redeemed
+     *         - `endDate` (string): Market end date
+     *         - Plus additional market details
+     *   - `error` (string | undefined): Error message on failure
+     *   - `errorMessage` (string | undefined): Detailed error message on failure
+     *
+     * @returns Promise resolving to CurrentPositionsResponse with enriched positions
+     *
+     * @example
+     * ```typescript
+     * const result = await agent.getCurrentPositions();
+     *
+     * if (result.success && result.data) {
+     *   await agent.log(`Managing ${result.data.positions.length} positions`);
+     *
+     *   if (result.data.hasPendingTxs) {
+     *     await agent.log('⚠️  Warning: Pending transactions may affect balances');
+     *   }
+     *
+     *   // Iterate through positions
+     *   for (const position of result.data.positions) {
+     *     await agent.log(`Position: ${position.assetAddress}`);
+     *     await agent.log(`  Quantity: ${position.currentQty}`);
+     *     await agent.log(`  Avg Cost: $${position.avgUnitCost}`);
+     *
+     *     // Check for Polymarket enrichment
+     *     if (position.polymarketMetadata) {
+     *       const pm = position.polymarketMetadata;
+     *       await agent.log(`  Market: ${pm.question}`);
+     *       await agent.log(`  Outcome: ${pm.outcome}`);
+     *       await agent.log(`  Value: $${pm.valueUsd}`);
+     *       await agent.log(`  PNL: $${pm.pnlUsd} (${pm.pnlPercent}%)`);
+     *
+     *       if (pm.isRedeemable) {
+     *         await agent.log('  ✅ This position is redeemable!');
+     *       }
+     *     }
+     *   }
+     * } else {
+     *   await agent.log(result.error || 'Failed to fetch positions', { error: true });
+     * }
+     * ```
+     */
+    getCurrentPositions(): Promise<CurrentPositionsResponse>;
 }
 
 /**
@@ -2271,4 +2560,4 @@ declare function isSolanaNetwork(network: Network): network is "solana";
  */
 declare function getChainIdFromNetwork(network: `ethereum:${number}`): number;
 
-export { APIClient, Agent, AgentContext, AgentSdk, type AssetChange, type CurrentPosition, type LogResponse, type MemoryDeleteResponse, type MemoryGetResponse, type MemoryListResponse, type MemorySetResponse, type Network, type PolymarketMarketOrderRequest, type PolymarketMarketOrderResponse, 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, type TransactionsResponse, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork, type runFunctionContract };
+export { APIClient, Agent, AgentContext, AgentSdk, type AssetChange, type CurrentPosition, type CurrentPositionsData, type CurrentPositionsResponse, type EnrichedPosition, type LogResponse, type MemoryDeleteResponse, type MemoryGetResponse, type MemoryListResponse, type MemorySetResponse, type Network, type PolymarketMarketOrderRequest, type PolymarketMarketOrderResponse, 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, type TransactionsResponse, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork, type runFunctionContract };

package/index.js

@@ -1 +1 @@
-import{loadAuthFromFileSystem as e}from"./chunk-4I3A6QAK.js";var r=class{config;baseUrl;authorizationHeader;isCloudflareWorker(){return"undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare}hasServiceBinding(){if(this.isCloudflareWorker()){if(void 0!==globalThis.AGENTS_TO_API_PROXY)return!0;if(void 0!==globalThis.__AGENT_ENV__&&globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)return!0}return!1}constructor(e){this.config=e,this.baseUrl=e.baseUrl||"https://agents.circuit.org",this.authorizationHeader=e.authorizationHeader}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 e={};e["X-Session-Id"]=this.config.sessionId.toString();const r=this.getAgentSlug();if(r&&(e["X-Agent-Slug"]=r),this.isCloudflareWorker())return e;if(this.authorizationHeader)return e.Authorization=this.authorizationHeader,e;try{const r=this.loadAuthConfig();r?.sessionToken&&(e.Authorization=`Bearer ${r.sessionToken}`)}catch{}return e}loadAuthConfig(){try{return e()}catch{}}async makeRequest(e,r={}){const t={...{"Content-Type":"application/json",...this.getAuthHeaders()},...r.headers};let s;if(this.hasServiceBinding()){let o;if(void 0!==globalThis.AGENTS_TO_API_PROXY)o=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");o=globalThis.__AGENT_ENV__.AGENTS_TO_API_PROXY}const a={...r,headers:t},n=`https://agents-to-api-proxy.circuit-0bc.workers.dev${e}`;s=await o.fetch(n,a)}else{const o=`${this.baseUrl}${e}`,a={...r,headers:t};s=await fetch(o,a)}if(!s.ok){const e=await s.json().catch(()=>({})),r=e.message||e.error||`HTTP ${s.status}: ${s.statusText}`,t=new Error(r);throw t.error=e.error,t.errorMessage=e.message,t.errorDetails=e,t.statusCode=s.status,t}return await s.json()}async get(e){return this.makeRequest(e,{method:"GET"})}async post(e,r){return this.makeRequest(e,{method:"POST",body:r?JSON.stringify(r):void 0})}async delete(e){return this.makeRequest(e,{method:"DELETE"})}};function t(e){return e.startsWith("ethereum:")}function s(e){return"solana"===e}function o(e){return Number(e.split(":")[1])}var a=class{client;config;constructor(e){this.config=e,this.client=new r(e)}async _sendLog(e){await this.client.post("/v1/logs",e)}async signAndSend(e){try{if(t(e.network)){const r=o(e.network);if("toAddress"in e.request)return await this.handleEvmTransaction({chainId:r,toAddress:e.request.toAddress,data:e.request.data,valueWei:e.request.value,message:e.message})}if(s(e.network)&&"hexTransaction"in e.request)return await this.handleSolanaTransaction({hexTransaction:e.request.hexTransaction,message:e.message});const r=`Unsupported network: ${e.network}`;return{success:!1,error:"Unsupported Network",errorMessage:r,errorDetails:{message:r}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async signMessage(e){try{if(t(e.network))return await this.handleEvmSignMessage(e);const r=`Unsupported network: ${e.network}`;return{success:!1,error:"Unsupported Network",errorMessage:r,errorDetails:{message:r}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}swidge={quote:async e=>this.handleSwidgeQuote(e),execute:async e=>this.handleSwidgeExecute(e)};memory={set:async(e,r)=>this.handleMemorySet(e,r),get:async e=>this.handleMemoryGet(e),delete:async e=>this.handleMemoryDelete(e),list:async()=>this.handleMemoryList()};platforms={polymarket:{marketOrder:async e=>this.handlePolymarketMarketOrder(e),redeemPositions:async e=>this.handlePolymarketRedeemPositions(e||{tokenIds:[]})}};async handleEvmTransaction(e){try{const r=await this.client.post("/v1/transactions/evm",e),t=await this.client.post(`/v1/transactions/evm/${r.internalTransactionId}/broadcast`);return{success:!0,data:{internalTransactionId:r.internalTransactionId,txHash:t.txHash,transactionUrl:t.transactionUrl}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async handleSolanaTransaction(e){try{const r=await this.client.post("/v1/transactions/solana",e),t=await this.client.post(`/v1/transactions/solana/${r.internalTransactionId}/broadcast`);return{success:!0,data:{internalTransactionId:r.internalTransactionId,txHash:t.txHash,transactionUrl:t.transactionUrl}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async handleEvmSignMessage(e){try{return{success:!0,data:await this.client.post("/v1/messages/evm",{messageType:e.request.messageType,data:e.request.data,chainId:e.request.chainId})}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async _updateJobStatus(e){try{return await this.client.post(`/v1/jobs/${e.jobId}/status`,e)}catch(e){return{status:400,message:`Failed to update job status: ${e instanceof Error?e.message:"Unknown error"}`}}}async handleSwidgeQuote(e){try{return{success:!0,data:await this.client.post("/v1/swidge/quote",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to get swidge quote";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleSwidgeExecute(e){try{return{success:!0,data:await this.client.post("/v1/swidge/execute",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to execute swidge swap";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handlePolymarketMarketOrder(e){try{return{success:!0,data:await this.client.post("/v1/platforms/polymarket/market-order",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to execute polymarket market order";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handlePolymarketRedeemPositions(e){try{return{success:!0,data:await this.client.post("/v1/platforms/polymarket/redeem-positions",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to redeem polymarket positions";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemorySet(e,r){try{return{success:!0,data:await this.client.post(`/v1/memory/${e}`,{value:r})}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to set memory";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryGet(e){try{return{success:!0,data:await this.client.get(`/v1/memory/${e}`)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to get memory";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryDelete(e){try{return{success:!0,data:await this.client.delete(`/v1/memory/${e}`)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to delete memory";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryList(){try{return{success:!0,data:await this.client.get("/v1/memory/list")}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to list memory keys";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async transactions(){try{return{success:!0,data:await this.client.get("/v1/transactions/ledger")}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to fetch transactions";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}};import{existsSync as n,readFileSync as i}from"fs";import{join as c}from"path";import{zValidator as u}from"@hono/zod-validator";import{Hono as l}from"hono";import{cors as d}from"hono/cors";import*as h from"zod";var m=class{sessionId;sessionWalletAddress;currentPositions;t;constructor(e){this.sessionId=e.sessionId,this.sessionWalletAddress=e.sessionWalletAddress,this.currentPositions=e.currentPositions,this.t=new a({sessionId:e.sessionId,baseUrl:e.baseUrl,authorizationHeader:e.authorizationHeader})}async log(e,r){const{error:t=!1,debug:s=!1}=r||{};let o,a;const n=(e,r)=>{if("bigint"==typeof r)return r.toString();if("function"==typeof r)return`[Function: ${r.name||"anonymous"}]`;if(void 0===r)return"[undefined]";if(null===r)return null;if("object"==typeof r&&!Array.isArray(r)&&r.toString!==Object.prototype.toString)try{const e=r.toString();if("[object Object]"!==e)return e}catch(e){}return r};if("object"==typeof e&&null!==e?(o=JSON.stringify(e,n,2),a=JSON.stringify(e,n)):(o=String(e),a=String(e)),t?console.error(o):console.log(o),s)return{success:!0};const i=t?"error":"observe";try{const e=a.length>250?a.slice(0,250):a;return await this.t._sendLog([{type:i,shortMessage:e}]),{success:!0}}catch(e){const r=e instanceof Error?e.message:"Failed to send log";return console.error(`Failed to send log to backend: ${r}`),{success:!1,error:"Log Error",errorMessage:r,errorDetails:{message:r,type:e instanceof Error?e.constructor.name:"UnknownError"}}}}async signAndSend(e){return this.t.signAndSend(e)}async signMessage(e){return this.t.signMessage(e)}memory={set:async(e,r)=>this.t.memory.set(e,r),get:async e=>this.t.memory.get(e),delete:async e=>this.t.memory.delete(e),list:async()=>this.t.memory.list()};platforms={polymarket:{marketOrder:async e=>this.t.platforms.polymarket.marketOrder(e),redeemPositions:async e=>this.t.platforms.polymarket.redeemPositions(e)}};swidge={quote:async e=>this.t.swidge.quote(e),execute:async e=>this.t.swidge.execute(e)};async transactions(){return this.t.transactions()}},g=h.object({network:h.string(),assetAddress:h.string(),tokenId:h.string().nullable(),avgUnitCost:h.string(),currentQty:h.string()}),y=h.object({sessionId:h.number(),sessionWalletAddress:h.string(),jobId:h.string().optional(),currentPositions:h.array(g)}),p=(h.object({status:h.string()}),class{app;runFunction;stopFunction;healthCheckFunction=async()=>({status:"healthy",timestamp:(new Date).toISOString()});constructor(e){this.app=new l,this.runFunction=e.runFunction,this.stopFunction=e.stopFunction,this.app.use("*",d()),this.setupRoutes()}defaultStopFunction=async e=>{await e.log(`Agent stopped for session ${e.sessionId}`)};async executeWithJobTracking(e,r,t){let s,o=!1;try{const s=new m({sessionId:e.sessionId,sessionWalletAddress:e.sessionWalletAddress,currentPositions:e.currentPositions,authorizationHeader:t});await r(s),o=!0}catch(e){s=this.getErrorMessage(e),o=!1,console.error("Agent function error:",s)}finally{e.jobId&&await this.updateJobStatus(e.sessionId,e.jobId,o?"success":"failed",s,t)}}getErrorMessage(e){if(null==e)return"Unknown error";try{const r=e?.constructor?.name||"Error";let t="";t=e instanceof Error&&e.message||String(e),t=t.replace(/[^\x20-\x7E\n\t]/g,"");const s=`${r}: ${t}`;return s.length>1e3?`${s.substring(0,997)}...`:s}catch{return"Unknown error (message extraction failed)"}}async updateJobStatus(e,r,t,s,o){const n=new a({sessionId:e,authorizationHeader:o});for(let e=1;e<=3;e++)try{return void await n._updateJobStatus({jobId:r,status:t,errorMessage:s})}catch(r){console.error(`Status update attempt ${e}/3 failed:`,r),e<3&&await new Promise(r=>setTimeout(r,100*2**(e-1)))}if("failed"===t)try{return console.warn(`Issue updating job status to '${t}' with error message, attempting to update status without error message`),void await n._updateJobStatus({jobId:r,status:t,errorMessage:void 0})}catch(e){console.error(`CRITICAL: Failed to update job ${r} status. Likely API connectivity issue:`,e)}else console.error(`CRITICAL: Failed to update job ${r} status to success after 3 attempts`)}setupRoutes(){this.app.post("/run",u("json",y),async e=>{const r=e.req.valid("json"),t=e.req.header("Authorization");return await this.executeWithJobTracking(r,this.runFunction,t),e.json({success:!0,message:"Execution completed"})}),this.app.post("/execute",u("json",y),async e=>{const r=e.req.valid("json"),t=e.req.header("Authorization");return await this.executeWithJobTracking(r,this.runFunction,t),e.json({success:!0,message:"Execution completed"})}),this.app.post("/stop",u("json",y),async e=>{const r=e.req.valid("json"),t=e.req.header("Authorization"),s=this.stopFunction||this.defaultStopFunction;return await this.executeWithJobTracking(r,s,t),e.json({success:!0,message:"Stop completed"})}),this.app.get("/health",async e=>{try{const r=await this.healthCheckFunction();return e.json(r)}catch(r){return console.error("Agent health check error:",r),e.json({status:"unhealthy",error:r instanceof Error?r.message:"Unknown error",timestamp:(new Date).toISOString()},500)}})}getPortFromPackageJson(){try{const e=c(process.cwd(),"package.json");if(n(e)){const r=JSON.parse(i(e,"utf-8"));if(r.circuit?.port)return console.log("⚠️  Warning: circuit.port in package.json is deprecated. Use AGENT_PORT environment variable instead."),Number.parseInt(r.circuit.port,10)}}catch(e){console.log("Could not read package.json for port configuration")}return null}async run(e){if("undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare)return this.getExport();const r=globalThis.Bun?.env,t=process.env.AGENT_PORT||r?.AGENT_PORT,s=this.getPortFromPackageJson();let o=e;!o&&t&&(o=Number.parseInt(t,10)),!o&&s&&(o=s),o||(o=3e3),console.log("🔧 Agent configuration:"),console.log(`   Explicit port parameter: ${e||"not set"}`),console.log(`   process.env.AGENT_PORT: ${process.env.AGENT_PORT||"not set"}`),console.log(`   Bun.env.AGENT_PORT: ${r?.AGENT_PORT||"not set"}`),console.log(`   package.json circuit.port: ${s||"not set"} (deprecated)`),console.log(`   Final port: ${o}`);try{const{serve:e}=await import("@hono/node-server");console.log(`🚀 Server is running on port ${o}`),console.log("📍 Available endpoints: GET /health, POST /run, POST /execute (backward compat), POST /stop"),e({fetch:this.app.fetch,port:o})}catch(e){console.error("Failed to start local server. @hono/node-server is not available."),console.error("For local development, install @hono/node-server: npm install @hono/node-server"),process.exit(1)}}getExport(){return{fetch:async(e,r,t)=>(r&&"undefined"!=typeof globalThis&&(globalThis.__AGENT_ENV__=r),this.app.fetch(e,r,t))}}});import{z as f}from"zod";var w=f.templateLiteral(["ethereum:",f.coerce.number().int().nonnegative()]),v=f.union([f.literal("solana"),w]),E=f.object({address:f.string(),network:v}),T=(f.object({from:E,to:E,fromToken:f.string().optional(),toToken:f.string().optional(),amount:f.string(),slippage:f.string().optional()}),f.object({network:v,address:f.string(),token:f.string().nullable(),name:f.string().optional(),symbol:f.string().optional(),decimals:f.number().optional(),amount:f.string().optional(),minimumAmount:f.string().optional(),amountFormatted:f.string().optional(),amountUsd:f.string().optional()})),b=f.object({usd:f.string().optional(),percentage:f.string().optional()}),k=f.object({name:f.string(),amount:f.string().optional(),amountFormatted:f.string().optional(),amountUsd:f.string().optional()}),D=f.object({programId:f.string(),keys:f.array(f.object({pubkey:f.string(),isSigner:f.boolean(),isWritable:f.boolean()})),data:f.union([f.string(),f.instanceof(Buffer)])}),S=f.object({type:f.literal("evm"),from:f.string().regex(/^0x[a-fA-F0-9]{40}$/),to:f.string().regex(/^0x[a-fA-F0-9]{40}$/),chainId:f.number(),value:f.number(),data:f.string().regex(/^0x[a-fA-F0-9]*$/),gas:f.number().nullish(),maxFeePerGas:f.number().nullish(),maxPriorityFeePerGas:f.number().nullish()}),A=f.object({type:f.literal("solana"),instructions:f.array(D),addressLookupTableAddresses:f.array(f.string())}),M=f.object({type:f.literal("transaction"),description:f.string(),transactionDetails:f.union([S,A]),metadata:f.record(f.string(),f.string())}),F=f.object({type:f.literal("signature"),description:f.string(),signatureData:f.string(),metadata:f.record(f.string(),f.string())}),$=f.discriminatedUnion("type",[M,F]),O=f.object({engine:f.literal("relay"),assetSend:T,assetReceive:T,priceImpact:b,fees:f.array(k),steps:f.array($)}),U=f.object({network:f.string(),txs:f.array(f.string())}),x=f.object({status:f.union([f.literal("success"),f.literal("failure"),f.literal("refund"),f.literal("delayed")]),in:U,out:U,lastUpdated:f.number()}),I={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"},P=e=>f.object({success:f.boolean(),data:e.optional(),error:f.string().optional(),errorMessage:f.string().optional(),errorDetails:f.object({message:f.string().optional(),error:f.string().optional(),status:f.number().optional(),statusText:f.string().optional()}).optional()});P(O),P(x);export{r as APIClient,p as Agent,m as AgentContext,a as AgentSdk,I as QUOTE_RESULT,o as getChainIdFromNetwork,t as isEthereumNetwork,s as isSolanaNetwork};
+import{loadAuthFromFileSystem as e}from"./chunk-4I3A6QAK.js";var r=class{config;baseUrl;authorizationHeader;isCloudflareWorker(){return"undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare}hasServiceBinding(){if(this.isCloudflareWorker()){if(void 0!==globalThis.AGENTS_TO_API_PROXY)return!0;if(void 0!==globalThis.__AGENT_ENV__&&globalThis.__AGENT_ENV__?.AGENTS_TO_API_PROXY)return!0}return!1}constructor(e){this.config=e,this.baseUrl=e.baseUrl||"https://agents.circuit.org",this.authorizationHeader=e.authorizationHeader}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 e={};e["X-Session-Id"]=this.config.sessionId.toString();const r=this.getAgentSlug();if(r&&(e["X-Agent-Slug"]=r),this.isCloudflareWorker())return e;if(this.authorizationHeader)return e.Authorization=this.authorizationHeader,e;try{const r=this.loadAuthConfig();r?.sessionToken&&(e.Authorization=`Bearer ${r.sessionToken}`)}catch{}return e}loadAuthConfig(){try{return e()}catch{}}async makeRequest(e,r={}){const t={...{"Content-Type":"application/json",...this.getAuthHeaders()},...r.headers};let s;if(this.hasServiceBinding()){let o;if(void 0!==globalThis.AGENTS_TO_API_PROXY)o=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");o=globalThis.__AGENT_ENV__.AGENTS_TO_API_PROXY}const a={...r,headers:t},n=`https://agents-to-api-proxy.circuit-0bc.workers.dev${e}`;s=await o.fetch(n,a)}else{const o=`${this.baseUrl}${e}`,a={...r,headers:t};s=await fetch(o,a)}if(!s.ok){const e=await s.json().catch(()=>({})),r=e.message||e.error||`HTTP ${s.status}: ${s.statusText}`,t=new Error(r);throw t.error=e.error,t.errorMessage=e.message,t.errorDetails=e,t.statusCode=s.status,t}return await s.json()}async get(e){return this.makeRequest(e,{method:"GET"})}async post(e,r){return this.makeRequest(e,{method:"POST",body:r?JSON.stringify(r):void 0})}async delete(e){return this.makeRequest(e,{method:"DELETE"})}};function t(e){return e.startsWith("ethereum:")}function s(e){return"solana"===e}function o(e){return Number(e.split(":")[1])}var a=class{client;config;constructor(e){this.config=e,this.client=new r(e)}async _sendLog(e){await this.client.post("/v1/logs",e)}async signAndSend(e){try{if(t(e.network)){const r=o(e.network);if("toAddress"in e.request)return await this.handleEvmTransaction({chainId:r,toAddress:e.request.toAddress,data:e.request.data,valueWei:e.request.value,message:e.message})}if(s(e.network)&&"hexTransaction"in e.request)return await this.handleSolanaTransaction({hexTransaction:e.request.hexTransaction,message:e.message});const r=`Unsupported network: ${e.network}`;return{success:!1,error:"Unsupported Network",errorMessage:r,errorDetails:{message:r}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async signMessage(e){try{if(t(e.network))return await this.handleEvmSignMessage(e);const r=`Unsupported network: ${e.network}`;return{success:!1,error:"Unsupported Network",errorMessage:r,errorDetails:{message:r}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}swidge={quote:async e=>this.handleSwidgeQuote(e),execute:function(e){return this.handleSwidgeExecute(e)}.bind(this)};memory={set:async(e,r)=>this.handleMemorySet(e,r),get:async e=>this.handleMemoryGet(e),delete:async e=>this.handleMemoryDelete(e),list:async()=>this.handleMemoryList()};platforms={polymarket:{marketOrder:async e=>this.handlePolymarketMarketOrder(e),redeemPositions:async e=>this.handlePolymarketRedeemPositions(e||{tokenIds:[]})}};async handleEvmTransaction(e){try{const r=await this.client.post("/v1/transactions/evm",e),t=await this.client.post(`/v1/transactions/evm/${r.internalTransactionId}/broadcast`);return{success:!0,data:{internalTransactionId:r.internalTransactionId,txHash:t.txHash,transactionUrl:t.transactionUrl}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async handleSolanaTransaction(e){try{const r=await this.client.post("/v1/transactions/solana",e),t=await this.client.post(`/v1/transactions/solana/${r.internalTransactionId}/broadcast`);return{success:!0,data:{internalTransactionId:r.internalTransactionId,txHash:t.txHash,transactionUrl:t.transactionUrl}}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async handleEvmSignMessage(e){try{return{success:!0,data:await this.client.post("/v1/messages/evm",{messageType:e.request.messageType,data:e.request.data,chainId:e.request.chainId})}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{};return r||t?{success:!1,error:r,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:e instanceof Error?e.message:"Unknown error",errorDetails:{}}}}async _updateJobStatus(e){try{return await this.client.post(`/v1/jobs/${e.jobId}/status`,e)}catch(e){return{status:400,message:`Failed to update job status: ${e instanceof Error?e.message:"Unknown error"}`}}}async handleSwidgeQuote(e){try{return{success:!0,data:await this.client.post("/v1/swidge/quote",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to get swidge quote";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleSwidgeExecute(e){try{const r=await this.client.post("/v1/swidge/execute",e);if(Array.isArray(r))return r.map(e=>{const r="success"===e.status;return{success:r,data:e,error:r?void 0:e.error}});const t="success"===r.status;return{success:t,data:r,error:t?void 0:r.error}}catch(r){const t=r.error,s=r.errorMessage,o=r.errorDetails||{},a=r instanceof Error?r.message:"Failed to execute swidge swap";return Array.isArray(e)?[{success:!1,error:t||"SDK Error",errorMessage:s||a,errorDetails:o}]:{success:!1,error:t||"SDK Error",errorMessage:s||a,errorDetails:o}}}async handlePolymarketMarketOrder(e){try{return{success:!0,data:await this.client.post("/v1/platforms/polymarket/market-order",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to execute polymarket market order";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handlePolymarketRedeemPositions(e){try{return{success:!0,data:await this.client.post("/v1/platforms/polymarket/redeem-positions",e)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to redeem polymarket positions";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemorySet(e,r){try{return{success:!0,data:await this.client.post(`/v1/memory/${e}`,{value:r})}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to set memory";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryGet(e){try{return{success:!0,data:await this.client.get(`/v1/memory/${e}`)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to get memory";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryDelete(e){try{return{success:!0,data:await this.client.delete(`/v1/memory/${e}`)}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to delete memory";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryList(){try{return{success:!0,data:await this.client.get("/v1/memory/list")}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to list memory keys";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async transactions(){try{return{success:!0,data:await this.client.get("/v1/transactions/ledger")}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to fetch transactions";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}async getCurrentPositions(){try{return{success:!0,data:await this.client.get("/v1/positions/current")}}catch(e){const r=e.error,t=e.errorMessage,s=e.errorDetails||{},o=e instanceof Error?e.message:"Failed to fetch current positions";return{success:!1,error:r||"SDK Error",errorMessage:t||o,errorDetails:s}}}};import{existsSync as n,readFileSync as i}from"fs";import{join as c}from"path";import{zValidator as u}from"@hono/zod-validator";import{Hono as l}from"hono";import{cors as d}from"hono/cors";import*as h from"zod";var m=class{sessionId;sessionWalletAddress;currentPositions;t;constructor(e){this.sessionId=e.sessionId,this.sessionWalletAddress=e.sessionWalletAddress,this.currentPositions=e.currentPositions,this.t=new a({sessionId:e.sessionId,baseUrl:e.baseUrl,authorizationHeader:e.authorizationHeader})}async log(e,r){const{error:t=!1,debug:s=!1}=r||{};let o,a;const n=(e,r)=>{if("bigint"==typeof r)return r.toString();if("function"==typeof r)return`[Function: ${r.name||"anonymous"}]`;if(void 0===r)return"[undefined]";if(null===r)return null;if("object"==typeof r&&!Array.isArray(r)&&r.toString!==Object.prototype.toString)try{const e=r.toString();if("[object Object]"!==e)return e}catch(e){}return r};if("object"==typeof e&&null!==e?(o=JSON.stringify(e,n,2),a=JSON.stringify(e,n)):(o=String(e),a=String(e)),t?console.error(o):console.log(o),s)return{success:!0};const i=t?"error":"observe";try{const e=a.length>250?a.slice(0,250):a;return await this.t._sendLog([{type:i,shortMessage:e}]),{success:!0}}catch(e){const r=e instanceof Error?e.message:"Failed to send log";return console.error(`Failed to send log to backend: ${r}`),{success:!1,error:"Log Error",errorMessage:r,errorDetails:{message:r,type:e instanceof Error?e.constructor.name:"UnknownError"}}}}async signAndSend(e){return this.t.signAndSend(e)}async signMessage(e){return this.t.signMessage(e)}memory={set:async(e,r)=>this.t.memory.set(e,r),get:async e=>this.t.memory.get(e),delete:async e=>this.t.memory.delete(e),list:async()=>this.t.memory.list()};platforms={polymarket:{marketOrder:async e=>this.t.platforms.polymarket.marketOrder(e),redeemPositions:async e=>this.t.platforms.polymarket.redeemPositions(e)}};swidge={quote:async e=>this.t.swidge.quote(e),execute:function(e){return this.t.swidge.execute(e)}.bind(this)};async transactions(){return this.t.transactions()}async getCurrentPositions(){return this.t.getCurrentPositions()}},g=h.object({network:h.string(),assetAddress:h.string(),tokenId:h.string().nullable(),avgUnitCost:h.string(),currentQty:h.string()}),y=h.object({sessionId:h.number(),sessionWalletAddress:h.string(),jobId:h.string().optional(),currentPositions:h.array(g)}),p=(h.object({status:h.string()}),class{app;runFunction;stopFunction;healthCheckFunction=async()=>({status:"healthy",timestamp:(new Date).toISOString()});constructor(e){this.app=new l,this.runFunction=e.runFunction,this.stopFunction=e.stopFunction,this.app.use("*",d()),this.setupRoutes()}defaultStopFunction=async e=>{await e.log(`Agent stopped for session ${e.sessionId}`)};async executeWithJobTracking(e,r,t){let s,o=!1;try{const s=new m({sessionId:e.sessionId,sessionWalletAddress:e.sessionWalletAddress,currentPositions:e.currentPositions,authorizationHeader:t});await r(s),o=!0}catch(e){s=this.getErrorMessage(e),o=!1,console.error("Agent function error:",s)}finally{e.jobId&&await this.updateJobStatus(e.sessionId,e.jobId,o?"success":"failed",s,t)}}getErrorMessage(e){if(null==e)return"Unknown error";try{const r=e?.constructor?.name||"Error";let t="";t=e instanceof Error&&e.message||String(e),t=t.replace(/[^\x20-\x7E\n\t]/g,"");const s=`${r}: ${t}`;return s.length>1e3?`${s.substring(0,997)}...`:s}catch{return"Unknown error (message extraction failed)"}}async updateJobStatus(e,r,t,s,o){const n=new a({sessionId:e,authorizationHeader:o});for(let e=1;e<=3;e++)try{return void await n._updateJobStatus({jobId:r,status:t,errorMessage:s})}catch(r){console.error(`Status update attempt ${e}/3 failed:`,r),e<3&&await new Promise(r=>setTimeout(r,100*2**(e-1)))}if("failed"===t)try{return console.warn(`Issue updating job status to '${t}' with error message, attempting to update status without error message`),void await n._updateJobStatus({jobId:r,status:t,errorMessage:void 0})}catch(e){console.error(`CRITICAL: Failed to update job ${r} status. Likely API connectivity issue:`,e)}else console.error(`CRITICAL: Failed to update job ${r} status to success after 3 attempts`)}setupRoutes(){this.app.post("/run",u("json",y),async e=>{const r=e.req.valid("json"),t=e.req.header("Authorization");return await this.executeWithJobTracking(r,this.runFunction,t),e.json({success:!0,message:"Execution completed"})}),this.app.post("/execute",u("json",y),async e=>{const r=e.req.valid("json"),t=e.req.header("Authorization");return await this.executeWithJobTracking(r,this.runFunction,t),e.json({success:!0,message:"Execution completed"})}),this.app.post("/stop",u("json",y),async e=>{const r=e.req.valid("json"),t=e.req.header("Authorization"),s=this.stopFunction||this.defaultStopFunction;return await this.executeWithJobTracking(r,s,t),e.json({success:!0,message:"Stop completed"})}),this.app.get("/health",async e=>{try{const r=await this.healthCheckFunction();return e.json(r)}catch(r){return console.error("Agent health check error:",r),e.json({status:"unhealthy",error:r instanceof Error?r.message:"Unknown error",timestamp:(new Date).toISOString()},500)}})}getPortFromPackageJson(){try{const e=c(process.cwd(),"package.json");if(n(e)){const r=JSON.parse(i(e,"utf-8"));if(r.circuit?.port)return console.log("⚠️  Warning: circuit.port in package.json is deprecated. Use AGENT_PORT environment variable instead."),Number.parseInt(r.circuit.port,10)}}catch(e){console.log("Could not read package.json for port configuration")}return null}async run(e){if("undefined"!=typeof globalThis&&void 0!==globalThis.Cloudflare)return this.getExport();const r=globalThis.Bun?.env,t=process.env.AGENT_PORT||r?.AGENT_PORT,s=this.getPortFromPackageJson();let o=e;!o&&t&&(o=Number.parseInt(t,10)),!o&&s&&(o=s),o||(o=3e3),console.log("🔧 Agent configuration:"),console.log(`   Explicit port parameter: ${e||"not set"}`),console.log(`   process.env.AGENT_PORT: ${process.env.AGENT_PORT||"not set"}`),console.log(`   Bun.env.AGENT_PORT: ${r?.AGENT_PORT||"not set"}`),console.log(`   package.json circuit.port: ${s||"not set"} (deprecated)`),console.log(`   Final port: ${o}`);try{const{serve:e}=await import("@hono/node-server");console.log(`🚀 Server is running on port ${o}`),console.log("📍 Available endpoints: GET /health, POST /run, POST /execute (backward compat), POST /stop"),e({fetch:this.app.fetch,port:o})}catch(e){console.error("Failed to start local server. @hono/node-server is not available."),console.error("For local development, install @hono/node-server: npm install @hono/node-server"),process.exit(1)}}getExport(){return{fetch:async(e,r,t)=>(r&&"undefined"!=typeof globalThis&&(globalThis.__AGENT_ENV__=r),this.app.fetch(e,r,t))}}});import{z as f}from"zod";var w=f.templateLiteral(["ethereum:",f.coerce.number().int().nonnegative()]),v=f.union([f.literal("solana"),w]),E=f.object({address:f.string(),network:v}),T=(f.object({from:E,to:E,fromToken:f.string().optional(),toToken:f.string().optional(),amount:f.string(),slippage:f.string().optional()}),f.object({network:v,address:f.string(),token:f.string().nullable(),name:f.string().optional(),symbol:f.string().optional(),decimals:f.number().optional(),amount:f.string().optional(),minimumAmount:f.string().optional(),amountFormatted:f.string().optional(),amountUsd:f.string().optional()})),b=f.object({usd:f.string().optional(),percentage:f.string().optional()}),k=f.object({name:f.string(),amount:f.string().optional(),amountFormatted:f.string().optional(),amountUsd:f.string().optional()}),D=f.object({programId:f.string(),keys:f.array(f.object({pubkey:f.string(),isSigner:f.boolean(),isWritable:f.boolean()})),data:f.union([f.string(),f.instanceof(Buffer)])}),S=f.object({type:f.literal("evm"),from:f.string().regex(/^0x[a-fA-F0-9]{40}$/),to:f.string().regex(/^0x[a-fA-F0-9]{40}$/),chainId:f.number(),value:f.number(),data:f.string().regex(/^0x[a-fA-F0-9]*$/),gas:f.number().nullish(),maxFeePerGas:f.number().nullish(),maxPriorityFeePerGas:f.number().nullish()}),A=f.object({type:f.literal("solana"),instructions:f.array(D),addressLookupTableAddresses:f.array(f.string())}),M=f.object({type:f.literal("transaction"),description:f.string(),transactionDetails:f.union([S,A]),metadata:f.record(f.string(),f.string())}),F=f.object({type:f.literal("signature"),description:f.string(),signatureData:f.string(),metadata:f.record(f.string(),f.string())}),$=f.discriminatedUnion("type",[M,F]),O=f.object({engine:f.literal("relay"),assetSend:T,assetReceive:T,priceImpact:b,fees:f.array(k),steps:f.array($)}),U=f.object({network:f.string(),txs:f.array(f.string())}),x=f.object({status:f.union([f.literal("success"),f.literal("failure"),f.literal("refund"),f.literal("delayed")]),in:U,out:U,lastUpdated:f.number(),error:f.string().optional()}),I={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"},P=e=>f.object({success:f.boolean(),data:e.optional(),error:f.string().optional(),errorMessage:f.string().optional(),errorDetails:f.object({message:f.string().optional(),error:f.string().optional(),status:f.number().optional(),statusText:f.string().optional()}).optional()});P(O),P(x);export{r as APIClient,p as Agent,m as AgentContext,a as AgentSdk,I as QUOTE_RESULT,o as getChainIdFromNetwork,t as isEthereumNetwork,s as isSolanaNetwork};

package/package.json

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