@ai-setting/roy-agent-core 1.5.15-test → 1.5.16-test

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

@@ -0,0 +1,241 @@
+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;
+}
+/**
+* TaskTag entity
+* 
+* Tag 池中的单个 Tag
+*/
+interface TaskTag {
+	id: number;
+	name: string;
+	createdAt: string;
+	taskCount: number;
+}
+interface CreateTaskOptions {
+	title: string;
+	description?: string;
+	priority?: TaskPriority;
+	parent_task_id?: number;
+	goals_and_expected_deliverables?: string;
+	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;
+	description?: string;
+	status?: TaskStatus;
+	priority?: TaskPriority;
+	progress?: number;
+	current_status?: string;
+	goals_and_expected_deliverables?: string;
+	due_date?: string;
+	tags?: string[];
+	/** 项目路径，标识任务所属的项目 */
+	project_path?: string;
+	/** 任务上下文信息，用于存储额外上下文 */
+	context?: string;
+}
+interface ListTasksOptions {
+	status?: TaskStatus;
+	priority?: TaskPriority;
+	parent_task_id?: number;
+	limit?: number;
+	offset?: number;
+}
+interface CreateOperationOptions {
+	taskId: number;
+	sessionId: string;
+	actionType: ActionType;
+	actionTitle: string;
+	actionDescription?: string;
+	mdPath?: string;
+}
+interface ListOperationsOptions {
+	taskId: number;
+	actionType?: ActionType;
+	limit?: number;
+	offset?: number;
+}
+interface ListTagsOptions {
+	limit?: number;
+	offset?: number;
+	orderBy?: "count" | "name" | "created_at";
+}
+interface SearchTagsOptions {
+	query: string;
+	limit?: number;
+}
+/**
+* Get default data directory for task storage
+*/
+declare function getDefaultDataDir(): string;
+/**
+* Get default database path for task storage
+*/
+declare function getDefaultTaskDbPath(): string;
+interface TaskStore {
+	createTask(options: CreateTaskOptions): Promise<Task>;
+	getTask(id: number): Promise<Task | undefined>;
+	updateTask(id: number, options: UpdateTaskOptions): Promise<Task | undefined>;
+	deleteTask(id: number): Promise<boolean>;
+	listTasks(options?: ListTasksOptions): Promise<Task[]>;
+	createOperation(options: CreateOperationOptions): Promise<TaskOperation>;
+	getOperation(id: number): Promise<TaskOperation | undefined>;
+	updateOperation(id: number, updates: {
+		actionTitle?: string;
+		actionDescription?: string;
+	}): Promise<TaskOperation | undefined>;
+	deleteOperation(id: number): Promise<boolean>;
+	listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+	createTag(name: string): Promise<TaskTag>;
+	getTag(id: number): Promise<TaskTag | undefined>;
+	getTagByName(name: string): Promise<TaskTag | undefined>;
+	listTags(options?: ListTagsOptions): Promise<TaskTag[]>;
+	searchTags(options: SearchTagsOptions): Promise<TaskTag[]>;
+	deleteTag(id: number): Promise<boolean>;
+	addTagsToTask(taskId: number, tagIds: number[]): Promise<void>;
+	removeTagsFromTask(taskId: number, tagIds: number[]): Promise<void>;
+	getTagsForTask(taskId: number): Promise<TaskTag[]>;
+	getTaskIdsByTags(tagNames: string[]): Promise<number[]>;
+	updateTaskTags(taskId: number, tagNames: string[]): Promise<void>;
+	/** Search tasks by keywords (tags, description, goals, operations) */
+	searchTasksByKeywords(keywords: string[], options?: {
+		limit?: number;
+		excludeTaskId?: number;
+	}): Promise<Task[]>;
+	/** Find similar tasks using new keywords search */
+	findSimilarTasksByKeywords(keywords: string[], options?: {
+		limit?: number;
+		excludeTaskId?: number;
+	}): Promise<Task[]>;
+	findSimilarTasks(taskId: number, limit?: number): Promise<Task[]>;
+	searchTasks(query: string, limit?: number): Promise<Task[]>;
+	close(): void;
+}
+/**
+* SQLite-based Task Store
+* 
+* 参考 Session SQLiteStore 实现模式：
+* - 使用 bun:sqlite 内置模块
+* - 内存缓存提高性能
+* - 默认路径：~/.local/share/roy-agent/tasks.db
+*/
+declare class SQLiteTaskStore implements TaskStore {
+	private db;
+	private dbPath;
+	private initialized;
+	private tasksCache;
+	private operationsCache;
+	constructor(dbPath?: string);
+	private initialize;
+	createTask(options: CreateTaskOptions): Promise<Task>;
+	getTask(id: number): Promise<Task | undefined>;
+	updateTask(id: number, options: UpdateTaskOptions): Promise<Task | undefined>;
+	deleteTask(id: number): Promise<boolean>;
+	listTasks(options?: ListTasksOptions): Promise<Task[]>;
+	createOperation(options: CreateOperationOptions): Promise<TaskOperation>;
+	getOperation(id: number): Promise<TaskOperation | undefined>;
+	updateOperation(id: number, updates: {
+		actionTitle?: string;
+		actionDescription?: string;
+	}): Promise<TaskOperation | undefined>;
+	deleteOperation(id: number): Promise<boolean>;
+	listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+	private rowToTask;
+	private rowToOperation;
+	createTag(name: string): Promise<TaskTag>;
+	getTag(id: number): Promise<TaskTag | undefined>;
+	getTagByName(name: string): Promise<TaskTag | undefined>;
+	listTags(options?: ListTagsOptions): Promise<TaskTag[]>;
+	searchTags(options: SearchTagsOptions): Promise<TaskTag[]>;
+	deleteTag(id: number): Promise<boolean>;
+	addTagsToTask(taskId: number, tagIds: number[]): Promise<void>;
+	removeTagsFromTask(taskId: number, tagIds: number[]): Promise<void>;
+	getTagsForTask(taskId: number): Promise<TaskTag[]>;
+	getTaskIdsByTags(tagNames: string[]): Promise<number[]>;
+	updateTaskTags(taskId: number, tagNames: string[]): Promise<void>;
+	/**
+	* Search tasks by keywords list
+	* Searches in: tags (JSON), description, goals_and_expected_deliverables, operations
+	*/
+	searchTasksByKeywords(keywords: string[], options?: {
+		limit?: number;
+		excludeTaskId?: number;
+	}): Promise<Task[]>;
+	/**
+	* Find similar tasks by keywords
+	* Excludes the target task and sorts by relevance
+	* Default limit is 5 to keep prompt concise
+	*/
+	findSimilarTasksByKeywords(keywords: string[], options?: {
+		limit?: number;
+		excludeTaskId?: number;
+	}): Promise<Task[]>;
+	findSimilarTasks(taskId: number, limit?: number): Promise<Task[]>;
+	searchTasks(query: string, limit?: number): Promise<Task[]>;
+	private rowToTag;
+	private syncTaskTagsJson;
+	close(): Promise<void>;
+}
+export { getDefaultTaskDbPath, getDefaultDataDir, TaskStore, SQLiteTaskStore };

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

@@ -0,0 +1,14 @@
+import {
+  SQLiteTaskStore,
+  getDefaultDataDir,
+  getDefaultTaskDbPath
+} from "../../../shared/@ai-setting/roy-agent-core-bvr1761x.js";
+import"../../../shared/@ai-setting/roy-agent-core-44hnfb02.js";
+import"../../../shared/@ai-setting/roy-agent-core-xs5rsgat.js";
+import"../../../shared/@ai-setting/roy-agent-core-psv4v63c.js";
+import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
+export {
+  getDefaultTaskDbPath,
+  getDefaultDataDir,
+  SQLiteTaskStore
+};