@downcity/city 0.2.17 → 0.2.25

package/bin/city/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * City City 访问入口。
+ */
+export type { FetchLike, FetchResponseLike, RawStreamBody, RequestInitLike, } from "./http.js";
+export { City } from "./city.js";
+export type { AdminCityOptions, CityClientBaseOptions, CityOptions, CityOptionsForRole, CityRole, UserCityOptions, } from "./types/city.js";
+export { AIInvoker, ModelCatalog, ModelHandle } from "./invoker/ai/index.js";
+export { PaymentInvoker, PaymentMethodHandle } from "./invoker/payment/index.js";
+export { ServiceClient, ActionClient } from "./invoker/invoker.js";
+export type { UserPaymentMethod, UserPaymentMethodReason, UserPaymentMethodType, UserImageResult, UserServiceInput, UserServiceSummary, UserStreamChunk, UserStreamResult, UserTextResult, UserVideoResult, } from "./user/types.js";
+export type { UserPaymentMethod as PaymentMethod, UserPaymentMethodReason as PaymentMethodReason, UserPaymentMethodType as PaymentMethodType, } from "./invoker/payment/types.js";
+export type { UserModelRef, UserModelInput, } from "./invoker/ai/types.js";
+export { BalanceInvoker, BalanceRedeemCodeInvoker } from "./invoker/balance/index.js";
+export { EnvInvoker } from "./invoker/env/index.js";
+export { TownsInvoker } from "./invoker/towns/index.js";
+export type { AdminInstructionResult, AdminModelRecord, AdminServiceSummary, } from "./admin/types.js";
+export type { BalanceAccountRecord, BalanceHistoryListInput, BalanceLedgerRecord, BalanceMutationInput, BalanceRedeemCodeCreateInput, BalanceRedeemCodeDisableInput, BalanceRedeemCodeIssueResult, BalanceRedeemCodeListInput, BalanceRedeemCodeRecord, BalanceTopupListInput, BalanceTopupRecord, BalanceTopupUpdateInput, } from "./invoker/balance/types.js";
+export type { EnvCatalogScope, EnvEntry, EnvRequirementStatus, EnvUpsertInput, } from "./invoker/env/types.js";
+export type { Town, TownCreateInput, TokenApplyInput, TokenApplyResult, } from "./invoker/towns/types.js";
+//# sourceMappingURL=index.d.ts.map

package/bin/city/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/city/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnE,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,iBAAiB,IAAI,aAAa,EAClC,uBAAuB,IAAI,mBAAmB,EAC9C,qBAAqB,IAAI,iBAAiB,GAC3C,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,YAAY,EACZ,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,eAAe,EACf,QAAQ,EACR,oBAAoB,EACpB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,IAAI,EACJ,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/bin/city/index.js

@@ -0,0 +1,14 @@
+/**
+ * City City 访问入口。
+ */
+export { City } from "./city.js";
+// ===========================================================================
+// City 能力类型
+// ===========================================================================
+export { AIInvoker, ModelCatalog, ModelHandle } from "./invoker/ai/index.js";
+export { PaymentInvoker, PaymentMethodHandle } from "./invoker/payment/index.js";
+export { ServiceClient, ActionClient } from "./invoker/invoker.js";
+export { BalanceInvoker, BalanceRedeemCodeInvoker } from "./invoker/balance/index.js";
+export { EnvInvoker } from "./invoker/env/index.js";
+export { TownsInvoker } from "./invoker/towns/index.js";
+//# sourceMappingURL=index.js.map

package/bin/city/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/city/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAUjC,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA0BnE,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/bin/city/invoker/ai/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * AI Service 调用器（对应 core service/ai/ai-service.ts AIService）。
+ *
+ * 路由：/v1/ai/{modality} 和 /v1/ai/models。
+ */
+import { type CityModelDescriptor } from "@downcity/type";
+import type { UserModelRef } from "./types.js";
+import type { UserImageResult, UserServiceInput, UserStreamResult, UserTextResult, UserVideoResult } from "../../user/types.js";
+import type { RequestInitLike } from "../../http.js";
+/**
+ * AI 服务调用器。
+ *
+ * 通过 User City .ai 访问：
+ * ```ts
+ * await client.ai.text({ prompt: "hello" });
+ * const catalog = await client.ai.listModels();
+ * ```
+ */
+export declare class AIInvoker {
+    private readonly req;
+    private readonly reqRaw;
+    private readonly input;
+    private readonly baseUrl;
+    private readonly token;
+    constructor(opts: {
+        baseUrl: string;
+        token?: string;
+        requestJSON: <T>(path: string, init: RequestInitLike) => Promise<T>;
+        requestRaw: (path: string, init: RequestInitLike) => Promise<{
+            body: import("../../http.js").RawStreamBody;
+        }>;
+        buildInput: (input: UserServiceInput) => Record<string, unknown>;
+    });
+    /** 文本生成。支持 tools 参数（ai-sdk tool 格式，自动序列化去掉 execute） */
+    text(input: UserServiceInput): Promise<UserTextResult>;
+    /** 流式生成。支持 tools 参数（ai-sdk tool 格式，自动序列化去掉 execute） */
+    stream(input: UserServiceInput): Promise<UserStreamResult>;
+    /** 图片生成 */
+    image(input: UserServiceInput): Promise<UserImageResult>;
+    /** 视频生成 */
+    video(input: UserServiceInput): Promise<UserVideoResult>;
+    /** 语音合成 */
+    tts<T = unknown>(input: UserServiceInput): Promise<T>;
+    /** 语音识别 */
+    asr<T = unknown>(input: UserServiceInput): Promise<T>;
+    /** 获取模型目录 */
+    listModels(): Promise<ModelCatalog>;
+    /**
+     * 获取指定模型的操作句柄。
+     *
+     * ```ts
+     * const ref = catalog.get("kimi-k2.6");
+     * const m = client.ai.model(ref);
+     * // 便捷调用
+     * const msg = await m.text({ messages: [...] });
+     * // 或自己接第三方 SDK
+     * const openai = new OpenAI({ baseURL: m.url(), apiKey: m.token });
+     * ```
+     */
+    model(ref: UserModelRef | string): ModelHandle;
+    private post;
+    /** 将 ai-sdk tool 格式序列化为 OpenAI function 格式（去掉 execute，只保留 schema） */
+    private serializeTools;
+}
+/**
+ * 模型目录（AIInvoker.listModels() 返回值）。
+ *
+ * 计算规则：
+ * - 第一个模型 = 全局默认
+ * - 每个 modality 的第一个支持模型 = 该 modality 的默认
+ */
+export declare class ModelCatalog {
+    private readonly byId;
+    private readonly def;
+    constructor(items: CityModelDescriptor[], ai: AIInvoker);
+    get(id: string): UserModelRef | undefined;
+    default(): UserModelRef | undefined;
+    all(): UserModelRef[];
+    forModality(modality: string): UserModelRef[];
+}
+/** 将 UserModelInput 转为字符串 */
+export declare function serializeModel(model: import("./types.js").UserModelInput | undefined): string | undefined;
+/**
+ * 模型操作句柄。
+ *
+ * 两种使用方式：
+ * 1. 便捷调用：m.text() / m.stream() — 走 server
+ * 2. 接入其他 SDK：m.url() + m.modelName() + m.token — 自己拼
+ *
+ * 通过 `client.ai.model(ref)` 获取，ref 来自 `listModels()`。
+ */
+export declare class ModelHandle {
+    private readonly ai;
+    /** 模型 ID */
+    readonly id: string;
+    /** 模型展示名称 */
+    readonly name: string;
+    /** 模型元数据（来自 server 的 PublicModel.meta） */
+    readonly meta: Record<string, unknown>;
+    /** Server AI 端点 */
+    readonly endpoint: string;
+    /** User auth token */
+    readonly token: string | undefined;
+    constructor(ai: AIInvoker, 
+    /** 模型 ID */
+    id: string, 
+    /** 模型展示名称 */
+    name?: string, 
+    /** Server AI 端点 */
+    endpoint?: string, 
+    /** User auth token */
+    token?: string, meta?: Record<string, unknown>);
+    /** 流式生成 */
+    stream(input: Omit<UserServiceInput, "model">): Promise<UserStreamResult>;
+    /** 文本生成 */
+    text(input: Omit<UserServiceInput, "model">): Promise<UserTextResult>;
+    /** 图片生成 */
+    image(input: Omit<UserServiceInput, "model">): Promise<UserImageResult>;
+    /** 视频生成 */
+    video(input: Omit<UserServiceInput, "model">): Promise<UserVideoResult>;
+    /** Server AI 端点 URL */
+    url(): string;
+    /** 模型名称（API 调用时的 model 参数值） */
+    modelName(): string;
+}
+//# sourceMappingURL=index.d.ts.map

package/bin/city/invoker/ai/index.d.ts.map

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

package/bin/city/invoker/ai/index.js

@@ -0,0 +1,247 @@
+/**
+ * AI Service 调用器（对应 core service/ai/ai-service.ts AIService）。
+ *
+ * 路由：/v1/ai/{modality} 和 /v1/ai/models。
+ */
+import { parseAIStreamBody } from "./stream.js";
+import { CITY_MODEL_INVOKER, CITY_MODEL_KIND, } from "@downcity/type";
+const PREFIX = "/v1/ai";
+/**
+ * AI 服务调用器。
+ *
+ * 通过 User City .ai 访问：
+ * ```ts
+ * await client.ai.text({ prompt: "hello" });
+ * const catalog = await client.ai.listModels();
+ * ```
+ */
+export class AIInvoker {
+    req;
+    reqRaw;
+    input;
+    baseUrl;
+    token;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl;
+        this.token = opts.token;
+        this.req = opts.requestJSON;
+        this.reqRaw = opts.requestRaw;
+        this.input = opts.buildInput;
+    }
+    /** 文本生成。支持 tools 参数（ai-sdk tool 格式，自动序列化去掉 execute） */
+    text(input) {
+        return this.req(`${PREFIX}/text`, {
+            method: "POST",
+            body: JSON.stringify(this.input(this.serializeTools(input))),
+        });
+    }
+    /** 流式生成。支持 tools 参数（ai-sdk tool 格式，自动序列化去掉 execute） */
+    async stream(input) {
+        const res = await this.reqRaw(`${PREFIX}/stream`, {
+            method: "POST",
+            body: JSON.stringify(this.input(this.serializeTools(input))),
+        });
+        return parseAIStreamBody(res.body);
+    }
+    /** 图片生成 */
+    image(input) {
+        return this.post("/image", input);
+    }
+    /** 视频生成 */
+    video(input) {
+        return this.post("/video", input);
+    }
+    /** 语音合成 */
+    tts(input) {
+        return this.post("/tts", input);
+    }
+    /** 语音识别 */
+    asr(input) {
+        return this.post("/asr", input);
+    }
+    /** 获取模型目录 */
+    async listModels() {
+        const body = await this.req(`${PREFIX}/models`, { method: "GET" });
+        return new ModelCatalog(body.items, this);
+    }
+    /**
+     * 获取指定模型的操作句柄。
+     *
+     * ```ts
+     * const ref = catalog.get("kimi-k2.6");
+     * const m = client.ai.model(ref);
+     * // 便捷调用
+     * const msg = await m.text({ messages: [...] });
+     * // 或自己接第三方 SDK
+     * const openai = new OpenAI({ baseURL: m.url(), apiKey: m.token });
+     * ```
+     */
+    model(ref) {
+        if (typeof ref === "string") {
+            return new ModelHandle(this, ref, ref, `${this.baseUrl}/v1/ai`, this.token);
+        }
+        return new ModelHandle(this, ref.id, ref.name, `${this.baseUrl}/v1/ai`, this.token, ref.meta);
+    }
+    post(path, input) {
+        return this.req(`${PREFIX}${path}`, {
+            method: "POST",
+            body: JSON.stringify(this.input(input)),
+        });
+    }
+    /** 将 ai-sdk tool 格式序列化为 OpenAI function 格式（去掉 execute，只保留 schema） */
+    serializeTools(input) {
+        const { tools, ...rest } = input;
+        const body = { ...rest };
+        if (Array.isArray(tools)) {
+            body.tools = tools;
+            return body;
+        }
+        if (tools && typeof tools === "object") {
+            body.tools = Object.entries(tools).map(([name, def]) => ({
+                type: "function",
+                function: {
+                    name,
+                    description: def.description,
+                    parameters: def.parameters,
+                },
+            }));
+        }
+        return body;
+    }
+}
+// ===================================================================
+// ModelCatalog
+// ===================================================================
+/**
+ * 模型目录（AIInvoker.listModels() 返回值）。
+ *
+ * 计算规则：
+ * - 第一个模型 = 全局默认
+ * - 每个 modality 的第一个支持模型 = 该 modality 的默认
+ */
+export class ModelCatalog {
+    byId;
+    def;
+    constructor(items, ai) {
+        if (!items?.length) {
+            this.byId = new Map();
+            this.def = undefined;
+            return;
+        }
+        const first = new Map();
+        for (const item of items) {
+            for (const m of item.modalities) {
+                if (!first.has(m))
+                    first.set(m, item.id);
+            }
+        }
+        const enriched = items.map((item, i) => create_city_model(ai, {
+            ...item,
+            is_default: i === 0,
+            default_modalities: item.modalities.filter((m) => first.get(m) === item.id) || undefined,
+        }));
+        this.byId = new Map(enriched.map((item) => [item.id, item]));
+        this.def = enriched[0];
+    }
+    get(id) {
+        return this.byId.get(String(id ?? "").trim());
+    }
+    default() {
+        return this.def;
+    }
+    all() {
+        return [...this.byId.values()];
+    }
+    forModality(modality) {
+        const m = String(modality ?? "").trim();
+        return [...this.byId.values()].filter((item) => item.modalities.includes(m));
+    }
+}
+/** 将 UserModelInput 转为字符串 */
+export function serializeModel(model) {
+    if (!model)
+        return undefined;
+    return typeof model === "string" ? model : model.id;
+}
+function create_city_model(ai, item) {
+    const model = {
+        ...item,
+        kind: CITY_MODEL_KIND,
+    };
+    Object.defineProperty(model, CITY_MODEL_INVOKER, {
+        enumerable: false,
+        configurable: false,
+        writable: false,
+        value: {
+            text: async (input) => await ai.text({ ...input, model: item.id }),
+            stream: async (input) => await ai.stream({ ...input, model: item.id }),
+        },
+    });
+    return Object.freeze(model);
+}
+// ===================================================================
+// ModelHandle — 绑定模型 ID 的操作句柄
+// ===================================================================
+/**
+ * 模型操作句柄。
+ *
+ * 两种使用方式：
+ * 1. 便捷调用：m.text() / m.stream() — 走 server
+ * 2. 接入其他 SDK：m.url() + m.modelName() + m.token — 自己拼
+ *
+ * 通过 `client.ai.model(ref)` 获取，ref 来自 `listModels()`。
+ */
+export class ModelHandle {
+    ai;
+    id;
+    name;
+    /** 模型元数据（来自 server 的 PublicModel.meta） */
+    meta;
+    /** Server AI 端点 */
+    endpoint;
+    /** User auth token */
+    token;
+    constructor(ai, 
+    /** 模型 ID */
+    id, 
+    /** 模型展示名称 */
+    name = id, 
+    /** Server AI 端点 */
+    endpoint = "", 
+    /** User auth token */
+    token, meta) {
+        this.ai = ai;
+        this.id = id;
+        this.name = name;
+        this.endpoint = endpoint;
+        this.token = token;
+        this.meta = meta ?? {};
+    }
+    // ======== 便捷调用（走 server） ========
+    /** 流式生成 */
+    stream(input) {
+        return this.ai.stream({ ...input, model: this.id });
+    }
+    /** 文本生成 */
+    text(input) {
+        return this.ai.text({ ...input, model: this.id });
+    }
+    /** 图片生成 */
+    image(input) {
+        return this.ai.image({ ...input, model: this.id });
+    }
+    /** 视频生成 */
+    video(input) {
+        return this.ai.video({ ...input, model: this.id });
+    }
+    // ======== 接入其他 SDK 的零配件 ========
+    /** Server AI 端点 URL */
+    url() {
+        return this.endpoint;
+    }
+    /** 模型名称（API 调用时的 model 参数值） */
+    modelName() {
+        return this.id;
+    }
+}
+//# sourceMappingURL=index.js.map

package/bin/city/invoker/ai/index.js.map

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

package/bin/city/invoker/ai/stream.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI SDK UIMessage stream 解析（对应 core AIService stream handler 的输出）。
+ */
+import type { RawStreamBody } from "../../http.js";
+import type { UserStreamResult } from "../../user/types.js";
+/** 解析 AI SDK UIMessage SSE body */
+export declare function parseAIStreamBody(body: RawStreamBody): UserStreamResult;
+//# sourceMappingURL=stream.d.ts.map

package/bin/city/invoker/ai/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../../src/city/invoker/ai/stream.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,mCAAmC;AACnC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAGvE"}

package/bin/city/invoker/ai/stream.js

@@ -0,0 +1,17 @@
+/**
+ * AI SDK UIMessage stream 解析（对应 core AIService stream handler 的输出）。
+ */
+import { DefaultChatTransport } from "ai";
+/** 解析 AI SDK UIMessage SSE body */
+export function parseAIStreamBody(body) {
+    if (!body)
+        throw new Error("Downcity stream response body is empty");
+    return parser.parse(body);
+}
+class Parser extends DefaultChatTransport {
+    parse(stream) {
+        return this.processResponseStream(stream);
+    }
+}
+const parser = new Parser();
+//# sourceMappingURL=stream.js.map

package/bin/city/invoker/ai/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../../src/city/invoker/ai/stream.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,IAAI,CAAC;AAK1C,mCAAmC;AACnC,MAAM,UAAU,iBAAiB,CAAC,IAAmB;IACnD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,MAAO,SAAQ,oBAA+B;IAClD,KAAK,CAAC,MAAkC;QACtC,OAAO,IAAI,CAAC,qBAAqB,CAAC,MAAqD,CAAC,CAAC;IAC3F,CAAC;CACF;AAED,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/bin/city/invoker/ai/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AI 模型类型（对应 core service/ai/types.ts PublicModel）。
+ *
+ * 关键点（中文）
+ * - CityModel 是跨 package 共享协议，定义在 @downcity/type。
+ * - UserModelRef 保留为 City 内部语义别名，避免一次性扩大改名范围。
+ */
+import type { CityModel, CityModelEnvRequirement } from "@downcity/type";
+export type UserModelEnvRequirement = CityModelEnvRequirement;
+/** 客户端可见的 Model 引用。 */
+export type UserModelRef = CityModel;
+/** 模型标识（Ref 或 ID 字符串）。 */
+export type UserModelInput = UserModelRef | string;
+//# sourceMappingURL=types.d.ts.map

package/bin/city/invoker/ai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/city/invoker/ai/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AAE9D,uBAAuB;AACvB,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC;AAErC,0BAA0B;AAC1B,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC"}

package/bin/city/invoker/ai/types.js

@@ -0,0 +1,9 @@
+/**
+ * AI 模型类型（对应 core service/ai/types.ts PublicModel）。
+ *
+ * 关键点（中文）
+ * - CityModel 是跨 package 共享协议，定义在 @downcity/type。
+ * - UserModelRef 保留为 City 内部语义别名，避免一次性扩大改名范围。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/bin/city/invoker/ai/types.js.map

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

package/bin/city/invoker/balance/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Balance Service 管理端调用器。
+ *
+ * 路由：/v1/balance/*
+ */
+import type { RequestInitLike } from "../../http.js";
+import type { BalanceAccountRecord, BalanceHistoryListInput, BalanceLedgerRecord, BalanceMutationInput, BalanceRedeemCodeCreateInput, BalanceRedeemCodeDisableInput, BalanceRedeemCodeIssueResult, BalanceRedeemCodeListInput, BalanceRedeemCodeRecord, BalanceTopupListInput, BalanceTopupRecord, BalanceTopupUpdateInput } from "./types.js";
+/**
+ * Balance 管理端调用器。
+ *
+ * 通过 `admin.balance` 访问：
+ * ```ts
+ * await admin.balance.listUsers();
+ * const issued = await admin.balance.redeemCodes.create({ amount: 500 });
+ * ```
+ */
+export declare class BalanceInvoker {
+    /**
+     * redeem_code 子调用器。
+     */
+    readonly redeemCodes: BalanceRedeemCodeInvoker;
+    private readonly req;
+    constructor(opts: {
+        requestJSON: <T>(path: string, init: RequestInitLike) => Promise<T>;
+    });
+    /**
+     * 列出余额账户。
+     */
+    listUsers(limit?: string | number): Promise<BalanceAccountRecord[]>;
+    /**
+     * 列出余额流水。
+     */
+    listHistory(input?: BalanceHistoryListInput): Promise<BalanceLedgerRecord[]>;
+    /**
+     * 列出充值单。
+     */
+    listTopups(input?: BalanceTopupListInput): Promise<BalanceTopupRecord[]>;
+    /**
+     * 手动加余额。
+     */
+    add(input: BalanceMutationInput): Promise<BalanceAccountRecord>;
+    /**
+     * 手动扣余额。
+     */
+    sub(input: BalanceMutationInput): Promise<BalanceAccountRecord>;
+    /**
+     * 确认充值单到账。
+     */
+    finishTopup(input: BalanceTopupUpdateInput): Promise<BalanceTopupRecord>;
+    /**
+     * 取消充值单。
+     */
+    cancelTopup(input: BalanceTopupUpdateInput): Promise<BalanceTopupRecord>;
+}
+/**
+ * redeem_code 管理端调用器。
+ */
+export declare class BalanceRedeemCodeInvoker {
+    private readonly req;
+    constructor(opts: {
+        requestJSON: <T>(path: string, init: RequestInitLike) => Promise<T>;
+    });
+    /**
+     * 列出 redeem_code。
+     */
+    list(input?: BalanceRedeemCodeListInput): Promise<BalanceRedeemCodeRecord[]>;
+    /**
+     * 创建 redeem_code。
+     */
+    create(input: BalanceRedeemCodeCreateInput): Promise<BalanceRedeemCodeIssueResult>;
+    /**
+     * 停用 redeem_code。
+     */
+    disable(input: BalanceRedeemCodeDisableInput): Promise<BalanceRedeemCodeRecord>;
+}
+//# sourceMappingURL=index.d.ts.map

package/bin/city/invoker/balance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/city/invoker/balance/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAE/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyD;gBAEjE,IAAI,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;KACrE;IAKD;;OAEG;IACG,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAQzE;;OAEG;IACG,WAAW,CAAC,KAAK,GAAE,uBAA4B,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAQtF;;OAEG;IACG,UAAU,CAAC,KAAK,GAAE,qBAA0B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQlF;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAO/D;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAO/D;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOxE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAMzE;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyD;gBAEjE,IAAI,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;KACrE;IAID;;OAEG;IACG,IAAI,CAAC,KAAK,GAAE,0BAA+B,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAQtF;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAOlF;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAMhF"}