@circuitorg/agent-sdk 1.0.10 → 1.0.12

package/README.md

@@ -84,9 +84,10 @@ await sdk.signAndSend({
 ```
 
 
-## 🔧 Sample Agent Structure
+## 🔧 Examples
 
-### SDK Configuration
+### Barebones Agent
+>This is the wireframe structure all agents need to have (executionFunction, stopFunction, and export default agent.getWorkerExport()). The main thing an agent dev needs to focus on is the execution logic, and any cleanup logic that would need to be ran whenever a user decides to stop an agent session.
 
 ```typescript
 import { Agent, AgentSdk, ExecutionFunctionContract, StopFunctionContract } from "@circuitorg/agent-sdk";
@@ -138,12 +139,269 @@ const stopFunction: StopFunctionContract = async (request) => {
 // DONT MODIFY BELOW THIS
 const agent = new Agent({ executionFunction, stopFunction });
 
-// Start the server for local development
-agent.run();
-
 // Export the agent for Cloudflare Workers
 export default agent.getWorkerExport();
 
 ```
 
 
+### Sample self sender
+>This demonstrates a very basic structure of fetching balances and sending 1% of that amount to yourself. It highlights what stage in the transaction process you will "hand off" the transaction to the circuit infrastructure for signing and sending (broadcasting).
+```typescript
+import {
+  Agent,
+  AgentSdk,
+  ExecutionFunctionContract,
+  StopFunctionContract,
+} from "@circuitorg/agent-sdk";
+import { encodeFunctionData, parseAbi } from "viem";
+
+export type BalanceResponse = {
+  /** Raw amount as string (wei, lamports, or token units) */
+  amount: string;
+  /** Number of decimals for the asset */
+  decimals: number;
+  /** Whether this is a token (true) or native asset (false) */
+  isToken: boolean;
+};
+
+export async function getEvmTokenBalance(params: {
+  address: string;
+  token: string;
+  rpcUrl: string;
+}): Promise<BalanceResponse> {
+  // balanceOf(address) - ERC-20 standard
+  const data = `0x70a08231${params.address
+    .replace(/^0x/, "")
+    .padStart(64, "0")}`;
+
+  const balanceCall = {
+    jsonrpc: "2.0",
+    id: 1,
+    method: "eth_call",
+    params: [{ to: params.token, data }, "latest"],
+  } as const;
+
+  const balanceRes = await fetch(params.rpcUrl, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(balanceCall),
+  });
+
+  const balanceJson = (await balanceRes.json()) as { result?: string };
+  const balHex = balanceJson.result || "0x0";
+  const amount = BigInt(balHex);
+
+  // decimals() - ERC-20 standard
+  const decimalsCall = {
+    jsonrpc: "2.0",
+    id: 2,
+    method: "eth_call",
+    params: [{ to: params.token, data: "0x313ce567" }, "latest"],
+  } as const;
+
+  const decimalsRes = await fetch(params.rpcUrl, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(decimalsCall),
+  });
+
+  const decimalsJson = (await decimalsRes.json()) as { result?: string };
+  const decimals = decimalsJson.result
+    ? Number(BigInt(decimalsJson.result))
+    : 18;
+
+  return {
+    amount: amount.toString(),
+    decimals,
+    isToken: true,
+  };
+}
+
+const toSubscript = (num: number): string => {
+  const map: Record<string, string> = {
+    "0": "₀",
+    "1": "₁",
+    "2": "₂",
+    "3": "₃",
+    "4": "₄",
+    "5": "₅",
+    "6": "₆",
+    "7": "₇",
+    "8": "₈",
+    "9": "₉",
+  };
+  return String(num)
+    .split("")
+    .map((c) => map[c] ?? c)
+    .join("");
+};
+
+const formatTokenAmount = (
+  amount: bigint,
+  decimals: number,
+  subscriptDecimals: number = 4,
+  standardDecimals: number = 6
+): string => {
+  const sign = amount < 0n ? "-" : "";
+  const s = (amount < 0n ? -amount : amount).toString();
+
+  const hasFraction = decimals > 0;
+  const integerPart =
+    s.length > decimals ? s.slice(0, s.length - decimals) : "0";
+  const fractional = hasFraction
+    ? s.length > decimals
+      ? s.slice(s.length - decimals)
+      : s.padStart(decimals, "0")
+    : "";
+
+  const groupedInt = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+
+  if (!hasFraction) return sign + groupedInt;
+  if (/^0+$/.test(fractional)) return sign + groupedInt;
+
+  const leadingZeros = fractional.match(/^0+/)?.[0].length ?? 0;
+
+  if (leadingZeros >= 3) {
+    // Use subscript notation for numbers with 3+ leading zeros
+    const rest = fractional.slice(leadingZeros);
+    const truncatedRest = rest.slice(0, subscriptDecimals);
+    const compressedFrac = `0${toSubscript(leadingZeros)}${truncatedRest}`;
+    return `${sign}${groupedInt}.${compressedFrac}`;
+  }
+
+  // For 0-2 leading zeros, use standard decimal formatting
+  const truncatedFrac = fractional.slice(0, standardDecimals);
+  const trimmedFrac = truncatedFrac.replace(/0+$/, ""); // Remove trailing zeros
+
+  if (trimmedFrac === "") return sign + groupedInt;
+  return `${sign}${groupedInt}.${trimmedFrac}`;
+};
+
+// Agent execution function using the new AgentSdk v1.0 API
+const executionFunction: ExecutionFunctionContract = async (request) => {
+  console.log(`🚀 Agent execution called for session ${request.sessionId}`);
+
+  const sdk = new AgentSdk({
+    sessionId: request.sessionId,
+  });
+
+  try {
+    await sdk.addMessage({
+      type: "observe",
+      shortMessage:
+        "🚀 Starting Agent SDK v1.0 comprehensive demo -- live test",
+    });
+
+    const PEPE_ARB = "0x25d887Ce7a35172C62FeBFD67a1856F20FaEbB00" as `0x${string}`;
+    const pepeBalance = await getEvmTokenBalance({
+      rpcUrl: "https://arb-mainnet.g.alchemy.com/v2/<YOUR_API_KEY>",
+      address: request.sessionWalletAddress,
+      token: PEPE_ARB,
+    });
+
+    const pepeBalanceFormatted = formatTokenAmount(
+      BigInt(pepeBalance.amount),
+      pepeBalance.decimals
+    );
+
+    await sdk.addMessage({
+      type: "observe",
+      shortMessage: `PEPE Balance (Arbitrum): ${pepeBalanceFormatted} PEPE`,
+    });
+
+
+    const abi = parseAbi([
+      "function transfer(address to, uint256 value) returns (bool)",
+    ]);
+    const demoAmount = BigInt(pepeBalance.amount) / 100n;
+
+    const data = encodeFunctionData({
+      abi,
+      functionName: "transfer",
+      args: [request.sessionWalletAddress as `0x${string}`, demoAmount],
+    });
+
+    // Demo custom contract call
+    await sdk.signAndSend({
+      network: "ethereum:42161",
+      request: {
+        toAddress: PEPE_ARB,
+        data: data,
+        value: "0", // No ETH value for token transfers
+      },
+      message: "Custom PEPE transfer demo",
+    });
+
+
+    await sdk.addMessage({
+      type: "observe",
+      shortMessage:
+        "✅ Agent SDK v1.0 comprehensive demo completed successfully!",
+    });
+
+    return { success: true };
+  } catch (error) {
+    console.error("💥 Agent execution error:", error);
+
+    await sdk.addMessage({
+      type: "error",
+      shortMessage: `Agent execution error: ${
+        error instanceof Error ? error.message : "Unknown error"
+      }`,
+    });
+
+    // Optional - Return detailed error information for the CLI to display
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : "Unknown error",
+      errorDetails: {
+        name: error instanceof Error ? error.name : "Unknown",
+        message: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+        timestamp: new Date().toISOString(),
+        sessionId: request.sessionId,
+        agentSlug: (globalThis as any).CIRCUIT_AGENT_SLUG || "unknown",
+        errorType: "AGENT_EXECUTION_ERROR",
+      },
+    };
+  }
+};
+
+const stopFunction: StopFunctionContract = async (request) => {
+  const sdk = new AgentSdk({
+    sessionId: request.sessionId,
+    testing: true,
+  });
+
+  try {
+    await sdk.addMessage({
+      type: "observe",
+      shortMessage: "🛑 Agent stopping with new SDK v1.0",
+    });
+    return { success: true };
+  } catch (error) {
+    console.error("💥 Agent stop error:", error);
+
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : "Unknown error",
+      errorDetails: {
+        name: error instanceof Error ? error.name : "Unknown",
+        message: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+        timestamp: new Date().toISOString(),
+        sessionId: request.sessionId,
+        agentSlug: (globalThis as any).CIRCUIT_AGENT_SLUG || "unknown",
+      },
+    };
+  }
+};
+
+// Create the agent
+const agent = new Agent({ executionFunction, stopFunction });
+
+// Export the agent for both Bun local development and Cloudflare Workers
+export default agent.getWorkerExport();
+
+```

package/index.d.ts

@@ -1,48 +1,12 @@
 import { z } from 'zod';
 
 /**
- * Core type definitions for the Agent SDK
- */
-
-/**
- * Configuration for the SDK client
- */
-interface SDKConfig {
-    /** Session ID for the current agent instance */
-    sessionId: number;
-    /** Enable verbose logging for debugging */
-    verbose?: boolean;
-    /** Enable testing mode to return mock responses */
-    testing?: boolean;
-    /** Optional base URL for local development (auto-detected if omitted) */
-    baseUrl?: string;
-}
-
-/**
- * Network type definitions and guard functions
+ * Network type definitions
  */
 type Network = `ethereum:${number}` | "solana";
-/**
- * Type guard to check if network is Ethereum-based
- * @param network - Network to check
- * @returns true if network is ethereum:chainId format
- */
-declare function isEthereumNetwork(network: Network): network is `ethereum:${number}`;
-/**
- * Type guard to check if network is Solana
- * @param network - Network to check
- * @returns true if network is "solana"
- */
-declare function isSolanaNetwork(network: Network): network is "solana";
-/**
- * Extract chain ID from Ethereum network string
- * @param network - Ethereum network string
- * @returns Chain ID as number
- */
-declare function getChainIdFromNetwork(network: `ethereum:${number}`): number;
 
 /**
- * Request type definitions with conditional shapes based on network
+ * Transaction type definitions for agent operations
  */
 
 /**
@@ -65,17 +29,6 @@ type SignAndSendRequest = {
         hexTransaction: string;
     };
 });
-/**
- * Message request for addMessage function
- */
-type AddMessageRequest = {
-    type: "observe" | "validate" | "reflect" | "error" | "warning";
-    shortMessage: string;
-};
-
-/**
- * Response type definitions
- */
 /**
  * Standard response from signAndSend operations
  */
@@ -87,6 +40,101 @@ type SignAndSendResponse = {
     /** Optional transaction URL (explorer link) */
     transactionUrl?: string;
 };
+/**
+ * EIP712 TypedData schema for typed message signing
+ */
+declare const EIP712TypedDataSchema: z.ZodObject<{
+    domain: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        chainId: z.ZodOptional<z.ZodNumber>;
+        verifyingContract: z.ZodOptional<z.ZodString>;
+        salt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    types: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>>>;
+    primaryType: z.ZodString;
+    message: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$strip>;
+/**
+ * EIP191 Message schema for simple message signing
+ */
+declare const EIP191MessageSchema: z.ZodObject<{
+    message: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Main signMessage request type with network-specific conditional shapes
+ */
+type SignMessageRequest = {
+    network: Network;
+} & ({
+    network: `ethereum:${number}`;
+    request: {
+        messageType: "eip712";
+        data: z.infer<typeof EIP712TypedDataSchema>;
+        chainId: number;
+    };
+} | {
+    network: `ethereum:${number}`;
+    request: {
+        messageType: "eip191";
+        data: z.infer<typeof EIP191MessageSchema>;
+        chainId: number;
+    };
+});
+/**
+ * Standard response from signMessage operations
+ */
+type SignMessageResponse = {
+    /** Signature component v */
+    v: number;
+    /** Signature component r */
+    r: string;
+    /** Signature component s */
+    s: string;
+    /** Formatted signature string */
+    formattedSignature: string;
+    /** Signature type */
+    type: "evm";
+};
+
+/**
+ * Agent log type definitions for agent communication
+ */
+
+/**
+ * Structure for individual agent logs
+ */
+declare const AgentLogSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        error: "error";
+        observe: "observe";
+        validate: "validate";
+        reflect: "reflect";
+        warning: "warning";
+    }>;
+    shortMessage: z.ZodString;
+}, z.core.$strip>;
+type AgentLog = z.infer<typeof AgentLogSchema>;
+
+/**
+ * Configuration type definitions for the Agent SDK
+ */
+/**
+ * Configuration for the SDK client
+ */
+interface SDKConfig {
+    /** Session ID for the current agent instance */
+    sessionId: number;
+    /** Enable verbose logging for debugging */
+    verbose?: boolean;
+    /** Enable testing mode to return mock responses */
+    testing?: boolean;
+    /** Optional base URL for local development (auto-detected if omitted) */
+    baseUrl?: string;
+}
 
 /**
  * Main AgentSdk class with simplified API surface
@@ -98,7 +146,7 @@ type SignAndSendResponse = {
  * Provides a minimal, type-safe surface with two core methods that cover the
  * majority of agent interactions:
  *
- * - `addMessage()` — emit timeline messages for observability and UX
+ * - `sendLog()` — emit timeline logs for observability and UX
  * - `signAndSend()` — sign and broadcast transactions across networks
  *
  * Quick start:
@@ -109,7 +157,7 @@ type SignAndSendResponse = {
  *   sessionId: 12345,
  * });
  *
- * await sdk.addMessage({ type: "observe", shortMessage: "Starting" });
+ * await sdk.sendLog({ type: "observe", shortMessage: "Starting" });
  * const tx = await sdk.signAndSend({
  *   network: "ethereum:42161",
  *   request: {
@@ -138,23 +186,23 @@ declare class AgentSdk {
      * ```
      */
     constructor(config: SDKConfig);
-    private log;
+    private logging;
     /**
-     * Add a message to the agent timeline.
+     * Add a log to the agent timeline.
      *
      * Messages show up in session traces and UIs and are useful for observability,
      * human-in-the-loop reviews, and debugging.
      *
-     * @param message - Timeline message
-     * @param message.type - One of: `"observe" | "validate" | "reflect" | "error" | "warning"`
-     * @param message.shortMessage - Short, human-readable message (<= 250 chars)
-     * @returns Resolves when the message is accepted by the backend
+     * @param log - Timeline message
+     * @param log.type - One of: `"observe" | "validate" | "reflect" | "error" | "warning"`
+     * @param log.shortMessage - Short, human-readable message (<= 250 chars)
+     * @returns Resolves when the log is accepted by the backend
      * @example
      * ```ts
-     * await sdk.addMessage({ type: "observe", shortMessage: "Starting swap" });
+     * await sdk.sendLog({ type: "observe", shortMessage: "Starting swap" });
      * ```
      */
-    addMessage(message: AddMessageRequest): Promise<void>;
+    sendLog(log: AgentLog): Promise<void>;
     /**
      * Sign and broadcast a transaction on the specified network.
      *
@@ -195,6 +243,42 @@ declare class AgentSdk {
      * ```
      */
     signAndSend(request: SignAndSendRequest): Promise<SignAndSendResponse>;
+    /**
+     * Sign a message using the agent's key.
+     *
+     * This is useful for signing arbitrary messages, such as EIP-712 typed data.
+     *
+     * @param request - Message signing request with network-specific parameters
+     * @param request.network - `"ethereum:${number}"` for EVM networks
+     * @param request.request - Message signing parameters
+     *   - For EIP-712: `{ messageType: "eip712", data: { domain, types, primaryType, message }, chainId }`
+     *   - For EIP-191: `{ messageType: "eip191", data: { message }, chainId }`
+     * @returns Promise resolving to signature components `{ v, r, s, formattedSignature, type }`
+     * @throws Error if the network is unsupported or the backend rejects the request
+     * @example
+     * ```ts
+     * // EIP-191 simple message signing
+     * const signature = await sdk.signMessage({
+     *   network: "ethereum:1",
+     *   request: {
+     *     messageType: "eip191",
+     *     data: { message: "Hello, world!" },
+     *     chainId: 1
+     *   }
+     * });
+     *
+     * // EIP-712 typed data signing
+     * const signature = await sdk.signMessage({
+     *   network: "ethereum:1",
+     *   request: {
+     *     messageType: "eip712",
+     *     data: { domain: {...}, types: {...}, primaryType: "Message", message: {...} },
+     *     chainId: 1
+     *   }
+     * });
+     * ```
+     */
+    signMessage(request: SignMessageRequest): Promise<SignMessageResponse>;
     /**
      * Handle EVM transaction signing and broadcasting
      */
@@ -204,9 +288,13 @@ declare class AgentSdk {
      */
     private handleSolanaTransaction;
     /**
-     * Send messages to the agent timeline (migrated from AgentToolset)
+     * Handle EVM message signing
      */
-    private messageSend;
+    private handleEvmSignMessage;
+    /**
+     * Send logs to the agent timeline (migrated from AgentToolset)
+     */
+    private _sendLog;
 }
 
 /**
@@ -237,7 +325,7 @@ declare class APIClient {
     private getAgentSlug;
     private getAuthHeaders;
     private loadAuthConfig;
-    private log;
+    private logging;
     /**
      * Perform a JSON HTTP request.
      *
@@ -301,7 +389,7 @@ type HealthResponse = z.infer<typeof HealthResponseSchema>;
  *
  *   try {
  *     // Send status message
- *     await agentToolset.messageSend([{
+ *     await agentToolset.sendLog([{
  *       type: "observe",
  *       shortMessage: "Starting agent execution..."
  *     }]);
@@ -350,10 +438,9 @@ type ExecutionFunctionContract = (request: AgentRequest) => Promise<AgentRespons
  *
  *   try {
  *     // Notify about shutdown
- *     await agentToolset.messageSend([{
+ *     await agentToolset.sendLog([{
  *       type: "observe",
  *       shortMessage: "Agent shutting down...",
- *       longMessage: "Cleaning up resources and saving state"
  *     }]);
  *
  *     // Example: Update sleep interval before shutdown
@@ -362,10 +449,9 @@ type ExecutionFunctionContract = (request: AgentRequest) => Promise<AgentRespons
  *     });
  *
  *     // Example: Final status message
- *     await agentToolset.messageSend([{
+ *     await agentToolset.sendLog([{
  *       type: "observe",
  *       shortMessage: "Shutdown complete",
- *       longMessage: `Agent ${request.sessionId} successfully shut down`
  *     }]);
  *
  *     return {
@@ -383,30 +469,6 @@ type ExecutionFunctionContract = (request: AgentRequest) => Promise<AgentRespons
  * ```
  */
 type StopFunctionContract = (request: AgentRequest) => Promise<AgentResponse>;
-/**
- * Contract for agent chat functions. Handle interactive messaging with the agent.
- * @param request - Contains session information and wallet address to operate with
- * @returns Promise resolving to a success/error response
- * @example
- * ```typescript
- * // Chat function implementation
- * const chatFunction: ChatFunctionContract = async (request) => {
- *   const agentToolset = new AgentToolset({ sessionId: request.sessionId });
- *
- *   await agentToolset.messageSend([{
- *     type: "observe",
- *     shortMessage: "Processing chat message",
- *     longMessage: `Received message for wallet ${request.sessionWalletAddress}`
- *   }]);
- *
- *   return {
- *     success: true,
- *     message: "Chat message processed"
- *   };
- * };
- * ```
- */
-type ChatFunctionContract = (request: AgentRequest) => Promise<AgentResponse>;
 /**
  * Contract for agent health check functions. Handle health status requests.
  * @returns Promise resolving to an object with a status field
@@ -433,8 +495,6 @@ type HealthCheckFunctionContract = () => Promise<HealthResponse>;
 interface AgentConfig {
     /** Main execution function that implements the agent's core logic */
     executionFunction: ExecutionFunctionContract;
-    /** Optional chat function for handling interactive messaging */
-    chatFunction?: ChatFunctionContract;
     /** Optional winddown function for cleanup operations, this is called when the agent is stopped */
     stopFunction?: StopFunctionContract;
     /** Optional health check function for monitoring agent health status */
@@ -445,14 +505,12 @@ interface AgentConfig {
  *
  * Exposes the following endpoints:
  * - `POST /execute` — required, calls your execution function
- * - `POST /chat` — optional, when a `chatFunction` is provided
  * - `POST /stop` and `DELETE /` — optional, when a `stopFunction` is provided
  * - `GET /health` — always available, uses provided or default health check
  */
 declare class Agent {
     private app;
     private executionFunction;
-    private chatFunction?;
     private stopFunction?;
     private healthCheckFunction?;
     /**
@@ -471,4 +529,27 @@ declare class Agent {
     };
 }
 
-export { APIClient, type AddMessageRequest, Agent, AgentSdk, type ExecutionFunctionContract, type Network, type SDKConfig, type SignAndSendRequest, type SignAndSendResponse, type StopFunctionContract, getChainIdFromNetwork, isEthereumNetwork, isSolanaNetwork };
+/**
+ * Utility functions for network operations
+ */
+
+/**
+ * Type guard to check if network is Ethereum-based
+ * @param network - Network to check
+ * @returns true if network is ethereum:chainId format
+ */
+declare function isEthereumNetwork(network: Network): network is `ethereum:${number}`;
+/**
+ * Type guard to check if network is Solana
+ * @param network - Network to check
+ * @returns true if network is "solana"
+ */
+declare function isSolanaNetwork(network: Network): network is "solana";
+/**
+ * Extract chain ID from Ethereum network string
+ * @param network - Ethereum network string
+ * @returns Chain ID as number
+ */
+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 };

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||!process.env?.HOME)return;const fs=eval("require")("fs"),path=eval("require")("path"),authPath=path.join(process.env.HOME,".config","circuit","auth.json");if(!fs.existsSync(authPath))return;const authContent=fs.readFileSync(authPath,"utf-8");return JSON.parse(authContent)}catch(t){return}}module.exports={loadAuthFromFileSystem:loadAuthFromFileSystem}}});import{z}from"zod";var API_BASE_URL_LOCAL="https://agents.circuit.org",MessageTypeSchema=z.enum(["observe","validate","reflect","error","warning"]),MessageSchema=z.object({type:MessageTypeSchema,shortMessage:z.string().max(250)}),MessagesRequestSchema=z.array(MessageSchema),MessagesResponseSchema=z.object({status:z.number(),message:z.string()}),TransactionSendRequestSchema=z.object({chainId:z.number(),toAddress:z.string(),data:z.string(),valueWei:z.string(),message:z.string().max(250).optional(),gas:z.number().optional(),maxFeePerGas:z.string().optional(),maxPriorityFeePerGas:z.string().optional()}),SolanaTransactionRequestSchema=z.object({hexTransaction:z.string(),message:z.string().max(250).optional()}),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}}log(t,e){this.config.verbose}async makeRequest(t,e={}){const s={...{"Content-Type":"application/json",...this.getAuthHeaders()},...e.headers};let r;if(this.log("=== REQUEST DETAILS ==="),this.log("Endpoint:",t),this.log("Method:",e.method||"GET"),this.log("Headers:",s),this.log("Body:",e.body),this.log("Session ID:",this.config.sessionId),this.log("Agent Slug:",this.getAgentSlug()||"not set"),this.log("Using Service Binding:",this.hasServiceBinding()),this.log("====================="),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.log("Using service binding AGENTS_TO_API_PROXY"),this.log("Service binding type:",typeof n);const o={...e,headers:s},a=`https://agents-to-api-proxy.circuit-0bc.workers.dev${t}`;r=await n.fetch(a,o)}else{this.log("Using HTTP fallback to:",this.baseUrl);const n=`${this.baseUrl}${t}`,o={...e,headers:s};r=await fetch(n,o)}if(this.log("=== RESPONSE DETAILS ==="),this.log("Status:",r.status),this.log("Status Text:",r.statusText),this.log("Response Headers:",Object.fromEntries(r.headers.entries())),this.log("======================"),!r.ok){const t=await r.json().catch(()=>({}));throw this.log("=== ERROR RESPONSE ==="),this.log("Error Data:",t),this.log("===================="),new Error(t.message||`HTTP ${r.status}: ${r.statusText}`)}const n=await r.json();return this.log("=== SUCCESS RESPONSE ==="),this.log("Response Data:",n),this.log("======================"),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)}log(t,e){this.config.verbose}async addMessage(t){this.log("=== ADD MESSAGE ==="),this.log("Message:",t),this.log("===================");const e=[{type:t.type,shortMessage:t.shortMessage}];await this.messageSend(e)}async signAndSend(t){if(this.log("=== SIGN AND SEND ==="),this.log("Request:",t),this.log("Testing mode:",this.config.testing),this.log("===================="),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 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 messageSend(t){return this.config.testing?{status:200,message:"Messages added successfully (TESTING)"}:this.client.post("/v1/messages",t)}};import{zValidator}from"@hono/zod-validator";import{Hono}from"hono";import{cors}from"hono/cors";import{z as z2}from"zod";var AgentRequestSchema=z2.object({sessionId:z2.number(),sessionWalletAddress:z2.string(),otherParameters:z2.object().optional()}),AgentResponseSchema=z2.object({success:z2.boolean(),error:z2.string().optional(),message:z2.string().optional()}),HealthResponseSchema=z2.object({status:z2.string()}),Agent=class{app;executionFunction;chatFunction;stopFunction;healthCheckFunction;constructor(t){this.app=new Hono,this.executionFunction=t.executionFunction,this.chatFunction=t.chatFunction,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.chatFunction&&this.app.post("/chat",zValidator("json",AgentRequestSchema),async t=>{try{const e=t.req.valid("json"),s=await(this.chatFunction?.(e));return t.json(s)}catch(e){return t.json({success:!1,error:e instanceof Error?e.message:"Unknown error",message:"Chat 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,r){return new Agent({executionFunction:t,chatFunction:e,stopFunction:s,healthCheckFunction:r})}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||!process.env?.HOME)return;const fs=eval("require")("fs"),path=eval("require")("path"),authPath=path.join(process.env.HOME,".config","circuit","auth.json");if(!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};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circuitorg/agent-sdk",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "typescript sdk for the Agent Toolset Service",
   "type": "module",
   "main": "index.js",
@@ -27,9 +27,9 @@
   "author": "circuitorg",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/circuitorg/agents-sdk/issues"
+    "url": "https://github.com/circuitorg/agent-sdk-typescript/issues"
   },
-  "homepage": "https://github.com/circuitorg/agents-sdk#readme",
+  "homepage": "https://github.com/circuitorg/agent-sdk-typescript#readme",
   "sideEffects": false,
   "browser": {
     "ws": "./src/stubs/ws-stub.js",
@@ -67,4 +67,4 @@
     "type": "git",
     "url": "git+https://github.com/circuitorg/agents-sdk.git"
   }
-}
+}