@distri/core 0.2.8 → 0.3.0

package/dist/index.d.mts

@@ -143,6 +143,14 @@ interface BrowserScreenshotEvent {
         timestamp_ms?: number;
     };
 }
+interface BrowserSessionStartedEvent {
+    type: 'browser_session_started';
+    data: {
+        session_id: string;
+        viewer_url?: string;
+        stream_url?: string;
+    };
+}
 interface InlineHookRequestedEvent {
     type: 'inline_hook_requested';
     data: {
@@ -161,7 +169,7 @@ interface InlineHookRequestedEvent {
         result?: any;
     };
 }
-type DistriEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | PlanStartedEvent | PlanFinishedEvent | PlanPrunedEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ToolExecutionStartEvent | ToolExecutionEndEvent | ToolRejectedEvent | StepStartedEvent | StepCompletedEvent | AgentHandoverEvent | FeedbackReceivedEvent | ToolCallsEvent | ToolResultsEvent | BrowserScreenshotEvent | InlineHookRequestedEvent;
+type DistriEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | PlanStartedEvent | PlanFinishedEvent | PlanPrunedEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ToolExecutionStartEvent | ToolExecutionEndEvent | ToolRejectedEvent | StepStartedEvent | StepCompletedEvent | AgentHandoverEvent | FeedbackReceivedEvent | ToolCallsEvent | ToolResultsEvent | BrowserScreenshotEvent | BrowserSessionStartedEvent | InlineHookRequestedEvent;
 
 type ChatCompletionRole = 'system' | 'user' | 'assistant' | 'tool';
 interface ChatCompletionMessage {
@@ -335,6 +343,12 @@ declare class DistriClient {
      * Get specific agent by ID
      */
     getAgent(agentId: string): Promise<AgentConfigWithTools>;
+    /**
+     * Update an agent's definition (markdown only)
+     */
+    updateAgent(agentId: string, update: {
+        markdown: string;
+    }): Promise<AgentConfigWithTools>;
     /**
      * Get or create A2AClient for an agent
      */
@@ -356,9 +370,18 @@ declare class DistriClient {
      */
     cancelTask(agentId: string, taskId: string): Promise<void>;
     /**
-     * Get threads from Distri server
+     * Get threads from Distri server with filtering and pagination
+     */
+    getThreads(params?: ThreadListParams): Promise<ThreadListResponse>;
+    /**
+     * Get agents sorted by thread count (most active first)
      */
-    getThreads(): Promise<DistriThread[]>;
+    getAgentsByUsage(): Promise<AgentUsageInfo[]>;
+    /**
+     * Create a new browser session
+     * Returns session info including viewer_url and stream_url from browsr
+     */
+    createBrowserSession(): Promise<BrowserSession>;
     getThread(threadId: string): Promise<DistriThread>;
     /**
      * Get thread messages
@@ -816,6 +839,16 @@ interface AgentDefinition {
     context_size?: number;
     tools?: DistriBaseTool[];
     browser_config?: BrowserAgentConfig;
+    /** Agent usage statistics */
+    stats?: AgentStats;
+}
+/**
+ * Agent usage statistics
+ */
+interface AgentStats {
+    thread_count: number;
+    sub_agent_usage_count: number;
+    last_used_at?: string | null;
 }
 interface BrowserAgentConfig {
     enabled?: boolean;
@@ -876,6 +909,9 @@ interface DistriThread {
     updated_at: string;
     message_count: number;
     last_message?: string;
+    user_id?: string;
+    external_id?: string;
+    tags?: string[];
 }
 interface Thread {
     id: string;
@@ -885,6 +921,49 @@ interface Thread {
     updated_at: string;
     message_count: number;
     last_message?: string;
+    user_id?: string;
+    external_id?: string;
+    tags?: string[];
+}
+/**
+ * Parameters for listing threads with filtering and pagination
+ */
+interface ThreadListParams {
+    agent_id?: string;
+    external_id?: string;
+    search?: string;
+    from_date?: string;
+    to_date?: string;
+    tags?: string[];
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Paginated response for thread listing
+ */
+interface ThreadListResponse {
+    threads: DistriThread[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+/**
+ * Agent usage information for sorting agents by thread count
+ */
+interface AgentUsageInfo {
+    agent_id: string;
+    agent_name: string;
+    thread_count: number;
+}
+/**
+ * Browser session info returned when creating a session
+ */
+interface BrowserSession {
+    session_id: string;
+    /** SSE stream URL (backend API) for event streaming */
+    sse_url?: string;
+    /** Frame URL for embedding (frontend app with token) */
+    frame_url?: string;
 }
 interface ChatProps {
     thread: Thread;
@@ -1078,4 +1157,4 @@ declare function extractToolCallsFromDistriMessage(message: DistriMessage): any[
  */
 declare function extractToolResultsFromDistriMessage(message: DistriMessage): any[];
 
-export { A2AProtocolError, type A2AStreamEventData, type ActionPlanStep, Agent, type AgentConfigWithTools, type AgentDefinition, type AgentHandoverEvent, ApiError, type AssistantWithToolCalls, type BasePlanStep, type BatchToolCallsStep, type BrowserAgentConfig, type BrowserScreenshotEvent, type ChatCompletionChoice, type ChatCompletionMessage, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseFormat, type ChatCompletionRole, type ChatProps, type CodePlanStep, type ConfigurationMeta, type ConfigurationResponse, ConnectionError, type ConnectionStatus, DEFAULT_BASE_URL, type DataPart, type DistriBaseTool, type DistriBrowserRuntimeConfig, type DistriChatMessage, DistriClient, type DistriClientConfig, type DistriConfiguration, DistriError, type DistriEvent, type DistriFnTool, type DistriMessage, type DistriPart, type DistriPlan, type DistriStreamEvent, type DistriThread, type ExternalMcpServer, ExternalToolValidationError, type ExternalToolValidationResult, type FeedbackReceivedEvent, type FileBytes, type FileType, type FileUrl, type FinalResultPlanStep, type HookContext, type HookHandler, type HookMutation, type ImagePart, type InlineHookEventData, type InlineHookRequest, type InlineHookRequestedEvent, type InvokeConfig, type InvokeContext, type InvokeResult, type LLMResponse, type LlmExecuteOptions, type LlmPlanStep, type McpDefinition, type McpServerType, type MessageRole, type ModelProviderConfig, type ModelProviderName, type ModelSettings, type PlanAction, type PlanFinishedEvent, type PlanPrunedEvent, type PlanStartedEvent, type PlanStep, type ReactStep, type Role, type RunErrorEvent, type RunFinishedEvent, type RunStartedEvent, type ServerConfig, type SpeechToTextConfig, type StepCompletedEvent, type StepStartedEvent, type StreamingTranscriptionOptions, type TextMessageContentEvent, type TextMessageEndEvent, type TextMessageStartEvent, type TextPart, type ThoughtPlanStep, type ThoughtStep, type Thread, type ToolCall, type ToolCallPart, type ToolCallsEvent, type ToolDefinition, type ToolExecutionEndEvent, type ToolExecutionOptions, type ToolExecutionStartEvent, type ToolHandler, type ToolRejectedEvent, type ToolResult, type ToolResultData, type ToolResultRefPart, type ToolResults, type ToolResultsEvent, type UseToolsOptions, convertA2AMessageToDistri, convertA2APartToDistri, convertA2AStatusUpdateToDistri, convertDistriMessageToA2A, convertDistriPartToA2A, createFailedToolResult, createSuccessfulToolResult, decodeA2AStreamEvent, extractTextFromDistriMessage, extractToolCallsFromDistriMessage, extractToolResultData, extractToolResultsFromDistriMessage, isArrayParts, isDistriEvent, isDistriMessage, processA2AMessagesData, processA2AStreamData, uuidv4 };
+export { A2AProtocolError, type A2AStreamEventData, type ActionPlanStep, Agent, type AgentConfigWithTools, type AgentDefinition, type AgentHandoverEvent, type AgentStats, type AgentUsageInfo, ApiError, type AssistantWithToolCalls, type BasePlanStep, type BatchToolCallsStep, type BrowserAgentConfig, type BrowserScreenshotEvent, type BrowserSession, type BrowserSessionStartedEvent, type ChatCompletionChoice, type ChatCompletionMessage, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseFormat, type ChatCompletionRole, type ChatProps, type CodePlanStep, type ConfigurationMeta, type ConfigurationResponse, ConnectionError, type ConnectionStatus, DEFAULT_BASE_URL, type DataPart, type DistriBaseTool, type DistriBrowserRuntimeConfig, type DistriChatMessage, DistriClient, type DistriClientConfig, type DistriConfiguration, DistriError, type DistriEvent, type DistriFnTool, type DistriMessage, type DistriPart, type DistriPlan, type DistriStreamEvent, type DistriThread, type ExternalMcpServer, ExternalToolValidationError, type ExternalToolValidationResult, type FeedbackReceivedEvent, type FileBytes, type FileType, type FileUrl, type FinalResultPlanStep, type HookContext, type HookHandler, type HookMutation, type ImagePart, type InlineHookEventData, type InlineHookRequest, type InlineHookRequestedEvent, type InvokeConfig, type InvokeContext, type InvokeResult, type LLMResponse, type LlmExecuteOptions, type LlmPlanStep, type McpDefinition, type McpServerType, type MessageRole, type ModelProviderConfig, type ModelProviderName, type ModelSettings, type PlanAction, type PlanFinishedEvent, type PlanPrunedEvent, type PlanStartedEvent, type PlanStep, type ReactStep, type Role, type RunErrorEvent, type RunFinishedEvent, type RunStartedEvent, type ServerConfig, type SpeechToTextConfig, type StepCompletedEvent, type StepStartedEvent, type StreamingTranscriptionOptions, type TextMessageContentEvent, type TextMessageEndEvent, type TextMessageStartEvent, type TextPart, type ThoughtPlanStep, type ThoughtStep, type Thread, type ThreadListParams, type ThreadListResponse, type ToolCall, type ToolCallPart, type ToolCallsEvent, type ToolDefinition, type ToolExecutionEndEvent, type ToolExecutionOptions, type ToolExecutionStartEvent, type ToolHandler, type ToolRejectedEvent, type ToolResult, type ToolResultData, type ToolResultRefPart, type ToolResults, type ToolResultsEvent, type UseToolsOptions, convertA2AMessageToDistri, convertA2APartToDistri, convertA2AStatusUpdateToDistri, convertDistriMessageToA2A, convertDistriPartToA2A, createFailedToolResult, createSuccessfulToolResult, decodeA2AStreamEvent, extractTextFromDistriMessage, extractToolCallsFromDistriMessage, extractToolResultData, extractToolResultsFromDistriMessage, isArrayParts, isDistriEvent, isDistriMessage, processA2AMessagesData, processA2AStreamData, uuidv4 };

package/dist/index.d.ts

@@ -143,6 +143,14 @@ interface BrowserScreenshotEvent {
         timestamp_ms?: number;
     };
 }
+interface BrowserSessionStartedEvent {
+    type: 'browser_session_started';
+    data: {
+        session_id: string;
+        viewer_url?: string;
+        stream_url?: string;
+    };
+}
 interface InlineHookRequestedEvent {
     type: 'inline_hook_requested';
     data: {
@@ -161,7 +169,7 @@ interface InlineHookRequestedEvent {
         result?: any;
     };
 }
-type DistriEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | PlanStartedEvent | PlanFinishedEvent | PlanPrunedEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ToolExecutionStartEvent | ToolExecutionEndEvent | ToolRejectedEvent | StepStartedEvent | StepCompletedEvent | AgentHandoverEvent | FeedbackReceivedEvent | ToolCallsEvent | ToolResultsEvent | BrowserScreenshotEvent | InlineHookRequestedEvent;
+type DistriEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | PlanStartedEvent | PlanFinishedEvent | PlanPrunedEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ToolExecutionStartEvent | ToolExecutionEndEvent | ToolRejectedEvent | StepStartedEvent | StepCompletedEvent | AgentHandoverEvent | FeedbackReceivedEvent | ToolCallsEvent | ToolResultsEvent | BrowserScreenshotEvent | BrowserSessionStartedEvent | InlineHookRequestedEvent;
 
 type ChatCompletionRole = 'system' | 'user' | 'assistant' | 'tool';
 interface ChatCompletionMessage {
@@ -335,6 +343,12 @@ declare class DistriClient {
      * Get specific agent by ID
      */
     getAgent(agentId: string): Promise<AgentConfigWithTools>;
+    /**
+     * Update an agent's definition (markdown only)
+     */
+    updateAgent(agentId: string, update: {
+        markdown: string;
+    }): Promise<AgentConfigWithTools>;
     /**
      * Get or create A2AClient for an agent
      */
@@ -356,9 +370,18 @@ declare class DistriClient {
      */
     cancelTask(agentId: string, taskId: string): Promise<void>;
     /**
-     * Get threads from Distri server
+     * Get threads from Distri server with filtering and pagination
+     */
+    getThreads(params?: ThreadListParams): Promise<ThreadListResponse>;
+    /**
+     * Get agents sorted by thread count (most active first)
      */
-    getThreads(): Promise<DistriThread[]>;
+    getAgentsByUsage(): Promise<AgentUsageInfo[]>;
+    /**
+     * Create a new browser session
+     * Returns session info including viewer_url and stream_url from browsr
+     */
+    createBrowserSession(): Promise<BrowserSession>;
     getThread(threadId: string): Promise<DistriThread>;
     /**
      * Get thread messages
@@ -816,6 +839,16 @@ interface AgentDefinition {
     context_size?: number;
     tools?: DistriBaseTool[];
     browser_config?: BrowserAgentConfig;
+    /** Agent usage statistics */
+    stats?: AgentStats;
+}
+/**
+ * Agent usage statistics
+ */
+interface AgentStats {
+    thread_count: number;
+    sub_agent_usage_count: number;
+    last_used_at?: string | null;
 }
 interface BrowserAgentConfig {
     enabled?: boolean;
@@ -876,6 +909,9 @@ interface DistriThread {
     updated_at: string;
     message_count: number;
     last_message?: string;
+    user_id?: string;
+    external_id?: string;
+    tags?: string[];
 }
 interface Thread {
     id: string;
@@ -885,6 +921,49 @@ interface Thread {
     updated_at: string;
     message_count: number;
     last_message?: string;
+    user_id?: string;
+    external_id?: string;
+    tags?: string[];
+}
+/**
+ * Parameters for listing threads with filtering and pagination
+ */
+interface ThreadListParams {
+    agent_id?: string;
+    external_id?: string;
+    search?: string;
+    from_date?: string;
+    to_date?: string;
+    tags?: string[];
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Paginated response for thread listing
+ */
+interface ThreadListResponse {
+    threads: DistriThread[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+/**
+ * Agent usage information for sorting agents by thread count
+ */
+interface AgentUsageInfo {
+    agent_id: string;
+    agent_name: string;
+    thread_count: number;
+}
+/**
+ * Browser session info returned when creating a session
+ */
+interface BrowserSession {
+    session_id: string;
+    /** SSE stream URL (backend API) for event streaming */
+    sse_url?: string;
+    /** Frame URL for embedding (frontend app with token) */
+    frame_url?: string;
 }
 interface ChatProps {
     thread: Thread;
@@ -1078,4 +1157,4 @@ declare function extractToolCallsFromDistriMessage(message: DistriMessage): any[
  */
 declare function extractToolResultsFromDistriMessage(message: DistriMessage): any[];
 
-export { A2AProtocolError, type A2AStreamEventData, type ActionPlanStep, Agent, type AgentConfigWithTools, type AgentDefinition, type AgentHandoverEvent, ApiError, type AssistantWithToolCalls, type BasePlanStep, type BatchToolCallsStep, type BrowserAgentConfig, type BrowserScreenshotEvent, type ChatCompletionChoice, type ChatCompletionMessage, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseFormat, type ChatCompletionRole, type ChatProps, type CodePlanStep, type ConfigurationMeta, type ConfigurationResponse, ConnectionError, type ConnectionStatus, DEFAULT_BASE_URL, type DataPart, type DistriBaseTool, type DistriBrowserRuntimeConfig, type DistriChatMessage, DistriClient, type DistriClientConfig, type DistriConfiguration, DistriError, type DistriEvent, type DistriFnTool, type DistriMessage, type DistriPart, type DistriPlan, type DistriStreamEvent, type DistriThread, type ExternalMcpServer, ExternalToolValidationError, type ExternalToolValidationResult, type FeedbackReceivedEvent, type FileBytes, type FileType, type FileUrl, type FinalResultPlanStep, type HookContext, type HookHandler, type HookMutation, type ImagePart, type InlineHookEventData, type InlineHookRequest, type InlineHookRequestedEvent, type InvokeConfig, type InvokeContext, type InvokeResult, type LLMResponse, type LlmExecuteOptions, type LlmPlanStep, type McpDefinition, type McpServerType, type MessageRole, type ModelProviderConfig, type ModelProviderName, type ModelSettings, type PlanAction, type PlanFinishedEvent, type PlanPrunedEvent, type PlanStartedEvent, type PlanStep, type ReactStep, type Role, type RunErrorEvent, type RunFinishedEvent, type RunStartedEvent, type ServerConfig, type SpeechToTextConfig, type StepCompletedEvent, type StepStartedEvent, type StreamingTranscriptionOptions, type TextMessageContentEvent, type TextMessageEndEvent, type TextMessageStartEvent, type TextPart, type ThoughtPlanStep, type ThoughtStep, type Thread, type ToolCall, type ToolCallPart, type ToolCallsEvent, type ToolDefinition, type ToolExecutionEndEvent, type ToolExecutionOptions, type ToolExecutionStartEvent, type ToolHandler, type ToolRejectedEvent, type ToolResult, type ToolResultData, type ToolResultRefPart, type ToolResults, type ToolResultsEvent, type UseToolsOptions, convertA2AMessageToDistri, convertA2APartToDistri, convertA2AStatusUpdateToDistri, convertDistriMessageToA2A, convertDistriPartToA2A, createFailedToolResult, createSuccessfulToolResult, decodeA2AStreamEvent, extractTextFromDistriMessage, extractToolCallsFromDistriMessage, extractToolResultData, extractToolResultsFromDistriMessage, isArrayParts, isDistriEvent, isDistriMessage, processA2AMessagesData, processA2AStreamData, uuidv4 };
+export { A2AProtocolError, type A2AStreamEventData, type ActionPlanStep, Agent, type AgentConfigWithTools, type AgentDefinition, type AgentHandoverEvent, type AgentStats, type AgentUsageInfo, ApiError, type AssistantWithToolCalls, type BasePlanStep, type BatchToolCallsStep, type BrowserAgentConfig, type BrowserScreenshotEvent, type BrowserSession, type BrowserSessionStartedEvent, type ChatCompletionChoice, type ChatCompletionMessage, type ChatCompletionRequest, type ChatCompletionResponse, type ChatCompletionResponseFormat, type ChatCompletionRole, type ChatProps, type CodePlanStep, type ConfigurationMeta, type ConfigurationResponse, ConnectionError, type ConnectionStatus, DEFAULT_BASE_URL, type DataPart, type DistriBaseTool, type DistriBrowserRuntimeConfig, type DistriChatMessage, DistriClient, type DistriClientConfig, type DistriConfiguration, DistriError, type DistriEvent, type DistriFnTool, type DistriMessage, type DistriPart, type DistriPlan, type DistriStreamEvent, type DistriThread, type ExternalMcpServer, ExternalToolValidationError, type ExternalToolValidationResult, type FeedbackReceivedEvent, type FileBytes, type FileType, type FileUrl, type FinalResultPlanStep, type HookContext, type HookHandler, type HookMutation, type ImagePart, type InlineHookEventData, type InlineHookRequest, type InlineHookRequestedEvent, type InvokeConfig, type InvokeContext, type InvokeResult, type LLMResponse, type LlmExecuteOptions, type LlmPlanStep, type McpDefinition, type McpServerType, type MessageRole, type ModelProviderConfig, type ModelProviderName, type ModelSettings, type PlanAction, type PlanFinishedEvent, type PlanPrunedEvent, type PlanStartedEvent, type PlanStep, type ReactStep, type Role, type RunErrorEvent, type RunFinishedEvent, type RunStartedEvent, type ServerConfig, type SpeechToTextConfig, type StepCompletedEvent, type StepStartedEvent, type StreamingTranscriptionOptions, type TextMessageContentEvent, type TextMessageEndEvent, type TextMessageStartEvent, type TextPart, type ThoughtPlanStep, type ThoughtStep, type Thread, type ThreadListParams, type ThreadListResponse, type ToolCall, type ToolCallPart, type ToolCallsEvent, type ToolDefinition, type ToolExecutionEndEvent, type ToolExecutionOptions, type ToolExecutionStartEvent, type ToolHandler, type ToolRejectedEvent, type ToolResult, type ToolResultData, type ToolResultRefPart, type ToolResults, type ToolResultsEvent, type UseToolsOptions, convertA2AMessageToDistri, convertA2APartToDistri, convertA2AStatusUpdateToDistri, convertDistriMessageToA2A, convertDistriPartToA2A, createFailedToolResult, createSuccessfulToolResult, decodeA2AStreamEvent, extractTextFromDistriMessage, extractToolCallsFromDistriMessage, extractToolResultData, extractToolResultsFromDistriMessage, isArrayParts, isDistriEvent, isDistriMessage, processA2AMessagesData, processA2AStreamData, uuidv4 };

package/dist/index.js

@@ -730,6 +730,17 @@ function convertA2AStatusUpdateToDistri(statusUpdate) {
       };
       return hookRequested;
     }
+    case "browser_session_started": {
+      const browserSessionStarted = {
+        type: "browser_session_started",
+        data: {
+          session_id: metadata.session_id || "",
+          viewer_url: metadata.viewer_url,
+          stream_url: metadata.stream_url
+        }
+      };
+      return browserSessionStarted;
+    }
     default: {
       console.warn(`Unhandled status update metadata type: ${metadata.type}`, metadata);
       const defaultResult = {
@@ -1312,6 +1323,31 @@ var _DistriClient = class _DistriClient {
       throw new DistriError(`Failed to fetch agent ${agentId}`, "FETCH_ERROR", error);
     }
   }
+  /**
+   * Update an agent's definition (markdown only)
+   */
+  async updateAgent(agentId, update) {
+    try {
+      const response = await this.fetch(`/agents/${agentId}`, {
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json",
+          ...this.config.headers
+        },
+        body: JSON.stringify(update)
+      });
+      if (!response.ok) {
+        if (response.status === 404) {
+          throw new ApiError(`Agent not found: ${agentId}`, 404);
+        }
+        throw new ApiError(`Failed to update agent: ${response.statusText}`, response.status);
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof ApiError) throw error;
+      throw new DistriError(`Failed to update agent ${agentId}`, "UPDATE_ERROR", error);
+    }
+  }
   /**
    * Get or create A2AClient for an agent
    */
@@ -1397,11 +1433,22 @@ var _DistriClient = class _DistriClient {
     }
   }
   /**
-   * Get threads from Distri server
+   * Get threads from Distri server with filtering and pagination
    */
-  async getThreads() {
+  async getThreads(params = {}) {
     try {
-      const response = await this.fetch(`/threads`);
+      const searchParams = new URLSearchParams();
+      if (params.agent_id) searchParams.set("agent_id", params.agent_id);
+      if (params.external_id) searchParams.set("external_id", params.external_id);
+      if (params.search) searchParams.set("search", params.search);
+      if (params.from_date) searchParams.set("from_date", params.from_date);
+      if (params.to_date) searchParams.set("to_date", params.to_date);
+      if (params.tags?.length) searchParams.set("tags", params.tags.join(","));
+      if (params.limit !== void 0) searchParams.set("limit", params.limit.toString());
+      if (params.offset !== void 0) searchParams.set("offset", params.offset.toString());
+      const queryString = searchParams.toString();
+      const url = queryString ? `/threads?${queryString}` : "/threads";
+      const response = await this.fetch(url);
       if (!response.ok) {
         throw new ApiError(`Failed to fetch threads: ${response.statusText}`, response.status);
       }
@@ -1411,6 +1458,39 @@ var _DistriClient = class _DistriClient {
       throw new DistriError("Failed to fetch threads", "FETCH_ERROR", error);
     }
   }
+  /**
+   * Get agents sorted by thread count (most active first)
+   */
+  async getAgentsByUsage() {
+    try {
+      const response = await this.fetch("/threads/agents");
+      if (!response.ok) {
+        throw new ApiError(`Failed to fetch agents by usage: ${response.statusText}`, response.status);
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof ApiError) throw error;
+      throw new DistriError("Failed to fetch agents by usage", "FETCH_ERROR", error);
+    }
+  }
+  /**
+   * Create a new browser session
+   * Returns session info including viewer_url and stream_url from browsr
+   */
+  async createBrowserSession() {
+    try {
+      const response = await this.fetch("/browser/session", {
+        method: "POST"
+      });
+      if (!response.ok) {
+        throw new ApiError(`Failed to create browser session: ${response.statusText}`, response.status);
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof ApiError) throw error;
+      throw new DistriError("Failed to create browser session", "FETCH_ERROR", error);
+    }
+  }
   async getThread(threadId) {
     try {
       const response = await this.fetch(`/threads/${threadId}`);
@@ -1865,7 +1945,7 @@ var Agent = class _Agent {
     const enhancedParams = this.enhanceParamsWithTools(params, tools);
     const a2aStream = this.client.sendMessageStream(this.agentDefinition.id, enhancedParams);
     const self = this;
-    return async function* () {
+    return (async function* () {
       for await (const event of a2aStream) {
         const converted = decodeA2AStreamEvent(event);
         if (converted && converted.type === "inline_hook_requested") {
@@ -1886,7 +1966,7 @@ var Agent = class _Agent {
           yield converted;
         }
       }
-    }();
+    })();
   }
   /**
    * Validate that required external tools are registered before invoking.