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

package/dist/env/task/index.js

@@ -1,34 +0,0 @@
-import {
-  ActionTypeEnum,
-  TaskComponent,
-  TaskConfigSchema,
-  TaskPriorityEnum,
-  TaskStatusEnum
-} from "../../shared/@ai-setting/roy-agent-core-gwc4h96n.js";
-import"../../shared/@ai-setting/roy-agent-core-vf215qfv.js";
-import {
-  SQLiteTaskStore
-} from "../../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-92z6t4he.js";
-import {
-  TaskEntityEventTypes
-} from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
-import"../../shared/@ai-setting/roy-agent-core-kkbwepqb.js";
-import"../../shared/@ai-setting/roy-agent-core-2dhd60aw.js";
-import"../../shared/@ai-setting/roy-agent-core-gjq1yk68.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 {
-  TaskStatusEnum,
-  TaskPriorityEnum,
-  TaskEntityEventTypes,
-  TaskConfigSchema,
-  TaskComponent,
-  SQLiteTaskStore,
-  ActionTypeEnum
-};

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

@@ -1,466 +0,0 @@
-import { z as z5 } from "zod";
-/**
-* Agent 类型
-*/
-type AgentType = "primary" | "sub" | "summary";
-/**
-* Agent 实例配置
-*/
-interface AgentInstanceConfig {
-	/** Agent 类型 */
-	type: AgentType;
-	/** Agent 名称 */
-	name?: string;
-	/** System Prompt */
-	systemPrompt?: string;
-	/** Behavior Spec ID */
-	behaviorSpecId?: string;
-	/** 使用的模型 */
-	model?: string;
-	/** 最大迭代次数 */
-	maxIterations?: number;
-	/** 最大错误重试次数 */
-	maxErrorRetries?: number;
-	/** 死循环检测阈值 */
-	doomLoopThreshold?: number;
-	/** 允许的工具列表 */
-	allowedTools?: string[];
-	/** 拒绝的工具列表 */
-	deniedTools?: string[];
-	/** 工具超时（毫秒） */
-	toolTimeout?: number;
-	/** 工具重试次数 */
-	toolRetries?: number;
-	/** 是否过滤 history 中的 tool 消息（默认过滤，避免上下文过长） */
-	filterHistory?: boolean;
-}
-/**
-* Checkpoint type
-*/
-type CheckpointType = "compact" | "manual";
-/**
-* Checkpoint metadata (stored in Session.metadata)
-*/
-interface CheckpointMeta {
-	id: string;
-	messageIndex: number;
-	title: string;
-	createdAt: number;
-	type: CheckpointType;
-}
-/**
-* User Intent type - represents a user's intent extracted from conversation
-*/
-type UserIntent = string;
-/**
-* Recent message for checkpoint
-* 
-* Stores a simplified version of a message for context preservation
-*/
-interface RecentMessage {
-	role: string;
-	content: string;
-}
-/**
-* Complete checkpoint information (includes generated content)
-*/
-interface SessionCheckpoint extends CheckpointMeta {
-	summary: string;
-	processKeyPoints: string[];
-	currentState: string;
-	nextSteps: string[];
-	messageCountBefore: number;
-	metadata?: Record<string, unknown>;
-	/** User intents extracted from the conversation */
-	userIntents: UserIntent[];
-	/**
-	* Recent messages preserved from the compacted conversation
-	* 
-	* Contains the last N turns of user query + assistant text response
-	* (excluding tool calls and tool results).
-	* This allows the checkpoint to serve as a fresh history context.
-	* 
-	* Format: [user, assistant, user, assistant, ...] from most recent
-	*/
-	recentMessages?: RecentMessage[];
-}
-/**
-* Session message
-*/
-interface SessionMessage {
-	id: string;
-	sessionID: string;
-	role: Role;
-	content: string;
-	timestamp: number;
-	parts?: MessagePart[];
-	/** Whether the message has been archived (compacted) */
-	isArchived?: boolean;
-	/** Timestamp when the message was archived */
-	archivedAt?: number;
-	/** Checkpoint ID this message belongs to */
-	checkpointId?: string;
-	/** Message metadata (includes checkpoint info if this is a checkpoint message) */
-	metadata?: MessageMetadata;
-}
-/**
-* Message metadata
-*/
-interface MessageMetadata extends Record<string, unknown> {
-	/** 消息类型标识，用于过滤和分类 */
-	type?: "tool_call" | "tool_result" | "checkpoint" | "user_intent" | "workflow.node.start" | "workflow.node.interrupt" | "workflow.node.end" | "workflow.node.resume";
-	isCheckpoint?: boolean;
-	checkpointId?: string;
-	checkpointMeta?: SessionCheckpoint;
-	/** Workflow node ID (for workflow.node.* messages) */
-	workflowNodeId?: string;
-	/** Workflow node type (for workflow.node.* messages) */
-	workflowNodeType?: string;
-	/** Agent session ID (for agent nodes in workflow) */
-	agentSessionId?: string;
-	/** User response (for workflow.node.resume messages) */
-	response?: string;
-	/** Success flag (for workflow.node.end messages) */
-	success?: boolean;
-}
-/**
-* Message role
-*/
-type Role = "user" | "assistant" | "system" | "tool" | "workflow.node.start" | "workflow.node.interrupt" | "workflow.node.end" | "workflow.node.resume";
-/**
-* Message part
-*/
-type MessagePart = SessionPart;
-/**
-* Text part - plain text content
-*/
-interface TextPart {
-	type: "text";
-	content: string;
-	/** If true, this part was generated by the system (e.g., auto-summary) */
-	synthetic?: boolean;
-	/** If true, this part should be ignored (e.g., replaced by reasoning) */
-	ignored?: boolean;
-}
-/**
-* Tool call part - represents a tool invocation
-*/
-interface ToolCallPart {
-	type: "tool-call";
-	/** AI SDK standard field name */
-	toolCallId: string;
-	toolName: string;
-	/** Tool arguments - can be string (JSON) or object */
-	arguments: string | Record<string, unknown>;
-	state: "pending" | "running";
-}
-/**
-* Tool result part - represents the result of a tool execution
-*/
-interface ToolResultPart {
-	type: "tool-result";
-	toolCallId: string;
-	toolName: string;
-	output: string;
-	error?: string;
-	state: "completed" | "error";
-}
-/**
-* Reasoning part - AI thinking/thought content
-*/
-interface ReasoningPart {
-	type: "reasoning";
-	/** Reasoning content */
-	content: string;
-	/** Reasoning type (for different models) */
-	reasoningType?: "core" | "effort" | "summary";
-	/** State */
-	state?: "thinking" | "completed";
-	/** Whether to collapse by default (like AI SDK default) */
-	isCollapsed?: boolean;
-	/** Metadata */
-	metadata?: {
-		tokenCount?: number;
-		time?: {
-			start: number;
-			end?: number;
-		};
-	};
-}
-/**
-* File part - file attachment
-*/
-interface FilePart {
-	type: "file";
-	mime: string;
-	url: string;
-	filename?: string;
-}
-/**
-* Checkpoint part - compaction checkpoint marker
-* 
-* Represents a checkpoint message in the conversation history.
-* This is stored as a user role message with markdown content summarizing
-* the compacted conversation segment.
-*/
-interface CheckpointPart {
-	type: "checkpoint";
-	/** Checkpoint ID reference */
-	checkpointId: string;
-	/** Markdown content summarizing the checkpoint */
-	content: string;
-	/** Title of the checkpoint */
-	title?: string;
-	/** Process key points */
-	processKeyPoints?: string[];
-	/** Current state description */
-	currentState?: string;
-	/** Next steps */
-	nextSteps?: string[];
-	/** Number of messages that were compacted */
-	messageCountBefore?: number;
-	/** Creation timestamp */
-	createdAt?: number;
-}
-/**
-* Union type for all Session Part types
-*/
-type SessionPart = TextPart | ToolCallPart | ToolResultPart | ReasoningPart | FilePart | CheckpointPart | WorkflowNodeStartPart | WorkflowNodeInterruptPart | WorkflowNodeEndPart | WorkflowNodeResumePart;
-/**
-* workflow.node.start 消息 part (对应 tool-call)
-*/
-interface WorkflowNodeStartPart {
-	type: "workflow-node-start";
-	nodeId: string;
-	nodeType: string;
-	input?: unknown;
-	startTime: number;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow.node.interrupt 消息 part
-*/
-interface WorkflowNodeInterruptPart {
-	type: "workflow-node-interrupt";
-	nodeId: string;
-	nodeType: string;
-	query: string;
-	options?: string[];
-	timestamp: number;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow.node.end 消息 part (对应 tool-result)
-*/
-interface WorkflowNodeEndPart {
-	type: "workflow-node-end";
-	nodeId: string;
-	nodeType: string;
-	output?: unknown;
-	error?: string;
-	durationMs: number;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-/**
-* workflow.node.resume 消息 part
-*/
-interface WorkflowNodeResumePart {
-	type: "workflow-node-resume";
-	nodeId: string;
-	response: string;
-	timestamp: number;
-	/** Agent session ID (only for agent nodes) */
-	agentSessionId?: string;
-}
-declare const WorkflowDefinitionSchema: unknown;
-type WorkflowDefinition = z5.infer<typeof WorkflowDefinitionSchema>;
-/**
-* TaskPlugin 配置
-*/
-interface TaskPluginConfig {
-	/** 是否启用 */
-	enabled?: boolean;
-	/** 优先级 */
-	priority?: number;
-}
-/**
-* TaskPlugin Hook 定义
-*/
-interface TaskPluginHook {
-	/** Hook 点 */
-	point: string;
-	/** 优先级（数字越大越先执行）*/
-	priority?: number;
-}
-/**
-* TaskPlugin 基类
-*/
-declare abstract class TaskPlugin {
-	abstract readonly name: string;
-	abstract readonly hooks: TaskPluginHook[];
-	protected config: TaskPluginConfig;
-	constructor(config?: TaskPluginConfig);
-	/**
-	* 设置依赖组件（可选实现）
-	*/
-	setComponents?(llmComponent: unknown, taskComponent: unknown): void;
-	/**
-	* 获取 Hook 点列表
-	*/
-	getHookPoints(): string[];
-	/**
-	* 获取指定 Hook 点的优先级
-	*/
-	getPriorityForHook(hookPoint: string): number;
-	/**
-	* 检查是否启用
-	*/
-	isEnabled(): boolean;
-	/**
-	* 设置启用状态
-	*/
-	setEnabled(enabled: boolean): void;
-}
-import { z as z7 } from "zod";
-/**
-* Task status enum
-*/
-declare const TaskStatusEnum: unknown;
-type TaskStatus = z7.infer<typeof TaskStatusEnum>;
-/**
-* Task priority enum
-*/
-declare const TaskPriorityEnum: unknown;
-type TaskPriority = z7.infer<typeof TaskPriorityEnum>;
-/**
-* Action type for task operations
-*/
-declare const ActionTypeEnum: unknown;
-type ActionType = z7.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;
-}
-interface TaskComponentLike {
-	getTask(id: number): Promise<Task | undefined>;
-	listOperations(options: {
-		taskId: number;
-		limit?: number;
-	}): Promise<Array<{
-		id: number;
-		taskId: number;
-		actionType: string;
-		actionTitle: string;
-		actionDescription: string;
-	}>>;
-	createOperation(options: any): Promise<any>;
-	env?: {
-		getComponent(name: string): unknown;
-	};
-}
-declare class TaskTagPlugin extends TaskPlugin {
-	readonly name = "TaskTagPlugin";
-	readonly hooks: readonly [{
-		readonly priority: 20;
-	}, {
-		readonly priority: 10;
-	}];
-	private taskComponent;
-	private agentComponent;
-	constructor(config?: TaskPluginConfig);
-	static getRequiredAgents(): unknown;
-	setComponents(_llmComponent: unknown, taskComponent: TaskComponentLike | null): void;
-	execute(ctx: any): Promise<void>;
-	/**
-	* 委派前：注入类似任务信息
-	* 
-	* 1. 从 task.tags 和 title 提取关键词
-	* 2. 检索最多 5 个类似任务
-	* 3. 只注入任务 ID、描述和目标
-	* 4. 提示可通过 task_get 获取详细信息
-	*/
-	private onDelegateBefore;
-	/**
-	* 从 task 提取关键词
-	*/
-	private extractKeywords;
-	/**
-	* 格式化类似任务（简洁版）
-	* 
-	* 注入格式：
-	* - Task ID: 用于引用和检索
-	* - Title: 任务标题
-	* - Description: 任务描述（截断至 100 字符）
-	* - Goal: 目标（截断至 100 字符）
-	* - 提醒：通过 task_get 和 task_operation_list 获取详细信息
-	*/
-	private formatSimilarTasks;
-	private onOperationAfterCreate;
-	private extractWorkflow;
-	private getWorkflowRepository;
-	private ensureDataDir;
-	private _workflowRepo;
-}
-/**
-* Workflow Extractor Agent System Prompt
-*/
-declare const WORKFLOW_EXTRACTOR_PROMPT = "你是 Workflow 提取专家，负责将自然语言描述转换为符合规范的 Workflow YAML。\n\n## 提取原则\n\n1. **优先具象节点**：优先使用特定工具节点（如 read_file, write_file, grep, bash 等）\n2. **Fallback 到通用节点**：没有对应工具时，使用 agent/llm/bash 节点\n3. **避免条件分支**：不提取循环和条件判断，保持线性流程\n4. **泛化但可执行**：步骤描述可泛化，但节点类型和工具要具体\n\n## 构建流程\n\n**重要**：构建的 Workflow 必须通过 `roy workflow validate` 验证才能输出。\n\n```\n1. 理解用户需求\n2. 参考 roy workflow nodes 查看可用节点类型\n3. 参考 roy workflow get <name> 查看已有 workflow 示例\n4. 生成 Workflow YAML\n5. 使用 roy workflow validate --yaml \"<生成的YAML>\" 验证\n6. 验证通过后输出最终结果\n```\n\n## 验证检查清单\n\n完成 Workflow 构建后，必须使用以下命令验证：\n\n```bash\nroy workflow validate --yaml \"<your-yaml>\"\n```\n\n验证通过后（无错误输出）才输出最终结果。验证失败时根据错误信息修正后重新验证。\n\n## 可用的 Workflow 节点类型\n\n使用以下命令查看所有节点类型的详细配置：\n\n```bash\nroy workflow nodes              # 列出所有节点类型\nroy workflow nodes <type>      # 查看特定节点详情（如 tool, agent, skill）\n```\n\n**支持的节点类型：**\n- **tool**：执行工具（bash, read-file, write-file, grep 等）\n- **skill**：调用技能\n- **agent**：AI Agent\n- **workflow**：子工作流\n- **condition**：条件判断\n- **merge**：合并结果\n- **decorator**：装饰器方法\n\n## 查看已有 Workflow 示例\n\n使用以下命令查看已有 workflow 的 YAML 结构：\n\n```bash\nroy workflow list              # 列出所有 workflow\nroy workflow get <name>       # 获取指定 workflow 详情（YAML 格式）\n```\n\n## 输出要求\n\n验证通过后，输出符合以下格式的 YAML Workflow：\n\n```yaml\nname: {泛化的任务名称}\nversion: \"1.0\"\ndescription: {一句话描述}\nnodes:\n  - id: node-1\n    type: tool|skill|agent|workflow|condition|merge|decorator\n    name: {节点名称}\n    config:\n      # 根据类型配置必填字段：\n      # tool: tool, input/args\n      # skill: skill, input\n      # agent: agent_type, prompt, options\n      # workflow: workflow_name, input\n      # condition: condition\n      # merge: strategy, depends_on\n      # decorator: _methodName, _instance\n    depends_on: []\noutputs: []\n```\n\n## 限制\n\n- 至少 2 个节点才有意义\n- 不要生成条件节点（if/else/switch）\n- 不要生成循环节点（while/for）\n- 每个节点要有清晰的名称和描述\n- 必须为 tool 节点指定 tool 名称\n- 必须为 agent 节点指定 agent_type 和 prompt";
-/**
-* 创建 WorkflowExtractorAgent 配置
-*/
-declare function createWorkflowExtractorAgent(): AgentInstanceConfig;
-/**
-* 格式化提取器输入 - 从 Task 提取
-*/
-declare function formatExtractorInput(params: {
-	task: Task;
-	operations: TaskOperation[];
-	messages: SessionMessage[];
-}): string;
-/**
-* 格式化提取器输入 - 从自然语言描述提取
-*/
-declare function formatExtractorInputFromDescription(params: {
-	description: string;
-}): string;
-/**
-* 解析提取器输出
-*/
-declare function parseExtractorOutput(output: string): Promise<WorkflowDefinition | null>;
-export { parseExtractorOutput, formatExtractorInputFromDescription, formatExtractorInput, createWorkflowExtractorAgent, WORKFLOW_EXTRACTOR_PROMPT, TaskTagPlugin, TaskPluginHook, TaskPluginConfig, TaskPlugin };

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

@@ -1,23 +0,0 @@
-import {
-  TaskPlugin,
-  TaskTagPlugin,
-  WORKFLOW_EXTRACTOR_PROMPT,
-  createWorkflowExtractorAgent,
-  formatExtractorInput,
-  formatExtractorInputFromDescription,
-  parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-3jywqmdd.js";
-import"../../../shared/@ai-setting/roy-agent-core-92z6t4he.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 {
-  parseExtractorOutput,
-  formatExtractorInputFromDescription,
-  formatExtractorInput,
-  createWorkflowExtractorAgent,
-  WORKFLOW_EXTRACTOR_PROMPT,
-  TaskTagPlugin,
-  TaskPlugin
-};