minimal-agent 0.13.0 → 0.15.0

package/workflows/schema.json

@@ -1,176 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://github.com/billsoft/kakadeai/minimal-agent/workflows/schema.json",
-  "title": "minimal-agent workflow",
-  "description": "Workflow YAML schema, v0.1 — see docs/workflow-plugin-plan.md",
-  "type": "object",
-  "required": ["name", "description", "steps"],
-  "additionalProperties": true,
-  "properties": {
-    "name": { "type": "string", "minLength": 1 },
-    "description": { "type": "string", "minLength": 1 },
-    "version": { "type": "string" },
-    "inputs": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["name"],
-        "properties": {
-          "name": { "type": "string", "minLength": 1 },
-          "type": { "enum": ["string", "number", "enum"] },
-          "required": { "type": "boolean" },
-          "default": {},
-          "values": { "type": "array", "items": { "type": "string" } },
-          "description": { "type": "string" }
-        }
-      }
-    },
-    "steps": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "$ref": "#/definitions/step" }
-    },
-    "self_heal": {
-      "type": "object",
-      "description": "Workflow-level retry/resume policy.",
-      "properties": {
-        "backoff": { "type": "number", "minimum": 0 },
-        "max_retries": { "type": "number", "minimum": 0 },
-        "retry_delay_ms": { "type": "number", "minimum": 0 },
-        "max_turns_retry_delay_ms": { "type": "number", "minimum": 0 }
-      },
-      "additionalProperties": true
-    },
-    "__meta": { "type": "object" }
-  },
-  "definitions": {
-    "step": {
-      "type": "object",
-      "required": ["id"],
-      "properties": {
-        "id": { "type": "string", "minLength": 1 },
-        "title": {
-          "type": "string",
-          "minLength": 1,
-          "description": "任意步可选：人话进度显示名（支持 ${} 插值）。声明后状态行显示这段文案（如「阶段2/6·起草实现计划」），不再显示块内相对序号。"
-        },
-        "tool": { "type": "string" },
-        "skill": { "type": "string" },
-        "llm": { "type": "string" },
-        "type": {
-          "enum": ["assert", "verify", "set", "branch", "loop", "break", "continue", "echo", "pause"],
-          "description": "控制流节点类型。'continue'=跳到（目标）循环下一轮迭代；'echo'=确定性输出插值消息（不烧 LLM）。"
-        },
-        "args": {
-          "type": "object",
-          "description": "tool 步参数（深度 ${} 插值）。⚠️ Bash 命令注意：${} 是引擎插值、发生在 shell 之前——shell 单引号会原样保留插值后的文本，不做算术/变量二次展开（sed -n '$((${i}+1))p' 会把字面 $((0+1))p 喂给 sed）。需要序号让 loop over 直接产出最终值（如 1 基行号）。"
-        },
-        "input": { "type": "string" },
-        "capture": {
-          "type": "object",
-          "additionalProperties": { "type": "string" }
-        },
-        "when": { "type": "string" },
-        "onError": { "enum": ["halt", "continue", "recover"] },
-        "target": {
-          "type": "string",
-          "minLength": 1,
-          "description": "仅 type=break/continue：目标循环 id（标签语义）。缺省=最近一层循环；指定后信号穿透中间层循环直达该 loop。"
-        },
-        "message": {
-          "type": "string",
-          "minLength": 1,
-          "description": "仅 type=echo（必填）：确定性输出给用户的消息，支持 ${} 插值。"
-        },
-        "goal_supplement": {
-          "type": "boolean",
-          "description": "动作步/pause 可选：本步产出作为「用户补充要求」并入贯穿目标锚定，注入后续每一步。"
-        },
-        "maxTurns": { "type": "number" },
-        "images": {
-          "type": "array",
-          "description": "仅 llm / agent 节点可选：OpenAI 兼容图片输入。字符串表示路径/URL；对象可设置 detail 与 max_long_side_pixel。",
-          "items": {
-            "oneOf": [
-              { "type": "string", "minLength": 1 },
-              {
-                "type": "object",
-                "required": ["source"],
-                "properties": {
-                  "source": { "type": "string", "minLength": 1 },
-                  "detail": { "enum": ["low", "default", "high"] },
-                  "max_long_side_pixel": { "type": "integer", "minimum": 1 }
-                },
-                "additionalProperties": true
-              }
-            ]
-          }
-        },
-        "parse_inline_images": {
-          "type": "boolean",
-          "description": "仅 llm / agent 节点可选：解析 prompt 中的 @./image.png 或图片 URL。"
-        },
-        "image_detail": {
-          "enum": ["low", "default", "high"],
-          "description": "仅 llm / agent 节点可选：本步骤图片 detail 默认值。"
-        },
-        "image_max_long_side_pixel": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "仅 llm / agent 节点可选：本步骤图片最长边默认值。"
-        },
-        "condition": { "type": "string" },
-        "onFail": { "type": "string" },
-        "then": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/step" }
-        },
-        "else": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/step" }
-        },
-        "over": { "type": "string" },
-        "as": { "type": "string" },
-        "do": {
-          "type": "array",
-          "items": { "$ref": "#/definitions/step" }
-        },
-        "prompt": { "type": "string" },
-        "free_text": {
-          "type": "string",
-          "enum": ["halt", "approve"],
-          "description": "type=pause 时自由输入的处理方式：halt=不放行（默认）；approve=作为补充要求放行，可配 capture.text 传给后续步骤。"
-        },
-        "max_iterations": {
-          "oneOf": [{ "type": "integer", "minimum": 1 }, { "type": "string", "minLength": 1 }]
-        },
-        "done_when": {
-          "type": "string",
-          "minLength": 1,
-          "description": "仅 agent 步可选：确定性完成条件（白名单表达式，如 fileExists('./out/x.pptx')）。不满足时引擎自动提醒同一 agent 继续执行（上限 2 次），仍不满足按可重试失败处理。弱模型「宣告要干却不调工具就停」的引擎级兜底。"
-        },
-        "output_schema": {
-          "type": "object",
-          "description": "⚠ ADR-05 新增：LLM 输出 JSON Schema 强约束，走 provider-native structured output。仅 llm 节点生效（skill 节点 loader 拒绝）；详见 docs/workflow-design.md。"
-        },
-        "context_files": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "required": ["path"],
-            "properties": {
-              "path": { "type": "string", "minLength": 1 },
-              "hint": { "type": "string" }
-            }
-          },
-          "description": "⚠ ADR-05 新增：仅 llm 节点声明可用的上下文文件清单（path + hint），runner 拼进 prompt 并开放 Read 子循环，不 inline 内容（skill 节点 loader 拒绝）。详见 docs/workflow-design.md。"
-        },
-        "allowed_tools": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 },
-          "description": "⚠ ADR-05 新增：与 context_files 配对的 mini ReAct 工具白名单，缺省 ['Read']。详见 docs/05-advanced-workflow-integration.md。"
-        }
-      }
-    }
-  }
-}