@downcity/city 0.2.153 → 0.2.157

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

@@ -0,0 +1,26 @@
+/**
+ * AI 模型推理强度解析模块。
+ *
+ * AIService 在最终模型路由完成后调用本模块进行校验和默认值解析。
+ * Provider 只能读取这里写入 Context.locals 的可信结果，再映射厂商参数。
+ */
+import type { Context } from "../service.js";
+import type { AIResolvedReasoning } from "../../types/AIReasoning.js";
+import type { ModelConfig } from "./types.js";
+/**
+ * 在模型注册阶段校验推理能力配置。
+ */
+export declare function validate_model_reasoning(model: ModelConfig): void;
+/**
+ * 按最终执行模型解析一次请求的推理强度。
+ */
+export declare function resolve_model_reasoning(model: ModelConfig, input: Record<string, unknown>): AIResolvedReasoning | undefined;
+/**
+ * 将已解析推理强度写入 Provider 上下文、请求体和计量元数据。
+ */
+export declare function attach_resolved_reasoning(ctx: Context, reasoning: AIResolvedReasoning | undefined): void;
+/**
+ * 读取 AIService 已校验的推理强度。
+ */
+export declare function read_resolved_reasoning(ctx: Context): AIResolvedReasoning | undefined;
+//# sourceMappingURL=reasoning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning.d.ts","sourceRoot":"","sources":["../../../src/service/ai/reasoning.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAmCjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,mBAAmB,GAAG,SAAS,CAoCjC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,mBAAmB,GAAG,SAAS,GACzC,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAUrF"}

package/bin/service/ai/reasoning.js

@@ -0,0 +1,118 @@
+/**
+ * AI 模型推理强度解析模块。
+ *
+ * AIService 在最终模型路由完成后调用本模块进行校验和默认值解析。
+ * Provider 只能读取这里写入 Context.locals 的可信结果，再映射厂商参数。
+ */
+import { httpError } from "../../utils/helpers.js";
+/** Context.locals 中保存已解析推理强度的固定字段名。 */
+const AI_REASONING_LOCAL_KEY = "ai_reasoning";
+/**
+ * 在模型注册阶段校验推理能力配置。
+ */
+export function validate_model_reasoning(model) {
+    const reasoning = model.reasoning;
+    if (!reasoning)
+        return;
+    if (!Array.isArray(reasoning.efforts) || reasoning.efforts.length === 0) {
+        throw new Error(`Model ${model.id} reasoning.efforts must not be empty`);
+    }
+    const effort_ids = new Set();
+    for (const effort of reasoning.efforts) {
+        const effort_id = effort.id.trim();
+        if (!effort_id) {
+            throw new Error(`Model ${model.id} reasoning effort id is required`);
+        }
+        if (effort.id !== effort_id) {
+            throw new Error(`Model ${model.id} reasoning effort id must not contain surrounding whitespace`);
+        }
+        if (!effort.name.trim()) {
+            throw new Error(`Model ${model.id} reasoning effort ${effort_id} name is required`);
+        }
+        if (effort_ids.has(effort_id)) {
+            throw new Error(`Model ${model.id} has duplicate reasoning effort: ${effort_id}`);
+        }
+        effort_ids.add(effort_id);
+    }
+    const default_effort = reasoning.default_effort?.trim();
+    if (reasoning.default_effort !== undefined && reasoning.default_effort !== default_effort) {
+        throw new Error(`Model ${model.id} default reasoning effort must not contain surrounding whitespace`);
+    }
+    if (reasoning.default_effort !== undefined && !default_effort) {
+        throw new Error(`Model ${model.id} default reasoning effort must not be empty`);
+    }
+    if (default_effort && !effort_ids.has(default_effort)) {
+        throw new Error(`Model ${model.id} has unknown default reasoning effort: ${default_effort}`);
+    }
+}
+/**
+ * 按最终执行模型解析一次请求的推理强度。
+ */
+export function resolve_model_reasoning(model, input) {
+    if (input.effort_id !== undefined) {
+        throw httpError(422, "effort_id is not supported; use reasoning_effort");
+    }
+    const requested_value = input.reasoning_effort;
+    const has_requested_effort = requested_value !== undefined;
+    if (has_requested_effort && typeof requested_value !== "string") {
+        throw httpError(422, "reasoning_effort must be a string");
+    }
+    const requested_effort = typeof requested_value === "string"
+        ? requested_value.trim()
+        : undefined;
+    if (has_requested_effort && !requested_effort) {
+        throw httpError(422, "reasoning_effort must not be empty");
+    }
+    const reasoning = model.reasoning;
+    if (!reasoning) {
+        if (requested_effort) {
+            throw httpError(422, `Model ${model.id} does not support reasoning_effort`);
+        }
+        return undefined;
+    }
+    const effort = requested_effort ?? reasoning.default_effort?.trim();
+    if (!effort)
+        return undefined;
+    if (!reasoning.efforts.some((item) => item.id === effort)) {
+        throw httpError(422, `Model ${model.id} does not support reasoning_effort: ${effort}`);
+    }
+    return {
+        effort,
+        source: requested_effort ? "request" : "default",
+    };
+}
+/**
+ * 将已解析推理强度写入 Provider 上下文、请求体和计量元数据。
+ */
+export function attach_resolved_reasoning(ctx, reasoning) {
+    if (!reasoning)
+        return;
+    ctx.locals[AI_REASONING_LOCAL_KEY] = reasoning;
+    ctx.input.reasoning_effort = reasoning.effort;
+    ctx.metering = {
+        ...ctx.metering,
+        metadata: {
+            ...(ctx.metering?.metadata ?? {}),
+            reasoning_effort: reasoning.effort,
+            reasoning_effort_source: reasoning.source,
+        },
+    };
+}
+/**
+ * 读取 AIService 已校验的推理强度。
+ */
+export function read_resolved_reasoning(ctx) {
+    const value = ctx.locals[AI_REASONING_LOCAL_KEY];
+    if (!value || typeof value !== "object")
+        return undefined;
+    const record = value;
+    if (typeof record.effort !== "string")
+        return undefined;
+    if (record.source !== "request" && record.source !== "default")
+        return undefined;
+    return {
+        effort: record.effort,
+        source: record.source,
+    };
+}
+//# sourceMappingURL=reasoning.js.map

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

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

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

@@ -5,6 +5,7 @@
  */
 import type { ActionFn } from "../action.js";
 import type { AIBalanceBridge, AIProviderBillFn } from "./charge.js";
+import type { CityModelDescriptor, CityModelEnvRequirement, CityModelReasoning } from "@downcity/type";
 import type { LanguageModel } from "ai";
 /**
  * Provider 构造选项。
@@ -112,6 +113,8 @@ export interface ModelConfig {
     tags?: string[];
     /** 模型元数据 */
     meta?: Record<string, unknown>;
+    /** 模型支持的推理强度配置。 */
+    reasoning?: CityModelReasoning;
     /** 模型所需环境变量 */
     env?: Record<string, string>;
     /** Provider 的 baseURL（用于自动透传） */
@@ -127,36 +130,14 @@ export interface ModelConfig {
     /** 本模型的出账方法，只生成扣费草稿，不直接扣余额。 */
     bill?: AIProviderBillFn;
 }
-export interface PublicModel {
-    /** 模型 ID */
-    id: string;
-    /** 模型展示名称 */
-    name: string;
-    /** 模型描述 */
-    description: string;
-    /** 模型支持的 modality 列表 */
-    modalities: string[];
-    /** 模型标签 */
-    tags: string[];
-    /** 模型元数据 */
-    meta: Record<string, unknown>;
-    /** 模型依赖的环境变量需求（通常仅在 admin 身份下返回） */
-    env_requirements?: AIModelEnvRequirement[];
-}
+export type PublicModel = CityModelDescriptor;
 /**
  * AI 模型环境变量需求。
  *
  * 用于 admin 视角展示某个模型依赖哪些运行时 key，
  * 以及这些 key 当前是否已经配置完成。
  */
-export interface AIModelEnvRequirement {
-    /** 环境变量 key，例如 `DEEPSEEK_API_KEY` */
-    key: string;
-    /** 给管理员展示的说明文本 */
-    description: string;
-    /** 当前是否必须提供该 key 才能调用模型 */
-    required: boolean;
-}
+export type AIModelEnvRequirement = CityModelEnvRequirement;
 /**
  * AIService 配置。
  */

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

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

package/bin/types/AIReasoning.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AI 推理强度运行时类型。
+ *
+ * 这里的结构只表示 AIService 已完成模型校验后的可信结果，不能直接由请求体构造。
+ */
+/** 已解析的模型推理强度。 */
+export interface AIResolvedReasoning {
+    /** 最终模型接受的推理强度档位 ID。 */
+    effort: string;
+    /** 档位来自调用方请求还是模型默认配置。 */
+    source: "request" | "default";
+}
+/** AI SDK provider option 支持的 JSON 值。 */
+export type AIProviderOptionValue = null | string | number | boolean | AIProviderOptionObject | AIProviderOptionValue[];
+/** 单个 AI SDK Provider 的 JSON 参数对象。 */
+export interface AIProviderOptionObject {
+    /** Provider 私有参数值。 */
+    [key: string]: AIProviderOptionValue | undefined;
+}
+/** 按 AI SDK Provider ID 分组的 providerOptions。 */
+export interface AIProviderOptions {
+    /** 指定 Provider 的私有参数对象。 */
+    [provider_id: string]: AIProviderOptionObject;
+}
+//# sourceMappingURL=AIReasoning.d.ts.map

package/bin/types/AIReasoning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIReasoning.d.ts","sourceRoot":"","sources":["../../src/types/AIReasoning.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B;AAED,yCAAyC;AACzC,MAAM,MAAM,qBAAqB,GAC7B,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,sBAAsB,GACtB,qBAAqB,EAAE,CAAC;AAE5B,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC,sBAAsB;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;CAClD;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,CAAC;CAC/C"}

package/bin/types/AIReasoning.js

@@ -0,0 +1,7 @@
+/**
+ * AI 推理强度运行时类型。
+ *
+ * 这里的结构只表示 AIService 已完成模型校验后的可信结果，不能直接由请求体构造。
+ */
+export {};
+//# sourceMappingURL=AIReasoning.js.map

package/bin/types/AIReasoning.js.map

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

package/bin/types/AIRouting.d.ts

@@ -0,0 +1,37 @@
+/**
+ * AI 模型运行时路由类型。
+ *
+ * 用于描述模型 action 解析结果、媒体 fallback 计划以及路由模块所需的模型访问能力。
+ */
+import type { ActionFn } from "../service/action.js";
+import type { ModelConfig } from "../service/ai/types.js";
+/** 已解析的模型 action。 */
+export interface AIResolvedAction {
+    /** 本次 action 绑定的最终模型配置。 */
+    model?: ModelConfig;
+    /** 本次请求实际执行的 Provider action。 */
+    action: ActionFn;
+}
+/** 模型发生 fallback 的标准原因。 */
+export type AIRoutingFallbackReason = "input_requires_media";
+/** 最终模型路由计划。 */
+export interface AIResolvedRoutingPlan {
+    /** 最终执行的模型和 action。 */
+    resolved: AIResolvedAction;
+    /** 发生 fallback 时的原模型 ID。 */
+    fallback_from?: string;
+    /** 发生 fallback 时的标准原因。 */
+    fallback_reason?: AIRoutingFallbackReason;
+    /** 触发 fallback 的媒体类型。 */
+    fallback_media_type?: string;
+}
+/** 媒体 fallback 路由访问模型注册表所需的最小能力。 */
+export interface AIModelRoutingAdapter {
+    /** 解析 fallback 规则中的模型 ID 或内联模型配置。 */
+    resolve_model(input: ModelConfig | string): ModelConfig | undefined;
+    /** 解析目标模型在指定通路下的 action。 */
+    resolve_action(model: ModelConfig, mode: string): ActionFn | undefined;
+    /** 判断目标模型当前是否满足环境变量等运行条件。 */
+    is_available(model: ModelConfig): boolean;
+}
+//# sourceMappingURL=AIRouting.d.ts.map

package/bin/types/AIRouting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIRouting.d.ts","sourceRoot":"","sources":["../../src/types/AIRouting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,qBAAqB;AACrB,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,iCAAiC;IACjC,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;AAE7D,gBAAgB;AAChB,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,oCAAoC;AACpC,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACpE,4BAA4B;IAC5B,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvE,6BAA6B;IAC7B,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;CAC3C"}

package/bin/types/AIRouting.js

@@ -0,0 +1,7 @@
+/**
+ * AI 模型运行时路由类型。
+ *
+ * 用于描述模型 action 解析结果、媒体 fallback 计划以及路由模块所需的模型访问能力。
+ */
+export {};
+//# sourceMappingURL=AIRouting.js.map

package/bin/types/AIRouting.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/city",
-  "version": "0.2.153",
+  "version": "0.2.157",
   "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.108",
+    "@downcity/type": "0.1.112",
     "ai": "^6.0.193",
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.23"