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

package/dist/env/agent/index.js

@@ -1,9 +1,9 @@
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../../shared/@ai-setting/roy-agent-core-3t82jyqb.js";
+} from "../../shared/@ai-setting/roy-agent-core-38sc085e.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-fg3j215p.js";
+import"../../shared/@ai-setting/roy-agent-core-emk3q2nt.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import {

package/dist/env/index.js

@@ -1,6 +1,6 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-r9hq4cjx.js";
+} from "../shared/@ai-setting/roy-agent-core-a23brrex.js";
 import {
   EventSourceComponent,
   builtInHandlers,
@@ -21,11 +21,11 @@ import"../shared/@ai-setting/roy-agent-core-4gmxjdhn.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-frjr619w.js";
+} from "../shared/@ai-setting/roy-agent-core-1t5esk1r.js";
 import"../shared/@ai-setting/roy-agent-core-9bmtxmp6.js";
-import"../shared/@ai-setting/roy-agent-core-btvxttqf.js";
-import"../shared/@ai-setting/roy-agent-core-44g4dhzg.js";
-import"../shared/@ai-setting/roy-agent-core-dbxm76wf.js";
+import"../shared/@ai-setting/roy-agent-core-1rzpnycm.js";
+import"../shared/@ai-setting/roy-agent-core-2rtka82a.js";
+import"../shared/@ai-setting/roy-agent-core-kzbj10gk.js";
 import"../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../shared/@ai-setting/roy-agent-core-v002ynpa.js";
 import"../shared/@ai-setting/roy-agent-core-4t40mkpv.js";
@@ -38,15 +38,15 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-3t82jyqb.js";
+} from "../shared/@ai-setting/roy-agent-core-38sc085e.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-6z063hns.js";
+} from "../shared/@ai-setting/roy-agent-core-t1ytby5n.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-8y804aat.js";
+import"../shared/@ai-setting/roy-agent-core-jqq7c2rk.js";
 import"../shared/@ai-setting/roy-agent-core-hsxn8m1j.js";
-import"../shared/@ai-setting/roy-agent-core-fg3j215p.js";
+import"../shared/@ai-setting/roy-agent-core-emk3q2nt.js";
 import {
   XDG_PATHS,
   getXDGPath,

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

@@ -3,8 +3,8 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-8y804aat.js";
-import"../../../shared/@ai-setting/roy-agent-core-fg3j215p.js";
+} from "../../../shared/@ai-setting/roy-agent-core-jqq7c2rk.js";
+import"../../../shared/@ai-setting/roy-agent-core-emk3q2nt.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import"../../../shared/@ai-setting/roy-agent-core-q5qj0fes.js";

package/dist/env/task/index.js

@@ -4,15 +4,15 @@ import {
   TaskConfigSchema,
   TaskPriorityEnum,
   TaskStatusEnum
-} from "../../shared/@ai-setting/roy-agent-core-6z063hns.js";
+} from "../../shared/@ai-setting/roy-agent-core-t1ytby5n.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-8y804aat.js";
+import"../../shared/@ai-setting/roy-agent-core-jqq7c2rk.js";
 import {
   SQLiteTaskStore
 } from "../../shared/@ai-setting/roy-agent-core-hsxn8m1j.js";
-import"../../shared/@ai-setting/roy-agent-core-fg3j215p.js";
+import"../../shared/@ai-setting/roy-agent-core-emk3q2nt.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-wa1kzqky.js";
 import"../../shared/@ai-setting/roy-agent-core-t94ktchq.js";

package/dist/env/workflow/engine/index.js

@@ -6,9 +6,9 @@ import {
   Scheduler,
   WorkflowEngine,
   init_engine
-} from "../../../shared/@ai-setting/roy-agent-core-btvxttqf.js";
-import"../../../shared/@ai-setting/roy-agent-core-44g4dhzg.js";
-import"../../../shared/@ai-setting/roy-agent-core-dbxm76wf.js";
+} from "../../../shared/@ai-setting/roy-agent-core-1rzpnycm.js";
+import"../../../shared/@ai-setting/roy-agent-core-2rtka82a.js";
+import"../../../shared/@ai-setting/roy-agent-core-kzbj10gk.js";
 import"../../../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../../../shared/@ai-setting/roy-agent-core-v002ynpa.js";
 import"../../../shared/@ai-setting/roy-agent-core-6vxg2gmr.js";

package/dist/env/workflow/index.js

@@ -1,10 +1,10 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-frjr619w.js";
+} from "../../shared/@ai-setting/roy-agent-core-1t5esk1r.js";
 import"../../shared/@ai-setting/roy-agent-core-9bmtxmp6.js";
-import"../../shared/@ai-setting/roy-agent-core-btvxttqf.js";
-import"../../shared/@ai-setting/roy-agent-core-44g4dhzg.js";
-import"../../shared/@ai-setting/roy-agent-core-dbxm76wf.js";
+import"../../shared/@ai-setting/roy-agent-core-1rzpnycm.js";
+import"../../shared/@ai-setting/roy-agent-core-2rtka82a.js";
+import"../../shared/@ai-setting/roy-agent-core-kzbj10gk.js";
 import"../../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../../shared/@ai-setting/roy-agent-core-v002ynpa.js";
 import"../../shared/@ai-setting/roy-agent-core-4t40mkpv.js";

package/dist/index.js

@@ -61,7 +61,7 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-r9hq4cjx.js";
+} from "./shared/@ai-setting/roy-agent-core-a23brrex.js";
 import {
   EventSourceComponent,
   builtInHandlers,
@@ -92,14 +92,14 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "./shared/@ai-setting/roy-agent-core-frjr619w.js";
+} from "./shared/@ai-setting/roy-agent-core-1t5esk1r.js";
 import {
   init_node_registry_helper,
   registerDecoratorNodeType
 } from "./shared/@ai-setting/roy-agent-core-9bmtxmp6.js";
-import"./shared/@ai-setting/roy-agent-core-btvxttqf.js";
-import"./shared/@ai-setting/roy-agent-core-44g4dhzg.js";
-import"./shared/@ai-setting/roy-agent-core-dbxm76wf.js";
+import"./shared/@ai-setting/roy-agent-core-1rzpnycm.js";
+import"./shared/@ai-setting/roy-agent-core-2rtka82a.js";
+import"./shared/@ai-setting/roy-agent-core-kzbj10gk.js";
 import"./shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"./shared/@ai-setting/roy-agent-core-v002ynpa.js";
 import"./shared/@ai-setting/roy-agent-core-4t40mkpv.js";
@@ -118,20 +118,20 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-3t82jyqb.js";
+} from "./shared/@ai-setting/roy-agent-core-38sc085e.js";
 import {
   AskUserError,
   init_workflow_hil
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-6z063hns.js";
+} from "./shared/@ai-setting/roy-agent-core-t1ytby5n.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-8y804aat.js";
+import"./shared/@ai-setting/roy-agent-core-jqq7c2rk.js";
 import"./shared/@ai-setting/roy-agent-core-hsxn8m1j.js";
 import {
   AgentRegistry
-} from "./shared/@ai-setting/roy-agent-core-fg3j215p.js";
+} from "./shared/@ai-setting/roy-agent-core-emk3q2nt.js";
 import {
   XDG_PATHS,
   getXDGPath,

package/dist/shared/@ai-setting/{roy-agent-core-btvxttqf.js → roy-agent-core-1rzpnycm.js}

@@ -1,7 +1,7 @@
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-44g4dhzg.js";
+} from "./roy-agent-core-2rtka82a.js";
 import {
   buildWorkflowNodeMetadata,
   getWorkflowNodeIdFromMetadata,
@@ -1136,6 +1136,7 @@ function extractAgentJsonOutput(agentResult, schema) {
   const candidates = [
     agentResult.structuredOutput,
     asRecord(agentResult.output),
+    extractFromOutputText(agentResult.output),
     extractFromToolCalls(agentResult),
     extractFromMessages(agentResult.messages)
   ];
@@ -1153,6 +1154,66 @@ function asRecord(value) {
   }
   return;
 }
+function extractFromOutputText(output) {
+  if (typeof output !== "string" || !output.trim()) {
+    return;
+  }
+  const trimmed = output.trim();
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+  } catch {}
+  const jsonBlockMatch = trimmed.match(/```(?:json)?\s*\n?(\{[\s\S]*?\})\n?\s*```/);
+  if (jsonBlockMatch) {
+    try {
+      const parsed = JSON.parse(jsonBlockMatch[1]);
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        return parsed;
+      }
+    } catch {}
+  }
+  for (let i = 0;i < trimmed.length; i++) {
+    if (trimmed[i] !== "{")
+      continue;
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let j = i;j < trimmed.length; j++) {
+      const ch = trimmed[j];
+      if (escape) {
+        escape = false;
+        continue;
+      }
+      if (ch === "\\" && inString) {
+        escape = true;
+        continue;
+      }
+      if (ch === '"') {
+        inString = !inString;
+        continue;
+      }
+      if (inString)
+        continue;
+      if (ch === "{")
+        depth++;
+      else if (ch === "}")
+        depth--;
+      if (depth === 0) {
+        const candidate = trimmed.slice(i, j + 1);
+        try {
+          const parsed = JSON.parse(candidate);
+          if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+          }
+        } catch {}
+        break;
+      }
+    }
+  }
+  return;
+}
 function extractFromToolCalls(agentResult) {
   const toolCalls = agentResult.metadata?.toolCallsDetail;
   if (!toolCalls?.length) {
@@ -1216,7 +1277,18 @@ function buildAgentNodeOutput(agentResult, outputConfig) {
     const schema = outputConfig.schema;
     const jsonData = extractAgentJsonOutput(agentResult, schema);
     if (!jsonData) {
-      throw new Error("AgentNode json output mode requires structured JSON from workflow_submit_output");
+      const defaults = buildSchemaDefaults(schema);
+      const fallbackData = { ...defaults, rawOutput: agentResult.output };
+      return {
+        result: fallbackData,
+        ...fallbackData,
+        metadata: {
+          ...agentResult.metadata,
+          outputMode: "json_fallback",
+          _extractionWarning: "JSON extraction failed, using defaults"
+        },
+        workflowHistory: agentResult.messages
+      };
     }
     return {
       result: jsonData,
@@ -1233,6 +1305,31 @@ function buildAgentNodeOutput(agentResult, outputConfig) {
     ...base
   };
 }
+function buildSchemaDefaults(schema) {
+  const defaults = {};
+  if (!schema?.properties || !schema?.required)
+    return defaults;
+  for (const key of schema.required) {
+    const prop = schema.properties[key];
+    if (!prop?.type)
+      continue;
+    switch (prop.type) {
+      case "boolean":
+        defaults[key] = false;
+        break;
+      case "string":
+        defaults[key] = "";
+        break;
+      case "number":
+      case "integer":
+        defaults[key] = 0;
+        break;
+      default:
+        defaults[key] = null;
+    }
+  }
+  return defaults;
+}
 var init_build_agent_node_output = __esm(() => {
   init_extract_agent_json_output();
 });
@@ -1292,7 +1389,7 @@ var init_agent_node = __esm(() => {
             await context.attachAgentSessionToLastStart(this.definition.id, agentSessionId);
           }
         }
-        const allowedTools = ["ask_user"];
+        const allowedTools = options.allowedTools?.length ? options.allowedTools : ["ask_user"];
         const agentConfig = {
           type: agentType,
           prompt: resolvedPrompt,

package/dist/shared/@ai-setting/{roy-agent-core-frjr619w.js → roy-agent-core-1t5esk1r.js}

@@ -6,7 +6,7 @@ import {
   WorkflowEngine,
   exports_engine,
   init_engine
-} from "./roy-agent-core-btvxttqf.js";
+} from "./roy-agent-core-1rzpnycm.js";
 import {
   WorkflowService
 } from "./roy-agent-core-4t40mkpv.js";
@@ -136,7 +136,7 @@ class WorkflowComponent extends BaseComponent {
       const agentComponent = this._workflowEnv.getComponent("agent");
       const llmComponent = this._workflowEnv.getComponent("llm");
       if (agentComponent) {
-        const { AgentComponentAdapter } = await import("./roy-agent-core-ye0z728h.js");
+        const { AgentComponentAdapter } = await import("./roy-agent-core-twd8kzag.js");
         agentRunner = new AgentComponentAdapter(agentComponent, {}, this.sessionComponent, llmComponent);
       }
     }
@@ -208,7 +208,7 @@ class WorkflowComponent extends BaseComponent {
       const sessionComponent = this._workflowEnv?.getComponent("session");
       componentLogger.info(`initSqliteService - toolComponent: ${!!toolComponent}, llmComponent: ${!!llmComponent}, skillRegistry: ${!!skillComponent}, sessionComponent: ${!!sessionComponent}`);
       if (llmComponent) {
-        const { registerWorkflowJsonOutputPlugin } = await import("./roy-agent-core-68qy97r3.js");
+        const { registerWorkflowJsonOutputPlugin } = await import("./roy-agent-core-ebap34m2.js");
         registerWorkflowJsonOutputPlugin(llmComponent);
       }
       this.createService({

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-3t82jyqb.js → roy-agent-core-38sc085e.js}

@@ -4,7 +4,7 @@ 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";
@@ -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-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 };

package/dist/shared/@ai-setting/{roy-agent-core-6z063hns.js → roy-agent-core-t1ytby5n.js}

@@ -5,7 +5,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-8y804aat.js";
+} from "./roy-agent-core-jqq7c2rk.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

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

@@ -1,10 +1,11 @@
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-44g4dhzg.js";
-import"./roy-agent-core-dbxm76wf.js";
+} from "./roy-agent-core-2rtka82a.js";
+import"./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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.5.46",
+  "version": "1.5.47",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",
@@ -83,4 +83,4 @@
   "bugs": {
     "url": "https://github.com/ai-setting/roy-agent/issues"
   }
-}
+}