@tbox-dev-js/sdk 0.1.5 → 0.1.6

package/dist/types.d.ts

@@ -14,6 +14,42 @@ export interface SdkResponse<T = unknown> {
     /** 错误信息 */
     errorMsg?: string;
 }
+/**
+ * C端 Session 鉴权信息
+ *
+ * 通过 TboxAppClient.generateSession() 获取 sessionId 和 channel，
+ * 结合 appId 构成 C端请求头。
+ */
+export interface SessionAuth {
+    /** 会话 ID（通过 generateSession 获取） */
+    sessionId: string;
+    /** 登录渠道（通过 generateSession 获取） */
+    channel: string;
+    /** 百宝箱应用 ID */
+    appId: string;
+}
+/**
+ * B端客户端配置（通过 API Key 鉴权）
+ */
+export interface TboxPluginClientConfig {
+    /** API Key（通过 Authorization 头传递） */
+    apiKey: string;
+    /** 自定义 base URL（可选，默认 https://o.tbox.cn） */
+    baseUrl?: string;
+    /** 请求超时时间（毫秒，可选） */
+    timeout?: number;
+}
+/**
+ * C端客户端配置（通过 Session 鉴权）
+ */
+export interface TboxSessionClientConfig {
+    /** C端 Session 鉴权信息 */
+    session: SessionAuth;
+    /** 自定义 base URL（可选，默认 https://o.tbox.cn） */
+    baseUrl?: string;
+    /** 请求超时时间（毫秒，可选） */
+    timeout?: number;
+}
 /**
  * 文字转语音请求
  */
@@ -340,26 +376,6 @@ export interface WebSearchResponse {
     /** 搜索结果列表 */
     items?: WebSearchItem[];
 }
-/**
- * TboxPluginClient 初始化配置
- */
-export interface TboxPluginClientConfig {
-    /**
-     * API Key（Bearer Token），通过 Authorization 头传递。
-     * 格式：直接传 key 字符串，SDK 内部会自动拼接 "Bearer " 前缀。
-     */
-    apiKey: string;
-    /**
-     * 自定义 base URL（可选）。
-     * 默认为 https://o.tbox.cn
-     */
-    baseUrl?: string;
-    /**
-     * 请求超时时间（毫秒，可选）。
-     * 默认不设置超时。
-     */
-    timeout?: number;
-}
 /**
  * AmapClient 初始化配置
  */
@@ -1413,3 +1429,44 @@ export interface ChatCompletionChunkChoice {
     /** 结束原因：stop / length / content_filter 等，正常结束为 stop */
     finish_reason?: string | null;
 }
+/**
+ * 首页开场白请求
+ */
+export interface HomepageGetRequest {
+    /** 应用 Agent ID（必填） */
+    agentId: string;
+    /** 扩展信息（可选，JSON 字符串） */
+    extInfo?: string;
+}
+/**
+ * 创建 C端客户端的便捷参数
+ *
+ * 通过 B端 apiKey 自动调用 generateSession 获取 session 信息
+ */
+export interface CreateSessionClientOptions {
+    /** B端 API Key（用于调用 generateSession） */
+    apiKey: string;
+    /** 百宝箱应用 ID */
+    appId: string;
+    /** 用户 ID */
+    userId: string;
+    /** 自定义 base URL（可选） */
+    baseUrl?: string;
+    /** 请求超时时间（毫秒，可选） */
+    timeout?: number;
+}
+/**
+ * 首页开场白响应
+ */
+export interface HomepageGetResponse {
+    /** 开场白文本 */
+    prologue?: string;
+    /** 推荐问题列表 */
+    suggestQuestions?: string[];
+    /** 应用名称 */
+    agentName?: string;
+    /** 应用头像 URL */
+    agentAvatar?: string;
+    /** 扩展信息 */
+    extInfo?: Record<string, unknown>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox-dev-js/sdk",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "百宝箱平台 JavaScript SDK — 知识库、插件、会话等服务的统一客户端",
   "type": "module",
   "main": "dist/index.cjs",