@ai-setting/roy-agent-core 1.5.45 → 1.5.47

package/dist/shared/@ai-setting/{roy-agent-core-44g4dhzg.js → roy-agent-core-2rtka82a.js}

@@ -1,9 +1,9 @@
 import {
   WORKFLOW_JSON_OUTPUT_PLUGIN_KEY,
-  extractStructuredJsonViaLlm,
   init_workflow_json_output_plugin,
-  registerWorkflowJsonOutputPlugin
-} from "./roy-agent-core-dbxm76wf.js";
+  registerWorkflowJsonOutputPlugin,
+  tracedExtractStructuredJsonViaLlm
+} from "./roy-agent-core-kzbj10gk.js";
 import {
   AskUserError,
   init_workflow_hil
@@ -229,7 +229,7 @@ class AgentComponentAdapter {
         role: m.role,
         content: m.content ?? ""
       }));
-      return await extractStructuredJsonViaLlm(this._llmComponent, history, outputSchema, {
+      return await tracedExtractStructuredJsonViaLlm(this._llmComponent, history, outputSchema, {
         model: config.options?.model,
         sessionId: agentSessionId
       });

package/dist/shared/@ai-setting/{roy-agent-core-9p604xjf.js → roy-agent-core-38sc085e.js}

@@ -4,10 +4,13 @@ import {
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-fg3j215p.js";
+} from "./roy-agent-core-emk3q2nt.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";
+import {
+  SessionMessageConverter
+} from "./roy-agent-core-7b35emr7.js";
 import {
   TracedAs,
   init_decorator
@@ -30,9 +33,6 @@ import {
   createLogger,
   init_logger
 } from "./roy-agent-core-10n2jh7p.js";
-import {
-  SessionMessageConverter
-} from "./roy-agent-core-7b35emr7.js";
 import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";
@@ -889,12 +889,10 @@ class AgentComponent extends BaseComponent {
         sessionId: effectiveContext.sessionId,
         summary: result.finalText
       };
-      await this.executePluginHooks(agent, "agent:after.react", {
-        ...hookCtx,
-        ...reactContext
-      });
-      if (hookCtx.structuredOutputExtracted) {
-        result.structuredOutput = hookCtx.structuredOutputExtracted;
+      const mergedHookCtx = { ...hookCtx, ...reactContext };
+      await this.executePluginHooks(agent, "agent:after.react", mergedHookCtx);
+      if (mergedHookCtx.structuredOutputExtracted) {
+        result.structuredOutput = mergedHookCtx.structuredOutputExtracted;
       }
       await this.executePluginHooks(agent, "agent:after.complete", hookCtx);
       if (this.aborted.get(runId) === true || hookCtx._stopped) {

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

@@ -82,6 +82,14 @@ class BaseEnvironment extends BaseComponent {
     if (!agentComponent) {
       throw new Error("AgentComponent not found. Please register AgentComponent before calling handle_query.");
     }
+    const agentName = context?.agentType && context.agentType !== "default" ? context.agentType : "default";
+    const registry = agentComponent.getRegistry?.();
+    if (registry) {
+      const agentDef = registry.get(agentName);
+      if (agentDef?.type === "workflow") {
+        return await this.handleWorkflowAgentQuery(agentName, query, agentComponent);
+      }
+    }
     let systemPrompt = "You are a helpful assistant.";
     let promptSource = "fallback";
     try {
@@ -118,7 +126,6 @@ class BaseEnvironment extends BaseComponent {
       finalSystemPrompt = finalSystemPrompt.replace("{{workspace_dir}}", workspaceDir);
       logger.debug(`[handle_query] Injected workspace_dir: ${workspaceDir}`);
     }
-    const agentName = context?.agentType && context.agentType !== "default" ? context.agentType : "default";
     let agent = agentComponent.getAgent(agentName);
     if (!agent) {
       if (agentName !== "default") {
@@ -155,6 +162,56 @@ class BaseEnvironment extends BaseComponent {
     }
     return result.finalText || "";
   }
+  async handleWorkflowAgentQuery(agentName, query, agentComponent) {
+    const registry = agentComponent.getRegistry?.();
+    if (!registry) {
+      return null;
+    }
+    const agentDef = registry.get(agentName);
+    if (!agentDef || agentDef.type !== "workflow") {
+      return null;
+    }
+    const workflowComponent = this.getComponent("workflow");
+    if (!workflowComponent) {
+      throw new Error(`WorkflowComponent not available — cannot run workflow agent "${agentName}". ` + `Ensure the workflow component is registered.`);
+    }
+    const workflowName = agentDef.workflow;
+    if (!workflowName) {
+      throw new Error(`Agent "${agentName}" has type 'workflow' but no workflow configured.`);
+    }
+    const svc = workflowComponent.getService?.();
+    if (!svc || typeof svc.getWorkflowByName !== "function") {
+      throw new Error(`WorkflowService not available. Cannot run workflow agent "${agentName}".`);
+    }
+    const workflow = svc.getWorkflowByName(workflowName);
+    if (!workflow) {
+      throw new Error(`Workflow "${workflowName}" not found. ` + `Use 'roy-agent workflow add' to register it first.`);
+    }
+    const wfResult = await workflowComponent.runWorkflow(workflow.definition, { query }, {});
+    if (wfResult.status === "paused") {
+      return JSON.stringify({
+        status: "paused",
+        message: `Workflow "${workflowName}" paused, waiting for user input.`,
+        pendingNodeId: wfResult.pendingNodeId,
+        query: wfResult.query,
+        sessionId: wfResult.sessionId,
+        hint: `Resume with: roy-agent workflow run -s ${wfResult.sessionId} --input "your response"`
+      });
+    }
+    if (wfResult.status === "failed") {
+      throw new Error(`Workflow "${workflowName}" execution failed: ${wfResult.error || "Unknown error (status: " + wfResult.status + ")"}`);
+    }
+    if (typeof wfResult.output === "string") {
+      return wfResult.output;
+    }
+    if (wfResult.output !== undefined && wfResult.output !== null) {
+      return JSON.stringify(wfResult.output);
+    }
+    if (wfResult.error) {
+      throw new Error(`Workflow "${workflowName}" completed with error: ${wfResult.error}`);
+    }
+    return "";
+  }
   async handle_action(action, context) {
     throw new Error("handle_action not implemented. Override in subclass.");
   }
@@ -424,6 +481,9 @@ class BaseEnvironment extends BaseComponent {
 __legacyDecorateClassTS([
   TracedAs("env.handle_query", { recordParams: true, recordResult: true, log: true })
 ], BaseEnvironment.prototype, "handle_query", null);
+__legacyDecorateClassTS([
+  TracedAs("env.handle_workflow_agent_query", { recordParams: true, recordResult: true, log: true })
+], BaseEnvironment.prototype, "handleWorkflowAgentQuery", null);
 
 // src/env/index.ts
 init_context();

package/dist/shared/@ai-setting/{roy-agent-core-68qy97r3.js → roy-agent-core-ebap34m2.js}

@@ -7,10 +7,13 @@ import {
   isWorkflowJsonOutputEnabled,
   registerWorkflowJsonOutputPlugin,
   runWorkflowJsonOutputExtraction,
+  tracedExtractStructuredJsonViaLlm,
+  tracedRunWorkflowJsonOutputExtraction,
   unregisterWorkflowJsonOutputPlugin
-} from "./roy-agent-core-dbxm76wf.js";
+} from "./roy-agent-core-kzbj10gk.js";
 import"./roy-agent-core-nhfy3p8q.js";
 import"./roy-agent-core-e25xkv53.js";
+import"./roy-agent-core-q5qj0fes.js";
 import"./roy-agent-core-rgj6hq15.js";
 import"./roy-agent-core-rm3hay00.js";
 import"./roy-agent-core-10n2jh7p.js";
@@ -21,6 +24,8 @@ init_workflow_json_output_plugin();
 
 export {
   unregisterWorkflowJsonOutputPlugin,
+  tracedRunWorkflowJsonOutputExtraction,
+  tracedExtractStructuredJsonViaLlm,
   runWorkflowJsonOutputExtraction,
   registerWorkflowJsonOutputPlugin,
   isWorkflowJsonOutputEnabled,

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

@@ -24,7 +24,8 @@ init_decorator();
 var logger = createLogger("agent:registry");
 var AgentConfigSchema = z.object({
   name: z.string(),
-  type: z.enum(["primary", "sub"]),
+  type: z.enum(["primary", "sub", "workflow"]),
+  workflow: z.string().optional(),
   description: z.string().optional(),
   systemPromptRef: z.string().optional(),
   systemPrompt: z.string().optional(),
@@ -37,7 +38,7 @@ var AgentConfigSchema = z.object({
   toolRetries: z.number().optional(),
   doomLoopThreshold: z.number().optional(),
   filterHistory: z.boolean().optional()
-});
+}).refine((data) => data.type !== "workflow" || data.workflow && data.workflow.length > 0, { message: "workflow is required when type is 'workflow'" });
 
 class AgentRegistry {
   agents = new Map;
@@ -78,6 +79,10 @@ class AgentRegistry {
     if (!agent.name) {
       throw new Error("Agent name is required");
     }
+    const validation = AgentConfigSchema.safeParse(agent);
+    if (!validation.success) {
+      throw new Error(`Invalid agent config for "${agent.name}": ${validation.error.issues.map((i) => i.message).join("; ")}`);
+    }
     this.agents.set(agent.name, { ...agent });
     logger.info(`[AgentRegistry] Registered agent: ${agent.name}`, { type: agent.type });
   }
@@ -133,6 +138,13 @@ class AgentRegistry {
     }
     return agent.systemPrompt;
   }
+  getWorkflowName(name) {
+    const agent = this.agents.get(name);
+    if (!agent || agent.type !== "workflow") {
+      return;
+    }
+    return agent.workflow;
+  }
   async load() {
     try {
       return await this.loadFromDirectory(this.configDir);
@@ -193,6 +205,11 @@ class AgentRegistry {
   }
   async saveAgent(agent) {
     try {
+      const validation = AgentConfigSchema.safeParse(agent);
+      if (!validation.success) {
+        logger.error(`[AgentRegistry] Invalid agent config for "${agent.name}": ${validation.error.message}`);
+        return false;
+      }
       await this.ensureConfigDir();
       const yamlContent = this.agentToYaml(agent);
       const filePath = join(this.configDir, `${agent.name}.yaml`);
@@ -226,7 +243,8 @@ class AgentRegistry {
       ...agent.toolTimeout !== undefined ? { toolTimeout: agent.toolTimeout } : {},
       ...agent.toolRetries !== undefined ? { toolRetries: agent.toolRetries } : {},
       ...agent.doomLoopThreshold !== undefined ? { doomLoopThreshold: agent.doomLoopThreshold } : {},
-      ...agent.filterHistory !== undefined ? { filterHistory: agent.filterHistory } : {}
+      ...agent.filterHistory !== undefined ? { filterHistory: agent.filterHistory } : {},
+      ...agent.workflow !== undefined ? { workflow: agent.workflow } : {}
     };
     return yaml.stringify(config).trimEnd() + `
 `;
@@ -282,6 +300,9 @@ __legacyDecorateClassTS([
 __legacyDecorateClassTS([
   TracedAs("agent.registry.getSystemPrompt", { recordParams: true, recordResult: true, log: true })
 ], AgentRegistry.prototype, "getSystemPrompt", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.registry.getWorkflowName", { recordParams: true, recordResult: true })
+], AgentRegistry.prototype, "getWorkflowName", null);
 __legacyDecorateClassTS([
   TracedAs("agent.registry.load", { recordParams: false, recordResult: true, log: true })
 ], AgentRegistry.prototype, "load", null);

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

@@ -0,0 +1,61 @@
+// src/env/mcp/npm-prefix/index.ts
+import fs from "fs";
+import { execSync } from "child_process";
+import os from "os";
+import path from "path";
+function pathExistsSync(p) {
+  try {
+    fs.accessSync(p, fs.constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getFallbackNpmPrefixPath() {
+  return path.join(os.homedir(), ".local", "share", "roy-agent", "npm-prefix");
+}
+function isUsableNpmPrefix(prefix) {
+  return pathExistsSync(path.join(prefix, "lib")) || pathExistsSync(path.join(prefix, "bin"));
+}
+function ensureNpmPrefixDirs(prefix) {
+  fs.mkdirSync(path.join(prefix, "lib"), { recursive: true });
+  fs.mkdirSync(path.join(prefix, "bin"), { recursive: true });
+}
+function ensureFallbackNpmPrefix() {
+  const fallback = getFallbackNpmPrefixPath();
+  ensureNpmPrefixDirs(fallback);
+  return fallback;
+}
+function readNpmConfigPrefix() {
+  try {
+    const prefix = execSync("npm config get prefix", {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    return prefix || undefined;
+  } catch {
+    return;
+  }
+}
+function resolveNpmPrefix() {
+  const candidates = [
+    process.env.NPM_CONFIG_PREFIX,
+    process.env.npm_config_prefix,
+    readNpmConfigPrefix(),
+    path.join(os.homedir(), ".npm-global")
+  ].filter(Boolean);
+  for (const prefix of candidates) {
+    if (isUsableNpmPrefix(prefix)) {
+      return prefix;
+    }
+  }
+  return ensureFallbackNpmPrefix();
+}
+function resolveGlobalNodeModulesPath() {
+  return path.join(resolveNpmPrefix(), "lib", "node_modules");
+}
+function resolveGlobalBinPath() {
+  return path.join(resolveNpmPrefix(), "bin");
+}
+
+export { getFallbackNpmPrefixPath, isUsableNpmPrefix, ensureNpmPrefixDirs, ensureFallbackNpmPrefix, readNpmConfigPrefix, resolveNpmPrefix, resolveGlobalNodeModulesPath, resolveGlobalBinPath };

package/dist/shared/@ai-setting/{roy-agent-core-8y804aat.js → roy-agent-core-jqq7c2rk.js}

@@ -1,9 +1,13 @@
 import {
   DEFAULT_SUBAGENT_PROMPT
-} from "./roy-agent-core-fg3j215p.js";
+} from "./roy-agent-core-emk3q2nt.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-92z6t4he.js";
+import {
+  TracedAs,
+  init_decorator
+} from "./roy-agent-core-q5qj0fes.js";
 import {
   globalHookManager,
   init_global_hook_manager
@@ -12,9 +16,13 @@ import {
   createLogger,
   init_logger
 } from "./roy-agent-core-10n2jh7p.js";
+import {
+  __legacyDecorateClassTS
+} from "./roy-agent-core-fs0mn2jk.js";
 
 // src/env/task/delegate/delegate-tool.ts
 init_logger();
+init_decorator();
 import { z } from "zod";
 
 // src/env/task/delegate/subagent-resolver.ts
@@ -65,8 +73,14 @@ ${customAgentNote}
 }
 function listKnownSubagentDescriptions(registry) {
   const builtInLines = builtInSubAgents.map((agent) => `- ${agent.id}: ${agent.description}`);
-  const registryAgents = registry?.listAgentsByType("sub") ?? [];
-  const customLines = registryAgents.filter((agent) => !builtInSubAgents.some((builtIn) => builtIn.id === agent.name)).map((agent) => `- ${agent.name}: ${agent.description || "Custom agent"}`);
+  const registryAgents = registry?.list() ?? [];
+  const customLines = registryAgents.filter((agent) => !builtInSubAgents.some((builtIn) => builtIn.id === agent.name)).map((agent) => {
+    if (agent.type === "workflow") {
+      const workflowInfo = agent.workflow ? ` (workflow: ${agent.workflow})` : "";
+      return `- ${agent.name}: ${agent.description || "Workflow agent"}${workflowInfo}`;
+    }
+    return `- ${agent.name}: ${agent.description || "Custom agent"}`;
+  });
   const lines = [...builtInLines, ...customLines];
   const guidance = buildAgentSelectionGuide({ hasCustomAgents: customLines.length > 0 });
   return lines.join(`
@@ -163,6 +177,14 @@ function getSubAgentSpec(id) {
   return builtInSubAgents.find((agent) => agent.id === id);
 }
 function ensureSubAgentRegistered(agentComponent, subagentType, basePrompt, subAgent, deniedTools) {
+  const registry = agentComponent.getRegistry?.();
+  if (registry) {
+    const agentDef = registry.get(subagentType);
+    if (agentDef?.type === "workflow") {
+      logger.debug(`[delegate] Skipping registration for workflow agent: ${subagentType}`);
+      return null;
+    }
+  }
   let agentInstance = agentComponent.getAgent(subagentType);
   if (!agentInstance) {
     const agentConfig = {
@@ -444,6 +466,8 @@ ${prompt}
       deniedTools
     } : undefined;
     ensureSubAgentRegistered(agentComponent, subagentType, basePrompt, subAgentForRegister, deniedTools);
+    const isWorkflowAgent = registry?.get(subagentType)?.type === "workflow";
+    const delegateQuery = isWorkflowAgent ? prompt : fullPrompt;
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => {
         reject(new Error(`Task execution timeout after ${timeoutMs}ms`));
@@ -452,7 +476,7 @@ ${prompt}
         clearTimeout(timer);
         reject(new Error("Task execution stopped"));
       });
-      this.env.handle_query?.(fullPrompt, {
+      this.env.handle_query?.(delegateQuery, {
         sessionId,
         deniedTools: deniedTools.length > 0 ? deniedTools : undefined,
         agentType: subagentType
@@ -509,6 +533,9 @@ ${prompt}
     logger.info(`[BackgroundTaskManager] Disposed`);
   }
 }
+__legacyDecorateClassTS([
+  TracedAs("delegate.executeWithAbort", { recordParams: true, recordResult: true, log: true })
+], BackgroundTaskManager.prototype, "executeWithAbort", null);
 function getAgentRegistry(taskComponent) {
   const agentComponent = taskComponent.env?.getComponent?.("agent");
   return agentComponent?.getRegistry?.();
@@ -675,11 +702,13 @@ ${prompt}
       deniedTools
     } : undefined;
     ensureSubAgentRegistered(agentComponent, subagentType, basePrompt, subAgentForRegister, deniedTools);
+    const isWorkflowAgent = registry?.get(subagentType)?.type === "workflow";
+    const delegateQuery = isWorkflowAgent ? prompt : fullPrompt;
     const timeoutMs = timeout || DEFAULT_TIMEOUT;
     let result;
     try {
       result = await Promise.race([
-        taskComponent.env?.handle_query?.(fullPrompt, {
+        taskComponent.env?.handle_query?.(delegateQuery, {
           sessionId: subSession.id,
           deniedTools: deniedTools.length > 0 ? deniedTools : undefined,
           agentType: subagentType

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

@@ -8,6 +8,10 @@ import {
   AskUserError,
   init_workflow_hil
 } from "./roy-agent-core-e25xkv53.js";
+import {
+  init_decorator,
+  wrapFunction
+} from "./roy-agent-core-q5qj0fes.js";
 import {
   globalHookManager,
   init_global_hook_manager
@@ -57,7 +61,7 @@ function registerWorkflowJsonOutputPlugin(llmComponent) {
     description: "Extract structured JSON after ReAct via a dedicated LLM invoke",
     execute: async (wrapper) => {
       const hookCtx = wrapper.data;
-      await runWorkflowJsonOutputExtraction(hookCtx, llmComponent);
+      await tracedRunWorkflowJsonOutputExtraction(hookCtx, llmComponent);
     }
   });
   logger.info("Workflow JSON output plugin registered on agent:after.react");
@@ -175,16 +179,19 @@ function toLLMMessage(msg) {
   }
   return { role: msg.role, content: "" };
 }
-var logger, WORKFLOW_JSON_OUTPUT_SOURCE_ID = "workflow", WORKFLOW_JSON_OUTPUT_PLUGIN_NAME = "json-output", WORKFLOW_JSON_OUTPUT_PLUGIN_KEY, HOOK_POINT = "agent:after.react", HOOK_NAME, registered = false;
+var logger, WORKFLOW_JSON_OUTPUT_SOURCE_ID = "workflow", WORKFLOW_JSON_OUTPUT_PLUGIN_NAME = "json-output", WORKFLOW_JSON_OUTPUT_PLUGIN_KEY, HOOK_POINT = "agent:after.react", HOOK_NAME, registered = false, tracedRunWorkflowJsonOutputExtraction, tracedExtractStructuredJsonViaLlm;
 var init_workflow_json_output_plugin = __esm(() => {
   init_global_hook_manager();
   init_workflow_hil();
   init_submit_json_output_tool();
   init_output_schema_hint();
   init_logger();
+  init_decorator();
   logger = createLogger("WorkflowJsonOutputPlugin");
   WORKFLOW_JSON_OUTPUT_PLUGIN_KEY = `${WORKFLOW_JSON_OUTPUT_SOURCE_ID}:${WORKFLOW_JSON_OUTPUT_PLUGIN_NAME}`;
   HOOK_NAME = `${WORKFLOW_JSON_OUTPUT_PLUGIN_NAME}:${HOOK_POINT}`;
+  tracedRunWorkflowJsonOutputExtraction = wrapFunction(runWorkflowJsonOutputExtraction, "workflow.json_output.extraction", { recordParams: true, recordResult: true, log: true });
+  tracedExtractStructuredJsonViaLlm = wrapFunction(extractStructuredJsonViaLlm, "workflow.json_output.extract_via_llm", { recordParams: false, recordResult: true, log: true });
 });
 
-export { WORKFLOW_JSON_OUTPUT_SOURCE_ID, WORKFLOW_JSON_OUTPUT_PLUGIN_NAME, WORKFLOW_JSON_OUTPUT_PLUGIN_KEY, isWorkflowJsonOutputEnabled, registerWorkflowJsonOutputPlugin, unregisterWorkflowJsonOutputPlugin, runWorkflowJsonOutputExtraction, extractStructuredJsonViaLlm, init_workflow_json_output_plugin };
+export { WORKFLOW_JSON_OUTPUT_SOURCE_ID, WORKFLOW_JSON_OUTPUT_PLUGIN_NAME, WORKFLOW_JSON_OUTPUT_PLUGIN_KEY, isWorkflowJsonOutputEnabled, registerWorkflowJsonOutputPlugin, unregisterWorkflowJsonOutputPlugin, runWorkflowJsonOutputExtraction, extractStructuredJsonViaLlm, tracedRunWorkflowJsonOutputExtraction, tracedExtractStructuredJsonViaLlm, init_workflow_json_output_plugin };