@downcity/city 0.2.200 → 0.2.211

package/bin/types/AI.d.ts

@@ -0,0 +1,289 @@
+/**
+ * City AI 领域类型模块。
+ *
+ * 本模块集中定义 AIChannel、模型、计费、图片任务以及内部路由类型。
+ * 公共入口只导出用户配置和 Channel 实现所需的最小类型集合。
+ */
+import type { LanguageModel, UIMessage } from "ai";
+import type { CityModelEnvRequirement, CityModelReasoning } from "@downcity/type";
+import type { ActionFn } from "../service/action.js";
+import type { Context } from "../service/service.js";
+import type { AsyncJobRecord } from "./AsyncJob.js";
+import type { RuntimeMetering } from "./Metering.js";
+/** AI SDK LanguageModelV3。 */
+export type LanguageModelV3 = Extract<LanguageModel, {
+    readonly specificationVersion: "v3";
+}>;
+/** LanguageModelV3 的标准调用参数。 */
+export type LanguageModelV3CallOptions = Parameters<LanguageModelV3["doStream"]>[0];
+/** LanguageModelV3 的标准流结果。 */
+export type LanguageModelV3StreamResult = Awaited<ReturnType<LanguageModelV3["doStream"]>>;
+/** LanguageModelV3 的标准流事件，仅供 City 内部 transport 使用。 */
+export type LanguageModelV3StreamPart = LanguageModelV3StreamResult["stream"] extends ReadableStream<infer Part> ? Part : never;
+/** LanguageModelV3 的标准非流式结果，仅供 City 内部聚合使用。 */
+export type LanguageModelV3GenerateResult = Awaited<ReturnType<LanguageModelV3["doGenerate"]>>;
+/** AI SDK 按 Provider ID 分组的服务端私有调用选项。 */
+export type AISDKProviderOptions = NonNullable<LanguageModelV3CallOptions["providerOptions"]>;
+/** AIService 已校验的推理强度。 */
+export interface AIResolvedReasoning {
+    /** 最终模型接受的推理强度档位 ID。 */
+    effort: string;
+    /** 档位来自调用方请求还是模型默认配置。 */
+    source: "request" | "default";
+}
+/** AIChannel 构造参数。 */
+export interface AIChannelOptions {
+    /** Federation 中的 Channel 唯一 ID。 */
+    id: string;
+    /** Channel 所需环境变量及管理员说明。 */
+    env?: Record<string, string>;
+    /** 上游 API 根地址，由 Channel 子类显式使用。 */
+    base_url?: string;
+    /** Channel 默认 API Key 对应的 Federation env key。 */
+    env_key?: string;
+    /** reasoning 映射使用的 AI SDK providerOptions 命名空间。 */
+    ai_sdk_provider_id?: string;
+    /** Channel 下所有模型共享的 AI SDK providerOptions 默认值。 */
+    ai_sdk_provider_options?: AISDKProviderOptions;
+}
+/** AIService 已解析完成、可供 Channel 执行的模型身份。 */
+export interface AIChannelModel {
+    /** Federation 对外模型 ID。 */
+    readonly id: string;
+    /** 真实上游模型 ID。 */
+    readonly upstream_model: string;
+}
+/** AIChannel 语言执行时可读取的显式输入。 */
+export interface AIChannelStreamInput {
+    /** 已移除客户端私有选项并注入服务端 providerOptions 的标准调用。 */
+    readonly call: LanguageModelV3CallOptions;
+    /** AIService 已解析完成的最终模型。 */
+    readonly model: AIChannelModel;
+    /** 读取 Federation 服务端环境变量。 */
+    readonly env: (key: string) => string | undefined;
+    /** AIService 已校验的可选 reasoning。 */
+    readonly reasoning?: AIResolvedReasoning;
+}
+/** AIChannel 非语言 action 可读取的显式输入。 */
+export interface AIChannelActionInput {
+    /** 当前 action 的业务输入。 */
+    readonly input: Record<string, unknown>;
+    /** AIService 已解析完成的最终模型。 */
+    readonly model: AIChannelModel;
+    /** 读取 Federation 服务端环境变量。 */
+    readonly env: (key: string) => string | undefined;
+    /** 当前请求的可选用户 ID。 */
+    readonly user_id?: string;
+    /** 当前请求所属的可选 City ID。 */
+    readonly city_id?: string;
+    /** 图片抓取 action 可读取的异步任务上下文。 */
+    readonly image_job?: AIImageJobContext;
+}
+/** fallback 匹配时使用的媒体信息。 */
+export interface AIModelFallbackMedia {
+    /** file part 的 IANA 媒体类型。 */
+    media_type: string;
+    /** 输入文件名。 */
+    filename?: string;
+    /** 输入文件 URL 或 Data URL。 */
+    url?: string;
+}
+/** 模型级媒体 fallback 规则。 */
+export interface AIModelFallbackRule {
+    /** 判断当前媒体是否命中规则。 */
+    match: (media: AIModelFallbackMedia) => boolean;
+    /** fallback 目标 Federation 模型 ID。 */
+    model_id: string;
+}
+/** AIChannel.model() 接收的模型声明。 */
+export interface AIModelSpec {
+    /** Federation 模型目录中的唯一 ID。 */
+    id: string;
+    /** 真实上游模型 ID，不向普通客户端公开。 */
+    upstream_model: string;
+    /** 面向用户展示的模型名称。 */
+    name: string;
+    /** 面向用户展示的模型说明。 */
+    description?: string;
+    /** 模型支持的总上下文窗口，单位为 token。 */
+    context_window?: number;
+    /** 模型目录标签。 */
+    tags?: string[];
+    /** 面向用户展示的价格说明列表，不参与实际扣费。 */
+    price?: string[];
+    /** 不公开给客户端的模型级 AI SDK providerOptions。 */
+    ai_sdk_provider_options?: AISDKProviderOptions;
+    /** 可公开给客户端的模型扩展信息。 */
+    meta?: Record<string, unknown>;
+    /** 模型公开的 reasoning 能力。 */
+    reasoning?: CityModelReasoning;
+    /** 模型级媒体 fallback 规则。 */
+    fallback?: AIModelFallbackRule[];
+    /** 模型成功执行后的账单草稿生成函数。 */
+    bill?: AIBill;
+}
+/** Channel 语言模型执行函数。 */
+export type AIModelStream = (ctx: Context, call: LanguageModelV3CallOptions) => Promise<LanguageModelV3StreamResult>;
+/** 非语言模型 action 映射。 */
+export interface AIModelActions {
+    /** 由 AIModelStream 自动派生的 text action。 */
+    text?: ActionFn;
+    /** 图片任务创建 action。 */
+    image_create?: ActionFn;
+    /** 图片任务抓取 action。 */
+    image_fetch?: ActionFn;
+    /** 图片任务查询 action。 */
+    image_result?: ActionFn;
+    /** 视频生成 action。 */
+    video?: ActionFn;
+    /** 语音合成 action。 */
+    tts?: ActionFn;
+    /** 语音识别 action。 */
+    asr?: ActionFn;
+    /** 扩展 modality action。 */
+    [modality: string]: ActionFn | undefined;
+}
+/** AIService 执行模型所需的内部运行时。 */
+export interface AIModelRuntime {
+    /** 可选的标准语言模型流入口。 */
+    stream?: AIModelStream;
+    /** 图片、视频、TTS、ASR 等 action。 */
+    actions: AIModelActions;
+}
+/** Federation 内部已注册、可路由、可执行的模型定义。 */
+export interface AIModelDefinition extends Omit<AIModelSpec, "ai_sdk_provider_options"> {
+    /** 当前模型所属 AIChannel ID。 */
+    channel_id: string;
+    /** 当前模型所需的 Federation 环境变量。 */
+    env?: Record<string, string>;
+    /** 当前模型的服务端执行运行时。 */
+    runtime: AIModelRuntime;
+}
+/** AI 模型环境变量需求。 */
+export type AIModelEnvRequirement = CityModelEnvRequirement;
+/** AIService 配置。 */
+export interface AIServiceOptions {
+    /** AI 专用余额桥接。 */
+    balance?: AIBalanceBridge;
+    /** 图片异步任务允许保持 queued/running 的最长时间，单位毫秒。 */
+    image_max_pending_duration_ms?: number;
+}
+/** AIChannel 计算出的单次扣费结果。 */
+export interface AICharge {
+    /** 可选扣费用户 ID。 */
+    user_id?: string;
+    /** 扣费额度，单位为 credits。 */
+    credits: number;
+    /** 账单说明。 */
+    note?: string;
+    /** 外部引用 ID。 */
+    ref?: string;
+    /** 内部审计信息。 */
+    metadata?: Record<string, unknown>;
+}
+/** AIService 提交给外部 Balance bridge 的扣费输入。 */
+export interface AIBalanceChargeInput extends AICharge {
+    /** 当前用户 ID。 */
+    user_id: string;
+    /** 相同键的重复提交必须只产生一次扣费。 */
+    idempotency_key?: string;
+}
+/** AIService 依赖的最小 Balance bridge。 */
+export interface AIBalanceBridge {
+    /** 执行余额前置检查。 */
+    precheck?(user_id: string, needed_credits?: number): Promise<{
+        credits: number;
+    }>;
+    /** 执行扣费并记录账单。 */
+    charge(input: AIBalanceChargeInput): Promise<unknown>;
+}
+/** Channel 或模型生成账单时可读取的显式输入。 */
+export interface AIBillInput {
+    /** 本次模型执行的最终输出。 */
+    readonly output: unknown;
+    /** AIService 已解析完成的最终模型。 */
+    readonly model: AIChannelModel;
+    /** AIService 已归一化的可选计量信息。 */
+    readonly metering?: RuntimeMetering;
+    /** 当前请求的可选用户 ID。 */
+    readonly user_id?: string;
+    /** 当前请求所属的可选 City ID。 */
+    readonly city_id?: string;
+}
+/** Channel 或模型生成扣费行的方法。 */
+export type AIBill = (input: AIBillInput) => AICharge | Promise<AICharge | undefined> | undefined;
+/** AIChannel action 返回的统一带计费结果。 */
+export interface AIChargedResult<T = unknown> {
+    /** 对外返回的 action 输出。 */
+    output: T;
+    /** AIChannel 已计算好的可选扣费结果。 */
+    charge?: AICharge | Promise<AICharge | undefined>;
+}
+/** 图片任务状态。 */
+export type AIImageStatus = "queued" | "running" | "succeeded" | "failed";
+/** image_create 返回的固定协议。 */
+export interface AIImageCreateResult {
+    /** 图片任务 ID。 */
+    job_id: string;
+    /** 创建后的任务状态。 */
+    status: AIImageStatus;
+    /** 当前任务状态说明。 */
+    message?: string;
+    /** 失败时返回的错误消息。 */
+    error?: string;
+    /** 建议下一次查询结果的间隔毫秒数。 */
+    poll_after_ms?: number;
+    /** 上游扩展元数据。 */
+    metadata?: Record<string, unknown>;
+}
+/** image_fetch 与 image_result 共用的固定协议。 */
+export interface AIImageResult extends AIImageCreateResult {
+    /** 成功时返回的 AI SDK UIMessage。 */
+    result?: UIMessage;
+}
+/** AIChannel 在 image_fetch 中可读取的图片任务上下文。 */
+export interface AIImageJobContext {
+    /** async_jobs 中保存的完整任务记录。 */
+    record: AsyncJobRecord;
+    /** image_create 时的原始输入。 */
+    input: Record<string, unknown>;
+    /** image_create 或 image_fetch 返回的上游状态。 */
+    state?: Record<string, unknown>;
+}
+/** 已被当前 worker 原子领取的图片任务。 */
+export interface AIImageJobClaim {
+    /** 进入 fetching 状态后的完整任务记录。 */
+    record: AsyncJobRecord;
+    /** 本次领取写入的时间戳，也是后续 CAS 的所有权令牌。 */
+    claimed_at: string;
+}
+/** 已解析的模型 action。 */
+export interface AIResolvedAction {
+    /** 本次 action 绑定的最终模型定义。 */
+    model?: AIModelDefinition;
+    /** 本次请求实际执行的 Channel 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(model_id: string): AIModelDefinition | undefined;
+    /** 解析目标模型在指定通路下的 action。 */
+    resolve_action(model: AIModelDefinition, mode: string): ActionFn | undefined;
+    /** 判断目标模型当前是否满足运行条件。 */
+    is_available(model: AIModelDefinition): boolean;
+}
+//# sourceMappingURL=AI.d.ts.map

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

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

package/bin/types/AI.js

@@ -0,0 +1,8 @@
+/**
+ * City AI 领域类型模块。
+ *
+ * 本模块集中定义 AIChannel、模型、计费、图片任务以及内部路由类型。
+ * 公共入口只导出用户配置和 Channel 实现所需的最小类型集合。
+ */
+export {};
+//# sourceMappingURL=AI.js.map

package/bin/types/AI.js.map

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

package/bin/types/AITransport.d.ts

@@ -0,0 +1,251 @@
+/**
+ * City AI transport 内部类型模块。
+ *
+ * 本模块只服务于 CityModel transport、text 输入转换和 OpenAI HTTP adapter，
+ * 不从 @downcity/city 公共入口导出。
+ */
+import type { ModelMessage, ToolSet, UIMessage } from "ai";
+import type { FetchResponseLike } from "../pact/http.js";
+import type { CityModelDescriptor } from "@downcity/type";
+import type { LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamPart, LanguageModelV3StreamResult } from "./AI.js";
+/** City Language Model transport v1 的固定协议标识。 */
+export declare const CITY_LANGUAGE_MODEL_PROTOCOL_V1: "downcity-language-model-v1";
+/** City transport JSON 原始值。 */
+export type CityTransportJsonPrimitive = string | number | boolean | null;
+/** City transport JSON 对象。 */
+export interface CityTransportJsonObject {
+    /** JSON 对象字段。 */
+    [key: string]: CityTransportJsonValue;
+}
+/** City transport 支持的完整 JSON 值。 */
+export type CityTransportJsonValue = CityTransportJsonPrimitive | CityTransportJsonObject | CityTransportJsonValue[];
+/** CityModel 发给 Federation 的标准模型调用。 */
+export interface CityLanguageModelStreamRequestV1 {
+    /** 固定协议版本。 */
+    protocol: typeof CITY_LANGUAGE_MODEL_PROTOCOL_V1;
+    /** Federation 模型目录中的模型 ID。 */
+    model_id: string;
+    /** JSON 编码后的 LanguageModelV3CallOptions。 */
+    call: CityTransportJsonObject;
+    /** 用户显式选择的 Downcity 推理强度。 */
+    reasoning_effort?: string;
+}
+/** Federation 通过 SSE 返回的标准模型流事件。 */
+export interface CityLanguageModelStreamEventV1 {
+    /** 固定协议版本。 */
+    protocol: typeof CITY_LANGUAGE_MODEL_PROTOCOL_V1;
+    /** JSON 编码后的 LanguageModelV3StreamPart。 */
+    part: CityTransportJsonObject;
+}
+/** 已校验并解码的 CityModel transport 请求。 */
+export interface DecodedCityLanguageModelRequest {
+    /** Federation 模型目录中的模型 ID。 */
+    model_id: string;
+    /** 解码后的标准 LanguageModelV3 调用参数。 */
+    call: LanguageModelV3CallOptions;
+    /** 用户显式选择的推理强度。 */
+    reasoning_effort?: string;
+}
+/** 供运行时校验的原始 CityModel transport 请求。 */
+export type RawCityLanguageModelRequest = CityLanguageModelStreamRequestV1 | Record<string, unknown>;
+/** 创建 Federation SSE 响应所需的输入。 */
+export interface CreateCityLanguageModelStreamInput {
+    /** 最终 AIChannel stream 返回的标准 LanguageModelV3 流结果。 */
+    result: LanguageModelV3StreamResult;
+}
+/** Federation SSE 响应及其最终完成事件。 */
+export interface CityLanguageModelStreamExecution {
+    /** 返回给 CityModel 客户端的 SSE Response。 */
+    response: Response;
+    /** 流结束后的 finish 事件；异常或取消时为空。 */
+    completion: Promise<LanguageModelV3StreamPart | undefined>;
+}
+/** CityModel 客户端构造参数。 */
+export interface CityModelOptions {
+    /** Federation 模型目录返回的公开描述。 */
+    descriptor: CityModelDescriptor;
+    /** 使用 City 客户端鉴权上下文发送模型请求。 */
+    request_stream(request: CityLanguageModelStreamRequestV1, signal?: AbortSignal): Promise<FetchResponseLike>;
+}
+/** 通用 text action 接受的输入。 */
+export interface AITextInput {
+    /** 多轮 AI SDK UIMessage；存在时优先于单轮 prompt。 */
+    messages?: UIMessage[];
+    /** 没有多轮 messages 时使用的单轮文本输入。 */
+    prompt?: string;
+    /** OpenAI function tool 定义列表。 */
+    tools?: Record<string, unknown>[];
+}
+/** 可直接交给 AI SDK generateText 的内部输入。 */
+export type AIResolvedTextInput = {
+    /** 转换后的 AI SDK 标准模型消息。 */
+    messages: ModelMessage[];
+    /** 当前请求携带的可选 AI SDK ToolSet。 */
+    tools?: ToolSet;
+} | {
+    /** 单轮 prompt 文本。 */
+    prompt: string;
+    /** 当前请求携带的可选 AI SDK ToolSet。 */
+    tools?: ToolSet;
+};
+/** OpenAI Chat Completions 请求。 */
+export interface OpenAIChatCompletionRequest {
+    /** Federation 模型目录中的模型 ID。 */
+    model: string;
+    /** 本次对话消息列表。 */
+    messages: OpenAIChatMessage[];
+    /** 是否返回 OpenAI SSE 数据流。 */
+    stream?: boolean;
+    /** 最大输出 token 数；优先级高于 max_tokens。 */
+    max_completion_tokens?: number;
+    /** 兼容旧客户端的最大输出 token 数。 */
+    max_tokens?: number;
+    /** 采样温度。 */
+    temperature?: number;
+    /** nucleus sampling 参数。 */
+    top_p?: number;
+    /** 停止序列。 */
+    stop?: string | string[];
+    /** presence penalty。 */
+    presence_penalty?: number;
+    /** frequency penalty。 */
+    frequency_penalty?: number;
+    /** 确定性采样种子。 */
+    seed?: number;
+    /** 可供模型调用的 function tools。 */
+    tools?: OpenAIChatTool[];
+    /** 工具选择策略。 */
+    tool_choice?: OpenAIChatToolChoice;
+    /** 文本或 JSON 输出格式。 */
+    response_format?: OpenAIChatResponseFormat;
+    /** Downcity 对外公开的推理强度。 */
+    reasoning_effort?: string;
+    /** 其它兼容字段不会直接进入 AIChannel。 */
+    [key: string]: unknown;
+}
+/** OpenAI 对话消息。 */
+export interface OpenAIChatMessage {
+    /** 消息角色。 */
+    role: "system" | "developer" | "user" | "assistant" | "tool";
+    /** 文本或多模态消息内容。 */
+    content?: string | OpenAIChatContentPart[] | null;
+    /** assistant 消息中的历史工具调用。 */
+    tool_calls?: OpenAIChatToolCall[];
+    /** tool 消息对应的工具调用 ID。 */
+    tool_call_id?: string;
+    /** tool 消息对应的工具名称。 */
+    name?: string;
+}
+/** OpenAI 多模态消息内容。 */
+export type OpenAIChatContentPart = OpenAIChatTextPart | OpenAIChatImagePart | OpenAIChatFilePart;
+/** OpenAI 文本内容。 */
+export interface OpenAIChatTextPart {
+    /** 内容类型。 */
+    type: "text" | "input_text";
+    /** 文本内容。 */
+    text: string;
+}
+/** OpenAI 图片内容。 */
+export interface OpenAIChatImagePart {
+    /** 内容类型。 */
+    type: "image_url" | "input_image";
+    /** Chat Completions image_url 对象。 */
+    image_url?: {
+        url: string;
+    };
+    /** 部分兼容客户端使用的直接 URL。 */
+    url?: string;
+}
+/** OpenAI 文件内容。 */
+export interface OpenAIChatFilePart {
+    /** 内容类型。 */
+    type: "file";
+    /** 文件 URL 或 Data URL。 */
+    url: string;
+    /** 文件 IANA 媒体类型。 */
+    media_type?: string;
+    /** 兼容 AI SDK 风格的媒体类型字段。 */
+    mediaType?: string;
+    /** 可选文件名。 */
+    filename?: string;
+}
+/** OpenAI function tool 定义。 */
+export interface OpenAIChatTool {
+    /** 工具类型。 */
+    type: "function";
+    /** function 定义。 */
+    function: {
+        /** 工具唯一名称。 */
+        name: string;
+        /** 工具说明。 */
+        description?: string;
+        /** 工具输入 JSON Schema。 */
+        parameters?: Record<string, unknown>;
+        /** 是否要求 AI SDK Provider 严格遵循 schema。 */
+        strict?: boolean;
+    };
+}
+/** OpenAI 工具选择策略。 */
+export type OpenAIChatToolChoice = "auto" | "none" | "required" | {
+    type: "function";
+    function: {
+        name: string;
+    };
+};
+/** OpenAI 输出格式。 */
+export type OpenAIChatResponseFormat = {
+    type: "text";
+} | {
+    type: "json_object";
+} | {
+    type: "json_schema";
+    json_schema: {
+        /** JSON schema 名称。 */
+        name: string;
+        /** JSON schema 说明。 */
+        description?: string;
+        /** 输出必须遵循的 JSON Schema。 */
+        schema: Record<string, unknown>;
+    };
+};
+/** OpenAI assistant 历史工具调用。 */
+export interface OpenAIChatToolCall {
+    /** 工具调用 ID。 */
+    id: string;
+    /** 工具调用类型。 */
+    type: "function";
+    /** function 调用内容。 */
+    function: {
+        /** 工具名称。 */
+        name: string;
+        /** JSON 字符串形式的工具参数。 */
+        arguments: string;
+    };
+}
+/** OpenAI token usage。 */
+export interface OpenAIChatUsage {
+    /** 输入 token 总数。 */
+    prompt_tokens: number;
+    /** 输出 token 总数。 */
+    completion_tokens: number;
+    /** 输入与输出 token 总数。 */
+    total_tokens: number;
+    /** 输入 token 明细。 */
+    prompt_tokens_details?: {
+        /** 命中缓存的输入 token 数。 */
+        cached_tokens: number;
+    };
+    /** 输出 token 明细。 */
+    completion_tokens_details?: {
+        /** 推理 token 数。 */
+        reasoning_tokens: number;
+    };
+}
+/** OpenAI adapter 输出与计费聚合状态。 */
+export interface OpenAIChatCompletionExecution {
+    /** 返回给 OpenAI-compatible 客户端的响应。 */
+    response: Response;
+    /** 标准 V3 聚合结果；异常或取消时为空。 */
+    completion: Promise<LanguageModelV3GenerateResult | undefined>;
+}
+//# sourceMappingURL=AITransport.d.ts.map

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

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

package/bin/types/AITransport.js

@@ -0,0 +1,12 @@
+/**
+ * City AI transport 内部类型模块。
+ *
+ * 本模块只服务于 CityModel transport、text 输入转换和 OpenAI HTTP adapter，
+ * 不从 @downcity/city 公共入口导出。
+ */
+// ===========================================================================
+// CityModel transport
+// ===========================================================================
+/** City Language Model transport v1 的固定协议标识。 */
+export const CITY_LANGUAGE_MODEL_PROTOCOL_V1 = "downcity-language-model-v1";
+//# sourceMappingURL=AITransport.js.map

package/bin/types/AITransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AITransport.js","sourceRoot":"","sources":["../../src/types/AITransport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,gDAAgD;AAChD,MAAM,CAAC,MAAM,+BAA+B,GAAG,4BAAqC,CAAC"}