@ai-setting/roy-agent-core 1.7.85 → 1.7.88

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

@@ -1,7 +1,7 @@
 import {
   init_global_hook_manager,
   init_hook_manager
-} from "./roy-agent-core-cpcd24n2.js";
+} from "./roy-agent-core-yet36q5k.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -11,7 +11,7 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   __esm,
   __legacyDecorateClassTS

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

@@ -1,7 +1,7 @@
 import {
   init_env_context,
   init_env_event
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,22 +1,22 @@
 import {
   isToolUnavailableError,
   truncateOutputInline
-} from "./roy-agent-core-ze5cqpf2.js";
+} from "./roy-agent-core-mx855td4.js";
 import {
   AgentRegistry
-} from "./roy-agent-core-ed233k5z.js";
+} from "./roy-agent-core-v1n0106v.js";
 import {
   createTaskOpWatermarkPlugin,
   enqueueToAddFakeUserMessage
-} from "./roy-agent-core-h21gngxf.js";
+} from "./roy-agent-core-7yh5wps0.js";
 import {
   SessionMessageConverter
-} from "./roy-agent-core-0snm5hc5.js";
+} from "./roy-agent-core-y6shd91r.js";
 import {
   parseToolArgsStrict,
   safeParseToolArgs,
   withTimeout
-} from "./roy-agent-core-fghc2m8z.js";
+} from "./roy-agent-core-aa8kv18f.js";
 import {
   getCurrentBgTaskId
 } from "./roy-agent-core-c1v263jn.js";
@@ -32,20 +32,20 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-cpcd24n2.js";
+} from "./roy-agent-core-yet36q5k.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getCurrentTaskId,
   getEnvContext,
   resolveEnvParentTaskId,
   runWithEnvContextAsync
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   TracedAs,
   agentRunParamFilter,
@@ -57,7 +57,7 @@ import {
   recordSessionMessagesParamFilter,
   toolExecParamFilter,
   toolExecResultFilter
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger
@@ -554,10 +554,16 @@ var AgentInstanceSchema = z.object({
 var AgentComponentConfigSchema = z.object({
   defaultAgent: AgentInstanceSchema
 });
-function filterToolsByAgent(tools, agent) {
+function filterToolsByAgent(tools, agent, extendTools) {
   if (!tools?.length)
     return tools ?? [];
   return tools.filter((t) => {
+    if (t.metadata?.channelOnly === true) {
+      if (!extendTools || extendTools.length === 0)
+        return false;
+      if (!extendTools.includes(t.name))
+        return false;
+    }
     const allowedList = t.metadata?.allowedAgentTypes;
     if (!allowedList || allowedList.length === 0)
       return true;
@@ -957,7 +963,8 @@ class AgentComponent extends BaseComponent {
     this.defaultTools = tools;
   }
   getAvailableTools(agent, context) {
-    let tools = filterToolsByAgent([...this.defaultTools], agent);
+    const extendTools = context?.extendTools;
+    let tools = filterToolsByAgent([...this.defaultTools], agent, extendTools);
     logger2.debug(`[getAvailableTools] After defaultTools (filtered): ${tools.length} tools`, {
       toolNames: tools.map((t) => t.name)
     });
@@ -965,7 +972,7 @@ class AgentComponent extends BaseComponent {
       const componentTools = this.toolComponent.listTools({
         allowedAgent: agent.name
       });
-      const filteredComponentTools = filterToolsByAgent(componentTools, agent);
+      const filteredComponentTools = filterToolsByAgent(componentTools, agent, extendTools);
       tools = [...tools, ...filteredComponentTools];
       logger2.debug(`[getAvailableTools] After adding componentTools: ${tools.length} tools`, {
         componentToolNames: filteredComponentTools.map((t) => t.name)
@@ -987,7 +994,7 @@ class AgentComponent extends BaseComponent {
       });
     }
     if (context?.extraTools?.length) {
-      const filteredExtraTools = filterToolsByAgent(context.extraTools, agent);
+      const filteredExtraTools = filterToolsByAgent(context.extraTools, agent, extendTools);
       tools = [...tools, ...filteredExtraTools];
       logger2.debug(`[getAvailableTools] After extraTools (filtered): ${tools.length} tools`, {
         extraToolNames: filteredExtraTools.map((t) => t.name)
@@ -1929,7 +1936,8 @@ class AgentComponent extends BaseComponent {
           ...ctx._runId ? { runId: ctx._runId } : {},
           ...ctx.context.sessionId ? { sessionId: ctx.context.sessionId } : {},
           ...ctx.context.agentType ? { agentType: ctx.context.agentType } : {},
-          ...ctx.agent?.name ? { agentName: ctx.agent.name } : {}
+          ...ctx.agent?.name ? { agentName: ctx.agent.name } : {},
+          ...ctx.context.extendTools?.length ? { extendTools: ctx.context.extendTools } : {}
         }
       };
       const request = {

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

@@ -4,7 +4,7 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

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

@@ -8,7 +8,7 @@ import {
 } from "./roy-agent-core-qxnbvgwe.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,7 +1,7 @@
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,6 +1,6 @@
 import {
   init_sqlite_task_store
-} from "./roy-agent-core-ezvpreqz.js";
+} from "./roy-agent-core-6k8mb7zx.js";
 
 // src/env/task/storage/index.ts
 init_sqlite_task_store();

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

@@ -2,10 +2,10 @@ import {
   WorkflowRepository,
   migrateEmptyTagsToDefault,
   rowToWorkflow
-} from "./roy-agent-core-r5wt1h3c.js";
-import"./roy-agent-core-mcy5apay.js";
+} from "./roy-agent-core-4fkxy2gv.js";
+import"./roy-agent-core-vf9sp6s3.js";
 import"./roy-agent-core-rvxg1wps.js";
-import"./roy-agent-core-qq96p0tj.js";
+import"./roy-agent-core-5s2t8z00.js";
 import"./roy-agent-core-7f7t9wwp.js";
 import"./roy-agent-core-85xyctnb.js";
 import"./roy-agent-core-fs0mn2jk.js";

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

@@ -9,7 +9,7 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

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

@@ -1,21 +1,21 @@
 import {
   LarkCardPatchNotifier,
   formatDurationMs
-} from "./roy-agent-core-7dd0s3xb.js";
+} from "./roy-agent-core-shb1qsyg.js";
 import {
   WorkflowHookPoints,
   init_workflow_hook_points
-} from "./roy-agent-core-c2gbt68e.js";
+} from "./roy-agent-core-h83zdsrq.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getEnvContextOrEmpty
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

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

@@ -0,0 +1,56 @@
+// src/env/tool/validator.ts
+import { ZodError } from "zod";
+var REASON_REQUIRED_CONFIG_KEY = "tool.reason.required";
+var moduleLevelReasonRequired = true;
+var configComponentRef = null;
+function setToolReasonConfigComponent(component) {
+  configComponentRef = component;
+}
+function isToolReasonRequired() {
+  if (configComponentRef) {
+    const v = configComponentRef.get(REASON_REQUIRED_CONFIG_KEY);
+    if (typeof v === "boolean")
+      return v;
+    if (typeof v === "string")
+      return v !== "false";
+  }
+  return moduleLevelReasonRequired;
+}
+
+class ToolValidator {
+  async validate(tool, args) {
+    if (isToolReasonRequired()) {
+      const reason = args?.["reason"];
+      if (typeof reason !== "string" || reason.trim() === "") {
+        return {
+          success: false,
+          error: `Missing or empty required parameter 'reason' for tool '${tool.name}': ` + `provide a one-sentence explanation of why you are calling this tool.`
+        };
+      }
+    }
+    try {
+      const parsed = await tool.parameters.parseAsync(args);
+      return {
+        success: true,
+        data: parsed
+      };
+    } catch (error) {
+      if (error instanceof ZodError) {
+        const errorMessage = tool.formatValidationError ? tool.formatValidationError(error) : this.formatError(error);
+        return {
+          success: false,
+          error: `Invalid arguments for tool '${tool.name}': ${errorMessage}`
+        };
+      }
+      return {
+        success: false,
+        error: `Validation error: ${error}`
+      };
+    }
+  }
+  formatError(error) {
+    return error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
+  }
+}
+
+export { setToolReasonConfigComponent, isToolReasonRequired, ToolValidator };

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

@@ -1,6 +1,6 @@
 import {
   safeParseToolArgs
-} from "./roy-agent-core-fghc2m8z.js";
+} from "./roy-agent-core-aa8kv18f.js";
 
 // src/env/session/session-message-converter.ts
 import { randomUUID } from "crypto";

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

@@ -439,7 +439,7 @@ subSessionId: sub-session-xyz
 | session 规模 | 建议处置 |
 |---|---|
 | **小**（超限比例 < 30%，消息数不多） | 直接 \`compact_session\` → 压缩成功后用 \`sub_session_id\` 续跑 |
-| **大**（超限比例很高 / 消息数很多） | \`compact_session\` **可能要跑很久甚至撞 120s 工具超时** → **不要在同一个 session 上死磕**，直接**开新 session** + 明确列出「已完成项 / 断点 / 小目标」 |
+| **大**（超限比例很高 / 消息数很多） | \`compact_session\` **可能要跑很久甚至撞 120s 工具超时** → **不要在同一个 session 上死磕**，走下面的**兜底路径**（压缩复查 → 仍无效才开新 session）+ 明确列出「已完成项 / 断点 / 小目标」 |
 
 **为什么必须先评估**（实测数据）：
 
@@ -474,7 +474,7 @@ const r = await compact_session({ session_id: "sub-session-xyz" });
 2. **再检查一次**该 session 的**消息数 / checkpoint** —— \`compact_session\` 成功会返回 \`checkpointId\`，也可以用 session 相关工具确认消息是否已被 archived
 3. 再决定走哪条路：
    - **压缩其实成功了** → 用 \`sub_session_id\` 续跑（上下文已经变小，安全）
-   - **压缩确实没生效** → 才走下面的「开新 session」路径
+   - **压缩确实没生效** → 才走下面的兜底路径（换新 session）
 
 **第 3 步：带同一个 \`sub_session_id\` 续跑**
 
@@ -502,9 +502,9 @@ delegate_task({
 
 \`\`\`typescript
 delegate_task({
-  description: "接续工作（上下文已超限，改用新 session）",
+  description: "接续工作（上下文已超限，压缩复查后仍不可救，换新 session）",
   prompt: "【已完成】... \\n【断点】... \\n【小目标】... \\n【相关文件路径】... \\n【已知结论】...",
-  // 不传 sub_session_id —— 开新 session
+  sub_session_id: "sub-session-xyz",  // ⚠️ 兜底路径：仅在 compact_session 也无效时才省略
 });
 \`\`\`
 
@@ -512,9 +512,9 @@ delegate_task({
 
 #### ❌ 反模式警示
 
-- ❌ **不要从头重新委托**（不传 \`sub_session_id\` 直接 \`delegate_task\`）—— 丢掉全部上下文，前面的调研和代码全白做，还可能重复踩已解决过的坑。
-- ❌ **不要在压缩失败时反复用同一个 session 续跑** —— 同样的超限会再发生一次，徒增 token 消耗。压缩失败就走"开新 session + 明确列出已完成项/断点/小目标"的兜底路径。
-- ❌ **不要在 session 规模很大时死磕 \`compact_session\`** —— 先按第 0 步评估，message 数很多就直接开新 session。
+- ❌ **不要从头重新委托** —— 不传 \`sub_session_id\` 直接 \`delegate_task\` 是**最后手段**，只在旧 session 上下文已确认不可救（compact_session 后仍超限 / 迭代上限且无可复用断点）时才允许。其余情况一律带 \`sub_session_id\` 续跑（不传才会丢掉全部上下文，前面的调研和代码全白做，还可能重复踩已解决过的坑）。
+- ❌ **不要在压缩失败时反复用同一个 session 续跑** —— 同样的超限会再发生一次，徒增 token 消耗。压缩失败就走"换新 session（不传 \`sub_session_id\`）+ 明确列出已完成项/断点/小目标"的兜底路径。
+- ❌ **不要在 session 规模很大时死磕 \`compact_session\`** —— 先按第 0 步评估，message 数很多就走兜底路径（压缩复查 → 仍无效才换新 session）。
 - ❌ **不要用 \`compact_session\` 压缩当前会话自己** —— 工具会直接拒绝（自毁）。
 - ❌ **不要压缩还在 running/pending 的后台任务** —— 先 \`stop_task\`。
 

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

@@ -1,9 +1,9 @@
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getEnvContext
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   __esm
 } from "./roy-agent-core-fs0mn2jk.js";

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

@@ -1,13 +1,13 @@
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-dqxec05w.js";
+} from "./roy-agent-core-bjtc9d35.js";
 import"./roy-agent-core-1db4vpc6.js";
 import"./roy-agent-core-mkc3zshb.js";
-import"./roy-agent-core-cpcd24n2.js";
-import"./roy-agent-core-qqaak24r.js";
-import"./roy-agent-core-7cbpmk4q.js";
-import"./roy-agent-core-qq96p0tj.js";
+import"./roy-agent-core-yet36q5k.js";
+import"./roy-agent-core-tkpp1ba0.js";
+import"./roy-agent-core-p31ftgq9.js";
+import"./roy-agent-core-5s2t8z00.js";
 import"./roy-agent-core-7f7t9wwp.js";
 import"./roy-agent-core-85xyctnb.js";
 import"./roy-agent-core-fs0mn2jk.js";

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

@@ -1,6 +1,6 @@
 import {
   builtInHandlers
-} from "./roy-agent-core-xf6z96qy.js";
+} from "./roy-agent-core-gr5h1dyr.js";
 import {
   appendAuditLog,
   checkSourceCountDrop,
@@ -12,11 +12,11 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.7.85",
+  "version": "1.7.88",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",
@@ -72,6 +72,14 @@
       "types": "./dist/env/event-source/wecom-respond-registry.d.ts",
       "default": "./dist/env/event-source/wecom-respond-registry.js"
     },
+    "./env/event-source/wecom-session-card-sender": {
+      "import": "./dist/env/event-source/wecom-session-card-sender.js",
+      "types": "./dist/env/event-source/wecom-session-card-sender.d.ts"
+    },
+    "./env/task/plugins/wecom-session-card-store": {
+      "import": "./dist/env/task/plugins/wecom-session-card-store.js",
+      "types": "./dist/env/task/plugins/wecom-session-card-store.d.ts"
+    },
     "./env/event-source/idempotency-key": {
       "import": "./dist/env/event-source/idempotency-key.js",
       "types": "./dist/env/event-source/idempotency-key.d.ts",