@ai-setting/roy-agent-core 1.5.42 → 1.5.43

package/dist/env/agent/index.js

@@ -1,9 +1,9 @@
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../../shared/@ai-setting/roy-agent-core-ek6gk3wk.js";
+} from "../../shared/@ai-setting/roy-agent-core-r6rwsr54.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-7t05apnp.js";
+import"../../shared/@ai-setting/roy-agent-core-fg3j215p.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

@@ -34,14 +34,14 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-ek6gk3wk.js";
+} from "../shared/@ai-setting/roy-agent-core-r6rwsr54.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-9q6sa7m3.js";
-import"../shared/@ai-setting/roy-agent-core-xz22rmak.js";
+} from "../shared/@ai-setting/roy-agent-core-1zq3p19q.js";
+import"../shared/@ai-setting/roy-agent-core-9p43ap7h.js";
 import"../shared/@ai-setting/roy-agent-core-hsxn8m1j.js";
-import"../shared/@ai-setting/roy-agent-core-7t05apnp.js";
+import"../shared/@ai-setting/roy-agent-core-fg3j215p.js";
 import {
   XDG_PATHS,
   getXDGPath,

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

@@ -3,10 +3,11 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-xz22rmak.js";
-import"../../../shared/@ai-setting/roy-agent-core-7t05apnp.js";
+} from "../../../shared/@ai-setting/roy-agent-core-9p43ap7h.js";
+import"../../../shared/@ai-setting/roy-agent-core-fg3j215p.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";
 import"../../../shared/@ai-setting/roy-agent-core-jqy2mdyq.js";
 import"../../../shared/@ai-setting/roy-agent-core-z33en0cz.js";
 import"../../../shared/@ai-setting/roy-agent-core-10n2jh7p.js";

package/dist/env/task/index.js

@@ -4,12 +4,12 @@ import {
   TaskConfigSchema,
   TaskPriorityEnum,
   TaskStatusEnum
-} from "../../shared/@ai-setting/roy-agent-core-9q6sa7m3.js";
-import"../../shared/@ai-setting/roy-agent-core-xz22rmak.js";
+} from "../../shared/@ai-setting/roy-agent-core-1zq3p19q.js";
+import"../../shared/@ai-setting/roy-agent-core-9p43ap7h.js";
 import {
   SQLiteTaskStore
 } from "../../shared/@ai-setting/roy-agent-core-hsxn8m1j.js";
-import"../../shared/@ai-setting/roy-agent-core-7t05apnp.js";
+import"../../shared/@ai-setting/roy-agent-core-fg3j215p.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/index.js

@@ -114,19 +114,19 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-ek6gk3wk.js";
+} from "./shared/@ai-setting/roy-agent-core-r6rwsr54.js";
 import {
   AskUserError,
   init_workflow_hil
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-9q6sa7m3.js";
-import"./shared/@ai-setting/roy-agent-core-xz22rmak.js";
+} from "./shared/@ai-setting/roy-agent-core-1zq3p19q.js";
+import"./shared/@ai-setting/roy-agent-core-9p43ap7h.js";
 import"./shared/@ai-setting/roy-agent-core-hsxn8m1j.js";
 import {
   AgentRegistry
-} from "./shared/@ai-setting/roy-agent-core-7t05apnp.js";
+} from "./shared/@ai-setting/roy-agent-core-fg3j215p.js";
 import {
   XDG_PATHS,
   getXDGPath,

package/dist/shared/@ai-setting/{roy-agent-core-9q6sa7m3.js → roy-agent-core-1zq3p19q.js}

@@ -2,7 +2,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-xz22rmak.js";
+} from "./roy-agent-core-9p43ap7h.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

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

@@ -1,6 +1,6 @@
 import {
   DEFAULT_SUBAGENT_PROMPT
-} from "./roy-agent-core-7t05apnp.js";
+} from "./roy-agent-core-fg3j215p.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-92z6t4he.js";
@@ -53,13 +53,23 @@ async function resolveFromRegistry(subagentType, agentDef, builtIn, registry) {
     fromRegistry: true
   };
 }
+function buildAgentSelectionGuide(options) {
+  const customAgentNote = options.hasCustomAgents ? "- Custom agents from AgentRegistry are listed above." : "- Custom agents from AgentRegistry appear above when registered.";
+  return `
+## Agent Selection Guide
+
+- Choose \`subagent_type\` from the list above; use \`general\` when no specialized agent fits (default).
+${customAgentNote}
+- For full metadata: \`roy-agent agents list\`, \`roy-agent agents get <name>\`, \`roy-agent prompt list\`.`;
+}
 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 lines = [...builtInLines, ...customLines];
+  const guidance = buildAgentSelectionGuide({ hasCustomAgents: customLines.length > 0 });
   return lines.join(`
-`);
+`) + guidance;
 }
 
 // src/env/task/delegate/delegate-tool.ts
@@ -497,16 +507,21 @@ ${prompt}
     logger.info(`[BackgroundTaskManager] Disposed`);
   }
 }
+function getAgentRegistry(taskComponent) {
+  const agentComponent = taskComponent.env?.getComponent?.("agent");
+  return agentComponent?.getRegistry?.();
+}
 function createDelegateTool(taskComponent) {
   const env = taskComponent.env;
   const backgroundTaskManager = new BackgroundTaskManager(env);
+  const registry = getAgentRegistry(taskComponent);
   taskComponent._backgroundTaskManager = backgroundTaskManager;
   const tool = {
     name: "delegate_task",
     description: `Launch a new sub-agent to handle complex, multistep tasks autonomously.
 
 Available agent types:
-${listKnownSubagentDescriptions()}
+${listKnownSubagentDescriptions(registry)}
 
 When using the delegate_task tool, you must specify a subagent_type parameter to select which agent type to use.
 
@@ -533,9 +548,8 @@ When using the delegate_task tool, you must specify a subagent_type parameter to
       const { description, prompt, subagent_type = "general", background = false, timeout, cleanup, task_id, reason } = params;
       const parentSessionId = ctx.session_id || "default";
       logger.info(`[delegate_task] Called: description=${description}, subagent_type=${subagent_type}, background=${background}, task_id=${task_id}`);
-      const agentComponent = taskComponent.env?.getComponent?.("agent");
-      const registry = agentComponent?.getRegistry?.();
-      if (!isKnownSubagentType(subagent_type, registry)) {
+      const registry2 = getAgentRegistry(taskComponent);
+      if (!isKnownSubagentType(subagent_type, registry2)) {
         return {
           success: false,
           output: "",
@@ -616,7 +630,7 @@ async function handleSyncTask(taskComponent, parentSessionId, description, promp
       };
     }
     const agentComponent = taskComponent.env?.getComponent?.("agent");
-    const registry = agentComponent?.getRegistry?.();
+    const registry = getAgentRegistry(taskComponent);
     const resolved = await resolveSubAgentConfig(subagentType, { registry });
     const subAgent = getSubAgentSpec(subagentType);
     let basePrompt = resolved?.basePrompt || subAgent?.promptOverride || `You are a subagent. Complete this task: {task_description}`;

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

@@ -1,10 +1,17 @@
 import {
   getXDGPath
 } from "./roy-agent-core-qxnbvgwe.js";
+import {
+  TracedAs,
+  init_decorator
+} from "./roy-agent-core-q5qj0fes.js";
 import {
   createLogger,
   init_logger
 } from "./roy-agent-core-10n2jh7p.js";
+import {
+  __legacyDecorateClassTS
+} from "./roy-agent-core-fs0mn2jk.js";
 
 // src/env/agent/agent-registry.ts
 import { readdir, readFile, writeFile, mkdir, unlink } from "fs/promises";
@@ -13,6 +20,7 @@ import { join } from "path";
 import { z } from "zod";
 import yaml from "yaml";
 init_logger();
+init_decorator();
 var logger = createLogger("agent:registry");
 var AgentConfigSchema = z.object({
   name: z.string(),
@@ -262,6 +270,24 @@ class AgentRegistry {
     return join(this.configDir, `${name}.yaml`);
   }
 }
+__legacyDecorateClassTS([
+  TracedAs("agent.registry.register", { recordParams: true, recordResult: true, log: true })
+], AgentRegistry.prototype, "register", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.registry.unregister", { recordParams: true, recordResult: true, log: true })
+], AgentRegistry.prototype, "unregister", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.registry.clear", { recordParams: false, recordResult: true, log: true })
+], AgentRegistry.prototype, "clear", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.registry.getSystemPrompt", { recordParams: true, recordResult: true, log: true })
+], AgentRegistry.prototype, "getSystemPrompt", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.registry.load", { recordParams: false, recordResult: true, log: true })
+], AgentRegistry.prototype, "load", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.registry.loadFromDirectory", { recordParams: true, recordResult: true, log: true })
+], AgentRegistry.prototype, "loadFromDirectory", null);
 function isAgentConfigFile(fileName) {
   return fileName.endsWith(".yaml") || fileName.endsWith(".yml");
 }

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

@@ -4,7 +4,7 @@ import {
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-7t05apnp.js";
+} from "./roy-agent-core-fg3j215p.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";
@@ -290,6 +290,7 @@ class AgentComponent extends BaseComponent {
           this.registerAgent(agentDef.name, {
             type: agentDef.type,
             systemPrompt,
+            systemPromptRef: agentDef.systemPromptRef,
             allowedTools: agentDef.allowedTools,
             deniedTools: agentDef.deniedTools,
             model: agentDef.model,
@@ -310,11 +311,17 @@ class AgentComponent extends BaseComponent {
       const systemPrompt = await this.registry.getSystemPrompt(agentDef.name);
       const existing = this.agents.get(agentDef.name);
       if (existing) {
-        existing.config.systemPrompt = systemPrompt;
+        if (systemPrompt !== undefined) {
+          existing.config.systemPrompt = systemPrompt;
+        }
+        if (agentDef.systemPromptRef) {
+          existing.config.systemPromptRef = agentDef.systemPromptRef;
+        }
       } else {
         this.registerAgent(agentDef.name, {
           type: agentDef.type,
           systemPrompt,
+          systemPromptRef: agentDef.systemPromptRef,
           allowedTools: agentDef.allowedTools,
           deniedTools: agentDef.deniedTools,
           model: agentDef.model,
@@ -363,6 +370,27 @@ class AgentComponent extends BaseComponent {
       });
     }
   }
+  async resolveSystemPrompt(agent, agentName) {
+    if (agent.config.systemPrompt) {
+      return;
+    }
+    if (!agent.config.systemPromptRef) {
+      return;
+    }
+    if (!this.registry) {
+      logger.debug(`[resolveSystemPrompt] No registry available for ${agentName}`);
+      return;
+    }
+    try {
+      const resolvedPrompt = await this.registry.getSystemPrompt(agentName);
+      if (resolvedPrompt) {
+        agent.config.systemPrompt = resolvedPrompt;
+        logger.debug(`[AgentComponent] Resolved systemPrompt for agent: ${agentName}`);
+      }
+    } catch (error) {
+      logger.warn(`[AgentComponent] Failed to resolve systemPrompt for agent ${agentName}: ${error}`);
+    }
+  }
   getAgent(agentName) {
     return this.agents.get(agentName);
   }
@@ -393,7 +421,8 @@ class AgentComponent extends BaseComponent {
       doomLoopThreshold: config.doomLoopThreshold ?? this.config.defaultAgent.doomLoopThreshold,
       toolTimeout: config.toolTimeout ?? this.config.defaultAgent.toolTimeout,
       toolRetries: config.toolRetries ?? this.config.defaultAgent.toolRetries,
-      systemPrompt: config.systemPrompt ?? this.config.defaultAgent.systemPrompt,
+      systemPrompt: config.systemPrompt ?? (config.systemPromptRef ? undefined : this.config.defaultAgent.systemPrompt),
+      systemPromptRef: config.systemPromptRef,
       model: config.model ?? this.config.defaultAgent.model,
       behaviorSpecId: config.behaviorSpecId ?? this.config.defaultAgent.behaviorSpecId,
       allowedTools: config.allowedTools ?? this.config.defaultAgent.allowedTools,
@@ -495,6 +524,7 @@ class AgentComponent extends BaseComponent {
     if (!this.doomLoopCaches.has(runId)) {
       this.doomLoopCaches.set(runId, new Map);
     }
+    await this.resolveSystemPrompt(agent, agentName);
     const effectiveContext = {
       ...context,
       agentType: agent.config.type,
@@ -1200,6 +1230,15 @@ ${ctx.context.additionInfo}`
     return messages;
   }
 }
+__legacyDecorateClassTS([
+  TracedAs("agent.component.initRegistry", { recordParams: true, recordResult: true, log: true })
+], AgentComponent.prototype, "initRegistry", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.component.syncRegistryAgentsFromConfig", { recordParams: false, recordResult: true, log: true })
+], AgentComponent.prototype, "syncRegistryAgentsFromConfig", null);
+__legacyDecorateClassTS([
+  TracedAs("agent.component.resolveSystemPrompt", { recordParams: true, recordResult: true, log: true })
+], AgentComponent.prototype, "resolveSystemPrompt", null);
 __legacyDecorateClassTS([
   TracedAs("agent.component.run", { recordParams: true, recordResult: true, log: true })
 ], AgentComponent.prototype, "_run", null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.5.42",
+  "version": "1.5.43",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",