@slashfi/agents-sdk 0.36.4 → 0.37.0

package/src/server.ts

@@ -488,7 +488,7 @@ function getToolDefinitions(schemas?: AgentServerOptions["schemas"]) {
     {
       name: "call_agent",
       description:
-        "Execute a tool on a registered agent. Provide the agent path and tool name.\n\nSupported actions:\n- invoke: Fire-and-forget agent invocation\n- ask: Invoke and wait for response\n- execute_tool: Call a specific tool on an agent\n- describe_tools: Get tool schemas for an agent\n- load: Get agent definition/system prompt\n- list_resources: List all resources available on an agent (docs, auth instructions, config schemas, etc.)\n- read_resources: Fetch one or more resources by URI",
+        "Execute a tool on a registered agent. Provide the agent path and tool name.\n\nSupported actions:\n- invoke: Fire-and-forget agent invocation\n- ask: Invoke and wait for response\n- execute_tool: Call a specific tool on an agent\n- describe_tools: Get tool schemas for an agent (slim by default; use full: true for complete schemas)\n- load: Get agent definition/system prompt\n- list_resources: List all resources available on an agent (docs, auth instructions, config schemas, etc.)\n- read_resources: Fetch one or more resources by URI",
       inputSchema: schemas?.callAgent
         ? zodToOpenAiJsonSchema(schemas.callAgent)
         : callAgentInputSchema,

package/src/types.ts

@@ -646,6 +646,17 @@ export interface ToolSchema {
   outputSchema?: JsonSchema;
 }
 
+/**
+ * Slim tool summary for describe_tools when full=false (default).
+ * Omits verbose inputSchema/outputSchema to save context tokens.
+ */
+export interface ToolSchemaSummary {
+  name: string;
+  description: string;
+  /** Estimated token count if full schema were returned for this tool */
+  fullTokens: number;
+}
+
 // ============================================
 // Agent Definition
 // ============================================
@@ -749,13 +760,18 @@ export interface CallAgentExecuteToolResponse {
 /** Success response for describe_tools */
 export interface CallAgentDescribeToolsResponse {
   success: true;
-  tools: ToolSchema[];
+  /** Full tool schemas (when full=true) */
+  tools?: ToolSchema[];
+  /** Slim tool summaries (when full=false/omitted) */
+  toolSummaries?: ToolSchemaSummary[];
   /** Agent description */
   description?: string;
   /** Security scheme (if any) */
   security?: SecuritySchemeSummary;
   /** Available resources (e.g., AUTH.md) */
   resources?: Array<{ uri: string; name?: string; mimeType?: string }>;
+  /** Human-readable hint about full mode */
+  context?: string;
 }
 
 /** A resolved agent ref with its discovered tools */