@yushaw/sanqian-sdk 0.3.21 → 0.3.23

package/dist/index.d.mts

@@ -871,6 +871,11 @@ interface ChannelProbeResult {
     bot_username: string | null;
     error: string | null;
 }
+interface ProbeChannelConfigRequest {
+    channel_type: string;
+    config: Record<string, unknown>;
+}
+type ChannelConfigSchema = Record<string, unknown>;
 interface CreateChannelAccountRequest {
     channel_type: string;
     name: string;
@@ -938,6 +943,7 @@ declare class SanqianSDK {
     private activeStreamConversations;
     private static readonly VALID_SECURITY_LEVELS;
     private connectingPromise;
+    private httpReadyPromise;
     private reconnectRefCount;
     private launchedBySanqian;
     private eventListeners;
@@ -958,11 +964,19 @@ declare class SanqianSDK {
     private resolvePendingStartIndex;
     private getHttpBaseUrl;
     private getHttpAuthHeaders;
+    private ensureHttpReady;
+    private doEnsureHttpReady;
     /**
      * Get the port number for the Sanqian backend
      * @throws Error if not connected
      */
     getPort(): number;
+    /**
+     * Get the HTTP base URL for Sanqian backend.
+     *
+     * @throws Error if connection info is not available
+     */
+    getBaseUrl(): string;
     constructor(config: SDKConfig);
     /**
      * Start watching connection.json for changes
@@ -1450,6 +1464,8 @@ declare class SanqianSDK {
     }>;
     getChannelStatus(id: string): Promise<ChannelStatus>;
     probeChannelAccount(id: string): Promise<ChannelProbeResult>;
+    probeChannelConfig(req: ProbeChannelConfigRequest): Promise<ChannelProbeResult>;
+    getChannelConfigSchema(channelType: string): Promise<ChannelConfigSchema>;
     listChannelBindings(accountId?: string): Promise<ChannelBinding[]>;
     createChannelBinding(req: CreateChannelBindingRequest): Promise<ChannelBinding>;
     updateChannelBinding(id: string, req: UpdateChannelBindingRequest): Promise<ChannelBinding>;
@@ -1644,4 +1660,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 ChannelAccount, type ChannelAccountStatus, type ChannelBinding, type ChannelBindingMatchType, type ChannelChatType, type ChannelDmPolicy, type ChannelDmScope, type ChannelGroupPolicy, type ChannelPluginInfo, type ChannelProbeResult, type ChannelRuntimeStatus, type ChannelStatus, 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, type CreateChannelAccountRequest, type CreateChannelBindingRequest, DiscoveryManager, 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, type ResourceListOptions, type ResourceListResult, type ResourceType, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, type SDKExtendedMethods, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SendChannelMessageRequest, type SendChannelMessageResponse, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, type UpdateChannelAccountRequest, type UpdateChannelBindingRequest, createSDKError };
+export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChannelAccount, type ChannelAccountStatus, type ChannelBinding, type ChannelBindingMatchType, type ChannelChatType, type ChannelConfigSchema, type ChannelDmPolicy, type ChannelDmScope, type ChannelGroupPolicy, type ChannelPluginInfo, type ChannelProbeResult, type ChannelRuntimeStatus, type ChannelStatus, 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, type CreateChannelAccountRequest, type CreateChannelBindingRequest, DiscoveryManager, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type LoadItem, type LoadItemAction, type LoadItemType, type ProbeChannelConfigRequest, type RemoteToolDefinition, type RerankConfigResult, type ResourceListOptions, type ResourceListResult, type ResourceType, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, type SDKExtendedMethods, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SendChannelMessageRequest, type SendChannelMessageResponse, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, type UpdateChannelAccountRequest, type UpdateChannelBindingRequest, createSDKError };

package/dist/index.d.ts

@@ -871,6 +871,11 @@ interface ChannelProbeResult {
     bot_username: string | null;
     error: string | null;
 }
+interface ProbeChannelConfigRequest {
+    channel_type: string;
+    config: Record<string, unknown>;
+}
+type ChannelConfigSchema = Record<string, unknown>;
 interface CreateChannelAccountRequest {
     channel_type: string;
     name: string;
@@ -938,6 +943,7 @@ declare class SanqianSDK {
     private activeStreamConversations;
     private static readonly VALID_SECURITY_LEVELS;
     private connectingPromise;
+    private httpReadyPromise;
     private reconnectRefCount;
     private launchedBySanqian;
     private eventListeners;
@@ -958,11 +964,19 @@ declare class SanqianSDK {
     private resolvePendingStartIndex;
     private getHttpBaseUrl;
     private getHttpAuthHeaders;
+    private ensureHttpReady;
+    private doEnsureHttpReady;
     /**
      * Get the port number for the Sanqian backend
      * @throws Error if not connected
      */
     getPort(): number;
+    /**
+     * Get the HTTP base URL for Sanqian backend.
+     *
+     * @throws Error if connection info is not available
+     */
+    getBaseUrl(): string;
     constructor(config: SDKConfig);
     /**
      * Start watching connection.json for changes
@@ -1450,6 +1464,8 @@ declare class SanqianSDK {
     }>;
     getChannelStatus(id: string): Promise<ChannelStatus>;
     probeChannelAccount(id: string): Promise<ChannelProbeResult>;
+    probeChannelConfig(req: ProbeChannelConfigRequest): Promise<ChannelProbeResult>;
+    getChannelConfigSchema(channelType: string): Promise<ChannelConfigSchema>;
     listChannelBindings(accountId?: string): Promise<ChannelBinding[]>;
     createChannelBinding(req: CreateChannelBindingRequest): Promise<ChannelBinding>;
     updateChannelBinding(id: string, req: UpdateChannelBindingRequest): Promise<ChannelBinding>;
@@ -1644,4 +1660,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 ChannelAccount, type ChannelAccountStatus, type ChannelBinding, type ChannelBindingMatchType, type ChannelChatType, type ChannelDmPolicy, type ChannelDmScope, type ChannelGroupPolicy, type ChannelPluginInfo, type ChannelProbeResult, type ChannelRuntimeStatus, type ChannelStatus, 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, type CreateChannelAccountRequest, type CreateChannelBindingRequest, DiscoveryManager, 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, type ResourceListOptions, type ResourceListResult, type ResourceType, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, type SDKExtendedMethods, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SendChannelMessageRequest, type SendChannelMessageResponse, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, type UpdateChannelAccountRequest, type UpdateChannelBindingRequest, createSDKError };
+export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChannelAccount, type ChannelAccountStatus, type ChannelBinding, type ChannelBindingMatchType, type ChannelChatType, type ChannelConfigSchema, type ChannelDmPolicy, type ChannelDmScope, type ChannelGroupPolicy, type ChannelPluginInfo, type ChannelProbeResult, type ChannelRuntimeStatus, type ChannelStatus, 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, type CreateChannelAccountRequest, type CreateChannelBindingRequest, DiscoveryManager, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type LoadItem, type LoadItemAction, type LoadItemType, type ProbeChannelConfigRequest, type RemoteToolDefinition, type RerankConfigResult, type ResourceListOptions, type ResourceListResult, type ResourceType, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, type SDKExtendedMethods, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SendChannelMessageRequest, type SendChannelMessageResponse, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, type UpdateChannelAccountRequest, type UpdateChannelBindingRequest, createSDKError };

package/dist/index.js

@@ -538,6 +538,8 @@ var SanqianSDK = class _SanqianSDK {
   ]);
   // Connection promise for deduplication (prevents multiple concurrent connect attempts)
   connectingPromise = null;
+  // HTTP readiness promise for deduplication (prevents concurrent discovery/launch)
+  httpReadyPromise = null;
   // Reconnect reference count - when > 0, auto-reconnect is enabled
   // This allows multiple components to request persistent connections
   reconnectRefCount = 0;
@@ -664,6 +666,38 @@ var SanqianSDK = class _SanqianSDK {
     const token = info?.token;
     return token ? { "X-App-Token": token } : {};
   }
+  async ensureHttpReady() {
+    if (this.connectionInfo || this.config.connectionInfo) {
+      return;
+    }
+    if (this.httpReadyPromise) {
+      this.log("HTTP readiness already in progress, waiting...");
+      return this.httpReadyPromise;
+    }
+    this.httpReadyPromise = this.doEnsureHttpReady();
+    try {
+      await this.httpReadyPromise;
+    } finally {
+      this.httpReadyPromise = null;
+    }
+  }
+  async doEnsureHttpReady() {
+    const discovery = await this.getDiscovery();
+    let info = discovery.read();
+    if (!info) {
+      if (!this.config.autoLaunchSanqian) {
+        throw createSDKError("NOT_RUNNING" /* NOT_RUNNING */);
+      }
+      this.log("Sanqian not running, attempting to launch for HTTP API...");
+      const launched = discovery.launchSanqian(this.config.sanqianPath);
+      if (!launched) {
+        throw createSDKError("NOT_INSTALLED" /* NOT_INSTALLED */);
+      }
+      this.log("Sanqian launch initiated, waiting for startup...");
+      info = await this.waitForSanqianStartup();
+    }
+    this.connectionInfo = info;
+  }
   /**
    * Get the port number for the Sanqian backend
    * @throws Error if not connected
@@ -675,6 +709,14 @@ var SanqianSDK = class _SanqianSDK {
     }
     return info.port;
   }
+  /**
+   * Get the HTTP base URL for Sanqian backend.
+   *
+   * @throws Error if connection info is not available
+   */
+  getBaseUrl() {
+    return this.getHttpBaseUrl();
+  }
   constructor(config) {
     const requestedSecurityLevel = this.normalizeRequestedSecurityLevel(
       config.requestedSecurityLevel
@@ -1565,26 +1607,10 @@ var SanqianSDK = class _SanqianSDK {
    */
   async doFullConnect() {
     this.log("Starting full connection flow...");
-    let info = null;
-    if (this.config.connectionInfo) {
-      this.log("Using pre-configured connection info (browser mode)");
-      info = this.config.connectionInfo;
-    } else {
-      const discovery = await this.getDiscovery();
-      info = discovery.read();
-      if (!info) {
-        if (this.config.autoLaunchSanqian) {
-          this.log("Sanqian not running, attempting to launch...");
-          const launched = discovery.launchSanqian(this.config.sanqianPath);
-          if (!launched) {
-            throw createSDKError("NOT_INSTALLED" /* NOT_INSTALLED */);
-          }
-          this.log("Sanqian launch initiated, waiting for startup...");
-          info = await this.waitForSanqianStartup();
-        } else {
-          throw createSDKError("NOT_RUNNING" /* NOT_RUNNING */);
-        }
-      }
+    await this.ensureHttpReady();
+    const info = this.connectionInfo || this.config.connectionInfo;
+    if (!info) {
+      throw createSDKError("NOT_RUNNING" /* NOT_RUNNING */);
     }
     await this.connectWithInfo(info);
   }
@@ -2473,7 +2499,7 @@ var SanqianSDK = class _SanqianSDK {
   // Channels
   // ============================================
   async listChannelPlugins() {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/plugins`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2482,7 +2508,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async listChannelAccounts() {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2491,7 +2517,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async createChannelAccount(req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts`;
     const response = await fetch(url, {
       method: "POST",
@@ -2505,7 +2531,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async getChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2514,7 +2540,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async updateChannelAccount(id, req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}`;
     const response = await fetch(url, {
       method: "PUT",
@@ -2528,7 +2554,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async deleteChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}`;
     const response = await fetch(url, { method: "DELETE", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2536,7 +2562,7 @@ var SanqianSDK = class _SanqianSDK {
     }
   }
   async startChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}/start`;
     const response = await fetch(url, { method: "POST", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2546,7 +2572,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async stopChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}/stop`;
     const response = await fetch(url, { method: "POST", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2555,7 +2581,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async getChannelStatus(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}/status`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2564,7 +2590,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async probeChannelAccount(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/accounts/${encodeURIComponent(id)}/probe`;
     const response = await fetch(url, { method: "POST", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2573,8 +2599,32 @@ var SanqianSDK = class _SanqianSDK {
     }
     return response.json();
   }
+  async probeChannelConfig(req) {
+    await this.ensureHttpReady();
+    const url = `${this.getHttpBaseUrl()}/api/channels/probe-config`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { ...this.getHttpAuthHeaders(), "Content-Type": "application/json" },
+      body: JSON.stringify(req)
+    });
+    if (!response.ok) {
+      const detail = await response.text();
+      throw createSDKError("REQUEST_FAILED" /* REQUEST_FAILED */, `Failed to probe channel config: ${detail}`);
+    }
+    return response.json();
+  }
+  async getChannelConfigSchema(channelType) {
+    await this.ensureHttpReady();
+    const url = `${this.getHttpBaseUrl()}/api/channels/plugins/${encodeURIComponent(channelType)}/config-schema`;
+    const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
+    if (!response.ok) {
+      const detail = await response.text();
+      throw createSDKError("REQUEST_FAILED" /* REQUEST_FAILED */, `Failed to get channel config schema: ${detail}`);
+    }
+    return response.json();
+  }
   async listChannelBindings(accountId) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const params = accountId ? `?account_id=${encodeURIComponent(accountId)}` : "";
     const url = `${this.getHttpBaseUrl()}/api/channels/bindings${params}`;
     const response = await fetch(url, { headers: this.getHttpAuthHeaders() });
@@ -2584,7 +2634,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async createChannelBinding(req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/bindings`;
     const response = await fetch(url, {
       method: "POST",
@@ -2598,7 +2648,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async updateChannelBinding(id, req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/bindings/${encodeURIComponent(id)}`;
     const response = await fetch(url, {
       method: "PUT",
@@ -2612,7 +2662,7 @@ var SanqianSDK = class _SanqianSDK {
     return response.json();
   }
   async deleteChannelBinding(id) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/bindings/${encodeURIComponent(id)}`;
     const response = await fetch(url, { method: "DELETE", headers: this.getHttpAuthHeaders() });
     if (!response.ok) {
@@ -2620,7 +2670,7 @@ var SanqianSDK = class _SanqianSDK {
     }
   }
   async sendChannelMessage(req) {
-    await this.ensureReady();
+    await this.ensureHttpReady();
     const url = `${this.getHttpBaseUrl()}/api/channels/send`;
     const response = await fetch(url, {
       method: "POST",