aitable-workflow-cli 0.1.23 → 0.1.24

package/templates/support-qa/workflows/daily-review/recipes/daily_review_handler.recipe.ts

@@ -1,26 +0,0 @@
-import type { EventHandlerRecipeDefinition, HandlerInitContext, HandlerInstance } from "aitable-workflow-core";
-
-/** cron tick → 建一条每日复盘工单(实际复盘逻辑在 daily_review step recipe) */
-const recipe: EventHandlerRecipeDefinition = {
-  meta: { id: "daily_review_handler", name: "每日复盘触发器", description: "cron tick → 建一条每日复盘工单" },
-  create(ctx: HandlerInitContext): HandlerInstance {
-    return {
-      onEvent(event) {
-        const firedAt = String(event.payload?.firedAt ?? new Date().toISOString());
-        // cron 事件携带调度时区与预定时刻；按时区取运行日期，避免 UTC 运行环境下标题日期错位
-        const timezone = typeof event.payload?.timezone === "string" ? (event.payload.timezone as string) : "Asia/Shanghai";
-        const scheduledFor = String(event.payload?.scheduledFor ?? firedAt);
-        let dateStr: string;
-        try {
-          dateStr = new Intl.DateTimeFormat("en-CA", { timeZone: timezone, year: "numeric", month: "2-digit", day: "2-digit" }).format(new Date(scheduledFor));
-        } catch {
-          dateStr = scheduledFor.slice(0, 10); // 时区非法时回退
-        }
-        ctx.log(`每日复盘触发 @ ${firedAt} (tz=${timezone}, 运行日=${dateStr})`);
-        ctx.pushEvent({ action: "create_record", fields: { "标题": `每日复盘 ${dateStr}` } });
-      },
-      stop() {},
-    };
-  },
-};
-export default recipe;

package/templates/support-qa/workflows/daily-review/workflow.yml

@@ -1,65 +0,0 @@
-meta:
-  name: "每日复盘"
-  version: "1.0.0"
-  domain: daily_review
-  description: "每日凌晨读取各群昨日短期记忆,coding agent 压缩/统计/需求Bug 抽取,写长期记忆+每日统计表+产品需求池;有活动才留痕(不发群)"
-
-notification:
-  channel: "none"
-
-# ─── 复盘留痕表(每个有活动的复盘日留一行运行记录;table_id 留空 setup 自动建表回写)──
-# ⚠️ 占位:部署前替换为你自己的 base_id/table_id;不可与 group-qa 同表
-tracker:
-  label: "每日复盘留痕表"
-  description: "记录每日复盘运行:日期/处理群数/需求Bug数/摘要"
-  base_id: ""
-  table_id: ""
-  states:
-    initial: "待处理"
-    active: [ "处理中" ]
-    terminal: [ "已完成", "已关闭" ]
-    blocked: "已阻塞"
-  fields:
-    state: "状态"
-    title: "标题"
-    current_step: "当前步骤"
-    event_log: "事件日志"
-  field_definitions:
-    - name: 复盘日期
-      type: text
-    - name: 处理群数
-      type: text
-    - name: 需求Bug数
-      type: text
-    - name: 摘要
-      type: text
-  views:
-    - id: default_grid
-      type: Grid
-      name: 表格
-      field_order: [ 标题, 复盘日期, 处理群数, 需求Bug数, 摘要, 状态, 当前步骤, 事件日志 ]
-      description: 每日复盘留痕
-
-# ─── 事件源：cron 每日触发,on_demand(无活动不建行)──
-event_sources:
-  - name: 每日复盘调度
-    type: cron_scheduler
-    handler: daily_review_handler
-    record_policy: on_demand
-
-steps:
-  - id: daily_review
-    name: "每日复盘"
-    recipe: daily_review
-    auto: true
-    output_mapping:
-      review_date: "复盘日期"
-      group_count: "处理群数"
-      needs_bug_count: "需求Bug数"
-      summary: "摘要"
-
-edges:
-  - from: __start__
-    to: daily_review
-  - from: daily_review
-    to: __end__

package/templates/support-qa/workflows/group-qa/recipes/answer.recipe.ts

@@ -1,231 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { z } from "zod";
-import type { RecipeDefinition, RecipeContext, RecipeResult } from "aitable-workflow-core";
-import { contractPromptBlock, extractSupportReply, type SupportReply } from "../../../lib/contract.js";
-import { runSandboxAgent } from "../../../lib/sandbox-agent.js";
-import { SUPPORT_DECISION_CONTENT, SUPPORT_MEMORY_KINDS, SUPPORT_MEMORY_ROLES, questionKey, supportEntry, supportScope } from "../../../lib/memory-events.js";
-
-/**
- * 单 agent 应答（support-qa L0）
- *
- * 一次 sandbox-agent.run 让 Aone Sandbox 内的 QoderRemoteAgent 依据知识库 +
- * 近期对话上下文，按契约返回严格 JSON：
- *   { action, reason, reply?, module? }（契约单一事实源见 lib/contract.ts）
- *
- * 拍平 action 契约（spec 2026-07-28）：
- *   1. 单一 action 取代 shouldReply + silenceCode 的组合歧义（Bug/Feature 不再坠入 kb_gap）；
- *   2. agent 失败/解析失败先重试 1 次，仍失败 → action=agent_failure 且写短期记忆
- *      （故障与"判定型静默"分开审计，绝不混入 kb_gap 知识待办）；
- *   3. 追问补位闸门参数（profile gates.standby）动态注入 prompt；
- *   4. 本步对静默类 action 一律 tracker:false —— 留痕与否由下游 on_action 按 profile 裁决。
- */
-
-const MAX_AGENT_ATTEMPTS = 2; // 1 次正常 + 1 次重试
-
-async function runAgentOnce(
-  ctx: RecipeContext,
-  prompt: string,
-  workDir: string,
-  attempt: number,
-): Promise<SupportReply | null> {
-  try {
-    const result = await runSandboxAgent(prompt, workDir, ctx.log);
-    if (!result.response) return null;
-    const decision = extractSupportReply(result.response);
-    if (!decision) {
-      ctx.log(
-        `agent 第 ${attempt} 次输出不符合契约 sandboxId=${result.sandboxId} sessionId=${result.sessionId} responseLength=${result.response.length}: ${JSON.stringify(result.response)}`,
-      );
-    }
-    return decision;
-  } catch (error) {
-    ctx.log(`agent 第 ${attempt} 次调用失败: ${error instanceof Error ? error.message : String(error)}`);
-    return null;
-  }
-}
-
-const recipe: RecipeDefinition = {
-  meta: {
-    id: "answer",
-    name: "单 agent 应答",
-    role: "support",
-    description: "一次 agent 调用产出契约 JSON（action/reason/reply/module）",
-    version: "1.0.0",
-    requiresAgent: true,
-    timeoutMs: 420_000,
-    config: z.object({
-      standby: z.object({
-        enabled: z.boolean().describe("是否启用追问补位"),
-        wait_minutes: z.number().describe("等待时间（分钟）"),
-      }).optional().describe("追问补位（L3）：用户 @真人后超时无人回且用户追问时放行"),
-    }),
-  },
-
-  async execute(ctx: RecipeContext): Promise<RecipeResult> {
-    const { input, toolkit, log } = ctx;
-    const content = String(input.content ?? "");
-    const context = String(input.context ?? "").trim();
-    const senderName = String(input.senderName ?? "").trim();
-    const priorAction = String(input.action ?? "").trim();
-    const conversationId = String(input.conversationId ?? "").trim();
-
-    // 上游 Recipe（fastpath/troubleshoot 等 L3 包）已产出 action → 透传
-    if (priorAction) {
-      log(`已由上游 Recipe 处理(action=${priorAction})，answer 跳过`);
-      return { status: "success", output: {}, tracker: false, logs: [`透传：${priorAction}`] };
-    }
-
-    if (!content.trim()) {
-      return {
-        status: "success",
-        output: { action: "no_question", module: "", answer: "", reason: "空消息" },
-        tracker: false,
-        logs: ["空消息 → 静默"],
-      };
-    }
-
-    // profile 校验已前移到启动期（core preflight 扩展点加载 lib/preflight.ts）：
-    // 配置错在 `aitable-workflow run` 启动瞬间就报，不再每条消息判一次再降级静默。
-    const roleId = ctx.roleContext?.id?.trim() || "support";
-    const workDir = path.resolve(ctx.configDir, "workspaces", roleId);
-
-    // ─── 长期记忆注入（写入工作目录供 agent 按需 Read/Grep，仅辅助上下文） ───
-    let memSection = "";
-    try {
-      const longTerm = await toolkit.memory.readLongTerm(supportScope()).catch(() => "");
-      if (longTerm && longTerm.trim()) {
-        fs.mkdirSync(workDir, { recursive: true });
-        fs.writeFileSync(path.join(workDir, ".long-term.md"), longTerm, "utf8");
-        memSection = `\n## 长期记忆（可用，仅作辅助上下文，不作事实依据）
-- 近期群聊复盘沉淀的高频问题与趋势已写入工作目录下的 .long-term.md，可按需 Read/Grep 搜索以理解语境；一切事实依据仍只能来自知识库，不得据此作答。\n`;
-        log(`已写入长期记忆到 ${path.join(workDir, ".long-term.md")} (${longTerm.length} 字符)`);
-      }
-    } catch (err) {
-      log(`写入长期记忆失败(不影响主流程): ${err}`);
-    }
-
-    // ─── 追问补位闸门参数（profile 驱动，动态注入；AGENTS.md 含规则正文） ───
-    const sbCfg = ctx.config.standby as { enabled?: boolean; wait_minutes?: number } | undefined;
-    const standby = { enabled: sbCfg?.enabled ?? false, waitMinutes: sbCfg?.wait_minutes ?? 30 };
-    const standbyNote = standby.enabled
-      ? `\n**追问补位参数**：本实例已启用"@真人未响应补位"（闸门规则 7）：用户 @过真人负责人、且距该消息已超过 ${standby.waitMinutes} 分钟（依据对话历史 [hh:mm] 时间戳判断）、真人未回复、当前消息是用户对同一问题的追问 → 允许回答，reply 开头用一句补位语气（如"看到相关同学暂时没回，先提供帮助文档里的信息："）。\n`
-      : "\n**追问补位参数**：本实例未启用补位（闸门规则 7 不适用，用户 @真人后一律礼让静默）。\n";
-
-    const hasImage = /!\[图片\]\([^)]+\)/.test(content);
-    const imageNote = hasImage
-      ? "\n**本条消息包含图片**（已内联为 `![图片](路径)`）：请先用 Read 打开该图片，结合图片内容（多为报错截图/操作截图）理解用户的真实问题后再作答。\n"
-      : "";
-
-    // 前置拦截（非法 module 根治）：把 owner-map 的合法模块清单直接写进契约 prompt，
-    // 解析后再做出口校验——清单外的 module 在 producer 就地置空，不流入 on_action。
-    let moduleKeys: string[] = [];
-    try {
-      const ownerMap = JSON.parse(fs.readFileSync(path.join(workDir, "owner-map.json"), "utf8")) as Record<string, unknown>;
-      if (ownerMap && typeof ownerMap === "object" && !Array.isArray(ownerMap)) moduleKeys = Object.keys(ownerMap);
-    } catch {
-      // owner-map 缺失（无转人工配置）→ 退回通用契约描述，不阻断主流程
-    }
-
-    const assistantName = ctx.roleContext?.name ?? "答疑助手";
-    const prompt = `开始处理前，必须先使用 Read 读取并完整遵循本工作目录下的 AGENTS.md，将其作为本次答疑的完整业务执行规范。
-
-你是「${assistantName}」。用户在钉钉群中发出了以下消息，请按 AGENTS.md 的闸门规则先判定是否需要回复，再基于知识库为用户提供准确解答。
-
-在对话历史中，标记为"(答疑机器人/即你自己之前的回复)"的消息就是你之前发出的回复；标记为"(真人同事)"的是真人值班同事。
-${memSection}${standbyNote}
-${contractPromptBlock(moduleKeys)}
-
-示例（仅用于说明格式，内容请按用户的真实问题作答）：
-{"action":"reply","reason":"知识库有据","reply":"Hi 小明，单表上限 20 万行。\\n\\n> 来源:https://example.com/xxx"}
-{"action":"no_question","reason":"用户表示感谢，非有效提问"}
-{"action":"kb_gap","reason":"普通资源咨询，知识库无据"}
-{"action":"bug","module":"数据源","reason":"确认是异常但文档无明确结论","reply":"Hi 小明，当前能确认的是……；你描述的现象还需要进一步排查。"}
-
-要求：
-1. reply 开头先用「Hi ${senderName || "用户"}，」打招呼，然后直接给出解答内容，不要寒暄复述。
-2. 引用出处按 AGENTS.md 的来源规则附在 reply 末尾。
-${context ? `\n${context}\n` : ""}
-${imageNote}用户消息（发送者：${senderName || "未知"}）：
-${content}`;
-
-    log(`answer prompt 就绪（workDir=${workDir}）: ${content.slice(0, 60)}`);
-
-    // ─── 执行（失败重试 1 次；G9） ───
-    let decision: SupportReply | null = null;
-    for (let attempt = 1; attempt <= MAX_AGENT_ATTEMPTS && !decision; attempt++) {
-      if (attempt > 1) log(`agent 无有效响应/解析失败，重试第 ${attempt - 1} 次`);
-      decision = await runAgentOnce(ctx, prompt, workDir, attempt);
-    }
-
-    if (!decision) {
-      log("agent 重试后仍失败 → agent_failure 兜底静默（写记忆，交 on_action 处置）");
-      if (conversationId) {
-        void toolkit.memory.append(
-          supportScope(conversationId),
-          supportEntry({
-            kind: SUPPORT_MEMORY_KINDS.agentFailure,
-            content: content.slice(0, 200),
-            sender: "agent",
-            role: SUPPORT_MEMORY_ROLES.agent,
-            conversationId,
-            summary: `agent 失败兜底静默: ${content.slice(0, 80)}`,
-            meta: { action: "agent_failure", attempts: MAX_AGENT_ATTEMPTS, question: questionKey(content) },
-          }),
-        ).catch((err) => log(`memory.append(agent_failure) 失败(不影响主流程): ${err}`));
-      }
-      return {
-        status: "success",
-        output: { action: "agent_failure", module: "", answer: "", reason: "agent 重试后仍无有效响应" },
-        tracker: false, // 留痕与否由 on_action 按 profile 裁决
-        logs: ["agent_failure → 交 on_action 处置"],
-      };
-    }
-
-    const action = decision.action;
-    const isReplyBearing = action === "reply" || action === "bug" || action === "feature";
-    const reason = String(decision.reason ?? "");
-    const reply = String(decision.reply ?? "");
-    let module = String(decision.module ?? "");
-    // 出口校验：清单外的 module 视同未给出（on_action 会走降级发送，不会拿非法 key 去查 Owner）
-    if (module && moduleKeys.length > 0 && !moduleKeys.includes(module)) {
-      log(`invalid_module_stripped: 「${module}」不在 owner-map 清单中，已置空`);
-      module = "";
-    }
-
-    const output: Record<string, unknown> = {
-      action,
-      module,
-      reason,
-      answer: isReplyBearing ? reply : "",
-    };
-
-    // 决策写短期记忆（发送事实由 reply-to-group 在发送成功后另记）
-    if (conversationId) {
-      void toolkit.memory.append(
-        supportScope(conversationId),
-        supportEntry({
-          kind: SUPPORT_MEMORY_KINDS.agentDecision,
-          // 正文只记占位：话术真相在发送事实（agent_reply_sent/owner_escalation_sent），不在决策里存半成品副本
-          content: isReplyBearing ? SUPPORT_DECISION_CONTENT.reply : SUPPORT_DECISION_CONTENT.silent,
-          sender: "agent",
-          role: SUPPORT_MEMORY_ROLES.agent,
-          conversationId,
-          summary: `答疑决策: ${action}${module ? `[${module}]` : ""}${reason ? ` - ${reason.slice(0, 80)}` : ""}`,
-          meta: { action, module, reason, question: questionKey(content) },
-        }),
-      ).catch((err) => log(`memory.append(agent_decision) 失败(不影响主流程): ${err}`));
-    }
-
-    log(`决策: ${action}${module ? `[${module}]` : ""}${reason ? `（${reason}）` : ""}`);
-    return {
-      status: "success",
-      output,
-      // reply/bug/feature → 建行留痕；静默类 → 本步不表态（tracker:false），由 on_action 按 profile 裁决
-      ...(isReplyBearing ? {} : { tracker: false }),
-      logs: [`决策 ${action}`, reason].filter(Boolean),
-    };
-  },
-};
-
-export default recipe;