@downcity/city 0.2.17

package/bin/index.js

@@ -0,0 +1,37 @@
+/**
+ * @downcity/city 公共入口。
+ */
+// ===========================================================================
+// 场景 1：创建 City 实例
+// ===========================================================================
+export { City } from "./core/base/base.js";
+// ===========================================================================
+// 场景 2：注册 Service / InstallableService / AI 模型
+// ===========================================================================
+export { Service } from "./service/service.js";
+export { InstallableService } from "./service/installable-service.js";
+export { Action } from "./service/action.js";
+export { AIService } from "./service/ai/ai-service.js";
+export { Provider } from "./service/ai/provider.js";
+export { createOpenAICompatibleProvider } from "./service/ai/openai-compatible-provider.js";
+// ===========================================================================
+// 场景 3：用户鉴权与 Token
+// ===========================================================================
+export { TokenSigner } from "./core/auth/token-signer.js";
+// ===========================================================================
+// 场景 4：管理 Studio 与环境变量（内置 Service）
+// ===========================================================================
+export { EnvService } from "./service/env/env-service.js";
+export { EnvStore } from "./service/env/env-store.js";
+export { StudiosService } from "./service/studios/studios-service.js";
+export { executeDDL } from "./store/db.js";
+// ===========================================================================
+// 场景 6：内置表 Schema
+// ===========================================================================
+export { sqliteStudios, pgStudios } from "./service/studios/schema.js";
+export { sqliteEnv, pgEnv } from "./service/env/schema.js";
+// ===========================================================================
+// 场景 7：工具函数
+// ===========================================================================
+export { randomSecret, base64UrlEncode, base64UrlDecode, base64UrlEncodeBytes, base64UrlDecodeBytes, timingSafeEqualBytes, httpError, normalizeEnvKey, bearerToken, parseDotenvEntries, } from "./utils/helpers.js";
+//# sourceMappingURL=index.js.map

package/bin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAI3C,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA0B7C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAe5F,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAS1D,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAO1D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAQtE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI3C,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAE3D,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,eAAe,EACf,WAAW,EACX,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/bin/service/action.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Action 模块。
+ *
+ * Action 是 Service 的一等能力单元。
+ * 每个 Action 有独立的 hook（before/after/onError），可独立被 client 调用。
+ *
+ * 使用方式：
+ * ```ts
+ * const zh2en = translateService.action("zh2en", async (ctx) => {
+ *   return await translate(ctx.input.text, "zh", "en");
+ * });
+ * zh2en.before(checkBalance).after(deductFee);
+ * ```
+ */
+import { Hook } from "./hook.js";
+import type { Context } from "./service.js";
+/** Action 的业务逻辑函数 */
+export type ActionFn = (ctx: Context) => unknown | Promise<unknown>;
+/** Action 实例 */
+export declare class Action {
+    /** Action 唯一 ID */
+    readonly id: string;
+    /** Action 独立的 hook（before/after/onError） */
+    readonly hook: Hook;
+    /** 业务逻辑 */
+    private readonly _run;
+    constructor(id: string, fn: ActionFn);
+    /** 注册 before hook */
+    before(fn: HookFn): this;
+    /** 注册 after hook */
+    after(fn: HookFn): this;
+    /** 注册 onError hook */
+    onError(fn: HookFn): this;
+    /** 执行业务逻辑 */
+    run(ctx: Context): Promise<unknown>;
+}
+/**
+ * Hook 回调函数。
+ *
+ * 接收 Context，不返回值（返回 void 或 Promise<void>）。
+ * 如需修改 context，直接在 ctx 上改（如 ctx.output）。
+ */
+export type HookFn = (ctx: Context) => void | Promise<void>;
+//# sourceMappingURL=action.d.ts.map

package/bin/service/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/service/action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,qBAAqB;AACrB,MAAM,MAAM,QAAQ,GAAG,CACrB,GAAG,EAAE,OAAO,KACT,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,gBAAgB;AAChB,qBAAa,MAAM;IACjB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,OAAc;IAE3B,WAAW;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;gBAEpB,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ;IAKpC,qBAAqB;IACrB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB,oBAAoB;IACpB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKvB,sBAAsB;IACtB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKzB,aAAa;IACP,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAG1C;AAED;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/service/action.js

@@ -0,0 +1,48 @@
+/**
+ * Action 模块。
+ *
+ * Action 是 Service 的一等能力单元。
+ * 每个 Action 有独立的 hook（before/after/onError），可独立被 client 调用。
+ *
+ * 使用方式：
+ * ```ts
+ * const zh2en = translateService.action("zh2en", async (ctx) => {
+ *   return await translate(ctx.input.text, "zh", "en");
+ * });
+ * zh2en.before(checkBalance).after(deductFee);
+ * ```
+ */
+import { Hook } from "./hook.js";
+/** Action 实例 */
+export class Action {
+    /** Action 唯一 ID */
+    id;
+    /** Action 独立的 hook（before/after/onError） */
+    hook = new Hook();
+    /** 业务逻辑 */
+    _run;
+    constructor(id, fn) {
+        this.id = id;
+        this._run = fn;
+    }
+    /** 注册 before hook */
+    before(fn) {
+        this.hook.before(fn);
+        return this;
+    }
+    /** 注册 after hook */
+    after(fn) {
+        this.hook.after(fn);
+        return this;
+    }
+    /** 注册 onError hook */
+    onError(fn) {
+        this.hook.onError(fn);
+        return this;
+    }
+    /** 执行业务逻辑 */
+    async run(ctx) {
+        return this._run(ctx);
+    }
+}
+//# sourceMappingURL=action.js.map

package/bin/service/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../src/service/action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,gBAAgB;AAChB,MAAM,OAAO,MAAM;IACjB,mBAAmB;IACV,EAAE,CAAS;IACpB,4CAA4C;IACnC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAE3B,WAAW;IACM,IAAI,CAAW;IAEhC,YAAY,EAAU,EAAE,EAAY;QAClC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,qBAAqB;IACrB,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB;IACpB,KAAK,CAAC,EAAU;QACd,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sBAAsB;IACtB,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;IACb,KAAK,CAAC,GAAG,CAAC,GAAY;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;CACF"}

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

@@ -0,0 +1,56 @@
+/**
+ * AI Service 模块。
+ *
+ * AIService 处理所有 AI 通路（SDK 通路 + OpenAI 兼容通路）。
+ * 通过 action() 注册 modality action，通过 resolve() 匹配模型和 action。
+ *
+ * 鉴权由 City 在路由入口统一强制执行。
+ *
+ * 路由（City 自动生成）：
+ * - POST /v1/ai/text             — 文本生成
+ * - POST /v1/ai/stream           — 流式生成
+ * - POST /v1/ai/image            — 图片生成
+ * - POST /v1/ai/video            — 视频生成
+ * - POST /v1/ai/chat/completions — OpenAI 兼容端点
+ * - GET  /v1/ai/models           — 模型列表
+ */
+import { Service } from "../service.js";
+import type { ActionFn } from "../action.js";
+import type { ModelConfig, PublicModel } from "./types.js";
+type EnvReader = (key: string) => string | undefined;
+export declare class AIService extends Service {
+    /** 模型注册表 */
+    private modelMap;
+    /** SDK 通路 action 映射（modality → action） */
+    private modalityActions;
+    constructor();
+    use(...inputs: (ModelConfig | ModelConfig[])[]): this;
+    listModels(): ModelConfig[];
+    hasAction(): boolean;
+    resolve(query: {
+        model?: string;
+        mode?: string;
+    }, env?: EnvReader): {
+        model?: ModelConfig;
+        action: ActionFn;
+    };
+    private getAction;
+    private resolveOpenAIAction;
+    private createAutoPassthroughAction;
+    private listCandidateModels;
+    private compareModelPriority;
+    private getDefaultScore;
+    private getDefaultModes;
+    private getModelModalities;
+    private getModelEnvRequirements;
+    private getMissingEnv;
+    private handleModality;
+    private handleChatCompletions;
+    static listModels(aiService: AIService, options: {
+        env: EnvReader;
+        identity: "guest" | "user" | "admin";
+    }): PublicModel[];
+    private toPublicModel;
+}
+export {};
+//# sourceMappingURL=ai-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-service.d.ts","sourceRoot":"","sources":["../../../src/service/ai/ai-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAEV,WAAW,EAEX,WAAW,EACZ,MAAM,YAAY,CAAC;AAQpB,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AASrD,qBAAa,SAAU,SAAQ,OAAO;IACpC,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAkC;IAElD,0CAA0C;IAC1C,OAAO,CAAC,eAAe,CAA+B;;IA4BtD,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,EAAE,GAAG,IAAI;IAarD,UAAU,IAAI,WAAW,EAAE;IAI3B,SAAS,IAAI,OAAO;IAMpB,OAAO,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG;QAAE,KAAK,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,QAAQ,CAAA;KAAE;IA2B7G,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,2BAA2B;IAmCnC,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,aAAa;YAQP,cAAc;YAiBd,qBAAqB;IAmBnC,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;QAC/C,GAAG,EAAE,SAAS,CAAC;QACf,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;KACtC,GAAG,WAAW,EAAE;IAYjB,OAAO,CAAC,aAAa;CAgBtB"}

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

@@ -0,0 +1,262 @@
+/**
+ * AI Service 模块。
+ *
+ * AIService 处理所有 AI 通路（SDK 通路 + OpenAI 兼容通路）。
+ * 通过 action() 注册 modality action，通过 resolve() 匹配模型和 action。
+ *
+ * 鉴权由 City 在路由入口统一强制执行。
+ *
+ * 路由（City 自动生成）：
+ * - POST /v1/ai/text             — 文本生成
+ * - POST /v1/ai/stream           — 流式生成
+ * - POST /v1/ai/image            — 图片生成
+ * - POST /v1/ai/video            — 视频生成
+ * - POST /v1/ai/chat/completions — OpenAI 兼容端点
+ * - GET  /v1/ai/models           — 模型列表
+ */
+import { Service } from "../service.js";
+import { httpError } from "../../utils/helpers.js";
+/** AIService 支持的 SDK 通路模态列表 */
+const MODALITIES = ["text", "stream", "image", "video", "tts", "asr"];
+/** 用户侧默认以 text 模态排序模型 */
+const DEFAULT_MODEL_MODE = "text";
+/**
+ * 判断一个值是否为 HTTP Response。
+ */
+function isResponse(value) {
+    return typeof value === "object" && value !== null && "status" in value && "headers" in value;
+}
+export class AIService extends Service {
+    /** 模型注册表 */
+    modelMap = new Map();
+    /** SDK 通路 action 映射（modality → action） */
+    modalityActions = new Map();
+    constructor() {
+        super({ id: "ai", name: "AI" });
+        // 为每个 modality 注册 routing action
+        for (const modality of MODALITIES) {
+            this.action(modality, async (ctx) => this.handleModality(modality, ctx), {
+                auth: ["user", "admin"],
+            });
+        }
+        // OpenAI 兼容端点
+        this.action("chat/completions", async (ctx) => this.handleChatCompletions(ctx), {
+            auth: ["user", "admin"],
+        });
+        // 模型列表走同一路径，根据身份决定可见范围。
+        this.action("models", (ctx) => ({
+            items: AIService.listModels(this, {
+                env: ctx.env,
+                identity: ctx.identity?.kind ?? "guest",
+            }),
+        }), { method: "GET", auth: ["user", "admin"] });
+    }
+    // ========== 模型注册 ==========
+    use(...inputs) {
+        const configs = [];
+        for (const input of inputs) {
+            if (Array.isArray(input))
+                configs.push(...input);
+            else
+                configs.push(input);
+        }
+        for (const config of configs) {
+            if (this.modelMap.has(config.id))
+                throw new Error(`Duplicate model: ${config.id}`);
+            this.modelMap.set(config.id, config);
+        }
+        return this;
+    }
+    listModels() {
+        return [...this.modelMap.values()];
+    }
+    hasAction() {
+        return this.modelMap.size > 0;
+    }
+    // ========== 模型匹配 ==========
+    resolve(query, env) {
+        const { model: modelId, mode } = query;
+        const isOpenAIMode = mode === "openai";
+        if (modelId) {
+            const model = this.modelMap.get(modelId);
+            if (!model)
+                throw httpError(422, `Unknown model: ${modelId}`);
+            const action = isOpenAIMode ? this.resolveOpenAIAction(model) : this.getAction(model, mode);
+            if (!action)
+                throw httpError(422, `Model ${modelId} does not support mode: ${mode ?? "text"}`);
+            return { model, action };
+        }
+        const candidates = this.listCandidateModels(mode, env);
+        const defaultModel = candidates[0];
+        if (defaultModel) {
+            const action = isOpenAIMode ? this.resolveOpenAIAction(defaultModel) : this.getAction(defaultModel, mode);
+            if (action)
+                return { model: defaultModel, action };
+        }
+        if (this.modelMap.size > 0) {
+            if (env)
+                throw httpError(422, `No available model for mode: ${mode ?? DEFAULT_MODEL_MODE}`);
+            throw httpError(422, `No action for mode: ${mode ?? DEFAULT_MODEL_MODE}`);
+        }
+        throw httpError(422, `No model registered`);
+    }
+    getAction(model, mode) {
+        return model.actions[(mode ?? "text")];
+    }
+    resolveOpenAIAction(model) {
+        if (model.actions.openai)
+            return model.actions.openai;
+        if (model.baseURL && model.envKey)
+            return this.createAutoPassthroughAction(model);
+        return undefined;
+    }
+    createAutoPassthroughAction(model) {
+        const baseURL = model.baseURL;
+        const envKey = model.envKey;
+        const passthroughModel = model.passthroughModel;
+        return async (ctx) => {
+            const apiKey = ctx.env(envKey);
+            if (!apiKey) {
+                return new Response(JSON.stringify({
+                    error: { message: `${envKey} is required`, type: "authentication_error" },
+                }), { status: 401, headers: { "content-type": "application/json" } });
+            }
+            const body = { ...ctx.input };
+            if (passthroughModel) {
+                body.model = passthroughModel;
+            }
+            const response = await fetch(`${baseURL}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "Authorization": `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+            });
+            return new Response(response.body, {
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+            });
+        };
+    }
+    listCandidateModels(mode, env) {
+        const candidates = [...this.modelMap.values()].filter((model) => {
+            const action = mode === "openai" ? this.resolveOpenAIAction(model) : this.getAction(model, mode);
+            return Boolean(action);
+        });
+        const readyCandidates = env
+            ? candidates.filter((model) => this.getMissingEnv(model, env).length === 0)
+            : candidates;
+        return readyCandidates.sort((a, b) => this.compareModelPriority(a, b, mode ?? DEFAULT_MODEL_MODE));
+    }
+    compareModelPriority(a, b, mode) {
+        const scoreDiff = this.getDefaultScore(b, mode) - this.getDefaultScore(a, mode);
+        if (scoreDiff !== 0)
+            return scoreDiff;
+        return 0;
+    }
+    getDefaultScore(model, mode) {
+        const defaultModes = this.getDefaultModes(model);
+        if (defaultModes.includes(mode))
+            return 3;
+        if (defaultModes.includes(DEFAULT_MODEL_MODE))
+            return 2;
+        if (defaultModes.length > 0)
+            return 1;
+        return 0;
+    }
+    getDefaultModes(model) {
+        const modalities = this.getModelModalities(model);
+        if (model.default === true)
+            return modalities;
+        if (Array.isArray(model.default))
+            return model.default.filter((mode) => modalities.includes(mode));
+        return [];
+    }
+    getModelModalities(model) {
+        const modalities = Object.keys(model.actions).filter((key) => model.actions[key] !== undefined);
+        if (!modalities.includes("openai") && this.resolveOpenAIAction(model))
+            modalities.push("openai");
+        return modalities;
+    }
+    getModelEnvRequirements(model) {
+        const requirements = model.env
+            ? Object.entries(model.env)
+            : model.envKey
+                ? [[model.envKey, `${model.id} API Key`]]
+                : [];
+        return requirements.map(([key, description]) => ({
+            key,
+            description,
+            required: true,
+        }));
+    }
+    getMissingEnv(model, env) {
+        return this.getModelEnvRequirements(model)
+            .filter((item) => item.required && !env(item.key))
+            .map((item) => item.key);
+    }
+    // ========== SDK 通路 ==========
+    async handleModality(modality, ctx) {
+        const resolved = this.resolve({ model: ctx.input.model, mode: modality }, ctx.env);
+        const aiCtx = { ...ctx, variant: resolved.model ? { id: resolved.model.id, name: resolved.model.name, meta: resolved.model.meta } : undefined };
+        try {
+            const output = await resolved.action(aiCtx);
+            if (isResponse(output))
+                return output;
+            return output;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const status = error.statusCode ?? 500;
+            return new Response(JSON.stringify({ error: message }), { status, headers: { "content-type": "application/json" } });
+        }
+    }
+    // ========== OpenAI 兼容通路 ==========
+    async handleChatCompletions(ctx) {
+        const body = ctx.input;
+        const modelId = body.model;
+        const resolved = this.resolve({ model: modelId, mode: "openai" }, ctx.env);
+        const aiCtx = { ...ctx, input: body, variant: resolved.model ? { id: resolved.model.id, name: resolved.model.name, meta: resolved.model.meta } : undefined };
+        try {
+            const output = await resolved.action(aiCtx);
+            if (isResponse(output))
+                return output;
+            return new Response(JSON.stringify(output), { status: 200, headers: { "content-type": "application/json" } });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const status = error.statusCode ?? 500;
+            return new Response(JSON.stringify({ error: { message, type: "server_error" } }), { status, headers: { "content-type": "application/json" } });
+        }
+    }
+    // ========== 模型列表 ==========
+    static listModels(aiService, options) {
+        const { env, identity } = options;
+        const includeAdminFields = identity === "admin";
+        const items = identity === "admin"
+            ? [...aiService.modelMap.values()]
+            : [...aiService.modelMap.values()].filter((config) => aiService.getMissingEnv(config, env).length === 0);
+        return items
+            .sort((a, b) => aiService.compareModelPriority(a, b, DEFAULT_MODEL_MODE))
+            .map((config) => aiService.toPublicModel(config, includeAdminFields));
+    }
+    toPublicModel(config, includeAdminFields = false) {
+        return {
+            id: config.id,
+            name: config.name,
+            description: config.description ?? "",
+            modalities: this.getModelModalities(config),
+            tags: config.tags ?? [],
+            meta: config.meta ?? {},
+            ...(includeAdminFields
+                ? {
+                    env_requirements: this.getModelEnvRequirements(config),
+                    default_modes: this.getDefaultModes(config),
+                }
+                : {}),
+        };
+    }
+}
+//# sourceMappingURL=ai-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-service.js","sourceRoot":"","sources":["../../../src/service/ai/ai-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AASnD,+BAA+B;AAC/B,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAC/E,yBAAyB;AACzB,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAKlC;;GAEG;AACH,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,CAAC;AAChG,CAAC;AAED,MAAM,OAAO,SAAU,SAAQ,OAAO;IACpC,YAAY;IACJ,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAElD,0CAA0C;IAClC,eAAe,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEtD;QACE,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhC,iCAAiC;QACjC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE;gBACvE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;aACxB,CAAC,CAAC;QACL,CAAC;QAED,cAAc;QACd,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE;YAC9E,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;SACxB,CAAC,CAAC;QAEH,wBAAwB;QACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE;gBAChC,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,OAAO;aACxC,CAAC;SACH,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,6BAA6B;IAE7B,GAAG,CAAC,GAAG,MAAuC;QAC5C,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;;gBAC5C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YACnF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,6BAA6B;IAE7B,OAAO,CAAC,KAAwC,EAAE,GAAe;QAC/D,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QACvC,MAAM,YAAY,GAAG,IAAI,KAAK,QAAQ,CAAC;QAEvC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK;gBAAE,MAAM,SAAS,CAAC,GAAG,EAAE,kBAAkB,OAAO,EAAE,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC5F,IAAI,CAAC,MAAM;gBAAE,MAAM,SAAS,CAAC,GAAG,EAAE,SAAS,OAAO,2BAA2B,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;YAC/F,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC3B,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAC1G,IAAI,MAAM;gBAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QACrD,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,GAAG;gBAAE,MAAM,SAAS,CAAC,GAAG,EAAE,gCAAgC,IAAI,IAAI,kBAAkB,EAAE,CAAC,CAAC;YAC5F,MAAM,SAAS,CAAC,GAAG,EAAE,uBAAuB,IAAI,IAAI,kBAAkB,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,SAAS,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAC9C,CAAC;IAEO,SAAS,CAAC,KAAkB,EAAE,IAAa;QACjD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,IAAI,MAAM,CAAuB,CAAC,CAAC;IAC/D,CAAC;IAEO,mBAAmB,CAAC,KAAkB;QAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACtD,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC;QAClF,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,2BAA2B,CAAC,KAAkB;QACpD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAQ,CAAC;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAO,CAAC;QAC7B,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;QAEhD,OAAO,KAAK,EAAE,GAAY,EAAqB,EAAE;YAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;oBACjC,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,EAAE,IAAI,EAAE,sBAAsB,EAAE;iBAC1E,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;YACxE,CAAC;YAED,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,EAA6B,CAAC;YACzD,IAAI,gBAAgB,EAAE,CAAC;gBACrB,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC;YAChC,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,mBAAmB,EAAE;gBAC1D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU,MAAM,EAAE;oBACnC,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;YAEH,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;gBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;aAC1B,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAEO,mBAAmB,CAAC,IAAa,EAAE,GAAe;QACxD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9D,MAAM,MAAM,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACjG,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,MAAM,eAAe,GAAG,GAAG;YACzB,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;YAC3E,CAAC,CAAC,UAAU,CAAC;QAEf,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,IAAI,kBAAkB,CAAC,CAAC,CAAC;IACrG,CAAC;IAEO,oBAAoB,CAAC,CAAc,EAAE,CAAc,EAAE,IAAY;QACvE,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAChF,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,eAAe,CAAC,KAAkB,EAAE,IAAY;QACtD,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,YAAY,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YAAE,OAAO,CAAC,CAAC;QACxD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,eAAe,CAAC,KAAkB;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;YAAE,OAAO,UAAU,CAAC;QAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACnG,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,kBAAkB,CAAC,KAAkB;QAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;QAChG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjG,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,uBAAuB,CAAC,KAAkB;QAChD,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG;YAC5B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;YAC3B,CAAC,CAAC,KAAK,CAAC,MAAM;gBACZ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;gBACzC,CAAC,CAAC,EAAE,CAAC;QAET,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,GAAG;YACH,WAAW;YACX,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,aAAa,CAAC,KAAkB,EAAE,GAAc;QACtD,OAAO,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC;aACvC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aACjD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,+BAA+B;IAEvB,KAAK,CAAC,cAAc,CAAC,QAAkB,EAAE,GAAY;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACzG,MAAM,KAAK,GAAY,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QAEzJ,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;YACtC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,MAAM,GAAI,KAAiC,CAAC,UAAU,IAAI,GAAG,CAAC;YACpE,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACvH,CAAC;IACH,CAAC;IAED,oCAAoC;IAE5B,KAAK,CAAC,qBAAqB,CAAC,GAAY;QAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAgC,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,KAA2B,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAY,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QAEtK,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;YACtC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAChH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,MAAM,GAAI,KAAiC,CAAC,UAAU,IAAI,GAAG,CAAC;YACpE,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACjJ,CAAC;IACH,CAAC;IAED,6BAA6B;IAE7B,MAAM,CAAC,UAAU,CAAC,SAAoB,EAAE,OAGvC;QACC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAClC,MAAM,kBAAkB,GAAG,QAAQ,KAAK,OAAO,CAAC;QAChD,MAAM,KAAK,GAAG,QAAQ,KAAK,OAAO;YAChC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAClC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;QAE3G,OAAO,KAAK;aACT,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;aACxE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC1E,CAAC;IAEO,aAAa,CAAC,MAAmB,EAAE,kBAAkB,GAAG,KAAK;QACnE,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;YACrC,UAAU,EAAE,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC;YAC3C,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;YACvB,GAAG,CAAC,kBAAkB;gBACpB,CAAC,CAAC;oBACE,gBAAgB,EAAE,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC;oBACtD,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;iBAC5C;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;CACF"}

package/bin/service/ai/openai-compatible-provider.d.ts

@@ -0,0 +1,54 @@
+/**
+ * OpenAI-compatible Provider 构造工具。
+ *
+ * 负责把 OpenAI 兼容上游包装成 Downcity 的 SDK 通路：
+ * - text   → 返回 AI SDK `UIMessage`
+ * - stream → 返回 AI SDK `UIMessageStreamResponse`
+ *
+ * 关键说明（中文）
+ * - `/chat/completions` 仍由 AIService 的自动透传处理
+ * - 这里专门补齐 UserClient.ai.text() / stream() 所需的 server 侧 action
+ * - 不在请求热路径里做动态导入，减少首请求和冷启动额外开销
+ */
+import type { LanguageModel } from "ai";
+import { Provider } from "./provider.js";
+/**
+ * OpenAI-compatible Provider 配置。
+ */
+export interface OpenAICompatibleProviderOptions {
+    /** Provider 唯一 ID，用于模型注册和日志标识。 */
+    id: string;
+    /** 运行时 API Key 对应的环境变量 key。 */
+    envKey: string;
+    /** OpenAI-compatible 上游 baseURL。 */
+    baseURL: string;
+    /** 该 Provider 默认绑定的上游模型 ID。 */
+    defaultModelId: string;
+}
+/**
+ * OpenAI-compatible client 工厂入参。
+ */
+export interface OpenAICompatibleClientConfig {
+    /** 上游 API Key。 */
+    apiKey: string;
+    /** 上游 OpenAI-compatible baseURL。 */
+    baseURL: string;
+    /** Provider 展示名称，通常用于底层 SDK 调试和埋点。 */
+    name: string;
+}
+/**
+ * OpenAI-compatible chat client 最小能力约束。
+ */
+export interface OpenAICompatibleClient {
+    /** 根据模型 ID 创建可传给 AI SDK 的 chat model。 */
+    chat(modelId: string): LanguageModel;
+}
+/**
+ * OpenAI-compatible client 工厂签名。
+ */
+export type OpenAICompatibleClientFactory = (config: OpenAICompatibleClientConfig) => OpenAICompatibleClient;
+/**
+ * 创建 OpenAI-compatible Provider。
+ */
+export declare function createOpenAICompatibleProvider(options: OpenAICompatibleProviderOptions, createClient: OpenAICompatibleClientFactory): Provider;
+//# sourceMappingURL=openai-compatible-provider.d.ts.map

package/bin/service/ai/openai-compatible-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible-provider.d.ts","sourceRoot":"","sources":["../../../src/service/ai/openai-compatible-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAqB,aAAa,EAAsB,MAAM,IAAI,CAAC;AAE/E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAC1C,MAAM,EAAE,4BAA4B,KACjC,sBAAsB,CAAC;AAoC5B;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,EACxC,YAAY,EAAE,6BAA6B,GAC1C,QAAQ,CASV"}