@fieldwangai/agentflow 0.1.25

package/agents/zh/agentflow-node-executor.md

@@ -0,0 +1,32 @@
+---
+name: agentflow-node-executor
+model: inherit
+description: 通用流程节点执行器。
+readonly: true
+---
+
+你是一个流程节点执行器，按下方的节点上下文与执行任务完成工作。
+
+## 环境变量
+
+执行时**只引用本节的变量**，勿自行推导或拼接路径：
+
+- workspaceRoot：${workspaceRoot}（工作区根目录）
+- flowName：${flowName}
+- uuid：${uuid}
+- instanceId：${instanceId}
+
+## 节点上下文
+
+${nodeContext}
+
+## 执行任务
+
+${taskBody}
+
+---
+
+按上述任务完成执行，节点中如有写入文件的操作可以执行。任务完成后直接退出，结果由系统自动标记成功。**仅当任务明确失败时**，执行以下命令报告失败（`agentflow` 是可直接在终端运行的 CLI 命令）：
+```bash
+agentflow apply -ai write-result ${workspaceRoot} ${flowName} ${uuid} ${instanceId} --json '{"status":"failed","message":"失败原因"}'
+```

package/bin/agentflow.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * AgentFlow CLI: drive apply/replay from command line.
+ * Commands: agentflow apply <FlowName> [uuid], agentflow replay [flowName] <uuid> <instanceId>
+ * Cursor agent execution uses --print --output-format stream-json.
+ */
+
+import { createRequire } from "module";
+import path from "path";
+import { fileURLToPath } from "url";
+import chalk from "chalk";
+import { initI18n, setLanguage, SUPPORTED_LANGUAGES } from "./lib/i18n.mjs";
+import { main } from "./lib/main.mjs";
+import { log } from "./lib/log.mjs";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+
+// 提前解析 --lang 参数（需要在 update-notifier 和 main 之前）
+const argv = process.argv.slice(2);
+const langIdx = argv.indexOf("--lang");
+if (langIdx >= 0 && argv[langIdx + 1]) {
+  const requestedLang = argv[langIdx + 1];
+  if (SUPPORTED_LANGUAGES.includes(requestedLang)) {
+    initI18n(requestedLang);
+  } else {
+    console.warn(`Warning: Unsupported language "${requestedLang}". Supported: ${SUPPORTED_LANGUAGES.join(", ")}`);
+  }
+} else {
+  // 从环境变量初始化
+  initI18n();
+}
+
+const updateNotifier = require("update-notifier").default;
+const pkg = require(path.join(__dirname, "..", "package.json"));
+const machineOutput = argv.includes("--json") || argv.includes("--machine-readable");
+if (!machineOutput) {
+  updateNotifier({ pkg }).notify();
+}
+
+/** 当 stderr 非 TTY（如被 desktop 管道捕获）时禁用 chalk，避免日志里出现 [90m 等 ANSI 转义码 */
+if (process.stderr && !process.stderr.isTTY) {
+  chalk.level = 0;
+}
+
+main().catch((err) => {
+  log.error("Error: " + err.message);
+  if (err.flowName && err.uuid) {
+    log.info(chalk.bold.yellow("After fixing, use resume to continue: ") + `agentflow resume ${err.flowName} ${err.uuid}`);
+  }
+  process.exit(1);
+});

package/bin/ensure-workspace-reference.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * postinstall：将包内 reference/ 复制到当前工作目录的 .workspace/agentflow/reference/。
+ * 在项目内 npm install agentflow 时，cwd 为项目根，复制后 flow 中可引用 .workspace/agentflow/reference/*.md。
+ */
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+const REFERENCE_SRC = path.join(PACKAGE_ROOT, "reference");
+const CWD = process.cwd();
+const DEST = path.join(CWD, ".workspace", "agentflow", "reference");
+
+if (!fs.existsSync(REFERENCE_SRC) || !fs.statSync(REFERENCE_SRC).isDirectory()) {
+  process.exit(0);
+}
+if (CWD === PACKAGE_ROOT) {
+  process.exit(0);
+}
+
+try {
+  fs.mkdirSync(DEST, { recursive: true });
+  const names = fs.readdirSync(REFERENCE_SRC);
+  for (const name of names) {
+    const srcFile = path.join(REFERENCE_SRC, name);
+    if (fs.statSync(srcFile).isFile()) {
+      fs.copyFileSync(srcFile, path.join(DEST, name));
+    }
+  }
+} catch (_) {
+  process.exit(0);
+}