@ai-setting/roy-agent-core 1.7.72 → 1.7.75

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

@@ -1,155 +0,0 @@
-// src/env/tool/built-in/query-background-process-tool.ts
-import { z } from "zod";
-var QueryBackgroundProcessParameters = z.object({
-  bgProcessId: z.string().min(1, "bgProcessId must not be empty").describe("The background process ID returned by delegate_task " + "(format: process_<timestamp>_<random>).")
-});
-function backgroundTaskToOutput(task) {
-  return {
-    alive: task.status === "pending" || task.status === "running",
-    status: task.status,
-    createdAt: task.createdAt,
-    lastUpdatedAt: task.lastUpdatedAt ?? task.completedAt ?? task.startedAt ?? task.createdAt,
-    description: task.description,
-    ...task.result !== undefined ? { result: task.result } : {},
-    ...task.error !== undefined ? { error: task.error } : {}
-  };
-}
-function notFoundOutput(bgProcessId) {
-  const now = Date.now();
-  return {
-    alive: false,
-    status: "not_found",
-    createdAt: now,
-    lastUpdatedAt: now,
-    description: `No background process found with id '${bgProcessId}'.`
-  };
-}
-var queryBackgroundProcessTool = {
-  name: "query_background_process",
-  description: `Query the status of a background process previously launched via delegate_task.
-
-` + `Use this tool when:
-` + `  - You delegated a long-running task but have NOT received any notification after a reasonable wait (5+ minutes), and want to confirm whether the process is still alive.
-` + `  - The user asks about the progress of a delegated task and you need a current snapshot.
-` + `  - You suspect a delegated task got stuck (no progress messages, no completion notification).
-
-` + `DO NOT poll this tool on every turn — it is meant for diagnostic checks at a reasonable cadence (e.g. every few minutes, or when you genuinely suspect the task is stuck).
-
-` + `Returns a JSON object with:
-` + `  - alive: boolean — true if status is 'pending' or 'running'
-` + `  - status: 'pending' | 'running' | 'completed' | 'failed' | 'stopped' | 'timeout' | 'not_found'
-` + `  - createdAt, lastUpdatedAt: timestamps (ms)
-` + `  - description: the task description you passed to delegate_task
-` + `  - result: present when status is 'completed'
-` + `  - error: present when status is 'failed'
-
-` + "Only the default receptionist agent has this tool. Sub-agents (roy, strict-task-agent, etc.) cannot see it because they do not need to query background tasks they themselves launched.",
-  parameters: QueryBackgroundProcessParameters,
-  permission: {
-    level: "safe",
-    requireConfirmation: false
-  },
-  metadata: {
-    category: "task",
-    tags: ["background", "delegate", "query", "status", "diagnostic"],
-    version: "1.0.0",
-    allowedAgentTypes: ["default"]
-  },
-  execute: async (args, ctx) => createQueryBackgroundProcessTool(null).execute(args, ctx)
-};
-function createQueryBackgroundProcessTool(manager = null) {
-  return {
-    name: "query_background_process",
-    description: `Query the status of a background process previously launched via delegate_task.
-
-` + `Use this tool when:
-` + `  - You delegated a long-running task but have NOT received any notification after a reasonable wait (5+ minutes), and want to confirm whether the process is still alive.
-` + `  - The user asks about the progress of a delegated task and you need a current snapshot.
-` + `  - You suspect a delegated task got stuck (no progress messages, no completion notification).
-
-` + `DO NOT poll this tool on every turn — it is meant for diagnostic checks at a reasonable cadence (e.g. every few minutes, or when you genuinely suspect the task is stuck).
-
-` + `Returns a JSON object with:
-` + `  - alive: boolean — true if status is 'pending' or 'running'
-` + `  - status: 'pending' | 'running' | 'completed' | 'failed' | 'stopped' | 'timeout' | 'not_found'
-` + `  - createdAt, lastUpdatedAt: timestamps (ms)
-` + `  - description: the task description you passed to delegate_task
-` + `  - result: present when status is 'completed'
-` + `  - error: present when status is 'failed'
-
-` + "Only the default receptionist agent has this tool. Sub-agents (roy, strict-task-agent, etc.) cannot see it because they do not need to query background tasks they themselves launched.",
-    parameters: QueryBackgroundProcessParameters,
-    permission: {
-      level: "safe",
-      requireConfirmation: false
-    },
-    metadata: {
-      category: "task",
-      tags: ["background", "delegate", "query", "status", "diagnostic"],
-      version: "1.0.0",
-      allowedAgentTypes: ["default"]
-    },
-    execute: async (args, ctx) => {
-      const startTime = Date.now();
-      const params = QueryBackgroundProcessParameters.parse(args);
-      const { bgProcessId } = params;
-      if (!manager) {
-        return {
-          success: false,
-          output: "",
-          error: "query_background_process is not initialized: no BackgroundTaskManager " + "has been bound. TaskComponent should call " + "createQueryBackgroundProcessTool(manager) and register the tool " + "during startup.",
-          metadata: { execution_time_ms: Date.now() - startTime }
-        };
-      }
-      let task;
-      try {
-        task = manager.getTask(bgProcessId);
-      } catch (err) {
-        return {
-          success: false,
-          output: "",
-          error: `failed to query background task: ${err.message}`,
-          metadata: { execution_time_ms: Date.now() - startTime }
-        };
-      }
-      if (task) {
-        const currentSessionId = ctx.session_id;
-        if (!currentSessionId || task.parentSessionId !== currentSessionId) {
-          return {
-            success: true,
-            output: JSON.stringify(notFoundOutput(bgProcessId), null, 2),
-            metadata: {
-              execution_time_ms: Date.now() - startTime,
-              bgProcessId,
-              status: "not_found",
-              alive: false
-            }
-          };
-        }
-      }
-      const output = task ? backgroundTaskToOutput(task) : notFoundOutput(bgProcessId);
-      if (output.alive) {
-        try {
-          const activity = await manager.getSubSessionActivity?.(bgProcessId);
-          if (activity) {
-            output.lastUpdatedAt = Math.max(output.lastUpdatedAt, activity.updatedAt);
-            output.messageCount = activity.messageCount;
-            output.subSessionUpdatedAt = activity.updatedAt;
-          }
-        } catch {}
-      }
-      return {
-        success: true,
-        output: JSON.stringify(output, null, 2),
-        metadata: {
-          execution_time_ms: Date.now() - startTime,
-          bgProcessId,
-          status: output.status,
-          alive: output.alive
-        }
-      };
-    }
-  };
-}
-
-export { queryBackgroundProcessTool, createQueryBackgroundProcessTool };