@circuitorg/agent-sdk 1.0.13 → 1.1.1

package/README.md

@@ -2,15 +2,16 @@
 
 > **Clean, type-safe TypeScript SDK for building cross-chain agents on the circuit platform**
 
-A TypeScript SDK for building automated agents to deploy on Circuit. Features a simple API surface with just **2 main methods** and full type safety.
+A TypeScript SDK for building automated agents to deploy on Circuit. Features a simple API surface with just **3 main methods** and full type safety.
 
 > **💡 Best used with [Circuit Agents CLI](https://github.com/circuitorg/agents-cli)** - Deploy, manage, and test your agents with ease
 
 ## ✨ Features
 
-- **🎯 Simple API**: Only 2 main methods - `sendLog()` and `signAndSend()`
+- **🎯 Simple API**: Only 3 main methods - `sendLog()`, `signAndSend()`, and `swidge.*` (swap/bridge)
 - **🔒 Type Safety**: Network parameter determines valid request shapes automatically
 - **🚀 Cross-Chain**: Unified interface for EVM and Solana networks
+- **🌉 Cross-Chain Swaps**: Built-in Swidge integration for seamless token swaps and bridges
 
 ## 🚀 Quick Start
 ### Install the SDK
@@ -84,6 +85,248 @@ await sdk.signAndSend({
 ```
 
 
+## 🌉 Cross-Chain Swaps with Swidge
+
+The SDK includes built-in Swidge integration for seamless cross-chain token swaps and bridges.
+
+Swidge provides a unified interface that handles both **swapping** (exchanging tokens within the same network) and **bridging** (moving tokens across different networks) through a single, easy-to-use API. Whether you're doing a simple token swap on Ethereum or bridging assets across chains, the same quote-and-execute pattern works for everything.
+
+### 3. Cross-Chain Swaps & Bridges
+
+#### Get a Quote
+
+```typescript
+// 🌉 Bridge USDC: Polygon → Arbitrum
+const bridgeQuote = await sdk.swidge.quote({
+  from: { network: "ethereum:137", address: request.sessionWalletAddress },
+  to: { network: "ethereum:42161", address: request.sessionWalletAddress },
+  amount: "50000000", // $50 USDC (6 decimals)
+  fromToken: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174", // USDC on Polygon
+  toToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",   // USDC on Arbitrum
+  slippage: "2.0", // 2% slippage for cross-chain (default: 0.5%)
+  priceImpact: "1.0" // 1% max price impact (default: 0.5%)
+});
+
+// 🔄 Swap USDC → ETH on same chain (using defaults)
+const swapQuote = await sdk.swidge.quote({
+  from: { network: "ethereum:42161", address: request.sessionWalletAddress },
+  to: { network: "ethereum:42161", address: request.sessionWalletAddress },
+  amount: "100000000", // $100 USDC (6 decimals)
+  fromToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", // USDC
+  // toToken omitted = native ETH (default behavior)
+  // slippage defaults to "0.5", priceImpact defaults to "0.5"
+});
+
+if (quote.success) {
+  console.log(`💰 You'll receive: ${quote.data.assetRecieve.amountFormatted}`);
+  console.log(`💸 Total fees: ${quote.data.fees.map(f => f.name).join(", ")}`);
+} else if (quote.error) {
+  // Check for specific error types
+  if (quote.error === QUOTE_RESULT.WALLET_NOT_FOUND) {
+    console.log("👛 Wallet not found");
+  } else if (quote.error === QUOTE_RESULT.WALLET_MISMATCH) {
+    console.log("🔐 Wallet address doesn't match session");
+  } else {
+    console.log("❓ Quote not available for this swap");
+  }
+}
+```
+
+#### Execute a Swap
+
+```typescript
+// 1️⃣ Get a quote first
+let quoteRequest = {
+  from: { network: "ethereum:42161", address: request.sessionWalletAddress },
+  to: { network: "ethereum:1", address: request.sessionWalletAddress },
+  amount: "100000000", // $100 USDC
+  fromToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", // USDC on Arbitrum
+  priceImpact: "0.1", // Conservative price impact setting
+  slippage: "5.0"
+};
+
+let quote = await sdk.swidge.quote(quoteRequest);
+
+// 2️⃣ Handle quote failures with retry logic
+if (quote.error === QUOTE_RESULT.NO_QUOTE_PROVIDED) {
+  console.log(`❓ Quote not available, increasing price impact and retrying...`)
+  // Retry with more permissive parameters
+  quoteRequest.priceImpact = "10.0";
+  quoteRequest.slippage = "10.0";
+  quote = await sdk.swidge.quote(quoteRequest);
+}
+
+// 3️⃣ Execute the swap if quote succeeded
+if (quote.success && quote.data) {
+  console.log(`💰 Expected to receive: ${quote.data.assetRecieve.amountFormatted}`);
+  console.log(`💸 Fees: ${quote.data.fees.map(f => `${f.name}: ${f.amountFormatted}`).join(", ")}`);
+
+  const result = await sdk.swidge.execute(quote.data);
+
+  if (result.success && result.data) {
+    console.log(`🎉 Status: ${result.data.status}`);
+
+    if (result.data.status === "success") {
+      console.log(`📤 Sent: ${result.data.in.txs[0]}`);
+      console.log(`📥 Received: ${result.data.out.txs[0]}`);
+      console.log("✅ Cross-chain swap completed!");
+    } else if (result.data.status === "failure") {
+      console.log("❌ Transaction failed");
+    } else if (result.data.status === "refund") {
+      console.log("↩️ Transaction was refunded");
+    } else if (result.data.status === "delayed") {
+      console.log("⏰ Transaction is delayed");
+    }
+  } else {
+    console.log(`❌ Execute failed: ${result.error}`);
+  }
+} else {
+  console.log(`❌ Quote failed after retry: ${quote.error}`);
+  return { success: false };
+}
+```
+
+### Swidge API Reference
+
+#### `sdk.swidge.quote(request: SwidgeQuoteRequest): Promise<SwidgeQuoteResponse>`
+
+Get pricing and routing information for token swaps between networks or within the same network.
+
+**Parameters:**
+```typescript
+{
+  from: { network: SwidgeNetwork, address: string },
+  to: { network: SwidgeNetwork, address: string },
+  amount: string,                    // Amount in token's smallest unit
+  fromToken?: string,                // Source token contract (omit for native tokens)
+  toToken?: string,                  // Destination token contract (omit for native tokens)
+  slippage?: string,                 // Slippage tolerance % (default: "0.5")
+  priceImpact?: string               // Max price impact % (default: "0.5")
+}
+```
+
+**Returns:**
+```typescript
+{
+  success: boolean,
+  data?: {
+    engine: "relay",
+    assetSend: {
+      network: SwidgeNetwork,
+      address: string,
+      token: string | null,
+      amount: string,
+      amountFormatted: string,
+      amountUsd: string,
+      // ... additional fields
+    },
+    assetRecieve: {
+      network: SwidgeNetwork,
+      address: string,
+      token: string | null,
+      amount: string,
+      amountFormatted: string,
+      amountUsd: string,
+      // ... additional fields
+    },
+    priceImpact: {
+      usd?: string,
+      percentage?: string
+    },
+    fees: Array<{
+      name: string,
+      amount?: string,
+      amountFormatted?: string,
+      amountUsd?: string
+    }>,
+    steps: Array<SwidgeUnsignedStep>  // Transaction steps to execute
+  },
+  error?: string,
+  errorDetails?: {
+    message: string,
+    status?: number,
+    statusText?: string
+  }
+}
+```
+
+**Error Handling with QUOTE_RESULT:**
+
+The SDK exports a `QUOTE_RESULT` constant that provides type-safe error checking with full IntelliSense support:
+
+```typescript
+import { QUOTE_RESULT } from "@circuitorg/agent-sdk";
+
+// Use QUOTE_RESULT constants instead of hardcoded strings
+if (quote.error === QUOTE_RESULT.WALLET_NOT_FOUND) {
+  // Handle wallet not found
+} else if (quote.error === QUOTE_RESULT.WALLET_MISMATCH) {
+  // Handle wallet mismatch
+}
+```
+
+**Possible Error Responses:**
+- `QUOTE_RESULT.FOUND` - Success case (not an error)
+- `QUOTE_RESULT.NO_QUOTE_PROVIDED` - Generic API error
+- `QUOTE_RESULT.WALLET_NOT_FOUND` - Wallet address not found
+- `QUOTE_RESULT.WALLET_MISMATCH` - From wallet does not match session wallet
+
+#### `sdk.swidge.execute(quoteData: SwidgeExecuteRequest): Promise<SwidgeExecuteResponse>`
+
+Execute a cross-chain swap or bridge using a complete quote from `sdk.swidge.quote()`.
+
+Pass the entire `quote.data` object returned from `quote()` - the SDK handles all transaction signing, broadcasting, and cross-chain coordination.
+
+**Parameters:**
+```typescript
+// The complete quote.data object from sdk.swidge.quote()
+{
+  engine: "relay",
+  assetSend: SwidgeQuoteAsset,
+  assetRecieve: SwidgeQuoteAsset,
+  priceImpact: SwidgePriceImpact,
+  fees: SwidgeFee[],
+  steps: SwidgeUnsignedStep[]  // Contains transaction details for each step
+}
+```
+
+**Returns:**
+```typescript
+{
+  success: boolean,
+  data?: {
+    status: "success" | "failure" | "refund" | "delayed",
+    in: {
+      network: string,
+      txs: string[]  // Transaction hashes for sending side
+    },
+    out: {
+      network: string,
+      txs: string[]  // Transaction hashes for receiving side
+    },
+    lastUpdated: number  // Timestamp of last status update
+  },
+  error?: string,
+  errorDetails?: {
+    message: string,
+    status?: number,
+    statusText?: string
+  }
+}
+```
+
+**Execution Flow:**
+1. SDK signs and broadcasts transactions from the `steps` array
+2. Monitors cross-chain execution progress
+3. Returns final status once complete (never returns "pending" or "waiting")
+
+**Status Meanings:**
+- `"success"` - All transactions completed successfully
+- `"failure"` - One or more transactions failed
+- `"refund"` - Transaction was refunded (e.g., due to timeout or failure)
+- `"delayed"` - Transaction is taking longer than expected but still processing
+
+
 ## 🔧 Examples
 
 ### Barebones Agent

package/index.d.ts

@@ -33,12 +33,22 @@ type SignAndSendRequest = {
  * Standard response from signAndSend operations
  */
 type SignAndSendResponse = {
-    /** Internal transaction ID for tracking */
-    internalTransactionId: number;
-    /** Transaction hash once broadcast */
-    txHash: string;
-    /** Optional transaction URL (explorer link) */
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Internal transaction ID for tracking (only present on success) */
+    internalTransactionId?: number;
+    /** Transaction hash once broadcast (only present on success) */
+    txHash?: string;
+    /** Optional transaction URL (explorer link) (only present on success) */
     transactionUrl?: string;
+    /** Error message (only present on failure) */
+    error?: string;
+    /** Detailed error information (only present on failure) */
+    errorDetails?: {
+        message: string;
+        status?: number;
+        statusText?: string;
+    };
 };
 /**
  * EIP712 TypedData schema for typed message signing
@@ -136,6 +146,237 @@ interface SDKConfig {
     baseUrl?: string;
 }
 
+/**
+ * Job status tracking types for Event invocation support
+ */
+interface UpdateJobStatusRequest {
+    jobId: string;
+    status: "pending" | "success" | "failed";
+    errorMessage?: string;
+}
+interface UpdateJobStatusResponse {
+    status: number;
+    message: string;
+}
+
+/**
+ * Swidge (cross-chain swap) type definitions for agent operations
+ * These schemas exactly match the execution-layer-sdk for zero friction
+ */
+
+declare const SwidgeQuoteRequestSchema: z.ZodObject<{
+    from: z.ZodObject<{
+        address: z.ZodString;
+        network: z.ZodUnion<readonly [z.ZodLiteral<"solana">, z.ZodTemplateLiteral<`ethereum:${number}`>]>;
+    }, z.core.$strip>;
+    to: z.ZodObject<{
+        address: z.ZodString;
+        network: z.ZodUnion<readonly [z.ZodLiteral<"solana">, z.ZodTemplateLiteral<`ethereum:${number}`>]>;
+    }, z.core.$strip>;
+    fromToken: z.ZodOptional<z.ZodString>;
+    toToken: z.ZodOptional<z.ZodString>;
+    amount: z.ZodString;
+    priceImpact: z.ZodOptional<z.ZodString>;
+    slippage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type SwidgeQuoteRequest = z.infer<typeof SwidgeQuoteRequestSchema>;
+/**
+ * Execute request schema - takes the complete quote response from quote() method
+ */
+declare const SwidgeExecuteRequestSchema: z.ZodObject<{
+    engine: z.ZodLiteral<"relay">;
+    assetSend: z.ZodObject<{
+        network: z.ZodUnion<readonly [z.ZodLiteral<"solana">, z.ZodTemplateLiteral<`ethereum:${number}`>]>;
+        address: z.ZodString;
+        token: z.ZodNullable<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodString>;
+        decimals: z.ZodOptional<z.ZodNumber>;
+        amount: z.ZodOptional<z.ZodString>;
+        minimumAmount: z.ZodOptional<z.ZodString>;
+        amountFormatted: z.ZodOptional<z.ZodString>;
+        amountUsd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    assetRecieve: z.ZodObject<{
+        network: z.ZodUnion<readonly [z.ZodLiteral<"solana">, z.ZodTemplateLiteral<`ethereum:${number}`>]>;
+        address: z.ZodString;
+        token: z.ZodNullable<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodString>;
+        decimals: z.ZodOptional<z.ZodNumber>;
+        amount: z.ZodOptional<z.ZodString>;
+        minimumAmount: z.ZodOptional<z.ZodString>;
+        amountFormatted: z.ZodOptional<z.ZodString>;
+        amountUsd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    priceImpact: z.ZodObject<{
+        usd: z.ZodOptional<z.ZodString>;
+        percentage: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    fees: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        amount: z.ZodOptional<z.ZodString>;
+        amountFormatted: z.ZodOptional<z.ZodString>;
+        amountUsd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"transaction">;
+        description: z.ZodString;
+        transactionDetails: z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"evm">;
+            from: z.ZodString;
+            to: z.ZodString;
+            chainId: z.ZodNumber;
+            value: z.ZodNumber;
+            data: z.ZodString;
+            gas: z.ZodNumber;
+            maxFeePerGas: z.ZodNumber;
+            maxPriorityFeePerGas: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"solana">;
+            instructions: z.ZodArray<z.ZodObject<{
+                programId: z.ZodString;
+                keys: z.ZodArray<z.ZodObject<{
+                    pubkey: z.ZodString;
+                    isSigner: z.ZodBoolean;
+                    isWritable: z.ZodBoolean;
+                }, z.core.$strip>>;
+                data: z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>]>;
+            }, z.core.$strip>>;
+            addressLookupTableAddresses: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>]>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"signature">;
+        description: z.ZodString;
+        signatureData: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+/**
+ * Quote result constants - type QUOTE_RESULT. to see available options
+ * These match the exact error strings returned by the swidge API
+ */
+declare const QUOTE_RESULT: {
+    readonly FOUND: "QUOTE_FOUND";
+    readonly NO_QUOTE_PROVIDED: "No quote provided";
+    readonly WALLET_NOT_FOUND: "Wallet not found";
+    readonly WALLET_MISMATCH: "From wallet does not match session wallet";
+};
+/**
+ * Type for quote result values
+ */
+type SwidgeQuoteResult = (typeof QUOTE_RESULT)[keyof typeof QUOTE_RESULT];
+/**
+ * Swidge quote response wrapper
+ */
+declare const SwidgeQuoteResponseWrapperSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        engine: z.ZodLiteral<"relay">;
+        assetSend: z.ZodObject<{
+            network: z.ZodUnion<readonly [z.ZodLiteral<"solana">, z.ZodTemplateLiteral<`ethereum:${number}`>]>;
+            address: z.ZodString;
+            token: z.ZodNullable<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            symbol: z.ZodOptional<z.ZodString>;
+            decimals: z.ZodOptional<z.ZodNumber>;
+            amount: z.ZodOptional<z.ZodString>;
+            minimumAmount: z.ZodOptional<z.ZodString>;
+            amountFormatted: z.ZodOptional<z.ZodString>;
+            amountUsd: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        assetRecieve: z.ZodObject<{
+            network: z.ZodUnion<readonly [z.ZodLiteral<"solana">, z.ZodTemplateLiteral<`ethereum:${number}`>]>;
+            address: z.ZodString;
+            token: z.ZodNullable<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            symbol: z.ZodOptional<z.ZodString>;
+            decimals: z.ZodOptional<z.ZodNumber>;
+            amount: z.ZodOptional<z.ZodString>;
+            minimumAmount: z.ZodOptional<z.ZodString>;
+            amountFormatted: z.ZodOptional<z.ZodString>;
+            amountUsd: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        priceImpact: z.ZodObject<{
+            usd: z.ZodOptional<z.ZodString>;
+            percentage: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        fees: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            amount: z.ZodOptional<z.ZodString>;
+            amountFormatted: z.ZodOptional<z.ZodString>;
+            amountUsd: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"transaction">;
+            description: z.ZodString;
+            transactionDetails: z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"evm">;
+                from: z.ZodString;
+                to: z.ZodString;
+                chainId: z.ZodNumber;
+                value: z.ZodNumber;
+                data: z.ZodString;
+                gas: z.ZodNumber;
+                maxFeePerGas: z.ZodNumber;
+                maxPriorityFeePerGas: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"solana">;
+                instructions: z.ZodArray<z.ZodObject<{
+                    programId: z.ZodString;
+                    keys: z.ZodArray<z.ZodObject<{
+                        pubkey: z.ZodString;
+                        isSigner: z.ZodBoolean;
+                        isWritable: z.ZodBoolean;
+                    }, z.core.$strip>>;
+                    data: z.ZodUnion<readonly [z.ZodString, z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>]>;
+                }, z.core.$strip>>;
+                addressLookupTableAddresses: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>]>;
+            metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"signature">;
+            description: z.ZodString;
+            signatureData: z.ZodString;
+            metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+    errorDetails: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        status: z.ZodOptional<z.ZodNumber>;
+        statusText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Swidge execute response wrapper
+ */
+declare const SwidgeExecuteResponseWrapperSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    data: z.ZodOptional<z.ZodObject<{
+        status: z.ZodUnion<readonly [z.ZodLiteral<"success">, z.ZodLiteral<"failure">, z.ZodLiteral<"refund">, z.ZodLiteral<"delayed">]>;
+        in: z.ZodObject<{
+            network: z.ZodString;
+            txs: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        out: z.ZodObject<{
+            network: z.ZodString;
+            txs: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        lastUpdated: z.ZodNumber;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+    errorDetails: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        status: z.ZodOptional<z.ZodNumber>;
+        statusText: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type SwidgeQuoteResponse = z.infer<typeof SwidgeQuoteResponseWrapperSchema>;
+type SwidgeExecuteRequest = z.infer<typeof SwidgeExecuteRequestSchema>;
+type SwidgeExecuteResponse = z.infer<typeof SwidgeExecuteResponseWrapperSchema>;
+
 /**
  * Main AgentSdk class with simplified API surface
  */
@@ -279,6 +520,132 @@ declare class AgentSdk {
      * ```
      */
     signMessage(request: SignMessageRequest): Promise<SignMessageResponse>;
+    /**
+     * 🌉 Swidge: Cross-chain swaps & bridges made simple
+     *
+     * Bridge assets between chains or swap tokens on the same network. Supports all major
+     * EVM chains (Ethereum, Arbitrum, Polygon, etc.) and Solana with automatic routing,
+     * and competitive fees.
+     *
+     */
+    readonly swidge: {
+        /**
+         * 🌉 Get a cross-chain swap or bridge quote
+         *
+         * Get pricing and routing info for swapping tokens between networks or within the same network.
+         * Perfect for bridging assets across chains or swapping tokens on the same chain.
+         *
+         * ⚠️ **Important Notes:**
+         * - **Small amounts may fail**: Use at least $10-20 worth to avoid fee/slippage issues
+         * - **Slippage matters**: Default is 0.5% for most cases, increase to 1-2% for volatile pairs
+         * - **Different networks = bridge**: Same network = swap
+         * - **Native tokens**: Omit `fromToken`/`toToken` for ETH, SOL, etc.
+         *
+         * @param request Quote parameters
+         * @param request.from Source wallet `{ network, address }`
+         * @param request.to Destination wallet `{ network, address }`
+         * @param request.amount Amount in token's smallest unit (wei for ETH, lamports for SOL)
+         * @param request.fromToken Source token contract address (optional, omit for native tokens like ETH/SOL)
+         * @param request.toToken Destination token contract address (optional, omit for native tokens like ETH/SOL)
+         * @param request.slippage Slippage tolerance % as string (e.g., "2.0" = 2%, default: "0.5")
+         * @param request.priceImpact Max price impact % as string (e.g., "1.0" = 1%, default: "0.5")
+         * @returns Quote with fees, price impact, and transaction steps
+         *
+         * @example
+         * ```ts
+         * // 🌉 Bridge USDC: Polygon → Arbitrum
+         * const bridgeQuote = await sdk.swidge.quote({
+         *   from: { network: "ethereum:137", address: request.sessionWalletAddress },
+         *   to: { network: "ethereum:42161", address: request.sessionWalletAddress },
+         *   amount: "50000000", // $50 USDC (6 decimals)
+         *   fromToken: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174", // USDC on Polygon
+         *   toToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",   // USDC on Arbitrum
+         *   slippage: "2.0", // 2% slippage for cross-chain (default: 0.5%)
+         *   priceImpact: "1.0" // 1% max price impact (default: 0.5%)
+         * });
+         *
+         * // 🔄 Swap USDC → ETH on same chain (using defaults)
+         * const swapQuote = await sdk.swidge.quote({
+         *   from: { network: "ethereum:42161", address: request.sessionWalletAddress },
+         *   to: { network: "ethereum:42161", address: request.sessionWalletAddress },
+         *   amount: "100000000", // $100 USDC (6 decimals)
+         *   fromToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", // USDC
+         *   // toToken omitted = native ETH (default behavior)
+         *   // slippage defaults to "0.5", priceImpact defaults to "0.5"
+         * });
+         *
+         * if (quote.success) {
+         *   console.log(`💰 You'll receive: ${quote.data.assetRecieve.amountFormatted}`);
+         *   console.log(`💸 Total fees: ${quote.data.fees.map(f => f.name).join(", ")}`);
+         * } else if (quote.error) {
+         *   // Check for specific error types
+         *   if (quote.error === QUOTE_RESULT.WALLET_NOT_FOUND) {
+         *     console.log("👛 Wallet not found");
+         *   } else if (quote.error === QUOTE_RESULT.WALLET_MISMATCH) {
+         *     console.log("🔐 Wallet address doesn't match session");
+         *   } else {
+         *     console.log("❓ Quote not available for this swap");
+         *   }
+         * }
+         * ```
+         */
+        quote: (request: SwidgeQuoteRequest) => Promise<SwidgeQuoteResponse>;
+        /**
+         * 🚀 Execute a cross-chain swap or bridge
+         *
+         * Takes your quote and makes it happen! Just pass the complete quote object from
+         * `sdk.swidge.quote()` and let the magic happen. Signs transactions, broadcasts them,
+         * and waits for completion.
+         *
+         * ⚠️ **What happens:**
+         * - Signs transactions using your wallet's policy engine
+         * - Broadcasts to the blockchain(s)
+         * - Waits for cross-chain completion (this may take some time depending on network status)
+         * - Returns final status with transaction hashes
+         *
+         * 💡 **Pro tip**: The backend handles all the complexity - you just pass the quote!
+         *
+         * @param quote Complete quote object from `sdk.swidge.quote()`
+         * @returns Execution result with status and transaction details
+         *
+         * @example
+         * ```ts
+         * // 1️⃣ Get a quote first
+         * const quote = await sdk.swidge.quote({
+         *   from: { network: "ethereum:137", address: request.sessionWalletAddress },
+         *   to: { network: "ethereum:42161", address: request.sessionWalletAddress },
+         *   amount: "50000000", // $50 USDC
+         *   fromToken: "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
+         *   toToken: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+         *   slippage: "2.0", // priceImpact defaults to "0.5"
+         * });
+         *
+         * // 2️⃣ Execute the swap
+         * if (quote.success && quote.data) {
+         *   const result = await sdk.swidge.execute(quote.data);
+         *
+         *   if (result.success && result.data) {
+         *     console.log(`🎉 Status: ${result.data.status}`);
+         *
+         *     if (result.data.status === "success") {
+         *       console.log(`📤 Sent: ${result.data.in.txs[0]}`);
+         *       console.log(`📥 Received: ${result.data.out.txs[0]}`);
+         *       console.log("✅ Cross-chain swap completed!");
+         *     } else if (result.data.status === "failure") {
+         *       console.log("❌ Transaction failed");
+         *     } else if (result.data.status === "refund") {
+         *       console.log("↩️ Transaction was refunded");
+         *     } else if (result.data.status === "delayed") {
+         *       console.log("⏰ Transaction is delayed");
+         *     }
+         *   } else {
+         *     console.log(`❌ Execute failed: ${result.error}`);
+         *   }
+         * }
+         * ```
+         */
+        execute: (executeQuote: SwidgeExecuteRequest) => Promise<SwidgeExecuteResponse>;
+    };
     /**
      * Handle EVM transaction signing and broadcasting
      */
@@ -295,6 +662,21 @@ declare class AgentSdk {
      * Send logs to the agent timeline (migrated from AgentToolset)
      */
     private _sendLog;
+    /**
+     * Internal method to update job status. Used by the Agent wrapper for automatic tracking.
+     *
+     * This method is not intended for direct use by agent developers - job status tracking
+     * is handled automatically by the Agent wrapper.
+     */
+    _updateJobStatus(request: UpdateJobStatusRequest): Promise<UpdateJobStatusResponse>;
+    /**
+     * Handle swidge quote requests
+     */
+    private handleSwidgeQuote;
+    /**
+     * Handle swidge execute requests
+     */
+    private handleSwidgeExecute;
 }
 
 /**
@@ -326,6 +708,10 @@ declare class APIClient {
     private getAuthHeaders;
     private loadAuthConfig;
     private logging;
+    /**
+     * Mask sensitive headers and filter out noise headers for logging
+     */
+    private sanitizeHeaders;
     /**
      * Perform a JSON HTTP request.
      *
@@ -358,6 +744,7 @@ declare class APIClient {
 declare const AgentRequestSchema: z.ZodObject<{
     sessionId: z.ZodNumber;
     sessionWalletAddress: z.ZodString;
+    jobId: z.ZodOptional<z.ZodString>;
     otherParameters: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
 }, z.core.$strip>;
 /**
@@ -505,7 +892,7 @@ interface AgentConfig {
  *
  * Exposes the following endpoints:
  * - `POST /execute` — required, calls your execution function
- * - `POST /stop` and `DELETE /` — optional, when a `stopFunction` is provided
+ * - `POST /stop` — always available, uses provided or default stop function
  * - `GET /health` — always available, uses provided or default health check
  */
 declare class Agent {
@@ -518,6 +905,18 @@ declare class Agent {
      * @param config - Execution function is required; chat/stop/health are optional.
      */
     constructor(config: AgentConfig);
+    /**
+     * Default stop function when no custom stop function is provided.
+     */
+    private defaultStopFunction;
+    /**
+     * Execute a function with automatic job status tracking.
+     */
+    private executeWithJobTracking;
+    /**
+     * Update job status using the AgentSdk.
+     */
+    private updateJobStatus;
     private setupRoutes;
     private getPortFromPackageJson;
     run(port?: number): {
@@ -552,4 +951,4 @@ declare function isSolanaNetwork(network: Network): network is "solana";
  */
 declare function getChainIdFromNetwork(network: `ethereum:${number}`): number;
 
-export { APIClient, Agent, AgentSdk, type ExecutionFunctionContract, type Network, type SDKConfig, type SignAndSendRequest, type SignAndSendResponse, type SignMessageRequest, type SignMessageResponse, type StopFunctionContract, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork };
+export { APIClient, Agent, AgentSdk, type ExecutionFunctionContract, type Network, QUOTE_RESULT, type SDKConfig, type SignAndSendRequest, type SignAndSendResponse, type SignMessageRequest, type SignMessageResponse, type StopFunctionContract, type SwidgeExecuteResponse, type SwidgeQuoteRequest, type SwidgeQuoteResponse, type SwidgeQuoteResult, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork };

package/index.js

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

package/package.json

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