@downcity/city 0.2.191 → 0.2.192

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

@@ -0,0 +1,73 @@
+/**
+ * AIService 值解析与类型守卫模块。
+ *
+ * 集中管理 Provider 输出、usage 和图片任务数据的纯函数转换，让 AIService 主模块
+ * 只保留路由、生命周期与持久化编排。
+ */
+import type { AsyncJobRecord } from "../../types/AsyncJob.js";
+import type { AIProviderChargedOutput, AIProviderChargedResponse, AIProviderChargeLine } from "./charge.js";
+import type { AIImageProviderCreateResult, AIImageProviderResult } from "./job-types.js";
+/** Provider action 拆包后的统一输出。 */
+export interface ResolvedProviderOutput {
+    /** Provider 对外输出。 */
+    output: unknown;
+    /** Provider 计算的可选扣费行。 */
+    charge?: AIProviderChargeLine | Promise<AIProviderChargeLine | undefined>;
+}
+/** 可转存到 Federation storage 的图片文件 part。 */
+export type StoredImagePart = Record<string, unknown> & {
+    /** 固定文件 part 类型。 */
+    type: "file";
+    /** 可抓取的 HTTP(S) URL。 */
+    url: string;
+};
+/** 判断一个值是否为 HTTP Response。 */
+export declare function isResponse(value: unknown): value is Response;
+/** 判断一个值是否为普通对象。 */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** 判断 Provider 是否返回了带账单 Response。 */
+export declare function isProviderChargedResponse(value: unknown): value is AIProviderChargedResponse;
+/** 判断 Provider 是否返回了带账单普通输出。 */
+export declare function isProviderChargedOutput(value: unknown): value is AIProviderChargedOutput;
+/** 判断一个值是否为 Promise-like。 */
+export declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
+/** 读取可选字符串。 */
+export declare function readOptionalString(value: unknown): string | undefined;
+/** 读取可选数字。 */
+export declare function readOptionalNumber(value: unknown): number | undefined;
+/** 读取正数配置。 */
+export declare function normalizePositiveNumber(value: unknown, fallback: number): number;
+/** 安全解析 JSON 对象。 */
+export declare function parseRecordJson(value: unknown): Record<string, unknown>;
+/** 安全解析 UIMessage。 */
+export declare function parseImageMessage(value: unknown): AIImageProviderResult["result"] | undefined;
+/** 把 TableApi 普通行转成图片任务记录。 */
+export declare function rowToAsyncJobRecord(row: Record<string, unknown>): AsyncJobRecord;
+/** 保留已知 HTTP 错误状态，其它异常统一包装成上游错误。 */
+export declare function imageActionError(error: unknown, fallback_message: string): Error;
+/** 从输出对象中读取 Provider usage。 */
+export declare function extractUsage(output: unknown): unknown;
+/** 兼容常见 Provider usage 字段。 */
+export declare function normalizeUsage(usage: unknown): {
+    /** 输入 token 数。 */
+    input_tokens?: number;
+    /** 输出 token 数。 */
+    output_tokens?: number;
+    /** 缓存命中的输入 token 数。 */
+    cached_tokens?: number;
+    /** 推理 token 数。 */
+    reasoning_tokens?: number;
+};
+/** 统计 UIMessage file parts 里的图片数量。 */
+export declare function countImageOutputs(output: unknown): number | undefined;
+/** 判断 file part URL 是否是可转存的远程 URL。 */
+export declare function isStorableRemoteFilePart(part: unknown): part is StoredImagePart;
+/** 读取 file part 的媒体类型。 */
+export declare function readFilePartMediaType(part: Record<string, unknown>): string;
+/** 读取 file part 的建议文件名。 */
+export declare function readFilePartFilename(part: Record<string, unknown>): string | undefined;
+/** 判断 Provider 是否返回了图片任务创建结果。 */
+export declare function isImageProviderCreateResult(value: unknown): value is AIImageProviderCreateResult;
+/** 判断 Provider 是否返回了图片任务查询结果。 */
+export declare function isImageProviderResult(value: unknown): value is AIImageProviderResult;
+//# sourceMappingURL=ai-service-values.d.ts.map

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

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

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

@@ -0,0 +1,177 @@
+/**
+ * AIService 值解析与类型守卫模块。
+ *
+ * 集中管理 Provider 输出、usage 和图片任务数据的纯函数转换，让 AIService 主模块
+ * 只保留路由、生命周期与持久化编排。
+ */
+import { httpError } from "../../utils/helpers.js";
+import { normalizeAIUsage } from "./helpers.js";
+/** 判断一个值是否为 HTTP Response。 */
+export function isResponse(value) {
+    return typeof value === "object" && value !== null && "status" in value && "headers" in value;
+}
+/** 判断一个值是否为普通对象。 */
+export function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+/** 判断 Provider 是否返回了带账单 Response。 */
+export function isProviderChargedResponse(value) {
+    return isRecord(value) && value.response instanceof Response;
+}
+/** 判断 Provider 是否返回了带账单普通输出。 */
+export function isProviderChargedOutput(value) {
+    return isRecord(value) && "output" in value;
+}
+/** 判断一个值是否为 Promise-like。 */
+export function isPromiseLike(value) {
+    return Boolean(value && typeof value === "object" && "then" in value && typeof value.then === "function");
+}
+/** 读取可选字符串。 */
+export function readOptionalString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+/** 读取可空字符串字段。 */
+function readNullableString(value) {
+    return typeof value === "string" ? value : null;
+}
+/** 读取可空数字字符串字段。 */
+function readNullableNumberString(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return String(value);
+    return typeof value === "string" && value.trim() ? value : null;
+}
+/** 读取可选数字。 */
+export function readOptionalNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value !== "string" || !value.trim())
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+/** 读取正数配置。 */
+export function normalizePositiveNumber(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+/** 读取任务状态。 */
+function readJobStatus(value) {
+    return value === "queued" || value === "running" || value === "fetching" || value === "succeeded" || value === "failed"
+        ? value
+        : "failed";
+}
+/** 安全解析 JSON 对象。 */
+export function parseRecordJson(value) {
+    if (typeof value !== "string" || !value.trim())
+        return {};
+    try {
+        const parsed = JSON.parse(value);
+        return isRecord(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** 安全解析 UIMessage。 */
+export function parseImageMessage(value) {
+    const record = parseRecordJson(value);
+    return record.role === "assistant" && Array.isArray(record.parts)
+        ? record
+        : undefined;
+}
+/** 把 TableApi 普通行转成图片任务记录。 */
+export function rowToAsyncJobRecord(row) {
+    return {
+        job_id: String(row.job_id ?? ""),
+        job_type: String(row.job_type ?? ""),
+        status: readJobStatus(row.status),
+        input_json: String(row.input_json ?? "{}"),
+        state_json: readNullableString(row.state_json),
+        result_json: readNullableString(row.result_json),
+        error: readNullableString(row.error),
+        message: readNullableString(row.message),
+        poll_after_ms: readNullableNumberString(row.poll_after_ms),
+        city_id: readNullableString(row.city_id),
+        user_id: readNullableString(row.user_id),
+        service_id: readNullableString(row.service_id),
+        model_id: readNullableString(row.model_id),
+        created_at: String(row.created_at ?? ""),
+        updated_at: String(row.updated_at ?? ""),
+    };
+}
+/** 保留已知 HTTP 错误状态，其它异常统一包装成上游错误。 */
+export function imageActionError(error, fallback_message) {
+    if (error instanceof Error && typeof error.statusCode === "number")
+        return error;
+    return httpError(502, error instanceof Error ? error.message : fallback_message);
+}
+/** 从输出对象中读取 Provider usage。 */
+export function extractUsage(output) {
+    if (!isRecord(output))
+        return undefined;
+    const metadata = isRecord(output.metadata) ? output.metadata : undefined;
+    if (metadata && "usage" in metadata)
+        return metadata.usage;
+    if (metadata && "usageMetadata" in metadata)
+        return metadata.usageMetadata;
+    if ("usage" in output)
+        return output.usage;
+    return undefined;
+}
+/** 兼容常见 Provider usage 字段。 */
+export function normalizeUsage(usage) {
+    return normalizeAIUsage(usage);
+}
+/** 统计 UIMessage file parts 里的图片数量。 */
+export function countImageOutputs(output) {
+    if (!isRecord(output) || !Array.isArray(output.parts))
+        return undefined;
+    const count = output.parts.filter((part) => {
+        if (!isRecord(part))
+            return false;
+        const type = String(part.type ?? "");
+        const media_type = String(part.mediaType ?? part.media_type ?? "");
+        return type === "file" && media_type.startsWith("image/");
+    }).length;
+    return count > 0 ? count : undefined;
+}
+/** 判断 file part URL 是否是可转存的远程 URL。 */
+export function isStorableRemoteFilePart(part) {
+    if (!isRecord(part) || part.type !== "file")
+        return false;
+    const url = readOptionalString(part.url);
+    return Boolean(url && /^https?:\/\//iu.test(url));
+}
+/** 读取 file part 的媒体类型。 */
+export function readFilePartMediaType(part) {
+    return readOptionalString(part.mediaType) ?? readOptionalString(part.media_type) ?? "application/octet-stream";
+}
+/** 读取 file part 的建议文件名。 */
+export function readFilePartFilename(part) {
+    return readOptionalString(part.filename);
+}
+/** 判断 Provider 是否返回了图片任务创建结果。 */
+export function isImageProviderCreateResult(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const record = value;
+    return typeof record.job_id === "string" && Boolean(record.job_id.trim()) && isImageJobStatus(record.status);
+}
+/** 判断 Provider 是否返回了图片任务查询结果。 */
+export function isImageProviderResult(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const record = value;
+    if (typeof record.job_id !== "string" || !record.job_id.trim() || !isImageJobStatus(record.status))
+        return false;
+    if (record.status === "succeeded") {
+        const result = isRecord(record.result) ? record.result : undefined;
+        if (!result || result.role !== "assistant" || !Array.isArray(result.parts))
+            return false;
+    }
+    return true;
+}
+/** 判断图片任务状态。 */
+function isImageJobStatus(value) {
+    return value === "queued" || value === "running" || value === "succeeded" || value === "failed";
+}
+//# sourceMappingURL=ai-service-values.js.map

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

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

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

@@ -13,6 +13,7 @@
  * - POST /v1/ai/image/create     — 创建图片生成任务
  * - POST /v1/ai/image/result     — 查询图片生成任务
  * - POST /v1/ai/chat/completions — OpenAI 兼容端点
+ * - POST /v1/ai/language-model/stream — CityModel 原生 LanguageModelV3 端点
  * - GET  /v1/ai/models           — 模型列表
  */
 import { Service } from "../service.js";
@@ -47,6 +48,13 @@ export declare class AIService extends Service {
     /** 按媒体输入解析最终模型，推理强度必须在该步骤之后解析。 */
     private plan_text_execution;
     private handleModality;
+    /**
+     * 执行 CityModel 原生 LanguageModelV3 调用。
+     *
+     * 路由、fallback、reasoning 和计费仍由 AIService 统一拥有；transport 模块只负责
+     * 调用最终模型并编码 SSE，避免把 Provider 决策泄漏到客户端。
+     */
+    private handleLanguageModelStream;
     private createImageJob;
     private readImageJob;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"ai-service.d.ts","sourceRoot":"","sources":["../../../src/service/ai/ai-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI7C,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EAEX,WAAW,EACZ,MAAM,YAAY,CAAC;AAiDpB,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AA2PrD,qBAAa,SAAU,SAAQ,OAAO;IACpC,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,0CAA0C;IAC1C,OAAO,CAAC,eAAe,CAA+B;IAEtD,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAS;gBAE3C,OAAO,GAAE,gBAAqB;IA0C1C,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,EAAE,GAAG,IAAI;IAKrD,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;IAgB7G,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,2BAA2B;IAmCnC,OAAO,CAAC,kBAAkB;IAS1B,kCAAkC;IAClC,OAAO,CAAC,mBAAmB;YAkBb,cAAc;YAmCd,cAAc;YAgBd,YAAY;IAS1B;;OAEG;YACW,aAAa;IAuD3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAOjC;;OAEG;IACH,OAAO,CAAC,kCAAkC;IAc1C;;OAEG;YACW,iBAAiB;IAU/B;;;;;;;OAOG;YACW,2BAA2B;IAwDzC;;OAEG;YACW,cAAc;IAuB5B;;OAEG;YACW,eAAe;IAW7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;YAcV,qBAAqB;IAoCnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;;;;;;OAOG;YACW,QAAQ;IAMtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;YACW,YAAY;IA0D1B,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;CAMlB"}
+{"version":3,"file":"ai-service.d.ts","sourceRoot":"","sources":["../../../src/service/ai/ai-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EAEX,WAAW,EACZ,MAAM,YAAY,CAAC;AA4EpB,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAYrD,qBAAa,SAAU,SAAQ,OAAO;IACpC,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,0CAA0C;IAC1C,OAAO,CAAC,eAAe,CAA+B;IAEtD,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAS;gBAE3C,OAAO,GAAE,gBAAqB;IA+C1C,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,EAAE,GAAG,IAAI;IAKrD,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;IAgB7G,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,2BAA2B;IAmCnC,OAAO,CAAC,kBAAkB;IAS1B,kCAAkC;IAClC,OAAO,CAAC,mBAAmB;YAkBb,cAAc;IAiC5B;;;;;OAKG;YACW,yBAAyB;YA8CzB,cAAc;YAgBd,YAAY;IAS1B;;OAEG;YACW,aAAa;IAuD3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAOjC;;OAEG;IACH,OAAO,CAAC,kCAAkC;IAc1C;;OAEG;YACW,iBAAiB;IAU/B;;;;;;;OAOG;YACW,2BAA2B;IAwDzC;;OAEG;YACW,cAAc;IAuB5B;;OAEG;YACW,eAAe;IAW7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;YAcV,qBAAqB;IAoCnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;;;;;;OAOG;YACW,QAAQ;IAMtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;YACW,YAAY;IA0D1B,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;CAMlB"}

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

@@ -13,21 +13,25 @@
  * - POST /v1/ai/image/create     — 创建图片生成任务
  * - POST /v1/ai/image/result     — 查询图片生成任务
  * - POST /v1/ai/chat/completions — OpenAI 兼容端点
+ * - POST /v1/ai/language-model/stream — CityModel 原生 LanguageModelV3 端点
  * - GET  /v1/ai/models           — 模型列表
  */
 import { Service } from "../service.js";
 import { httpError } from "../../utils/helpers.js";
 import { sqliteAsyncJobs } from "../async-job/schema.js";
-import { normalizeAIUsage } from "./helpers.js";
 import { attach_resolved_reasoning, resolve_model_reasoning, } from "./reasoning.js";
 import { AIModelRegistry } from "./model-registry.js";
 import { resolve_text_routing_plan } from "./model-routing.js";
 import { claim_image_job, finish_image_job_fetch, release_image_job_claim, } from "./image-job-store.js";
 import { settle_response_charge } from "./charge-runtime.js";
+import { create_city_language_model_stream, decode_city_language_model_request, } from "./language-model-stream.js";
+import { countImageOutputs, extractUsage, imageActionError, isImageProviderCreateResult, isImageProviderResult, isPromiseLike, isProviderChargedOutput, isProviderChargedResponse, isResponse, isStorableRemoteFilePart, normalizePositiveNumber, normalizeUsage, parseImageMessage, parseRecordJson, readFilePartFilename, readFilePartMediaType, readOptionalNumber, readOptionalString, rowToAsyncJobRecord, } from "./ai-service-values.js";
 /** AIService 直接暴露的 SDK 通路模态列表。图片只通过 image/create + image/result 暴露。 */
 const MODALITIES = ["text", "stream", "video", "tts", "asr"];
 /** 用户侧默认以 text 模态排序模型 */
 const DEFAULT_MODEL_MODE = "text";
+/** CityModel 原生 LanguageModelV3 运行模式。 */
+const LANGUAGE_MODEL_MODE = "language_model";
 /** 图片任务的内部 action 列表。 */
 const IMAGE_ACTION_MODES = ["image_create", "image_fetch"];
 /** 图片生成任务在通用 async_jobs 表中的类型。 */
@@ -38,235 +42,14 @@ const IMAGE_FETCH_ACTION = "image/fetch";
 const DEFAULT_IMAGE_MAX_PENDING_DURATION_MS = 2 * 60 * 60 * 1000;
 /** 图片任务 pending 超时错误。 */
 const IMAGE_PENDING_TIMEOUT_ERROR = "upstream timeout";
-/**
- * 判断一个值是否为 HTTP Response。
- */
-function isResponse(value) {
-    return typeof value === "object" && value !== null && "status" in value && "headers" in value;
-}
-/**
- * 判断一个值是否为普通对象。
- */
-function isRecord(value) {
-    return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-/**
- * 判断 Provider 是否返回了带账单 Response。
- */
-function isProviderChargedResponse(value) {
-    return isRecord(value) && value.response instanceof Response;
-}
-/**
- * 判断 Provider 是否返回了带账单普通输出。
- */
-function isProviderChargedOutput(value) {
-    return isRecord(value) && "output" in value;
-}
-/**
- * 判断一个值是否为 Promise-like。
- */
-function isPromiseLike(value) {
-    return Boolean(value && typeof value === "object" && "then" in value && typeof value.then === "function");
-}
-/**
- * 读取可选字符串。
- */
-function readOptionalString(value) {
-    return typeof value === "string" && value.trim() ? value.trim() : undefined;
-}
-/**
- * 读取可空字符串字段。
- */
-function readNullableString(value) {
-    return typeof value === "string" ? value : null;
-}
-/**
- * 读取可空数字字符串字段。
- */
-function readNullableNumberString(value) {
-    if (typeof value === "number" && Number.isFinite(value))
-        return String(value);
-    return typeof value === "string" && value.trim() ? value : null;
-}
-/**
- * 读取可选数字。
- */
-function readOptionalNumber(value) {
-    if (typeof value === "number" && Number.isFinite(value))
-        return value;
-    if (typeof value !== "string" || !value.trim())
-        return undefined;
-    const parsed = Number(value);
-    return Number.isFinite(parsed) ? parsed : undefined;
-}
-/**
- * 读取正数配置。
- */
-function normalizePositiveNumber(value, fallback) {
-    return typeof value === "number" && Number.isFinite(value) && value > 0
-        ? value
-        : fallback;
-}
-/**
- * 读取任务状态。
- */
-function readJobStatus(value) {
-    return value === "queued" || value === "running" || value === "fetching" || value === "succeeded" || value === "failed"
-        ? value
-        : "failed";
-}
-/**
- * 安全解析 JSON 对象。
- */
-function parseRecordJson(value) {
-    if (typeof value !== "string" || !value.trim())
-        return {};
-    try {
-        const parsed = JSON.parse(value);
-        return isRecord(parsed) ? parsed : {};
-    }
-    catch {
-        return {};
-    }
-}
-/**
- * 安全解析 UIMessage。
- */
-function parseImageMessage(value) {
-    const record = parseRecordJson(value);
-    return record.role === "assistant" && Array.isArray(record.parts)
-        ? record
-        : undefined;
-}
-/**
- * 把 TableApi 普通行转成图片任务记录。
- */
-function rowToAsyncJobRecord(row) {
-    return {
-        job_id: String(row.job_id ?? ""),
-        job_type: String(row.job_type ?? ""),
-        status: readJobStatus(row.status),
-        input_json: String(row.input_json ?? "{}"),
-        state_json: readNullableString(row.state_json),
-        result_json: readNullableString(row.result_json),
-        error: readNullableString(row.error),
-        message: readNullableString(row.message),
-        poll_after_ms: readNullableNumberString(row.poll_after_ms),
-        city_id: readNullableString(row.city_id),
-        user_id: readNullableString(row.user_id),
-        service_id: readNullableString(row.service_id),
-        model_id: readNullableString(row.model_id),
-        created_at: String(row.created_at ?? ""),
-        updated_at: String(row.updated_at ?? ""),
-    };
-}
-/**
- * 保留已知 HTTP 错误状态，其它异常统一包装成上游错误。
- */
-function imageActionError(error, fallback_message) {
-    if (error instanceof Error && typeof error.statusCode === "number") {
-        return error;
-    }
-    return httpError(502, error instanceof Error ? error.message : fallback_message);
-}
-/**
- * 从输出对象中读取 provider usage。
- */
-function extractUsage(output) {
-    if (!isRecord(output))
-        return undefined;
-    const metadata = isRecord(output.metadata) ? output.metadata : undefined;
-    if (metadata && "usage" in metadata)
-        return metadata.usage;
-    if (metadata && "usageMetadata" in metadata)
-        return metadata.usageMetadata;
-    if ("usage" in output)
-        return output.usage;
-    return undefined;
-}
-/**
- * 兼容常见 provider usage 字段。
- */
-function normalizeUsage(usage) {
-    return normalizeAIUsage(usage);
-}
-/**
- * 统计 UIMessage file parts 里的图片数量。
- */
-function countImageOutputs(output) {
-    if (!isRecord(output) || !Array.isArray(output.parts))
-        return undefined;
-    const count = output.parts.filter((part) => {
-        if (!isRecord(part))
-            return false;
-        const type = String(part.type ?? "");
-        const media_type = String(part.mediaType ?? part.media_type ?? "");
-        return type === "file" && media_type.startsWith("image/");
-    }).length;
-    return count > 0 ? count : undefined;
-}
-/**
- * 判断 file part URL 是否是可转存的远程 URL。
- */
-function isStorableRemoteFilePart(part) {
-    if (!isRecord(part))
-        return false;
-    if (part.type !== "file")
-        return false;
-    const url = readOptionalString(part.url);
-    return Boolean(url && /^https?:\/\//iu.test(url));
-}
-/**
- * 读取 file part 的媒体类型。
- */
-function readFilePartMediaType(part) {
-    return readOptionalString(part.mediaType)
-        ?? readOptionalString(part.media_type)
-        ?? "application/octet-stream";
-}
-/**
- * 读取 file part 的建议文件名。
- */
-function readFilePartFilename(part) {
-    return readOptionalString(part.filename);
-}
-/**
- * 判断 provider 是否返回了图片任务创建结果。
- */
-function isImageProviderCreateResult(value) {
+/** 判断 Provider runtime 是否返回了可直接调用的 LanguageModelV3。 */
+function is_language_model_v3(value) {
     if (!value || typeof value !== "object")
         return false;
-    const record = value;
-    return typeof record.job_id === "string" &&
-        Boolean(record.job_id.trim()) &&
-        isImageJobStatus(record.status);
-}
-/**
- * 判断 provider 是否返回了图片任务查询结果。
- */
-function isImageProviderResult(value) {
-    if (!value || typeof value !== "object")
-        return false;
-    const record = value;
-    if (typeof record.job_id !== "string" || !record.job_id.trim())
-        return false;
-    if (!isImageJobStatus(record.status))
-        return false;
-    if (record.status === "succeeded") {
-        const result = isRecord(record.result) ? record.result : undefined;
-        if (!result || result.role !== "assistant" || !Array.isArray(result.parts))
-            return false;
-    }
-    return true;
-}
-/**
- * 判断图片任务状态。
- */
-function isImageJobStatus(value) {
-    return value === "queued" ||
-        value === "running" ||
-        value === "succeeded" ||
-        value === "failed";
+    const model = value;
+    return model.specificationVersion === "v3" &&
+        typeof model.doStream === "function" &&
+        typeof model.doGenerate === "function";
 }
 export class AIService extends Service {
     /** 模型注册表 */
@@ -301,6 +84,10 @@ export class AIService extends Service {
         this.action("chat/completions", async (ctx) => this.handleChatCompletions(ctx), {
             auth: ["user", "admin"],
         }).before((ctx) => this.precheck(ctx));
+        // CityModel 原生 LanguageModelV3 endpoint。
+        this.action("language-model/stream", async (ctx) => this.handleLanguageModelStream(ctx), {
+            auth: ["user", "admin"],
+        }).before((ctx) => this.precheck(ctx));
         // 模型列表走同一路径，根据身份决定可见范围。
         this.action("models", (ctx) => ({
             items: AIService.listModels(this, {
@@ -342,6 +129,11 @@ export class AIService extends Service {
         return model_id || undefined;
     }
     getAction(model, mode) {
+        if (mode === LANGUAGE_MODEL_MODE) {
+            return model.language_model
+                ? (ctx) => model.language_model?.create_language_model(ctx)
+                : undefined;
+        }
         if (mode === "image" || IMAGE_ACTION_MODES.includes(mode)) {
             const has_image_actions = Boolean(model.actions.image_create && model.actions.image_fetch);
             if (!has_image_actions)
@@ -437,6 +229,48 @@ export class AIService extends Service {
             return new Response(JSON.stringify({ error: message }), { status, headers: { "content-type": "application/json" } });
         }
     }
+    /**
+     * 执行 CityModel 原生 LanguageModelV3 调用。
+     *
+     * 路由、fallback、reasoning 和计费仍由 AIService 统一拥有；transport 模块只负责
+     * 调用最终模型并编码 SSE，避免把 Provider 决策泄漏到客户端。
+     */
+    async handleLanguageModelStream(ctx) {
+        const request = decode_city_language_model_request(ctx.input);
+        ctx.input = {
+            ...ctx.input,
+            model: request.model_id,
+            ...(request.reasoning_effort ? { reasoning_effort: request.reasoning_effort } : {}),
+        };
+        const initial_resolved = this.resolve({ model: request.model_id, mode: LANGUAGE_MODEL_MODE }, ctx.env);
+        const routing = this.plan_text_execution(initial_resolved, ctx, LANGUAGE_MODEL_MODE);
+        const resolved = routing.resolved;
+        const reasoning = resolved.model ? resolve_model_reasoning(resolved.model, ctx.input) : undefined;
+        this.attachResolvedModel(ctx, resolved.model, LANGUAGE_MODEL_MODE, routing);
+        attach_resolved_reasoning(ctx, reasoning);
+        const started_at = Date.now();
+        const output = await resolved.action(ctx);
+        if (!is_language_model_v3(output)) {
+            throw httpError(500, "Model language runtime did not return LanguageModelV3");
+        }
+        const provider_options = resolved.model?.language_model?.build_provider_options?.(ctx, output);
+        const execution = await create_city_language_model_stream({
+            model: output,
+            call: request.call,
+            provider_options,
+            signal: ctx.request?.signal,
+        });
+        const completion = execution.completion.then((part) => {
+            if (part)
+                this.attachOutputMetering(ctx, part, LANGUAGE_MODEL_MODE, started_at);
+            return part;
+        });
+        const charge = resolved.model?.bill
+            ? completion.then((part) => part ? resolved.model?.bill?.(ctx, part) : undefined)
+            : undefined;
+        const charged_response = await this.handleCharge(ctx, charge, true, undefined, undefined, execution.response);
+        return charged_response ?? execution.response;
+    }
     // ========== 图片任务通路 ==========
     async createImageJob(ctx) {
         const resolved = this.resolve({ model: this.normalizeModelId(ctx.input.model), mode: "image_create" }, ctx.env);