@ai-setting/roy-agent-core 1.5.85 → 1.5.87

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

@@ -1,10 +1,12 @@
-import"../../shared/@ai-setting/roy-agent-core-2grcjaad.js";
+import"../../shared/@ai-setting/roy-agent-core-4f3976cd.js";
 import {
   EventSourceComponent,
+  TimerInstance,
   builtInHandlers,
   getBuiltInHandler,
-  larkCliHandler
-} from "../../shared/@ai-setting/roy-agent-core-ya1ayt1k.js";
+  larkCliHandler,
+  timerHandler
+} from "../../shared/@ai-setting/roy-agent-core-6mk0m4t3.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -13,7 +15,7 @@ import {
   isBuiltInEventSourceType,
   isValidEventSourceType,
   validateEventSourceConfig
-} from "../../shared/@ai-setting/roy-agent-core-xb4hvk1m.js";
+} from "../../shared/@ai-setting/roy-agent-core-qhhxx2x2.js";
 import"../../shared/@ai-setting/roy-agent-core-v8xa6vs8.js";
 import"../../shared/@ai-setting/roy-agent-core-7fdzfsm6.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
@@ -31,12 +33,14 @@ import"../../shared/@ai-setting/roy-agent-core-c6592r3c.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   validateEventSourceConfig,
+  timerHandler,
   larkCliHandler,
   isValidEventSourceType,
   isBuiltInEventSourceType,
   getDefaultConfigForType,
   getBuiltInHandler,
   builtInHandlers,
+  TimerInstance,
   EventSourceInitHooks,
   EventSourceComponent,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,

package/dist/env/index.js

@@ -5,14 +5,14 @@ import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-ya1ayt1k.js";
+} from "../shared/@ai-setting/roy-agent-core-6mk0m4t3.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
   isBuiltInEventSourceType,
   isValidEventSourceType,
   validateEventSourceConfig
-} from "../shared/@ai-setting/roy-agent-core-xb4hvk1m.js";
+} from "../shared/@ai-setting/roy-agent-core-qhhxx2x2.js";
 import"../shared/@ai-setting/roy-agent-core-v8xa6vs8.js";
 import {
   PluginComponent
@@ -21,17 +21,17 @@ import"../shared/@ai-setting/roy-agent-core-7fdzfsm6.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-dp73ghtz.js";
+} from "../shared/@ai-setting/roy-agent-core-6n7xwv4v.js";
 import"../shared/@ai-setting/roy-agent-core-fjexv5nm.js";
-import"../shared/@ai-setting/roy-agent-core-gttz2jpm.js";
+import"../shared/@ai-setting/roy-agent-core-9y09xfav.js";
 import"../shared/@ai-setting/roy-agent-core-5kdw0p98.js";
 import"../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../shared/@ai-setting/roy-agent-core-gb9gbkc3.js";
 import"../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"../shared/@ai-setting/roy-agent-core-hhrg314p.js";
-import"../shared/@ai-setting/roy-agent-core-j754zgb4.js";
+import"../shared/@ai-setting/roy-agent-core-hc20420t.js";
 import"../shared/@ai-setting/roy-agent-core-qnrf2aw6.js";
-import"../shared/@ai-setting/roy-agent-core-r5axf0ad.js";
+import"../shared/@ai-setting/roy-agent-core-0y64qaac.js";
 import"../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../shared/@ai-setting/roy-agent-core-tq9528d3.js";
 import"../shared/@ai-setting/roy-agent-core-h0x19xgn.js";
@@ -44,9 +44,9 @@ 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-dv12wpdv.js";
+} from "../shared/@ai-setting/roy-agent-core-r1adqgaa.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../shared/@ai-setting/roy-agent-core-0kt57b72.js";
+import"../shared/@ai-setting/roy-agent-core-bgw4dq11.js";
 import"../shared/@ai-setting/roy-agent-core-pcdzfwdv.js";
 import"../shared/@ai-setting/roy-agent-core-7z4xtrmw.js";
 import {
@@ -54,7 +54,7 @@ import {
   getXDGPath,
   getXDGPaths
 } from "../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../shared/@ai-setting/roy-agent-core-7nh5h9fn.js";
+import"../shared/@ai-setting/roy-agent-core-9vwyj29a.js";
 import"../shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import"../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import {

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

@@ -3,7 +3,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-0kt57b72.js";
+} from "../../../shared/@ai-setting/roy-agent-core-bgw4dq11.js";
 import"../../../shared/@ai-setting/roy-agent-core-7z4xtrmw.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-92z6t4he.js";

package/dist/env/task/index.js

@@ -5,18 +5,18 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-dv12wpdv.js";
+} from "../../shared/@ai-setting/roy-agent-core-r1adqgaa.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-0kt57b72.js";
+import"../../shared/@ai-setting/roy-agent-core-bgw4dq11.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
 } from "../../shared/@ai-setting/roy-agent-core-pcdzfwdv.js";
 import"../../shared/@ai-setting/roy-agent-core-7z4xtrmw.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../../shared/@ai-setting/roy-agent-core-7nh5h9fn.js";
+import"../../shared/@ai-setting/roy-agent-core-9vwyj29a.js";
 import"../../shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import"../../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";

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

@@ -8,7 +8,7 @@ import {
   listTasksTool,
   searchTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-7nh5h9fn.js";
+} from "../../../shared/@ai-setting/roy-agent-core-9vwyj29a.js";
 import"../../../shared/@ai-setting/roy-agent-core-y5d04fm3.js";
 import"../../../shared/@ai-setting/roy-agent-core-k05v31rc.js";
 import"../../../shared/@ai-setting/roy-agent-core-shme7set.js";

package/dist/env/tool/built-in/index.js

@@ -8,7 +8,9 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../../shared/@ai-setting/roy-agent-core-8pk6a00t.js";
+} from "../../../shared/@ai-setting/roy-agent-core-qhjb153z.js";
+import"../../../shared/@ai-setting/roy-agent-core-k05v31rc.js";
+import"../../../shared/@ai-setting/roy-agent-core-shme7set.js";
 import"../../../shared/@ai-setting/roy-agent-core-7z9b1fm8.js";
 import"../../../shared/@ai-setting/roy-agent-core-c6592r3c.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/tool/index.js

@@ -4,7 +4,7 @@ import {
   ToolValidator,
   getMaxOutputSize,
   setToolConfigComponent
-} from "../../shared/@ai-setting/roy-agent-core-pwzkgtgr.js";
+} from "../../shared/@ai-setting/roy-agent-core-3arrpf7n.js";
 import {
   bashTool,
   echoTool,
@@ -15,7 +15,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../shared/@ai-setting/roy-agent-core-8pk6a00t.js";
+} from "../../shared/@ai-setting/roy-agent-core-qhjb153z.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
 import"../../shared/@ai-setting/roy-agent-core-rgckng3p.js";

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

@@ -6,12 +6,12 @@ import {
   Scheduler,
   WorkflowEngine,
   init_engine
-} from "../../../shared/@ai-setting/roy-agent-core-gttz2jpm.js";
+} from "../../../shared/@ai-setting/roy-agent-core-9y09xfav.js";
 import"../../../shared/@ai-setting/roy-agent-core-5kdw0p98.js";
 import"../../../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../../../shared/@ai-setting/roy-agent-core-gb9gbkc3.js";
 import"../../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
-import"../../../shared/@ai-setting/roy-agent-core-j754zgb4.js";
+import"../../../shared/@ai-setting/roy-agent-core-hc20420t.js";
 import"../../../shared/@ai-setting/roy-agent-core-qnrf2aw6.js";
 import"../../../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";

package/dist/env/workflow/index.js

@@ -1,14 +1,14 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-dp73ghtz.js";
+} from "../../shared/@ai-setting/roy-agent-core-6n7xwv4v.js";
 import"../../shared/@ai-setting/roy-agent-core-fjexv5nm.js";
-import"../../shared/@ai-setting/roy-agent-core-gttz2jpm.js";
+import"../../shared/@ai-setting/roy-agent-core-9y09xfav.js";
 import"../../shared/@ai-setting/roy-agent-core-5kdw0p98.js";
 import"../../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../../shared/@ai-setting/roy-agent-core-gb9gbkc3.js";
 import"../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"../../shared/@ai-setting/roy-agent-core-hhrg314p.js";
-import"../../shared/@ai-setting/roy-agent-core-j754zgb4.js";
+import"../../shared/@ai-setting/roy-agent-core-hc20420t.js";
 import {
   BaseEventSchema,
   ControlPauseEventSchema,
@@ -60,7 +60,7 @@ import {
   pathNotFound,
   unresolvedVariable
 } from "../../shared/@ai-setting/roy-agent-core-qnrf2aw6.js";
-import"../../shared/@ai-setting/roy-agent-core-r5axf0ad.js";
+import"../../shared/@ai-setting/roy-agent-core-0y64qaac.js";
 import"../../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../../shared/@ai-setting/roy-agent-core-tq9528d3.js";
 import {

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

@@ -5,7 +5,7 @@ import {
   init_skill_node,
   init_tool_node,
   init_workflow_node
-} from "../../../shared/@ai-setting/roy-agent-core-j754zgb4.js";
+} from "../../../shared/@ai-setting/roy-agent-core-hc20420t.js";
 import"../../../shared/@ai-setting/roy-agent-core-k05v31rc.js";
 import"../../../shared/@ai-setting/roy-agent-core-shme7set.js";
 import"../../../shared/@ai-setting/roy-agent-core-7z9b1fm8.js";

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

@@ -22,7 +22,7 @@ import {
   getRunWorkflowTool,
   initRunWorkflowTool,
   resetRunWorkflowTool
-} from "../../../shared/@ai-setting/roy-agent-core-r5axf0ad.js";
+} from "../../../shared/@ai-setting/roy-agent-core-0y64qaac.js";
 import {
   WORKFLOW_SUBMIT_OUTPUT_TOOL_NAME,
   WorkflowJsonOutputMarker,

package/dist/index.js

@@ -22,7 +22,7 @@ import {
   ToolComponent,
   ToolRegistry,
   ToolValidator
-} from "./shared/@ai-setting/roy-agent-core-pwzkgtgr.js";
+} from "./shared/@ai-setting/roy-agent-core-3arrpf7n.js";
 import {
   bashTool,
   editFileTool,
@@ -32,12 +32,12 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "./shared/@ai-setting/roy-agent-core-8pk6a00t.js";
+} from "./shared/@ai-setting/roy-agent-core-qhjb153z.js";
 import {
   closeDatabase
 } from "./shared/@ai-setting/roy-agent-core-h4h55x4h.js";
 import"./shared/@ai-setting/roy-agent-core-3sv590cv.js";
-import"./shared/@ai-setting/roy-agent-core-2grcjaad.js";
+import"./shared/@ai-setting/roy-agent-core-4f3976cd.js";
 import {
   MemoryComponent
 } from "./shared/@ai-setting/roy-agent-core-2h38rvyj.js";
@@ -61,10 +61,12 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-29fh9mxg.js";
 import {
   EventSourceComponent,
+  TimerInstance,
   builtInHandlers,
   getBuiltInHandler,
-  larkCliHandler
-} from "./shared/@ai-setting/roy-agent-core-ya1ayt1k.js";
+  larkCliHandler,
+  timerHandler
+} from "./shared/@ai-setting/roy-agent-core-6mk0m4t3.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -73,7 +75,7 @@ import {
   isBuiltInEventSourceType,
   isValidEventSourceType,
   validateEventSourceConfig
-} from "./shared/@ai-setting/roy-agent-core-xb4hvk1m.js";
+} from "./shared/@ai-setting/roy-agent-core-qhhxx2x2.js";
 import {
   LogTraceComponent,
   LogTraceConfigSchema
@@ -90,20 +92,20 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "./shared/@ai-setting/roy-agent-core-dp73ghtz.js";
+} from "./shared/@ai-setting/roy-agent-core-6n7xwv4v.js";
 import {
   init_node_registry_helper,
   registerDecoratorNodeType
 } from "./shared/@ai-setting/roy-agent-core-fjexv5nm.js";
-import"./shared/@ai-setting/roy-agent-core-gttz2jpm.js";
+import"./shared/@ai-setting/roy-agent-core-9y09xfav.js";
 import"./shared/@ai-setting/roy-agent-core-5kdw0p98.js";
 import"./shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"./shared/@ai-setting/roy-agent-core-gb9gbkc3.js";
 import"./shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import"./shared/@ai-setting/roy-agent-core-hhrg314p.js";
-import"./shared/@ai-setting/roy-agent-core-j754zgb4.js";
+import"./shared/@ai-setting/roy-agent-core-hc20420t.js";
 import"./shared/@ai-setting/roy-agent-core-qnrf2aw6.js";
-import"./shared/@ai-setting/roy-agent-core-r5axf0ad.js";
+import"./shared/@ai-setting/roy-agent-core-0y64qaac.js";
 import"./shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"./shared/@ai-setting/roy-agent-core-tq9528d3.js";
 import {
@@ -130,9 +132,9 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-dv12wpdv.js";
+} from "./shared/@ai-setting/roy-agent-core-r1adqgaa.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-0kt57b72.js";
+import"./shared/@ai-setting/roy-agent-core-bgw4dq11.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
@@ -145,7 +147,7 @@ import {
   getXDGPath,
   getXDGPaths
 } from "./shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"./shared/@ai-setting/roy-agent-core-7nh5h9fn.js";
+import"./shared/@ai-setting/roy-agent-core-9vwyj29a.js";
 import"./shared/@ai-setting/roy-agent-core-t94ktchq.js";
 import {
   TaskHookPoints
@@ -346,6 +348,7 @@ export {
   writeFileTool,
   wrapFunction,
   validateEventSourceConfig,
+  timerHandler,
   setQuietMode,
   setConfigComponent as setLoggerConfigComponent,
   setLogDirOverride,
@@ -405,6 +408,7 @@ export {
   ToolRegistry,
   ToolError,
   ToolComponent,
+  TimerInstance,
   TaskTagPlugin,
   TaskHookPoints,
   TaskComponent,

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

@@ -147,16 +147,40 @@ var WorkflowListInputSchema = z3.object({
   tags: z3.array(z3.string()).optional().describe("Filter by multiple tags (AND)"),
   search: z3.string().optional().describe("Search workflows by keyword"),
   limit: z3.number().positive().optional().describe("Maximum number of results to return"),
-  offset: z3.number().min(0).optional().describe("Offset for pagination")
+  offset: z3.number().min(0).optional().describe("Offset for pagination"),
+  page: z3.number().int().min(1).optional().describe("1-based page number (optional; defaults to 1)")
 });
+function projectWorkflow(w) {
+  return {
+    name: w.name,
+    version: w.version,
+    description: w.description,
+    tags: w.tags,
+    created_at: w.createdAt
+  };
+}
+function buildListToolOutput(result, params) {
+  return {
+    total: result.total,
+    count: result.workflows.length,
+    truncated: result.total > result.workflows.length,
+    limit: params.limit,
+    offset: params.offset,
+    page: params.page ?? 1,
+    available_tags: result.available_tags,
+    workflows: result.workflows.map(projectWorkflow)
+  };
+}
 function createWorkflowListTool(workflowService) {
   return {
     name: "workflow_list",
-    description: "List all registered workflows with optional filtering. " + "Returns `workflows`, `total` (filtered count regardless of pagination), `count` (returned count), " + "`limit`, `offset`, and `available_tags` (sorted by usage_count DESC). " + "Multi-tag filter uses AND logic. " + "\uD83D\uDCA1 TIP: The `available_tags` field tells you what tags already exist. " + "Before calling `workflow_add` with new tags, call `workflow_tag_list` to discover " + "existing tags and prefer reusing them for semantic consistency " + "(e.g. reuse 'ci-cd' rather than creating 'continuous-integration'). " + "Avoid tag proliferation is a design goal — limit the number of distinct tags in the pool.",
+    description: "List all registered workflows with optional filtering. " + "Returns canonical JSON shape (Code Review #1479 follow-up): " + "`total` (filtered count BEFORE pagination), `count` (returned count), `truncated` (true when total > count), " + "`limit`, `offset`, `page` (1-based page number; defaults to 1), `available_tags` (sorted by usage_count DESC), " + "and `workflows` (the array, always LAST so downstream tail-truncation strips it rather than the metadata). " + "Multi-tag filter uses AND logic. " + "\uD83D\uDCA1 TIP: The `available_tags` field tells you what tags already exist. " + "Before calling `workflow_add` with new tags, call `workflow_tag_list` to discover " + "existing tags and prefer reusing them for semantic consistency " + "(e.g. reuse 'ci-cd' rather than creating 'continuous-integration'). " + "Avoid tag proliferation is a design goal — limit the number of distinct tags in the pool.",
     parameters: WorkflowListInputSchema,
     execute: async (args, ctx) => {
       const params = WorkflowListInputSchema.parse(args);
       try {
+        const effectivePage = params.page ?? 1;
+        const effectiveOffset = params.offset !== undefined ? params.offset : (effectivePage - 1) * (params.limit ?? 20);
         const options = {};
         if (params.tag !== undefined)
           options.tag = params.tag;
@@ -164,54 +188,41 @@ function createWorkflowListTool(workflowService) {
           options.search = params.search;
         if (params.limit !== undefined)
           options.limit = params.limit;
-        if (params.offset !== undefined)
-          options.offset = params.offset;
+        if (effectiveOffset !== 0)
+          options.offset = effectiveOffset;
         if (params.tags && params.tags.length > 0) {
-          const result2 = await workflowService.searchWorkflowsWithTags ? await workflowService.searchWorkflowsWithTags({
+          const result2 = workflowService.searchWorkflowsWithTags ? await workflowService.searchWorkflowsWithTags({
             tags: params.tags,
             limit: params.limit,
-            offset: params.offset
-          }) : { workflows: workflowService.searchWorkflows({ tags: params.tags, limit: params.limit, offset: params.offset }), available_tags: [], total: 0 };
+            offset: effectiveOffset
+          }) : {
+            workflows: workflowService.searchWorkflows({
+              tags: params.tags,
+              limit: params.limit,
+              offset: effectiveOffset
+            }),
+            available_tags: [],
+            total: workflowService.searchWorkflows({
+              tags: params.tags
+            }).length
+          };
           return {
             success: true,
-            output: JSON.stringify({
-              workflows: result2.workflows.map((w) => ({
-                name: w.name,
-                version: w.version,
-                description: w.description,
-                tags: w.tags,
-                created_at: w.createdAt
-              })),
-              available_tags: result2.available_tags,
-              total: result2.total,
-              count: result2.workflows.length,
-              limit: params.limit,
-              offset: params.offset
-            }, null, 2),
+            output: JSON.stringify(buildListToolOutput(result2, params), null, 2),
             metadata: { execution_time_ms: 0 }
           };
         }
         const result = workflowService.listWorkflowsWithTags ? await workflowService.listWorkflowsWithTags(options) : {
           workflows: workflowService.listWorkflows(options),
           available_tags: [],
-          total: 0
+          total: workflowService.listWorkflows({
+            tag: options.tag,
+            search: options.search
+          }).length
         };
         return {
           success: true,
-          output: JSON.stringify({
-            workflows: result.workflows.map((w) => ({
-              name: w.name,
-              version: w.version,
-              description: w.description,
-              tags: w.tags,
-              created_at: w.createdAt
-            })),
-            available_tags: result.available_tags,
-            total: result.total,
-            count: result.workflows.length,
-            limit: params.limit,
-            offset: params.offset
-          }, null, 2),
+          output: JSON.stringify(buildListToolOutput(result, params), null, 2),
           metadata: { execution_time_ms: 0 }
         };
       } catch (error) {

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

@@ -20,7 +20,8 @@ import {
   runWithEnvContext
 } from "./roy-agent-core-y5d04fm3.js";
 import {
-  TracedAs
+  TracedAs,
+  init_decorator
 } from "./roy-agent-core-k05v31rc.js";
 import {
   createLogger,
@@ -34,6 +35,163 @@ import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";
 
+// src/env/event-source/timer-handler.ts
+init_decorator();
+var DEFAULT_TIMER_INTERVAL_MS = 10 * 60 * 1000;
+var SELF_REMINDER_MESSAGE = `[Timer Self-Reminder]
+请读取最近 1 周处理的 task 信息，分析用户当前的工作目标和重点任务。
+基于分析结果，自主构建有价值的任务来推进用户目标。
+
+分析维度：
+1. 最近完成的 task 类型和主题
+2. 进行中的 task 状态和阻塞点
+3. 用户的工作模式和偏好
+4. 可以主动优化的领域
+
+请根据分析结果，创建 1-3 个有价值的任务并执行。`;
+var TIMER_OPTIONS_KEY_GET_MANAGER = "getBackgroundTaskManager";
+
+class TimerInstance {
+  config;
+  interval;
+  sessionId;
+  getRunningTasks;
+  customPrompt;
+  status = "created";
+  timerId;
+  eventHandler;
+  constructor(config, getRunningTasks) {
+    this.config = config;
+    this.interval = typeof config.interval === "number" && config.interval > 0 ? config.interval : DEFAULT_TIMER_INTERVAL_MS;
+    this.sessionId = `timer-${config.id}-${process.pid}`;
+    const optionsPrompt = config.options?.prompt;
+    if (typeof optionsPrompt === "string" && optionsPrompt.trim().length > 0) {
+      this.customPrompt = optionsPrompt;
+    }
+    if (getRunningTasks) {
+      this.getRunningTasks = getRunningTasks;
+    } else {
+      const factory = config.options?.[TIMER_OPTIONS_KEY_GET_MANAGER];
+      if (typeof factory === "function") {
+        const manager = factory();
+        this.getRunningTasks = () => manager.listTasks();
+      } else {
+        this.getRunningTasks = () => [];
+      }
+    }
+  }
+  async start() {
+    if (this.status === "running")
+      return;
+    this.timerId = setInterval(() => {
+      this.tick();
+    }, this.interval);
+    this.status = "running";
+  }
+  async stop() {
+    if (this.timerId !== undefined) {
+      clearInterval(this.timerId);
+      this.timerId = undefined;
+    }
+    this.status = "stopped";
+  }
+  getStatus() {
+    return this.status;
+  }
+  onEvent(handler) {
+    this.eventHandler = handler;
+  }
+  offEvent() {
+    this.eventHandler = undefined;
+  }
+  tick() {
+    let allTasks;
+    try {
+      allTasks = this.getRunningTasks();
+    } catch (error) {
+      console.warn(`[TimerInstance] Failed to get running tasks, skipping tick: ${error}`);
+      return;
+    }
+    const hasRunning = Array.isArray(allTasks) && allTasks.some((t) => t.status === "running");
+    if (hasRunning) {
+      return;
+    }
+    const event = this.buildSelfReminderEvent();
+    this.eventHandler?.(event);
+  }
+  buildSelfReminderEvent() {
+    const timestamp = Date.now();
+    const message = this.customPrompt ?? SELF_REMINDER_MESSAGE;
+    return {
+      id: `es-${this.config.id}-${timestamp}-${Math.random().toString(36).slice(2, 8)}`,
+      type: "event-source.event.timer",
+      timestamp,
+      metadata: {
+        source: "event-source",
+        sourceId: this.config.id,
+        sourceMessageType: "timer.selfReminder",
+        sessionId: this.sessionId
+      },
+      payload: {
+        sourceId: this.config.id,
+        sourceType: "timer",
+        rawEvent: {
+          type: "timer.selfReminder",
+          triggeredAt: timestamp
+        },
+        message,
+        metadata: {
+          eventType: "timer.selfReminder",
+          sourceId: this.config.id,
+          sourceType: "timer",
+          timestamp
+        },
+        timestamp
+      }
+    };
+  }
+}
+__legacyDecorateClassTS([
+  TracedAs("timer.tick", { recordParams: false, log: false })
+], TimerInstance.prototype, "tick", null);
+__legacyDecorateClassTS([
+  TracedAs("timer.buildSelfReminderEvent", { recordParams: false, log: false })
+], TimerInstance.prototype, "buildSelfReminderEvent", null);
+var timerHandler = {
+  type: "timer",
+  validateConfig(config) {
+    const errors = [];
+    const { interval } = config;
+    if (interval !== undefined && interval !== null) {
+      if (typeof interval !== "number" || !Number.isFinite(interval)) {
+        errors.push("Timer interval must be a finite number");
+      } else if (interval <= 0) {
+        errors.push("Timer interval must be a positive number (milliseconds)");
+      }
+    }
+    return errors;
+  },
+  createInstance(config) {
+    return new TimerInstance(config);
+  },
+  getOptions() {
+    return [
+      {
+        name: "interval",
+        description: `Timer interval in milliseconds (default: ${DEFAULT_TIMER_INTERVAL_MS} = 10 minutes)`,
+        required: false,
+        type: "number"
+      },
+      {
+        name: "prompt",
+        description: "Custom prompt message for SelfReminder events (replaces default message)",
+        required: false,
+        type: "string"
+      }
+    ];
+  }
+};
+
 // src/env/event-source/event-source-handlers.ts
 init_global_hook_manager();
 import { spawn } from "child_process";
@@ -543,7 +701,8 @@ var larkCliHandler = {
   }
 };
 var builtInHandlers = [
-  larkCliHandler
+  larkCliHandler,
+  timerHandler
 ];
 function getBuiltInHandler(type) {
   return builtInHandlers.find((h) => h.type === type);
@@ -553,6 +712,7 @@ function getBuiltInHandler(type) {
 import { join } from "path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 init_logger();
+init_decorator();
 
 // src/env/event-source/event-source-config-registration.ts
 var EVENT_SOURCE_DEFAULTS = {
@@ -644,7 +804,7 @@ class EventSourceComponent extends BaseComponent {
     }
   }
   async executeInitHooks() {
-    const { EventSourceInitHooks } = await import("./roy-agent-core-9mj7vzsm.js");
+    const { EventSourceInitHooks } = await import("./roy-agent-core-vneyghpg.js");
     await EventSourceInitHooks.execute(this);
   }
   registerHandler(handler) {
@@ -790,6 +950,57 @@ class EventSourceComponent extends BaseComponent {
     }
     return existed;
   }
+  async update(id, partial) {
+    if (!partial || Object.keys(partial).length === 0) {
+      throw new Error("update() partial must not be empty");
+    }
+    const existing = this.sources.get(id);
+    if (!existing) {
+      throw new Error(`EventSource not found: ${id}`);
+    }
+    if (Object.prototype.hasOwnProperty.call(partial, "type")) {
+      if (partial.type !== existing.type) {
+        throw new Error(`Cannot update event source type: ${existing.type} -> ${partial.type} (use unregister + register instead)`);
+      }
+    }
+    const wasRunning = this.statuses.get(id) === "running";
+    let stopped = false;
+    if (wasRunning) {
+      await this.stopSource(id);
+      stopped = true;
+    }
+    const updated = {
+      ...existing,
+      ...partial,
+      id: existing.id,
+      type: existing.type
+    };
+    const handler = this.handlers.get(existing.type);
+    if (handler) {
+      const errors = handler.validateConfig(updated);
+      if (errors.length > 0) {
+        throw new Error(`Invalid config after update: ${errors.join(", ")}`);
+      }
+    }
+    this.sources.set(id, updated);
+    logger.info(`EventSource updated: ${id}`, {
+      fields: Object.keys(partial)
+    });
+    try {
+      await this.saveConfig();
+    } catch (err) {
+      logger.error(`Failed to save config after updating ${id}:`, err);
+      throw err;
+    }
+    return {
+      id,
+      updated,
+      wasRunning,
+      stopped,
+      restarted: false,
+      fields: Object.keys(partial)
+    };
+  }
   get(id) {
     return this.sources.get(id);
   }
@@ -931,5 +1142,8 @@ class EventSourceComponent extends BaseComponent {
     }
   }
 }
+__legacyDecorateClassTS([
+  TracedAs("event-source.update", { recordParams: false, log: false })
+], EventSourceComponent.prototype, "update", null);
 
-export { larkCliHandler, builtInHandlers, getBuiltInHandler, EventSourceComponent };
+export { TimerInstance, timerHandler, larkCliHandler, builtInHandlers, getBuiltInHandler, EventSourceComponent };

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

@@ -6,7 +6,7 @@ import {
   WorkflowEngine,
   exports_engine,
   init_engine
-} from "./roy-agent-core-gttz2jpm.js";
+} from "./roy-agent-core-9y09xfav.js";
 import {
   askUserTool,
   createRunWorkflowTool,
@@ -17,7 +17,7 @@ import {
   createWorkflowRunStopTool,
   createWorkflowSearchTool,
   createWorkflowTagListTool
-} from "./roy-agent-core-r5axf0ad.js";
+} from "./roy-agent-core-0y64qaac.js";
 import {
   WorkflowService
 } from "./roy-agent-core-tq9528d3.js";

package/dist/shared/@ai-setting/{roy-agent-core-7nh5h9fn.js → roy-agent-core-9vwyj29a.js}

@@ -248,7 +248,10 @@ function listTasksTool(taskComponent) {
   return {
     name: "task_list",
     description: "List tasks with optional filters for status, priority, type, parent_task_id, " + "and depth (hierarchy level). " + `depth: 0=只根任务（无父任务），1=根+一层子任务，2=根+二层子任务，-1 或忽略=全部。
-` + "Returns { tasks, total, limit, offset } where total is the count of all " + "matching tasks BEFORE pagination.",
+` + `Returns { total, count, truncated, limit, offset, depth, tasks } where:
+` + `  - total: count of all matching tasks BEFORE pagination
+` + "  - count: count of tasks in the returned `tasks` array (after pagination)\n" + `  - truncated: true when total > count (data was truncated by pagination)
+` + "Note: `total` is the FIRST field in the response so it survives tail-truncation " + "by ToolComponent.truncateOutput.",
     parameters: ListTasksToolSchema,
     execute: async (args, ctx) => {
       const params = ListTasksToolSchema.parse(args);
@@ -265,12 +268,13 @@ function listTasksTool(taskComponent) {
         return {
           success: true,
           output: JSON.stringify({
-            tasks: result.tasks,
             total: result.total,
             count: result.tasks.length,
+            truncated: result.total > result.tasks.length,
             limit: params.limit,
             offset: params.offset,
-            depth: params.depth
+            depth: params.depth,
+            tasks: result.tasks
           }),
           metadata: { execution_time_ms: 0 }
         };

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

@@ -19,7 +19,7 @@ import {
   init_skill_node,
   init_tool_node,
   init_workflow_node
-} from "./roy-agent-core-j754zgb4.js";
+} from "./roy-agent-core-hc20420t.js";
 import {
   WorkflowError,
   createWorkflowEvent,
@@ -1856,7 +1856,15 @@ var init_engine = __esm(() => {
       }
       const { stripEphemeralResumeInput } = await import("./roy-agent-core-2vhsccvz.js");
       const { workflowInput: runtimeInput } = stripEphemeralResumeInput(rawRuntimeInput);
-      const mergedWorkflowInput = { ...persistedInput, ...runtimeInput };
+      const defaultsFromSchema = {};
+      if (definition.inputs) {
+        for (const [key, param] of Object.entries(definition.inputs)) {
+          if (param.default !== undefined) {
+            defaultsFromSchema[key] = param.default;
+          }
+        }
+      }
+      const mergedWorkflowInput = { ...defaultsFromSchema, ...persistedInput, ...runtimeInput };
       const workflowInput = Object.keys(mergedWorkflowInput).length > 0 ? mergedWorkflowInput : undefined;
       const config = {
         parallelLimit,

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

@@ -238,7 +238,7 @@ ${originalPrompt}
 `;
 }
 var DEFAULT_TIMEOUT = 1800000;
-var PROGRESS_INTERVAL = 120000;
+var PROGRESS_INTERVAL = 600000;
 
 class BackgroundTaskManager {
   env;

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

@@ -66,7 +66,7 @@ var init_tool_node = __esm(() => {
         }
         if (toolName === "bash" && typeof input.command === "string") {
           const trimmed = input.command.replace(/\n+$/, "");
-          const echoMatch = trimmed.match(/^echo\s+"([\s\S]*)"\s*$/);
+          const echoMatch = trimmed.match(/^echo\s+"([^\n\r]*)"\s*$/);
           if (echoMatch) {
             let inner = echoMatch[1];
             inner = inner.replace(/\\/g, "\\\\");

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

@@ -1,6 +1,7 @@
 // src/env/event-source/types.ts
 var BUILT_IN_EVENT_SOURCE_TYPES = {
-  LARK_CLI: "lark-cli"
+  LARK_CLI: "lark-cli",
+  TIMER: "timer"
 };
 var BUILT_IN_EVENT_SOURCE_TYPE_LIST = Object.values(BUILT_IN_EVENT_SOURCE_TYPES);
 

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

@@ -1,3 +1,7 @@
+import {
+  init_decorator,
+  wrapFunction
+} from "./roy-agent-core-k05v31rc.js";
 import {
   exports_tracer_provider,
   init_propagation,
@@ -10,6 +14,7 @@ import {
 
 // src/env/tool/built-in/bash.ts
 init_propagation();
+init_decorator();
 import { z } from "zod";
 import { Effect as Effect2 } from "effect";
 
@@ -188,7 +193,7 @@ var bashTool = {
     tags: ["shell", "command", "terminal", "exec"],
     version: "2.0.0"
   },
-  execute: async (args, ctx) => {
+  execute: wrapFunction(async (args, ctx) => {
     const startTime = Date.now();
     const { command, workdir, timeout = 60000, env } = args;
     const currentSpanCtx = getCurrentSpanContext();
@@ -293,7 +298,7 @@ var bashTool = {
         }
       };
     }
-  }
+  }, "tool.bash.execute", { recordParams: true, recordResult: true })
 };
 
 // src/env/tool/built-in/echo.ts

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

@@ -5,7 +5,7 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "./roy-agent-core-0kt57b72.js";
+} from "./roy-agent-core-bgw4dq11.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
@@ -20,7 +20,7 @@ import {
   listTasksTool,
   searchTasksTool,
   updateTaskTool
-} from "./roy-agent-core-7nh5h9fn.js";
+} from "./roy-agent-core-9vwyj29a.js";
 import {
   createOperationTool,
   deleteOperationTool,

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

@@ -6,7 +6,7 @@ import {
   isBuiltInEventSourceType,
   isValidEventSourceType,
   validateEventSourceConfig
-} from "./roy-agent-core-xb4hvk1m.js";
+} from "./roy-agent-core-qhhxx2x2.js";
 import"./roy-agent-core-fs0mn2jk.js";
 export {
   validateEventSourceConfig,

package/package.json

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