@slashfi/agents-sdk 0.77.0 → 0.77.2

package/src/registry.ts

@@ -5,6 +5,7 @@
  */
 
 import { dirname, resolve } from "node:path";
+import { AdkError } from "./adk-error.js";
 import type { AgentEvent, BaseEvent, CallAgentToolCallEvent, CustomEventMap, EventCallback, EventType, ListAgentsResult, ListAgentsToolCallEvent } from "./events.js";
 import { createEventBus } from "./events.js";
 import type { Logger } from "./logger.js";
@@ -39,6 +40,33 @@ const DEFAULT_SUPPORTED_ACTIONS: AgentAction[] = [
   "read_resources",
 ];
 
+function adkErrorFields(
+  err: unknown,
+): { code: string; hint: string; details: Record<string, unknown> } | null {
+  if (err instanceof AdkError) {
+    return { code: err.code, hint: err.hint, details: err.details };
+  }
+  if (!err || typeof err !== "object") return null;
+  const candidate = err as {
+    name?: unknown;
+    code?: unknown;
+    hint?: unknown;
+    details?: unknown;
+  };
+  return candidate.name === "AdkError" &&
+    typeof candidate.code === "string" &&
+    typeof candidate.hint === "string" &&
+    !!candidate.details &&
+    typeof candidate.details === "object" &&
+    !Array.isArray(candidate.details)
+    ? {
+        code: candidate.code,
+        hint: candidate.hint,
+        details: candidate.details as Record<string, unknown>,
+      }
+    : null;
+}
+
 /**
  * Estimate the token count for a tool schema when serialized to JSON.
  * Uses a rough heuristic: ~4 characters per token (conservative estimate
@@ -760,10 +788,15 @@ export function createAgentRegistry(
                 })
                 .catch(() => {}); // don't let emit error mask tool error
 
+              const adkErr = adkErrorFields(err);
               return {
                 success: false,
                 error: err instanceof Error ? err.message : String(err),
-                code: "TOOL_EXECUTION_ERROR",
+                code: adkErr?.code ?? "TOOL_EXECUTION_ERROR",
+                ...(adkErr && {
+                  hint: adkErr.hint,
+                  details: adkErr.details,
+                }),
               } as CallAgentErrorResponse;
             }
 
@@ -784,11 +817,16 @@ export function createAgentRegistry(
             } as CallAgentExecuteToolResponse;
           } catch (outerErr) {
             // Catch-all for unexpected errors (e.g., emit failures)
+            const adkErr = adkErrorFields(outerErr);
             return {
               success: false,
               error:
                 outerErr instanceof Error ? outerErr.message : String(outerErr),
-              code: "TOOL_EXECUTION_ERROR",
+              code: adkErr?.code ?? "TOOL_EXECUTION_ERROR",
+              ...(adkErr && {
+                hint: adkErr.hint,
+                details: adkErr.details,
+              }),
             } as CallAgentErrorResponse;
           }
         }

package/src/types.ts

@@ -4,8 +4,8 @@
  * Defines the fundamental types for agent definitions, tools, and contexts.
  */
 
-import type { EventCallback, EventType } from "./events.js";
 import type { AgentAction, CallerType } from "./call-agent-schema.js";
+import type { EventCallback, EventType } from "./events.js";
 
 /** Internal listener entry stored on agents/tools */
 export interface ListenerEntry {
@@ -22,7 +22,15 @@ export interface ListenerEntry {
  * JSON Schema definition for tool input parameters.
  */
 export type JsonSchema = {
-  type: "object" | "array" | "string" | "number" | "integer" | "boolean" | "null" | string[];
+  type:
+    | "object"
+    | "array"
+    | "string"
+    | "number"
+    | "integer"
+    | "boolean"
+    | "null"
+    | string[];
   properties?: Record<string, JsonSchema>;
   items?: JsonSchema;
   required?: string[];
@@ -293,7 +301,7 @@ export type SecurityScheme =
  * directory-level overview (e.g., in list_agents responses).
  */
 export interface SecuritySchemeSummary {
-  type: SecurityScheme['type'];
+  type: SecurityScheme["type"];
   [key: string]: unknown;
 }
 
@@ -710,7 +718,7 @@ export interface AgentDefinition<TContext extends ToolContext = ToolContext> {
    * - 'direct': registry hosts and serves this agent's tools (default)
    * - 'redirect': registry catalogs this agent but clients connect to `upstream` directly
    */
-  mode?: 'direct' | 'redirect';
+  mode?: "direct" | "redirect";
 
   /**
    * Upstream URL for redirect-mode agents.
@@ -861,6 +869,8 @@ export interface CallAgentErrorResponse {
   success: false;
   error: string;
   code?: string;
+  hint?: string;
+  details?: Record<string, unknown>;
 }
 
 /** Union of all response types */
@@ -942,5 +952,10 @@ export type ServerSource =
   | string
   | { command: string; args?: string[]; env?: Record<string, string> }
   | { url: string; headers?: Record<string, string> }
-  | { spawn: string; args?: string[]; env?: Record<string, string>; port?: number; endpoint?: string };
-
+  | {
+      spawn: string;
+      args?: string[];
+      env?: Record<string, string>;
+      port?: number;
+      endpoint?: string;
+    };