@slashfi/agents-sdk 0.30.1 → 0.31.0

package/src/types.ts

@@ -259,6 +259,32 @@ export type SecurityScheme =
   | HttpSecurityScheme
   | NoneSecurityScheme;
 
+/**
+ * Lightweight security summary for agent listings.
+ * The full SecurityScheme has all the details; this is the
+ * directory-level overview (e.g., in list_agents responses).
+ */
+export interface SecuritySchemeSummary {
+  type: SecurityScheme['type'];
+  [key: string]: unknown;
+}
+
+/**
+ * A static resource exposed by an agent.
+ * Well-known resources:
+ * - `AUTH.md` — LLM-readable auth/connection setup instructions
+ */
+export interface AgentResource {
+  /** Resource URI (e.g., 'AUTH.md') */
+  uri: string;
+  /** Human-readable name */
+  name?: string;
+  /** MIME type (defaults to text/markdown for .md) */
+  mimeType?: string;
+  /** The resource content (populated on read_resources, omitted on list) */
+  content?: string;
+}
+
 // ============================================
 // Agent Configuration
 // ============================================
@@ -313,6 +339,13 @@ export interface AgentConfig {
    */
   security?: SecurityScheme;
 
+  /**
+   * Agent resources — static files/documents the agent exposes.
+   * Well-known resources:
+   * - `AUTH.md` — LLM-readable auth setup instructions
+   */
+  resources?: AgentResource[];
+
   /** Additional configuration */
   /** Agent refs (paths to other agents this agent can call) */
   refs?: Record<string, { description?: string }>;
@@ -747,6 +780,30 @@ export interface CallAgentCallbackResponse {
   callbackId: string;
 }
 
+/** List resources response */
+export interface CallAgentListResourcesResponse {
+  success: true;
+  agentPath: string;
+  resources: Array<{
+    uri: string;
+    name?: string;
+    mimeType?: string;
+  }>;
+}
+
+/** Read resources response */
+export interface CallAgentReadResourcesResponse {
+  success: true;
+  agentPath: string;
+  resources: Array<{
+    uri: string;
+    name?: string;
+    mimeType?: string;
+    content?: string;
+    error?: string;
+  }>;
+}
+
 /** Error response */
 export interface CallAgentErrorResponse {
   success: false;
@@ -762,4 +819,6 @@ export type CallAgentResponse =
   | CallAgentDescribeToolsResponse
   | CallAgentLoadResponse
   | CallAgentCallbackResponse
+  | CallAgentListResourcesResponse
+  | CallAgentReadResourcesResponse
   | CallAgentErrorResponse;