@acosmi/sdk-ts 2.2.1 → 2.4.0

package/dist/node/index.d.cts

@@ -638,6 +638,23 @@ interface Config {
      * `client.compliance.*`，不与既有模型网关 API 冲突。
      */
     complianceBaseURL?: string;
+    /**
+     * `/api/v4` 网关调用 (managed-model / agent-run / casehall 等) 的 base 覆盖。
+     *
+     * 未配置时默认 = `serverURL`（既有行为，所有既有消费方不受影响）。
+     *
+     * 用途：浏览器部署在**非网关同源**域名（如 sign.zhonglvbao.com）时，网关
+     * acosmi.com 对带 `Origin` 头的跨域浏览器请求返 403（CORS 收紧）。把本字段设为
+     * 同源代理 base（如 `window.location.origin`）、并在该域名 nginx 加
+     * `location /api/v4/ { proxy_pass https://acosmi.com/api/v4/; proxy_set_header Origin ""; }`
+     * 服务端转发，即可让浏览器侧 casehall / 网关调用走同源 → nginx 服务端转发 →
+     * 规避跨域 403。仅设在**浏览器端** client；服务端 (Route Handler) client 不设本字段，
+     * 直连 `serverURL` 即可（服务端到 acosmi.com 无跨域）。
+     *
+     * 与 `complianceBaseURL` 同构（compliance 走 `/admin-api`，本字段走 `/api/v4`）。
+     * apiURL() 仍按需追加 `/api/v4`，调用方无需手动拼。
+     */
+    apiBaseURL?: string;
     /**
      * OAuth metadata profile — 决定 `ensureToken` 刷新 token 时
      * 发现 metadata 走哪个 well-known 端点。
@@ -693,6 +710,8 @@ declare class Client {
     serverURL: string;
     /** Compliance API 根地址 (已 trim 尾随 /); null = 走默认 ${serverURL}/admin-api */
     complianceBaseURL: string | null;
+    /** `/api/v4` 网关调用 base 覆盖 (已 trim 尾随 /); null = 走默认 serverURL */
+    apiBaseURL: string | null;
     /** OAuth metadata profile — 刷新 token 时发现 metadata 用 (默认 'desktop') */
     oauthMetadataProfile: OAuthMetadataProfile;
     /** Browser Web OAuth refresh strategy (default 'direct') */
@@ -1701,7 +1720,8 @@ interface SkillStoreItem {
     scope: string;
     status: string;
     downloadCount: number;
-    readme: string;
+    readme?: string;
+    skillMd?: string;
     tags: string[];
     author: string;
     publisherId: string;

package/dist/node/index.d.ts

@@ -638,6 +638,23 @@ interface Config {
      * `client.compliance.*`，不与既有模型网关 API 冲突。
      */
     complianceBaseURL?: string;
+    /**
+     * `/api/v4` 网关调用 (managed-model / agent-run / casehall 等) 的 base 覆盖。
+     *
+     * 未配置时默认 = `serverURL`（既有行为，所有既有消费方不受影响）。
+     *
+     * 用途：浏览器部署在**非网关同源**域名（如 sign.zhonglvbao.com）时，网关
+     * acosmi.com 对带 `Origin` 头的跨域浏览器请求返 403（CORS 收紧）。把本字段设为
+     * 同源代理 base（如 `window.location.origin`）、并在该域名 nginx 加
+     * `location /api/v4/ { proxy_pass https://acosmi.com/api/v4/; proxy_set_header Origin ""; }`
+     * 服务端转发，即可让浏览器侧 casehall / 网关调用走同源 → nginx 服务端转发 →
+     * 规避跨域 403。仅设在**浏览器端** client；服务端 (Route Handler) client 不设本字段，
+     * 直连 `serverURL` 即可（服务端到 acosmi.com 无跨域）。
+     *
+     * 与 `complianceBaseURL` 同构（compliance 走 `/admin-api`，本字段走 `/api/v4`）。
+     * apiURL() 仍按需追加 `/api/v4`，调用方无需手动拼。
+     */
+    apiBaseURL?: string;
     /**
      * OAuth metadata profile — 决定 `ensureToken` 刷新 token 时
      * 发现 metadata 走哪个 well-known 端点。
@@ -693,6 +710,8 @@ declare class Client {
     serverURL: string;
     /** Compliance API 根地址 (已 trim 尾随 /); null = 走默认 ${serverURL}/admin-api */
     complianceBaseURL: string | null;
+    /** `/api/v4` 网关调用 base 覆盖 (已 trim 尾随 /); null = 走默认 serverURL */
+    apiBaseURL: string | null;
     /** OAuth metadata profile — 刷新 token 时发现 metadata 用 (默认 'desktop') */
     oauthMetadataProfile: OAuthMetadataProfile;
     /** Browser Web OAuth refresh strategy (default 'direct') */
@@ -1701,7 +1720,8 @@ interface SkillStoreItem {
     scope: string;
     status: string;
     downloadCount: number;
-    readme: string;
+    readme?: string;
+    skillMd?: string;
     tags: string[];
     author: string;
     publisherId: string;

package/dist/node/index.mjs

@@ -2079,6 +2079,8 @@ var Client = class _Client {
   serverURL;
   /** Compliance API 根地址 (已 trim 尾随 /); null = 走默认 ${serverURL}/admin-api */
   complianceBaseURL;
+  /** `/api/v4` 网关调用 base 覆盖 (已 trim 尾随 /); null = 走默认 serverURL */
+  apiBaseURL;
   /** OAuth metadata profile — 刷新 token 时发现 metadata 用 (默认 'desktop') */
   oauthMetadataProfile;
   /** Browser Web OAuth refresh strategy (default 'direct') */
@@ -2120,6 +2122,7 @@ var Client = class _Client {
     const picked = pickAndNormalizeGatewayURL(cfg);
     this.serverURL = picked ?? DEFAULT_GATEWAY_BASE_URL;
     this.complianceBaseURL = cfg.complianceBaseURL ? cfg.complianceBaseURL.replace(/\/+$/, "") : null;
+    this.apiBaseURL = cfg.apiBaseURL ? cfg.apiBaseURL.replace(/\/+$/, "") : null;
     this.oauthMetadataProfile = cfg.oauthMetadataProfile ?? "desktop";
     this.browserRefreshMode = cfg.browserRefreshMode ?? "direct";
     this.refreshProxyURL = cfg.refreshProxyURL ?? null;
@@ -3046,7 +3049,7 @@ var Client = class _Client {
   // Internal HTTP
   // ===========================================================================
   apiURL(path) {
-    let base = this.serverURL;
+    let base = this.apiBaseURL ?? this.serverURL;
     if (!base.endsWith("/api/v4")) {
       base += "/api/v4";
     }