@ai-setting/roy-agent-core 1.5.6 → 1.5.8

package/dist/env/index.d.ts

@@ -2116,6 +2116,10 @@ interface Task {
 	updatedAt: string;
 	due_date?: string;
 	tags?: string[];
+	/** Project root path for task positioning */
+	project_path: string;
+	/** JSON string with time-space positioning info (worktree, branch, etc.) */
+	context: string;
 }
 /**
 * TaskOperation entity
@@ -2154,6 +2158,15 @@ interface CreateTaskOptions {
 	due_date?: string;
 	tags?: string[];
 	sessionId: string;
+	/** Project root path for task positioning. Use 'unknown' if unknown. */
+	project_path: string;
+	/**
+	* JSON string with time-space positioning info.
+	* - For coding tasks: include worktree_path, branch, type
+	* - For other tasks: use '{}' or '{"type":"unknown"}'
+	* Must be a valid JSON string.
+	*/
+	context: string;
 }
 interface UpdateTaskOptions {
 	title?: string;
@@ -2165,6 +2178,10 @@ interface UpdateTaskOptions {
 	goals_and_expected_deliverables?: string;
 	due_date?: string;
 	tags?: string[];
+	/** 项目路径，标识任务所属的项目 */
+	project_path?: string;
+	/** 任务上下文信息，用于存储额外上下文 */
+	context?: string;
 }
 interface ListTasksOptions {
 	status?: TaskStatus;
@@ -2299,6 +2316,10 @@ declare class TaskComponent extends BaseComponent {
 	private configComponent?;
 	private tagService;
 	private plugins;
+	/**
+	* 发布 EnvEvent
+	*/
+	private publishEvent;
 	constructor();
 	/**
 	* Initialize the component

package/dist/env/index.js

@@ -13,16 +13,16 @@ import {
 } from "../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-dc497hmk.js";
+} from "../shared/@ai-setting/roy-agent-core-rhmtwnw1.js";
 import"../shared/@ai-setting/roy-agent-core-0rtxwr28.js";
-import"../shared/@ai-setting/roy-agent-core-4t40mkpv.js";
-import"../shared/@ai-setting/roy-agent-core-0vbdz0x7.js";
-import"../shared/@ai-setting/roy-agent-core-7fgf85wc.js";
-import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import"../shared/@ai-setting/roy-agent-core-wrcy0h6z.js";
 import"../shared/@ai-setting/roy-agent-core-69jskqjg.js";
+import"../shared/@ai-setting/roy-agent-core-4t40mkpv.js";
 import"../shared/@ai-setting/roy-agent-core-jvatggbb.js";
 import"../shared/@ai-setting/roy-agent-core-5x94xmt6.js";
+import"../shared/@ai-setting/roy-agent-core-0vbdz0x7.js";
+import"../shared/@ai-setting/roy-agent-core-7fgf85wc.js";
+import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
@@ -30,12 +30,13 @@ import {
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-n2cvdgd6.js";
-import"../shared/@ai-setting/roy-agent-core-htwpckw9.js";
-import"../shared/@ai-setting/roy-agent-core-dbsk841j.js";
+} from "../shared/@ai-setting/roy-agent-core-gwc4h96n.js";
+import"../shared/@ai-setting/roy-agent-core-vf215qfv.js";
+import"../shared/@ai-setting/roy-agent-core-bvr1761x.js";
+import"../shared/@ai-setting/roy-agent-core-wa1kzqky.js";
 import"../shared/@ai-setting/roy-agent-core-t94ktchq.js";
-import"../shared/@ai-setting/roy-agent-core-z62zee1e.js";
 import"../shared/@ai-setting/roy-agent-core-92z6t4he.js";
+import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
 import {
   McpComponent
 } from "../shared/@ai-setting/roy-agent-core-pjr12nnd.js";

package/dist/env/llm/index.js

@@ -12,7 +12,7 @@ import {
   invoke,
   invokeNonStream,
   parseModelString
-} from "../../shared/@ai-setting/roy-agent-core-3xwneva0.js";
+} from "../../shared/@ai-setting/roy-agent-core-vkz81f7v.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
 import"../../shared/@ai-setting/roy-agent-core-kkbwepqb.js";

package/dist/env/task/delegate/index.d.ts

@@ -1163,6 +1163,10 @@ interface Task {
 	updatedAt: string;
 	due_date?: string;
 	tags?: string[];
+	/** Project root path for task positioning */
+	project_path: string;
+	/** JSON string with time-space positioning info (worktree, branch, etc.) */
+	context: string;
 }
 /**
 * TaskOperation entity
@@ -1199,6 +1203,15 @@ interface CreateTaskOptions {
 	due_date?: string;
 	tags?: string[];
 	sessionId: string;
+	/** Project root path for task positioning. Use 'unknown' if unknown. */
+	project_path: string;
+	/**
+	* JSON string with time-space positioning info.
+	* - For coding tasks: include worktree_path, branch, type
+	* - For other tasks: use '{}' or '{"type":"unknown"}'
+	* Must be a valid JSON string.
+	*/
+	context: string;
 }
 interface UpdateTaskOptions {
 	title?: string;
@@ -1210,6 +1223,10 @@ interface UpdateTaskOptions {
 	goals_and_expected_deliverables?: string;
 	due_date?: string;
 	tags?: string[];
+	/** 项目路径，标识任务所属的项目 */
+	project_path?: string;
+	/** 任务上下文信息，用于存储额外上下文 */
+	context?: string;
 }
 interface ListTasksOptions {
 	status?: TaskStatus;
@@ -1327,6 +1344,10 @@ declare class TaskComponent extends BaseComponent {
 	private configComponent?;
 	private tagService;
 	private plugins;
+	/**
+	* 发布 EnvEvent
+	*/
+	private publishEvent;
 	constructor();
 	/**
 	* Initialize the component
@@ -1456,6 +1477,43 @@ declare class TaskComponent extends BaseComponent {
 	*/
 	listPlugins(): TaskPlugin[];
 }
+/**
+* Background Task Event Types
+* 这些事件由 BackgroundTaskManager 发布，标识为 task.background.*
+*/
+declare const BackgroundTaskEventTypes: {
+	readonly STARTED: "task.background.started";
+	readonly PROGRESS: "task.background.progress";
+	readonly COMPLETED: "task.background.completed";
+	readonly FAILED: "task.background.failed";
+	readonly TIMEOUT: "task.background.timeout";
+	readonly STOPPED: "task.background.stopped";
+};
+interface BackgroundTaskStartedPayload {
+	backgroundTaskId: string;
+	subSessionId: string;
+	parentSessionId: string;
+	description: string;
+	subagentType: string;
+	associatedTaskId?: number;
+}
+interface BackgroundTaskProgressPayload {
+	backgroundTaskId: string;
+	subSessionId: string;
+	parentSessionId: string;
+	status: string;
+	progress?: number;
+}
+interface BackgroundTaskCompletedPayload {
+	backgroundTaskId: string;
+	subSessionId: string;
+	parentSessionId: string;
+	status: "completed" | "failed" | "timeout" | "stopped";
+	result?: string;
+	error?: string;
+	executionTimeMs: number;
+	associatedTaskId?: number;
+}
 interface SubAgentSpec {
 	id: string;
 	name: string;
@@ -1503,24 +1561,27 @@ interface CreateBackgroundTaskOptions {
 * Background Task Manager (简化版)
 * 
 * 管理后台任务的创建、执行、状态跟踪
-* 支持 EnvEvent 发布
+* 发布 task.background.* 事件供外部订阅
 */
 declare class BackgroundTaskManager {
 	private env;
 	private tasks;
-	private progressTimers;
 	private abortControllers;
+	private progressTimers;
 	constructor(env: any);
 	/**
 	* Get SessionComponent from env
 	*/
 	private getSessionComponent;
+	/**
+	* Publish a task.background.* event
+	*/
+	private publishBackgroundEvent;
 	createTask(options: CreateBackgroundTaskOptions): Promise<{
 		taskId: string;
 		subSessionId: string;
 	}>;
 	private executeTask;
-	private executeWithAbort;
 	/**
 	* Start progress reporter for a task
 	*/
@@ -1529,10 +1590,7 @@ declare class BackgroundTaskManager {
 	* Stop progress reporter for a task
 	*/
 	private stopProgressReporter;
-	/**
-	* Publish an event to the environment
-	*/
-	private publishEvent;
+	private executeWithAbort;
 	stopTask(taskId: string): {
 		success: boolean;
 		task?: BackgroundTask;
@@ -1551,72 +1609,4 @@ declare class BackgroundTaskManager {
 */
 declare function createDelegateTool(taskComponent: TaskComponent): Tool;
 declare function createStopTool(taskManager: BackgroundTaskManager): Tool;
-/**
-* 任务事件类型枚举
-*/
-declare const TaskEventTypes: {
-	/** 任务开始执行 */
-	readonly TASK_STARTED: "task.started";
-	/** 任务进度更新 */
-	readonly TASK_PROGRESS: "task.progress";
-	/** 任务完成 */
-	readonly TASK_COMPLETED: "task.completed";
-	/** 任务失败 */
-	readonly TASK_FAILED: "task.failed";
-	/** 任务超时 */
-	readonly TASK_TIMEOUT: "task.timeout";
-	/** 任务被停止 */
-	readonly TASK_STOPPED: "task.stopped";
-};
-type TaskEventType = (typeof TaskEventTypes)[keyof typeof TaskEventTypes];
-/**
-* 任务开始事件负载
-*/
-interface TaskStartedPayload {
-	taskId: string;
-	subSessionId: string;
-	parentSessionId: string;
-	description: string;
-	subagentType: string;
-	associatedTaskId?: number;
-}
-/**
-* 任务进度事件负载
-*/
-interface TaskProgressPayload {
-	taskId: string;
-	subSessionId: string;
-	parentSessionId: string;
-	status: string;
-	progress?: number;
-	progressMessage?: string;
-	description?: string;
-	subagentType?: string;
-}
-/**
-* 任务完成事件负载
-*/
-interface TaskCompletedPayload {
-	taskId: string;
-	subSessionId: string;
-	parentSessionId: string;
-	status: "completed" | "failed" | "timeout" | "stopped";
-	result?: string;
-	error?: string;
-	executionTimeMs: number;
-	associatedTaskId?: number;
-	description?: string;
-	subagentType?: string;
-}
-/**
-* 任务事件基类
-*/
-interface BaseTaskEventPayload {
-	taskId: string;
-	subSessionId: string;
-	parentSessionId: string;
-	description: string;
-	subagentType: string;
-	associatedTaskId?: number;
-}
-export { createStopTool, createDelegateTool, TaskStartedPayload, TaskProgressPayload, TaskEventTypes, TaskEventType, TaskCompletedPayload, SubAgentSpec, DelegateToolResult, DelegateToolParams, DelegateToolParameters, BaseTaskEventPayload, BackgroundTaskManager, BackgroundTask };
+export { createStopTool, createDelegateTool, SubAgentSpec, DelegateToolResult, DelegateToolParams, DelegateToolParameters, BackgroundTaskStartedPayload, BackgroundTaskProgressPayload, BackgroundTaskManager, BackgroundTaskEventTypes, BackgroundTaskCompletedPayload, BackgroundTask };

package/dist/env/task/delegate/index.js

@@ -1,9 +1,9 @@
 import {
+  BackgroundTaskEventTypes,
   BackgroundTaskManager,
-  TaskEventTypes,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-z62zee1e.js";
+} from "../../../shared/@ai-setting/roy-agent-core-vf215qfv.js";
 import"../../../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import"../../../shared/@ai-setting/roy-agent-core-gjq1yk68.js";
 import"../../../shared/@ai-setting/roy-agent-core-44hnfb02.js";
@@ -13,6 +13,6 @@ import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   createStopTool,
   createDelegateTool,
-  TaskEventTypes,
-  BackgroundTaskManager
+  BackgroundTaskManager,
+  BackgroundTaskEventTypes
 };

package/dist/env/task/events/index.d.ts

@@ -0,0 +1,171 @@
+/**
+* @fileoverview Task Entity Event Types
+* 
+* 定义 TaskComponent 相关的 EnvEvent 类型
+*/
+/**
+* Task Entity 事件类型枚举
+*/
+declare const TaskEntityEventTypes: {
+	/** Task 创建 */
+	readonly CREATED: "task.created";
+	/** Task 更新 */
+	readonly UPDATED: "task.updated";
+	/** Task 完成 */
+	readonly COMPLETED: "task.completed";
+	/** Task 删除 */
+	readonly DELETED: "task.deleted";
+	/** Operation 记录添加 */
+	readonly OPERATION_ADDED: "task.operation_added";
+	/** Task 被委托 */
+	readonly DELEGATED: "task.delegated";
+};
+type TaskEntityEventType = (typeof TaskEntityEventTypes)[keyof typeof TaskEntityEventTypes];
+import { z } from "zod";
+/**
+* Task status enum
+*/
+declare const TaskStatusEnum: unknown;
+type TaskStatus = z.infer<typeof TaskStatusEnum>;
+/**
+* Task priority enum
+*/
+declare const TaskPriorityEnum: unknown;
+type TaskPriority = z.infer<typeof TaskPriorityEnum>;
+/**
+* Action type for task operations
+*/
+declare const ActionTypeEnum: unknown;
+type ActionType = z.infer<typeof ActionTypeEnum>;
+/**
+* Task entity
+*/
+interface Task {
+	id: number;
+	title: string;
+	description: string;
+	status: TaskStatus;
+	priority: TaskPriority;
+	progress: number;
+	current_status: string;
+	goals_and_expected_deliverables: string;
+	parent_task_id?: number;
+	createdAt: string;
+	updatedAt: string;
+	due_date?: string;
+	tags?: string[];
+	/** Project root path for task positioning */
+	project_path: string;
+	/** JSON string with time-space positioning info (worktree, branch, etc.) */
+	context: string;
+}
+/**
+* TaskOperation entity
+* 
+* 记录任务的操作历史，每个操作关联到一个 sessionId
+*/
+interface TaskOperation {
+	id: number;
+	taskId: number;
+	sessionId: string;
+	actionType: ActionType;
+	actionTitle: string;
+	actionDescription: string;
+	timestamp: string;
+	mdPath?: string;
+}
+/**
+* task.created 事件负载
+*/
+interface TaskCreatedPayload {
+	task: Task;
+	sessionId: string;
+}
+/**
+* task.updated 事件负载
+*/
+interface TaskUpdatedPayload {
+	task: Task;
+	changes: Partial<Task>;
+	sessionId: string;
+}
+/**
+* task.completed 事件负载
+*/
+interface TaskCompletedPayload {
+	task: Task;
+	sessionId: string;
+}
+/**
+* task.deleted 事件负载
+*/
+interface TaskDeletedPayload {
+	taskId: number;
+	sessionId: string;
+}
+/**
+* task.operation_added 事件负载
+*/
+interface TaskOperationAddedPayload {
+	operation: TaskOperation;
+	taskId: number;
+}
+/**
+* task.delegated 事件负载
+*/
+interface TaskDelegatedPayload {
+	taskId: number;
+	backgroundTaskId: string;
+	subSessionId: string;
+	parentSessionId: string;
+	description: string;
+	subagentType: string;
+}
+/**
+* task.background.started 事件负载
+*/
+interface BackgroundTaskStartedPayload {
+	taskId: string;
+	subSessionId: string;
+	parentSessionId: string;
+	description: string;
+	subagentType: string;
+	associatedTaskId?: number;
+}
+/**
+* task.background.progress 事件负载
+*/
+interface BackgroundTaskProgressPayload {
+	taskId: string;
+	subSessionId: string;
+	parentSessionId: string;
+	status: string;
+	progress?: number;
+	progressMessage?: string;
+	description?: string;
+	subagentType?: string;
+}
+/**
+* task.background.completed/failed/timeout/stopped 事件负载
+*/
+interface BackgroundTaskCompletedPayload {
+	taskId: string;
+	subSessionId: string;
+	parentSessionId: string;
+	status: "completed" | "failed" | "timeout" | "stopped";
+	result?: string;
+	error?: string;
+	executionTimeMs: number;
+	associatedTaskId?: number;
+	description?: string;
+	subagentType?: string;
+}
+/**
+* 所有 Task Entity 事件负载的联合类型
+*/
+type TaskEntityEventPayload = TaskCreatedPayload | TaskUpdatedPayload | TaskCompletedPayload | TaskDeletedPayload | TaskOperationAddedPayload | TaskDelegatedPayload;
+/**
+* 所有 Background Task 事件负载的联合类型
+*/
+type BackgroundTaskEventPayload = BackgroundTaskStartedPayload | BackgroundTaskProgressPayload | BackgroundTaskCompletedPayload;
+export { TaskUpdatedPayload, TaskOperationAddedPayload, TaskEntityEventTypes, TaskEntityEventType, TaskEntityEventPayload, TaskDeletedPayload, TaskDelegatedPayload, TaskCreatedPayload, TaskCompletedPayload, BackgroundTaskStartedPayload, BackgroundTaskProgressPayload, BackgroundTaskEventPayload, BackgroundTaskCompletedPayload };

package/dist/env/task/events/index.js

@@ -0,0 +1,7 @@
+import {
+  TaskEntityEventTypes
+} from "../../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
+import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
+export {
+  TaskEntityEventTypes
+};

package/dist/env/task/hooks/index.d.ts

@@ -198,6 +198,10 @@ interface Task {
 	updatedAt: string;
 	due_date?: string;
 	tags?: string[];
+	/** Project root path for task positioning */
+	project_path: string;
+	/** JSON string with time-space positioning info (worktree, branch, etc.) */
+	context: string;
 }
 /**
 * TaskOperation entity
@@ -234,6 +238,15 @@ interface CreateTaskOptions {
 	due_date?: string;
 	tags?: string[];
 	sessionId: string;
+	/** Project root path for task positioning. Use 'unknown' if unknown. */
+	project_path: string;
+	/**
+	* JSON string with time-space positioning info.
+	* - For coding tasks: include worktree_path, branch, type
+	* - For other tasks: use '{}' or '{"type":"unknown"}'
+	* Must be a valid JSON string.
+	*/
+	context: string;
 }
 interface UpdateTaskOptions {
 	title?: string;
@@ -245,6 +258,10 @@ interface UpdateTaskOptions {
 	goals_and_expected_deliverables?: string;
 	due_date?: string;
 	tags?: string[];
+	/** 项目路径，标识任务所属的项目 */
+	project_path?: string;
+	/** 任务上下文信息，用于存储额外上下文 */
+	context?: string;
 }
 interface CreateOperationOptions {
 	taskId: number;
@@ -403,24 +420,27 @@ interface CreateBackgroundTaskOptions {
 * Background Task Manager (简化版)
 * 
 * 管理后台任务的创建、执行、状态跟踪
-* 支持 EnvEvent 发布
+* 发布 task.background.* 事件供外部订阅
 */
 declare class BackgroundTaskManager {
 	private env;
 	private tasks;
-	private progressTimers;
 	private abortControllers;
+	private progressTimers;
 	constructor(env: any);
 	/**
 	* Get SessionComponent from env
 	*/
 	private getSessionComponent;
+	/**
+	* Publish a task.background.* event
+	*/
+	private publishBackgroundEvent;
 	createTask(options: CreateBackgroundTaskOptions): Promise<{
 		taskId: string;
 		subSessionId: string;
 	}>;
 	private executeTask;
-	private executeWithAbort;
 	/**
 	* Start progress reporter for a task
 	*/
@@ -429,10 +449,7 @@ declare class BackgroundTaskManager {
 	* Stop progress reporter for a task
 	*/
 	private stopProgressReporter;
-	/**
-	* Publish an event to the environment
-	*/
-	private publishEvent;
+	private executeWithAbort;
 	stopTask(taskId: string): {
 		success: boolean;
 		task?: BackgroundTask;