@yushaw/sanqian-sdk 0.3.17 → 0.3.19

package/dist/index.browser.d.mts

@@ -261,6 +261,14 @@ interface ChatResponse {
         total_tokens: number;
     };
 }
+/** Mention/load item types for dynamic capability/context activation */
+type LoadItemType = "tool" | "skill" | "subagent" | "context";
+type LoadItemAction = "load" | "unload";
+interface LoadItem {
+    type: LoadItemType;
+    id: string;
+    action?: LoadItemAction;
+}
 interface ChatStreamEvent {
     type: "start" | "text" | "thinking" | "tool_call" | "tool_args_chunk" | "tool_args" | "tool_result" | "done" | "error" | "interrupt" | "cancelled";
     /** Text content (for "text" and "thinking" events) */
@@ -289,7 +297,7 @@ interface ChatStreamEvent {
     interrupt_type?: HitlInterruptType;
     /** Interrupt payload (for "interrupt" event) - HITL */
     interrupt_payload?: HitlInterruptPayload;
-    /** Run ID (for "interrupt" event) - needed to send HITL response */
+    /** Run ID (for "start"/"interrupt"/"cancelled" events) */
     run_id?: string;
 }
 /**
@@ -394,6 +402,12 @@ interface AgentConfig {
      * - ["agent1", "agent2"]: Can only call specified agents
      */
     subagents?: string[];
+    /**
+     * Enable memory system for this agent (default: false).
+     * When enabled, relevant memories are auto-recalled at each turn
+     * and new facts are automatically captured.
+     */
+    memory_enabled?: boolean;
     /**
      * Whether this agent can be discovered via search_capability (default: true)
      * Set to false if you want the agent to be usable but not discoverable by other agents
@@ -429,6 +443,8 @@ interface AgentInfo {
     skills: string[];
     /** Sub-agents this agent can call via task tool */
     subagents?: string[] | null;
+    /** Whether memory system is enabled for this agent */
+    memory_enabled?: boolean;
     /** Whether this agent can be discovered via search_capability */
     searchable?: boolean;
     created_at?: string;
@@ -497,6 +513,12 @@ interface AgentUpdateConfig {
      * - ["agent1", "agent2"]: Can only call specified agents
      */
     subagents?: string[] | null;
+    /**
+     * Enable memory system for this agent.
+     * - undefined: Keep existing value
+     * - true/false: Set explicitly
+     */
+    memory_enabled?: boolean;
     /**
      * Whether this agent can be discovered via search_capability
      * - undefined: Keep existing value
@@ -727,9 +749,14 @@ declare class SanqianSDK {
     private sessionResources;
     private contextProviders;
     private runIdToMsgId;
-    private pendingStreamMsgId;
+    private pendingStreamRequests;
+    private pendingCancelMsgIds;
+    private static readonly VALID_SECURITY_LEVELS;
     private log;
     private warn;
+    private normalizeRequestedSecurityLevel;
+    private sendRunCancel;
+    private requestStreamCancel;
     constructor(config: SDKConfig);
     /**
      * Build WebSocket URL from connection info
@@ -809,6 +836,9 @@ declare class SanqianSDK {
         autoDiscoverTools?: boolean;
         autoDiscoverSubagents?: boolean;
         persistHistory?: boolean;
+        filePaths?: string[];
+        loadItems?: LoadItem[];
+        mentionedTools?: string[];
     }): Promise<ChatResponse>;
     chatStream(agentId: string, messages: ChatMessage[], options?: {
         conversationId?: string;
@@ -820,6 +850,10 @@ declare class SanqianSDK {
         attachedContexts?: string[];
         attachedResources?: string[];
         sessionResources?: string[];
+        filePaths?: string[];
+        loadItems?: LoadItem[];
+        mentionedTools?: string[];
+        signal?: AbortSignal;
     }): AsyncGenerator<ChatStreamEvent>;
     /**
      * Send HITL (Human-in-the-Loop) response to resume after interrupt
@@ -944,6 +978,7 @@ declare const SANQIAN_WEBSITE = "https://sanqian.io";
  * Error codes for SDK errors
  */
 declare enum SDKErrorCode {
+    INVALID_CONFIG = "INVALID_CONFIG",
     NOT_INSTALLED = "NOT_INSTALLED",
     NOT_RUNNING = "NOT_RUNNING",
     CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
@@ -996,4 +1031,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 ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type RemoteToolDefinition, type RerankConfigResult, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SessionResource, type SkillCapability, type StoredSessionResource, 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 ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type LoadItem, type LoadItemAction, type LoadItemType, type RemoteToolDefinition, type RerankConfigResult, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, createSDKError };