@tbox-dev-js/sdk 0.1.0

package/LEGAL.md

@@ -0,0 +1,7 @@
+Legal Disclaimer
+
+Within this source code, the comments in Chinese shall be the original, governing version. Any comment in other languages are for reference only. In the event of any conflict between the Chinese language version comments and other language version comments, the Chinese language version shall prevail.
+
+法律免责声明
+
+关于代码注释部分，中文注释为官方版本，其它语言注释仅做参考。中文注释可能与其它语言注释存在不一致，当中文注释与其它语言注释存在不一致时，请以中文注释为准。

package/README.md

@@ -0,0 +1,222 @@
+# @tbox/plugin-sdk
+
+百宝箱平台插件服务 JavaScript SDK，封装了插件工具执行、TTS/ASR、插件信息查询等核心能力。
+
+调用域名：`https://o.tbox.cn`
+
+## 安装
+
+```bash
+npm install @tbox/plugin-sdk
+# 或
+yarn add @tbox/plugin-sdk
+# 或
+pnpm add @tbox/plugin-sdk
+```
+
+## 快速开始
+
+```ts
+import { TboxPluginClient } from '@tbox/plugin-sdk';
+
+const client = new TboxPluginClient({
+  apiKey: 'your-api-key', // 百宝箱应用 API Key
+});
+
+// 按工具 ID 执行插件工具
+const result = await client.run('your-plugin-tool-id', {
+  inputs: { city: '杭州' },
+});
+
+if (result.success) {
+  console.log(result.data?.output);
+} else {
+  console.error(result.errorCode, result.errorMsg);
+}
+```
+
+## 初始化配置
+
+```ts
+const client = new TboxPluginClient({
+  // 必填：API Key（百宝箱应用维度的 API Key）
+  apiKey: 'your-api-key',
+
+  // 可选：自定义 base URL，默认 https://o.tbox.cn
+  baseUrl: 'https://o.tbox.cn',
+
+  // 可选：请求超时时间（毫秒）
+  timeout: 10000,
+});
+```
+
+## API 文档
+
+### `client.run(pluginToolId, request)` — 按工具 ID 执行插件
+
+**适用场景**：已知工具 ID，调用最直接、性能最好。
+
+```ts
+const res = await client.run('tool-id-xxx', {
+  inputs: {
+    query: '今天杭州天气',
+  },
+});
+// res.data: PluginExecResult
+```
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `pluginToolId` | `string` | 插件工具 ID |
+| `request.inputs` | `Record<string, unknown>` | 工具输入参数 |
+
+---
+
+### `client.runByToolName(pluginId, toolName, request)` — 按工具名称执行插件
+
+**适用场景**：已知插件 ID 和工具名称，SDK 内部自动解析工具 ID。
+
+```ts
+const res = await client.runByToolName('plugin-id', 'weather_search', {
+  inputs: { city: '上海' },
+});
+```
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `pluginId` | `string` | 插件 ID |
+| `toolName` | `string` | 工具名称 |
+| `request.inputs` | `Record<string, unknown>` | 工具输入参数 |
+
+---
+
+### `client.getPluginInfo(pluginId)` — 查询插件信息
+
+查询插件配置信息，包含插件下的工具列表及参数定义。
+
+```ts
+const res = await client.getPluginInfo('plugin-id');
+if (res.success) {
+  const tools = res.data?.pluginToolList;
+  tools?.forEach(tool => {
+    console.log(tool.name, tool.description);
+  });
+}
+```
+
+---
+
+### `client.submitToolOutput(request)` — 提交工具输出
+
+在 Agent 调用工具后，将工具执行结果回传给平台。
+
+```ts
+const res = await client.submitToolOutput({
+  agent_id: 'app-id-xxx',       // 百宝箱应用 ID
+  tool_call_id: 'call-id-yyy',  // 工具调用 ID
+  output: { result: '晴天，25°C' },
+});
+```
+
+---
+
+### `client.doTts(request)` — 文字转语音
+
+```ts
+const res = await client.doTts({
+  text: '你好，欢迎使用百宝箱',
+  voice: 'xiaoyun',   // 可选，发音人
+  speechRate: 0,      // 可选，语速 -500~500
+});
+if (res.success) {
+  const audioBase64 = res.data?.audioBase64;
+}
+```
+
+---
+
+### `client.asrBase64(request)` — 语音转文字
+
+输入 Base64 编码的音频数据，返回识别文本。
+
+```ts
+const res = await client.asrBase64({
+  audioBase64: '<base64-encoded-audio>',
+  format: 'mp3',       // 可选，音频格式
+  sampleRate: 16000,   // 可选，采样率
+});
+if (res.success) {
+  console.log(res.data?.text);
+}
+```
+
+---
+
+## 统一响应格式
+
+所有方法均返回 `Promise<SdkResponse<T>>`：
+
+```ts
+interface SdkResponse<T> {
+  success: boolean;      // 是否成功
+  data?: T;              // 响应数据（成功时）
+  errorCode?: string;    // 错误码（失败时）
+  errorMsg?: string;     // 错误信息（失败时）
+}
+```
+
+## 错误处理
+
+```ts
+const res = await client.run('tool-id', { inputs: {} });
+
+if (!res.success) {
+  switch (res.errorCode) {
+    case 'NETWORK_ERROR':
+      console.error('网络请求失败:', res.errorMsg);
+      break;
+    case 'HTTP_401':
+      console.error('API Key 无效或已过期');
+      break;
+    default:
+      console.error(`调用失败 [${res.errorCode}]:`, res.errorMsg);
+  }
+}
+```
+
+## 兼容环境
+
+- **Node.js** >= 18（原生支持 `fetch`）
+- **浏览器**：支持 `fetch` API 的现代浏览器
+- **模块格式**：ESM（`import`）+ CJS（`require`）双格式
+
+## 项目结构
+
+```
+tbox-js/
+├── src/
+│   ├── types.ts      # TypeScript 类型定义
+│   ├── http.ts       # 底层 HTTP 封装
+│   ├── plugin.ts     # TboxPluginClient 核心类
+│   └── index.ts      # 统一导出入口
+├── dist/             # 构建产物（npm 发布内容）
+│   ├── index.js      # CJS 格式
+│   ├── index.esm.js  # ESM 格式
+│   └── index.d.ts    # TypeScript 类型声明
+├── package.json
+├── tsconfig.json
+└── rollup.config.js
+```
+
+## 开发构建
+
+```bash
+# 安装依赖
+npm install
+
+# 构建产物
+npm run build
+
+# 类型检查
+npm run typecheck
+```

package/config/knowledge.json

@@ -0,0 +1,41 @@
+{
+  "config": {
+    "type": "STRUCTURED",
+    "topK": 5,
+    "scoreThreshold": 0.5,
+    "updateMode": "UPSERT",
+    "pageSize": 10
+  },
+  "tools": [
+    "list",
+    "retrieve",
+    "create",
+    "update"
+  ],
+  "knowledges": {
+    "产品数据": {
+      "datasetId": "",
+      "documentId": "",
+      "config": {
+        "topK": 10,
+        "scoreThreshold": 0.7
+      },
+      "tableSchema": {
+        "name": "产品表",
+        "description": "产品基础信息",
+        "columns": []
+      },
+      "indexColumns": []
+    },
+    "FAQ": {
+      "datasetId": "",
+      "documentId": "",
+      "tableSchema": {
+        "name": "FAQ表",
+        "description": "常见问题",
+        "columns": []
+      },
+      "indexColumns": []
+    }
+  }
+}

package/dist/amap.d.ts

@@ -0,0 +1,373 @@
+/**
+ * 高德地图 SDK - AmapClient 核心类
+ *
+ * 封装高德地图天气查询工具（amap_weather），
+ * 通过百宝箱插件服务 /openapi/v1/plugin/run/{pluginToolId} 接口调用。
+ */
+import type { AmapClientConfig, AmapConvertRequest, AmapConvertResponse, AmapCyclingRouteRequest, AmapCyclingRouteResponse, AmapDistrictRequest, AmapDistrictResponse, AmapDrivingRouteRequest, AmapDrivingRouteResponse, AmapEbikeRouteRequest, AmapEbikeRouteResponse, AmapGeocodeRequest, AmapGeocodeResponse, AmapIpLocationRequest, AmapIpLocationResponse, AmapPeripheralSearchRequest, AmapPeripheralSearchResponse, AmapPoiSearchRequest, AmapPoiSearchResponse, AmapRegeocodeRequest, AmapRegeocodeResponse, AmapTransitRouteRequest, AmapTransitRouteResponse, AmapWalkingRouteRequest, AmapWalkingRouteResponse, AmapWeatherRequest, AmapWeatherResponse, SdkResponse } from './types';
+/**
+ * 高德地图客户端
+ *
+ * @example
+ * ```ts
+ * import { AmapClient } from '@tbox/plugin-sdk';
+ *
+ * const client = new AmapClient({ apiKey: 'your-api-key' });
+ *
+ * // 查询实况天气
+ * const res = await client.weather({ city: '杭州市' });
+ * if (res.success) {
+ *   console.log(res.data?.lives?.[0]?.weather);
+ * }
+ *
+ * // 查询预报天气
+ * const forecast = await client.weather({ city: '上海市', extensions: 'all' });
+ * if (forecast.success) {
+ *   console.log(forecast.data?.forecasts?.[0]?.casts);
+ * }
+ * ```
+ */
+export declare class AmapClient {
+    private readonly http;
+    /** 高德天气查询工具的固定工具 ID */
+    private static readonly AMAP_WEATHER_TOOL_ID;
+    /** 高德地址转经纬度工具的固定工具 ID */
+    private static readonly AMAP_GEOCODE_TOOL_ID;
+    /** 高德骑行路线规划工具的固定工具 ID */
+    private static readonly AMAP_CYCLING_ROUTE_TOOL_ID;
+    /** 高德 IP 定位工具的固定工具 ID */
+    private static readonly AMAP_IP_LOCATION_TOOL_ID;
+    /** 高德周边搜索工具的固定工具 ID */
+    private static readonly AMAP_PERIPHERAL_SEARCH_TOOL_ID;
+    /** 高德步行路线规划工具的固定工具 ID */
+    private static readonly AMAP_WALKING_ROUTE_TOOL_ID;
+    /** 高德驾车路线规划工具的固定工具 ID */
+    private static readonly AMAP_DRIVING_ROUTE_TOOL_ID;
+    /** 高德电动车路线规划工具的固定工具 ID */
+    private static readonly AMAP_EBIKE_ROUTE_TOOL_ID;
+    /** 高德公交路线规划工具的固定工具 ID */
+    private static readonly AMAP_TRANSIT_ROUTE_TOOL_ID;
+    /** 高德行政区域查询工具的固定工具 ID */
+    private static readonly AMAP_DISTRICT_TOOL_ID;
+    /** 高德经纬度转地址工具的固定工具 ID */
+    private static readonly AMAP_REGEOCODE_TOOL_ID;
+    /** 高德坐标转换工具的固定工具 ID */
+    private static readonly AMAP_CONVERT_TOOL_ID;
+    /** 高德 POI 关键字搜索工具的固定工具 ID */
+    private static readonly AMAP_POI_SEARCH_TOOL_ID;
+    constructor(config: AmapClientConfig);
+    /**
+     * 查询天气（实况或预报）
+     *
+     * 内部调用 run('20240627231800002183', ...) 实现，对外屏蔽工具 ID 细节。
+     * 数据来源于中国气象局。
+     *
+     * @param request - 天气查询请求
+     *   - `city`（必填）：省份名、市名、区/县/镇、乡/村或具体地点
+     *   - `extensions`（可选）：`base`（实况，默认）或 `all`（预报）
+     * @returns 天气查询结果
+     *   - `extensions=base` 时，`data.lives` 包含实况天气数据
+     *   - `extensions=all` 时，`data.forecasts` 包含逐日预报数据
+     *
+     * @example
+     * ```ts
+     * // 查询实况天气
+     * const live = await client.weather({ city: '西湖区' });
+     * if (live.success) {
+     *   const w = live.data?.lives?.[0];
+     *   console.log(`${w?.city} ${w?.weather} ${w?.temperature}℃`);
+     * }
+     *
+     * // 查询未来几天预报
+     * const forecast = await client.weather({ city: '北京市', extensions: 'all' });
+     * if (forecast.success) {
+     *   for (const cast of forecast.data?.forecasts?.[0]?.casts ?? []) {
+     *     console.log(`${cast.date} 白天：${cast.dayweather} 夜间：${cast.nightweather}`);
+     *   }
+     * }
+     * ```
+     */
+    weather(request: AmapWeatherRequest): Promise<SdkResponse<AmapWeatherResponse>>;
+    /**
+     * 地址转经纬度（地理编码）
+     *
+     * 将详细的地名，转换为经纬度坐标。
+     * 内部调用 run('20240627233200002185', ...) 实现，对外屏蔽工具 ID 细节。
+     *
+     * @param request - 地址转经纬度请求
+     *   - `address`（必填）：详细地址信息（国家、省份、城市、区县、城镇、乡村、街道、门牌号）
+     *   - `city`（可选）：查询的城市，指定可提高查询精度
+     * @returns 地理编码结果
+     *   - `data.geocodes` 包含地理编码信息列表
+     *
+     * @example
+     * ```ts
+     * // 地址转经纬度
+     * const res = await client.geocode({ address: '北京市朝阳区阜通东大街6号', city: '北京' });
+     * if (res.success) {
+     *   const geo = res.data?.geocodes?.[0];
+     *   console.log(`地址: ${geo?.formatted_address}`);
+     *   console.log(`经纬度: ${geo?.location}`);
+     *   console.log(`区域编码: ${geo?.adcode}`);
+     * }
+     * ```
+     */
+    geocode(request: AmapGeocodeRequest): Promise<SdkResponse<AmapGeocodeResponse>>;
+    /**
+     * 骑行路线规划
+     *
+     * 提供起点和终点的位置，返回骑行路线，支持多条路线。
+     *
+     * @param request - 骑行路线规划请求
+     *   - `origin`（必填）：起点位置名称
+     *   - `destination`（必填）：终点位置名称
+     * @returns 骑行路线规划结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.cyclingRoute({
+     *   origin: '杭州市西湖区',
+     *   destination: '杭州市余杭区'
+     * });
+     * if (res.success) {
+     *   const path = res.data?.route?.paths?.[0];
+     *   console.log(`距离: ${path?.distance}米, 时间: ${path?.duration}秒`);
+     * }
+     * ```
+     */
+    cyclingRoute(request: AmapCyclingRouteRequest): Promise<SdkResponse<AmapCyclingRouteResponse>>;
+    /**
+     * IP 定位
+     *
+     * 定位输入的 IP 所在的地理位置（暂不支持 IPv6）。
+     *
+     * @param request - IP 定位请求
+     *   - `ip`（必填）：需要定位的 IP 地址
+     * @returns IP 定位结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.ipLocation({ ip: '114.114.114.114' });
+     * if (res.success) {
+     *   console.log(`省份: ${res.data?.province}, 城市: ${res.data?.city}`);
+     * }
+     * ```
+     */
+    ipLocation(request: AmapIpLocationRequest): Promise<SdkResponse<AmapIpLocationResponse>>;
+    /**
+     * 周边搜索
+     *
+     * 根据指定地点和关键词，搜索周边景点、美食、酒店、运动场所等。
+     *
+     * @param request - 周边搜索请求
+     *   - `address`（必填）：中心点地址信息
+     *   - `keyword`（必填）：检索关键词（景点、美食、游玩区域等，不超过 80 字符）
+     *   - `count`（可选）：返回条数，默认 5
+     *   - `radius`（可选）：搜索半径（米），范围 0-50000
+     * @returns 周边搜索结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.peripheralSearch({
+     *   address: '杭州市西湖区',
+     *   keyword: '美食',
+     *   count: 10,
+     *   radius: 1000
+     * });
+     * if (res.success) {
+     *   for (const poi of res.data?.pois ?? []) {
+     *     console.log(`${poi.name} - ${poi.address}`);
+     *   }
+     * }
+     * ```
+     */
+    peripheralSearch(request: AmapPeripheralSearchRequest): Promise<SdkResponse<AmapPeripheralSearchResponse>>;
+    /**
+     * 步行路线规划
+     *
+     * 提供起点和终点的位置，返回步行路线，支持多条路线。
+     *
+     * @param request - 步行路线规划请求
+     *   - `origin`（必填）：起点地址
+     *   - `destination`（必填）：终点地址
+     * @returns 步行路线规划结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.walkingRoute({
+     *   origin: '杭州市西湖区古荡',
+     *   destination: '杭州市西湖区西溪湿地'
+     * });
+     * if (res.success) {
+     *   const path = res.data?.route?.paths?.[0];
+     *   console.log(`距离: ${path?.distance}米, 时间: ${path?.duration}秒`);
+     * }
+     * ```
+     */
+    walkingRoute(request: AmapWalkingRouteRequest): Promise<SdkResponse<AmapWalkingRouteResponse>>;
+    /**
+     * 驾车路线规划
+     *
+     * 提供起点和终点的位置，返回驾车路线，支持多条路线。
+     *
+     * @param request - 驾车路线规划请求
+     *   - `origin`（必填）：起点地址或经纬度
+     *   - `destination`（必填）：终点地址或经纬度
+     * @returns 驾车路线规划结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.drivingRoute({
+     *   origin: '杭州西溪湿地',
+     *   destination: '绍兴市'
+     * });
+     * if (res.success) {
+     *   const path = res.data?.route?.paths?.[0];
+     *   console.log(`距离: ${path?.distance}米, 时间: ${path?.duration}秒`);
+     *   console.log(`出租车费用: ${res.data?.route?.taxi_cost}元`);
+     * }
+     * ```
+     */
+    drivingRoute(request: AmapDrivingRouteRequest): Promise<SdkResponse<AmapDrivingRouteResponse>>;
+    /**
+     * 电动车路线规划
+     *
+     * 提供起点和终点的位置，返回电动车骑行路线，支持多条路线。
+     *
+     * @param request - 电动车路线规划请求
+     *   - `origin`（必填）：起点地址或经纬度
+     *   - `destination`（必填）：终点地址或经纬度
+     * @returns 电动车路线规划结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.ebikeRoute({
+     *   origin: '杭州市西湖区',
+     *   destination: '杭州市余杭区'
+     * });
+     * if (res.success) {
+     *   const path = res.data?.route?.paths?.[0];
+     *   console.log(`距离: ${path?.distance}米, 时间: ${path?.duration}秒`);
+     * }
+     * ```
+     */
+    ebikeRoute(request: AmapEbikeRouteRequest): Promise<SdkResponse<AmapEbikeRouteResponse>>;
+    /**
+     * 公交路线规划
+     *
+     * 提供起点和终点的位置，返回公交换乘方案，支持多条路线。
+     *
+     * @param request - 公交路线规划请求
+     *   - `origin`（必填）：起点地址或经纬度
+     *   - `destination`（必填）：终点地址或经纬度
+     * @returns 公交路线规划结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.transitRoute({
+     *   origin: '杭州火车站',
+     *   destination: '西湖'
+     * });
+     * if (res.success) {
+     *   for (const transit of res.data?.route?.transits ?? []) {
+     *     console.log(`费用: ${transit.cost}元, 时间: ${transit.duration}秒`);
+     *   }
+     * }
+     * ```
+     */
+    transitRoute(request: AmapTransitRouteRequest): Promise<SdkResponse<AmapTransitRouteResponse>>;
+    /**
+     * 行政区域查询
+     *
+     * 根据用户输入，快速查找特定的行政区域信息。
+     *
+     * @param request - 行政区域查询请求
+     *   - `keywords`（必填）：查询关键字（行政区名称、citycode、adcode）
+     * @returns 行政区域查询结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.district({ keywords: '成都市' });
+     * if (res.success) {
+     *   for (const district of res.data?.districts ?? []) {
+     *     console.log(`${district.name} (${district.adcode})`);
+     *   }
+     * }
+     * ```
+     */
+    district(request: AmapDistrictRequest): Promise<SdkResponse<AmapDistrictResponse>>;
+    /**
+     * 经纬度转地址（逆地理编码）
+     *
+     * 将经纬度转换为详细的地址，且返回附近周边的 POI、AOI 信息。
+     *
+     * @param request - 经纬度转地址请求
+     *   - `location`（必填）：经纬度坐标（经度在前，纬度在后，英文逗号分隔）
+     *   - `extensions`（可选）：base（基本地址）/ all（详细信息）
+     * @returns 逆地理编码结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.regeocode({
+     *   location: '116.480881,39.989410',
+     *   extensions: 'base'
+     * });
+     * if (res.success) {
+     *   console.log(`地址: ${res.data?.regeocode?.formatted_address}`);
+     * }
+     * ```
+     */
+    regeocode(request: AmapRegeocodeRequest): Promise<SdkResponse<AmapRegeocodeResponse>>;
+    /**
+     * 坐标转换
+     *
+     * 将非高德坐标（GPS、mapbar、baidu 坐标）转换成高德坐标。
+     *
+     * @param request - 坐标转换请求
+     *   - `locations`（必填）：坐标点（经纬度用逗号分隔，多个坐标用 "|" 分隔，最多 40 个）
+     *   - `coordsys`（必填）：原坐标系（gps / mapbar / baidu / autonavi）
+     * @returns 坐标转换结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.convert({
+     *   locations: '116.481488,39.990464',
+     *   coordsys: 'baidu'
+     * });
+     * if (res.success) {
+     *   console.log(`转换后的坐标: ${res.data?.locations}`);
+     * }
+     * ```
+     */
+    convert(request: AmapConvertRequest): Promise<SdkResponse<AmapConvertResponse>>;
+    /**
+     * POI 关键字搜索
+     *
+     * 通过文本关键字搜索地点信息，支持结构化地址和 POI 名称搜索。
+     *
+     * @param request - POI 关键字搜索请求
+     *   - `keywords`（可选）：查询关键字
+     *   - `types`（可选）：指定地点类型
+     *   - `region`（可选）：搜索区划（默认全国）
+     *   - `city_limit`（可选）：是否限制在 region 内（true / false）
+     *   - `page_size`（可选）：每页数据条数（1-25）
+     *   - `page_num`（可选）：分页页码（1-100）
+     * @returns POI 搜索结果
+     *
+     * @example
+     * ```ts
+     * const res = await client.poiSearch({
+     *   keywords: '首开广场',
+     *   region: '北京',
+     *   page_size: '10',
+     *   page_num: '1'
+     * });
+     * if (res.success) {
+     *   for (const poi of res.data?.pois ?? []) {
+     *     console.log(`${poi.name} - ${poi.address}`);
+     *   }
+     * }
+     * ```
+     */
+    poiSearch(request: AmapPoiSearchRequest): Promise<SdkResponse<AmapPoiSearchResponse>>;
+}

package/dist/app.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 百宝箱插件服务 SDK - 应用服务客户端
+ *
+ * 封装 /openapi/v1/app 下的接口
+ */
+import type { SdkResponse, AppGenerateSessionRequest, AppSessionResult, TboxPluginClientConfig } from './types';
+/**
+ * 百宝箱应用服务客户端
+ *
+ * @example
+ * ```ts
+ * const client = new TboxAppClient({ apiKey: 'your-api-key' });
+ *
+ * // 生成 sessionId，用于免登录访问百宝箱应用
+ * const result = await client.generateSession({
+ *   appId: 'your-app-id',
+ *   userId: 'user-123',
+ *   userInfo: [
+ *     { infoType: 'name', infoValue: '张三' },
+ *   ],
+ *   deviceInfo: {
+ *     platform: 'IOS',
+ *     appVersion: '1.0.0',
+ *   },
+ * });
+ *
+ * if (result.success) {
+ *   console.log('sessionId:', result.data?.sessionId);
+ *   console.log('channel:', result.data?.channel);
+ * }
+ * ```
+ */
+export declare class TboxAppClient {
+    private readonly http;
+    constructor(config: TboxPluginClientConfig);
+    /**
+     * 根据用户信息生成 sessionId 和 channel
+     *
+     * 接口：POST /openapi/v1/app/generate_session
+     *
+     * 生成的 sessionId 可用于拼接百宝箱 H5 访问链接，实现免登录跳转。
+     *
+     * @param request 请求参数，appId 和 userId 为必填
+     * @returns sessionId 和 channel
+     */
+    generateSession(request: AppGenerateSessionRequest): Promise<SdkResponse<AppSessionResult>>;
+}

package/dist/constant.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @tbox/sdk — 常量定义
+ */
+/** 默认 API 基础 URL */
+export declare const TBOX_BASE_URL = "https://o.tbox.cn";
+/** SDK 版本号 */
+export declare const SDK_VERSION = "1.0.0";
+/** SDK 版本标识 header key */
+export declare const SDK_VERSION_HEADER = "X-Tbox-SDK-Version";