@ai-setting/roy-agent-core 1.7.49 → 1.7.51

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

@@ -1,14 +1,14 @@
 import {
   AgentComponentAdapter,
   init_agent_component_adapter
-} from "./roy-agent-core-xmfyt3dg.js";
+} from "./roy-agent-core-6167phd4.js";
 import"./roy-agent-core-1db4vpc6.js";
 import"./roy-agent-core-ze068vc9.js";
 import"./roy-agent-core-e25xkv53.js";
-import"./roy-agent-core-mqaht7mm.js";
-import"./roy-agent-core-emjpkx9s.js";
-import"./roy-agent-core-fm77q3tn.js";
-import"./roy-agent-core-bt6h398s.js";
+import"./roy-agent-core-4z3rq5gw.js";
+import"./roy-agent-core-k8b440n3.js";
+import"./roy-agent-core-5apmk4qw.js";
+import"./roy-agent-core-dsevjbck.js";
 import"./roy-agent-core-8seq65bp.js";
 import"./roy-agent-core-jnszp0jq.js";
 import"./roy-agent-core-fs0mn2jk.js";

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

@@ -1,6 +1,6 @@
 import {
   builtInPrompts
-} from "./roy-agent-core-223v204d.js";
+} from "./roy-agent-core-gdsqp6j8.js";
 import {
   getXDGPath
 } from "./roy-agent-core-qxnbvgwe.js";
@@ -10,14 +10,14 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-xn12d221.js";
+} from "./roy-agent-core-tdbv7ff4.js";
 import {
   createHook
-} from "./roy-agent-core-khx0h4j2.js";
+} from "./roy-agent-core-qcspfszy.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-mqaht7mm.js";
+} from "./roy-agent-core-4z3rq5gw.js";
 import {
   createLogger,
   init_logger

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

@@ -3,17 +3,17 @@ import {
 } from "./roy-agent-core-az13yzmc.js";
 import {
   BaseComponent
-} from "./roy-agent-core-xn12d221.js";
+} from "./roy-agent-core-tdbv7ff4.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-mqaht7mm.js";
+} from "./roy-agent-core-4z3rq5gw.js";
 import {
   init_context
-} from "./roy-agent-core-emjpkx9s.js";
+} from "./roy-agent-core-k8b440n3.js";
 import {
   getEnvContextOrEmpty
-} from "./roy-agent-core-fm77q3tn.js";
+} from "./roy-agent-core-5apmk4qw.js";
 import {
   createLogger,
   init_logger

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

@@ -1,11 +1,13 @@
 import {
-  createHook
-} from "./roy-agent-core-khx0h4j2.js";
+  createHook,
+  init_hook
+} from "./roy-agent-core-qcspfszy.js";
 import {
   HookManager
-} from "./roy-agent-core-mqaht7mm.js";
+} from "./roy-agent-core-4z3rq5gw.js";
 
 // src/env/component.ts
+init_hook();
 class BaseComponent {
   _status = "created";
   _enabled = true;

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

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

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

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

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

@@ -1,13 +1,13 @@
 import {
   isValidSessionId
-} from "./roy-agent-core-m9drr1fd.js";
+} from "./roy-agent-core-yd21n6c7.js";
 import {
   TAG_MAX_COUNT,
   TAG_MIN_COUNT
-} from "./roy-agent-core-wt37tszm.js";
+} from "./roy-agent-core-7evvpfwc.js";
 import {
   validateWorkflowDefinition
-} from "./roy-agent-core-98wwn2px.js";
+} from "./roy-agent-core-na73mym1.js";
 import {
   getCurrentBgTaskId
 } from "./roy-agent-core-c1v263jn.js";
@@ -18,7 +18,7 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-bt6h398s.js";
+} from "./roy-agent-core-dsevjbck.js";
 import {
   createLogger,
   init_logger
@@ -485,7 +485,7 @@ var WorkflowValidateInputSchema = z6.object({
 function createWorkflowValidateTool(_workflowService) {
   return {
     name: "workflow_validate",
-    description: `Validate a workflow definition (YAML or JSON) without persisting it. ` + `Checks for: duplicate node IDs, missing dependencies, cycles, empty node IDs. ` + `Returns { valid: boolean, errors: string[], workflowName?, nodeCount }. ` + `Use this BEFORE workflow_add to ensure the workflow is structurally sound.`,
+    description: `Validate a workflow definition (YAML or JSON) without persisting it. ` + `Checks (1) DAG structure: duplicate node IDs, missing dependencies, cycles, empty node IDs; ` + `(2) template-reference contracts: whether {{nodes.X.<field>}} matches node X's output shape ` + `(e.g. {{nodes.<toolNode>.result}} is an ERROR — tool nodes expose ".output", not ".result"). ` + `Returns { valid, errors: string[], warnings?: string[], infos?: string[], workflowName?, ` + `nodeCount, errorCount, warningCount }. ` + `Use this BEFORE workflow_add; fix EVERY error (and evaluate each warning) before registering.`,
     parameters: WorkflowValidateInputSchema,
     execute: async (args, _ctx) => {
       try {
@@ -524,16 +524,29 @@ function createWorkflowValidateTool(_workflowService) {
         }
         const result = validateWorkflowDefinition(definition);
         const nodeCount = Array.isArray(definition.nodes) ? definition.nodes.length : 0;
+        const warnings = result.warnings ?? [];
+        const infos = result.infos ?? [];
         const output = {
           valid: result.valid,
           errors: result.errors,
+          warnings,
+          infos,
           workflowName: definition.name,
-          nodeCount
+          nodeCount,
+          errorCount: result.errors.length,
+          warningCount: warnings.length
         };
+        const errorText = result.valid ? undefined : `Validation failed (${result.errors.length} error(s)):
+` + result.errors.map((e, i) => `  ${i + 1}. ${e}`).join(`
+`) + (warnings.length > 0 ? `
+
+Advisory warnings (${warnings.length}) — evaluate and fix where sensible:
+` + warnings.map((w, i) => `  - ${w}`).join(`
+`) : "");
         return {
           success: result.valid,
           output: JSON.stringify(output, null, 2),
-          error: result.valid ? undefined : `Validation failed: ${result.errors.join("; ")}`,
+          error: errorText,
           metadata: { execution_time_ms: 0 }
         };
       } catch (error) {

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

@@ -6,10 +6,13 @@ import {
   createLarkCliTaskNotifyHook,
   createPerTaskGroupChatPlugin,
   mergeChatOwnership
-} from "./roy-agent-core-5vf48m39.js";
+} from "./roy-agent-core-kyasfzeh.js";
 import {
   getSharedEventStore
-} from "./roy-agent-core-zff8vvs5.js";
+} from "./roy-agent-core-yhsssn86.js";
+import {
+  createLarkCliWorkflowNotifyHook
+} from "./roy-agent-core-wxsgay02.js";
 import {
   normalizeLarkAtMentions
 } from "./roy-agent-core-64f22h1g.js";
@@ -18,24 +21,24 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-xn12d221.js";
+} from "./roy-agent-core-tdbv7ff4.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-mqaht7mm.js";
+} from "./roy-agent-core-4z3rq5gw.js";
 import {
   init_context
-} from "./roy-agent-core-emjpkx9s.js";
+} from "./roy-agent-core-k8b440n3.js";
 import {
   createEnvContext,
   normalizeParentTaskId,
   runWithEnvContext
-} from "./roy-agent-core-fm77q3tn.js";
+} from "./roy-agent-core-5apmk4qw.js";
 import {
   TracedAs,
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-bt6h398s.js";
+} from "./roy-agent-core-dsevjbck.js";
 import {
   createLogger,
   getTracerProvider,
@@ -846,6 +849,7 @@ function isPluginDebugEnabled() {
 }
 var BUILT_IN_PLUGIN_FACTORIES = {
   LarkCliTaskNotifyPlugin: (cfg) => createLarkCliTaskNotifyHook(cfg),
+  LarkCliWorkflowNotifyPlugin: (cfg) => createLarkCliWorkflowNotifyHook(cfg),
   PerTaskGroupChatPlugin: (cfg) => createPerTaskGroupChatPlugin(cfg),
   "task-tag": () => new TaskTagPlugin
 };
@@ -1208,6 +1212,9 @@ class LarkCliInstance {
     if (Array.isArray(plugin.hooks)) {
       return plugin.hooks.map((h) => h.point || h);
     }
+    if (Array.isArray(plugin.hookPoints)) {
+      return plugin.hookPoints.map((h) => h.point || h);
+    }
     if (typeof plugin.execute === "function" && plugin.hookPoint) {
       return [plugin.hookPoint];
     }

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

@@ -0,0 +1,302 @@
+import {
+  LarkCardPatchNotifier,
+  formatDurationMs
+} from "./roy-agent-core-zd077w51.js";
+import {
+  WorkflowHookPoints,
+  init_workflow_hook_points
+} from "./roy-agent-core-9csa89jx.js";
+import {
+  init_context
+} from "./roy-agent-core-k8b440n3.js";
+import {
+  getEnvContextOrEmpty
+} from "./roy-agent-core-5apmk4qw.js";
+import {
+  TracedAs,
+  init_decorator
+} from "./roy-agent-core-dsevjbck.js";
+import {
+  createLogger,
+  init_logger
+} from "./roy-agent-core-8seq65bp.js";
+import {
+  __legacyDecorateClassTS
+} from "./roy-agent-core-fs0mn2jk.js";
+
+// src/env/workflow/plugins/lark-cli-workflow-notify-plugin.ts
+init_decorator();
+init_logger();
+init_context();
+init_workflow_hook_points();
+var logger = createLogger("lark-cli:workflow-notify");
+
+class LarkCliWorkflowNotifyHook {
+  name;
+  priority;
+  description;
+  pluginName;
+  sourceId;
+  hookPoints = [
+    WorkflowHookPoints.BEFORE_RUN,
+    WorkflowHookPoints.AFTER_RUN,
+    WorkflowHookPoints.BEFORE_NODE,
+    WorkflowHookPoints.AFTER_NODE
+  ];
+  config;
+  cardNotifier;
+  cardMessageIds = new Map;
+  lastNodeNotifyTimestamps = new Map;
+  static CARD_START_FAILED_SENTINEL = "__wf_card_start_failed__";
+  static CARD_START_INFLIGHT_SENTINEL = "__wf_card_start_inflight__";
+  constructor(config = {}) {
+    this.name = config.pluginName || "LarkCliWorkflowNotifyPlugin";
+    this.priority = config.priority ?? 5;
+    this.description = "LarkCli workflow 进展通知 Hook（卡片模式）";
+    this.pluginName = config.pluginName;
+    this.sourceId = config.sourceId;
+    this.config = {
+      enabled: true,
+      priority: 5,
+      ...config
+    };
+    this.cardNotifier = config.cardNotifier ?? new LarkCardPatchNotifier;
+  }
+  async execute(ctx) {
+    if (!this.config.enabled)
+      return;
+    const env = getEnvContextOrEmpty();
+    if (this.pluginName && this.sourceId) {
+      const key = `${this.sourceId}:${this.pluginName}`;
+      if (env.pluginEnabled && env.pluginEnabled[key] !== true) {
+        logger.debug(`Plugin not enabled for source: ${key}`);
+        return;
+      }
+    }
+    switch (ctx.hookPoint) {
+      case WorkflowHookPoints.BEFORE_RUN:
+        await this.onBeforeRun(ctx);
+        break;
+      case WorkflowHookPoints.AFTER_RUN:
+        await this.onAfterRun(ctx);
+        break;
+      case WorkflowHookPoints.BEFORE_NODE:
+        await this.onBeforeNode(ctx);
+        break;
+      case WorkflowHookPoints.AFTER_NODE:
+        await this.onAfterNode(ctx);
+        break;
+      default:
+        logger.debug(`ignored hook point: ${ctx.hookPoint}`);
+    }
+  }
+  async onBeforeRun(ctx) {
+    const data = ctx.data;
+    if (!data?.runId)
+      return;
+    await this.sendCardStart(data);
+  }
+  async onBeforeNode(ctx) {
+    const data = ctx.data;
+    if (!data?.runId)
+      return;
+    if (this.shouldThrottleNodeStart(data.runId))
+      return;
+    const timestamp = new Date().toISOString();
+    await this.patchCard(data, {
+      currentNode: data.nodeId,
+      currentNodeType: data.nodeType,
+      processSteps: [
+        {
+          title: `${data.nodeId} 开始`,
+          timestamp,
+          category: data.nodeType
+        }
+      ]
+    });
+  }
+  async onAfterNode(ctx) {
+    const data = ctx.data;
+    if (!data?.runId)
+      return;
+    const timestamp = new Date().toISOString();
+    const nodeStatus = String(data.status);
+    const succeeded = nodeStatus === "completed" || nodeStatus === "skipped";
+    const statusText = succeeded ? "完成" : "失败";
+    const durationText = formatDurationMs(data.durationMs);
+    const description = data.error ?? (durationText ? `耗时 ${durationText}` : succeeded ? undefined : `节点状态：${nodeStatus}`);
+    const processSteps = [
+      {
+        title: `${data.nodeId} ${statusText}`,
+        timestamp,
+        endTimestamp: timestamp,
+        description,
+        category: data.nodeType
+      }
+    ];
+    const milestones = succeeded || !data.error ? [] : [
+      {
+        title: `节点失败：${data.nodeId}`,
+        timestamp,
+        description: data.error
+      }
+    ];
+    await this.patchCard(data, {
+      currentNode: data.nodeId,
+      currentNodeType: data.nodeType,
+      milestones,
+      processSteps
+    });
+  }
+  async onAfterRun(ctx) {
+    const data = ctx.data;
+    if (!data?.runId)
+      return;
+    const messageId = this.cardMessageIds.get(data.runId);
+    if (!messageId || messageId === LarkCliWorkflowNotifyHook.CARD_START_FAILED_SENTINEL || messageId === LarkCliWorkflowNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
+      logger.debug(`onAfterRun: no card for run ${data.runId}, skip`);
+      return;
+    }
+    const status = this.mapRunStatus(data.status);
+    const target = this.resolveTarget();
+    const profile = target.profile;
+    try {
+      await this.cardNotifier.finishWorkflow({
+        messageId,
+        chatId: target.chatId,
+        profile,
+        status,
+        meta: this.buildWorkflowMeta(data),
+        completedNodes: data.completedNodes,
+        totalNodes: data.totalNodes,
+        durationMs: data.durationMs,
+        error: data.error ?? data.stopReason,
+        finalStep: data.status === "completed" ? undefined : data.stopReason
+      });
+      this.cardMessageIds.delete(data.runId);
+      this.lastNodeNotifyTimestamps.delete(`node:${data.runId}`);
+    } catch (err) {
+      logger.error(`sendCardFinish failed for workflow run ${data.runId}: ${err.message}`);
+    }
+  }
+  async sendCardStart(data) {
+    if (!this.cardNotifier)
+      return;
+    const claim = this.cardMessageIds.get(data.runId);
+    if (claim) {
+      logger.debug(`sendCardStart: run ${data.runId} 已有首卡（${claim}）→ 跳过重复建卡`);
+      return;
+    }
+    this.cardMessageIds.set(data.runId, LarkCliWorkflowNotifyHook.CARD_START_INFLIGHT_SENTINEL);
+    const target = this.resolveTarget();
+    if (!target.chatId) {
+      this.cardMessageIds.delete(data.runId);
+      logger.debug(`sendCardStart: no chatId for run ${data.runId}, skip`);
+      return;
+    }
+    try {
+      const res = await this.cardNotifier.startWorkflow({
+        chatId: target.chatId,
+        profile: target.profile,
+        meta: this.buildWorkflowMeta(data),
+        totalNodes: data.totalNodes,
+        completedNodes: data.completedNodes ?? 0,
+        milestones: [
+          {
+            title: "Workflow 启动",
+            timestamp: new Date().toISOString(),
+            description: data.workflowName
+          }
+        ]
+      });
+      this.cardMessageIds.set(data.runId, res.messageId);
+      logger.debug(`sendCardStart: run ${data.runId} → message ${res.messageId} ` + `(pinned=${res.pinned}) chat=${target.chatId}`);
+    } catch (err) {
+      this.cardMessageIds.set(data.runId, LarkCliWorkflowNotifyHook.CARD_START_FAILED_SENTINEL);
+      logger.error(`sendCardStart failed for run ${data.runId}: ${err.message}`);
+    }
+  }
+  async patchCard(data, extra) {
+    if (!this.cardNotifier)
+      return;
+    const messageId = this.cardMessageIds.get(data.runId);
+    if (!messageId) {
+      logger.debug(`patchCard: no card for run ${data.runId}, skip`);
+      return;
+    }
+    if (messageId === LarkCliWorkflowNotifyHook.CARD_START_FAILED_SENTINEL || messageId === LarkCliWorkflowNotifyHook.CARD_START_INFLIGHT_SENTINEL) {
+      logger.debug(`patchCard: card not ready for run ${data.runId} (${messageId}), skip`);
+      return;
+    }
+    const target = this.resolveTarget();
+    if (!target.chatId) {
+      logger.debug(`patchCard: no chatId for run ${data.runId}, skip`);
+      return;
+    }
+    try {
+      await this.cardNotifier.updateWorkflow({
+        messageId,
+        chatId: target.chatId,
+        profile: target.profile,
+        status: "running",
+        meta: this.buildWorkflowMeta(data),
+        completedNodes: data.completedNodes,
+        totalNodes: data.totalNodes,
+        currentNode: extra.currentNode,
+        currentNodeType: extra.currentNodeType,
+        milestones: extra.milestones,
+        processSteps: extra.processSteps
+      });
+    } catch (err) {
+      logger.error(`patchCard failed for run ${data.runId}: ${err.message}`);
+    }
+  }
+  resolveTarget() {
+    const env = getEnvContextOrEmpty();
+    const rc = env.replyChannel;
+    return {
+      chatId: rc?.chatId,
+      profile: rc?.profile
+    };
+  }
+  buildWorkflowMeta(data) {
+    const run = data;
+    return {
+      runId: data.runId,
+      workflowName: data.workflowName,
+      workflowId: run.workflowId,
+      input: run.input
+    };
+  }
+  mapRunStatus(status) {
+    switch (String(status)) {
+      case "completed":
+        return "completed";
+      case "stopped":
+        return "stopped";
+      default:
+        return "failed";
+    }
+  }
+  shouldThrottleNodeStart(runId) {
+    const throttleMs = this.config.nodeThrottleMs ?? 3000;
+    if (throttleMs <= 0)
+      return false;
+    const key = `node:${runId}`;
+    const now = Date.now();
+    const last = this.lastNodeNotifyTimestamps.get(key);
+    if (last && now - last < throttleMs) {
+      logger.debug(`[throttle] skip before.node patch for run ${runId} (${now - last}ms ago)`);
+      return true;
+    }
+    this.lastNodeNotifyTimestamps.set(key, now);
+    return false;
+  }
+}
+__legacyDecorateClassTS([
+  TracedAs("lark-cli-workflow-notify.execute")
+], LarkCliWorkflowNotifyHook.prototype, "execute", null);
+function createLarkCliWorkflowNotifyHook(config = {}) {
+  return new LarkCliWorkflowNotifyHook(config);
+}
+export { LarkCliWorkflowNotifyHook, createLarkCliWorkflowNotifyHook };

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

@@ -1,7 +1,7 @@
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-bt6h398s.js";
+} from "./roy-agent-core-dsevjbck.js";
 import {
   __esm,
   __legacyDecorateClassTS

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

@@ -16,11 +16,11 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-xn12d221.js";
+} from "./roy-agent-core-tdbv7ff4.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-bt6h398s.js";
+} from "./roy-agent-core-dsevjbck.js";
 import {
   createLogger,
   init_logger

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

@@ -1,7 +1,7 @@
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-bt6h398s.js";
+} from "./roy-agent-core-dsevjbck.js";
 import {
   __legacyDecorateClassTS,
   __require