@downcity/city 0.2.93 → 0.2.100

package/bin/service/{ai → async-job}/schema.d.ts

@@ -1,19 +1,19 @@
 /**
- * AI Service 数据库 schema 模块。
+ * 通用异步任务数据库 schema 模块。
  *
- * 这里定义 AIService 自己持久化使用的表。当前主要用于图片生成任务，
- * 让 Worker 可以把长耗时生成从前台 HTTP 请求中拆出来。
+ * async_jobs 是 City 的统一异步任务表，用于图片生成、视频生成、
+ * 文件处理等需要跨请求恢复或轮询的任务。
  */
 /**
- * 默认 SQLite 图片任务表。
+ * 默认 SQLite 异步任务表。
  */
-export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
-    name: "ai_image_jobs";
+export declare const sqliteAsyncJobs: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "async_jobs";
     schema: undefined;
     columns: {
         job_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "job_id";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -30,9 +30,28 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }, {}, {
             length: number | undefined;
         }>;
+        job_type: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "job_type";
+            tableName: "async_jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
         status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "status";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -51,7 +70,7 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }>;
         input_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "input_json";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -68,9 +87,28 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }, {}, {
             length: number | undefined;
         }>;
+        state_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "state_json";
+            tableName: "async_jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
         result_json: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "result_json";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -89,7 +127,7 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }>;
         error: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "error";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -108,7 +146,7 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }>;
         message: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "message";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -127,7 +165,7 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }>;
         city_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "city_id";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -146,7 +184,26 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }>;
         user_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "user_id";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        service_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "service_id";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -165,7 +222,7 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }>;
         model_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "model_id";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -184,7 +241,7 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }>;
         created_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "created_at";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -203,7 +260,7 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
         }>;
         updated_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "updated_at";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "SQLiteText";
             data: string;
@@ -224,15 +281,15 @@ export declare const sqliteAIImageJobs: import("drizzle-orm/sqlite-core").SQLite
     dialect: "sqlite";
 }>;
 /**
- * 默认 Postgres 图片任务表。
+ * 默认 Postgres 异步任务表。
  */
-export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithColumns<{
-    name: "ai_image_jobs";
+export declare const pgAsyncJobs: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "async_jobs";
     schema: undefined;
     columns: {
         job_id: import("drizzle-orm/pg-core").PgColumn<{
             name: "job_id";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -247,9 +304,26 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        job_type: import("drizzle-orm/pg-core").PgColumn<{
+            name: "job_type";
+            tableName: "async_jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         status: import("drizzle-orm/pg-core").PgColumn<{
             name: "status";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -266,7 +340,7 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
         }, {}, {}>;
         input_json: import("drizzle-orm/pg-core").PgColumn<{
             name: "input_json";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -281,9 +355,26 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        state_json: import("drizzle-orm/pg-core").PgColumn<{
+            name: "state_json";
+            tableName: "async_jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         result_json: import("drizzle-orm/pg-core").PgColumn<{
             name: "result_json";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -300,7 +391,7 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
         }, {}, {}>;
         error: import("drizzle-orm/pg-core").PgColumn<{
             name: "error";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -317,7 +408,7 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
         }, {}, {}>;
         message: import("drizzle-orm/pg-core").PgColumn<{
             name: "message";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -334,7 +425,7 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
         }, {}, {}>;
         city_id: import("drizzle-orm/pg-core").PgColumn<{
             name: "city_id";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -351,7 +442,24 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
         }, {}, {}>;
         user_id: import("drizzle-orm/pg-core").PgColumn<{
             name: "user_id";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        service_id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "service_id";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -368,7 +476,7 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
         }, {}, {}>;
         model_id: import("drizzle-orm/pg-core").PgColumn<{
             name: "model_id";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -385,7 +493,7 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
         }, {}, {}>;
         created_at: import("drizzle-orm/pg-core").PgColumn<{
             name: "created_at";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -402,7 +510,7 @@ export declare const pgAIImageJobs: import("drizzle-orm/pg-core").PgTableWithCol
         }, {}, {}>;
         updated_at: import("drizzle-orm/pg-core").PgColumn<{
             name: "updated_at";
-            tableName: "ai_image_jobs";
+            tableName: "async_jobs";
             dataType: "string";
             columnType: "PgText";
             data: string;

package/bin/service/async-job/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/service/async-job/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6B1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BtB,CAAC"}

package/bin/service/{ai → async-job}/schema.js

@@ -1,23 +1,27 @@
 /**
- * AI Service 数据库 schema 模块。
+ * 通用异步任务数据库 schema 模块。
  *
- * 这里定义 AIService 自己持久化使用的表。当前主要用于图片生成任务，
- * 让 Worker 可以把长耗时生成从前台 HTTP 请求中拆出来。
+ * async_jobs 是 City 的统一异步任务表，用于图片生成、视频生成、
+ * 文件处理等需要跨请求恢复或轮询的任务。
  */
 import { pgTable, text as pgText } from "drizzle-orm/pg-core";
 import { sqliteTable, text as sqliteText } from "drizzle-orm/sqlite-core";
-const DEFAULT_IMAGE_JOBS_TABLE = "ai_image_jobs";
+const DEFAULT_ASYNC_JOBS_TABLE = "async_jobs";
 /**
- * 默认 SQLite 图片任务表。
+ * 默认 SQLite 异步任务表。
  */
-export const sqliteAIImageJobs = sqliteTable(DEFAULT_IMAGE_JOBS_TABLE, {
-    /** Federation 内部生成的图片任务 ID。 */
+export const sqliteAsyncJobs = sqliteTable(DEFAULT_ASYNC_JOBS_TABLE, {
+    /** City 内部生成的异步任务 ID。 */
     job_id: sqliteText("job_id").primaryKey(),
+    /** 任务类型，例如 `ai.image.generate`。 */
+    job_type: sqliteText("job_type").notNull(),
     /** 任务状态：queued / running / succeeded / failed。 */
     status: sqliteText("status").notNull(),
-    /** 原始图片生成输入，JSON 字符串。 */
+    /** 原始任务输入，JSON 字符串。 */
     input_json: sqliteText("input_json").notNull(),
-    /** 成功后的 UIMessage 结果，JSON 字符串。 */
+    /** 可恢复任务中间状态，JSON 字符串。 */
+    state_json: sqliteText("state_json"),
+    /** 成功后的业务结果，JSON 字符串。 */
     result_json: sqliteText("result_json"),
     /** 失败时给客户端展示的错误消息。 */
     error: sqliteText("error"),
@@ -27,6 +31,8 @@ export const sqliteAIImageJobs = sqliteTable(DEFAULT_IMAGE_JOBS_TABLE, {
     city_id: sqliteText("city_id"),
     /** 当前终端用户 ID。 */
     user_id: sqliteText("user_id"),
+    /** 创建该任务的 Service ID。 */
+    service_id: sqliteText("service_id"),
     /** 本次任务解析到的模型 ID。 */
     model_id: sqliteText("model_id"),
     /** 创建时间。 */
@@ -35,16 +41,20 @@ export const sqliteAIImageJobs = sqliteTable(DEFAULT_IMAGE_JOBS_TABLE, {
     updated_at: sqliteText("updated_at").notNull(),
 });
 /**
- * 默认 Postgres 图片任务表。
+ * 默认 Postgres 异步任务表。
  */
-export const pgAIImageJobs = pgTable(DEFAULT_IMAGE_JOBS_TABLE, {
-    /** Federation 内部生成的图片任务 ID。 */
+export const pgAsyncJobs = pgTable(DEFAULT_ASYNC_JOBS_TABLE, {
+    /** City 内部生成的异步任务 ID。 */
     job_id: pgText("job_id").primaryKey(),
+    /** 任务类型，例如 `ai.image.generate`。 */
+    job_type: pgText("job_type").notNull(),
     /** 任务状态：queued / running / succeeded / failed。 */
     status: pgText("status").notNull(),
-    /** 原始图片生成输入，JSON 字符串。 */
+    /** 原始任务输入，JSON 字符串。 */
     input_json: pgText("input_json").notNull(),
-    /** 成功后的 UIMessage 结果，JSON 字符串。 */
+    /** 可恢复任务中间状态，JSON 字符串。 */
+    state_json: pgText("state_json"),
+    /** 成功后的业务结果，JSON 字符串。 */
     result_json: pgText("result_json"),
     /** 失败时给客户端展示的错误消息。 */
     error: pgText("error"),
@@ -54,6 +64,8 @@ export const pgAIImageJobs = pgTable(DEFAULT_IMAGE_JOBS_TABLE, {
     city_id: pgText("city_id"),
     /** 当前终端用户 ID。 */
     user_id: pgText("user_id"),
+    /** 创建该任务的 Service ID。 */
+    service_id: pgText("service_id"),
     /** 本次任务解析到的模型 ID。 */
     model_id: pgText("model_id"),
     /** 创建时间。 */

package/bin/service/async-job/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/service/async-job/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1E,MAAM,wBAAwB,GAAG,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC,wBAAwB,EAAE;IACnE,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE;IACzC,mCAAmC;IACnC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IAC1C,kDAAkD;IAClD,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IACtC,uBAAuB;IACvB,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC9C,0BAA0B;IAC1B,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC;IACpC,yBAAyB;IACzB,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC;IACtC,sBAAsB;IACtB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;IAC1B,2BAA2B;IAC3B,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;IAC9B,iCAAiC;IACjC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;IAC9B,iBAAiB;IACjB,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;IAC9B,yBAAyB;IACzB,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC;IACpC,qBAAqB;IACrB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC;IAChC,YAAY;IACZ,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC9C,YAAY;IACZ,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CAC/C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,wBAAwB,EAAE;IAC3D,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE;IACrC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;IACtC,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAClC,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC1C,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC;IAChC,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;IAClC,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IACtB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;IAC1B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;IAC1B,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;IAC1B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC;IAChC,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC;IAC5B,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC1C,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CAC3C,CAAC,CAAC"}

package/bin/types/AsyncJob.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 通用异步任务类型模块。
+ *
+ * City 内部所有需要跨请求恢复、轮询或后台执行的任务都使用这组结构。
+ * 具体业务能力通过 job_type 区分，例如图片生成使用 `ai.image.generate`。
+ */
+/** 通用异步任务状态。 */
+export type AsyncJobStatus = "queued" | "running" | "succeeded" | "failed";
+/**
+ * 通用异步任务表行。
+ */
+export interface AsyncJobRecord {
+    /** City 内部生成的异步任务 ID。 */
+    job_id: string;
+    /** 任务类型，例如 `ai.image.generate`。 */
+    job_type: string;
+    /** 当前任务状态。 */
+    status: AsyncJobStatus;
+    /** 创建任务时的原始输入，JSON 字符串。 */
+    input_json: string;
+    /** 任务推进时需要保留的中间状态，JSON 字符串。 */
+    state_json?: string | null;
+    /** 成功后的业务结果，JSON 字符串。 */
+    result_json?: string | null;
+    /** 失败时给客户端展示的错误消息。 */
+    error?: string | null;
+    /** 当前任务状态说明，便于客户端展示或排障。 */
+    message?: string | null;
+    /** 当前 user_token 绑定的 City ID。 */
+    city_id?: string | null;
+    /** 当前终端用户 ID。 */
+    user_id?: string | null;
+    /** 创建该任务的 Service ID。 */
+    service_id?: string | null;
+    /** 本次任务解析到的模型 ID。 */
+    model_id?: string | null;
+    /** 创建时间。 */
+    created_at: string;
+    /** 更新时间。 */
+    updated_at: string;
+}
+//# sourceMappingURL=AsyncJob.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncJob.d.ts","sourceRoot":"","sources":["../../src/types/AsyncJob.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/bin/types/AsyncJob.js

@@ -0,0 +1,8 @@
+/**
+ * 通用异步任务类型模块。
+ *
+ * City 内部所有需要跨请求恢复、轮询或后台执行的任务都使用这组结构。
+ * 具体业务能力通过 job_type 区分，例如图片生成使用 `ai.image.generate`。
+ */
+export {};
+//# sourceMappingURL=AsyncJob.js.map

package/bin/types/AsyncJob.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/city",
-  "version": "0.2.93",
+  "version": "0.2.100",
   "description": "Downcity City runtime and City access SDK for services, actions, auth, env, and cities.",
   "type": "module",
   "main": "./bin/index.js",

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

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/service/ai/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBxB,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/service/ai/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1E,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC,wBAAwB,EAAE;IACrE,+BAA+B;IAC/B,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE;IACzC,kDAAkD;IAClD,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IACtC,yBAAyB;IACzB,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC9C,kCAAkC;IAClC,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC;IACtC,sBAAsB;IACtB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;IAC1B,2BAA2B;IAC3B,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;IAC9B,iCAAiC;IACjC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;IAC9B,iBAAiB;IACjB,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;IAC9B,qBAAqB;IACrB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC;IAChC,YAAY;IACZ,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC9C,YAAY;IACZ,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CAC/C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,wBAAwB,EAAE;IAC7D,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE;IACrC,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAClC,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC1C,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;IAClC,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IACtB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;IAC1B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;IAC1B,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;IAC1B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC;IAC5B,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC1C,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CAC3C,CAAC,CAAC"}