@downcity/agent 1.1.86 → 1.1.91

package/src/session/Session.ts

@@ -130,6 +130,7 @@ export class Session implements AgentSession {
     });
     this.turnService = new SessionTurnService({
       session_id: this.id,
+      project_root: this.projectRoot,
       executor: this.executor,
       state_service: this.stateService,
       event_hub: this.eventHub,

package/src/session/services/SessionTurnService.ts

@@ -32,6 +32,11 @@ type SessionTurnServiceOptions = {
    */
   session_id: string;
 
+  /**
+   * 当前项目根目录。
+   */
+  project_root: string;
+
   /**
    * 当前 session 执行器。
    */
@@ -53,6 +58,7 @@ type SessionTurnServiceOptions = {
  */
 export class SessionTurnService {
   private readonly session_id: string;
+  private readonly project_root: string;
   private readonly executor: Executor;
   private readonly state_service: SessionStateService;
   private readonly event_hub: SessionEventHub;
@@ -60,6 +66,7 @@ export class SessionTurnService {
 
   constructor(options: SessionTurnServiceOptions) {
     this.session_id = options.session_id;
+    this.project_root = options.project_root;
     this.executor = options.executor;
     this.state_service = options.state_service;
     this.event_hub = options.event_hub;
@@ -134,6 +141,7 @@ export class SessionTurnService {
     const tool_name_by_call_id = new Map<string, string>();
     const run_context: SessionRunContext = {
       sessionId: this.session_id,
+      projectRoot: this.project_root,
       onStepCallback: input.onStepMerge,
       onAssistantStepCallback: async (step) => {
         this.publish_event({

package/src/types/executor/SessionRunContext.ts

@@ -23,6 +23,15 @@ export interface SessionRunContext {
    */
   sessionId: string;
 
+  /**
+   * 当前执行所属的项目根目录。
+   *
+   * 关键点（中文）
+   * - 用于 tool/plugin 运行期把二进制资源写入项目级 `.downcity/resources`。
+   * - 未提供时，底层资源写入逻辑会回退到当前进程工作目录，兼容旧入口。
+   */
+  projectRoot?: string;
+
   /**
    * step 边界合并回调。
    *

package/src/types/plugin/ImagePlugin.ts

@@ -88,6 +88,73 @@ export interface ImagePluginInput {
  */
 export type ImagePluginResult = UIMessage;
 
+/**
+ * ImagePlugin 图片任务状态。
+ */
+export type ImagePluginJobStatus = "queued" | "running" | "succeeded" | "failed";
+
+/**
+ * ImagePlugin 图片任务创建结果。
+ */
+export interface ImagePluginJobCreateResult {
+  /** 图片任务唯一 ID。 */
+  job_id: string;
+  /** 当前任务状态。 */
+  status: ImagePluginJobStatus;
+  /** 查询任务状态的路径或 URL。 */
+  status_path?: string;
+  /** 读取任务结果的路径或 URL。 */
+  result_path?: string;
+  /** 人类可读状态说明。 */
+  message?: string;
+  /** 建议下次轮询前等待的毫秒数。 */
+  poll_after_ms?: number;
+  /** 任务创建时间。 */
+  created_at?: string;
+  /** 任务更新时间。 */
+  updated_at?: string;
+}
+
+/**
+ * ImagePlugin 图片任务状态查询结果。
+ */
+export interface ImagePluginJobStatusResult {
+  /** 图片任务唯一 ID。 */
+  job_id: string;
+  /** 当前任务状态。 */
+  status: ImagePluginJobStatus;
+  /** 人类可读状态说明。 */
+  message?: string;
+  /** 失败时的错误信息。 */
+  error?: string;
+  /** 建议下次轮询前等待的毫秒数。 */
+  poll_after_ms?: number;
+  /** 任务创建时间。 */
+  created_at?: string;
+  /** 任务更新时间。 */
+  updated_at?: string;
+}
+
+/**
+ * ImagePlugin 图片任务结果查询结果。
+ */
+export interface ImagePluginJobResult {
+  /** 图片任务唯一 ID。 */
+  job_id: string;
+  /** 当前任务状态。 */
+  status: ImagePluginJobStatus;
+  /** 成功时的图片结果。 */
+  result?: ImagePluginResult;
+  /** 失败时的错误信息。 */
+  error?: string;
+  /** 人类可读状态说明。 */
+  message?: string;
+  /** 任务创建时间。 */
+  created_at?: string;
+  /** 任务更新时间。 */
+  updated_at?: string;
+}
+
 /**
  * ImagePlugin 构造参数。
  */
@@ -98,6 +165,16 @@ export interface ImagePluginOptions {
   title?: string;
   /** Plugin 用途说明。 */
   description?: string;
-  /** 图片生成函数，通常传入 `(input) => city.ai.image(input)`。 */
-  image: (input: ImagePluginInput) => Promise<ImagePluginResult> | ImagePluginResult;
+  /** 可选：图片生成函数；未传 `create/status/result` 时用于本地后台任务兼容。 */
+  image?: (input: ImagePluginInput) => Promise<ImagePluginResult> | ImagePluginResult;
+  /** 可选：创建图片生成任务，通常传入 `(input) => city.ai.imageJobCreate(input)`。 */
+  create?: (input: ImagePluginInput) => Promise<ImagePluginJobCreateResult> | ImagePluginJobCreateResult;
+  /** 可选：查询图片生成任务状态，通常传入 `(input) => city.ai.imageJobStatus(input)`。 */
+  status?: (input: { job_id: string }) => Promise<ImagePluginJobStatusResult> | ImagePluginJobStatusResult;
+  /** 可选：读取图片生成任务结果，通常传入 `(input) => city.ai.imageJobResult(input)`。 */
+  result?: (input: { job_id: string }) => Promise<ImagePluginJobResult> | ImagePluginJobResult;
+  /** 兼容 `generate` 动作等待任务完成的最长毫秒数。 */
+  wait_timeout_ms?: number;
+  /** 兼容 `generate` 动作每次轮询间隔毫秒数。 */
+  poll_interval_ms?: number;
 }