@qjp88995/provider-client 0.0.0-stage → 0.1.0

package/dist/center-fetch.d.ts

@@ -0,0 +1,29 @@
+import type { VendorFetch } from './vendors/index.js';
+export interface CenterFetchOptions {
+    /** 中心的根地址，如 `https://provider.example.com`。 */
+    centerUrl: string;
+    /** 接入方 API key（`pc_…`）。 */
+    apiKey: string;
+    /** 厂商 slug（透传路由段）。 */
+    vendor: string;
+    /**
+     * 这家所有端点的 baseUrl。只改写落在这些 origin 上的请求；别的 origin 直接报错——那是适配器拼错了地址，
+     * 悄悄发出去就是带着中心的 key 打到别处。
+     */
+    baseUrls: readonly string[];
+    /** 会话粘性键（`x-pc-affinity`）。 */
+    affinity?: string;
+    /** 钉住某把 key（`x-pc-pin`）。 */
+    pin?: string;
+    /** 每次响应回来时告诉调用方实际用的是哪把 key（`x-pc-credential`）。 */
+    onCredential?: (ref: string) => void;
+    /** 发往中心用的 fetch；默认全局 fetch。 */
+    fetch?: VendorFetch;
+}
+/**
+ * 中心模式的出站 fetch，交给适配器的 `CreateModelInput.fetch`：把厂商 URL 的 origin 换成
+ * `<中心>/v1/proxy/<slug>`（pathname 与查询串原样），剥掉厂商鉴权头，加上 `x-pc-key` 与粘性 / pin 头。
+ * 适配器本身一个字不改——这就是「厂商的每一条出站请求都走 `CreateModelInput.fetch`」那条红线的用处。
+ */
+export declare function createCenterFetch(options: CenterFetchOptions): VendorFetch;
+//# sourceMappingURL=center-fetch.d.ts.map

package/dist/center-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"center-fetch.d.ts","sourceRoot":"","sources":["../src/center-fetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAUtD,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CA8B1E"}

package/dist/center-fetch.js

@@ -0,0 +1,45 @@
+import { PC_HEADERS, PROXY_ROUTE_PREFIX } from './types.js';
+/** 厂商 SDK 可能放厂商 key 的头。中心反正会剥，这里先剥掉：假 key 不出本进程。 */
+const VENDOR_AUTH_HEADERS = [
+    'authorization',
+    'x-goog-api-key',
+    'x-api-key',
+    'api-key',
+];
+/**
+ * 中心模式的出站 fetch，交给适配器的 `CreateModelInput.fetch`：把厂商 URL 的 origin 换成
+ * `<中心>/v1/proxy/<slug>`（pathname 与查询串原样），剥掉厂商鉴权头，加上 `x-pc-key` 与粘性 / pin 头。
+ * 适配器本身一个字不改——这就是「厂商的每一条出站请求都走 `CreateModelInput.fetch`」那条红线的用处。
+ */
+export function createCenterFetch(options) {
+    const center = options.centerUrl.replace(/\/+$/, '');
+    const prefix = `${center}${PROXY_ROUTE_PREFIX}/${encodeURIComponent(options.vendor)}`;
+    const origins = new Set(options.baseUrls.map(u => new URL(u).origin));
+    const send = options.fetch ?? globalThis.fetch;
+    return async (input, init) => {
+        const request = input instanceof Request ? input : null;
+        const url = new URL(request ? request.url : input.toString());
+        if (!origins.has(url.origin)) {
+            throw new Error(`refusing to route ${url.origin} through the provider center: not an endpoint of vendor "${options.vendor}"`);
+        }
+        const headers = new Headers(request?.headers);
+        new Headers(init?.headers).forEach((v, k) => headers.set(k, v));
+        for (const h of VENDOR_AUTH_HEADERS)
+            headers.delete(h);
+        url.searchParams.delete('key');
+        headers.set(PC_HEADERS.key, options.apiKey);
+        if (options.affinity)
+            headers.set(PC_HEADERS.affinity, options.affinity);
+        if (options.pin)
+            headers.set(PC_HEADERS.pin, options.pin);
+        const target = `${prefix}${url.pathname}${url.search}`;
+        const res = request
+            ? await send(new Request(target, request), { ...init, headers })
+            : await send(target, { ...init, headers });
+        const ref = res.headers.get(PC_HEADERS.credential);
+        if (ref)
+            options.onCredential?.(ref);
+        return res;
+    };
+}
+//# sourceMappingURL=center-fetch.js.map

package/dist/center-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"center-fetch.js","sourceRoot":"","sources":["../src/center-fetch.ts"],"names":[],"mappings":"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"}

package/dist/direct-resolver.d.ts

@@ -0,0 +1,29 @@
+import { type ModelHandle, type ModelRef, type ModelResolver, type ResolveOptions } from './model-handle.js';
+import type { CatalogEndpoint, CatalogModel, LlmCapability, VendorKind } from './types.js';
+import type { VendorFetch } from './vendors/index.js';
+/** 直连模式下的一家厂商：目录条目的形状，外加厂商 key。 */
+export interface DirectVendor {
+    slug: string;
+    /** 显示名，默认 = slug。 */
+    name?: string;
+    kind: VendorKind;
+    /** 厂商的 API key。 */
+    apiKey: string;
+    endpoints: CatalogEndpoint[];
+    /** 只写 `modelId` 与 `protocols` 也行，其余取默认（无能力、无上限、无单价）。 */
+    models: DirectModel[];
+    /** 出站 fetch（网络代理）；默认全局 fetch。 */
+    fetch?: VendorFetch;
+}
+export type DirectModel = Pick<CatalogModel, 'modelId' | 'protocols'> & Partial<Omit<CatalogModel, 'modelId' | 'protocols'>>;
+/**
+ * 直连模式：不经中心，拿厂商 key 直接调。给本地开发、测试与没有中心的环境；与 `ProviderClient` 同一个
+ * `ModelResolver` 接口、同一套适配器，换模式不改调用方。没有 key 池、没有故障切换。
+ */
+export declare class DirectModelResolver implements ModelResolver {
+    private readonly vendors;
+    constructor(vendors: readonly DirectVendor[]);
+    resolve(ref: ModelRef, options?: ResolveOptions): Promise<ModelHandle>;
+    capabilitiesOf(ref: ModelRef): Promise<LlmCapability[]>;
+}
+//# sourceMappingURL=direct-resolver.d.ts.map

package/dist/direct-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-resolver.d.ts","sourceRoot":"","sources":["../src/direct-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAEZ,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,wDAAwD;IACxD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,iCAAiC;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,WAAW,CAAC,GACnE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC;AAEvD;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGnB;gBAEO,OAAO,EAAE,SAAS,YAAY,EAAE;IAqBtC,OAAO,CACX,GAAG,EAAE,QAAQ,EACb,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC;IAcvB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAMxD"}

package/dist/direct-resolver.js

@@ -0,0 +1,47 @@
+import { buildHandle, findModel, } from './model-handle.js';
+/**
+ * 直连模式：不经中心，拿厂商 key 直接调。给本地开发、测试与没有中心的环境；与 `ProviderClient` 同一个
+ * `ModelResolver` 接口、同一套适配器，换模式不改调用方。没有 key 池、没有故障切换。
+ */
+export class DirectModelResolver {
+    vendors;
+    constructor(vendors) {
+        this.vendors = vendors.map(v => ({
+            slug: v.slug,
+            name: v.name ?? v.slug,
+            kind: v.kind,
+            apiKey: v.apiKey,
+            fetch: v.fetch,
+            endpoints: v.endpoints,
+            models: v.models.map(m => ({
+                displayName: m.modelId,
+                capabilities: [],
+                maxContextTokens: null,
+                maxOutputTokens: null,
+                pricing: null,
+                ...m,
+            })),
+        }));
+    }
+    // async：找不到厂商 / 模型时以 rejected promise 报出，与中心模式一致。
+    async resolve(ref, options = {}) {
+        findModel(this.vendors, ref);
+        const vendor = this.vendors.find(v => v.slug === ref.vendor);
+        const model = vendor.models.find(m => m.modelId === ref.modelId);
+        return buildHandle({
+            ref,
+            vendor,
+            model,
+            apiKey: vendor.apiKey,
+            fetchFor: () => vendor.fetch,
+            reasoningEffort: options.reasoningEffort,
+        });
+    }
+    capabilitiesOf(ref) {
+        const model = this.vendors
+            .find(v => v.slug === ref.vendor)
+            ?.models.find(m => m.modelId === ref.modelId);
+        return Promise.resolve(model ? [...model.capabilities] : []);
+    }
+}
+//# sourceMappingURL=direct-resolver.js.map

package/dist/direct-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-resolver.js","sourceRoot":"","sources":["../src/direct-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,SAAS,GAKV,MAAM,mBAAmB,CAAC;AA4B3B;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACb,OAAO,CAGnB;IAEL,YAAY,OAAgC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI;YACtB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACzB,WAAW,EAAE,CAAC,CAAC,OAAO;gBACtB,YAAY,EAAE,EAAE;gBAChB,gBAAgB,EAAE,IAAI;gBACtB,eAAe,EAAE,IAAI;gBACrB,OAAO,EAAE,IAAI;gBACb,GAAG,CAAC;aACL,CAAC,CAAC;SACJ,CAAC,CAAC,CAAC;IACN,CAAC;IAED,kDAAkD;IAElD,KAAK,CAAC,OAAO,CACX,GAAa,EACb,UAA0B,EAAE;QAE5B,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,CAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,CAAE,CAAC;QAClE,OAAO,WAAW,CAAC;YACjB,GAAG;YACH,MAAM;YACN,KAAK;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK;YAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;SACzC,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,GAAa;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO;aACvB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC;YACjC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,38 @@
+import { type CenterErrorCode } from './types.js';
+/**
+ * - 中心的错误码（`CenterErrorCode`），如 `unauthorized`（key 不对或已吊销）、`vendor_not_allowed`、
+ *   `no_credential`（池里没有可用的 key）、`pinned_credential_unavailable`。
+ * - `unknown_vendor` / `unknown_model`：目录里没有（或这个接入方看不到）这家 / 这个模型。
+ * - `protocol_unavailable`：模型声明的协议里，没有一个是这家有端点且适配器已实现的。
+ * - `unsupported_vendor_kind`：这个版本的 client 没有该厂商类型的适配器（中心比 client 新）。
+ * - `network`：连不上中心（`cause` 里是原始错误）。
+ * - `unexpected`：回了不认识的东西（非 JSON 的错误页、不认识的错误码……），`status` 照填。
+ */
+export type ProviderClientErrorCode = CenterErrorCode | 'unknown_vendor' | 'unknown_model' | 'protocol_unavailable' | 'unsupported_vendor_kind' | 'network' | 'unexpected';
+export declare class ProviderClientError extends Error {
+    readonly code: ProviderClientErrorCode;
+    /** HTTP 状态码；不是 HTTP 层的错误（或没拿到响应）时为 null。 */
+    readonly status: number | null;
+    readonly name: string;
+    constructor(code: ProviderClientErrorCode, message: string, 
+    /** HTTP 状态码；不是 HTTP 层的错误（或没拿到响应）时为 null。 */
+    status: number | null, options?: {
+        cause?: unknown;
+    });
+}
+/** 模型声明的协议与这家可用的端点 / 适配器没有交集。不静默退回某个协议。 */
+export declare class ProtocolUnavailableError extends ProviderClientError {
+    readonly modelId: string;
+    readonly protocols: readonly string[];
+    readonly vendorKind: string;
+    readonly name = "ProtocolUnavailableError";
+    constructor(modelId: string, protocols: readonly string[], vendorKind: string);
+}
+/** 从中心的错误响应体（`{ code, message }`）认出错误码；认不出给 null。 */
+export declare function parseCenterError(body: unknown): {
+    code: CenterErrorCode;
+    message: string;
+} | null;
+/** 把中心的一个非 2xx 响应变成错误。会读掉响应体。 */
+export declare function errorFromResponse(res: Response): Promise<ProviderClientError>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAC/B,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,sBAAsB,GACtB,yBAAyB,GACzB,SAAS,GACT,YAAY,CAAC;AAEjB,qBAAa,mBAAoB,SAAQ,KAAK;IAI1C,QAAQ,CAAC,IAAI,EAAE,uBAAuB;IAEtC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IANhC,SAAkB,IAAI,EAAE,MAAM,CAAyB;gBAG5C,IAAI,EAAE,uBAAuB,EACtC,OAAO,EAAE,MAAM;IACf,4CAA4C;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIhC;AAED,2CAA2C;AAC3C,qBAAa,wBAAyB,SAAQ,mBAAmB;IAI7D,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM;IAL7B,SAAkB,IAAI,8BAA8B;gBAGzC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,UAAU,EAAE,MAAM;CAQ9B;AAID,qDAAqD;AACrD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,GACZ;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQnD;AAED,iCAAiC;AACjC,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,mBAAmB,CAAC,CAkB9B"}

package/dist/errors.js

@@ -0,0 +1,57 @@
+import { CENTER_ERROR_CODES } from './types.js';
+export class ProviderClientError extends Error {
+    code;
+    status;
+    name = 'ProviderClientError';
+    constructor(code, message, 
+    /** HTTP 状态码；不是 HTTP 层的错误（或没拿到响应）时为 null。 */
+    status, options) {
+        super(message, options);
+        this.code = code;
+        this.status = status;
+    }
+}
+/** 模型声明的协议与这家可用的端点 / 适配器没有交集。不静默退回某个协议。 */
+export class ProtocolUnavailableError extends ProviderClientError {
+    modelId;
+    protocols;
+    vendorKind;
+    name = 'ProtocolUnavailableError';
+    constructor(modelId, protocols, vendorKind) {
+        super('protocol_unavailable', `Model "${modelId}" declares protocols [${protocols.join(', ')}] but vendor "${vendorKind}" has no usable endpoint for any of them`, null);
+        this.modelId = modelId;
+        this.protocols = protocols;
+        this.vendorKind = vendorKind;
+    }
+}
+const KNOWN = new Set(CENTER_ERROR_CODES);
+/** 从中心的错误响应体（`{ code, message }`）认出错误码；认不出给 null。 */
+export function parseCenterError(body) {
+    if (!body || typeof body !== 'object')
+        return null;
+    const { code, message } = body;
+    if (typeof code !== 'string' || !KNOWN.has(code))
+        return null;
+    return {
+        code: code,
+        message: typeof message === 'string' ? message : code,
+    };
+}
+/** 把中心的一个非 2xx 响应变成错误。会读掉响应体。 */
+export async function errorFromResponse(res) {
+    const text = await res.text().catch(() => '');
+    let body = null;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        // 不是 JSON：落到 unexpected。
+    }
+    const known = parseCenterError(body);
+    if (known) {
+        return new ProviderClientError(known.code, known.message, res.status);
+    }
+    const snippet = text.slice(0, 200).trim();
+    return new ProviderClientError('unexpected', `provider center answered ${res.status}${snippet ? `: ${snippet}` : ''}`, res.status);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAwB,MAAM,YAAY,CAAC;AAoBtE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAIjC;IAGA;IANO,IAAI,GAAW,qBAAqB,CAAC;IAEvD,YACW,IAA6B,EACtC,OAAe;IACf,4CAA4C;IACnC,MAAqB,EAC9B,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QANf,SAAI,GAAJ,IAAI,CAAyB;QAG7B,WAAM,GAAN,MAAM,CAAe;IAIhC,CAAC;CACF;AAED,2CAA2C;AAC3C,MAAM,OAAO,wBAAyB,SAAQ,mBAAmB;IAIpD;IACA;IACA;IALO,IAAI,GAAG,0BAA0B,CAAC;IAEpD,YACW,OAAe,EACf,SAA4B,EAC5B,UAAkB;QAE3B,KAAK,CACH,sBAAsB,EACtB,UAAU,OAAO,yBAAyB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,UAAU,0CAA0C,EACnI,IAAI,CACL,CAAC;QARO,YAAO,GAAP,OAAO,CAAQ;QACf,cAAS,GAAT,SAAS,CAAmB;QAC5B,eAAU,GAAV,UAAU,CAAQ;IAO7B,CAAC;CACF;AAED,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,kBAAkB,CAAC,CAAC;AAElD,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAC9B,IAAa;IAEb,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAA6C,CAAC;IACxE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO;QACL,IAAI,EAAE,IAAuB;QAC7B,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;KACtD,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAa;IAEb,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,IAAI,GAAY,IAAI,CAAC;IACzB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;IACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,OAAO,IAAI,mBAAmB,CAC5B,YAAY,EACZ,4BAA4B,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACxE,GAAG,CAAC,MAAM,CACX,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { type CenterFetchOptions, createCenterFetch } from './center-fetch.js';
+export { type DirectModel, DirectModelResolver, type DirectVendor, } from './direct-resolver.js';
+export { ProtocolUnavailableError, ProviderClientError, type ProviderClientErrorCode, } from './errors.js';
+export { type ModelFileStore, type ModelHandle, type ModelRef, type ModelResolver, type ResolveOptions, type UploadedFile, } from './model-handle.js';
+export { ProviderClient, type ProviderClientOptions, } from './provider-client.js';
+export { toProviderClientError } from './to-error.js';
+export { type CatalogEndpoint, type CatalogModel, type CatalogResponse, type CatalogVendor, CENTER_ERROR_CODES, type CenterErrorCode, LLM_CAPABILITIES, LLM_PROTOCOLS, type LlmCapability, type LlmProtocol, type ModelPricing, PC_HEADERS, PROXY_ROUTE_PREFIX, REASONING_EFFORTS, type ReasoningEffort, VENDOR_KINDS, type VendorKind, } from './types.js';
+export { type AdviceModelView, findVendorAdapter, getVendorAdapter, LlmVendorAdapter, type ModelAdvice, type ProviderOptions, type SamplingParams, VENDOR_ADAPTERS, type VendorFetch, } from './vendors/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EACL,KAAK,WAAW,EAChB,mBAAmB,EACnB,KAAK,YAAY,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,eAAe,EACpB,gBAAgB,EAChB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,eAAe,EACpB,YAAY,EACZ,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,eAAe,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,eAAe,EACf,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { createCenterFetch } from './center-fetch.js';
+export { DirectModelResolver, } from './direct-resolver.js';
+export { ProtocolUnavailableError, ProviderClientError, } from './errors.js';
+export { ProviderClient, } from './provider-client.js';
+export { toProviderClientError } from './to-error.js';
+export { CENTER_ERROR_CODES, LLM_CAPABILITIES, LLM_PROTOCOLS, PC_HEADERS, PROXY_ROUTE_PREFIX, REASONING_EFFORTS, VENDOR_KINDS, } from './types.js';
+export { findVendorAdapter, getVendorAdapter, LlmVendorAdapter, VENDOR_ADAPTERS, } from './vendors/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAEL,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GAEpB,MAAM,aAAa,CAAC;AASrB,OAAO,EACL,cAAc,GAEf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAKL,kBAAkB,EAElB,gBAAgB,EAChB,aAAa,EAIb,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EAEjB,YAAY,GAEb,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAIhB,eAAe,GAEhB,MAAM,oBAAoB,CAAC"}

package/dist/model-handle.d.ts

@@ -0,0 +1,92 @@
+import type { LanguageModel } from 'ai';
+import { type CatalogModel, type CatalogVendor, type LlmCapability, type LlmProtocol, type ModelPricing } from './types.js';
+import { type LlmVendorAdapter, type ProviderOptions, type SamplingParams, type VendorFetch, type VendorFileStore } from './vendors/index.js';
+/** 指向一个模型：厂商 slug + 厂商侧的模型名。 */
+export interface ModelRef {
+    vendor: string;
+    modelId: string;
+}
+export interface ResolveOptions {
+    /**
+     * 推理档位（`REASONING_EFFORTS`）。省略或不认识的值 = **什么都不发**（不是关闭）；非推理模型也什么都不发
+     * ——给不会推理的模型发关闭指令有 400 风险。是 `string` 不是 `ReasoningEffort`：调用方的配置常是裸字符串，
+     * 不认识时不替它猜档位。
+     */
+    reasoningEffort?: string;
+    /** 会话 id。中心据此把同一会话固定在同一把 key 上（前缀缓存、厂商侧文件与状态都绑账号）。直连模式忽略。 */
+    affinity?: string;
+    /**
+     * 钉住某把 key（上传文件时 `fileStore.upload` 回的 `credentialRef`）。那把 key 不可用时请求报
+     * `pinned_credential_unavailable`，不切换——调用方重新上传后不带 pin 重试。直连模式忽略。
+     */
+    pin?: string;
+}
+/** 上传结果；`credentialRef` 是中心模式下文件落在哪把 key 的账号上（直连为 null），之后引用它的请求要 pin 这把。 */
+export interface UploadedFile {
+    fileId: string;
+    expiresAt: Date | null;
+    credentialRef: string | null;
+}
+export interface ModelFileStore {
+    /** `FilePart.data.reference` 的命名空间 key（跟承载包走，不跟厂商走）。 */
+    referenceKey: string;
+    upload(input: Parameters<VendorFileStore['upload']>[0]): Promise<UploadedFile>;
+    delete(fileId: string): Promise<void>;
+}
+/** 一轮要的全部模型材料，一次解析出来、同源。 */
+export interface ModelHandle {
+    ref: ModelRef;
+    /** `厂商名 / 模型显示名`。 */
+    label: string;
+    model: LanguageModel;
+    /** 实际选中的线协议（按模型声明的顺序取第一个「有端点且适配器已实现」的）。 */
+    protocol: LlmProtocol;
+    /** 推理档位已翻译成这家的参数；可以是 undefined（见 `ResolveOptions.reasoningEffort`）。 */
+    providerOptions: ProviderOptions | undefined;
+    /** 调用方给的档位，原样。 */
+    reasoningEffort: string | undefined;
+    limits: {
+        maxContextTokens: number | null;
+        maxOutputTokens: number | null;
+    };
+    capabilities: LlmCapability[];
+    /** 单价（每百万 token）。给接入方自己算用量。 */
+    pricing: ModelPricing | null;
+    /**
+     * 工具调用 `providerMetadata` 里要随 part 落库、重放时放回 `providerOptions` 的命名空间（google 的思考签名）。
+     * 别家为空：它们的 metadata 原样回放会改变请求形状。
+     */
+    replayedMetadataKeys: readonly string[];
+    /** 厂商 Files API；没有为 null（调用方退到公网 URL / base64）。 */
+    fileStore: ModelFileStore | null;
+    /** 剥掉这家不接受的采样参数（Kimi 禁 temperature / top_p，AI SDK 不替我们挡）。不抛，调用方按 `dropped` 记 warn。 */
+    filterSampling(params: SamplingParams): {
+        accepted: SamplingParams;
+        dropped: (keyof SamplingParams)[];
+    };
+}
+export interface ModelResolver {
+    /** 解析出一轮要用的句柄。厂商 / 模型不在目录里、协议对不上 → `ProviderClientError`。 */
+    resolve(ref: ModelRef, options?: ResolveOptions): Promise<ModelHandle>;
+    /** 只要能力、不造句柄。模型不在目录里给空数组。 */
+    capabilitiesOf(ref: ModelRef): Promise<LlmCapability[]>;
+}
+export declare function findModel(vendors: readonly CatalogVendor[], ref: ModelRef): {
+    vendor: CatalogVendor;
+    model: CatalogModel;
+};
+export declare function adapterFor(vendor: CatalogVendor): LlmVendorAdapter;
+/** 两种模式共用：从目录条目、凭证与出站 fetch 造句柄。 */
+export declare function buildHandle(input: {
+    ref: ModelRef;
+    vendor: CatalogVendor;
+    model: CatalogModel;
+    apiKey: string;
+    /**
+     * 造出站 fetch。中心模式下 `onCredential` 收到这次实际用的 key；上传文件时每次单独造一个，
+     * 并发的请求互不串（文件落在哪把 key 上要拿准，之后引用它要 pin 这把）。
+     */
+    fetchFor: (onCredential?: (ref: string) => void) => VendorFetch | undefined;
+    reasoningEffort: string | undefined;
+}): ModelHandle;
+//# sourceMappingURL=model-handle.d.ts.map

package/dist/model-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-handle.d.ts","sourceRoot":"","sources":["../src/model-handle.ts"],"names":[],"mappings":"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"}

package/dist/model-handle.js

@@ -0,0 +1,72 @@
+import { ProviderClientError } from './errors.js';
+import { REASONING_EFFORTS, } from './types.js';
+import { findVendorAdapter, } from './vendors/index.js';
+const EFFORTS = new Set(REASONING_EFFORTS);
+export function findModel(vendors, ref) {
+    const vendor = vendors.find(v => v.slug === ref.vendor);
+    if (!vendor) {
+        throw new ProviderClientError('unknown_vendor', `vendor "${ref.vendor}" is not in the catalog`, null);
+    }
+    const model = vendor.models.find(m => m.modelId === ref.modelId);
+    if (!model) {
+        throw new ProviderClientError('unknown_model', `model "${ref.modelId}" is not in vendor "${ref.vendor}"`, null);
+    }
+    return { vendor, model };
+}
+export function adapterFor(vendor) {
+    const adapter = findVendorAdapter(vendor.kind);
+    if (!adapter) {
+        throw new ProviderClientError('unsupported_vendor_kind', `this provider-client has no adapter for vendor kind "${vendor.kind}" (vendor "${vendor.slug}"); upgrade the package`, null);
+    }
+    return adapter;
+}
+/** 两种模式共用：从目录条目、凭证与出站 fetch 造句柄。 */
+export function buildHandle(input) {
+    const { ref, vendor, model, reasoningEffort } = input;
+    const adapter = adapterFor(vendor);
+    const { protocol, baseUrl } = adapter.chooseEndpoint(model, vendor.endpoints);
+    const createInput = {
+        protocol,
+        baseUrl,
+        apiKey: input.apiKey,
+        modelId: model.modelId,
+        fetch: input.fetchFor(),
+    };
+    const store = adapter.createFileStore(createInput);
+    return {
+        ref,
+        label: `${vendor.name} / ${model.displayName}`,
+        model: adapter.createModel(createInput),
+        protocol,
+        providerOptions: model.capabilities.includes('reasoning') &&
+            reasoningEffort !== undefined &&
+            EFFORTS.has(reasoningEffort)
+            ? adapter.reasoning(model.modelId, reasoningEffort, protocol)
+            : undefined,
+        reasoningEffort,
+        limits: {
+            maxContextTokens: model.maxContextTokens,
+            maxOutputTokens: model.maxOutputTokens,
+        },
+        capabilities: [...model.capabilities],
+        pricing: model.pricing,
+        replayedMetadataKeys: adapter.replayedMetadataKeys,
+        fileStore: store && {
+            referenceKey: store.referenceKey,
+            async upload(file) {
+                let credentialRef = null;
+                const once = adapter.createFileStore({
+                    ...createInput,
+                    fetch: input.fetchFor(ref => (credentialRef = ref)),
+                });
+                if (!once)
+                    throw new Error('file store disappeared');
+                const r = await once.upload(file);
+                return { ...r, credentialRef };
+            },
+            delete: fileId => store.delete(fileId),
+        },
+        filterSampling: params => adapter.filterSampling(params),
+    };
+}
+//# sourceMappingURL=model-handle.js.map

package/dist/model-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-handle.js","sourceRoot":"","sources":["../src/model-handle.ts"],"names":[],"mappings":"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"}

package/dist/provider-client.d.ts

@@ -0,0 +1,40 @@
+import { type ModelHandle, type ModelRef, type ModelResolver, type ResolveOptions } from './model-handle.js';
+import { type CatalogResponse } from './types.js';
+import type { VendorFetch } from './vendors/index.js';
+export interface ProviderClientOptions {
+    /** 中心的根地址，如 `https://provider.example.com`。 */
+    centerUrl: string;
+    /** 接入方 API key（`pc_…`）。 */
+    apiKey: string;
+    /**
+     * 目录在这段时间内直接用缓存、不去中心复核（毫秒，默认 60 秒）。过期后带 `If-None-Match` 复核，
+     * 没变只回 304。中心改了目录最多这么久才被看到。
+     */
+    catalogTtlMs?: number;
+    /** 目录请求的超时（毫秒，默认 10 秒）。透传请求不受它管（流式回答可以很长）。 */
+    timeoutMs?: number;
+    /** 发往中心用的 fetch（测试替身、自定义代理）；默认全局 fetch。 */
+    fetch?: VendorFetch;
+}
+/**
+ * 中心模式：模型目录从中心拉，所有厂商请求经中心透传（中心换上真 key、坏了自动换下一把）。
+ * 本进程从头到尾不碰厂商 key。
+ */
+export declare class ProviderClient implements ModelResolver {
+    private readonly options;
+    private readonly center;
+    private readonly send;
+    private readonly ttlMs;
+    private readonly timeoutMs;
+    private cached;
+    private inflight;
+    constructor(options: ProviderClientOptions);
+    /** 这个接入方能用的厂商与模型（按白名单过滤过）。 */
+    catalog(): Promise<CatalogResponse>;
+    /** 丢掉目录缓存（中心改了配置、想立刻看到时）。 */
+    invalidateCatalog(): void;
+    resolve(ref: ModelRef, options?: ResolveOptions): Promise<ModelHandle>;
+    capabilitiesOf(ref: ModelRef): Promise<("vision" | "video" | "reasoning")[]>;
+    private fetchCatalog;
+}
+//# sourceMappingURL=provider-client.d.ts.map

package/dist/provider-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-client.d.ts","sourceRoot":"","sources":["../src/provider-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,eAAe,EAAc,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,aAAa;IAYtC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAXpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAIE;IAChB,OAAO,CAAC,QAAQ,CAAyC;gBAE5B,OAAO,EAAE,qBAAqB;IAO3D,8BAA8B;IAC9B,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAUnC,6BAA6B;IAC7B,iBAAiB,IAAI,IAAI;IAInB,OAAO,CACX,GAAG,EAAE,QAAQ,EACb,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC;IAwBjB,cAAc,CAAC,GAAG,EAAE,QAAQ;YAQpB,YAAY;CAgC3B"}

package/dist/provider-client.js

@@ -0,0 +1,96 @@
+import { createCenterFetch } from './center-fetch.js';
+import { errorFromResponse, ProviderClientError } from './errors.js';
+import { buildHandle, findModel, } from './model-handle.js';
+import { PC_HEADERS } from './types.js';
+/**
+ * 中心模式：模型目录从中心拉，所有厂商请求经中心透传（中心换上真 key、坏了自动换下一把）。
+ * 本进程从头到尾不碰厂商 key。
+ */
+export class ProviderClient {
+    options;
+    center;
+    send;
+    ttlMs;
+    timeoutMs;
+    cached = null;
+    inflight = null;
+    constructor(options) {
+        this.options = options;
+        this.center = options.centerUrl.replace(/\/+$/, '');
+        this.send = options.fetch ?? globalThis.fetch;
+        this.ttlMs = options.catalogTtlMs ?? 60_000;
+        this.timeoutMs = options.timeoutMs ?? 10_000;
+    }
+    /** 这个接入方能用的厂商与模型（按白名单过滤过）。 */
+    catalog() {
+        if (this.cached && Date.now() - this.cached.checkedAt < this.ttlMs) {
+            return Promise.resolve(this.cached.body);
+        }
+        this.inflight ??= this.fetchCatalog().finally(() => {
+            this.inflight = null;
+        });
+        return this.inflight;
+    }
+    /** 丢掉目录缓存（中心改了配置、想立刻看到时）。 */
+    invalidateCatalog() {
+        this.cached = null;
+    }
+    async resolve(ref, options = {}) {
+        const { vendor, model } = findModel((await this.catalog()).vendors, ref);
+        const baseUrls = vendor.endpoints.map(e => e.baseUrl);
+        return buildHandle({
+            ref,
+            vendor,
+            model,
+            // 厂商 SDK 要求有 key 才肯造句柄；它放进的鉴权头会被中心模式 fetch 剥掉。
+            apiKey: 'via-provider-center',
+            fetchFor: onCredential => createCenterFetch({
+                centerUrl: this.center,
+                apiKey: this.options.apiKey,
+                vendor: vendor.slug,
+                baseUrls,
+                affinity: options.affinity,
+                pin: options.pin,
+                onCredential,
+                fetch: this.send,
+            }),
+            reasoningEffort: options.reasoningEffort,
+        });
+    }
+    async capabilitiesOf(ref) {
+        const vendor = (await this.catalog()).vendors.find(v => v.slug === ref.vendor);
+        const model = vendor?.models.find(m => m.modelId === ref.modelId);
+        return model ? [...model.capabilities] : [];
+    }
+    async fetchCatalog() {
+        const headers = {
+            [PC_HEADERS.key]: this.options.apiKey,
+        };
+        if (this.cached?.etag)
+            headers['if-none-match'] = this.cached.etag;
+        let res;
+        try {
+            res = await this.send(`${this.center}/v1/catalog`, {
+                headers,
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+        }
+        catch (err) {
+            throw new ProviderClientError('network', `provider center unreachable: ${err instanceof Error ? err.message : String(err)}`, null, { cause: err });
+        }
+        if (res.status === 304 && this.cached) {
+            this.cached.checkedAt = Date.now();
+            return this.cached.body;
+        }
+        if (!res.ok)
+            throw await errorFromResponse(res);
+        const body = (await res.json());
+        this.cached = {
+            etag: res.headers.get('etag'),
+            body,
+            checkedAt: Date.now(),
+        };
+        return body;
+    }
+}
+//# sourceMappingURL=provider-client.js.map