@downcity/city 0.2.200 → 0.2.211

package/bin/types/Bureau.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Bureau 公共类型模块。
+ *
+ * Bureau 是某个 City 部署在独立服务器上的可选后端。它使用 Bureau Token
+ * 获取自身 City 上下文，并使用 Federation 公钥在本地验证 user_token。
+ */
+/** Bureau 使用的标准 fetch 能力。 */
+export type BureauFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/** Bureau Token 可访问的 Federation 服务端能力。 */
+export type BureauCapability = "accounts:read";
+/** Federation 数据库中的 Bureau Token 记录。 */
+export interface BureauTokenRecord extends Record<string, unknown> {
+    /** Bureau Token 的公开查找 ID。 */
+    token_id: string;
+    /** Bureau 所属的唯一 City ID。 */
+    city_id: string;
+    /** Bureau Token 完整明文的 SHA-256 Base64URL hash。 */
+    token_hash: string;
+    /** JSON 编码的 Bureau capability 列表。 */
+    capabilities: string;
+    /** Token 当前状态。 */
+    status: "active" | "revoked";
+    /** Token 创建时间。 */
+    created_at: string;
+    /** Token 最后更新时间。 */
+    updated_at: string;
+}
+/** 已通过 Federation 验证的 Bureau 服务端身份。 */
+export interface RuntimeBureau {
+    /** Bureau Token ID。 */
+    token_id: string;
+    /** Bureau 所属的唯一 City ID。 */
+    city_id: string;
+    /** Bureau 被授予的 Federation 能力。 */
+    capabilities: BureauCapability[];
+}
+/** Federation 管理端登记 Bureau Token 的输入。 */
+export interface RegisterBureauTokenInput {
+    /** CLI 生成的 Bureau Token 查找 ID。 */
+    token_id: string;
+    /** CLI 对完整 Bureau Token 计算的 SHA-256 Base64URL hash。 */
+    token_hash: string;
+    /** Bureau 所属的唯一 City ID。 */
+    city_id: string;
+    /** Bureau capability；默认允许读取用户账户数据。 */
+    capabilities?: BureauCapability[];
+}
+/** Federation 服务端列出的 Bureau Token 元数据。 */
+export interface BureauTokenSummary {
+    /** Bureau Token 的公开查找 ID。 */
+    token_id: string;
+    /** Bureau 所属的唯一 City ID。 */
+    city_id: string;
+    /** Bureau capability。 */
+    capabilities: BureauCapability[];
+    /** Token 当前状态。 */
+    status: "active" | "revoked";
+    /** Token 创建时间。 */
+    created_at: string;
+    /** Token 最后更新时间。 */
+    updated_at: string;
+}
+/** Bureau 从 Federation 获取的可信运行上下文。 */
+export interface BureauContext {
+    /** Bureau Token ID。 */
+    token_id: string;
+    /** Bureau 所属的唯一 City ID。 */
+    city_id: string;
+    /** Bureau 被授予的 Federation 能力。 */
+    capabilities: BureauCapability[];
+}
+/** Bureau 构造参数。 */
+export interface BureauOptions {
+    /** 预先信任的 Federation HTTP 入口地址。 */
+    federation_url: string;
+    /** Federation 注册表中属于该 City 后端的 Bureau Token。 */
+    bureau_token: string;
+    /** 自定义 fetch 实现。 */
+    fetch?: BureauFetch;
+    /** Federation 上下文与 JWKS 的本地缓存时间，单位毫秒。 */
+    jwks_cache_ttl?: number;
+}
+/** Bureau 本地验签后得到的 Federation 用户身份。 */
+export interface BureauIdentity {
+    /** Federation 用户 ID，来源于已验证 JWT。 */
+    user_id: string;
+    /** 与当前 Bureau 注册记录一致的 City ID。 */
+    city_id: string;
+    /** user_token 中携带的可信业务元数据。 */
+    metadata: Record<string, unknown>;
+    /** user_token 唯一 ID，来源于 JWT jti。 */
+    token_id: string;
+    /** user_token 过期时间，Unix 秒。 */
+    expires_at: number;
+}
+//# sourceMappingURL=Bureau.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Bureau.d.ts","sourceRoot":"","sources":["../../src/types/Bureau.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAE/C,wCAAwC;AACxC,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IAEnB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IAErB,kBAAkB;IAClB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE7B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,iCAAiC;IACjC,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,yCAAyC;AACzC,MAAM,WAAW,wBAAwB;IACvC,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IAEnB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IAEjC,kBAAkB;IAClB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE7B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,iCAAiC;IACjC,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,mBAAmB;AACnB,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IAEvB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IAErB,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAEhB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/bin/types/Bureau.js

@@ -0,0 +1,8 @@
+/**
+ * Bureau 公共类型模块。
+ *
+ * Bureau 是某个 City 部署在独立服务器上的可选后端。它使用 Bureau Token
+ * 获取自身 City 上下文，并使用 Federation 公钥在本地验证 user_token。
+ */
+export {};
+//# sourceMappingURL=Bureau.js.map

package/bin/types/Bureau.js.map

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

package/bin/types/FederationAdmin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * FederationAdmin 公共类型模块。
+ *
+ * FederationAdmin 只属于 Federation 控制面，不参与 City 或 Bureau 用户请求。
+ */
+import type { FetchLike } from "../pact/http.js";
+/** FederationAdmin 构造参数。 */
+export interface FederationAdminOptions {
+    /** Federation 的 HTTP 入口地址。 */
+    federation_url: string;
+    /** Federation 全局管理 Bearer Secret。 */
+    admin_secret_key: string;
+    /** 自定义 fetch 实现。 */
+    fetch?: FetchLike;
+}
+//# sourceMappingURL=FederationAdmin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FederationAdmin.d.ts","sourceRoot":"","sources":["../../src/types/FederationAdmin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,4BAA4B;AAC5B,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IAEvB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,oBAAoB;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB"}

package/bin/types/FederationAdmin.js

@@ -0,0 +1,7 @@
+/**
+ * FederationAdmin 公共类型模块。
+ *
+ * FederationAdmin 只属于 Federation 控制面，不参与 City 或 Bureau 用户请求。
+ */
+export {};
+//# sourceMappingURL=FederationAdmin.js.map

package/bin/types/FederationAdmin.js.map

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

package/bin/types/Metering.d.ts

@@ -11,9 +11,9 @@
  */
 export interface RuntimeMetering {
     /**
-     * 计量所属 provider ID，例如 `deepseek`、`openai-image`。
+     * 计量所属 AIChannel ID，例如 `deepseek`、`openai-image`。
      */
-    provider_id?: string;
+    channel_id?: string;
     /**
      * Downcity 模型 ID。
      */

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

@@ -1 +1 @@
-{"version":3,"file":"Metering.d.ts","sourceRoot":"","sources":["../../src/types/Metering.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}
+{"version":3,"file":"Metering.d.ts","sourceRoot":"","sources":["../../src/types/Metering.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/bin/types/User.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Federation 用户公共类型模块。
+ *
+ * City 直接访问 Federation，Bureau 也可以在完成本地验签后按需读取同一份
+ * 用户数据，因此两端共用这些类型。
+ */
+/** Federation Accounts 当前用户 Profile。 */
+export interface UserProfile {
+    /** Federation 用户 ID。 */
+    user_id: string;
+    /** 用户资料邮箱。 */
+    email: string;
+    /** 用户展示名称。 */
+    display_name: string;
+    /** 用户头像 URL。 */
+    avatar_url: string;
+    /** 用户个人简介。 */
+    bio: string;
+    /** 资料创建时间。 */
+    created_at: string;
+    /** 资料更新时间。 */
+    updated_at: string;
+}
+//# sourceMappingURL=User.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"User.d.ts","sourceRoot":"","sources":["../../src/types/User.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAEhB,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IAEd,cAAc;IACd,YAAY,EAAE,MAAM,CAAC;IAErB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;IAEZ,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;IAEnB,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/bin/types/User.js

@@ -0,0 +1,8 @@
+/**
+ * Federation 用户公共类型模块。
+ *
+ * City 直接访问 Federation，Bureau 也可以在完成本地验签后按需读取同一份
+ * 用户数据，因此两端共用这些类型。
+ */
+export {};
+//# sourceMappingURL=User.js.map

package/bin/types/User.js.map

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

package/bin/utils/CityLanguageModelCodec.d.ts

@@ -4,7 +4,7 @@
  * LanguageModelV3 中的 URL、Uint8Array 和 Date 不是普通 JSON 值。本模块使用
  * 明确标签完成无损转换，并拒绝函数、symbol、bigint 和未知 class 实例。
  */
-import type { CityTransportJsonObject, CityTransportJsonValue } from "../types/CityLanguageModelTransport.js";
+import type { CityTransportJsonObject, CityTransportJsonValue } from "../types/AITransport.js";
 /** 把 LanguageModelV3 值编码成 transport JSON。 */
 export declare function encode_city_transport_value(value: unknown): CityTransportJsonValue;
 /** 把 transport JSON 解码回 LanguageModelV3 可消费的值。 */

package/bin/utils/CityLanguageModelCodec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CityLanguageModelCodec.d.ts","sourceRoot":"","sources":["../../src/utils/CityLanguageModelCodec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,wCAAwC,CAAC;AAIhD,6CAA6C;AAC7C,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CA0ClF;AAED,kDAAkD;AAClD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAsBlF;AAED,uBAAuB;AACvB,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAMpF"}
+{"version":3,"file":"CityLanguageModelCodec.d.ts","sourceRoot":"","sources":["../../src/utils/CityLanguageModelCodec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAIjC,6CAA6C;AAC7C,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CA0ClF;AAED,kDAAkD;AAClD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAsBlF;AAED,uBAAuB;AACvB,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAMpF"}

package/bin/utils/CityLanguageModelResult.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LanguageModelV3 流结果聚合工具。
+ *
+ * 该模块只理解 AI SDK LanguageModelV3 的标准流事件，不了解 Federation transport
+ * 或具体上游协议。CityModel 非流式调用和 AIChannel 通用 text action 复用这里，
+ * 保证两条入口对 text、reasoning、tool、usage 和 metadata 的收口语义一致。
+ */
+import type { LanguageModelV3GenerateResult, LanguageModelV3StreamPart } from "../types/AI.js";
+/** 将标准 LanguageModelV3 流聚合为一次非流式生成结果。 */
+export declare function collect_city_language_model_stream(stream: ReadableStream<LanguageModelV3StreamPart>, request_body?: unknown): Promise<LanguageModelV3GenerateResult>;
+//# sourceMappingURL=CityLanguageModelResult.d.ts.map

package/bin/utils/CityLanguageModelResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityLanguageModelResult.d.ts","sourceRoot":"","sources":["../../src/utils/CityLanguageModelResult.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,wBAAsB,kCAAkC,CACtD,MAAM,EAAE,cAAc,CAAC,yBAAyB,CAAC,EACjD,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,6BAA6B,CAAC,CA+DxC"}

package/bin/utils/CityLanguageModelResult.js

@@ -0,0 +1,76 @@
+/**
+ * LanguageModelV3 流结果聚合工具。
+ *
+ * 该模块只理解 AI SDK LanguageModelV3 的标准流事件，不了解 Federation transport
+ * 或具体上游协议。CityModel 非流式调用和 AIChannel 通用 text action 复用这里，
+ * 保证两条入口对 text、reasoning、tool、usage 和 metadata 的收口语义一致。
+ */
+/** 将标准 LanguageModelV3 流聚合为一次非流式生成结果。 */
+export async function collect_city_language_model_stream(stream, request_body) {
+    const reader = stream.getReader();
+    const content = [];
+    const text_blocks = new Map();
+    const reasoning_blocks = new Map();
+    let warnings = [];
+    let response;
+    let finish_reason;
+    let usage;
+    let provider_metadata;
+    while (true) {
+        const chunk = await reader.read();
+        if (chunk.done)
+            break;
+        const part = chunk.value;
+        const type = String(part.type ?? "");
+        if (type === "error")
+            throw part.error;
+        if (type === "stream-start") {
+            warnings = Array.isArray(part.warnings) ? part.warnings : [];
+        }
+        else if (type === "response-metadata") {
+            const { type: _type, ...metadata } = part;
+            response = metadata;
+        }
+        else if (type === "text-start" || type === "reasoning-start") {
+            const block = {
+                type: type === "text-start" ? "text" : "reasoning",
+                text: "",
+                ...(part.providerMetadata
+                    ? { providerMetadata: part.providerMetadata }
+                    : {}),
+            };
+            content.push(block);
+            const blocks = type === "text-start" ? text_blocks : reasoning_blocks;
+            blocks.set(String(part.id), block);
+        }
+        else if (type === "text-delta" || type === "reasoning-delta") {
+            const blocks = type === "text-delta" ? text_blocks : reasoning_blocks;
+            const block = blocks.get(String(part.id));
+            if (block) {
+                block.text = `${String(block.text ?? "")}${String(part.delta ?? "")}`;
+            }
+        }
+        else if (["file", "source", "tool-call", "tool-result", "tool-approval-request"]
+            .includes(type)) {
+            content.push(part);
+        }
+        else if (type === "finish") {
+            finish_reason = part.finishReason;
+            usage = part.usage;
+            provider_metadata = part.providerMetadata;
+        }
+    }
+    if (!finish_reason || !usage) {
+        throw new Error("Language model stream ended without finish usage");
+    }
+    return {
+        content,
+        finishReason: finish_reason,
+        usage,
+        warnings,
+        ...(provider_metadata ? { providerMetadata: provider_metadata } : {}),
+        ...(request_body !== undefined ? { request: { body: request_body } } : {}),
+        ...(response ? { response } : {}),
+    };
+}
+//# sourceMappingURL=CityLanguageModelResult.js.map

package/bin/utils/CityLanguageModelResult.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/city",
-  "version": "0.2.200",
+  "version": "0.2.211",
   "description": "Downcity City runtime and City access SDK for services, actions, auth, env, and cities.",
   "type": "module",
   "main": "./bin/index.js",
@@ -41,10 +41,11 @@
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@downcity/type": "0.1.153",
+    "@downcity/type": "0.1.158",
     "ai": "^6.0.193",
     "drizzle-orm": "^0.45.2",
-    "hono": "^4.12.23"
+    "hono": "^4.12.23",
+    "jose": "^6.2.3"
   },
   "scripts": {
     "build": "rm -rf bin tsconfig.tsbuildinfo && tsc",

package/bin/federation/auth/token-signer.d.ts

@@ -1,27 +0,0 @@
-/**
- * user_token 签发与校验模块。
- *
- * Downcity 使用 Web Crypto API 的 HMAC-SHA256 生成最小可用的 user_token。
- * 零 Node.js 依赖，兼容所有现代运行时（Node、Workers、Deno、Bun、浏览器）。
- */
-import type { CreateUserTokenInput, UserTokenPayload } from "./types.js";
-export declare class TokenSigner {
-    readonly signingKey: string;
-    /** 缓存的 CryptoKey，避免每次签名都重新 import */
-    private cryptoKey?;
-    constructor(signingKey: string);
-    /**
-     * 获取（或缓存）HMAC CryptoKey。
-     *
-     * 使用 Web Crypto API 的 crypto.subtle.importKey，
-     * 首次调用时创建并缓存 Promise，后续复用。
-     */
-    private getCryptoKey;
-    /** 签发 user_token */
-    sign(input: CreateUserTokenInput): Promise<string>;
-    /** 校验并解析 user_token，失败抛 httpError(401) */
-    verify(token: string): Promise<UserTokenPayload>;
-    /** 把 ttl 解析成秒数 */
-    static parseTTL(ttl: string | number): number;
-}
-//# sourceMappingURL=token-signer.d.ts.map

package/bin/federation/auth/token-signer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token-signer.d.ts","sourceRoot":"","sources":["../../../src/federation/auth/token-signer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE,qBAAa,WAAW;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,qCAAqC;IACrC,OAAO,CAAC,SAAS,CAAC,CAAqB;gBAE3B,UAAU,EAAE,MAAM;IAO9B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAcpB,oBAAoB;IACd,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BxD,0CAA0C;IACpC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BtD,kBAAkB;IAClB,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;CAyB9C"}

package/bin/federation/auth/token-signer.js

@@ -1,116 +0,0 @@
-/**
- * user_token 签发与校验模块。
- *
- * Downcity 使用 Web Crypto API 的 HMAC-SHA256 生成最小可用的 user_token。
- * 零 Node.js 依赖，兼容所有现代运行时（Node、Workers、Deno、Bun、浏览器）。
- */
-import { httpError, base64UrlEncode, base64UrlDecode, base64UrlEncodeBytes, base64UrlDecodeBytes, timingSafeEqualBytes } from "../../utils/helpers.js";
-export class TokenSigner {
-    signingKey;
-    /** 缓存的 CryptoKey，避免每次签名都重新 import */
-    cryptoKey;
-    constructor(signingKey) {
-        if (!signingKey) {
-            throw new Error("TokenSigner requires a signing key");
-        }
-        this.signingKey = signingKey;
-    }
-    /**
-     * 获取（或缓存）HMAC CryptoKey。
-     *
-     * 使用 Web Crypto API 的 crypto.subtle.importKey，
-     * 首次调用时创建并缓存 Promise，后续复用。
-     */
-    getCryptoKey() {
-        if (!this.cryptoKey) {
-            const encoder = new TextEncoder();
-            this.cryptoKey = crypto.subtle.importKey("raw", encoder.encode(this.signingKey), { name: "HMAC", hash: "SHA-256" }, false, ["sign", "verify"]);
-        }
-        return this.cryptoKey;
-    }
-    /** 签发 user_token */
-    async sign(input) {
-        if (!input || typeof input.city_id !== "string" || input.city_id.length === 0) {
-            throw new TypeError("city_id is required");
-        }
-        if (typeof input.user_id !== "string" || input.user_id.length === 0) {
-            throw new TypeError("user_id is required");
-        }
-        const ttl = input.ttl;
-        const now = Math.floor(Date.now() / 1000);
-        const payload = {
-            aud: "downcity:user",
-            city_id: input.city_id,
-            user_id: input.user_id,
-            metadata: input.metadata ?? {},
-            iat: now,
-        };
-        if (ttl) {
-            payload.exp = now + TokenSigner.parseTTL(ttl);
-        }
-        const encodedPayload = base64UrlEncode(JSON.stringify(payload));
-        const signature = await signPayload(await this.getCryptoKey(), encodedPayload);
-        return `ub_${encodedPayload}.${signature}`;
-    }
-    /** 校验并解析 user_token，失败抛 httpError(401) */
-    async verify(token) {
-        const rawToken = token.startsWith("ub_") ? token.slice(3) : token;
-        const [encodedPayload, signature] = rawToken.split(".");
-        if (!encodedPayload || !signature) {
-            throw httpError(401, "Invalid user token");
-        }
-        if (!await verifyPayload(await this.getCryptoKey(), encodedPayload, signature)) {
-            throw httpError(401, "Invalid user token signature");
-        }
-        const payload = JSON.parse(base64UrlDecode(encodedPayload));
-        const now = Math.floor(Date.now() / 1000);
-        if (payload.exp && payload.exp <= now) {
-            throw httpError(401, "User token expired");
-        }
-        if (payload.aud !== "downcity:user") {
-            throw httpError(401, "Invalid user token audience");
-        }
-        if (!payload.city_id || !payload.user_id) {
-            throw httpError(401, "Invalid user token payload");
-        }
-        return payload;
-    }
-    /** 把 ttl 解析成秒数 */
-    static parseTTL(ttl) {
-        if (typeof ttl === "number" && Number.isFinite(ttl) && ttl > 0) {
-            return ttl;
-        }
-        if (typeof ttl !== "string") {
-            throw new TypeError("ttl must be a positive number of seconds or a string like 1h");
-        }
-        const match = ttl.match(/^(\d+)(s|m|h|d)$/);
-        if (!match) {
-            throw new Error(`Invalid ttl: ${ttl}`);
-        }
-        const value = Number(match[1]);
-        const unit = match[2];
-        const multipliers = {
-            s: 1,
-            m: 60,
-            h: 60 * 60,
-            d: 24 * 60 * 60,
-        };
-        return value * multipliers[unit];
-    }
-}
-/**
- * 使用 HMAC-SHA256 对 payload 签名，返回 base64url 编码的签名。
- */
-async function signPayload(cryptoKey, encodedPayload) {
-    const signature = await crypto.subtle.sign("HMAC", cryptoKey, new TextEncoder().encode(encodedPayload));
-    return base64UrlEncodeBytes(new Uint8Array(signature));
-}
-/**
- * 验证 HMAC-SHA256 签名是否匹配。
- */
-async function verifyPayload(cryptoKey, encodedPayload, signature) {
-    const expected = base64UrlDecodeBytes(signature);
-    const actual = await crypto.subtle.sign("HMAC", cryptoKey, new TextEncoder().encode(encodedPayload));
-    return timingSafeEqualBytes(new Uint8Array(actual), expected);
-}
-//# sourceMappingURL=token-signer.js.map

package/bin/federation/auth/token-signer.js.map

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

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

@@ -1,76 +0,0 @@
-/**
- * AI Provider 扣费协议。
- *
- * 关键说明（中文）
- * - Provider 自己理解上游 usage 与价格规则，并返回最终应扣金额。
- * - AIService 只负责在正确的生命周期内提交扣费，不理解 token/cache 等 provider 细节。
- * - Balance bridge 只暴露通用 charge 能力，避免 @downcity/city 反向依赖 @downcity/services。
- */
-import type { Context } from "../service.js";
-/**
- * Provider 计算出的单次扣费结果。
- */
-export interface AIProviderChargeLine {
-    /**
-     * 可选扣费用户 ID。
-     *
-     * 图片 result 轮询可能由 admin 或服务端代发，没有当前 user。
-     * 这时 bill() 应从已保存任务归属中返回 user_id，AIService 会优先使用它。
-     */
-    user_id?: string;
-    /** 扣费额度，单位为 credits。 */
-    credits: number;
-    /** 账单说明。 */
-    note?: string;
-    /** 外部引用 ID。 */
-    ref?: string;
-    /** 内部审计信息，不作为跨 provider 的公共 usage 协议。 */
-    metadata?: Record<string, unknown>;
-}
-/**
- * AIService 提交给外部 Balance bridge 的扣费输入。
- */
-export interface AIBalanceChargeInput extends AIProviderChargeLine {
-    /** 当前用户 ID。 */
-    user_id: string;
-    /** 可选幂等键；相同键的重复提交必须只产生一次扣费。 */
-    idempotency_key?: string;
-}
-/**
- * AIService 依赖的最小 Balance bridge。
- */
-export interface AIBalanceBridge {
-    /**
-     * 执行余额前置检查。
-     *
-     * AIService 默认调用时不传 needed_credits，只拦截已经欠费的用户。
-     */
-    precheck?(user_id: string, needed_credits?: number): Promise<{
-        credits: number;
-    }>;
-    /** 执行扣费并记录账单。 */
-    charge(input: AIBalanceChargeInput): Promise<unknown>;
-}
-/**
- * Provider 或模型生成扣费行的方法。
- */
-export type AIProviderBillFn = (ctx: Context, output: unknown) => AIProviderChargeLine | Promise<AIProviderChargeLine | undefined> | undefined;
-/**
- * Provider action 可返回的带扣费普通输出。
- */
-export interface AIProviderChargedOutput<T = unknown> {
-    /** 对外返回的原始 action 输出。 */
-    output: T;
-    /** Provider 已计算好的扣费结果。 */
-    charge?: AIProviderChargeLine | Promise<AIProviderChargeLine | undefined> | undefined;
-}
-/**
- * Provider action 可返回的带扣费 Response 输出。
- */
-export interface AIProviderChargedResponse {
-    /** 对外返回的 HTTP Response。 */
-    response: Response;
-    /** Provider 已计算好的扣费结果。 */
-    charge?: AIProviderChargeLine | Promise<AIProviderChargeLine | undefined> | undefined;
-}
-//# sourceMappingURL=charge.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"charge.d.ts","sourceRoot":"","sources":["../../../src/service/ai/charge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElF,iBAAiB;IACjB,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,OAAO,KACZ,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,OAAO;IAClD,yBAAyB;IACzB,MAAM,EAAE,CAAC,CAAC;IACV,0BAA0B;IAC1B,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACvF;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACvF"}

package/bin/service/ai/charge.js

@@ -1,10 +0,0 @@
-/**
- * AI Provider 扣费协议。
- *
- * 关键说明（中文）
- * - Provider 自己理解上游 usage 与价格规则，并返回最终应扣金额。
- * - AIService 只负责在正确的生命周期内提交扣费，不理解 token/cache 等 provider 细节。
- * - Balance bridge 只暴露通用 charge 能力，避免 @downcity/city 反向依赖 @downcity/services。
- */
-export {};
-//# sourceMappingURL=charge.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"charge.js","sourceRoot":"","sources":["../../../src/service/ai/charge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}