@ai-setting/roy-agent-core 1.5.87 → 1.5.89

package/dist/shared/@ai-setting/roy-agent-core-8wd3qwx5.js

@@ -0,0 +1,35 @@
+import {
+  DAGManager,
+  init_dag_manager
+} from "./roy-agent-core-4yq23m5g.js";
+
+// src/env/workflow/utils/validate-workflow-definition.ts
+init_dag_manager();
+function validateWorkflowDefinition(definition) {
+  if (!definition || typeof definition !== "object") {
+    return {
+      valid: false,
+      errors: ["Workflow definition must be an object"]
+    };
+  }
+  const def = definition;
+  if (!Array.isArray(def.nodes)) {
+    return {
+      valid: false,
+      errors: ["Workflow definition must have a 'nodes' array"]
+    };
+  }
+  try {
+    const dag = new DAGManager(definition, { allowCycles: false });
+    return dag.validate();
+  } catch (error) {
+    return {
+      valid: false,
+      errors: [
+        `Validation error: ${error instanceof Error ? error.message : String(error)}`
+      ]
+    };
+  }
+}
+
+export { validateWorkflowDefinition };

package/dist/shared/@ai-setting/{roy-agent-core-29fh9mxg.js → roy-agent-core-bwjpte58.js}

@@ -1,6 +1,6 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-7fdzfsm6.js";
+} from "./roy-agent-core-yanpq5gb.js";
 import {
   ContextError,
   ErrorCodes
@@ -158,7 +158,6 @@ class BaseEnvironment extends BaseComponent {
         "echo",
         "glob",
         "grep",
-        "read_file",
         "write_file",
         "edit_file",
         "task_create",

package/dist/shared/@ai-setting/{roy-agent-core-r1adqgaa.js → roy-agent-core-ewr1nw7t.js}

@@ -5,7 +5,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-bgw4dq11.js";
+} from "./roy-agent-core-mw4ty0ba.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
@@ -20,7 +20,7 @@ import {
   listTasksTool,
   searchTasksTool,
   updateTaskTool
-} from "./roy-agent-core-9vwyj29a.js";
+} from "./roy-agent-core-h5867smx.js";
 import {
   createOperationTool,
   deleteOperationTool,
@@ -358,12 +358,11 @@ class TaskComponent extends BaseComponent {
   }
   async createTask(options) {
     const sessionId = options.sessionId;
-    if (options.parent_task_id === undefined || options.parent_task_id === null) {
-      throw new Error("parent_task_id is required. All tasks must be attached to a parent task. " + "Use task_list(depth=0) to find root tasks, or create a parent task first.");
-    }
-    const parentTask = await this.store.getTask(options.parent_task_id);
-    if (!parentTask) {
-      throw new Error(`Parent task #${options.parent_task_id} not found. ` + "Please provide a valid parent_task_id. Use task_list(depth=0) to see all root tasks.");
+    if (options.parent_task_id !== undefined && options.parent_task_id !== null) {
+      const parentTask = await this.store.getTask(options.parent_task_id);
+      if (!parentTask) {
+        throw new Error(`Parent task #${options.parent_task_id} not found. ` + "Please provide a valid parent_task_id. Use task_list(depth=0) to see all root tasks.");
+      }
     }
     const createCtx = {
       options: { ...options },

package/dist/shared/@ai-setting/{roy-agent-core-yx0vw1aw.js → roy-agent-core-fgpnv7dt.js}

@@ -1,13 +1,16 @@
 import {
   withTimeout
 } from "./roy-agent-core-r0m0at3x.js";
+import {
+  truncateOutputInline
+} from "./roy-agent-core-hxsbegfc.js";
 import {
   AskUserError,
   init_workflow_hil
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-7z4xtrmw.js";
+} from "./roy-agent-core-nqzt9ne4.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";
@@ -303,6 +306,12 @@ class AgentComponent extends BaseComponent {
       logger.info("[AgentComponent] Registered built-in workflow-agent");
       this.registry.registerJsonExtractAgent();
       logger.info("[AgentComponent] Registered built-in json-extract agent");
+      this.registry.registerWorkflowExtractAgent();
+      logger.info("[AgentComponent] Registered built-in workflow-extract agent");
+      this.registry.registerCompactAgent();
+      logger.info("[AgentComponent] Registered built-in compact agent");
+      this.registry.registerCompactHintAgent();
+      logger.info("[AgentComponent] Registered built-in compact-hint agent");
       for (const agentDef of this.registry.list()) {
         if (!this.agents.has(agentDef.name)) {
           const systemPrompt = await this.registry.getSystemPrompt(agentDef.name);
@@ -504,7 +513,7 @@ class AgentComponent extends BaseComponent {
     const allowedTools = context?.allowedTools ?? agent.config.allowedTools;
     const deniedTools = context?.deniedTools ?? agent.config.deniedTools;
     logger.debug(`[getAvailableTools] Filtering: allowed=${allowedTools}, denied=${deniedTools}`);
-    if (allowedTools?.length) {
+    if (allowedTools !== undefined && allowedTools !== null) {
       tools = tools.filter((t) => allowedTools.includes(t.name));
       logger.debug(`[getAvailableTools] After allowedTools filter: ${tools.length} tools`, {
         toolNames: tools.map((t) => t.name)
@@ -1062,7 +1071,8 @@ ${additionInfo}`
             sessionId: ctx.context.sessionId,
             messageId: ctx.context.messageId
           },
-          abortSignal: ctx.context.abort
+          abortSignal: ctx.context.abort,
+          skipThresholdCheck: ctx.context.agentType === "sub"
         });
         const result = await withTimeout(llmPromise, 300000, "LLM invocation timeout after 300s");
         logger.debug("[invokeLLM] LLMComponent.invoke returned successfully");
@@ -1148,6 +1158,7 @@ ${additionInfo}`
         } else {
           result = await withTimeout(toolPromise, 120000, `Tool '${toolName}' execution timeout after 120s`);
         }
+        result = truncateOutputInline(result, undefined, undefined, toolName);
       } else if (this.toolComponent?.execute) {
         const toolPromise = this.toolComponent.execute(request);
         if (isLongRunningTool) {
@@ -1163,6 +1174,7 @@ ${additionInfo}`
         } else {
           result = await withTimeout(toolPromise, 120000, `Tool '${toolName}' execution timeout after 120s`);
         }
+        result = truncateOutputInline(result, undefined, undefined, toolName);
       }
       this.pushEnvEvent({
         type: "tool.result",
@@ -1375,4 +1387,19 @@ __legacyDecorateClassTS([
 __legacyDecorateClassTS([
   TracedAs("agent.component.getConversationHistory", { recordParams: true, recordResult: true, log: true })
 ], AgentComponent.prototype, "getConversationHistory", null);
-export { AgentComponentConfigSchema, AgentComponent };
+// src/env/agent/summary-agent.ts
+class SummaryAgent {
+  llmComponent;
+  config;
+  constructor(_promptComponent, llmComponent, config) {
+    this.llmComponent = llmComponent;
+    this.config = {
+      type: "summary",
+      promptName: "session/compact",
+      maxIterations: 1,
+      model: undefined,
+      ...config
+    };
+  }
+}
+export { AgentComponentConfigSchema, AgentComponent, SummaryAgent };

package/dist/shared/@ai-setting/{roy-agent-core-jymz9fzp.js → roy-agent-core-fvfc7f6v.js}

@@ -7,9 +7,6 @@ import {
   MemorySessionStore,
   SQLiteSessionStore
 } from "./roy-agent-core-q7sqeax6.js";
-import {
-  SummaryAgent
-} from "./roy-agent-core-x3gtyqax.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-qxhq8ven.js";
@@ -67,6 +64,7 @@ var SESSION_CONFIG_REGISTRATION = {
 // src/env/session/session-component.ts
 init_search_query_parser();
 import path from "path";
+import { z } from "zod";
 var logger = createLogger("session");
 
 class SessionComponent extends BaseComponent {
@@ -78,9 +76,6 @@ class SessionComponent extends BaseComponent {
   hooksConfig = {};
   configComponent;
   configWatcher;
-  summaryAgent;
-  promptComponent;
-  llmComponent;
   constructor() {
     super();
   }
@@ -398,19 +393,6 @@ class SessionComponent extends BaseComponent {
     const date = new Date().toISOString().replace("T", " ").substring(0, 19);
     return template.replace("{date}", date);
   }
-  setSummaryComponents(promptComponent, llmComponent) {
-    this.promptComponent = promptComponent;
-    this.llmComponent = llmComponent;
-    this.summaryAgent = new SummaryAgent(promptComponent, llmComponent);
-  }
-  ensureSummaryAgent() {
-    if (!this.summaryAgent) {
-      if (!this.promptComponent || !this.llmComponent) {
-        throw new Error("SummaryAgent components not initialized. Call setSummaryComponents() first.");
-      }
-      this.summaryAgent = new SummaryAgent(this.promptComponent, this.llmComponent);
-    }
-  }
   async generateCompactHint(sessionId) {
     const session = await this.get(sessionId);
     if (!session) {
@@ -424,16 +406,33 @@ class SessionComponent extends BaseComponent {
       logger.warn("[SessionComponent] Not enough messages for hint generation");
       return "";
     }
-    this.ensureSummaryAgent();
-    const result = await this.summaryAgent.generateCompactHint({
-      messages: messages.map((m) => ({ role: m.role, content: m.content })),
-      sessionContext: {}
+    const agentComponent = this.env.getComponent("agent");
+    let hintData;
+    const submitTool = {
+      name: "workflow_submit_output",
+      description: "Submit the final result. Call this with your guidance_prompt.",
+      parameters: z.object({
+        guidance_prompt: z.string().describe("The compact guidance prompt (3-4 sentences)")
+      }),
+      execute: async (args) => {
+        const parsed = z.object({
+          guidance_prompt: z.string()
+        }).parse(args);
+        hintData = parsed;
+        return { success: true, output: "OK" };
+      }
+    };
+    await agentComponent.run("compact-hint", "Analyze this conversation and generate a compact guidance prompt for checkpoint generation.", {
+      sessionId,
+      persistSession: false,
+      extraTools: [submitTool]
     });
+    const hint = hintData?.guidance_prompt || "[Hint extraction failed]";
     logger.info("[SessionComponent] Compact hint generated", {
       sessionId,
-      hintLength: result.hint.length
+      hintLength: hint.length
     });
-    return result.hint;
+    return hint;
   }
   async compact(sessionId, options) {
     const session = await this.get(sessionId);
@@ -448,20 +447,52 @@ class SessionComponent extends BaseComponent {
       throw new Error("Not enough messages to compact (minimum 3 required)");
     }
     const recentMessages = this.extractRecentMessages(messages, 2);
-    this.ensureSummaryAgent();
     await this.executeBeforeHooks("compact", { session, options });
     let summaryResult;
     try {
-      summaryResult = await this.summaryAgent.run({
-        messages: messages.map((m) => ({ role: m.role, content: m.content })),
-        userContext: options?.summary,
-        outputFormat: "json",
-        scenarioHint: options?.scenarioHint
+      const userQuery = options?.scenarioHint ? options.scenarioHint : "Generate a checkpoint from this conversation.";
+      let checkpointData;
+      const submitTool = {
+        name: "workflow_submit_output",
+        description: "Submit the checkpoint result with title, processKeyPoints, currentState, nextSteps, userIntents.",
+        parameters: z.object({
+          title: z.string().describe("Brief checkpoint title (max 30 chars)"),
+          processKeyPoints: z.array(z.string()).describe("Key discoveries or decisions"),
+          currentState: z.string().describe("Current progress and status"),
+          nextSteps: z.array(z.string()).describe("Follow-up items"),
+          userIntents: z.array(z.string()).describe("User's core intents (2-5 items)")
+        }),
+        execute: async (args) => {
+          const parsed = z.object({
+            title: z.string(),
+            processKeyPoints: z.array(z.string()),
+            currentState: z.string(),
+            nextSteps: z.array(z.string()),
+            userIntents: z.array(z.string())
+          }).parse(args);
+          checkpointData = parsed;
+          return { success: true, output: "OK" };
+        }
+      };
+      const agentComponent = this.env.getComponent("agent");
+      await agentComponent.run("compact", userQuery, {
+        sessionId,
+        persistSession: false,
+        extraTools: [submitTool]
       });
+      const data = checkpointData || {};
+      summaryResult = {
+        title: data.title || "Untitled Checkpoint",
+        processKeyPoints: data.processKeyPoints || [],
+        currentState: data.currentState || "",
+        nextSteps: data.nextSteps || [],
+        userIntents: data.userIntents || [],
+        rawResponse: JSON.stringify(data)
+      };
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      logger.error(`[SessionComponent] SummaryAgent.run failed: ${errorMessage}`);
-      throw new Error(`Session compaction failed: SummaryAgent error - ${errorMessage}`);
+      logger.error(`[SessionComponent] Compact agent failed: ${errorMessage}`);
+      throw new Error(`Session compaction failed: ${errorMessage}`);
     }
     const checkpointId = `cp_${Date.now().toString(36)}_${Math.random().toString(36).substring(2, 8)}`;
     const checkpoint = {

package/dist/shared/@ai-setting/{roy-agent-core-9vwyj29a.js → roy-agent-core-h5867smx.js}

@@ -18,15 +18,13 @@ var CreateTaskToolSchema = z.object({
   due_date: z.string().optional().describe("Due date (ISO format)"),
   tags: z.array(z.string()).optional().describe("Task tags (for search, stored in task.tags JSON field)"),
   project_path: z.string().describe("Project root path for task positioning. " + "Used to locate the project space for this task. " + "Use 'unknown' if unknown."),
-  parent_task_id: z.number().describe(`父任务 ID（必填）。所有新任务都必须挂载到某个父任务下，以维护良好的任务树结构。
-` + `为什么 parent_task_id 是必填的：
-` + `  1. 任务聚类：将相关任务聚合到同一父任务下，便于管理和追踪
-` + `  2. 维护任务树：保持根任务数量可控（≤10个），深度适中（≤5层）
+  parent_task_id: z.union([z.number(), z.null()]).optional().describe(`父任务 ID（可选）。不传或传 null 时，创建根任务（root task）。
+` + `如需将任务挂载到某个父任务下，传入对应父任务 ID。
 ` + `如何选择合适的父任务：
 ` + `  1. 使用 task_list(depth=0) 查看当前所有根任务
 ` + `  2. 使用 task_search 搜索与当前任务相关的父任务
 ` + `  3. 按主题归类：将相似主题的任务挂载到同一个父任务下
-` + "如果确实找不到合适的父任务，可以先创建一个合适的父任务，再创建子任务。"),
+` + "如果确实找不到合适的父任务，可以直接创建根任务（不传 parent_task_id）。"),
   context: z.string().describe("JSON string with time-space positioning information for task continuity. " + "This field is crucial for Agent task handoff. " + "Core fields: worktree_path (git worktree path), branch (current branch), type (feature/bug/refactor/chore). " + 'Example for coding: {"worktree_path": "/path/worktree", "branch": "feature/xyz", "type": "feature"}. ' + 'Example for other: {"type": "general"}. ' + `If unknown, use '{}' or '{"type":"unknown"}'. ` + "IMPORTANT: Must be a valid JSON string!")
 });
 var GetTaskToolSchema = z.object({
@@ -124,32 +122,28 @@ function createTaskTool(taskComponent) {
         
         **DO NOT leave this as plain text** - it must be valid JSON!
       
-      ## ⚠️ parent_task_id is REQUIRED
+      ## parent_task_id is OPTIONAL
       
-      All new tasks MUST have a parent_task_id. This is critical for:
+      Creating a root task (top-level task) is allowed and common. To create a root task,
+      simply **omit** \`parent_task_id\` (or pass \`null\`).
       
-      1. **Task Tree Structure**: Every task must be attached to a parent,
-         maintaining a clean hierarchy (根任务 ≤10, 深度 ≤5).
-      
-      2. **Task Clustering**: Related tasks are grouped under the same parent,
-         making it easy to track progress and find related work.
-      
-      **How to choose a parent task:**
+      To create a child task, provide an existing parent's \`parent_task_id\`. Best practices:
       
       1. First, use \`task_list(depth=0)\` to see all root tasks (top-level tasks).
       2. Use \`task_search\` with relevant keywords to find existing tasks
          that could serve as the parent.
       3. Group by topic: put similar tasks under the same parent.
-      4. If no suitable parent exists, create a parent task first,
-         then create the child task with that parent_task_id.
+      4. If no suitable parent exists, create a root task first (omit \`parent_task_id\`),
+         then create the child task with that root task's id.
       
-      **Example:**
-      - First: task_list(depth=0) → find an appropriate root task for your project
-        (e.g. one whose title matches your project name). Use the returned root task's
-        id as \`parent_task_id\` — do NOT hardcode a specific id; the root task id varies
-        across deployments and resets.
-      - Then: task_create(title="New feature", parent_task_id=<root_task_id>, ...)
+      **Examples:**
+      - Root task: \`task_create(title="New project", ...)\` (no parent_task_id)
+      - Child task: \`task_create(title="New feature", parent_task_id=<root_task_id>, ...)\`
         where \`<root_task_id>\` is the id returned by task_list, NOT a hardcoded number.
+      
+      **Hierarchy guidance** (not enforced):
+      - 根任务 ≤10 (keep root tasks manageable)
+      - 深度 ≤5 (avoid deep nesting)
     `,
     parameters: CreateTaskToolSchema,
     execute: async (args, ctx) => {

package/dist/shared/@ai-setting/roy-agent-core-hvdfgvfz.js

@@ -0,0 +1,114 @@
+// src/env/task/delegate/process-registry.ts
+import { AsyncLocalStorage } from "async_hooks";
+
+// src/util/process/process-tree-killer.ts
+import { spawn as _childProcessSpawn } from "child_process";
+var spawnInjector;
+function spawn(cmd, args, opts) {
+  if (spawnInjector)
+    return spawnInjector(cmd, args, opts);
+  return _childProcessSpawn(cmd, args, opts);
+}
+var platformOverride;
+function currentPlatform() {
+  return platformOverride ?? process.platform;
+}
+function killProcessTree(pid, options) {
+  if (!Number.isInteger(pid) || pid <= 0) {
+    throw new Error(`Invalid PID: ${pid} (must be a positive integer)`);
+  }
+  const platform = currentPlatform();
+  const signal = options?.signal ?? "SIGKILL";
+  if (platform === "win32") {
+    return killOnWindows(pid);
+  }
+  return killOnPosix(pid, signal);
+}
+function killOnWindows(pid) {
+  try {
+    spawn("taskkill", ["/pid", String(pid), "/f", "/t"], {
+      stdio: "ignore",
+      windowsHide: true
+    });
+    return {
+      pid,
+      platform: "win32",
+      signal: "taskkill /f /t",
+      success: true
+    };
+  } catch {
+    return {
+      pid,
+      platform: "win32",
+      signal: "taskkill /f /t",
+      success: false
+    };
+  }
+}
+function killOnPosix(pid, signal) {
+  const platform = currentPlatform();
+  try {
+    process.kill(-pid, signal);
+    return {
+      pid,
+      platform,
+      signal,
+      success: true
+    };
+  } catch (err) {
+    const code = err.code;
+    if (code === "ESRCH" || code === "EPERM") {
+      return {
+        pid,
+        platform,
+        signal,
+        success: true
+      };
+    }
+    return {
+      pid,
+      platform,
+      signal,
+      success: false
+    };
+  }
+}
+
+// src/env/task/delegate/process-registry.ts
+class ProcessRegistry {
+  pids = new Set;
+  register(pid) {
+    if (!Number.isInteger(pid) || pid <= 0) {
+      return;
+    }
+    this.pids.add(pid);
+  }
+  unregister(pid) {
+    if (!Number.isInteger(pid)) {
+      return;
+    }
+    this.pids.delete(pid);
+  }
+  size() {
+    return this.pids.size;
+  }
+  killAll() {
+    if (this.pids.size === 0)
+      return;
+    for (const pid of Array.from(this.pids)) {
+      try {
+        killProcessTree(pid);
+      } catch {}
+    }
+    this.pids.clear();
+  }
+}
+var processRegistryStorage = new AsyncLocalStorage;
+function runWithProcessRegistryAsync(registry, fn) {
+  return processRegistryStorage.run(registry, fn);
+}
+function getCurrentProcessRegistry() {
+  return processRegistryStorage.getStore();
+}
+
+export { killProcessTree, ProcessRegistry, runWithProcessRegistryAsync, getCurrentProcessRegistry };