@ai-setting/roy-agent-core 1.5.73 → 1.5.75

package/dist/env/agent/index.js

@@ -1,10 +1,10 @@
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../../shared/@ai-setting/roy-agent-core-9dja7n0q.js";
-import"../../shared/@ai-setting/roy-agent-core-3f0bkm7q.js";
+} from "../../shared/@ai-setting/roy-agent-core-w6j4zyps.js";
+import"../../shared/@ai-setting/roy-agent-core-r0m0at3x.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../shared/@ai-setting/roy-agent-core-nx3c3ce2.js";
+import"../../shared/@ai-setting/roy-agent-core-zf62vkc4.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import {

package/dist/env/commands/index.js

@@ -1,6 +1,6 @@
 import {
   CommandsComponent
-} from "../../shared/@ai-setting/roy-agent-core-7wdjpbcr.js";
+} from "../../shared/@ai-setting/roy-agent-core-3952rkj0.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
 import"../../shared/@ai-setting/roy-agent-core-rgckng3p.js";
 import"../../shared/@ai-setting/roy-agent-core-b8r4tfqq.js";

package/dist/env/event-source/index.js

@@ -4,7 +4,7 @@ import {
   builtInHandlers,
   getBuiltInHandler,
   larkCliHandler
-} from "../../shared/@ai-setting/roy-agent-core-w4tqc9m1.js";
+} from "../../shared/@ai-setting/roy-agent-core-f9xyqx9s.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -15,7 +15,7 @@ import {
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-xb4hvk1m.js";
 import"../../shared/@ai-setting/roy-agent-core-v8xa6vs8.js";
-import"../../shared/@ai-setting/roy-agent-core-xp8xrxgc.js";
+import"../../shared/@ai-setting/roy-agent-core-r12a2qfv.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";

package/dist/env/index.js

@@ -1,11 +1,11 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-zm86k3rg.js";
+} from "../shared/@ai-setting/roy-agent-core-gb9rb9ny.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-w4tqc9m1.js";
+} from "../shared/@ai-setting/roy-agent-core-f9xyqx9s.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -16,8 +16,8 @@ import {
 import"../shared/@ai-setting/roy-agent-core-v8xa6vs8.js";
 import {
   PluginComponent
-} from "../shared/@ai-setting/roy-agent-core-p7grnnzp.js";
-import"../shared/@ai-setting/roy-agent-core-xp8xrxgc.js";
+} from "../shared/@ai-setting/roy-agent-core-t1ef8hf2.js";
+import"../shared/@ai-setting/roy-agent-core-r12a2qfv.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
@@ -39,16 +39,16 @@ import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-9dja7n0q.js";
-import"../shared/@ai-setting/roy-agent-core-3f0bkm7q.js";
+} from "../shared/@ai-setting/roy-agent-core-w6j4zyps.js";
+import"../shared/@ai-setting/roy-agent-core-r0m0at3x.js";
 import"../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-84vtpbw6.js";
+} from "../shared/@ai-setting/roy-agent-core-11dnsfwp.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-eq52jra7.js";
+import"../shared/@ai-setting/roy-agent-core-0tgnq4nz.js";
 import"../shared/@ai-setting/roy-agent-core-r9y8ct0w.js";
-import"../shared/@ai-setting/roy-agent-core-nx3c3ce2.js";
+import"../shared/@ai-setting/roy-agent-core-zf62vkc4.js";
 import {
   XDG_PATHS,
   getXDGPath,

package/dist/env/llm/index.js

@@ -8,13 +8,13 @@ import {
   ProviderCapabilitiesSchema,
   ProviderConfigSchema,
   ProviderManager
-} from "../../shared/@ai-setting/roy-agent-core-smgpr5tz.js";
+} from "../../shared/@ai-setting/roy-agent-core-h2d1s8yd.js";
 import {
   createInvokeConfig,
   invoke,
   invokeNonStream,
   parseModelString
-} from "../../shared/@ai-setting/roy-agent-core-3f0bkm7q.js";
+} from "../../shared/@ai-setting/roy-agent-core-r0m0at3x.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../../shared/@ai-setting/roy-agent-core-ce10b0ez.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";

package/dist/env/plugin/index.js

@@ -1,6 +1,6 @@
 import {
   PluginComponent
-} from "../../shared/@ai-setting/roy-agent-core-p7grnnzp.js";
+} from "../../shared/@ai-setting/roy-agent-core-t1ef8hf2.js";
 import {
   BasePlugin
 } from "../../shared/@ai-setting/roy-agent-core-az13yzmc.js";

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

@@ -3,8 +3,8 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-eq52jra7.js";
-import"../../../shared/@ai-setting/roy-agent-core-nx3c3ce2.js";
+} from "../../../shared/@ai-setting/roy-agent-core-0tgnq4nz.js";
+import"../../../shared/@ai-setting/roy-agent-core-zf62vkc4.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-7tp56w6n.js";

package/dist/env/task/index.js

@@ -5,16 +5,16 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-84vtpbw6.js";
+} from "../../shared/@ai-setting/roy-agent-core-11dnsfwp.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-eq52jra7.js";
+import"../../shared/@ai-setting/roy-agent-core-0tgnq4nz.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "../../shared/@ai-setting/roy-agent-core-r9y8ct0w.js";
-import"../../shared/@ai-setting/roy-agent-core-nx3c3ce2.js";
+import"../../shared/@ai-setting/roy-agent-core-zf62vkc4.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-7t0jen73.js";
 import"../../shared/@ai-setting/roy-agent-core-t94ktchq.js";

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

@@ -9,7 +9,7 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-xp8xrxgc.js";
+} from "../../../shared/@ai-setting/roy-agent-core-r12a2qfv.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import"../../../shared/@ai-setting/roy-agent-core-qg4rma4c.js";

package/dist/index.js

@@ -11,13 +11,13 @@ import {
   ModelLimitsSchema,
   ProviderCapabilitiesSchema,
   ProviderConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-smgpr5tz.js";
+} from "./shared/@ai-setting/roy-agent-core-h2d1s8yd.js";
 import {
   ConfigComponent
 } from "./shared/@ai-setting/roy-agent-core-prdngx28.js";
 import {
   CommandsComponent
-} from "./shared/@ai-setting/roy-agent-core-7wdjpbcr.js";
+} from "./shared/@ai-setting/roy-agent-core-3952rkj0.js";
 import {
   ToolComponent,
   ToolRegistry,
@@ -57,13 +57,13 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-zm86k3rg.js";
+} from "./shared/@ai-setting/roy-agent-core-gb9rb9ny.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   getBuiltInHandler,
   larkCliHandler
-} from "./shared/@ai-setting/roy-agent-core-w4tqc9m1.js";
+} from "./shared/@ai-setting/roy-agent-core-f9xyqx9s.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -79,11 +79,11 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-v8xa6vs8.js";
 import {
   PluginComponent
-} from "./shared/@ai-setting/roy-agent-core-p7grnnzp.js";
+} from "./shared/@ai-setting/roy-agent-core-t1ef8hf2.js";
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-xp8xrxgc.js";
+} from "./shared/@ai-setting/roy-agent-core-r12a2qfv.js";
 import {
   BasePlugin
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
@@ -116,29 +116,29 @@ import"./shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-9dja7n0q.js";
+} from "./shared/@ai-setting/roy-agent-core-w6j4zyps.js";
 import {
   createInvokeConfig,
   invoke,
   invokeNonStream,
   parseModelString
-} from "./shared/@ai-setting/roy-agent-core-3f0bkm7q.js";
+} from "./shared/@ai-setting/roy-agent-core-r0m0at3x.js";
 import {
   AskUserError,
   init_workflow_hil
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-84vtpbw6.js";
+} from "./shared/@ai-setting/roy-agent-core-11dnsfwp.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-eq52jra7.js";
+import"./shared/@ai-setting/roy-agent-core-0tgnq4nz.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "./shared/@ai-setting/roy-agent-core-r9y8ct0w.js";
 import {
   AgentRegistry
-} from "./shared/@ai-setting/roy-agent-core-nx3c3ce2.js";
+} from "./shared/@ai-setting/roy-agent-core-zf62vkc4.js";
 import {
   XDG_PATHS,
   getXDGPath,

package/dist/shared/@ai-setting/{roy-agent-core-eq52jra7.js → roy-agent-core-0tgnq4nz.js}

@@ -1,6 +1,6 @@
 import {
   DEFAULT_SUBAGENT_PROMPT
-} from "./roy-agent-core-nx3c3ce2.js";
+} from "./roy-agent-core-zf62vkc4.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-92z6t4he.js";

package/dist/shared/@ai-setting/{roy-agent-core-84vtpbw6.js → roy-agent-core-11dnsfwp.js}

@@ -5,7 +5,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-eq52jra7.js";
+} from "./roy-agent-core-0tgnq4nz.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath

package/dist/shared/@ai-setting/{roy-agent-core-7wdjpbcr.js → roy-agent-core-3952rkj0.js}

@@ -367,7 +367,7 @@ Run \`${options.name} --help\` to explore full capabilities.
         const stat = await fs2.lstat(commandPath);
         const realPath = stat.isSymbolicLink() ? await fs2.readlink(commandPath) : commandPath;
         const cmdSource = dir === this.projectCommandsDir ? "project" : "user";
-        const shortDescription = await this.getDescription(realPath);
+        const shortDescription = await this.getDescription(realPath, name, dir);
         return {
           name,
           path: realPath,
@@ -436,7 +436,7 @@ Run \`${options.name} --help\` to explore full capabilities.
             }
           }
           const realPath = stat.isSymbolicLink() ? await fs2.readlink(fullPath) : fullPath;
-          const shortDescription = await this.getDescription(realPath);
+          const shortDescription = await this.getDescription(realPath, entry, dir);
           commands.push({
             name: entry,
             path: realPath,
@@ -456,7 +456,17 @@ Run \`${options.name} --help\` to explore full capabilities.
     const regex = new RegExp("^" + pattern.replace(/\*/g, ".*").replace(/\?/g, ".") + "$");
     return regex.test(name);
   }
-  async getDescription(commandPath) {
+  async getDescription(commandPath, name, commandsDir) {
+    if (name && commandsDir) {
+      const metaPath = path2.join(commandsDir, `${name}.meta.md`);
+      try {
+        const meta = await parseMetaFile(metaPath, "user");
+        if (meta?.description) {
+          this.descriptionCache.set(commandPath, meta.description);
+          return meta.description;
+        }
+      } catch {}
+    }
     const cached = this.descriptionCache.get(commandPath);
     if (cached !== undefined)
       return cached;

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

@@ -1,7 +1,7 @@
 import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook
-} from "./roy-agent-core-xp8xrxgc.js";
+} from "./roy-agent-core-r12a2qfv.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-qxhq8ven.js";

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

@@ -1,6 +1,6 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-xp8xrxgc.js";
+} from "./roy-agent-core-r12a2qfv.js";
 import {
   ContextError,
   ErrorCodes

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

@@ -1,6 +1,6 @@
 import {
   invoke
-} from "./roy-agent-core-3f0bkm7q.js";
+} from "./roy-agent-core-r0m0at3x.js";
 import {
   ContextError,
   ErrorCodes

package/dist/shared/@ai-setting/{roy-agent-core-3f0bkm7q.js → roy-agent-core-r0m0at3x.js}

@@ -212,7 +212,10 @@ function convertToolChoice(toolChoice) {
     return;
   if (typeof toolChoice === "string")
     return toolChoice;
-  return { type: "tool", toolName: toolChoice.function.name };
+  const toolName = toolChoice.function?.name?.trim();
+  if (!toolName)
+    return;
+  return { type: "tool", toolName };
 }
 function createEnvEventEmitter(env, context) {
   if (!env) {

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

@@ -411,7 +411,9 @@ function createAutoTaskPlugin(config) {
         tr.result.output = (tr.result.output || "") + `
 
 ---
-\uD83D\uDCCC **System: This session has reached ` + ctx.iteration + " ReAct iterations. " + "The current work may be long-running. Please use `delegate_task` to assign " + "it to a sub-agent (e.g. `roy`) that will create a proper task and continue.**\n" + 'Example: `delegate_task(description="<summary>", prompt="Continue working on the current task...", subagent_type="roy")`\n---';
+` + "\uD83D\uDEA8 **IMPORTANT: You MUST call `delegate_task` now.**\n\n" + "This session has reached " + ctx.iteration + " ReAct iterations. " + "**You are REQUIRED to stop your current work and call `delegate_task` immediately.** " + `Do NOT continue the current ReAct loop. You MUST hand off the remaining work to a sub-agent.
+
+` + "**You MUST call the tool `delegate_task` with these parameters:**\n" + "- `description`: A short 3-5 word summary of the task\n" + "- `prompt`: Detailed instructions for the sub-agent to continue the work\n" + '- `subagent_type`: Use `"roy"` for general tasks\n\n' + "**Failure to call `delegate_task` will result in the work being lost.**\n" + "---";
       }
       logger2.info(`[AutoTaskPlugin] Prompted delegate_task at iteration ${ctx.iteration} (session=${sid.slice(0, 12)}...)`);
       return { continue: true };

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

@@ -42,26 +42,34 @@ class PluginComponent extends BaseComponent {
     this.logger.info("[PluginComponent] Initialized");
   }
   async loadInstalledPlugins() {
-    const configPath = join(homedir(), ".roy-agent", "plugins.json");
-    if (!existsSync(configPath)) {
-      this.logger.debug("[PluginComponent] No plugins.json found, skipping auto-load");
-      return;
-    }
-    let config;
-    try {
-      const raw = readFileSync(configPath, "utf-8");
-      config = JSON.parse(raw);
-    } catch (err) {
-      this.logger.warn(`[PluginComponent] Failed to read plugins.json: ${err}`);
-      return;
+    const pluginConfigs = [
+      { source: "global", path: join(homedir(), ".roy-agent", "plugins.json") },
+      { source: "project", path: join(process.cwd(), ".roy", "plugins.json") }
+    ];
+    const allPlugins = [];
+    for (const { source, path } of pluginConfigs) {
+      if (!existsSync(path)) {
+        this.logger.debug(`[PluginComponent] No plugins.json found at ${path}, skipping`);
+        continue;
+      }
+      try {
+        const raw = readFileSync(path, "utf-8");
+        const config = JSON.parse(raw);
+        const plugins = config.plugins ?? [];
+        if (plugins.length > 0) {
+          this.logger.info(`[PluginComponent] Found ${plugins.length} plugin(s) in ${source} config: ${path}`);
+          allPlugins.push(...plugins);
+        }
+      } catch (err) {
+        this.logger.warn(`[PluginComponent] Failed to read plugins.json at ${path}: ${err}`);
+      }
     }
-    const plugins = config.plugins ?? [];
-    if (plugins.length === 0) {
-      this.logger.debug("[PluginComponent] plugins.json is empty, skipping auto-load");
+    if (allPlugins.length === 0) {
+      this.logger.debug("[PluginComponent] No plugins found in any config, skipping auto-load");
       return;
     }
-    this.logger.info(`[PluginComponent] Loading ${plugins.length} installed plugin(s) from plugins.json`);
-    for (const entry of plugins) {
+    this.logger.info(`[PluginComponent] Loading ${allPlugins.length} installed plugin(s) from all configs`);
+    for (const entry of allPlugins) {
       try {
         await this.loadPluginFromPackage(entry.packageName);
       } catch (err) {
@@ -73,9 +81,31 @@ class PluginComponent extends BaseComponent {
     let pluginModule;
     try {
       pluginModule = await import(packageName);
-    } catch (err) {
-      this.logger.warn(`[PluginComponent] Could not import plugin '${packageName}': ${err}`);
-      return;
+    } catch (_err) {
+      const projectPluginPath = join(process.cwd(), ".roy", "plugins", packageName);
+      if (existsSync(projectPluginPath)) {
+        this.logger.debug(`[PluginComponent] Falling back to project plugin path: ${projectPluginPath}`);
+        try {
+          pluginModule = await import(projectPluginPath);
+        } catch (err2) {
+          this.logger.warn(`[PluginComponent] Could not import plugin '${packageName}' from project path: ${err2}`);
+          return;
+        }
+      } else {
+        const globalPluginPath = join(homedir(), ".roy-agent", "node_modules", packageName);
+        if (existsSync(globalPluginPath)) {
+          this.logger.debug(`[PluginComponent] Falling back to global plugin path: ${globalPluginPath}`);
+          try {
+            pluginModule = await import(globalPluginPath);
+          } catch (err3) {
+            this.logger.warn(`[PluginComponent] Could not import plugin '${packageName}' from global path: ${err3}`);
+            return;
+          }
+        } else {
+          this.logger.warn(`[PluginComponent] Could not import plugin '${packageName}': ${_err}`);
+          return;
+        }
+      }
     }
     const tryCreateInstance = (candidate, exportKind) => {
       if (!candidate)

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

@@ -1,13 +1,13 @@
 import {
   withTimeout
-} from "./roy-agent-core-3f0bkm7q.js";
+} from "./roy-agent-core-r0m0at3x.js";
 import {
   AskUserError,
   init_workflow_hil
 } from "./roy-agent-core-e25xkv53.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-nx3c3ce2.js";
+} from "./roy-agent-core-zf62vkc4.js";
 import {
   ContextError
 } from "./roy-agent-core-ctdhjv68.js";

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

@@ -109,17 +109,18 @@ class AgentRegistry {
     const promptComponent = this.getActivePromptComponent();
     if (agent.systemPromptRef) {
       try {
-        const prompt = promptComponent?.get?.(agent.systemPromptRef);
-        if (prompt) {
-          logger.debug(`[AgentRegistry] Resolved systemPromptRef: ${agent.systemPromptRef}`);
-          return prompt;
-        }
         if (promptComponent?.getPrompt) {
           const rendered = await promptComponent.getPrompt(agent.systemPromptRef);
           if (rendered) {
+            logger.debug(`[AgentRegistry] Resolved systemPromptRef via getPrompt: ${agent.systemPromptRef}`);
             return rendered;
           }
         }
+        const prompt = promptComponent?.get?.(agent.systemPromptRef);
+        if (prompt) {
+          logger.debug(`[AgentRegistry] Resolved systemPromptRef via get: ${agent.systemPromptRef}`);
+          return prompt;
+        }
         if (agent.systemPrompt) {
           logger.debug(`[AgentRegistry] systemPromptRef not found, falling back to inline`);
           return agent.systemPrompt;

package/package.json

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