@yushaw/sanqian-sdk 0.3.5 → 0.3.7

package/dist/index.browser.d.mts

@@ -455,6 +455,36 @@ interface AgentUpdateConfig {
      */
     searchable?: boolean;
 }
+/**
+ * Session resource pushed by an app.
+ * Content is provided at push time (not fetched like attached_resources).
+ * Global scope - visible in all Chat UI instances, persists until app disconnects.
+ */
+interface SessionResource {
+    /** Resource ID (auto-generated if not provided) */
+    id?: string;
+    /** Display title (required) */
+    title: string;
+    /** Content (required, format controlled by app) */
+    content: string;
+    /** Optional summary for UI tooltip */
+    summary?: string;
+    /** Optional icon (emoji or URL) */
+    icon?: string;
+    /** Optional resource type for styling */
+    type?: ResourceType;
+}
+/**
+ * Stored session resource with full metadata
+ */
+interface StoredSessionResource extends SessionResource {
+    /** Full ID: "appName:resourceId" */
+    fullId: string;
+    /** Source app name */
+    appName: string;
+    /** Push timestamp (ISO 8601) */
+    pushedAt: string;
+}
 interface SDKEvents {
     connected: () => void;
     disconnected: (reason: string) => void;
@@ -464,6 +494,10 @@ interface SDKEvents {
         name: string;
         arguments: Record<string, unknown>;
     }) => void;
+    /** Called when a session resource is pushed or updated */
+    resourcePushed: (resource: StoredSessionResource) => void;
+    /** Called when user removes a session resource from Chat UI */
+    resourceRemoved: (resourceId: string) => void;
 }
 type SDKEventName = keyof SDKEvents;
 

package/dist/index.d.mts

@@ -575,6 +575,10 @@ interface ListCapabilitiesOptions {
     source?: string;
     /** Filter by category (tools only) */
     category?: string;
+    /** SDK app name (for including own private agents) */
+    appName?: string;
+    /** Agent scope filter: "searchable" (default) or "available" (includes non-searchable but enabled agents) */
+    scope?: "searchable" | "available";
 }
 /** Options for searching capabilities */
 interface SearchCapabilitiesOptions {
@@ -585,6 +589,36 @@ interface SearchCapabilitiesOptions {
     /** Exclude these IDs */
     exclude?: string[];
 }
+/**
+ * Session resource pushed by an app.
+ * Content is provided at push time (not fetched like attached_resources).
+ * Global scope - visible in all Chat UI instances, persists until app disconnects.
+ */
+interface SessionResource {
+    /** Resource ID (auto-generated if not provided) */
+    id?: string;
+    /** Display title (required) */
+    title: string;
+    /** Content (required, format controlled by app) */
+    content: string;
+    /** Optional summary for UI tooltip */
+    summary?: string;
+    /** Optional icon (emoji or URL) */
+    icon?: string;
+    /** Optional resource type for styling */
+    type?: ResourceType;
+}
+/**
+ * Stored session resource with full metadata
+ */
+interface StoredSessionResource extends SessionResource {
+    /** Full ID: "appName:resourceId" */
+    fullId: string;
+    /** Source app name */
+    appName: string;
+    /** Push timestamp (ISO 8601) */
+    pushedAt: string;
+}
 interface SDKEvents {
     connected: () => void;
     disconnected: (reason: string) => void;
@@ -594,8 +628,45 @@ interface SDKEvents {
         name: string;
         arguments: Record<string, unknown>;
     }) => void;
+    /** Called when a session resource is pushed or updated */
+    resourcePushed: (resource: StoredSessionResource) => void;
+    /** Called when user removes a session resource from Chat UI */
+    resourceRemoved: (resourceId: string) => void;
 }
 type SDKEventName = keyof SDKEvents;
+/**
+ * Extended SDK methods available on SanqianSDK instance.
+ * Use this interface when you need type-safe access to these methods
+ * without type assertions.
+ */
+interface SDKExtendedMethods {
+    /** Get all session resources pushed by this app */
+    getSessionResources(): StoredSessionResource[];
+    /** Cancel an in-flight chat run */
+    cancelRun(runId: string): void;
+    /** Remove a session resource */
+    removeSessionResource(resourceId: string): Promise<void>;
+    /** Get messages from a conversation */
+    getMessages?(conversationId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        messages?: Array<{
+            id?: string;
+            role: string;
+            content: string;
+            thinking?: string | null;
+            tool_calls?: ToolCall[] | null;
+            created_at?: string;
+            file_paths?: string[];
+        }>;
+        has_more?: boolean;
+    }>;
+    /** Subscribe to events */
+    on<T extends SDKEventName>(event: T, listener: SDKEvents[T]): void;
+    /** Unsubscribe from events */
+    off<T extends SDKEventName>(event: T, listener: SDKEvents[T]): void;
+}
 
 declare class SanqianSDK {
     private config;
@@ -605,6 +676,7 @@ declare class SanqianSDK {
     private state;
     private toolHandlers;
     private contextProviders;
+    private sessionResources;
     private pendingRequests;
     private heartbeatTimer;
     private reconnectTimer;
@@ -674,6 +746,7 @@ declare class SanqianSDK {
     private handleContextGetCurrent;
     private handleContextGetList;
     private handleContextGetById;
+    private handleResourceRemovedByUser;
     private handleDisconnect;
     /**
      * Check if auto-reconnect should be enabled
@@ -839,6 +912,7 @@ declare class SanqianSDK {
         persistHistory?: boolean;
         attachedContexts?: string[];
         attachedResources?: string[];
+        sessionResources?: string[];
     }): AsyncGenerator<ChatStreamEvent>;
     /**
      * Send HITL (Human-in-the-Loop) response to resume after interrupt
@@ -897,6 +971,66 @@ declare class SanqianSDK {
      * @returns Embedding configuration or { available: false } if not configured
      */
     getEmbeddingConfig(): Promise<EmbeddingConfigResult>;
+    /**
+     * Push a session resource to Sanqian
+     *
+     * Session resources are temporary context pushed by the app, visible in all Chat UI instances.
+     * They persist until the app disconnects or explicitly removes them.
+     *
+     * @example
+     * ```typescript
+     * const stored = await sdk.pushResource({
+     *   title: 'Current Note',
+     *   content: '<note>\n# My Note\nContent here...\n</note>',
+     *   summary: 'My Note - 2024-01-15',
+     *   icon: '📝',
+     *   type: 'note',
+     * });
+     * console.log(`Pushed: ${stored.fullId}`); // "my-app:abc123"
+     * ```
+     *
+     * @param resource - Resource to push
+     * @returns Stored resource with full ID and metadata
+     */
+    pushResource(resource: SessionResource): Promise<StoredSessionResource>;
+    /**
+     * Remove a session resource
+     *
+     * @example
+     * ```typescript
+     * await sdk.removeResource('my-app:abc123');
+     * ```
+     *
+     * @param resourceId - Full resource ID (appName:resourceId)
+     */
+    removeResource(resourceId: string): Promise<void>;
+    /**
+     * Clear all session resources pushed by this app
+     *
+     * @example
+     * ```typescript
+     * await sdk.clearResources();
+     * ```
+     */
+    clearResources(): Promise<void>;
+    /**
+     * Get all session resources pushed by this app
+     *
+     * Returns the local cache of resources pushed by this SDK instance.
+     * Does NOT fetch from server - use this for quick local state access.
+     *
+     * @example
+     * ```typescript
+     * const resources = sdk.getSessionResources();
+     * console.log(`Active resources: ${resources.length}`);
+     * for (const r of resources) {
+     *   console.log(`- ${r.fullId}: ${r.title}`);
+     * }
+     * ```
+     *
+     * @returns Array of stored session resources
+     */
+    getSessionResources(): StoredSessionResource[];
     /**
      * List available capabilities (tools, skills, agents)
      *
@@ -951,7 +1085,8 @@ declare class SanqianSDK {
      * List all available agents (not just own agents)
      *
      * Unlike listAgents() which returns only this app's private agents,
-     * this method returns all discoverable agents in the system.
+     * this method returns all enabled agents in the system,
+     * including non-searchable ones and this app's own private agents.
      *
      * @example
      * ```typescript
@@ -1168,4 +1303,4 @@ declare class SanqianSDKError extends Error {
  */
 declare function createSDKError(code: SDKErrorCode, details?: string): SanqianSDKError;
 
-export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, type ContextCapability, type ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationHistoryResult, type ConversationInfo, type ConversationMessage, DiscoveryManager, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type RemoteToolDefinition, type ResourceListOptions, type ResourceListResult, type ResourceType, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SkillCapability, type ToolCall, type ToolCapability, type ToolDefinition, createSDKError };
+export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, type ContextCapability, type ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationHistoryResult, type ConversationInfo, type ConversationMessage, DiscoveryManager, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type RemoteToolDefinition, type ResourceListOptions, type ResourceListResult, type ResourceType, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, type SDKExtendedMethods, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, createSDKError };

package/dist/index.d.ts

@@ -575,6 +575,10 @@ interface ListCapabilitiesOptions {
     source?: string;
     /** Filter by category (tools only) */
     category?: string;
+    /** SDK app name (for including own private agents) */
+    appName?: string;
+    /** Agent scope filter: "searchable" (default) or "available" (includes non-searchable but enabled agents) */
+    scope?: "searchable" | "available";
 }
 /** Options for searching capabilities */
 interface SearchCapabilitiesOptions {
@@ -585,6 +589,36 @@ interface SearchCapabilitiesOptions {
     /** Exclude these IDs */
     exclude?: string[];
 }
+/**
+ * Session resource pushed by an app.
+ * Content is provided at push time (not fetched like attached_resources).
+ * Global scope - visible in all Chat UI instances, persists until app disconnects.
+ */
+interface SessionResource {
+    /** Resource ID (auto-generated if not provided) */
+    id?: string;
+    /** Display title (required) */
+    title: string;
+    /** Content (required, format controlled by app) */
+    content: string;
+    /** Optional summary for UI tooltip */
+    summary?: string;
+    /** Optional icon (emoji or URL) */
+    icon?: string;
+    /** Optional resource type for styling */
+    type?: ResourceType;
+}
+/**
+ * Stored session resource with full metadata
+ */
+interface StoredSessionResource extends SessionResource {
+    /** Full ID: "appName:resourceId" */
+    fullId: string;
+    /** Source app name */
+    appName: string;
+    /** Push timestamp (ISO 8601) */
+    pushedAt: string;
+}
 interface SDKEvents {
     connected: () => void;
     disconnected: (reason: string) => void;
@@ -594,8 +628,45 @@ interface SDKEvents {
         name: string;
         arguments: Record<string, unknown>;
     }) => void;
+    /** Called when a session resource is pushed or updated */
+    resourcePushed: (resource: StoredSessionResource) => void;
+    /** Called when user removes a session resource from Chat UI */
+    resourceRemoved: (resourceId: string) => void;
 }
 type SDKEventName = keyof SDKEvents;
+/**
+ * Extended SDK methods available on SanqianSDK instance.
+ * Use this interface when you need type-safe access to these methods
+ * without type assertions.
+ */
+interface SDKExtendedMethods {
+    /** Get all session resources pushed by this app */
+    getSessionResources(): StoredSessionResource[];
+    /** Cancel an in-flight chat run */
+    cancelRun(runId: string): void;
+    /** Remove a session resource */
+    removeSessionResource(resourceId: string): Promise<void>;
+    /** Get messages from a conversation */
+    getMessages?(conversationId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        messages?: Array<{
+            id?: string;
+            role: string;
+            content: string;
+            thinking?: string | null;
+            tool_calls?: ToolCall[] | null;
+            created_at?: string;
+            file_paths?: string[];
+        }>;
+        has_more?: boolean;
+    }>;
+    /** Subscribe to events */
+    on<T extends SDKEventName>(event: T, listener: SDKEvents[T]): void;
+    /** Unsubscribe from events */
+    off<T extends SDKEventName>(event: T, listener: SDKEvents[T]): void;
+}
 
 declare class SanqianSDK {
     private config;
@@ -605,6 +676,7 @@ declare class SanqianSDK {
     private state;
     private toolHandlers;
     private contextProviders;
+    private sessionResources;
     private pendingRequests;
     private heartbeatTimer;
     private reconnectTimer;
@@ -674,6 +746,7 @@ declare class SanqianSDK {
     private handleContextGetCurrent;
     private handleContextGetList;
     private handleContextGetById;
+    private handleResourceRemovedByUser;
     private handleDisconnect;
     /**
      * Check if auto-reconnect should be enabled
@@ -839,6 +912,7 @@ declare class SanqianSDK {
         persistHistory?: boolean;
         attachedContexts?: string[];
         attachedResources?: string[];
+        sessionResources?: string[];
     }): AsyncGenerator<ChatStreamEvent>;
     /**
      * Send HITL (Human-in-the-Loop) response to resume after interrupt
@@ -897,6 +971,66 @@ declare class SanqianSDK {
      * @returns Embedding configuration or { available: false } if not configured
      */
     getEmbeddingConfig(): Promise<EmbeddingConfigResult>;
+    /**
+     * Push a session resource to Sanqian
+     *
+     * Session resources are temporary context pushed by the app, visible in all Chat UI instances.
+     * They persist until the app disconnects or explicitly removes them.
+     *
+     * @example
+     * ```typescript
+     * const stored = await sdk.pushResource({
+     *   title: 'Current Note',
+     *   content: '<note>\n# My Note\nContent here...\n</note>',
+     *   summary: 'My Note - 2024-01-15',
+     *   icon: '📝',
+     *   type: 'note',
+     * });
+     * console.log(`Pushed: ${stored.fullId}`); // "my-app:abc123"
+     * ```
+     *
+     * @param resource - Resource to push
+     * @returns Stored resource with full ID and metadata
+     */
+    pushResource(resource: SessionResource): Promise<StoredSessionResource>;
+    /**
+     * Remove a session resource
+     *
+     * @example
+     * ```typescript
+     * await sdk.removeResource('my-app:abc123');
+     * ```
+     *
+     * @param resourceId - Full resource ID (appName:resourceId)
+     */
+    removeResource(resourceId: string): Promise<void>;
+    /**
+     * Clear all session resources pushed by this app
+     *
+     * @example
+     * ```typescript
+     * await sdk.clearResources();
+     * ```
+     */
+    clearResources(): Promise<void>;
+    /**
+     * Get all session resources pushed by this app
+     *
+     * Returns the local cache of resources pushed by this SDK instance.
+     * Does NOT fetch from server - use this for quick local state access.
+     *
+     * @example
+     * ```typescript
+     * const resources = sdk.getSessionResources();
+     * console.log(`Active resources: ${resources.length}`);
+     * for (const r of resources) {
+     *   console.log(`- ${r.fullId}: ${r.title}`);
+     * }
+     * ```
+     *
+     * @returns Array of stored session resources
+     */
+    getSessionResources(): StoredSessionResource[];
     /**
      * List available capabilities (tools, skills, agents)
      *
@@ -951,7 +1085,8 @@ declare class SanqianSDK {
      * List all available agents (not just own agents)
      *
      * Unlike listAgents() which returns only this app's private agents,
-     * this method returns all discoverable agents in the system.
+     * this method returns all enabled agents in the system,
+     * including non-searchable ones and this app's own private agents.
      *
      * @example
      * ```typescript
@@ -1168,4 +1303,4 @@ declare class SanqianSDKError extends Error {
  */
 declare function createSDKError(code: SDKErrorCode, details?: string): SanqianSDKError;
 
-export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, type ContextCapability, type ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationHistoryResult, type ConversationInfo, type ConversationMessage, DiscoveryManager, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type RemoteToolDefinition, type ResourceListOptions, type ResourceListResult, type ResourceType, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SkillCapability, type ToolCall, type ToolCapability, type ToolDefinition, createSDKError };
+export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, type ContextCapability, type ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationHistoryResult, type ConversationInfo, type ConversationMessage, DiscoveryManager, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type RemoteToolDefinition, type ResourceListOptions, type ResourceListResult, type ResourceType, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, type SDKExtendedMethods, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, createSDKError };

package/dist/index.js

@@ -515,6 +515,8 @@ var SanqianSDK = class _SanqianSDK {
   toolHandlers = /* @__PURE__ */ new Map();
   // Context providers by id
   contextProviders = /* @__PURE__ */ new Map();
+  // Session resources pushed by this app (local cache)
+  sessionResources = /* @__PURE__ */ new Map();
   // Pending request futures
   pendingRequests = /* @__PURE__ */ new Map();
   // Timers
@@ -716,6 +718,7 @@ var SanqianSDK = class _SanqianSDK {
       this.ws.close(1e3, "Client disconnect");
       this.ws = null;
     }
+    this.sessionResources.clear();
     this.state = {
       connected: false,
       registering: false,
@@ -803,6 +806,9 @@ var SanqianSDK = class _SanqianSDK {
       case "context_get_by_id":
         this.handleContextGetById(message);
         break;
+      case "resource_removed_by_user":
+        this.handleResourceRemovedByUser(message);
+        break;
       default:
         this.warn(`Unknown message type: ${type}`);
     }
@@ -1055,6 +1061,15 @@ var SanqianSDK = class _SanqianSDK {
     }
   }
   // ============================================
+  // Session Resource Handlers
+  // ============================================
+  handleResourceRemovedByUser(message) {
+    const { resourceId } = message;
+    this.log(`Resource removed by user: ${resourceId}`);
+    this.sessionResources.delete(resourceId);
+    this.emit("resourceRemoved", resourceId);
+  }
+  // ============================================
   // Connection Management
   // ============================================
   handleDisconnect(reason) {
@@ -1602,6 +1617,7 @@ var SanqianSDK = class _SanqianSDK {
       auto_discover_subagents: options?.autoDiscoverSubagents ?? false,
       attached_contexts: options?.attachedContexts,
       attached_resources: options?.attachedResources,
+      session_resources: options?.sessionResources,
       remote_tools: options?.remoteTools?.map((t) => ({
         name: t.name,
         description: t.description,
@@ -1754,6 +1770,121 @@ var SanqianSDK = class _SanqianSDK {
     return response.config || { available: false };
   }
   // ============================================
+  // Session Resources API
+  // ============================================
+  /**
+   * Push a session resource to Sanqian
+   *
+   * Session resources are temporary context pushed by the app, visible in all Chat UI instances.
+   * They persist until the app disconnects or explicitly removes them.
+   *
+   * @example
+   * ```typescript
+   * const stored = await sdk.pushResource({
+   *   title: 'Current Note',
+   *   content: '<note>\n# My Note\nContent here...\n</note>',
+   *   summary: 'My Note - 2024-01-15',
+   *   icon: '📝',
+   *   type: 'note',
+   * });
+   * console.log(`Pushed: ${stored.fullId}`); // "my-app:abc123"
+   * ```
+   *
+   * @param resource - Resource to push
+   * @returns Stored resource with full ID and metadata
+   */
+  async pushResource(resource) {
+    await this.ensureReady();
+    const msgId = this.generateId();
+    const message = {
+      id: msgId,
+      type: "resource_push",
+      resource
+    };
+    const response = await this.sendAndWait(message, msgId, 1e4);
+    if (!response.success || !response.resourceId) {
+      throw createSDKError("REQUEST_FAILED" /* REQUEST_FAILED */, response.error || "Failed to push resource");
+    }
+    const stored = {
+      ...resource,
+      fullId: response.resourceId,
+      appName: this.config.appName,
+      pushedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.sessionResources.set(stored.fullId, stored);
+    this.emit("resourcePushed", stored);
+    this.log(`Pushed resource: ${stored.fullId}`);
+    return stored;
+  }
+  /**
+   * Remove a session resource
+   *
+   * @example
+   * ```typescript
+   * await sdk.removeResource('my-app:abc123');
+   * ```
+   *
+   * @param resourceId - Full resource ID (appName:resourceId)
+   */
+  async removeResource(resourceId) {
+    await this.ensureReady();
+    const msgId = this.generateId();
+    const message = {
+      id: msgId,
+      type: "resource_remove",
+      resourceId
+    };
+    const response = await this.sendAndWait(message, msgId, 1e4);
+    if (!response.success) {
+      throw createSDKError("REQUEST_FAILED" /* REQUEST_FAILED */, response.error || "Failed to remove resource");
+    }
+    this.sessionResources.delete(resourceId);
+    this.emit("resourceRemoved", resourceId);
+    this.log(`Removed resource: ${resourceId}`);
+  }
+  /**
+   * Clear all session resources pushed by this app
+   *
+   * @example
+   * ```typescript
+   * await sdk.clearResources();
+   * ```
+   */
+  async clearResources() {
+    await this.ensureReady();
+    const msgId = this.generateId();
+    const message = {
+      id: msgId,
+      type: "resource_clear"
+    };
+    const response = await this.sendAndWait(message, msgId, 1e4);
+    if (!response.success) {
+      throw createSDKError("REQUEST_FAILED" /* REQUEST_FAILED */, response.error || "Failed to clear resources");
+    }
+    this.sessionResources.clear();
+    this.log("Cleared all resources");
+  }
+  /**
+   * Get all session resources pushed by this app
+   *
+   * Returns the local cache of resources pushed by this SDK instance.
+   * Does NOT fetch from server - use this for quick local state access.
+   *
+   * @example
+   * ```typescript
+   * const resources = sdk.getSessionResources();
+   * console.log(`Active resources: ${resources.length}`);
+   * for (const r of resources) {
+   *   console.log(`- ${r.fullId}: ${r.title}`);
+   * }
+   * ```
+   *
+   * @returns Array of stored session resources
+   */
+  getSessionResources() {
+    return Array.from(this.sessionResources.values());
+  }
+  // ============================================
   // Capability Discovery API
   // ============================================
   /**
@@ -1783,6 +1914,12 @@ var SanqianSDK = class _SanqianSDK {
     if (options?.category) {
       params.append("category", options.category);
     }
+    if (options?.appName) {
+      params.append("appName", options.appName);
+    }
+    if (options?.scope) {
+      params.append("scope", options.scope);
+    }
     const url = `${this.getHttpBaseUrl()}/api/capabilities?${params.toString()}`;
     const response = await fetch(url);
     if (!response.ok) {
@@ -1855,7 +1992,8 @@ var SanqianSDK = class _SanqianSDK {
    * List all available agents (not just own agents)
    *
    * Unlike listAgents() which returns only this app's private agents,
-   * this method returns all discoverable agents in the system.
+   * this method returns all enabled agents in the system,
+   * including non-searchable ones and this app's own private agents.
    *
    * @example
    * ```typescript
@@ -1864,7 +2002,11 @@ var SanqianSDK = class _SanqianSDK {
    * ```
    */
   async listAvailableAgents() {
-    const caps = await this.listCapabilities({ type: "agent" });
+    const caps = await this.listCapabilities({
+      type: "agent",
+      appName: this.config.appName,
+      scope: "available"
+    });
     return caps;
   }
   // ============================================