@slashfi/agents-sdk 0.36.3 → 0.37.0

package/src/registry.ts

@@ -24,6 +24,7 @@ import type {
   ToolContext,
   ToolDefinition,
   ToolSchema,
+  ToolSchemaSummary,
   Visibility,
 } from "./types.js";
 import { assertValidDefinition } from "./validate.js";
@@ -37,6 +38,21 @@ const DEFAULT_SUPPORTED_ACTIONS: AgentAction[] = [
   "read_resources",
 ];
 
+/**
+ * Estimate the token count for a tool schema when serialized to JSON.
+ * Uses a rough heuristic: ~4 characters per token (conservative estimate
+ * that accounts for JSON structure, property names, and schema verbosity).
+ */
+function estimateToolTokens(tool: ToolSchema): number {
+  const json = JSON.stringify({
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema,
+    ...(tool.outputSchema && { outputSchema: tool.outputSchema }),
+  });
+  return Math.ceil(json.length / 4);
+}
+
 // ============================================
 // Agent Registry Interface
 // ============================================
@@ -601,7 +617,10 @@ export function createAgentRegistry(
   return registryObj;
 
   async function callInternal(request: CallAgentRequest): Promise<CallAgentResponse> {
-      const agent = agents.get(request.path);
+      // Normalize path: try exact, then with @, then without @
+      const agent = agents.get(request.path)
+        ?? agents.get(`@${request.path}`)
+        ?? agents.get(request.path.replace(/^@/, ""));
 
       if (!agent) {
         return {
@@ -791,17 +810,45 @@ export function createAgentRegistry(
               ...(t.outputSchema && { outputSchema: t.outputSchema }),
             }));
 
+          // Full mode: return complete schemas (backward-compatible)
+          if (request.full) {
+            return {
+              success: true,
+              tools: toolSchemas,
+              description: agent.config?.description,
+              security: agent.config?.security,
+              resources: agent.config?.resources?.map((r) => ({
+                uri: r.uri,
+                name: r.name,
+                mimeType: r.mimeType,
+                content: r.content,
+              })),
+            } as CallAgentDescribeToolsResponse;
+          }
+
+          // Slim mode (default): summaries with token estimates
+          const toolSummaries: ToolSchemaSummary[] = toolSchemas.map((t) => ({
+            name: t.name,
+            description: t.description,
+            fullTokens: estimateToolTokens(t),
+          }));
+
+          const totalFullTokens = toolSummaries.reduce(
+            (sum, t) => sum + t.fullTokens,
+            0,
+          );
+
           return {
             success: true,
-            tools: toolSchemas,
+            toolSummaries,
             description: agent.config?.description,
             security: agent.config?.security,
             resources: agent.config?.resources?.map((r) => ({
               uri: r.uri,
               name: r.name,
               mimeType: r.mimeType,
-              content: r.content,
             })),
+            context: `Use full: true to get complete tool schemas (~${(totalFullTokens / 1000).toFixed(1)}k tokens total)`,
           } as CallAgentDescribeToolsResponse;
         }
 

package/src/server.ts

@@ -26,6 +26,7 @@
  */
 
 import type { AuthStore } from "./agent-definitions/auth.js";
+import type { Visibility } from "./types.js";
 import {
   type SecretStore,
   processSecretParams,
@@ -487,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,
@@ -697,7 +698,7 @@ export function createAgentServer(
                   agent.config?.name ?? "",
                   agent.config?.description ?? "",
                   ...agent.tools
-                    .filter((t) => canSeeTool(t, auth))
+                    .filter((t) => canSeeTool(t, auth, (agent.visibility ?? agent.config?.visibility ?? 'internal') as Visibility))
                     .map((t) => `${t.name} ${t.description}`),
                 ].join(" "),
               }));
@@ -764,7 +765,7 @@ export function createAgentServer(
                   mimeType: r.mimeType,
                 })),
                 tools: agent.tools
-                  .filter((t) => canSeeTool(t, auth))
+                  .filter((t) => canSeeTool(t, auth, (agent.visibility ?? agent.config?.visibility ?? 'internal') as Visibility))
                   .map((t) => t.name),
               })),
             };

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 */