@slashfi/agents-sdk 0.77.2 → 0.78.0

package/src/define-config.ts

@@ -53,7 +53,7 @@ export type RegistryAuth =
  *   local credentials.
  */
 export interface RegistryProxy {
-  mode: 'required' | 'optional';
+  mode: "required" | "optional";
   /** Agent path to forward to. Defaults to `@config`. */
   agent?: string;
 }
@@ -119,7 +119,7 @@ export interface RegistryEntry {
   publisher?: string;
 
   /** Connection status — set by validation/test, used to filter active entries */
-  status?: 'active' | 'inactive' | 'error';
+  status?: "active" | "inactive" | "error";
 
   /**
    * If set, ref ops for refs sourced from this registry are forwarded
@@ -153,31 +153,57 @@ export type RefConfig = Record<string, unknown>;
 
 /** A ref entry — describes how to connect to an agent */
 export type RefEntry = {
-      /** Canonical agent path on the remote registry (e.g. `notion`, `linear`). */
-      ref: string;
+  /** Canonical agent path on the remote registry (e.g. `notion`, `linear`). */
+  ref: string;
 
-      /**
-       * Local identifier for this ref. Used by all operations
-       * (call/remove/auth/update/…) to look up the entry. Add paths
-       * default this to `ref` when omitted.
-       */
-      name: string;
+  /**
+   * Local identifier for this ref. Used by all operations
+   * (call/remove/auth/update/…) to look up the entry. Add paths
+   * default this to `ref` when omitted.
+   */
+  name: string;
 
-      /** Connection scheme */
-      scheme?: 'mcp' | 'https' | 'registry';
+  /** Connection scheme */
+  scheme?: "mcp" | "https" | "registry";
 
-      /** Direct URL to the agent (e.g. https://mcp.notion.com/mcp) */
-      url?: string;
+  /** Direct URL to the agent (e.g. https://mcp.notion.com/mcp) */
+  url?: string;
 
-      /** Per-instance config (headers, secrets, etc. — values support {{secret-uri}} templates) */
-      config?: RefConfig;
+  /** Per-instance config (headers, secrets, etc. — values support {{secret-uri}} templates) */
+  config?: RefConfig;
 
-      /** The registry where this ref was discovered */
-      sourceRegistry?: { url: string; agentPath: string };
+  /** The registry where this ref was discovered */
+  sourceRegistry?: { url: string; agentPath: string };
 
-      /** Connection status — set by validation/test, used to filter active entries */
-      status?: 'active' | 'inactive' | 'error';
-    };
+  /** Connection status — set by validation/test, used to filter active entries */
+  status?: "active" | "inactive" | "error";
+
+  /**
+   * Human-readable description from the registry.
+   *
+   * Not stored in `consumer-config.json`. Hydrated into the in-memory
+   * `RefEntry` by `ref.list()` / `ref.get()` from `registry-cache.json`,
+   * which the adk maintains as a side-effect of `ref.add()` / `ref.inspect()`.
+   *
+   * `undefined` when the cache has no entry yet (e.g. first session for an
+   * existing user, or a freshly cleared cache). Consumers that need a fallback
+   * should apply their own (commonly `description ?? name`).
+   */
+  description?: string;
+
+  /**
+   * Slim tool summaries from the registry. Populated alongside `description`
+   * by the same cache lifecycle. Tool input schemas are intentionally
+   * omitted — they are too large to cache and callers fetch them on demand
+   * via `ref.inspect(name, { full: true })`.
+   *
+   * `undefined` when the cache has no entry yet.
+   */
+  tools?: Array<{
+    name: string;
+    description?: string;
+  }>;
+};
 
 /** Input accepted by add paths. `name` defaults to `ref` when omitted. */
 export type RefAddInput = Omit<RefEntry, "name"> & { name?: string };

package/src/index.ts

@@ -112,7 +112,12 @@ export {
 
 // Define functions
 export { defineAgent, defineTool } from "./define.js";
-export type { DefineAgentOptions, DefineToolOptions, AgentWithHooks, ToolWithHooks } from "./define.js";
+export type {
+  DefineAgentOptions,
+  DefineToolOptions,
+  AgentWithHooks,
+  ToolWithHooks,
+} from "./define.js";
 
 // Registry
 export { createAgentRegistry, agentFromSerialized } from "./registry.js";
@@ -346,10 +351,7 @@ export {
   exchangeCodeForTokens,
   refreshAccessToken as refreshMcpAccessToken,
 } from "./mcp-client.js";
-export type {
-  OAuthServerMetadata,
-} from "./mcp-client.js";
-
+export type { OAuthServerMetadata } from "./mcp-client.js";
 
 // ============================================
 // Serialized Agent Definitions
@@ -361,10 +363,6 @@ export type {
   SerializedTool,
 } from "./serialized.js";
 
-
-
-
-
 // ============================================
 // call_agent Schema (shared source of truth)
 // ============================================
@@ -405,9 +403,7 @@ export type { ValidationResult } from "./validate.js";
 // BM25 Search
 // ============================================
 
-export {
-  createBM25Index,
-} from "./bm25.js";
+export { createBM25Index } from "./bm25.js";
 
 export type {
   BM25Options,
@@ -438,7 +434,14 @@ export type {
   ResolveCredentials,
   ResolveCredentialsContext,
   RegistryTestResult,
+  RegistryCache,
+  RegistryCacheEntry,
+  RegistryCacheToolSummary,
 } from "./config-store.js";
 export { createLocalFsStore, getLocalEncryptionKey } from "./local-fs.js";
 export { AdkError, getError, getRecentErrors } from "./adk-error.js";
-export { createAdkTools, type AdkToolsHooks, type CreateAdkToolsOptions } from "./adk-tools.js";
+export {
+  createAdkTools,
+  type AdkToolsHooks,
+  type CreateAdkToolsOptions,
+} from "./adk-tools.js";

package/src/ref-naming.test.ts

@@ -10,7 +10,7 @@
 import { describe, expect, test } from "bun:test";
 import { createAdkTools } from "./adk-tools";
 import type { FsStore } from "./agent-definitions/config";
-import { createAdk, createAgentRegistry, defineAgent } from "./index";
+import { createAdk } from "./index";
 import type { ToolContext } from "./types";
 
 function createMemoryFs(): FsStore {
@@ -326,54 +326,6 @@ describe("ref tool — add operation defaults ref to name", () => {
     const raw = await fs.readFile("consumer-config.json");
     expect(raw).toBeNull();
   });
-
-  test("invalid add input returns schema details through registry call", async () => {
-    const fs = createMemoryFs();
-    const adk = createAdk(fs);
-    const refTool = makeRefTool(adk);
-    const registry = createAgentRegistry();
-    registry.register(
-      defineAgent({
-        path: "@config",
-        entrypoint: "Config agent",
-        tools: [refTool],
-        visibility: "public",
-      }),
-    );
-
-    const response = await registry.call({
-      action: "execute_tool",
-      path: "@config",
-      tool: "ref",
-      params: {
-        operation: "add",
-        ref: "google-calendar",
-      },
-    });
-
-    expect(response.success).toBe(false);
-    if (response.success) throw new Error("expected invalid input error");
-    expect(response.code).toBe("TOOL_INPUT_INVALID");
-    expect(response.error).toContain("Invalid ref.add input");
-    expect(response.details?.issues).toEqual(
-      expect.arrayContaining([
-        expect.objectContaining({
-          path: "sourceRegistry",
-        }),
-      ]),
-    );
-    expect(response.details?.schema).toMatchObject({
-      anyOf: expect.any(Array),
-    });
-    expect(response.details?.operationSchema).toMatchObject({
-      type: "object",
-    });
-    expect(response.hint).toContain("details.schema");
-    expect(response.details).not.toHaveProperty("examples");
-    expect(JSON.stringify(response.details?.operationSchema)).toContain(
-      "sourceRegistry",
-    );
-  });
 });
 
 describe("ref tool — auth state hook", () => {

package/src/registry.ts

@@ -5,7 +5,6 @@
  */
 
 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";
@@ -40,33 +39,6 @@ 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
@@ -788,15 +760,10 @@ 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: adkErr?.code ?? "TOOL_EXECUTION_ERROR",
-                ...(adkErr && {
-                  hint: adkErr.hint,
-                  details: adkErr.details,
-                }),
+                code: "TOOL_EXECUTION_ERROR",
               } as CallAgentErrorResponse;
             }
 
@@ -817,16 +784,11 @@ 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: adkErr?.code ?? "TOOL_EXECUTION_ERROR",
-              ...(adkErr && {
-                hint: adkErr.hint,
-                details: adkErr.details,
-              }),
+              code: "TOOL_EXECUTION_ERROR",
             } as CallAgentErrorResponse;
           }
         }

package/src/types.ts

@@ -4,8 +4,8 @@
  * Defines the fundamental types for agent definitions, tools, and contexts.
  */
 
-import type { AgentAction, CallerType } from "./call-agent-schema.js";
 import type { EventCallback, EventType } from "./events.js";
+import type { AgentAction, CallerType } from "./call-agent-schema.js";
 
 /** Internal listener entry stored on agents/tools */
 export interface ListenerEntry {
@@ -22,15 +22,7 @@ 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[];
@@ -301,7 +293,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;
 }
 
@@ -718,7 +710,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.
@@ -869,8 +861,6 @@ export interface CallAgentErrorResponse {
   success: false;
   error: string;
   code?: string;
-  hint?: string;
-  details?: Record<string, unknown>;
 }
 
 /** Union of all response types */
@@ -952,10 +942,5 @@ 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 };
+