@circuitorg/agent-sdk 1.3.8 → 1.3.10

package/README.md

@@ -81,19 +81,21 @@ Every agent receives a single `AgentContext` object that provides:
 **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
+#### Starting Asset setup
+> Note: For native tokens, use the canonical native token addresses:
+> - EVM: `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` (EIP-7528)
+> - Solana: `11111111111111111111111111111111` (System Program)
 ```toml
-// Requiring 1 SOL
-[[requiredAssets]]
+# Requiring 1 SOL
+[startingAsset]
 network = "solana"
 address = "11111111111111111111111111111111"
 minimumAmount = "1000000000"
 
-// Requiring 1 ETH
-[[requiredAssets]]
-network = "ethereum:<chainId>"
-address = "0x0000000000000000000000000000000000000000"
+# Requiring 1 ETH
+[startingAsset]
+network = "ethereum:1"
+address = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
 minimumAmount = "1000000000000000000"
 ```
 

package/index.d.ts

@@ -18,6 +18,11 @@ type SignAndSendRequest = {
     network: Network;
     /** Optional short message to be attached to the transaction for observability */
     message?: string;
+    /**
+     * ISO 8601 timestamp for when the suggestion expires (only used in manual mode).
+     * If not provided, the suggestion never expires.
+     */
+    expiresAt?: string | null;
 } & ({
     network: `ethereum:${number}`;
     request: {
@@ -32,36 +37,32 @@ type SignAndSendRequest = {
     };
 });
 /**
- * Success data from signAndSend operations
+ * SignAndSend response with union type for manual mode support
  */
-type SignAndSendData = {
-    /** Internal transaction ID for tracking */
-    internalTransactionId: number;
-    /** Transaction hash once broadcast */
-    txHash: string;
-    /** Optional transaction URL (explorer link) */
-    transactionUrl?: string;
-};
+declare const SignAndSendResponseSchema: z$1.ZodObject<{
+    success: z$1.ZodBoolean;
+    data: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodObject<{
+        internalTransactionId: z$1.ZodNumber;
+        txHash: z$1.ZodString;
+        transactionUrl: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        suggested: z$1.ZodLiteral<true>;
+        suggestionId: z$1.ZodNumber;
+        details: z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>;
+    }, z$1.core.$strip>]>>;
+    error: z$1.ZodOptional<z$1.ZodString>;
+    errorMessage: z$1.ZodOptional<z$1.ZodString>;
+    errorDetails: z$1.ZodOptional<z$1.ZodObject<{
+        message: z$1.ZodOptional<z$1.ZodString>;
+        error: z$1.ZodOptional<z$1.ZodString>;
+        status: z$1.ZodOptional<z$1.ZodNumber>;
+        statusText: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>>;
+}, z$1.core.$strip>;
 /**
- * Standard response from signAndSend operations
+ * Standard response from signAndSend operations (TypeScript type)
  */
-type SignAndSendResponse = {
-    /** Whether the operation was successful */
-    success: boolean;
-    /** Transaction data (only present on success) */
-    data?: SignAndSendData;
-    /** Error category from API (only present on failure) */
-    error?: string;
-    /** Detailed error message from API (only present on failure) */
-    errorMessage?: string;
-    /** Detailed error information (only present on failure) */
-    errorDetails?: {
-        message?: string;
-        error?: string;
-        status?: number;
-        statusText?: string;
-    };
-};
+type SignAndSendResponse = z$1.infer<typeof SignAndSendResponseSchema>;
 /**
  * EIP712 TypedData schema for typed message signing
  */
@@ -413,6 +414,7 @@ declare const SwidgeQuoteDataSchema: z$1.ZodObject<{
 }, z$1.core.$strip>;
 /**
  * Execute request schema - takes the complete quote response from quote() method
+ * with optional manual mode options
  */
 declare const SwidgeExecuteRequestSchema: z$1.ZodObject<{
     engine: z$1.ZodString;
@@ -472,6 +474,7 @@ declare const SwidgeExecuteRequestSchema: z$1.ZodObject<{
         description: z$1.ZodString;
         signatureData: z$1.ZodString;
     }, z$1.core.$strip>], "type">>;
+    expiresAt: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodOptional<z$1.ZodString>>>;
 }, z$1.core.$strip>;
 /**
  * Quote result constants - type QUOTE_RESULT. to see available options
@@ -564,11 +567,11 @@ declare const SwidgeQuoteResponseWrapperSchema: z$1.ZodObject<{
     }, z$1.core.$strip>>;
 }, z$1.core.$loose>;
 /**
- * Swidge execute response wrapper
+ * Swidge execute response wrapper with union type for manual mode support
  */
 declare const SwidgeExecuteResponseWrapperSchema: z$1.ZodObject<{
     success: z$1.ZodBoolean;
-    data: z$1.ZodOptional<z$1.ZodObject<{
+    data: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodObject<{
         status: z$1.ZodString;
         in: z$1.ZodOptional<z$1.ZodObject<{
             network: z$1.ZodString;
@@ -580,7 +583,11 @@ declare const SwidgeExecuteResponseWrapperSchema: z$1.ZodObject<{
         }, z$1.core.$strip>>;
         lastUpdated: z$1.ZodNumber;
         error: z$1.ZodOptional<z$1.ZodString>;
-    }, z$1.core.$strip>>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        suggested: z$1.ZodLiteral<true>;
+        suggestionId: z$1.ZodNumber;
+        details: z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>;
+    }, z$1.core.$strip>]>>;
     error: z$1.ZodOptional<z$1.ZodString>;
     errorMessage: z$1.ZodOptional<z$1.ZodString>;
     errorDetails: z$1.ZodOptional<z$1.ZodObject<{
@@ -602,20 +609,31 @@ declare const PolymarketMarketOrderRequestSchema: z$1.ZodObject<{
         BUY: "BUY";
         SELL: "SELL";
     }>;
+    expiresAt: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodOptional<z$1.ZodString>>>;
 }, z$1.core.$strip>;
 declare const PolymarketRedeemPositionsRequestSchema: z$1.ZodObject<{
     tokenIds: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>>;
 }, z$1.core.$strip>;
+/**
+ * Polymarket market order response with union type for manual mode support
+ */
 declare const PolymarketMarketOrderResponseSchema: z$1.ZodObject<{
     success: z$1.ZodBoolean;
-    data: z$1.ZodOptional<z$1.ZodObject<{
-        orderId: z$1.ZodString;
-        side: z$1.ZodString;
-        size: z$1.ZodString;
-        priceUsd: z$1.ZodString;
-        totalPriceUsd: z$1.ZodString;
-        txHashes: z$1.ZodArray<z$1.ZodString>;
-    }, z$1.core.$strip>>;
+    data: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodObject<{
+        success: z$1.ZodBoolean;
+        orderInfo: z$1.ZodObject<{
+            orderId: z$1.ZodString;
+            side: z$1.ZodString;
+            size: z$1.ZodString;
+            priceUsd: z$1.ZodString;
+            totalPriceUsd: z$1.ZodString;
+            txHashes: z$1.ZodArray<z$1.ZodString>;
+        }, z$1.core.$strip>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        suggested: z$1.ZodLiteral<true>;
+        suggestionId: z$1.ZodNumber;
+        details: z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>;
+    }, z$1.core.$strip>]>>;
     error: z$1.ZodOptional<z$1.ZodString>;
     errorMessage: z$1.ZodOptional<z$1.ZodString>;
     errorDetails: z$1.ZodOptional<z$1.ZodObject<{
@@ -662,7 +680,7 @@ declare const PolymarketRedeemPositionsResponseSchema: z$1.ZodObject<{
         statusText: z$1.ZodOptional<z$1.ZodString>;
     }, z$1.core.$strip>>;
 }, z$1.core.$loose>;
-type PolymarketMarketOrderRequest = z$1.infer<typeof PolymarketMarketOrderRequestSchema>;
+type PolymarketMarketOrderRequest = z$1.input<typeof PolymarketMarketOrderRequestSchema>;
 type PolymarketRedeemPositionsRequest = z$1.infer<typeof PolymarketRedeemPositionsRequestSchema>;
 type PolymarketMarketOrderResponse = z$1.infer<typeof PolymarketMarketOrderResponseSchema>;
 type PolymarketRedeemPositionsResponse = z$1.infer<typeof PolymarketRedeemPositionsResponseSchema>;
@@ -691,6 +709,7 @@ declare const HyperliquidPlaceOrderRequestSchema: z$1.ZodObject<{
     triggerPrice: z$1.ZodOptional<z$1.ZodNumber>;
     reduceOnly: z$1.ZodOptional<z$1.ZodBoolean>;
     postOnly: z$1.ZodOptional<z$1.ZodBoolean>;
+    expiresAt: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodOptional<z$1.ZodString>>>;
 }, z$1.core.$strip>;
 /**
  * Request to transfer between spot and perp accounts on Hyperliquid
@@ -698,10 +717,14 @@ declare const HyperliquidPlaceOrderRequestSchema: z$1.ZodObject<{
 declare const HyperliquidTransferRequestSchema: z$1.ZodObject<{
     amount: z$1.ZodNumber;
     toPerp: z$1.ZodBoolean;
+    expiresAt: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodOptional<z$1.ZodString>>>;
 }, z$1.core.$strip>;
+/**
+ * Hyperliquid place order response with union type for manual mode support
+ */
 declare const HyperliquidPlaceOrderResponseSchema: z$1.ZodObject<{
     success: z$1.ZodBoolean;
-    data: z$1.ZodOptional<z$1.ZodObject<{
+    data: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodObject<{
         orderId: z$1.ZodString;
         symbol: z$1.ZodString;
         side: z$1.ZodString;
@@ -711,7 +734,11 @@ declare const HyperliquidPlaceOrderResponseSchema: z$1.ZodObject<{
         status: z$1.ZodString;
         market: z$1.ZodString;
         clientOrderId: z$1.ZodOptional<z$1.ZodString>;
-    }, z$1.core.$strip>>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        suggested: z$1.ZodLiteral<true>;
+        suggestionId: z$1.ZodNumber;
+        details: z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>;
+    }, z$1.core.$strip>]>>;
     error: z$1.ZodOptional<z$1.ZodString>;
 }, z$1.core.$loose>;
 declare const HyperliquidOrderResponseSchema: z$1.ZodObject<{
@@ -833,8 +860,8 @@ declare const HyperliquidLiquidationsResponseSchema: z$1.ZodObject<{
     }, z$1.core.$strip>>>;
     error: z$1.ZodOptional<z$1.ZodString>;
 }, z$1.core.$loose>;
-type HyperliquidPlaceOrderRequest = z$1.infer<typeof HyperliquidPlaceOrderRequestSchema>;
-type HyperliquidTransferRequest = z$1.infer<typeof HyperliquidTransferRequestSchema>;
+type HyperliquidPlaceOrderRequest = z$1.input<typeof HyperliquidPlaceOrderRequestSchema>;
+type HyperliquidTransferRequest = z$1.input<typeof HyperliquidTransferRequestSchema>;
 type HyperliquidPlaceOrderResponse = z$1.infer<typeof HyperliquidPlaceOrderResponseSchema>;
 type HyperliquidOrderResponse = z$1.infer<typeof HyperliquidOrderResponseSchema>;
 type HyperliquidDeleteOrderResponse = z$1.infer<typeof HyperliquidDeleteOrderResponseSchema>;
@@ -928,6 +955,187 @@ type MemoryGetResponse = z$1.infer<typeof MemoryGetResponseSchema>;
 type MemoryDeleteResponse = z$1.infer<typeof MemoryDeleteResponseSchema>;
 type MemoryListResponse = z$1.infer<typeof MemoryListResponseSchema>;
 
+/**
+ * Manual execution mode types for suggested transactions.
+ *
+ * When a session is in "manual" mode, transaction operations return
+ * suggested transactions instead of executing them immediately.
+ */
+
+/**
+ * Execution mode for agent sessions
+ * - "auto": Transactions execute immediately (default behavior)
+ * - "manual": Transactions are stored as suggestions for user approval
+ */
+type ExecutionMode = "auto" | "manual";
+/**
+ * Empty data constant for Ethereum transactions.
+ * Use this for simple transfers without any contract interaction.
+ *
+ * @example
+ * ```typescript
+ * await agent.signAndSend({
+ *   network: "ethereum:1",
+ *   request: {
+ *     toAddress: recipientAddress,
+ *     data: EMPTY_DATA,
+ *     value: "1000000000000000000", // 1 ETH
+ *   }
+ * });
+ * ```
+ */
+declare const EMPTY_DATA: "0x";
+/**
+ * Type alias for Ethereum addresses.
+ * Ensures addresses start with "0x" followed by 40 hex characters.
+ */
+type EthereumAddress = `0x${string}`;
+/**
+ * Type alias for Ethereum data/calldata.
+ * Must start with "0x" followed by even number of hex characters.
+ */
+type EthereumData = `0x${string}`;
+/**
+ * Base data structure for all suggested transaction responses.
+ * Nested under the `data` field in the response.
+ */
+interface SuggestedTransactionData {
+    /** Indicates this is a suggested transaction, not an executed one */
+    suggested: true;
+    /** Unique identifier for the suggestion record */
+    suggestionId: number;
+    /** Transaction details for display to the user */
+    details: Record<string, unknown>;
+}
+/**
+ * Type guard to check if a response is a suggested transaction
+ *
+ * @example
+ * ```typescript
+ * const swap = await agent.swidge.execute(quote.data);
+ * if (isSuggestedTransaction(swap)) {
+ *   console.log(`Suggestion ID: ${swap.data.suggestionId}`);
+ * } else {
+ *   console.log(`Executed: ${swap.data}`);
+ * }
+ * ```
+ */
+declare function isSuggestedTransaction<T extends {
+    success: boolean;
+    data?: unknown;
+}>(response: T): response is T & {
+    success: true;
+    data: SuggestedTransactionData;
+};
+/**
+ * Generic type guard to check if a response is successful and has data
+ *
+ * @example
+ * ```typescript
+ * const result = await agent.memory.get("key");
+ * if (isSuccessResponse(result)) {
+ *   // TypeScript knows result.data exists and is defined
+ *   console.log(result.data.value);
+ * }
+ * ```
+ */
+declare function isSuccessResponse<T>(response: {
+    success: boolean;
+    data?: T;
+    error?: string;
+    errorMessage?: string;
+}): response is {
+    success: true;
+    data: T;
+};
+/**
+ * Type guard to check if swap data is an executed swap (not a suggestion)
+ *
+ * @example
+ * ```typescript
+ * import type { SwidgeExecuteData, SuggestedTransactionData } from "@circuitorg/agent-sdk";
+ *
+ * const swap = await agent.swidge.execute(quote.data);
+ * if (swap.success && swap.data) {
+ *   if (isSwidgeExecuted(swap.data)) {
+ *     console.log(`Swap executed: ${swap.data.out?.txs[0]}`);
+ *   } else {
+ *     console.log(`Swap suggested: ${swap.data.suggestionId}`);
+ *   }
+ * }
+ * ```
+ */
+declare function isSwidgeExecuted(data: unknown): data is {
+    out?: {
+        txs?: string[];
+    };
+};
+/**
+ * Type guard to check if Polymarket order data is an executed order (not a suggestion)
+ *
+ * @example
+ * ```typescript
+ * const order = await agent.platforms.polymarket.marketOrder({...});
+ * if (order.success && order.data) {
+ *   if (isPolymarketExecuted(order.data)) {
+ *     console.log(`Order executed: ${order.data.orderInfo}`);
+ *   } else {
+ *     console.log(`Order suggested: ${order.data.suggestionId}`);
+ *   }
+ * }
+ * ```
+ */
+declare function isPolymarketExecuted(data: unknown): data is {
+    success: boolean;
+    orderInfo: unknown;
+};
+/**
+ * Type guard to check if Hyperliquid order data is an executed order (not a suggestion)
+ *
+ * @example
+ * ```typescript
+ * const order = await agent.platforms.hyperliquid.placeOrder({...});
+ * if (order.success && order.data) {
+ *   if (isHyperliquidExecuted(order.data)) {
+ *     console.log(`Order ID: ${order.data.orderId}`);
+ *   } else {
+ *     console.log(`Order suggested: ${order.data.suggestionId}`);
+ *   }
+ * }
+ * ```
+ */
+declare function isHyperliquidExecuted(data: unknown): data is {
+    orderId: string;
+};
+/**
+ * Type guard to check if transaction data is an executed transaction (not a suggestion)
+ *
+ * @example
+ * ```typescript
+ * const tx = await agent.signAndSend({...});
+ * if (tx.success && tx.data) {
+ *   if (isTransactionExecuted(tx.data)) {
+ *     console.log(`Tx hash: ${tx.data.txHash}`);
+ *   } else {
+ *     console.log(`Transaction suggested: ${tx.data.suggestionId}`);
+ *   }
+ * }
+ * ```
+ */
+declare function isTransactionExecuted(data: unknown): data is {
+    internalTransactionId: number;
+    txHash: string;
+    transactionUrl?: string;
+};
+/**
+ * Response from clearing suggested transactions
+ */
+interface ClearSuggestionsResponse {
+    success: boolean;
+    error?: string;
+    errorMessage?: string;
+}
+
 /**
  * Main AgentSdk class with simplified API surface
  */
@@ -1250,7 +1458,7 @@ declare class AgentSdk {
          */
         execute: {
             (executeQuote: SwidgeExecuteRequest): Promise<SwidgeExecuteResponse>;
-            (executeQuotes: SwidgeExecuteRequest[]): Promise<SwidgeExecuteResponse[]>;
+            (executeQuotes: SwidgeExecuteRequest[]): Promise<SwidgeExecuteResponse[] | SwidgeExecuteResponse[]>;
         };
     };
     /**
@@ -2201,6 +2409,15 @@ declare class AgentSdk {
      * ```
      */
     getCurrentPositions(): Promise<CurrentPositionsResponse>;
+    /**
+     * Clear all pending suggested transactions for this session.
+     *
+     * Performs a soft delete by setting the `deletedAt` timestamp on all
+     * unprocessed suggestions across all suggestion tables.
+     *
+     * @returns Promise resolving to ClearSuggestionsResponse
+     */
+    clearSuggestedTransactions(): Promise<ClearSuggestionsResponse>;
 }
 
 /**
@@ -2220,6 +2437,7 @@ declare class APIClient {
     private baseUrl;
     private authorizationHeader?;
     private isCircuitEnvironment;
+    private getCircuitDevMode;
     /**
      * Create an API client.
      * @param config - SDK configuration
@@ -2369,6 +2587,12 @@ declare class AgentContext {
     readonly sessionWalletAddress: string;
     /** Current positions allocated to this agent (required) */
     readonly currentPositions: CurrentPosition[];
+    /**
+     * Execution mode for this session.
+     * - "auto": Transactions execute immediately (default behavior)
+     * - "manual": Transactions are stored as suggestions for user approval
+     */
+    readonly executionMode: ExecutionMode;
     /** Internal SDK instance */
     private _sdk;
     /**
@@ -2399,6 +2623,7 @@ declare class AgentContext {
         sessionId: number;
         sessionWalletAddress: string;
         currentPositions: CurrentPosition[];
+        executionMode?: ExecutionMode;
         baseUrl?: string;
         authorizationHeader?: string;
     });
@@ -2487,6 +2712,7 @@ declare class AgentContext {
      * **Input**: `SignAndSendRequest`
      *   - `network` (string): "solana" or "ethereum:chainId" (e.g., "ethereum:1", "ethereum:42161")
      *   - `message` (string | undefined): Optional context message
+     *   - `expiresAt` (string | null | undefined): ISO 8601 timestamp for suggestion expiry
      *   - `request` (object): Transaction payload
      *     - For Ethereum:
      *       - `toAddress` (string): Recipient address as hex string
@@ -2502,33 +2728,52 @@ declare class AgentContext {
      *
      * **Output**: `SignAndSendResponse`
      *   - `success` (boolean): Whether the operation succeeded
-     *   - `txHash` (string | undefined): Transaction hash on success
-     *   - `transactionUrl` (string | undefined): Explorer link on success
-     *   - `internalTransactionId` (number | undefined): Internal tracking ID
+     *   - `data` (SignAndSendData | SuggestedTransactionData | undefined): Response data
+     *     - In auto mode: SignAndSendData with txHash, transactionUrl, etc.
+     *     - In manual mode: SuggestedTransactionData with suggestionId and details
      *   - `error` (string | undefined): Error message on failure
+     *   - `errorMessage` (string | undefined): Detailed error message on failure
      *   - `errorDetails` (object | undefined): Detailed error info
      *
      * @param request - Transaction request with network and transaction details
-     * @returns Promise resolving to SignAndSendResponse with transaction hash or error details
+     * @returns Promise resolving to SignAndSendResponse
      *
      * @example
      * ```typescript
-     * const response = await agent.signAndSend({
-     *   network: "ethereum:42161",
+     * // Auto mode or manual mode with bypass - transaction is executed
+     * const result = await agent.signAndSend({
+     *   network: "ethereum:8453",
      *   request: {
-     *     toAddress: "0x742d35cc6634C0532925a3b8D65e95f32B6b5582",
-     *     data: "0x",
-     *     value: "1000000000000000000",  // 1 ETH
-     *     gas: 21000,
-     *     maxFeePerGas: "20000000000"
+     *     toAddress: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bB70" as `0x${string}`,
+     *     data: "0x" as `0x${string}`,
+     *     value: "1000000000000000000", // 1 ETH
      *   },
-     *   message: "Sending 1 ETH"
+     *   message: "Send 1 ETH to Bob",
      * });
      *
-     * if (response.success) {
-     *   await agent.log(`Transaction sent: ${response.txHash}`);
-     * } else {
-     *   await agent.log(response.error || 'Transaction failed', { error: true });
+     * if (result.success && result.data) {
+     *   if (isTransactionExecuted(result.data)) {
+     *     console.log(`Transaction sent: ${result.data.txHash}`);
+     *   }
+     * }
+     *
+     * // Manual mode - transaction is suggested for approval
+     * const result = await agent.signAndSend({
+     *   network: "ethereum:8453",
+     *   request: {
+     *     toAddress: recipient as `0x${string}`,
+     *     data: EMPTY_DATA,
+     *     value: amount,
+     *   },
+     *   message: "Transfer to recipient",
+     * });
+     *
+     * if (result.success && result.data) {
+     *   if (isSuggestedTransaction(result)) {
+     *     console.log(`Transaction suggested (ID: ${result.data.suggestionId})`);
+     *   } else if (isTransactionExecuted(result.data)) {
+     *     console.log(`Transaction executed: ${result.data.txHash}`);
+     *   }
      * }
      * ```
      */
@@ -2732,17 +2977,23 @@ declare class AgentContext {
              *   - `tokenId` (string): Market token ID for the position
              *   - `size` (number): For BUY: USD amount to spend. For SELL: Number of shares to sell
              *   - `side` ("BUY" | "SELL"): Order side
+             *   - `expiresAt` (string | null, optional): ISO 8601 timestamp for suggestion expiry
              *
              * **Output**: `PolymarketMarketOrderResponse`
              *   - `success` (boolean): Whether the operation was successful
-             *   - `data`: Market order data with orderInfo (orderId, side, priceUsd, txHashes)
-             *   - `error`: Error message on failure
+             *   - `data` (PolymarketMarketOrderData | SuggestedTransactionData | undefined): Response data
+             *     - In auto mode: PolymarketMarketOrderData with orderInfo (orderId, side, priceUsd, txHashes)
+             *     - In manual mode: SuggestedTransactionData with suggestionId and details
+             *   - `error` (string | undefined): Error message on failure
+             *   - `errorMessage` (string | undefined): Detailed error message on failure
              *
              * @param request - Order parameters (tokenId, size, side)
-             * @returns Promise resolving to PolymarketMarketOrderResponse with order details
+             * @returns Promise resolving to PolymarketMarketOrderResponse with order details or suggestion
              *
              * @example
              * ```typescript
+             * import { isSuggestedTransaction, isPolymarketExecuted } from "@circuitorg/agent-sdk";
+             *
              * // BUY order - size is USD amount
              * const buyResult = await agent.platforms.polymarket.marketOrder({
              *   tokenId: "123456",
@@ -2751,8 +3002,14 @@ declare class AgentContext {
              * });
              *
              * if (buyResult.success && buyResult.data) {
-             *   await agent.log(`Order ID: ${buyResult.data.orderInfo.orderId}`);
-             *   await agent.log(`Total: $${buyResult.data.orderInfo.totalPriceUsd}`);
+             *   if (isSuggestedTransaction(buyResult)) {
+             *     await agent.log(`Order suggested (ID: ${buyResult.data.suggestionId})`);
+             *   } else if (isPolymarketExecuted(buyResult.data)) {
+             *     await agent.log(`Order ID: ${buyResult.data.orderInfo.orderId}`);
+             *     await agent.log(`Total: $${buyResult.data.orderInfo.totalPriceUsd}`);
+             *   }
+             * } else {
+             *   await agent.log(`Order failed: ${buyResult.errorMessage}`, { error: true });
              * }
              *
              * // SELL order - size is number of shares
@@ -2813,7 +3070,7 @@ declare class AgentContext {
              * Submit a market, limit, stop, or take-profit order for perpetuals or spot trading.
              *
              * **Input**: `HyperliquidPlaceOrderRequest`
-             *   - `symbol` (string): Trading pair symbol (e.g., "BTC-USD")
+             *   - `symbol` (string): Trading pair symbol (e.g., "BTC", "ETH")
              *   - `side` ("buy" | "sell"): Order side
              *   - `size` (number): Order size
              *   - `price` (number): Order price (for market orders, acts as slippage limit)
@@ -2822,29 +3079,26 @@ declare class AgentContext {
              *   - `triggerPrice` (number, optional): Trigger price for stop/take-profit orders
              *   - `reduceOnly` (boolean, optional): Whether this is a reduce-only order
              *   - `postOnly` (boolean, optional): Whether this is a post-only order
+             *   - `expiresAt` (string | null, optional): ISO 8601 timestamp for suggestion expiry
              *
              * **Output**: `HyperliquidPlaceOrderResponse`
              *   - `success` (boolean): Whether the operation was successful
-             *   - `data` (HyperliquidOrderInfo | undefined): Order information (only present on success)
-             *     - `data.orderId` (string): Order ID
-             *     - `data.symbol` (string): Trading pair symbol
-             *     - `data.side` ("buy" | "sell"): Order side
-             *     - `data.price` (number): Order price
-             *     - `data.size` (number): Order size
-             *     - `data.filled` (number): Filled amount
-             *     - `data.status` (string): Order status
-             *     - `data.market` ("perp" | "spot"): Market type
-             *     - `data.clientOrderId` (string | undefined): Client order ID
+             *   - `data` (HyperliquidOrderInfo | SuggestedTransactionData | undefined): Response data
+             *     - In auto mode: HyperliquidOrderInfo with orderId, symbol, side, price, size, filled, status, market, clientOrderId
+             *     - In manual mode: SuggestedTransactionData with suggestionId and details
              *   - `error` (string | undefined): Error message (only present on failure)
+             *   - `errorMessage` (string | undefined): Detailed error message (only present on failure)
              *
              * @param request - Order parameters
              * @returns Promise resolving to HyperliquidPlaceOrderResponse
              *
              * @example
              * ```ts
+             * import { isSuggestedTransaction, isHyperliquidExecuted } from "@circuitorg/agent-sdk";
+             *
              * // Market order
              * const result = await agent.platforms.hyperliquid.placeOrder({
-             *   symbol: "BTC-USD",
+             *   symbol: "BTC",
              *   side: "buy",
              *   size: 0.0001,
              *   price: 110000,
@@ -2852,19 +3106,31 @@ declare class AgentContext {
              *   type: "market",
              * });
              *
+             * if (result.success && result.data) {
+             *   if (isSuggestedTransaction(result)) {
+             *     await agent.log(`Order suggested (ID: ${result.data.suggestionId})`);
+             *   } else if (isHyperliquidExecuted(result.data)) {
+             *     await agent.log(`Order placed: ${result.data.orderId}`);
+             *     await agent.log(`Status: ${result.data.status}`);
+             *   }
+             * } else {
+             *   await agent.log(`Order failed: ${result.errorMessage}`, { error: true });
+             * }
+             *
              * // Limit order
-             * const result = await agent.platforms.hyperliquid.placeOrder({
-             *   symbol: "BTC-USD",
+             * const limitResult = await agent.platforms.hyperliquid.placeOrder({
+             *   symbol: "BTC",
              *   side: "buy",
              *   size: 0.0001,
              *   price: 100000,
              *   market: "perp",
              *   type: "limit",
              * });
-             *
-             * if (result.success && result.data) {
-             *   await agent.log(`Order placed: ${result.data.orderId}`);
-             *   await agent.log(`Status: ${result.data.status}`);
+             *       *     await agent.log(`Order suggested: ${result.data.suggestionId}`);
+             *   } else {
+             *     await agent.log(`Order placed: ${result.data.orderId}`);
+             *     await agent.log(`Status: ${result.data.status}`);
+             *   }
              * } else {
              *   await agent.log(`Error: ${result.error}`, { error: true });
              * }
@@ -3249,34 +3515,47 @@ declare class AgentContext {
          * **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
+         *   - `success` (boolean): Whether the execution was successful
+         *   - `data` (SwidgeExecuteData | SuggestedTransactionData | undefined): Response data
+         *     - In auto mode: SwidgeExecuteData with status ("success", "failure", "refund", "delayed") and transaction hashes
+         *     - In manual mode: SuggestedTransactionData with suggestionId and details
+         *   - `error` (string | undefined): Error message if execution failed
+         *   - `errorMessage` (string | undefined): Detailed error message if execution failed
          *
          * @param quoteData - Complete quote object(s) from agent.swidge.quote()
          * @returns Promise resolving to SwidgeExecuteResponse with transaction status
          *
          * @example
          * ```typescript
-         * // Single execution
+         * import { isSuggestedTransaction, isSwidgeExecuted } from "@circuitorg/agent-sdk";
+         *
+         * // Single execution with type guards
          * const quote = await agent.swidge.quote({...});
          * if (quote.success && quote.data) {
          *   const result = await agent.swidge.execute(quote.data);
+         *
          *   if (result.success && result.data) {
-         *     await agent.log(`Swap status: ${result.data.status}`);
-         *     if (result.data.status === "success") {
-         *       await agent.log(`Tx hash: ${result.data.out.txs[0]}`);
+         *     // Use type guard to check if transaction was suggested
+         *     if (isSuggestedTransaction(result)) {
+         *       await agent.log(`Swap suggested (ID: ${result.data.suggestionId})`);
+         *     } else if (isSwidgeExecuted(result.data)) {
+         *       await agent.log(`Swap status: ${result.data.status}`);
+         *       if (result.data.status === "success" && result.data.out?.txs) {
+         *         await agent.log(`Tx hash: ${result.data.out.txs[0]}`);
+         *       }
          *     }
+         *   } else {
+         *     await agent.log(`Swap failed: ${result.errorMessage}`, { error: true });
          *   }
          * }
          *
          * // Bulk execution
          * const results = await agent.swidge.execute([quote.data, quote2.data]);
-         * results.forEach((result, index) => {
-         *   if (result.success && result.data) {
+         * for (const [index, result] of results.entries()) {
+         *   if (result.success && result.data && isSwidgeExecuted(result.data)) {
          *     console.log(`Swap ${index + 1} status: ${result.data.status}`);
          *   }
-         * });
+         * }
          * ```
          */
         execute: {
@@ -3333,6 +3612,41 @@ declare class AgentContext {
      * ```
      */
     transactions(): Promise<TransactionsResponse>;
+    /**
+     * Clear all pending suggested transactions for this session.
+     *
+     * This performs a soft delete by setting the `deletedAt` timestamp on all
+     * unprocessed suggestions. Useful for clearing stale suggestions before
+     * creating new ones or when the agent's strategy has changed.
+     *
+     * **Best Practice**: Call this at the start of your run() function when in
+     * manual mode to ensure you're working with a clean slate.
+     *
+     * **Output**: `ClearSuggestionsResponse`
+     *   - `success` (boolean): Whether the operation succeeded
+     *   - `error` (string | undefined): Error message on failure
+     *   - `errorMessage` (string | undefined): Detailed error message on failure
+     *
+     * @returns Promise resolving to ClearSuggestionsResponse
+     *
+     * @example
+     * ```typescript
+     * async function run(agent: AgentContext): Promise<void> {
+     *   // Clear any stale suggestions from previous runs
+     *   await agent.clearSuggestedTransactions();
+     *
+     *   // Now create fresh suggestions
+     *   await agent.signAndSend({...});
+     *   await agent.platforms.polymarket.marketOrder({...});
+     * }
+     *
+     * async function unwind(agent: AgentContext): Promise<void> {
+     *   // Clear suggestions when stopping
+     *   await agent.clearSuggestedTransactions();
+     * }
+     * ```
+     */
+    clearSuggestedTransactions(): Promise<ClearSuggestionsResponse>;
     /**
      * Get current live positions for the session.
      *
@@ -3561,4 +3875,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 CurrentPositionsData, type CurrentPositionsResponse, type EnrichedPosition, type HyperliquidBalancesResponse, type HyperliquidDeleteOrderResponse, type HyperliquidHistoricalOrdersResponse, type HyperliquidLiquidationsResponse, type HyperliquidOpenOrdersResponse, type HyperliquidOrderFillsResponse, type HyperliquidOrderResponse, type HyperliquidPlaceOrderRequest, type HyperliquidPlaceOrderResponse, type HyperliquidPositionsResponse, type HyperliquidTransferRequest, type HyperliquidTransferResponse, 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, SwidgeExecuteRequestSchema, type SwidgeExecuteResponse, SwidgeExecuteResponseWrapperSchema, type SwidgeQuoteRequest, SwidgeQuoteRequestSchema, type SwidgeQuoteResponse, SwidgeQuoteResponseWrapperSchema, type SwidgeQuoteResult, type TransactionsResponse, type UnwindFunctionContract, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork, type runFunctionContract };
+export { APIClient, Agent, AgentContext, AgentSdk, type AssetChange, type ClearSuggestionsResponse, type CurrentPosition, type CurrentPositionsData, type CurrentPositionsResponse, EMPTY_DATA, type EnrichedPosition, type EthereumAddress, type EthereumData, type ExecutionMode, type HyperliquidBalancesResponse, type HyperliquidDeleteOrderResponse, type HyperliquidHistoricalOrdersResponse, type HyperliquidLiquidationsResponse, type HyperliquidOpenOrdersResponse, type HyperliquidOrderFillsResponse, type HyperliquidOrderResponse, type HyperliquidPlaceOrderRequest, type HyperliquidPlaceOrderResponse, type HyperliquidPositionsResponse, type HyperliquidTransferRequest, type HyperliquidTransferResponse, 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 SuggestedTransactionData, SwidgeExecuteRequestSchema, type SwidgeExecuteResponse, SwidgeExecuteResponseWrapperSchema, type SwidgeQuoteRequest, SwidgeQuoteRequestSchema, type SwidgeQuoteResponse, SwidgeQuoteResponseWrapperSchema, type SwidgeQuoteResult, type TransactionsResponse, type UnwindFunctionContract, getChainIdFromNetwork, isEthereumNetwork, isHyperliquidExecuted, isPolymarketExecuted, isSolanaNetwork, isSuccessResponse, isSuggestedTransaction, isSwidgeExecuted, isTransactionExecuted, type runFunctionContract };

package/index.js

@@ -1 +1 @@
-import{loadAuthFromFileSystem as r}from"./chunk-4I3A6QAK.js";var e=class{config;baseUrl;authorizationHeader;isCircuitEnvironment(){return!("undefined"==typeof process||!process.env||"circuit"!==process.env.CIRCUIT_ENVIRONMENT&&void 0===process.env.AWS_LAMBDA_FUNCTION_NAME&&void 0===process.env.LAMBDA_TASK_ROOT&&void 0===process.env.AWS_EXECUTION_ENV)}constructor(r){this.config=r;const e=this.isCircuitEnvironment(),t=e?"http://transaction-service.agent.internal":"https://agents.circuit.org";this.baseUrl=r.baseUrl||t,console.log("[Circuit SDK] Environment: "+(e?"Circuit (internal)":"Local (public)"),{CIRCUIT_ENVIRONMENT:process.env?.CIRCUIT_ENVIRONMENT??"not set",baseUrl:this.baseUrl}),this.authorizationHeader=r.authorizationHeader}getAgentSlug(){if("undefined"!=typeof process&&process.env?.CIRCUIT_AGENT_SLUG)return process.env.CIRCUIT_AGENT_SLUG}getAuthHeaders(){const r={};r["X-Session-Id"]=this.config.sessionId.toString();const e=this.getAgentSlug();if(e&&(r["X-Agent-Slug"]=e),this.isCircuitEnvironment())return r;if(this.authorizationHeader)return r.Authorization=this.authorizationHeader,r;try{const e=this.loadAuthConfig();e?.sessionToken&&(r.Authorization=`Bearer ${e.sessionToken}`)}catch{}return r}loadAuthConfig(){try{return r()}catch{}}async makeRequest(r,e={}){const t={...{"Content-Type":"application/json","User-Agent":"circuit-agent-sdk/1.0",Accept:"*/*",...this.getAuthHeaders()},...e.headers},s=`${this.baseUrl}${r}`,o=9e5,n=new AbortController,a=setTimeout(()=>n.abort(),o),i={...e,headers:t,signal:n.signal};console.log("[Circuit SDK] ========== OUTGOING REQUEST =========="),console.log(`[Circuit SDK] ${e.method||"GET"} ${s}`),console.log("[Circuit SDK] Headers:",JSON.stringify(t,null,2)),e.body&&console.log("[Circuit SDK] Body:",e.body),console.log("[Circuit SDK] Environment:",{CIRCUIT_ENVIRONMENT:process.env?.CIRCUIT_ENVIRONMENT??"NOT SET",CIRCUIT_AGENT_SLUG:process.env?.CIRCUIT_AGENT_SLUG??"NOT SET",isCircuitEnvironment:this.isCircuitEnvironment()}),console.log("[Circuit SDK] =====================================");try{const r=await fetch(s,i);if(clearTimeout(a),console.log("[Circuit SDK] ========== RESPONSE =========="),console.log(`[Circuit SDK] Status: ${r.status} ${r.statusText}`),console.log("[Circuit SDK] Response Headers:",Object.fromEntries(r.headers.entries())),!r.ok){const e=await r.text();console.log("[Circuit SDK] Error Body:",e),console.log("[Circuit SDK] ==============================");let t={};try{t=JSON.parse(e)}catch{t={error:e}}const s=t.error||`HTTP ${r.status}: ${r.statusText}`,o=new Error(s);throw o.error=t.error,o.errorMessage=t.error,o.errorDetails=t,o.statusCode=r.status,o}const e=await r.json();return console.log("[Circuit SDK] Success Body:",JSON.stringify(e).slice(0,500)),console.log("[Circuit SDK] =============================="),e}catch(e){if(clearTimeout(a),console.log("[Circuit SDK] ========== REQUEST ERROR =========="),console.log("[Circuit SDK] Error:",e),console.log("[Circuit SDK] ==================================="),e instanceof Error){if("AbortError"===e.name||e.message.includes("aborted")){const e=new Error(`Request timeout after 900s to ${s}`);throw e.error="Request Timeout",e.errorMessage=`Request to ${s} timed out after 900 seconds`,e.errorDetails={url:s,endpoint:r,timeout:o,baseUrl:this.baseUrl},e}if(e.message.includes("fetch failed")||e.message.includes("ECONNREFUSED")||e.message.includes("ENOTFOUND")||e.message.includes("getaddrinfo")||e.message.includes("network")){const t=new Error(`Network error: ${e.message}. URL: ${s}`);throw t.error="Network Error",t.errorMessage=`Failed to connect to ${s}: ${e.message}`,t.errorDetails={url:s,endpoint:r,baseUrl:this.baseUrl,originalError:e.message,isCircuitEnvironment:this.isCircuitEnvironment()},t}}throw e}}async get(r){return this.makeRequest(r,{method:"GET"})}async post(r,e){return this.makeRequest(r,{method:"POST",body:e?JSON.stringify(e):void 0})}async delete(r){return this.makeRequest(r,{method:"DELETE"})}};function t(r){return r.startsWith("ethereum:")}function s(r){return"solana"===r}function o(r){return Number(r.split(":")[1])}var n=class{client;config;constructor(r){this.config=r,this.client=new e(r)}setBaseUrl(r){this.config.baseUrl=r,this.client=new e(this.config)}async _sendLog(r){await this.client.post("/v1/logs",r)}async signAndSend(r){try{if(t(r.network)){const e=o(r.network);if("toAddress"in r.request)return await this.handleEvmTransaction({chainId:e,toAddress:r.request.toAddress,data:r.request.data,valueWei:r.request.value,message:r.message})}if(s(r.network)&&"hexTransaction"in r.request)return await this.handleSolanaTransaction({hexTransaction:r.request.hexTransaction,message:r.message});const e=`Unsupported network: ${r.network}`;return{success:!1,error:"Unsupported Network",errorMessage:e,errorDetails:{message:e}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async signMessage(r){try{if(t(r.network))return await this.handleEvmSignMessage(r);const e=`Unsupported network: ${r.network}`;return{success:!1,error:"Unsupported Network",errorMessage:e,errorDetails:{message:e}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}swidge={quote:async r=>this.handleSwidgeQuote(r),execute:function(r){return this.handleSwidgeExecute(r)}.bind(this)};memory={set:async(r,e)=>this.handleMemorySet(r,e),get:async r=>this.handleMemoryGet(r),delete:async r=>this.handleMemoryDelete(r),list:async()=>this.handleMemoryList()};platforms={polymarket:{marketOrder:async r=>this.handlePolymarketMarketOrder(r),redeemPositions:async r=>this.handlePolymarketRedeemPositions(r||{tokenIds:[]})},hyperliquid:{placeOrder:async r=>this.handleHyperliquidPlaceOrder(r),order:async r=>this.handleHyperliquidGetOrder(r),deleteOrder:async(r,e)=>this.handleHyperliquidDeleteOrder(r,e),balances:async()=>this.handleHyperliquidGetBalances(),positions:async()=>this.handleHyperliquidGetPositions(),openOrders:async()=>this.handleHyperliquidGetOpenOrders(),orderFills:async()=>this.handleHyperliquidGetOrderFills(),orders:async()=>this.handleHyperliquidGetHistoricalOrders(),transfer:async r=>this.handleHyperliquidTransfer(r),liquidations:async r=>this.handleHyperliquidGetLiquidations(r)}};async handleEvmTransaction(r){try{const e=(await this.client.post("/v1/transactions/evm",r)).data,t=(await this.client.post(`/v1/transactions/evm/${e.id}/broadcast`)).data;return{success:!0,data:{internalTransactionId:e.id,txHash:t.transactionHash,transactionUrl:void 0}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async handleSolanaTransaction(r){try{const e=(await this.client.post("/v1/transactions/solana",r)).data,t=(await this.client.post(`/v1/transactions/solana/${e.id}/broadcast`)).data;return{success:!0,data:{internalTransactionId:e.id,txHash:t.transactionHash,transactionUrl:void 0}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async handleEvmSignMessage(r){try{return await this.client.post("/v1/messages/evm",{messageType:r.request.messageType,data:r.request.data,chainId:r.request.chainId})}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async _updateJobStatus(r){try{return await this.client.post(`/v1/jobs/${r.jobId}/status`,r)}catch(r){return{status:400,message:`Failed to update job status: ${r instanceof Error?r.message:"Unknown error"}`}}}async handleSwidgeQuote(r){try{return await this.client.post("/v1/swap/quote",r)}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to get swidge quote";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleSwidgeExecute(r){try{return await this.client.post("/v1/swap/execute",r)}catch(e){const t=e.error,s=e.errorMessage,o=e.errorDetails||{},n=e instanceof Error?e.message:"Failed to execute swidge swap";return Array.isArray(r)?[{success:!1,error:t||"SDK Error",errorMessage:s||n,errorDetails:o}]:{success:!1,error:t||"SDK Error",errorMessage:s||n,errorDetails:o}}}async handlePolymarketMarketOrder(r){try{return await this.client.post("/v1/platforms/polymarket/market-order",r)}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to execute polymarket market order";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handlePolymarketRedeemPositions(r){try{return await this.client.post("/v1/platforms/polymarket/redeem-positions",r)}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to redeem polymarket positions";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleHyperliquidPlaceOrder(r){try{return await this.client.post("/v1/platforms/hyperliquid/order",r)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to place order";return{success:!1,error:e||t}}}async handleHyperliquidGetOrder(r){try{return await this.client.get(`/v1/platforms/hyperliquid/order/${r}`)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get order";return{success:!1,error:e||t}}}async handleHyperliquidDeleteOrder(r,e){try{return await this.client.delete(`/v1/platforms/hyperliquid/order/${r}/${e}`)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to delete order";return{success:!1,error:e||t}}}async handleHyperliquidGetBalances(){try{return await this.client.get("/v1/platforms/hyperliquid/balances")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get balances";return{success:!1,error:e||t}}}async handleHyperliquidGetPositions(){try{return await this.client.get("/v1/platforms/hyperliquid/positions")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get positions";return{success:!1,error:e||t}}}async handleHyperliquidGetOpenOrders(){try{return await this.client.get("/v1/platforms/hyperliquid/orders")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get open orders";return{success:!1,error:e||t}}}async handleHyperliquidGetOrderFills(){try{return await this.client.get("/v1/platforms/hyperliquid/orders/fill-history")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get order fills";return{success:!1,error:e||t}}}async handleHyperliquidGetHistoricalOrders(){try{return await this.client.get("/v1/platforms/hyperliquid/orders/historical")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get historical orders";return{success:!1,error:e||t}}}async handleHyperliquidTransfer(r){try{return await this.client.post("/v1/platforms/hyperliquid/transfer",r)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to transfer";return{success:!1,error:e||t}}}async handleHyperliquidGetLiquidations(r){try{const e=r?`?startTime=${r}`:"";return await this.client.get(`/v1/platforms/hyperliquid/liquidations${e}`)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get liquidations";return{success:!1,error:e||t}}}async handleMemorySet(r,e){try{return await this.client.post(`/v1/memory/${r}`,{value:e})}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to set memory";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryGet(r){try{return await this.client.get(`/v1/memory/${r}`)}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to get memory";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryDelete(r){try{return await this.client.delete(`/v1/memory/${r}`)}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to delete memory";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryList(){try{return await this.client.get("/v1/memory/list")}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to list memory keys";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async transactions(){try{return await this.client.get("/v1/transactions/ledger")}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to fetch transactions";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async getCurrentPositions(){try{return await this.client.get("/v1/positions/current")}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to fetch current positions";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}};import{existsSync as a,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 y=class{sessionId;sessionWalletAddress;currentPositions;t;constructor(r){this.sessionId=r.sessionId,this.sessionWalletAddress=r.sessionWalletAddress,this.currentPositions=r.currentPositions,this.t=new n({sessionId:r.sessionId,baseUrl:r.baseUrl,authorizationHeader:r.authorizationHeader})}setBaseUrl(r){this.t.setBaseUrl(r)}async log(r,e){const{error:t=!1,debug:s=!1}=e||{};let o,n;const a=(r,e)=>{if("bigint"==typeof e)return e.toString();if("function"==typeof e)return`[Function: ${e.name||"anonymous"}]`;if(void 0===e)return"[undefined]";if(null===e)return null;if("object"==typeof e&&!Array.isArray(e)&&e.toString!==Object.prototype.toString)try{const r=e.toString();if("[object Object]"!==r)return r}catch(r){}return e};if("object"==typeof r&&null!==r?(o=JSON.stringify(r,a,2),n=JSON.stringify(r,a)):(o=String(r),n=String(r)),t?console.error(o):console.log(o),s)return{success:!0};const i=t?"error":"observe";try{return await this.t._sendLog([{type:i,message:n}]),{success:!0}}catch(r){const e=r instanceof Error?r.message:"Failed to send log";return console.error(`Failed to send log to backend: ${e}`),{success:!1,error:"Log Error",errorMessage:e,errorDetails:{message:e,type:r instanceof Error?r.constructor.name:"UnknownError"}}}}async signAndSend(r){return this.t.signAndSend(r)}async signMessage(r){return this.t.signMessage(r)}memory={set:async(r,e)=>this.t.memory.set(r,e),get:async r=>this.t.memory.get(r),delete:async r=>this.t.memory.delete(r),list:async()=>this.t.memory.list()};platforms={polymarket:{marketOrder:async r=>this.t.platforms.polymarket.marketOrder(r),redeemPositions:async r=>this.t.platforms.polymarket.redeemPositions(r)},hyperliquid:{placeOrder:async r=>this.t.platforms.hyperliquid.placeOrder(r),order:async r=>this.t.platforms.hyperliquid.order(r),deleteOrder:async(r,e)=>this.t.platforms.hyperliquid.deleteOrder(r,e),balances:async()=>this.t.platforms.hyperliquid.balances(),positions:async()=>this.t.platforms.hyperliquid.positions(),openOrders:async()=>this.t.platforms.hyperliquid.openOrders(),orderFills:async()=>this.t.platforms.hyperliquid.orderFills(),orders:async()=>this.t.platforms.hyperliquid.orders(),transfer:async r=>this.t.platforms.hyperliquid.transfer(r),liquidations:async r=>this.t.platforms.hyperliquid.liquidations(r)}};swidge={quote:async r=>this.t.swidge.quote(r),execute:function(r){return this.t.swidge.execute(r)}.bind(this)};async transactions(){return this.t.transactions()}async getCurrentPositions(){return this.t.getCurrentPositions()}},p=h.object({network:h.string(),assetAddress:h.string(),tokenId:h.string().nullable(),avgUnitCost:h.string(),currentQty:h.string()}),m=h.object({sessionId:h.number(),sessionWalletAddress:h.string(),jobId:h.string().optional(),currentPositions:h.array(p),unwindPositions:h.array(p).optional()}),f=(h.object({status:h.string()}),class{app;runFunction;unwindFunction;healthCheckFunction=async()=>({status:"healthy",timestamp:(new Date).toISOString()});constructor(r){this.app=new l,this.runFunction=r.runFunction,this.unwindFunction=r.unwindFunction,this.app.use("*",d()),this.setupRoutes()}defaultUnwindFunction=async(r,e)=>{await r.log(`Unwind requested for session ${r.sessionId} (positions=${e.length}), but no unwindFunction was provided`)};async executeWithJobTracking(r,e,t,s){let o,n=!1;try{const o=new y({sessionId:r.sessionId,sessionWalletAddress:r.sessionWalletAddress,currentPositions:r.currentPositions,authorizationHeader:s});if("unwind"===e){const e=r.unwindPositions??r.currentPositions;await t(o,e)}else await t(o);n=!0}catch(r){o=this.getErrorMessage(r),n=!1,console.error(`Agent ${e} function error:`,o)}finally{r.jobId&&await this.updateJobStatus(r.sessionId,r.jobId,n?"success":"failed",o,s)}}getErrorMessage(r){if(null==r)return"Unknown error";try{const e=r?.constructor?.name||"Error";let t="";t=r instanceof Error&&r.message||String(r),t=t.replace(/[^\x20-\x7E\n\t]/g,"");const s=`${e}: ${t}`;return s.length>1e3?`${s.substring(0,997)}...`:s}catch{return"Unknown error (message extraction failed)"}}async updateJobStatus(r,e,t,s,o){const a=new n({sessionId:r,authorizationHeader:o});for(let r=1;r<=3;r++)try{return void await a._updateJobStatus({jobId:e,status:t,errorMessage:s})}catch(e){console.error(`Status update attempt ${r}/3 failed:`,e),r<3&&await new Promise(e=>setTimeout(e,100*2**(r-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 a._updateJobStatus({jobId:e,status:t,errorMessage:void 0})}catch(r){console.error(`CRITICAL: Failed to update job ${e} status. Likely API connectivity issue:`,r)}else console.error(`CRITICAL: Failed to update job ${e} status to success after 3 attempts`)}setupRoutes(){this.app.post("/run",u("json",m),async r=>{const e=r.req.valid("json"),t=r.req.header("Authorization");return await this.executeWithJobTracking(e,"run",this.runFunction,t),r.json({success:!0,message:"Execution completed"})}),this.app.post("/execute",u("json",m),async r=>{const e=r.req.valid("json"),t=r.req.header("Authorization");return await this.executeWithJobTracking(e,"run",this.runFunction,t),r.json({success:!0,message:"Execution completed"})}),this.app.post("/unwind",u("json",m),async r=>{const e=r.req.valid("json"),t=r.req.header("Authorization"),s=this.unwindFunction||this.defaultUnwindFunction;return await this.executeWithJobTracking(e,"unwind",s,t),r.json({success:!0,message:"Unwind completed"})}),this.app.get("/health",async r=>{try{const e=await this.healthCheckFunction();return r.json(e)}catch(e){return console.error("Agent health check error:",e),r.json({status:"unhealthy",error:e instanceof Error?e.message:"Unknown error",timestamp:(new Date).toISOString()},500)}})}getPortFromPackageJson(){try{const r=c(process.cwd(),"package.json");if(a(r)){const e=JSON.parse(i(r,"utf-8"));if(e.circuit?.port)return console.log("⚠️  Warning: circuit.port in package.json is deprecated. Use AGENT_PORT environment variable instead."),Number.parseInt(e.circuit.port,10)}}catch(r){console.log("Could not read package.json for port configuration")}return null}async run(r){const e=globalThis.Bun?.env,t=process.env.AGENT_PORT||e?.AGENT_PORT,s=this.getPortFromPackageJson();let o=r;!o&&t&&(o=Number.parseInt(t,10)),!o&&s&&(o=s),o||(o=3e3),console.log("🔧 Agent configuration:"),console.log(`   Explicit port parameter: ${r||"not set"}`),console.log(`   process.env.AGENT_PORT: ${process.env.AGENT_PORT||"not set"}`),console.log(`   Bun.env.AGENT_PORT: ${e?.AGENT_PORT||"not set"}`),console.log(`   package.json circuit.port: ${s||"not set"} (deprecated)`),console.log(`   Final port: ${o}`);try{const{serve:r}=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 /unwind"),r({fetch:this.app.fetch,port:o})}catch(r){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:this.app.fetch.bind(this.app)}}});import{z as g}from"zod";var w=g.templateLiteral(["ethereum:",g.coerce.number().int().nonnegative()]),E=g.union([g.literal("solana"),w]),v=g.object({address:g.string(),network:E}),S=g.object({from:v,to:v,fromToken:g.string().optional(),toToken:g.string().optional(),amount:g.string(),slippage:g.string().optional()}),D=g.object({network:E,address:g.string(),token:g.string().nullable(),name:g.string().optional(),symbol:g.string().optional(),decimals:g.number().optional(),amount:g.string().optional(),minimumAmount:g.string().optional(),amountFormatted:g.string().optional(),amountUsd:g.string().optional()}),T=g.object({usd:g.string().optional(),percentage:g.string().optional()}),O=g.object({name:g.string(),amount:g.string().optional(),amountFormatted:g.string().optional(),amountUsd:g.string().optional()}),k=(g.object({programId:g.string(),keys:g.array(g.object({pubkey:g.string(),isSigner:g.boolean(),isWritable:g.boolean()})),data:g.union([g.string(),g.instanceof(Buffer)])}),g.object({type:g.literal("evm"),from:g.string().regex(/^0x[a-fA-F0-9]{40}$/),to:g.string().regex(/^0x[a-fA-F0-9]{40}$/),chainId:g.number(),value:g.string(),data:g.string().regex(/^0x[a-fA-F0-9]*$/),gas:g.number().nullish(),maxFeePerGas:g.number().nullish(),maxPriorityFeePerGas:g.number().nullish()})),F=g.object({type:g.literal("solana"),serializedTransaction:g.string()}),U=g.object({type:g.literal("transaction"),description:g.string(),transactionDetails:g.union([k,F])}),$=g.object({type:g.literal("signature"),description:g.string(),signatureData:g.string()}),b=g.discriminatedUnion("type",[U,$]),A=g.object({engine:g.string().describe("Swap engine. Expected: 'relay', 'lifi'"),assetSend:D,assetReceive:D,priceImpact:T,fees:g.array(O),steps:g.array(b)}),C=A,M=g.object({network:g.string(),txs:g.array(g.string())}),q=g.object({status:g.string().describe("Expected: 'success', 'failure', 'refund', 'delayed'"),in:M.optional(),out:M.optional(),lastUpdated:g.number(),error:g.string().optional()}),N={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"},I=r=>g.object({success:g.boolean(),data:r.optional(),error:g.string().optional(),errorMessage:g.string().optional(),errorDetails:g.object({message:g.string().optional(),error:g.string().optional(),status:g.number().optional(),statusText:g.string().optional()}).optional()}).passthrough(),K=I(A),P=I(q);export{e as APIClient,f as Agent,y as AgentContext,n as AgentSdk,N as QUOTE_RESULT,C as SwidgeExecuteRequestSchema,P as SwidgeExecuteResponseWrapperSchema,S as SwidgeQuoteRequestSchema,K as SwidgeQuoteResponseWrapperSchema,o as getChainIdFromNetwork,t as isEthereumNetwork,s as isSolanaNetwork};
+import{loadAuthFromFileSystem as r}from"./chunk-4I3A6QAK.js";var e=class{config;baseUrl;authorizationHeader;isCircuitEnvironment(){return!("undefined"==typeof process||!process.env||"circuit"!==process.env.CIRCUIT_ENVIRONMENT&&void 0===process.env.AWS_LAMBDA_FUNCTION_NAME&&void 0===process.env.LAMBDA_TASK_ROOT&&void 0===process.env.AWS_EXECUTION_ENV)}getCircuitDevMode(){if("undefined"!=typeof process&&process.env)return process.env.CIRCUIT_DEV_MODE}constructor(r){this.config=r;const e=this.getCircuitDevMode(),t=this.isCircuitEnvironment();let s,o;"local"===e?(s="http://localhost:4001",o="Dev Local"):t?(s="http://transaction-service.agent.internal",o="Circuit (internal)"):(s="https://agents.circuit.org",o="Local (public)"),this.baseUrl=r.baseUrl||s,this.authorizationHeader=r.authorizationHeader}getAgentSlug(){if("undefined"!=typeof process&&process.env?.CIRCUIT_AGENT_SLUG)return process.env.CIRCUIT_AGENT_SLUG}getAuthHeaders(){const r={};r["X-Session-Id"]=this.config.sessionId.toString();const e=this.getAgentSlug();if(e&&(r["X-Agent-Slug"]=e),this.isCircuitEnvironment())return r;if(this.authorizationHeader)return r.Authorization=this.authorizationHeader,r;try{const e=this.loadAuthConfig();e?.sessionToken&&(r.Authorization=`Bearer ${e.sessionToken}`)}catch{}return"undefined"!=typeof process&&process.env?.CIRCUIT_DEV_API_KEY&&(r["X-API-Key"]=process.env.CIRCUIT_DEV_API_KEY),r}loadAuthConfig(){try{return r()}catch{}}async makeRequest(r,e={}){const t={...{"Content-Type":"application/json","User-Agent":"circuit-agent-sdk/1.0",Accept:"*/*",...this.getAuthHeaders()},...e.headers},s=`${this.baseUrl}${r}`,o=9e5,n=new AbortController,a=setTimeout(()=>n.abort(),o),i={...e,headers:t,signal:n.signal};try{const r=await fetch(s,i);if(clearTimeout(a),!r.ok){const e=await r.text();let t={};try{t=JSON.parse(e)}catch{t={error:e}}const s=t.error||`HTTP ${r.status}: ${r.statusText}`,o=new Error(s);throw o.error=t.error,o.errorMessage=t.error,o.errorDetails=t,o.statusCode=r.status,o}return await r.json()}catch(e){if(clearTimeout(a),e instanceof Error){if("AbortError"===e.name||e.message.includes("aborted")){const e=new Error(`Request timeout after 900s to ${s}`);throw e.error="Request Timeout",e.errorMessage=`Request to ${s} timed out after 900 seconds`,e.errorDetails={url:s,endpoint:r,timeout:o,baseUrl:this.baseUrl},e}if(e.message.includes("fetch failed")||e.message.includes("ECONNREFUSED")||e.message.includes("ENOTFOUND")||e.message.includes("getaddrinfo")||e.message.includes("network")){const t=new Error(`Network error: ${e.message}. URL: ${s}`);throw t.error="Network Error",t.errorMessage=`Failed to connect to ${s}: ${e.message}`,t.errorDetails={url:s,endpoint:r,baseUrl:this.baseUrl,originalError:e.message,isCircuitEnvironment:this.isCircuitEnvironment()},t}}throw e}}async get(r){return this.makeRequest(r,{method:"GET"})}async post(r,e){return this.makeRequest(r,{method:"POST",body:e?JSON.stringify(e):void 0})}async delete(r){return this.makeRequest(r,{method:"DELETE"})}};function t(r){return r.startsWith("ethereum:")}function s(r){return"solana"===r}function o(r){return Number(r.split(":")[1])}var n=class{client;config;constructor(r){this.config=r,this.client=new e(r)}setBaseUrl(r){this.config.baseUrl=r,this.client=new e(this.config)}async _sendLog(r){await this.client.post("/v1/logs",r)}async signAndSend(r){try{if(t(r.network)){const e=o(r.network);if("toAddress"in r.request)return await this.handleEvmTransaction({chainId:e,toAddress:r.request.toAddress,data:r.request.data,valueWei:r.request.value,message:r.message,expiresAt:r.expiresAt??null})}if(s(r.network)&&"hexTransaction"in r.request)return await this.handleSolanaTransaction({hexTransaction:r.request.hexTransaction,message:r.message,expiresAt:r.expiresAt??null});const e=`Unsupported network: ${r.network}`;return{success:!1,error:"Unsupported Network",errorMessage:e,errorDetails:{message:e}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async signMessage(r){try{if(t(r.network))return await this.handleEvmSignMessage(r);const e=`Unsupported network: ${r.network}`;return{success:!1,error:"Unsupported Network",errorMessage:e,errorDetails:{message:e}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}swidge={quote:async r=>this.handleSwidgeQuote(r),execute:function(r){return this.handleSwidgeExecute(r)}.bind(this)};memory={set:async(r,e)=>this.handleMemorySet(r,e),get:async r=>this.handleMemoryGet(r),delete:async r=>this.handleMemoryDelete(r),list:async()=>this.handleMemoryList()};platforms={polymarket:{marketOrder:async r=>this.handlePolymarketMarketOrder(r),redeemPositions:async r=>this.handlePolymarketRedeemPositions(r||{tokenIds:[]})},hyperliquid:{placeOrder:async r=>this.handleHyperliquidPlaceOrder(r),order:async r=>this.handleHyperliquidGetOrder(r),deleteOrder:async(r,e)=>this.handleHyperliquidDeleteOrder(r,e),balances:async()=>this.handleHyperliquidGetBalances(),positions:async()=>this.handleHyperliquidGetPositions(),openOrders:async()=>this.handleHyperliquidGetOpenOrders(),orderFills:async()=>this.handleHyperliquidGetOrderFills(),orders:async()=>this.handleHyperliquidGetHistoricalOrders(),transfer:async r=>this.handleHyperliquidTransfer(r),liquidations:async r=>this.handleHyperliquidGetLiquidations(r)}};async handleEvmTransaction(r){try{const e=(await this.client.post("/v1/transactions/evm",r)).data;if("suggested"in e&&!0===e.suggested)return{success:!0,data:{suggested:!0,suggestionId:e.suggestionId,details:e.details}};const t=e,s=(await this.client.post(`/v1/transactions/evm/${t.id}/broadcast`)).data;return{success:!0,data:{internalTransactionId:t.id,txHash:s.transactionHash,transactionUrl:void 0}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async handleSolanaTransaction(r){try{const e=(await this.client.post("/v1/transactions/solana",r)).data;if("suggested"in e&&!0===e.suggested)return{success:!0,data:{suggested:!0,suggestionId:e.suggestionId,details:e.details}};const t=e,s=(await this.client.post(`/v1/transactions/solana/${t.id}/broadcast`)).data;return{success:!0,data:{internalTransactionId:t.id,txHash:s.transactionHash,transactionUrl:void 0}}}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async handleEvmSignMessage(r){try{return await this.client.post("/v1/messages/evm",{messageType:r.request.messageType,data:r.request.data,chainId:r.request.chainId})}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{};return e||t?{success:!1,error:e,errorMessage:t,errorDetails:s}:{success:!1,error:"SDK Error",errorMessage:r instanceof Error?r.message:"Unknown error",errorDetails:{}}}}async _updateJobStatus(r){try{return await this.client.post(`/v1/jobs/${r.jobId}/status`,r)}catch(r){return{status:400,message:`Failed to update job status: ${r instanceof Error?r.message:"Unknown error"}`}}}async handleSwidgeQuote(r){try{return await this.client.post("/v1/swap/quote",r)}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to get swidge quote";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleSwidgeExecute(r){try{return await this.client.post("/v1/swap/execute",r)}catch(e){const t=e.error,s=e.errorMessage,o=e.errorDetails||{},n=e instanceof Error?e.message:"Failed to execute swidge swap";return Array.isArray(r)?[{success:!1,error:t||"SDK Error",errorMessage:s||n,errorDetails:o}]:{success:!1,error:t||"SDK Error",errorMessage:s||n,errorDetails:o}}}async handlePolymarketMarketOrder(r){try{const e=await this.client.post("/v1/platforms/polymarket/market-order",r);return e.success&&e.data&&"suggested"in e.data&&e.data.suggested,e}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to execute polymarket market order";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handlePolymarketRedeemPositions(r){try{return await this.client.post("/v1/platforms/polymarket/redeem-positions",r)}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to redeem polymarket positions";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleHyperliquidPlaceOrder(r){try{const e=await this.client.post("/v1/platforms/hyperliquid/order",r);return e.success&&e.data&&"suggested"in e.data&&e.data.suggested,e}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to place order";return{success:!1,error:e||t}}}async handleHyperliquidGetOrder(r){try{return await this.client.get(`/v1/platforms/hyperliquid/order/${r}`)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get order";return{success:!1,error:e||t}}}async handleHyperliquidDeleteOrder(r,e){try{return await this.client.delete(`/v1/platforms/hyperliquid/order/${r}/${e}`)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to delete order";return{success:!1,error:e||t}}}async handleHyperliquidGetBalances(){try{return await this.client.get("/v1/platforms/hyperliquid/balances")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get balances";return{success:!1,error:e||t}}}async handleHyperliquidGetPositions(){try{return await this.client.get("/v1/platforms/hyperliquid/positions")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get positions";return{success:!1,error:e||t}}}async handleHyperliquidGetOpenOrders(){try{return await this.client.get("/v1/platforms/hyperliquid/orders")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get open orders";return{success:!1,error:e||t}}}async handleHyperliquidGetOrderFills(){try{return await this.client.get("/v1/platforms/hyperliquid/orders/fill-history")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get order fills";return{success:!1,error:e||t}}}async handleHyperliquidGetHistoricalOrders(){try{return await this.client.get("/v1/platforms/hyperliquid/orders/historical")}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get historical orders";return{success:!1,error:e||t}}}async handleHyperliquidTransfer(r){try{return await this.client.post("/v1/platforms/hyperliquid/transfer",r)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to transfer";return{success:!1,error:e||t}}}async handleHyperliquidGetLiquidations(r){try{const e=r?`?startTime=${r}`:"";return await this.client.get(`/v1/platforms/hyperliquid/liquidations${e}`)}catch(r){const e=r.error,t=r instanceof Error?r.message:"Failed to get liquidations";return{success:!1,error:e||t}}}async handleMemorySet(r,e){try{return await this.client.post(`/v1/memory/${r}`,{value:e})}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to set memory";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryGet(r){try{return await this.client.get(`/v1/memory/${r}`)}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to get memory";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryDelete(r){try{return await this.client.delete(`/v1/memory/${r}`)}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to delete memory";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async handleMemoryList(){try{return await this.client.get("/v1/memory/list")}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to list memory keys";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async transactions(){try{return await this.client.get("/v1/transactions/ledger")}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to fetch transactions";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async getCurrentPositions(){try{return await this.client.get("/v1/positions/current")}catch(r){const e=r.error,t=r.errorMessage,s=r.errorDetails||{},o=r instanceof Error?r.message:"Failed to fetch current positions";return{success:!1,error:e||"SDK Error",errorMessage:t||o,errorDetails:s}}}async clearSuggestedTransactions(){try{return await this.client.delete("/v1/sessions/suggestions")}catch(r){const e=r.error,t=r.errorMessage,s=r instanceof Error?r.message:"Failed to clear suggested transactions";return{success:!1,error:e||"SDK Error",errorMessage:t||s}}}};import{existsSync as a,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 y=class{sessionId;sessionWalletAddress;currentPositions;executionMode;t;constructor(r){this.sessionId=r.sessionId,this.sessionWalletAddress=r.sessionWalletAddress,this.currentPositions=r.currentPositions,this.executionMode=r.executionMode??"auto",this.t=new n({sessionId:r.sessionId,baseUrl:r.baseUrl,authorizationHeader:r.authorizationHeader})}setBaseUrl(r){this.t.setBaseUrl(r)}async log(r,e){const{error:t=!1,debug:s=!1}=e||{};let o,n;const a=(r,e)=>{if("bigint"==typeof e)return e.toString();if("function"==typeof e)return`[Function: ${e.name||"anonymous"}]`;if(void 0===e)return"[undefined]";if(null===e)return null;if("object"==typeof e&&!Array.isArray(e)&&e.toString!==Object.prototype.toString)try{const r=e.toString();if("[object Object]"!==r)return r}catch(r){}return e};if("object"==typeof r&&null!==r?(o=JSON.stringify(r,a,2),n=JSON.stringify(r,a)):(o=String(r),n=String(r)),t?console.error(o):console.log(o),s)return{success:!0};const i=t?"error":"observe";try{return await this.t._sendLog([{type:i,message:n}]),{success:!0}}catch(r){const e=r instanceof Error?r.message:"Failed to send log";return console.error(`Failed to send log to backend: ${e}`),{success:!1,error:"Log Error",errorMessage:e,errorDetails:{message:e,type:r instanceof Error?r.constructor.name:"UnknownError"}}}}async signAndSend(r){return this.t.signAndSend(r)}async signMessage(r){return this.t.signMessage(r)}memory={set:async(r,e)=>this.t.memory.set(r,e),get:async r=>this.t.memory.get(r),delete:async r=>this.t.memory.delete(r),list:async()=>this.t.memory.list()};platforms={polymarket:{marketOrder:async r=>this.t.platforms.polymarket.marketOrder(r),redeemPositions:async r=>this.t.platforms.polymarket.redeemPositions(r)},hyperliquid:{placeOrder:async r=>this.t.platforms.hyperliquid.placeOrder(r),order:async r=>this.t.platforms.hyperliquid.order(r),deleteOrder:async(r,e)=>this.t.platforms.hyperliquid.deleteOrder(r,e),balances:async()=>this.t.platforms.hyperliquid.balances(),positions:async()=>this.t.platforms.hyperliquid.positions(),openOrders:async()=>this.t.platforms.hyperliquid.openOrders(),orderFills:async()=>this.t.platforms.hyperliquid.orderFills(),orders:async()=>this.t.platforms.hyperliquid.orders(),transfer:async r=>this.t.platforms.hyperliquid.transfer(r),liquidations:async r=>this.t.platforms.hyperliquid.liquidations(r)}};swidge={quote:async r=>this.t.swidge.quote(r),execute:function(r){return this.t.swidge.execute(r)}.bind(this)};async transactions(){return this.t.transactions()}async clearSuggestedTransactions(){return this.t.clearSuggestedTransactions()}async getCurrentPositions(){return this.t.getCurrentPositions()}},p=h.object({network:h.string(),assetAddress:h.string(),tokenId:h.string().nullable(),avgUnitCost:h.string(),currentQty:h.string()}),g=h.object({sessionId:h.number(),sessionWalletAddress:h.string(),jobId:h.string().optional(),currentPositions:h.array(p),unwindPositions:h.array(p).optional(),executionMode:h.enum(["auto","manual"]).default("auto")}),m=(h.object({status:h.string()}),class{app;runFunction;unwindFunction;healthCheckFunction=async()=>({status:"healthy",timestamp:(new Date).toISOString()});constructor(r){this.app=new l,this.runFunction=r.runFunction,this.unwindFunction=r.unwindFunction,this.app.use("*",d()),this.setupRoutes()}defaultUnwindFunction=async(r,e)=>{await r.log(`Unwind requested for session ${r.sessionId} (positions=${e.length}), but no unwindFunction was provided`)};async executeWithJobTracking(r,e,t,s){let o,n=!1;try{const o=new y({sessionId:r.sessionId,sessionWalletAddress:r.sessionWalletAddress,currentPositions:r.currentPositions,executionMode:r.executionMode,authorizationHeader:s});if("unwind"===e){const e=r.unwindPositions??r.currentPositions;await t(o,e)}else await t(o);n=!0}catch(r){o=this.getErrorMessage(r),n=!1,console.error(`Agent ${e} function error:`,o)}finally{r.jobId&&await this.updateJobStatus(r.sessionId,r.jobId,n?"success":"failed",o,s)}}getErrorMessage(r){if(null==r)return"Unknown error";try{const e=r?.constructor?.name||"Error";let t="";t=r instanceof Error&&r.message||String(r),t=t.replace(/[^\x20-\x7E\n\t]/g,"");const s=`${e}: ${t}`;return s.length>1e3?`${s.substring(0,997)}...`:s}catch{return"Unknown error (message extraction failed)"}}async updateJobStatus(r,e,t,s,o){const a=new n({sessionId:r,authorizationHeader:o});for(let r=1;r<=3;r++)try{return void await a._updateJobStatus({jobId:e,status:t,errorMessage:s})}catch(e){console.error(`Status update attempt ${r}/3 failed:`,e),r<3&&await new Promise(e=>setTimeout(e,100*2**(r-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 a._updateJobStatus({jobId:e,status:t,errorMessage:void 0})}catch(r){console.error(`CRITICAL: Failed to update job ${e} status. Likely API connectivity issue:`,r)}else console.error(`CRITICAL: Failed to update job ${e} status to success after 3 attempts`)}setupRoutes(){this.app.post("/run",u("json",g),async r=>{const e=r.req.valid("json"),t=r.req.header("Authorization");return await this.executeWithJobTracking(e,"run",this.runFunction,t),r.json({success:!0,message:"Execution completed"})}),this.app.post("/execute",u("json",g),async r=>{const e=r.req.valid("json"),t=r.req.header("Authorization");return await this.executeWithJobTracking(e,"run",this.runFunction,t),r.json({success:!0,message:"Execution completed"})}),this.app.post("/unwind",u("json",g),async r=>{const e=r.req.valid("json"),t=r.req.header("Authorization"),s=this.unwindFunction||this.defaultUnwindFunction;return await this.executeWithJobTracking(e,"unwind",s,t),r.json({success:!0,message:"Unwind completed"})}),this.app.get("/health",async r=>{try{const e=await this.healthCheckFunction();return r.json(e)}catch(e){return console.error("Agent health check error:",e),r.json({status:"unhealthy",error:e instanceof Error?e.message:"Unknown error",timestamp:(new Date).toISOString()},500)}})}getPortFromPackageJson(){try{const r=c(process.cwd(),"package.json");if(a(r)){const e=JSON.parse(i(r,"utf-8"));if(e.circuit?.port)return console.log("⚠️  Warning: circuit.port in package.json is deprecated. Use AGENT_PORT environment variable instead."),Number.parseInt(e.circuit.port,10)}}catch(r){console.log("Could not read package.json for port configuration")}return null}async run(r){const e=globalThis.Bun?.env,t=process.env.AGENT_PORT||e?.AGENT_PORT,s=this.getPortFromPackageJson();let o=r;!o&&t&&(o=Number.parseInt(t,10)),!o&&s&&(o=s),o||(o=3e3),console.log("🔧 Agent configuration:"),console.log(`   Explicit port parameter: ${r||"not set"}`),console.log(`   process.env.AGENT_PORT: ${process.env.AGENT_PORT||"not set"}`),console.log(`   Bun.env.AGENT_PORT: ${e?.AGENT_PORT||"not set"}`),console.log(`   package.json circuit.port: ${s||"not set"} (deprecated)`),console.log(`   Final port: ${o}`);try{const{serve:r}=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 /unwind"),r({fetch:this.app.fetch,port:o})}catch(r){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:this.app.fetch.bind(this.app)}}});import{z as f}from"zod";f.enum(["auto","manual"]);var w="0x",E=f.object({suggested:f.literal(!0),suggestionId:f.number(),details:f.record(f.string(),f.unknown())});function v(r){return!0===r.success&&"data"in r&&"object"==typeof r.data&&null!==r.data&&"suggested"in r.data&&!0===r.data.suggested}function D(r){return r.success&&void 0!==r.data}function k(r){return"object"==typeof r&&null!==r&&"out"in r&&!("suggested"in r)}function F(r){return"object"==typeof r&&null!==r&&"orderInfo"in r&&!("suggested"in r)}function b(r){return"object"==typeof r&&null!==r&&"orderId"in r&&!("suggested"in r)}function T(r){return"object"==typeof r&&null!==r&&"txHash"in r&&!("suggested"in r)}f.object({success:f.boolean(),error:f.string().optional(),errorMessage:f.string().optional()});import{z as S}from"zod";var O=S.templateLiteral(["ethereum:",S.coerce.number().int().nonnegative()]),M=S.union([S.literal("solana"),O]),A=S.object({address:S.string(),network:M}),$=S.object({from:A,to:A,fromToken:S.string().optional(),toToken:S.string().optional(),amount:S.string(),slippage:S.string().optional()}),U=S.object({network:M,address:S.string(),token:S.string().nullable(),name:S.string().optional(),symbol:S.string().optional(),decimals:S.number().optional(),amount:S.string().optional(),minimumAmount:S.string().optional(),amountFormatted:S.string().optional(),amountUsd:S.string().optional()}),q=S.object({usd:S.string().optional(),percentage:S.string().optional()}),x=S.object({name:S.string(),amount:S.string().optional(),amountFormatted:S.string().optional(),amountUsd:S.string().optional()}),I=(S.object({programId:S.string(),keys:S.array(S.object({pubkey:S.string(),isSigner:S.boolean(),isWritable:S.boolean()})),data:S.union([S.string(),S.instanceof(Buffer)])}),S.object({type:S.literal("evm"),from:S.string().regex(/^0x[a-fA-F0-9]{40}$/),to:S.string().regex(/^0x[a-fA-F0-9]{40}$/),chainId:S.number(),value:S.string(),data:S.string().regex(/^0x[a-fA-F0-9]*$/),gas:S.number().nullish(),maxFeePerGas:S.number().nullish(),maxPriorityFeePerGas:S.number().nullish()})),P=S.object({type:S.literal("solana"),serializedTransaction:S.string()}),j=S.object({type:S.literal("transaction"),description:S.string(),transactionDetails:S.union([I,P])}),N=S.object({type:S.literal("signature"),description:S.string(),signatureData:S.string()}),H=S.discriminatedUnion("type",[j,N]),C=S.object({engine:S.string().describe("Swap engine. Expected: 'relay', 'lifi'"),assetSend:U,assetReceive:U,priceImpact:q,fees:S.array(x),steps:S.array(H)}),_=C.extend({expiresAt:S.string().datetime().optional().nullable().default(null)}),K=S.object({network:S.string(),txs:S.array(S.string())}),L=S.object({status:S.string().describe("Expected: 'success', 'failure', 'refund', 'delayed'"),in:K.optional(),out:K.optional(),lastUpdated:S.number(),error:S.string().optional()}),R={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"},G=r=>S.object({success:S.boolean(),data:r.optional(),error:S.string().optional(),errorMessage:S.string().optional(),errorDetails:S.object({message:S.string().optional(),error:S.string().optional(),status:S.number().optional(),statusText:S.string().optional()}).optional()}).passthrough(),z=G(C),W=G(S.union([L,E]));export{e as APIClient,m as Agent,y as AgentContext,n as AgentSdk,w as EMPTY_DATA,R as QUOTE_RESULT,_ as SwidgeExecuteRequestSchema,W as SwidgeExecuteResponseWrapperSchema,$ as SwidgeQuoteRequestSchema,z as SwidgeQuoteResponseWrapperSchema,o as getChainIdFromNetwork,t as isEthereumNetwork,b as isHyperliquidExecuted,F as isPolymarketExecuted,s as isSolanaNetwork,D as isSuccessResponse,v as isSuggestedTransaction,k as isSwidgeExecuted,T as isTransactionExecuted};

package/package.json

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