@yushaw/sanqian-sdk 0.3.6 → 0.3.8

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,12 @@ 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;
+    /** Called when all session resources are cleared by this app */
+    resourcesCleared: (appName: string) => void;
 }
 type SDKEventName = keyof SDKEvents;
 

package/dist/index.d.mts

@@ -589,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;
@@ -598,8 +628,49 @@ 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;
+    /** Called when all session resources are cleared by this app */
+    resourcesCleared: (appName: 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 (local cache) */
+    getSessionResources(): StoredSessionResource[];
+    /** Fetch session resources from server (optionally filtered by agent) */
+    fetchSessionResources(agentId?: string): Promise<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;
@@ -609,6 +680,7 @@ declare class SanqianSDK {
     private state;
     private toolHandlers;
     private contextProviders;
+    private sessionResources;
     private pendingRequests;
     private heartbeatTimer;
     private reconnectTimer;
@@ -678,6 +750,7 @@ declare class SanqianSDK {
     private handleContextGetCurrent;
     private handleContextGetList;
     private handleContextGetById;
+    private handleResourceRemovedByUser;
     private handleDisconnect;
     /**
      * Check if auto-reconnect should be enabled
@@ -843,6 +916,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
@@ -901,6 +975,88 @@ 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[];
+    /**
+     * Fetch session resources from server
+     *
+     * Unlike getSessionResources() which returns only this app's local cache,
+     * this method fetches session resources from the server.
+     *
+     * @example
+     * ```typescript
+     * // Fetch ALL resources (for backend/debugging)
+     * const allResources = await sdk.fetchSessionResources();
+     *
+     * // Fetch resources filtered by agent (for UI display)
+     * const agentResources = await sdk.fetchSessionResources('assistant');
+     * ```
+     *
+     * @param agentId - Optional agent ID to filter resources by association.
+     *                  - If not provided: returns ALL resources
+     *                  - If provided: returns only resources from apps configured
+     *                    in the agent's attached_contexts
+     * @returns Array of session resources
+     */
+    fetchSessionResources(agentId?: string): Promise<StoredSessionResource[]>;
     /**
      * List available capabilities (tools, skills, agents)
      *
@@ -1173,4 +1329,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

@@ -589,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;
@@ -598,8 +628,49 @@ 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;
+    /** Called when all session resources are cleared by this app */
+    resourcesCleared: (appName: 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 (local cache) */
+    getSessionResources(): StoredSessionResource[];
+    /** Fetch session resources from server (optionally filtered by agent) */
+    fetchSessionResources(agentId?: string): Promise<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;
@@ -609,6 +680,7 @@ declare class SanqianSDK {
     private state;
     private toolHandlers;
     private contextProviders;
+    private sessionResources;
     private pendingRequests;
     private heartbeatTimer;
     private reconnectTimer;
@@ -678,6 +750,7 @@ declare class SanqianSDK {
     private handleContextGetCurrent;
     private handleContextGetList;
     private handleContextGetById;
+    private handleResourceRemovedByUser;
     private handleDisconnect;
     /**
      * Check if auto-reconnect should be enabled
@@ -843,6 +916,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
@@ -901,6 +975,88 @@ 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[];
+    /**
+     * Fetch session resources from server
+     *
+     * Unlike getSessionResources() which returns only this app's local cache,
+     * this method fetches session resources from the server.
+     *
+     * @example
+     * ```typescript
+     * // Fetch ALL resources (for backend/debugging)
+     * const allResources = await sdk.fetchSessionResources();
+     *
+     * // Fetch resources filtered by agent (for UI display)
+     * const agentResources = await sdk.fetchSessionResources('assistant');
+     * ```
+     *
+     * @param agentId - Optional agent ID to filter resources by association.
+     *                  - If not provided: returns ALL resources
+     *                  - If provided: returns only resources from apps configured
+     *                    in the agent's attached_contexts
+     * @returns Array of session resources
+     */
+    fetchSessionResources(agentId?: string): Promise<StoredSessionResource[]>;
     /**
      * List available capabilities (tools, skills, agents)
      *
@@ -1173,4 +1329,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,159 @@ 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.emit("resourcesCleared", this.config.appName);
+    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());
+  }
+  /**
+   * Fetch session resources from server
+   *
+   * Unlike getSessionResources() which returns only this app's local cache,
+   * this method fetches session resources from the server.
+   *
+   * @example
+   * ```typescript
+   * // Fetch ALL resources (for backend/debugging)
+   * const allResources = await sdk.fetchSessionResources();
+   *
+   * // Fetch resources filtered by agent (for UI display)
+   * const agentResources = await sdk.fetchSessionResources('assistant');
+   * ```
+   *
+   * @param agentId - Optional agent ID to filter resources by association.
+   *                  - If not provided: returns ALL resources
+   *                  - If provided: returns only resources from apps configured
+   *                    in the agent's attached_contexts
+   * @returns Array of session resources
+   */
+  async fetchSessionResources(agentId) {
+    await this.ensureReady();
+    let url = `${this.getHttpBaseUrl()}/api/sdk/session-resources`;
+    if (agentId) {
+      const params = new URLSearchParams({ agent_id: agentId });
+      url += `?${params.toString()}`;
+    }
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw createSDKError(
+        "REQUEST_FAILED" /* REQUEST_FAILED */,
+        `Failed to fetch session resources: ${response.statusText}`
+      );
+    }
+    return response.json();
+  }
+  // ============================================
   // Capability Discovery API
   // ============================================
   /**