@gopherhole/sdk 0.1.2 → 0.1.3

package/dist/index.d.mts

@@ -192,6 +192,8 @@ interface GopherHoleOptions {
     reconnectDelay?: number;
     /** Max reconnect attempts */
     maxReconnectAttempts?: number;
+    /** Default request timeout in ms (default: 30000) */
+    requestTimeout?: number;
 }
 /** Agent card configuration for registration */
 interface AgentCardConfig {
@@ -253,6 +255,14 @@ interface SendOptions {
     pushNotificationUrl?: string;
     /** History length to include */
     historyLength?: number;
+    /** Request timeout in ms (overrides default) */
+    timeoutMs?: number;
+}
+interface SendAndWaitOptions extends SendOptions {
+    /** Polling interval in ms (default: 1000) */
+    pollIntervalMs?: number;
+    /** Max wait time in ms (default: 300000 = 5 min) */
+    maxWaitMs?: number;
 }
 type EventMap = {
     connect: () => void;
@@ -269,6 +279,7 @@ declare class GopherHole extends EventEmitter<EventMap> {
     private autoReconnect;
     private reconnectDelay;
     private maxReconnectAttempts;
+    private requestTimeout;
     private reconnectAttempts;
     private reconnectTimer;
     private pingInterval;
@@ -295,6 +306,15 @@ declare class GopherHole extends EventEmitter<EventMap> {
      * Send a text message to another agent
      */
     sendText(toAgentId: string, text: string, options?: SendOptions): Promise<Task>;
+    /**
+     * Send a text message and wait for completion
+     * Returns the completed task with response artifacts
+     */
+    sendTextAndWait(toAgentId: string, text: string, options?: SendAndWaitOptions): Promise<Task>;
+    /**
+     * Wait for a task to complete (polling)
+     */
+    waitForTask(taskId: string, options?: SendAndWaitOptions): Promise<Task>;
     /**
      * Get a task by ID
      */
@@ -502,4 +522,4 @@ interface RatingResult {
     ratingCount: number;
 }
 
-export { type A2AArtifact, type A2AMessage, type A2ATask, type A2ATaskStatus, type AgentAuthentication, type AgentCapabilities, type AgentCard, type AgentCardConfig, type AgentCategory, type AgentInfoResult, type AgentReview, type AgentSkill, type AgentSkillConfig, type Artifact, type ContentMode, type DataContent, type DataPart, type DiscoverOptions, type DiscoverResult, type FileContent, type FilePart, GopherHole, type GopherHoleOptions, type InputMode, type JsonRpcError, JsonRpcErrorCodes, type JsonRpcRequest, type JsonRpcResponse, type Message, type MessagePart, type MessagePayload, type MessageSendConfiguration, type OutputMode, type Part, type PublicAgent, type PushNotificationConfig, type RatingResult, type SendOptions, type Task, type TaskArtifactUpdateEvent, type TaskEvent, type TaskListConfiguration, type TaskPushNotificationConfig, type TaskQueryConfiguration, type TaskState, type TaskStatus, type TaskStatusUpdateEvent, type TextPart, GopherHole as default };
+export { type A2AArtifact, type A2AMessage, type A2ATask, type A2ATaskStatus, type AgentAuthentication, type AgentCapabilities, type AgentCard, type AgentCardConfig, type AgentCategory, type AgentInfoResult, type AgentReview, type AgentSkill, type AgentSkillConfig, type Artifact, type ContentMode, type DataContent, type DataPart, type DiscoverOptions, type DiscoverResult, type FileContent, type FilePart, GopherHole, type GopherHoleOptions, type InputMode, type JsonRpcError, JsonRpcErrorCodes, type JsonRpcRequest, type JsonRpcResponse, type Message, type MessagePart, type MessagePayload, type MessageSendConfiguration, type OutputMode, type Part, type PublicAgent, type PushNotificationConfig, type RatingResult, type SendAndWaitOptions, type SendOptions, type Task, type TaskArtifactUpdateEvent, type TaskEvent, type TaskListConfiguration, type TaskPushNotificationConfig, type TaskQueryConfiguration, type TaskState, type TaskStatus, type TaskStatusUpdateEvent, type TextPart, GopherHole as default };

package/dist/index.d.ts

@@ -192,6 +192,8 @@ interface GopherHoleOptions {
     reconnectDelay?: number;
     /** Max reconnect attempts */
     maxReconnectAttempts?: number;
+    /** Default request timeout in ms (default: 30000) */
+    requestTimeout?: number;
 }
 /** Agent card configuration for registration */
 interface AgentCardConfig {
@@ -253,6 +255,14 @@ interface SendOptions {
     pushNotificationUrl?: string;
     /** History length to include */
     historyLength?: number;
+    /** Request timeout in ms (overrides default) */
+    timeoutMs?: number;
+}
+interface SendAndWaitOptions extends SendOptions {
+    /** Polling interval in ms (default: 1000) */
+    pollIntervalMs?: number;
+    /** Max wait time in ms (default: 300000 = 5 min) */
+    maxWaitMs?: number;
 }
 type EventMap = {
     connect: () => void;
@@ -269,6 +279,7 @@ declare class GopherHole extends EventEmitter<EventMap> {
     private autoReconnect;
     private reconnectDelay;
     private maxReconnectAttempts;
+    private requestTimeout;
     private reconnectAttempts;
     private reconnectTimer;
     private pingInterval;
@@ -295,6 +306,15 @@ declare class GopherHole extends EventEmitter<EventMap> {
      * Send a text message to another agent
      */
     sendText(toAgentId: string, text: string, options?: SendOptions): Promise<Task>;
+    /**
+     * Send a text message and wait for completion
+     * Returns the completed task with response artifacts
+     */
+    sendTextAndWait(toAgentId: string, text: string, options?: SendAndWaitOptions): Promise<Task>;
+    /**
+     * Wait for a task to complete (polling)
+     */
+    waitForTask(taskId: string, options?: SendAndWaitOptions): Promise<Task>;
     /**
      * Get a task by ID
      */
@@ -502,4 +522,4 @@ interface RatingResult {
     ratingCount: number;
 }
 
-export { type A2AArtifact, type A2AMessage, type A2ATask, type A2ATaskStatus, type AgentAuthentication, type AgentCapabilities, type AgentCard, type AgentCardConfig, type AgentCategory, type AgentInfoResult, type AgentReview, type AgentSkill, type AgentSkillConfig, type Artifact, type ContentMode, type DataContent, type DataPart, type DiscoverOptions, type DiscoverResult, type FileContent, type FilePart, GopherHole, type GopherHoleOptions, type InputMode, type JsonRpcError, JsonRpcErrorCodes, type JsonRpcRequest, type JsonRpcResponse, type Message, type MessagePart, type MessagePayload, type MessageSendConfiguration, type OutputMode, type Part, type PublicAgent, type PushNotificationConfig, type RatingResult, type SendOptions, type Task, type TaskArtifactUpdateEvent, type TaskEvent, type TaskListConfiguration, type TaskPushNotificationConfig, type TaskQueryConfiguration, type TaskState, type TaskStatus, type TaskStatusUpdateEvent, type TextPart, GopherHole as default };
+export { type A2AArtifact, type A2AMessage, type A2ATask, type A2ATaskStatus, type AgentAuthentication, type AgentCapabilities, type AgentCard, type AgentCardConfig, type AgentCategory, type AgentInfoResult, type AgentReview, type AgentSkill, type AgentSkillConfig, type Artifact, type ContentMode, type DataContent, type DataPart, type DiscoverOptions, type DiscoverResult, type FileContent, type FilePart, GopherHole, type GopherHoleOptions, type InputMode, type JsonRpcError, JsonRpcErrorCodes, type JsonRpcRequest, type JsonRpcResponse, type Message, type MessagePart, type MessagePayload, type MessageSendConfiguration, type OutputMode, type Part, type PublicAgent, type PushNotificationConfig, type RatingResult, type SendAndWaitOptions, type SendOptions, type Task, type TaskArtifactUpdateEvent, type TaskEvent, type TaskListConfiguration, type TaskPushNotificationConfig, type TaskQueryConfiguration, type TaskState, type TaskStatus, type TaskStatusUpdateEvent, type TextPart, GopherHole as default };

package/dist/index.js

@@ -62,6 +62,7 @@ var GopherHole = class extends import_eventemitter3.EventEmitter {
     this.autoReconnect = options.autoReconnect ?? true;
     this.reconnectDelay = options.reconnectDelay ?? 1e3;
     this.maxReconnectAttempts = options.maxReconnectAttempts ?? 10;
+    this.requestTimeout = options.requestTimeout ?? 3e4;
   }
   /**
    * Update agent card (sends to hub if connected)
@@ -132,13 +133,14 @@ var GopherHole = class extends import_eventemitter3.EventEmitter {
    * Send a message to another agent
    */
   async send(toAgentId, payload, options) {
+    const { timeoutMs, ...config } = options || {};
     const response = await this.rpc("message/send", {
       message: payload,
       configuration: {
         agentId: toAgentId,
-        ...options
+        ...config
       }
-    });
+    }, timeoutMs);
     return response;
   }
   /**
@@ -150,6 +152,30 @@ var GopherHole = class extends import_eventemitter3.EventEmitter {
       parts: [{ kind: "text", text }]
     }, options);
   }
+  /**
+   * Send a text message and wait for completion
+   * Returns the completed task with response artifacts
+   */
+  async sendTextAndWait(toAgentId, text, options) {
+    const task = await this.sendText(toAgentId, text, options);
+    return this.waitForTask(task.id, options);
+  }
+  /**
+   * Wait for a task to complete (polling)
+   */
+  async waitForTask(taskId, options) {
+    const pollInterval = options?.pollIntervalMs ?? 1e3;
+    const maxWait = options?.maxWaitMs ?? 3e5;
+    const startTime = Date.now();
+    while (Date.now() - startTime < maxWait) {
+      const task = await this.getTask(taskId);
+      if (task.status.state === "completed" || task.status.state === "failed" || task.status.state === "canceled" || task.status.state === "rejected") {
+        return task;
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    throw new Error(`Task ${taskId} did not complete within ${maxWait}ms`);
+  }
   /**
    * Get a task by ID
    */
@@ -209,25 +235,38 @@ var GopherHole = class extends import_eventemitter3.EventEmitter {
   /**
    * Make a JSON-RPC call to the A2A endpoint
    */
-  async rpc(method, params) {
-    const response = await fetch(`${this.apiUrl}/a2a`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${this.apiKey}`
-      },
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        method,
-        params,
-        id: Date.now()
-      })
-    });
-    const data = await response.json();
-    if (data.error) {
-      throw new Error(data.error.message || "RPC error");
+  async rpc(method, params, timeoutMs) {
+    const timeout = timeoutMs ?? this.requestTimeout;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+      const response = await fetch(`${this.apiUrl}/a2a`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this.apiKey}`
+        },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          method,
+          params,
+          id: Date.now()
+        }),
+        signal: controller.signal
+      });
+      const data = await response.json();
+      if (data.error) {
+        throw new Error(data.error.message || "RPC error");
+      }
+      return data.result;
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        throw new Error(`Request timeout after ${timeout}ms`);
+      }
+      throw err;
+    } finally {
+      clearTimeout(timeoutId);
     }
-    return data.result;
   }
   /**
    * Handle incoming WebSocket messages

package/dist/index.mjs

@@ -43,6 +43,7 @@ var GopherHole = class extends EventEmitter {
     this.autoReconnect = options.autoReconnect ?? true;
     this.reconnectDelay = options.reconnectDelay ?? 1e3;
     this.maxReconnectAttempts = options.maxReconnectAttempts ?? 10;
+    this.requestTimeout = options.requestTimeout ?? 3e4;
   }
   /**
    * Update agent card (sends to hub if connected)
@@ -113,13 +114,14 @@ var GopherHole = class extends EventEmitter {
    * Send a message to another agent
    */
   async send(toAgentId, payload, options) {
+    const { timeoutMs, ...config } = options || {};
     const response = await this.rpc("message/send", {
       message: payload,
       configuration: {
         agentId: toAgentId,
-        ...options
+        ...config
       }
-    });
+    }, timeoutMs);
     return response;
   }
   /**
@@ -131,6 +133,30 @@ var GopherHole = class extends EventEmitter {
       parts: [{ kind: "text", text }]
     }, options);
   }
+  /**
+   * Send a text message and wait for completion
+   * Returns the completed task with response artifacts
+   */
+  async sendTextAndWait(toAgentId, text, options) {
+    const task = await this.sendText(toAgentId, text, options);
+    return this.waitForTask(task.id, options);
+  }
+  /**
+   * Wait for a task to complete (polling)
+   */
+  async waitForTask(taskId, options) {
+    const pollInterval = options?.pollIntervalMs ?? 1e3;
+    const maxWait = options?.maxWaitMs ?? 3e5;
+    const startTime = Date.now();
+    while (Date.now() - startTime < maxWait) {
+      const task = await this.getTask(taskId);
+      if (task.status.state === "completed" || task.status.state === "failed" || task.status.state === "canceled" || task.status.state === "rejected") {
+        return task;
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    throw new Error(`Task ${taskId} did not complete within ${maxWait}ms`);
+  }
   /**
    * Get a task by ID
    */
@@ -190,25 +216,38 @@ var GopherHole = class extends EventEmitter {
   /**
    * Make a JSON-RPC call to the A2A endpoint
    */
-  async rpc(method, params) {
-    const response = await fetch(`${this.apiUrl}/a2a`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${this.apiKey}`
-      },
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        method,
-        params,
-        id: Date.now()
-      })
-    });
-    const data = await response.json();
-    if (data.error) {
-      throw new Error(data.error.message || "RPC error");
+  async rpc(method, params, timeoutMs) {
+    const timeout = timeoutMs ?? this.requestTimeout;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+      const response = await fetch(`${this.apiUrl}/a2a`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this.apiKey}`
+        },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          method,
+          params,
+          id: Date.now()
+        }),
+        signal: controller.signal
+      });
+      const data = await response.json();
+      if (data.error) {
+        throw new Error(data.error.message || "RPC error");
+      }
+      return data.result;
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        throw new Error(`Request timeout after ${timeout}ms`);
+      }
+      throw err;
+    } finally {
+      clearTimeout(timeoutId);
     }
-    return data.result;
   }
   /**
    * Handle incoming WebSocket messages

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gopherhole/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "GopherHole SDK - Connect AI agents via the A2A protocol",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/index.ts

@@ -16,6 +16,8 @@ export interface GopherHoleOptions {
   reconnectDelay?: number;
   /** Max reconnect attempts */
   maxReconnectAttempts?: number;
+  /** Default request timeout in ms (default: 30000) */
+  requestTimeout?: number;
 }
 
 /** Agent card configuration for registration */
@@ -86,6 +88,15 @@ export interface SendOptions {
   pushNotificationUrl?: string;
   /** History length to include */
   historyLength?: number;
+  /** Request timeout in ms (overrides default) */
+  timeoutMs?: number;
+}
+
+export interface SendAndWaitOptions extends SendOptions {
+  /** Polling interval in ms (default: 1000) */
+  pollIntervalMs?: number;
+  /** Max wait time in ms (default: 300000 = 5 min) */
+  maxWaitMs?: number;
 }
 
 type EventMap = {
@@ -107,6 +118,7 @@ export class GopherHole extends EventEmitter<EventMap> {
   private autoReconnect: boolean;
   private reconnectDelay: number;
   private maxReconnectAttempts: number;
+  private requestTimeout: number;
   private reconnectAttempts = 0;
   private reconnectTimer: ReturnType<typeof setTimeout> | null = null;
   private pingInterval: ReturnType<typeof setInterval> | null = null;
@@ -127,6 +139,7 @@ export class GopherHole extends EventEmitter<EventMap> {
     this.autoReconnect = options.autoReconnect ?? true;
     this.reconnectDelay = options.reconnectDelay ?? 1000;
     this.maxReconnectAttempts = options.maxReconnectAttempts ?? 10;
+    this.requestTimeout = options.requestTimeout ?? 30000;
   }
   
   /**
@@ -209,13 +222,14 @@ export class GopherHole extends EventEmitter<EventMap> {
    * Send a message to another agent
    */
   async send(toAgentId: string, payload: MessagePayload, options?: SendOptions): Promise<Task> {
+    const { timeoutMs, ...config } = options || {};
     const response = await this.rpc('message/send', {
       message: payload,
       configuration: {
         agentId: toAgentId,
-        ...options,
+        ...config,
       },
-    });
+    }, timeoutMs);
 
     return response as Task;
   }
@@ -230,6 +244,38 @@ export class GopherHole extends EventEmitter<EventMap> {
     }, options);
   }
 
+  /**
+   * Send a text message and wait for completion
+   * Returns the completed task with response artifacts
+   */
+  async sendTextAndWait(toAgentId: string, text: string, options?: SendAndWaitOptions): Promise<Task> {
+    const task = await this.sendText(toAgentId, text, options);
+    return this.waitForTask(task.id, options);
+  }
+
+  /**
+   * Wait for a task to complete (polling)
+   */
+  async waitForTask(taskId: string, options?: SendAndWaitOptions): Promise<Task> {
+    const pollInterval = options?.pollIntervalMs ?? 1000;
+    const maxWait = options?.maxWaitMs ?? 300000; // 5 min default
+    const startTime = Date.now();
+
+    while (Date.now() - startTime < maxWait) {
+      const task = await this.getTask(taskId);
+      
+      if (task.status.state === 'completed' || task.status.state === 'failed' || 
+          task.status.state === 'canceled' || task.status.state === 'rejected') {
+        return task;
+      }
+
+      // Wait before polling again
+      await new Promise(resolve => setTimeout(resolve, pollInterval));
+    }
+
+    throw new Error(`Task ${taskId} did not complete within ${maxWait}ms`);
+  }
+
   /**
    * Get a task by ID
    */
@@ -305,28 +351,42 @@ export class GopherHole extends EventEmitter<EventMap> {
   /**
    * Make a JSON-RPC call to the A2A endpoint
    */
-  private async rpc(method: string, params: Record<string, unknown>): Promise<unknown> {
-    const response = await fetch(`${this.apiUrl}/a2a`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${this.apiKey}`,
-      },
-      body: JSON.stringify({
-        jsonrpc: '2.0',
-        method,
-        params,
-        id: Date.now(),
-      }),
-    });
+  private async rpc(method: string, params: Record<string, unknown>, timeoutMs?: number): Promise<unknown> {
+    const timeout = timeoutMs ?? this.requestTimeout;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+
+    try {
+      const response = await fetch(`${this.apiUrl}/a2a`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${this.apiKey}`,
+        },
+        body: JSON.stringify({
+          jsonrpc: '2.0',
+          method,
+          params,
+          id: Date.now(),
+        }),
+        signal: controller.signal,
+      });
 
-    const data = await response.json();
+      const data = await response.json();
 
-    if (data.error) {
-      throw new Error(data.error.message || 'RPC error');
-    }
+      if (data.error) {
+        throw new Error(data.error.message || 'RPC error');
+      }
 
-    return data.result;
+      return data.result;
+    } catch (err) {
+      if (err instanceof Error && err.name === 'AbortError') {
+        throw new Error(`Request timeout after ${timeout}ms`);
+      }
+      throw err;
+    } finally {
+      clearTimeout(timeoutId);
+    }
   }
 
   /**