@downcity/city 0.2.200 → 0.2.205

package/bin/utils/CityLanguageModelResult.js

@@ -0,0 +1,76 @@
+/**
+ * LanguageModelV3 流结果聚合工具。
+ *
+ * 该模块只理解 AI SDK LanguageModelV3 的标准流事件，不了解 Federation transport
+ * 或具体上游协议。CityModel 非流式调用和 AIChannel 通用 text action 复用这里，
+ * 保证两条入口对 text、reasoning、tool、usage 和 metadata 的收口语义一致。
+ */
+/** 将标准 LanguageModelV3 流聚合为一次非流式生成结果。 */
+export async function collect_city_language_model_stream(stream, request_body) {
+    const reader = stream.getReader();
+    const content = [];
+    const text_blocks = new Map();
+    const reasoning_blocks = new Map();
+    let warnings = [];
+    let response;
+    let finish_reason;
+    let usage;
+    let provider_metadata;
+    while (true) {
+        const chunk = await reader.read();
+        if (chunk.done)
+            break;
+        const part = chunk.value;
+        const type = String(part.type ?? "");
+        if (type === "error")
+            throw part.error;
+        if (type === "stream-start") {
+            warnings = Array.isArray(part.warnings) ? part.warnings : [];
+        }
+        else if (type === "response-metadata") {
+            const { type: _type, ...metadata } = part;
+            response = metadata;
+        }
+        else if (type === "text-start" || type === "reasoning-start") {
+            const block = {
+                type: type === "text-start" ? "text" : "reasoning",
+                text: "",
+                ...(part.providerMetadata
+                    ? { providerMetadata: part.providerMetadata }
+                    : {}),
+            };
+            content.push(block);
+            const blocks = type === "text-start" ? text_blocks : reasoning_blocks;
+            blocks.set(String(part.id), block);
+        }
+        else if (type === "text-delta" || type === "reasoning-delta") {
+            const blocks = type === "text-delta" ? text_blocks : reasoning_blocks;
+            const block = blocks.get(String(part.id));
+            if (block) {
+                block.text = `${String(block.text ?? "")}${String(part.delta ?? "")}`;
+            }
+        }
+        else if (["file", "source", "tool-call", "tool-result", "tool-approval-request"]
+            .includes(type)) {
+            content.push(part);
+        }
+        else if (type === "finish") {
+            finish_reason = part.finishReason;
+            usage = part.usage;
+            provider_metadata = part.providerMetadata;
+        }
+    }
+    if (!finish_reason || !usage) {
+        throw new Error("Language model stream ended without finish usage");
+    }
+    return {
+        content,
+        finishReason: finish_reason,
+        usage,
+        warnings,
+        ...(provider_metadata ? { providerMetadata: provider_metadata } : {}),
+        ...(request_body !== undefined ? { request: { body: request_body } } : {}),
+        ...(response ? { response } : {}),
+    };
+}
+//# sourceMappingURL=CityLanguageModelResult.js.map

package/bin/utils/CityLanguageModelResult.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/city",
-  "version": "0.2.200",
+  "version": "0.2.205",
   "description": "Downcity City runtime and City access SDK for services, actions, auth, env, and cities.",
   "type": "module",
   "main": "./bin/index.js",
@@ -41,7 +41,7 @@
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@downcity/type": "0.1.153",
+    "@downcity/type": "0.1.155",
     "ai": "^6.0.193",
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.23"

package/bin/service/ai/charge.d.ts

@@ -1,76 +0,0 @@
-/**
- * AI Provider 扣费协议。
- *
- * 关键说明（中文）
- * - Provider 自己理解上游 usage 与价格规则，并返回最终应扣金额。
- * - AIService 只负责在正确的生命周期内提交扣费，不理解 token/cache 等 provider 细节。
- * - Balance bridge 只暴露通用 charge 能力，避免 @downcity/city 反向依赖 @downcity/services。
- */
-import type { Context } from "../service.js";
-/**
- * Provider 计算出的单次扣费结果。
- */
-export interface AIProviderChargeLine {
-    /**
-     * 可选扣费用户 ID。
-     *
-     * 图片 result 轮询可能由 admin 或服务端代发，没有当前 user。
-     * 这时 bill() 应从已保存任务归属中返回 user_id，AIService 会优先使用它。
-     */
-    user_id?: string;
-    /** 扣费额度，单位为 credits。 */
-    credits: number;
-    /** 账单说明。 */
-    note?: string;
-    /** 外部引用 ID。 */
-    ref?: string;
-    /** 内部审计信息，不作为跨 provider 的公共 usage 协议。 */
-    metadata?: Record<string, unknown>;
-}
-/**
- * AIService 提交给外部 Balance bridge 的扣费输入。
- */
-export interface AIBalanceChargeInput extends AIProviderChargeLine {
-    /** 当前用户 ID。 */
-    user_id: string;
-    /** 可选幂等键；相同键的重复提交必须只产生一次扣费。 */
-    idempotency_key?: string;
-}
-/**
- * AIService 依赖的最小 Balance bridge。
- */
-export interface AIBalanceBridge {
-    /**
-     * 执行余额前置检查。
-     *
-     * AIService 默认调用时不传 needed_credits，只拦截已经欠费的用户。
-     */
-    precheck?(user_id: string, needed_credits?: number): Promise<{
-        credits: number;
-    }>;
-    /** 执行扣费并记录账单。 */
-    charge(input: AIBalanceChargeInput): Promise<unknown>;
-}
-/**
- * Provider 或模型生成扣费行的方法。
- */
-export type AIProviderBillFn = (ctx: Context, output: unknown) => AIProviderChargeLine | Promise<AIProviderChargeLine | undefined> | undefined;
-/**
- * Provider action 可返回的带扣费普通输出。
- */
-export interface AIProviderChargedOutput<T = unknown> {
-    /** 对外返回的原始 action 输出。 */
-    output: T;
-    /** Provider 已计算好的扣费结果。 */
-    charge?: AIProviderChargeLine | Promise<AIProviderChargeLine | undefined> | undefined;
-}
-/**
- * Provider action 可返回的带扣费 Response 输出。
- */
-export interface AIProviderChargedResponse {
-    /** 对外返回的 HTTP Response。 */
-    response: Response;
-    /** Provider 已计算好的扣费结果。 */
-    charge?: AIProviderChargeLine | Promise<AIProviderChargeLine | undefined> | undefined;
-}
-//# sourceMappingURL=charge.d.ts.map

package/bin/service/ai/charge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"charge.d.ts","sourceRoot":"","sources":["../../../src/service/ai/charge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElF,iBAAiB;IACjB,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,OAAO,KACZ,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,OAAO;IAClD,yBAAyB;IACzB,MAAM,EAAE,CAAC,CAAC;IACV,0BAA0B;IAC1B,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACvF;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACvF"}

package/bin/service/ai/charge.js

@@ -1,10 +0,0 @@
-/**
- * AI Provider 扣费协议。
- *
- * 关键说明（中文）
- * - Provider 自己理解上游 usage 与价格规则，并返回最终应扣金额。
- * - AIService 只负责在正确的生命周期内提交扣费，不理解 token/cache 等 provider 细节。
- * - Balance bridge 只暴露通用 charge 能力，避免 @downcity/city 反向依赖 @downcity/services。
- */
-export {};
-//# sourceMappingURL=charge.js.map

package/bin/service/ai/charge.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"charge.js","sourceRoot":"","sources":["../../../src/service/ai/charge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/service/ai/job-types.d.ts

@@ -1,69 +0,0 @@
-/**
- * AI 图片任务协议类型。
- *
- * 关键点（中文）
- * - AIService 固定 image_create / image_fetch / image_result 的返回协议。
- * - AIService 默认使用内置 async_jobs 表保存图片任务，Provider 只负责创建上游任务和抓取上游结果。
- */
-import type { UIMessage } from "ai";
-import type { AsyncJobRecord } from "../../types/AsyncJob.js";
-/** 图片任务状态。 */
-export type AIImageJobStatus = "queued" | "running" | "succeeded" | "failed";
-/** 图片任务扩展元数据。 */
-export interface AIImageJobMetadata {
-    /** 扩展字段，由具体 Provider 自行约定。 */
-    [key: string]: unknown;
-}
-/** image_create action 返回给 AIService 的固定协议。 */
-export interface AIImageProviderCreateResult {
-    /** 图片任务 ID，对 AIService 不透明，由具体 Provider 生成或转发。 */
-    job_id: string;
-    /** 创建后的任务状态。 */
-    status: AIImageJobStatus;
-    /** 当前任务状态说明，便于客户端展示或排障。 */
-    message?: string;
-    /** 失败时返回的错误消息。 */
-    error?: string;
-    /** 建议客户端下一次查询 result 的间隔毫秒数。 */
-    poll_after_ms?: number;
-    /** 具体 Provider 返回的扩展元数据。 */
-    metadata?: AIImageJobMetadata;
-}
-/** image_fetch action 返回给 AIService 的固定协议。 */
-export interface AIImageProviderFetchResult {
-    /** 图片任务 ID。 */
-    job_id: string;
-    /** 当前任务状态。 */
-    status: AIImageJobStatus;
-    /** 成功时返回的 AI SDK UIMessage。 */
-    result?: UIMessage;
-    /** 失败时返回的错误消息。 */
-    error?: string;
-    /** 当前任务状态说明，便于客户端展示或排障。 */
-    message?: string;
-    /** 建议客户端下一次查询 result 的间隔毫秒数。 */
-    poll_after_ms?: number;
-    /** 具体 Provider 返回的扩展元数据。 */
-    metadata?: AIImageJobMetadata;
-}
-/** image/create 返回给客户端的结果。 */
-export type UserImageJobCreateResult = AIImageProviderCreateResult;
-/** image/result 返回给客户端的结果。 */
-export type UserImageJobResult = AIImageProviderFetchResult;
-/** image/result 的查询输入。 */
-export interface UserImageJobResultInput {
-    /** 图片任务 ID，由 image_create 返回。 */
-    job_id: string;
-}
-/** Provider 在 image_fetch 中可读取的图片任务上下文。 */
-export interface AIImageJobContext {
-    /** async_jobs 中保存的完整任务记录。 */
-    record: AsyncJobRecord;
-    /** image_create 时的原始输入。 */
-    input: Record<string, unknown>;
-    /** image_create / image_fetch 返回的 provider 状态。 */
-    state?: AIImageJobMetadata;
-}
-/** 兼容命名：Provider fetch 与用户 result 使用相同固定结果协议。 */
-export type AIImageProviderResult = AIImageProviderFetchResult;
-//# sourceMappingURL=job-types.d.ts.map

package/bin/service/ai/job-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"job-types.d.ts","sourceRoot":"","sources":["../../../src/service/ai/job-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,cAAc;AACd,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7E,iBAAiB;AACjB,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,+CAA+C;AAC/C,MAAM,WAAW,2BAA2B;IAC1C,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,MAAM,EAAE,gBAAgB,CAAC;IACzB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,8BAA8B;AAC9B,MAAM,MAAM,wBAAwB,GAAG,2BAA2B,CAAC;AAEnE,8BAA8B;AAC9B,MAAM,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAE5D,0BAA0B;AAC1B,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kDAAkD;IAClD,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,iDAAiD;AACjD,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,CAAC"}

package/bin/service/ai/job-types.js

@@ -1,9 +0,0 @@
-/**
- * AI 图片任务协议类型。
- *
- * 关键点（中文）
- * - AIService 固定 image_create / image_fetch / image_result 的返回协议。
- * - AIService 默认使用内置 async_jobs 表保存图片任务，Provider 只负责创建上游任务和抓取上游结果。
- */
-export {};
-//# sourceMappingURL=job-types.js.map

package/bin/service/ai/job-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"job-types.js","sourceRoot":"","sources":["../../../src/service/ai/job-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/service/ai/provider.d.ts

@@ -1,143 +0,0 @@
-/**
- * AI Provider 模块。
- *
- * Provider 是第三方 AI 提供商的基类。
- * - 默认提供 OpenAI-compatible 的 text 实现。
- * - 子类通过覆盖 createClient 来绑定不同的 AI SDK provider。
- * - 需要其它模态（image / video / tts / asr）或自定义 openai 透传时，覆盖对应方法。
- */
-import type { UIMessage } from "ai";
-import type { CityModelReasoning } from "@downcity/type";
-import type { Context } from "../service.js";
-import type { AIProviderBillFn, AIProviderChargedOutput, AIProviderChargedResponse, AIProviderChargeLine } from "./charge.js";
-import type { AIImageProviderCreateResult, AIImageProviderFetchResult, AIImageProviderResult } from "./job-types.js";
-import type { ModelConfig, CityLanguageModelV3, ModelFallbackRule, OpenAICompatibleClient, OpenAICompatibleClientConfig, ProviderOptions } from "./types.js";
-import type { AIProviderOptions } from "../../types/AIReasoning.js";
-import type { CityProviderStreamCall, CityProviderStreamResult } from "../../types/CityLanguageModelRuntime.js";
-interface OpenAIActionInput {
-    /** 多轮 UIMessage。 */
-    messages?: UIMessage[];
-    /** 单轮 prompt。 */
-    prompt?: string;
-    /** OpenAI function tools。 */
-    tools?: Record<string, unknown>[];
-}
-/**
- * AI Provider 基类。
- *
- * 子类通过覆盖方法声明 action，model() 会自动收集并生成 ModelConfig。
-  * 默认 text 使用 OpenAI-compatible 协议，CityModel 模型流统一由 stream 提供。
- */
-export declare abstract class Provider {
-    /** Provider 唯一 ID。 */
-    readonly id: string;
-    /** 模型所需环境变量说明。 */
-    readonly env?: Record<string, string>;
-    /** Provider 的 baseURL（用于自动透传）。 */
-    readonly baseURL?: string;
-    /** Provider 的环境变量 key。 */
-    readonly envKey?: string;
-    /** 上游 API 实际模型 ID（自动透传时替换 body.model）。 */
-    readonly passthroughModel?: string;
-    constructor(options: ProviderOptions);
-    /**
-     * 创建 OpenAI-compatible chat client。
-     *
-     * 子类需要支持 text 或 CityModel stream 时必须覆盖。
-     * 默认抛出错误。
-     */
-    protected createClient(config: OpenAICompatibleClientConfig): OpenAICompatibleClient;
-    /**
-     * 从输入中提取 prompt 文本。
-     *
-     * 子类可覆盖以支持多模态 messages 转文本。
-     */
-    protected extractPrompt(input: OpenAIActionInput): string;
-    /**
-     * 为一次完成的调用生成扣费草稿。
-     *
-     * 默认不返回扣费。真正扣款由 AIService 调用 BalanceService 完成。
-     */
-    protected bill(ctx: Context, output: unknown): AIProviderChargeLine | undefined;
-    /** 创建默认 OpenAI-compatible chat model。 */
-    private create_openai_compatible_model;
-    /**
-     * 执行一次 CityModel 标准模型流。
-     *
-     * 默认实现把调用交给 OpenAI-compatible chat model。Responses、Claude Messages、
-     * Gemini 或自定义上游协议应覆盖此方法，并返回标准 LanguageModelV3 流事件。
-     */
-    protected stream(ctx: Context, call: CityProviderStreamCall): Promise<CityProviderStreamResult>;
-    /**
-     * 将输入解析成 prompt 或 messages。
-     */
-    private resolveActionInput;
-    /**
-     * 将 AIService 已解析的推理强度转换为当前 AI SDK Provider 的 providerOptions。
-     *
-     * 默认实现适用于 OpenAI-compatible Provider。Anthropic、Gemini 等字段结构不同的
-     * Provider 应覆盖该方法，但不能重新读取或校验原始 reasoning_effort。
-     */
-    protected build_reasoning_provider_options(ctx: Context, model: CityLanguageModelV3): AIProviderOptions | undefined;
-    /**
-     * 文本生成 action（OpenAI-compatible 默认实现）。
-     */
-    text(ctx: Context): Promise<AIProviderChargedOutput<UIMessage>>;
-    /**
-     * 图片任务创建 action。
-     *
-     * 子类实现图片生成时覆盖，负责创建并启动 provider 侧图片任务。
-     */
-    image_create?(ctx: Context): Promise<AIImageProviderCreateResult>;
-    /**
-     * 图片任务抓取 action。
-     *
-     * 子类实现图片生成时覆盖，负责根据 provider 任务状态抓取上游结果。
-     */
-    image_fetch?(ctx: Context): Promise<AIImageProviderFetchResult>;
-    /**
-     * 图片任务查询 action。
-     *
-     * 该方法保留为类型兼容，AIService 图片能力默认使用 image_fetch。
-     */
-    image_result?(ctx: Context): Promise<AIImageProviderResult>;
-    /**
-     * 视频生成 action。
-     */
-    video?(ctx: Context): Promise<AIProviderChargedOutput<UIMessage>>;
-    /**
-     * 语音合成 action。
-     */
-    tts?(ctx: Context): Promise<AIProviderChargedResponse>;
-    /**
-     * 语音识别 action。
-     */
-    asr?(ctx: Context): Promise<AIProviderChargedResponse>;
-    /**
-     * OpenAI 兼容 /chat/completions action。
-     *
-     * 未覆盖时由 AIService 自动透传。
-     */
-    openai?(ctx: Context): Promise<AIProviderChargedResponse>;
-    /**
-    * 生成模型配置。
-    *
-    * 自动收集当前 Provider 实例上定义的 action 方法。
-    */
-    model(spec: {
-        id: string;
-        name: string;
-        description?: string;
-        /** 模型支持的总上下文窗口长度，单位为 token。 */
-        context_window?: number;
-        tags?: string[];
-        meta?: Record<string, unknown>;
-        /** 面向用户展示的价格说明列表；不参与实际扣费计算。 */
-        price?: string[];
-        reasoning?: CityModelReasoning;
-        fallback?: ModelFallbackRule[];
-        bill?: AIProviderBillFn;
-    }): ModelConfig;
-}
-export {};
-//# sourceMappingURL=provider.d.ts.map

package/bin/service/ai/provider.d.ts.map

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

package/bin/service/ai/provider.js

@@ -1,221 +0,0 @@
-/**
- * AI Provider 模块。
- *
- * Provider 是第三方 AI 提供商的基类。
- * - 默认提供 OpenAI-compatible 的 text 实现。
- * - 子类通过覆盖 createClient 来绑定不同的 AI SDK provider。
- * - 需要其它模态（image / video / tts / asr）或自定义 openai 透传时，覆盖对应方法。
- */
-import { convertToModelMessages, generateText } from "ai";
-import { buildAssistantMessage, buildToolSet, readRequiredEnv, resolveUpstreamModel, } from "./helpers.js";
-import { read_resolved_reasoning } from "./reasoning.js";
-// ===========================================================================
-// Provider 基类
-// ===========================================================================
-/**
- * AI Provider 基类。
- *
- * 子类通过覆盖方法声明 action，model() 会自动收集并生成 ModelConfig。
-  * 默认 text 使用 OpenAI-compatible 协议，CityModel 模型流统一由 stream 提供。
- */
-export class Provider {
-    /** Provider 唯一 ID。 */
-    id;
-    /** 模型所需环境变量说明。 */
-    env;
-    /** Provider 的 baseURL（用于自动透传）。 */
-    baseURL;
-    /** Provider 的环境变量 key。 */
-    envKey;
-    /** 上游 API 实际模型 ID（自动透传时替换 body.model）。 */
-    passthroughModel;
-    constructor(options) {
-        this.id = options.id;
-        this.env = options.env ?? (options.envKey ? { [options.envKey]: `${options.id} API Key` } : undefined);
-        this.baseURL = options.baseURL;
-        this.envKey = options.envKey;
-        this.passthroughModel = options.passthroughModel;
-    }
-    /**
-     * 创建 OpenAI-compatible chat client。
-     *
-     * 子类需要支持 text 或 CityModel stream 时必须覆盖。
-     * 默认抛出错误。
-     */
-    createClient(config) {
-        throw new Error(`Provider ${this.id} does not support language models`);
-    }
-    /**
-     * 从输入中提取 prompt 文本。
-     *
-     * 子类可覆盖以支持多模态 messages 转文本。
-     */
-    extractPrompt(input) {
-        if (typeof input.prompt === "string")
-            return input.prompt;
-        return input.messages
-            ?.find((message) => message.role === "user")
-            ?.parts?.find((part) => part.type === "text")
-            ?.text ?? "";
-    }
-    /**
-     * 为一次完成的调用生成扣费草稿。
-     *
-     * 默认不返回扣费。真正扣款由 AIService 调用 BalanceService 完成。
-     */
-    bill(ctx, output) {
-        return undefined;
-    }
-    /** 创建默认 OpenAI-compatible chat model。 */
-    create_openai_compatible_model(ctx) {
-        if (!this.envKey) {
-            throw new Error(`Provider ${this.id} is missing envKey`);
-        }
-        const api_key = readRequiredEnv(ctx, this.envKey);
-        const base_url = this.baseURL ?? "https://api.openai.com/v1";
-        const upstream_model = resolveUpstreamModel(ctx, this.passthroughModel ?? "");
-        return this.createClient({ apiKey: api_key, baseURL: base_url, name: this.id }).chat(upstream_model);
-    }
-    /**
-     * 执行一次 CityModel 标准模型流。
-     *
-     * 默认实现把调用交给 OpenAI-compatible chat model。Responses、Claude Messages、
-     * Gemini 或自定义上游协议应覆盖此方法，并返回标准 LanguageModelV3 流事件。
-     */
-    async stream(ctx, call) {
-        const model = this.create_openai_compatible_model(ctx);
-        const provider_options = this.build_reasoning_provider_options(ctx, model);
-        return model.doStream({
-            ...call,
-            ...(provider_options ? { providerOptions: provider_options } : {}),
-        });
-    }
-    /**
-     * 将输入解析成 prompt 或 messages。
-     */
-    async resolveActionInput(input) {
-        const tools = buildToolSet(input.tools);
-        if (Array.isArray(input.messages) && input.messages.length > 0) {
-            const messages = tools
-                ? await convertToModelMessages(input.messages, { tools })
-                : await convertToModelMessages(input.messages);
-            return tools ? { tools, messages } : { messages };
-        }
-        return {
-            prompt: this.extractPrompt(input),
-        };
-    }
-    /**
-     * 将 AIService 已解析的推理强度转换为当前 AI SDK Provider 的 providerOptions。
-     *
-     * 默认实现适用于 OpenAI-compatible Provider。Anthropic、Gemini 等字段结构不同的
-     * Provider 应覆盖该方法，但不能重新读取或校验原始 reasoning_effort。
-     */
-    build_reasoning_provider_options(ctx, model) {
-        const reasoning = read_resolved_reasoning(ctx);
-        if (!reasoning)
-            return undefined;
-        const provider = typeof model === "object" && model !== null && "provider" in model
-            ? model.provider
-            : undefined;
-        const provider_id = typeof provider === "string"
-            ? provider.split(".")[0]?.trim()
-            : undefined;
-        if (!provider_id) {
-            throw new Error(`Provider ${this.id} cannot resolve AI SDK provider id`);
-        }
-        return {
-            [provider_id]: {
-                reasoningEffort: reasoning.effort,
-            },
-        };
-    }
-    /**
-     * 文本生成 action（OpenAI-compatible 默认实现）。
-     */
-    async text(ctx) {
-        const input = ctx.input;
-        const resolved_input = await this.resolveActionInput(input);
-        const model = this.create_openai_compatible_model(ctx);
-        const provider_options = this.build_reasoning_provider_options(ctx, model);
-        if ("messages" in resolved_input) {
-            const result = await generateText({
-                model,
-                messages: resolved_input.messages,
-                ...("tools" in resolved_input ? { tools: resolved_input.tools } : {}),
-                ...(provider_options ? { providerOptions: provider_options } : {}),
-            });
-            return buildAssistantMessage(result.text, ctx, {
-                finishReason: result.finishReason,
-                usage: result.usage,
-                ...("tools" in resolved_input ? { toolCalls: result.toolCalls } : {}),
-            });
-        }
-        const result = await generateText({
-            model,
-            prompt: resolved_input.prompt,
-            ...(provider_options ? { providerOptions: provider_options } : {}),
-        });
-        return buildAssistantMessage(result.text, ctx, {
-            finishReason: result.finishReason,
-            usage: result.usage,
-        });
-    }
-    /**
-    * 生成模型配置。
-    *
-    * 自动收集当前 Provider 实例上定义的 action 方法。
-    */
-    model(spec) {
-        const actions = {};
-        const has_language_model = this.stream !== Provider.prototype.stream ||
-            this.createClient !== Provider.prototype.createClient;
-        const all_modalities = [
-            "text",
-            "image_create",
-            "image_fetch",
-            "image_result",
-            "video",
-            "tts",
-            "asr",
-            "openai",
-        ];
-        for (const modality of all_modalities) {
-            const fn = this[modality];
-            if (typeof fn !== "function")
-                continue;
-            // text 默认由基类实现，只有子类显式覆盖或提供了 createClient 才暴露。
-            if (modality === "text") {
-                const is_overridden = fn !== Provider.prototype[modality];
-                const has_create_client = this.createClient !== Provider.prototype.createClient;
-                if (!is_overridden && !has_create_client)
-                    continue;
-            }
-            actions[modality] = fn.bind(this);
-        }
-        return {
-            id: spec.id,
-            provider_id: this.id,
-            name: spec.name,
-            description: spec.description,
-            context_window: spec.context_window,
-            tags: spec.tags,
-            ...(spec.price ? { price: [...spec.price] } : {}),
-            meta: spec.meta,
-            reasoning: spec.reasoning,
-            env: this.env,
-            baseURL: this.baseURL,
-            envKey: this.envKey,
-            passthroughModel: this.passthroughModel,
-            fallback: spec.fallback,
-            actions,
-            ...(has_language_model ? {
-                language_model: {
-                    stream: (ctx, call) => this.stream(ctx, call),
-                },
-            } : {}),
-            bill: spec.bill ?? this.bill.bind(this),
-        };
-    }
-}
-//# sourceMappingURL=provider.js.map