@downcity/city 0.2.93 → 0.2.100

package/bin/index.d.ts

@@ -14,13 +14,14 @@ export { InstallableService } from "./service/installable-service.js";
 export { Action } from "./service/action.js";
 export type { Context, RouteAuth, EnvRequirement, } from "./service/service.js";
 export type { RuntimeMetering, } from "./types/Metering.js";
+export type { AsyncJobRecord, AsyncJobStatus, } from "./types/AsyncJob.js";
 export type { ActionFn, HookFn, } from "./service/action.js";
 export type { ServiceDefinition, ServiceInstallContext, ServiceRouteContext, } from "./service/installable-service.js";
 export type { InstructionDefinition, InstructionContext, InstructionActionDefinition, InstructionCapable, } from "./service/instruction.js";
 export { AIService } from "./service/ai/ai-service.js";
 export { Provider } from "./service/ai/provider.js";
 export type { AIServiceOptions, ModelConfig, ModelActions, OpenAICompatibleClient, OpenAICompatibleClientConfig, ProviderOptions, PublicModel, } from "./service/ai/types.js";
-export { buildAssistantMessage, buildImageMessage, buildToolSet, isRecord, normalizeAIUsage, normalizeOpenAICompatibleBody, readErrorMessage, readImageJobStepContext, readJsonResponse, readOpenAICompatibleSseUsage, readRequiredEnv, readString, resolveUpstreamModel, stripUndefined, toRecord, trimTrailingSlash, } from "./service/ai/helpers.js";
+export { buildAssistantMessage, buildImageMessage, buildToolSet, isRecord, normalizeAIUsage, normalizeOpenAICompatibleBody, readErrorMessage, readJsonResponse, readOpenAICompatibleSseUsage, readRequiredEnv, readString, resolveUpstreamModel, stripUndefined, toRecord, trimTrailingSlash, } from "./service/ai/helpers.js";
 export type { BuildAssistantMessageResult, ExtractedImage, ToolCallShape, } from "./service/ai/helpers.js";
 export type { AIBalanceBridge, AIBalanceChargeInput, AIProviderBillFn, AIProviderChargedOutput, AIProviderChargedResponse, AIProviderChargeLine, } from "./service/ai/charge.js";
 export { TokenSigner } from "./federation/auth/token-signer.js";
@@ -40,7 +41,7 @@ export { AIInvoker, ModelCatalog, ModelHandle } from "./pact/invoker/ai/index.js
 export { PaymentInvoker, PaymentMethodHandle } from "./pact/invoker/payment/index.js";
 export { ServiceClient, ActionClient } from "./pact/invoker/invoker.js";
 export type { UserPaymentMethod, UserPaymentMethodReason, UserPaymentMethodType, UserImageContent, UserImageFileContent, UserImageInput, UserImageJobCreateResult, UserImageJobResult, UserImageJobResultInput, UserImageJobStatus, UserImageMessage, UserImageResult, UserImageTextContent, UserServiceInput, UserServiceSummary, UserStreamChunk, UserStreamResult, UserTextResult, UserVideoResult, } from "./pact/user/types.js";
-export type { AIImageJobStepContext, AIImageJobStepResult, AIImageJobStepState, } from "./service/ai/job-types.js";
+export type { AIImageProviderCreateResult, AIImageProviderPersistResult, AIImageProviderResult, } from "./service/ai/job-types.js";
 export type { UserPaymentMethod as PaymentMethod, UserPaymentMethodReason as PaymentMethodReason, UserPaymentMethodType as PaymentMethodType, } from "./pact/invoker/payment/types.js";
 export type { UserModelRef, UserModelInput, } from "./pact/invoker/ai/types.js";
 export { BalanceInvoker, BalanceRedeemCodeInvoker } from "./pact/invoker/balance/index.js";
@@ -50,5 +51,6 @@ export type { AdminInstructionResult, AdminModelRecord, AdminServiceSummary, } f
 export type { BalanceAccountRecord, BalanceHistoryListInput, BalanceLedgerRecord, BalanceMutationInput, BalanceRedeemCodeCreateInput, BalanceRedeemCodeDisableInput, BalanceRedeemCodeIssueResult, BalanceRedeemCodeListInput, BalanceRedeemCodeRecord, BalanceTopupListInput, BalanceTopupRecord, BalanceTopupUpdateInput, } from "./pact/invoker/balance/types.js";
 export type { CityCreateInput, CityRecord, TokenApplyInput, TokenApplyResult, } from "./pact/invoker/cities/types.js";
 export { sqliteEnv, pgEnv } from "./service/env/schema.js";
+export { sqliteAsyncJobs, pgAsyncJobs } from "./service/async-job/schema.js";
 export { randomSecret, base64UrlEncode, base64UrlDecode, base64UrlEncodeBytes, base64UrlDecodeBytes, timingSafeEqualBytes, httpError, normalizeEnvKey, bearerToken, parseDotenvEntries, } from "./utils/helpers.js";
 //# sourceMappingURL=index.d.ts.map

package/bin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACvF,YAAY,EAAE,8BAA8B,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAC/G,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAM7F,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,YAAY,EACV,OAAO,EACP,SAAS,EACT,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,cAAc,EACd,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,QAAQ,EACR,MAAM,GACP,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,4BAA4B,EAC5B,eAAe,EACf,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,6BAA6B,EAC7B,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,2BAA2B,EAC3B,cAAc,EACd,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAMtD,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAM5D,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAExE,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,iBAAiB,IAAI,aAAa,EAClC,uBAAuB,IAAI,mBAAmB,EAC9C,qBAAqB,IAAI,iBAAiB,GAC3C,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EACV,YAAY,EACZ,cAAc,GACf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,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,iCAAiC,CAAC;AAEzC,YAAY,EACV,eAAe,EACf,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAM7E,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,eAAe,EACf,WAAW,EACX,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/bin/index.js

@@ -17,7 +17,7 @@ export { InstallableService } from "./service/installable-service.js";
 export { Action } from "./service/action.js";
 export { AIService } from "./service/ai/ai-service.js";
 export { Provider } from "./service/ai/provider.js";
-export { buildAssistantMessage, buildImageMessage, buildToolSet, isRecord, normalizeAIUsage, normalizeOpenAICompatibleBody, readErrorMessage, readImageJobStepContext, readJsonResponse, readOpenAICompatibleSseUsage, readRequiredEnv, readString, resolveUpstreamModel, stripUndefined, toRecord, trimTrailingSlash, } from "./service/ai/helpers.js";
+export { buildAssistantMessage, buildImageMessage, buildToolSet, isRecord, normalizeAIUsage, normalizeOpenAICompatibleBody, readErrorMessage, readJsonResponse, readOpenAICompatibleSseUsage, readRequiredEnv, readString, resolveUpstreamModel, stripUndefined, toRecord, trimTrailingSlash, } from "./service/ai/helpers.js";
 // ===========================================================================
 // 场景 3：用户鉴权与 Token
 // ===========================================================================
@@ -39,6 +39,7 @@ export { EnvInvoker } from "./pact/invoker/env/index.js";
 // 场景 7：内置表 Schema
 // ===========================================================================
 export { sqliteEnv, pgEnv } from "./service/env/schema.js";
+export { sqliteAsyncJobs, pgAsyncJobs } from "./service/async-job/schema.js";
 // ===========================================================================
 // 场景 8：工具函数
 // ===========================================================================

package/bin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAKxD,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA8B7C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAYpD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,6BAA6B,EAC7B,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,4BAA4B,EAC5B,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAiBjC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAShE,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAQ1D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAOtD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAqB3C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAUxC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAyCxE,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AA8BzD,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAE3D,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,eAAe,EACf,WAAW,EACX,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAKxD,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAmC7C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAYpD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,6BAA6B,EAC7B,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAiBjC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAShE,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAQ1D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAOtD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAqB3C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAUxC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAyCxE,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AA8BzD,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE7E,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,SAAS,EACT,eAAe,EACf,WAAW,EACX,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

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

@@ -9,14 +9,17 @@
  * 路由（City 自动生成）：
  * - POST /v1/ai/text             — 文本生成
  * - POST /v1/ai/stream           — 流式生成
- * - POST /v1/ai/image            — 图片生成
  * - POST /v1/ai/video            — 视频生成
+ * - POST /v1/ai/image/create     — 创建图片生成任务
+ * - POST /v1/ai/image/result     — 查询图片生成任务
+ * - POST /v1/ai/image/persist    — 后台持久化图片结果（admin）
  * - POST /v1/ai/chat/completions — OpenAI 兼容端点
  * - GET  /v1/ai/models           — 模型列表
  */
-import { Service } from "../service.js";
+import { Service, type Context } from "../service.js";
 import type { ActionFn } from "../action.js";
 import type { AIServiceOptions, ModelConfig, PublicModel } from "./types.js";
+import type { AIImageProviderPersistResult } from "./job-types.js";
 type EnvReader = (key: string) => string | undefined;
 export declare class AIService extends Service {
     /** 模型注册表 */
@@ -49,13 +52,14 @@ export declare class AIService extends Service {
     private handleModality;
     private createImageJob;
     private readImageJob;
-    private advanceImageJob;
-    private runImageJob;
-    private imageJobTable;
-    private getImageJob;
-    private updateImageJob;
-    private ensureImageJobAccess;
-    private toImageJobResult;
+    /**
+     * 持久化图片任务结果，并在持久化成功后触发计费。
+     *
+     * 关键点（中文）
+     * - 这个方法供后台 worker / queue / cron 调用，不是前端轮询 API。
+     * - Provider 负责把结果写入自己的存储；AIService 只在 succeeded 后执行 model.bill。
+     */
+    persistImageJob(ctx: Context): Promise<AIImageProviderPersistResult>;
     private handleChatCompletions;
     /**
      * 将解析出的模型写回原始 Context，供 hook / usage / charge 读取。

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;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI7C,OAAO,KAAK,EACV,gBAAgB,EAEhB,WAAW,EAEX,WAAW,EACZ,MAAM,YAAY,CAAC;AAwBpB,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAsMrD,qBAAa,SAAU,SAAQ,OAAO;IACpC,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAkC;IAElD,0CAA0C;IAC1C,OAAO,CAAC,eAAe,CAA+B;IAEtD,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;gBAE/B,OAAO,GAAE,gBAAqB;IAmC1C,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,EAAE,GAAG,IAAI;IAarD,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;IA2B7G,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,2BAA2B;IAmCnC,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,aAAa;YAQP,cAAc;YAuBd,cAAc;YA6Dd,YAAY;YAYZ,eAAe;YAuDf,WAAW;IA+BzB,OAAO,CAAC,aAAa;YAMP,WAAW;YAKX,cAAc;IAQ5B,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,gBAAgB;YAgBV,qBAAqB;IAwBnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;YACW,YAAY;IAiC1B,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;IAYjB,OAAO,CAAC,aAAa;CAgBtB"}
+{"version":3,"file":"ai-service.d.ts","sourceRoot":"","sources":["../../../src/service/ai/ai-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,KAAK,EACV,gBAAgB,EAEhB,WAAW,EAEX,WAAW,EACZ,MAAM,YAAY,CAAC;AAOpB,OAAO,KAAK,EAEV,4BAA4B,EAI7B,MAAM,gBAAgB,CAAC;AAUxB,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAmJrD,qBAAa,SAAU,SAAQ,OAAO;IACpC,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAkC;IAElD,0CAA0C;IAC1C,OAAO,CAAC,eAAe,CAA+B;IAEtD,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;gBAE/B,OAAO,GAAE,gBAAqB;IAsC1C,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,EAAE,GAAG,IAAI;IAarD,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;IA2B7G,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,2BAA2B;IAmCnC,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,aAAa;YAQP,cAAc;YAuBd,cAAc;YAcd,YAAY;IAc1B;;;;;;OAMG;IACG,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,4BAA4B,CAAC;YAsB5D,qBAAqB;IAwBnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;YACW,YAAY;IAkC1B,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;IAYjB,OAAO,CAAC,aAAa;CAgBtB"}

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

@@ -9,21 +9,22 @@
  * 路由（City 自动生成）：
  * - POST /v1/ai/text             — 文本生成
  * - POST /v1/ai/stream           — 流式生成
- * - POST /v1/ai/image            — 图片生成
  * - POST /v1/ai/video            — 视频生成
+ * - POST /v1/ai/image/create     — 创建图片生成任务
+ * - POST /v1/ai/image/result     — 查询图片生成任务
+ * - POST /v1/ai/image/persist    — 后台持久化图片结果（admin）
  * - POST /v1/ai/chat/completions — OpenAI 兼容端点
  * - GET  /v1/ai/models           — 模型列表
  */
 import { Service } from "../service.js";
-import { httpError, randomSecret } from "../../utils/helpers.js";
-import { sqliteAIImageJobs } from "./schema.js";
+import { httpError } from "../../utils/helpers.js";
 import { normalizeAIUsage } from "./helpers.js";
-/** AIService 直接暴露的 SDK 通路模态列表。 */
-const MODALITIES = ["text", "stream", "image", "video", "tts", "asr"];
+/** AIService 直接暴露的 SDK 通路模态列表。图片只通过 image/create + image/result 暴露。 */
+const MODALITIES = ["text", "stream", "video", "tts", "asr"];
 /** 用户侧默认以 text 模态排序模型 */
 const DEFAULT_MODEL_MODE = "text";
-/** 图片任务轮询建议间隔 */
-const IMAGE_JOB_POLL_AFTER_MS = 2_000;
+/** 图片任务的内部 action 列表。 */
+const IMAGE_ACTION_MODES = ["image_create", "image_persist", "image_result"];
 /**
  * 判断一个值是否为 HTTP Response。
  */
@@ -54,15 +55,6 @@ function isProviderChargedOutput(value) {
 function isPromiseLike(value) {
     return Boolean(value && typeof value === "object" && "then" in value && typeof value.then === "function");
 }
-/**
- * 读取必填字符串。
- */
-function readRequiredString(value, label) {
-    const text = readOptionalString(value);
-    if (!text)
-        throw httpError(422, `${label} is required`);
-    return text;
-}
 /**
  * 读取可选字符串。
  */
@@ -70,57 +62,13 @@ function readOptionalString(value) {
     return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
 /**
- * 归一化图片任务输出。
- */
-async function normalizeImageJobOutput(output) {
-    if (!isResponse(output))
-        return output;
-    const text = await output.text();
-    if (!output.ok) {
-        throw httpError(output.status, text || output.statusText || "image generation failed");
-    }
-    return text ? JSON.parse(text) : {};
-}
-/**
- * 解析已持久化的图片任务结果。
- */
-function parseImageJobResult(raw) {
-    try {
-        return JSON.parse(raw);
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * 解析可恢复任务状态。
+ * 保留已知 HTTP 错误状态，其它异常统一包装成上游错误。
  */
-function parseImageJobStepState(raw) {
-    if (!raw)
-        return undefined;
-    try {
-        const parsed = JSON.parse(raw);
-        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
-            ? parsed
-            : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * 解析已持久化的图片任务输入。
- */
-function parseImageJobInput(raw) {
-    try {
-        const parsed = JSON.parse(raw);
-        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
-            ? parsed
-            : {};
-    }
-    catch {
-        return {};
+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。
@@ -159,51 +107,60 @@ function countImageOutputs(output) {
     return count > 0 ? count : undefined;
 }
 /**
- * 判断 provider 是否返回了图片任务推进结果。
+ * 判断 provider 是否返回了图片任务创建结果。
  */
-function isImageJobStepResult(value) {
+function isImageProviderCreateResult(value) {
     if (!value || typeof value !== "object")
         return false;
-    const status = value.status;
-    return status === "running" || status === "succeeded" || status === "failed";
+    const record = value;
+    return typeof record.job_id === "string" &&
+        Boolean(record.job_id.trim()) &&
+        isImageJobStatus(record.status);
 }
 /**
- * 把类型化任务记录转成 TableApi 使用的普通行。
+ * 判断 provider 是否返回了图片任务查询结果。
  */
-function recordToRow(record) {
-    return { ...record };
-}
-/**
- * 把 TableApi 普通行转成图片任务记录。
- */
-function rowToImageJobRecord(row) {
-    return {
-        job_id: String(row.job_id ?? ""),
-        status: readJobStatus(row.status),
-        input_json: String(row.input_json ?? "{}"),
-        result_json: readNullableString(row.result_json),
-        error: readNullableString(row.error),
-        message: readNullableString(row.message),
-        city_id: readNullableString(row.city_id),
-        user_id: readNullableString(row.user_id),
-        model_id: readNullableString(row.model_id),
-        created_at: String(row.created_at ?? ""),
-        updated_at: String(row.updated_at ?? ""),
-    };
+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;
 }
 /**
- * 读取任务状态。
+ * 判断 provider 是否返回了图片持久化结果。
  */
-function readJobStatus(value) {
-    return value === "queued" || value === "running" || value === "succeeded" || value === "failed"
-        ? value
-        : "failed";
+function isImageProviderPersistResult(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 readNullableString(value) {
-    return typeof value === "string" ? value : null;
+function isImageJobStatus(value) {
+    return value === "queued" ||
+        value === "running" ||
+        value === "succeeded" ||
+        value === "failed";
 }
 export class AIService extends Service {
     /** 模型注册表 */
@@ -213,7 +170,7 @@ export class AIService extends Service {
     /** AI 专用余额桥接。 */
     balance;
     constructor(options = {}) {
-        super({ id: "ai", name: "AI", tables: { image_jobs: sqliteAIImageJobs } });
+        super({ id: "ai", name: "AI" });
         this.balance = options.balance;
         // 为每个 modality 注册 routing action
         for (const modality of MODALITIES) {
@@ -228,6 +185,9 @@ export class AIService extends Service {
         this.action("image/result", async (ctx) => this.readImageJob(ctx), {
             auth: ["user", "admin"],
         });
+        this.action("image/persist", async (ctx) => this.persistImageJob(ctx), {
+            auth: ["admin"],
+        });
         // OpenAI 兼容端点
         this.action("chat/completions", async (ctx) => this.handleChatCompletions(ctx), {
             auth: ["user", "admin"],
@@ -290,6 +250,14 @@ export class AIService extends Service {
         throw httpError(422, `No model registered`);
     }
     getAction(model, mode) {
+        if (mode === "image" || IMAGE_ACTION_MODES.includes(mode)) {
+            const has_image_actions = Boolean(model.actions.image_create && model.actions.image_persist && model.actions.image_result);
+            if (!has_image_actions)
+                return undefined;
+            return mode === "image"
+                ? model.actions.image_create
+                : model.actions[mode];
+        }
         return model.actions[(mode ?? "text")];
     }
     resolveOpenAIAction(model) {
@@ -365,9 +333,12 @@ export class AIService extends Service {
     }
     getModelModalities(model) {
         const modalities = Object.keys(model.actions).filter((key) => model.actions[key] !== undefined);
+        if (modalities.includes("image_create") && modalities.includes("image_persist") && modalities.includes("image_result")) {
+            modalities.push("image");
+        }
         if (!modalities.includes("openai") && this.resolveOpenAIAction(model))
             modalities.push("openai");
-        return modalities;
+        return modalities.filter((mode) => mode !== "image_create" && mode !== "image_persist" && mode !== "image_result");
     }
     getModelEnvRequirements(model) {
         const requirements = model.env
@@ -410,197 +381,60 @@ export class AIService extends Service {
     }
     // ========== 图片任务通路 ==========
     async createImageJob(ctx) {
-        const resolved = this.resolve({ model: ctx.input.model, mode: "image" }, ctx.env);
-        const job_id = `img_${randomSecret(12)}`;
+        const resolved = this.resolve({ model: ctx.input.model, mode: "image_create" }, ctx.env);
         this.attachResolvedModel(ctx, resolved.model, "image/create");
-        await this.handleCharge(ctx, resolved.model?.bill?.(ctx, { job_id }), false);
-        const now = new Date().toISOString();
-        const record = {
-            job_id,
-            status: "queued",
-            input_json: JSON.stringify(ctx.input),
-            result_json: null,
-            error: null,
-            message: "queued",
-            city_id: ctx.city?.city_id ?? readOptionalString(ctx.input.city_id),
-            user_id: ctx.user?.user_id ?? null,
-            model_id: resolved.model?.id ?? null,
-            created_at: now,
-            updated_at: now,
-        };
-        await this.imageJobTable(ctx).insert(recordToRow(record));
-        const job_ctx = {
-            ...ctx,
-            input: { ...ctx.input },
-            locals: {},
-            output: undefined,
-            error: undefined,
-        };
-        if (resolved.model?.actions.image_job) {
-            let advanced;
-            try {
-                advanced = await this.advanceImageJob(job_ctx, record);
-            }
-            catch (error) {
-                await this.updateImageJob(ctx, job_id, {
-                    status: "failed",
-                    error: error instanceof Error ? error.message : String(error),
-                    message: "failed",
-                    updated_at: new Date().toISOString(),
-                });
-                throw httpError(502, error instanceof Error ? error.message : "image_job action failed");
+        try {
+            const created = await resolved.action(ctx);
+            if (!isImageProviderCreateResult(created)) {
+                throw httpError(500, "image_create action returned invalid result");
             }
-            return {
-                job_id,
-                status: advanced.status,
-                poll_after_ms: IMAGE_JOB_POLL_AFTER_MS,
-            };
+            return created;
         }
-        else {
-            const promise = this.runImageJob(job_id, job_ctx);
-            if (ctx.waitUntil)
-                ctx.waitUntil(promise);
-            else
-                void promise;
+        catch (error) {
+            throw imageActionError(error, "image_create action failed");
         }
-        return {
-            job_id,
-            status: "queued",
-            poll_after_ms: IMAGE_JOB_POLL_AFTER_MS,
-        };
     }
     async readImageJob(ctx) {
-        const job_id = readRequiredString(ctx.input.job_id, "job_id");
-        const record = await this.getImageJob(ctx, job_id);
-        if (!record)
-            throw httpError(404, `Image job not found: ${job_id}`);
-        this.ensureImageJobAccess(ctx, record);
-        if (record.status === "queued" || record.status === "running") {
-            const advanced = await this.advanceImageJob(ctx, record);
-            return this.toImageJobResult(advanced);
-        }
-        return this.toImageJobResult(record);
-    }
-    async advanceImageJob(ctx, record) {
-        const input = parseImageJobInput(record.input_json);
-        const resolved = this.resolve({ model: input.model, mode: "image" }, ctx.env);
-        const step_action = resolved.model?.actions.image_job;
-        if (!step_action)
-            return record;
-        this.attachResolvedModel(ctx, resolved.model, "image");
-        const step_ctx = {
-            ...ctx,
-            input,
-            locals: {
-                ...ctx.locals,
-                image_job: {
-                    job_id: record.job_id,
-                    status: record.status,
-                    state: parseImageJobStepState(record.result_json),
-                },
-            },
-        };
-        const output = await step_action(step_ctx);
-        if (!isImageJobStepResult(output)) {
-            throw httpError(500, "image_job action returned invalid result");
-        }
-        const updated_at = new Date().toISOString();
-        if (output.status === "succeeded") {
-            if (!output.result)
-                throw httpError(500, "image_job action succeeded without result");
-            await this.updateImageJob(ctx, record.job_id, {
-                status: "succeeded",
-                result_json: JSON.stringify(output.result),
-                error: null,
-                message: output.message ?? "succeeded",
-                updated_at,
-            });
-        }
-        else if (output.status === "failed") {
-            await this.updateImageJob(ctx, record.job_id, {
-                status: "failed",
-                error: output.error ?? output.message ?? "image generation failed",
-                message: output.message ?? "failed",
-                updated_at,
-            });
-        }
-        else {
-            await this.updateImageJob(ctx, record.job_id, {
-                status: "running",
-                result_json: output.state ? JSON.stringify(output.state) : record.result_json,
-                error: null,
-                message: output.message ?? "running",
-                updated_at,
-            });
-        }
-        const next = await this.getImageJob(ctx, record.job_id);
-        return next ?? record;
-    }
-    async runImageJob(job_id, ctx) {
+        const resolved = this.resolve({ model: ctx.input.model, mode: "image_result" }, ctx.env);
+        this.attachResolvedModel(ctx, resolved.model, "image/result");
         try {
-            await this.updateImageJob(ctx, job_id, {
-                status: "running",
-                message: "running",
-                error: null,
-                updated_at: new Date().toISOString(),
-            });
-            const resolved = this.resolve({ model: ctx.input.model, mode: "image" }, ctx.env);
-            this.attachResolvedModel(ctx, resolved.model, "image");
             const output = await resolved.action(ctx);
-            const result = await normalizeImageJobOutput(output);
-            await this.updateImageJob(ctx, job_id, {
-                status: "succeeded",
-                result_json: JSON.stringify(result),
-                error: null,
-                message: "succeeded",
-                updated_at: new Date().toISOString(),
-            });
+            if (!isImageProviderResult(output)) {
+                throw httpError(500, "image_result action returned invalid result");
+            }
+            return output;
         }
         catch (error) {
-            await this.updateImageJob(ctx, job_id, {
-                status: "failed",
-                error: error instanceof Error ? error.message : String(error),
-                message: "failed",
-                updated_at: new Date().toISOString(),
-            });
+            throw imageActionError(error, "image_result action failed");
         }
     }
-    imageJobTable(ctx) {
-        const table = ctx.db.image_jobs;
-        if (!table)
-            throw httpError(500, "AI image job table is not initialized");
-        return table;
-    }
-    async getImageJob(ctx, job_id) {
-        const rows = await this.imageJobTable(ctx).select({ job_id });
-        return rows[0] ? rowToImageJobRecord(rows[0]) : undefined;
-    }
-    async updateImageJob(ctx, job_id, values) {
-        await this.imageJobTable(ctx).update({ where: { job_id }, values: recordToRow(values) });
-    }
-    ensureImageJobAccess(ctx, record) {
-        if (ctx.identity?.kind !== "user")
-            return;
-        if (record.city_id && ctx.city?.city_id && record.city_id !== ctx.city.city_id) {
-            throw httpError(404, `Image job not found: ${record.job_id}`);
+    /**
+     * 持久化图片任务结果，并在持久化成功后触发计费。
+     *
+     * 关键点（中文）
+     * - 这个方法供后台 worker / queue / cron 调用，不是前端轮询 API。
+     * - Provider 负责把结果写入自己的存储；AIService 只在 succeeded 后执行 model.bill。
+     */
+    async persistImageJob(ctx) {
+        const resolved = this.resolve({ model: ctx.input.model, mode: "image_persist" }, ctx.env);
+        this.attachResolvedModel(ctx, resolved.model, "image/persist");
+        const started_at = Date.now();
+        try {
+            const output = await resolved.action(ctx);
+            if (!isImageProviderPersistResult(output)) {
+                throw httpError(500, "image_persist action returned invalid result");
+            }
+            if (output.status === "succeeded") {
+                this.attachOutputMetering(ctx, output.result, "image", started_at);
+                const charge = resolved.model?.bill?.(ctx, output);
+                await this.handleCharge(ctx, charge, isPromiseLike(charge));
+            }
+            return output;
         }
-        if (record.user_id && ctx.user?.user_id && record.user_id !== ctx.user.user_id) {
-            throw httpError(404, `Image job not found: ${record.job_id}`);
+        catch (error) {
+            throw imageActionError(error, "image_persist action failed");
         }
     }
-    toImageJobResult(record) {
-        const result = record.status === "succeeded" && record.result_json
-            ? parseImageJobResult(record.result_json)
-            : undefined;
-        return {
-            job_id: record.job_id,
-            status: record.status,
-            result,
-            error: record.error ?? undefined,
-            message: record.message ?? undefined,
-            poll_after_ms: IMAGE_JOB_POLL_AFTER_MS,
-        };
-    }
     // ========== OpenAI 兼容通路 ==========
     async handleChatCompletions(ctx) {
         const body = ctx.input;
@@ -697,11 +531,12 @@ export class AIService extends Service {
             .then(async (line) => {
             if (!line || line.amount_microcredits <= 0)
                 return;
-            if (!ctx.user?.user_id)
+            const user_id = line.user_id ?? ctx.user?.user_id;
+            if (!user_id)
                 return;
             await this.balance?.charge({
-                user_id: ctx.user.user_id,
                 ...line,
+                user_id,
             });
         });
         if (!defer) {