minimal-agent 0.1.8 → 0.2.0

package/skills/subtitle-srt/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: subtitle-srt
+description: 当用户说"生成字幕"、"做 SRT"、"字幕文件"、"subtitle-srt"，或在 workflow 里要把分段文本 + 时长信息转成标准 SRT 字幕文件时使用。给定 cue 列表（每条带文本和起止时间或时长），生成符合 SRT 规范的字幕文件。
+---
+
+# subtitle-srt —— SRT 字幕生成
+
+> 通用 skill，不绑定语种 / 不绑定视频比例 / 不绑定字体（字体是视频合成阶段的事）。
+
+## 输入约定
+
+支持两种输入形态：
+
+### 形态 A：cues_json（一次性给所有 cue）
+
+```
+cues_json=<JSON 数组> output=./subs.srt [encoding=utf-8]
+```
+
+`cues_json` 是合法 JSON 数组，每个元素至少有 `text`，时间可以两种方式给：
+
+```json
+[
+  {"text": "开场白", "start": 0.0, "end": 3.5},
+  {"text": "第二幕", "start": 3.5, "end": 7.7}
+]
+```
+
+或者只给时长，由本 skill 自动累加：
+
+```json
+[
+  {"text": "开场白", "duration": 3.5},
+  {"text": "第二幕", "duration": 4.2}
+]
+```
+
+### 形态 B：texts + durations（两个并列数组）
+
+```
+texts=<JSON 字符串数组> durations=<逗号分隔秒数> output=./subs.srt
+```
+
+例：
+```
+texts=["开场白","第二幕","第三幕"] durations=3.5,4.2,3.0 output=./subs.srt
+```
+
+> 形态 B 比形态 A 易写，适合 workflow 里用 capture 拼出的简单场景。
+
+## 标准执行流程
+
+### 1. 解析输入
+
+判断是哪种形态：含 `cues_json=` 字段走 A，含 `texts=` + `durations=` 走 B。两者都不满足 → 报错。
+
+### 2. 计算每条 cue 的起止时间戳
+
+如果给了 `start` + `end`（形态 A 第一种），直接用。
+
+否则按 `duration` 累加：
+- cue 1: start=0.0, end=duration[0]
+- cue 2: start=end[0], end=start[1]+duration[1]
+- ...
+
+### 3. 时间戳格式转换
+
+SRT 时间戳格式：`HH:MM:SS,mmm`（毫秒前**用逗号不用点**）。
+
+公式：
+```
+total_ms = round(seconds * 1000)
+hh = total_ms // 3600000
+mm = (total_ms % 3600000) // 60000
+ss = (total_ms % 60000) // 1000
+ms = total_ms % 1000
+formatted = f"{hh:02d}:{mm:02d}:{ss:02d},{ms:03d}"
+```
+
+### 4. 拼 SRT 内容
+
+每条 cue 4 行（序号 / 时间戳 / 文本 / 空行）：
+
+```
+1
+00:00:00,000 --> 00:00:03,500
+开场白
+
+2
+00:00:03,500 --> 00:00:07,700
+第二幕
+
+```
+
+> ⚠️ 最后一条 cue 末尾**也要有空行**，否则部分播放器会吞掉最后一句。
+
+### 5. 写入文件
+
+用 Write 工具：
+- `file_path = OUTPUT`
+- `content = <上面拼好的 SRT 字符串>`
+
+或者用 Bash + heredoc（注意编码，Windows 上要保证 UTF-8 无 BOM）：
+```bash
+mkdir -p "$(dirname "$OUTPUT")"
+cat > "$OUTPUT" <<'EOF'
+1
+00:00:00,000 --> 00:00:03,500
+开场白
+
+EOF
+```
+
+### 6. 自检（可选）
+
+如果机器有 ffprobe，跑一下确认字幕可读：
+```bash
+ffprobe -v error -loglevel error -i "$OUTPUT" 2>&1 || echo "ffprobe 验证未通过：$?"
+```
+
+ffprobe 失败不算硬错（部分版本对 SRT 解析比较宽松），但要打印 warning。
+
+### 7. 收尾输出
+
+```
+saved: <OUTPUT> (cues=<N>, duration=<TOTAL_SEC>s)
+```
+
+## 注意事项
+
+- 长文本自动换行：单 cue 文本超过 ~30 字时，在自然标点处插入换行（`，` / `。` / `？` / `！`）。SRT 单条多行用真实换行符即可
+- **不打印用户文本内容到日志**（隐私）
+- 字符编码强制 UTF-8 无 BOM；Windows PowerShell 写文件时显式 `-Encoding utf8`
+- 不假设语种 —— 中英日韩都按字符长度判断换行（中文 1 字符 ≈ 英文 2 字符的视觉宽度，可按 30 字符切）

package/skills/tts-zh/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: tts-zh
+description: 当用户说"中文配音"、"中文 TTS"、"语音合成"、"文字转语音"、"tts-zh"，或在 workflow 里要把中文文本转成 mp3 时使用。优先用 MiniMax T2A API，失败时 fallback 到 edge-tts 离线方案，输出 mp3 到指定路径。
+---
+
+# tts-zh —— 中文 TTS（minimax 主 + edge-tts 兜底）
+
+## 输入约定
+
+调用方传一行 `key=value` 字段串：
+
+```
+text=今天天气真好 output=./assets/audio_0.mp3 voice=female-shaonv speed=1.0
+```
+
+字段：
+- **text**（必填）：要合成的中文文本（短句，≤200 字）
+- **output**（必填）：目标 mp3 路径
+- **voice**（可选，默认 `female-shaonv`）：minimax 嗓音 id；edge-tts 走 `zh-CN-XiaoxiaoNeural` 不受 voice 字段影响
+- **speed**（可选，默认 `1.0`）：语速 0.5–2.0
+
+## 标准执行流程
+
+### 1. 解析输入
+
+仔细取 text / output / voice / speed。text 可能包含空格甚至标点，按"剩余串"策略提取。
+
+### 2. 优先尝试 MiniMax T2A
+
+#### 2.1 取 key + group id
+
+```bash
+KEY="$MINIMAX_API_KEY"
+GROUP="$MINIMAX_GROUP_ID"
+```
+
+如果两个都不空，进入 2.2；任一为空，**直接跳到第 3 步（edge-tts fallback）**，不算错误。
+
+#### 2.2 调 API
+
+minimax T2A v2 接口：
+
+```bash
+jq -n --arg t "$TEXT" --arg v "$VOICE" --argjson s "$SPEED" \
+  '{model:"speech-01", text:$t, voice_setting:{voice_id:$v, speed:$s}, audio_setting:{format:"mp3"}}' \
+  | curl -sS "https://api.minimax.chat/v1/t2a_v2?GroupId=$GROUP" \
+      -H "Authorization: Bearer $KEY" \
+      -H "Content-Type: application/json" \
+      --data-binary @- \
+      -o /tmp/minimax_resp.json
+```
+
+> ⚠️ MINIMAX_BASE_URL 可能不是 `api.minimax.chat`（用户也许配了自定义网关）。如果 env 里有 `MINIMAX_BASE_URL`，用它替换 `https://api.minimax.chat`，否则用默认。
+
+#### 2.3 解析响应
+
+minimax 返回里音频是 hex 字符串：
+```
+.data.audio  →  "ff f3 e4 ..."（hex 编码的 mp3 字节流）
+```
+
+解码到文件：
+```bash
+mkdir -p "$(dirname "$OUTPUT")"
+jq -r '.data.audio' /tmp/minimax_resp.json | xxd -r -p > "$OUTPUT"
+```
+
+> 如果 `xxd` 不可用（部分 Windows），用 PowerShell：
+> ```powershell
+> $resp = Get-Content /tmp/minimax_resp.json -Raw | ConvertFrom-Json
+> $hex = $resp.data.audio
+> $bytes = New-Object byte[] ($hex.Length / 2)
+> for ($i = 0; $i -lt $bytes.Length; $i++) { $bytes[$i] = [Convert]::ToByte($hex.Substring($i*2, 2), 16) }
+> [IO.File]::WriteAllBytes('<OUTPUT>', $bytes)
+> ```
+
+#### 2.4 校验
+
+```bash
+SIZE=$(stat -c%s "$OUTPUT" 2>/dev/null || stat -f%z "$OUTPUT")
+```
+
+- `SIZE > 1000` → 成功，输出 `saved: <OUTPUT> (provider=minimax, size=<SIZE>)`，结束
+- `SIZE < 1000` 或文件不存在 → 视为失败，**进入第 3 步 edge-tts fallback**
+
+### 3. Fallback 到 edge-tts
+
+#### 3.1 确认 edge-tts 可用
+
+```bash
+pip show edge-tts >/dev/null 2>&1 || pip install --user edge-tts
+which edge-tts || python -m edge_tts --help >/dev/null 2>&1 || true
+```
+
+如果 pip / python 都没有，**报错退出**："tts-zh 失败：minimax 不可用且本机无 Python，无法 fallback 到 edge-tts。请配置 MINIMAX_API_KEY + MINIMAX_GROUP_ID 或安装 Python + edge-tts"
+
+#### 3.2 跑 edge-tts
+
+```bash
+edge-tts --voice zh-CN-XiaoxiaoNeural --rate "+0%" --text "$TEXT" --write-media "$OUTPUT"
+# 或：
+python -m edge_tts --voice zh-CN-XiaoxiaoNeural --text "$TEXT" --write-media "$OUTPUT"
+```
+
+> 语速换算：minimax 的 speed=1.0 ↔ edge-tts 的 `--rate "+0%"`；speed=1.2 ↔ `--rate "+20%"`；speed=0.8 ↔ `--rate "-20%"`。
+> 公式：`rate = ((speed - 1.0) * 100)` 取整，前面加 `+` 或 `-`。
+
+#### 3.3 校验
+
+同 2.4 步骤；size > 1000 → 成功，输出 `saved: <OUTPUT> (provider=edge-tts, size=<SIZE>)`。
+
+仍然失败 → 报错 "tts-zh 失败：minimax 和 edge-tts 都不工作"
+
+## 嗓音速查
+
+### MiniMax 常用 voice_id
+
+| voice_id | 描述 |
+|---|---|
+| `female-shaonv` | 少女音（默认，自然清亮） |
+| `male-qn-jingying` | 精英男声（沉稳） |
+| `female-tianmei` | 甜美女声 |
+| `audiobook_male_1` | 有声书男声 |
+
+### edge-tts（兜底，固定）
+
+| voice | 描述 |
+|---|---|
+| `zh-CN-XiaoxiaoNeural` | 默认女声（自然） |
+| `zh-CN-YunxiNeural` | 男声 |
+
+## 注意事项
+
+- **不打印 API key / GroupId 到任何日志**
+- text 含特殊 shell 字符（`$ "  '` 等）时务必走 jq 拼 JSON，**不要直接拼字符串到 curl 命令里**
+- 输出 mp3 时长会因为文本长度而变 —— 不要硬假设时长，下游 ffprobe 实际测量
+- 一次只合成一句；若调用方传超过 200 字，让它分多次调用

package/skills/video-compose/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: video-compose
+description: 当用户说"合成视频"、"做 mp4"、"图片转视频"、"ffmpeg 拼视频"、"video-compose"，或在 workflow 里要把图片序列 + 可选音轨 + 可选字幕合成成 mp4 时使用。本 skill 是 ffmpeg 的 declarative 封装，所有参数（分辨率、字体、码率、转场）都可配置，不绑定特定视频格式。
+---
+
+# video-compose —— 通用 ffmpeg 视频合成
+
+> 通用 skill，可被任何 workflow 调用。无场景假设（不绑定竖屏/横屏，不绑定语言）。
+
+## 输入约定
+
+调用方传一行 `key=value` 字段串，必填项 + 可选项混合：
+
+```
+images_glob=./assets/img_*.png audio=./assets/audio.mp3 srt=./assets/subs.srt output=./out/video.mp4 width=1080 height=1920 per_image_duration=3 fps=30 font=Microsoft YaHei font_size=42
+```
+
+### 必填
+
+- **images_glob**：图片 glob 表达式（用 Glob 工具枚举，按文件名排序）
+- **output**：目标 mp4 路径
+
+### 可选
+
+| 字段 | 默认 | 说明 |
+|---|---|---|
+| **audio** | （无） | 音轨 mp3/wav；不传则纯视频无声 |
+| **srt** | （无） | 字幕文件；不传则不烧入字幕 |
+| **width** × **height** | `1080` × `1920` | 输出分辨率（默认竖屏；横屏传 `1920` × `1080`） |
+| **per_image_duration** | `3` | 每张图片显示秒数（如果给 audio，可能会被覆盖 —— 见下方"对齐音轨"） |
+| **fps** | `30` | 帧率 |
+| **font** | `Microsoft YaHei`（Win）/ `PingFang SC`（Mac）/ `Noto Sans CJK SC`（Linux） | 字幕字体 |
+| **font_size** | `42` | 字幕字号 |
+| **font_color** | `FFFFFF` | 字幕颜色（RGB hex） |
+| **align_audio** | `auto` | `auto`=按音轨长度等分图片时长 / `fixed`=固定 `per_image_duration` / `cut`=超出部分截断 |
+| **crf** | `23` | x264 质量（18–28，越低越清） |
+
+## 标准执行流程
+
+### 1. 前置检查
+
+```bash
+which ffmpeg >/dev/null || { echo "缺少 ffmpeg，请安装：winget install Gyan.FFmpeg / brew install ffmpeg / apt install ffmpeg"; exit 1; }
+which ffprobe >/dev/null || { echo "缺少 ffprobe（通常和 ffmpeg 一起装）"; exit 1; }
+```
+
+### 2. 收集图片列表
+
+用 Glob 工具按 `images_glob` 找文件 → 按文件名 ASCII 排序。如果只有 0 或 1 张图，**报错退出**（视频至少要 2 帧才有意义）。
+
+### 3. 决定每张图时长
+
+- 如果**有 audio** 且 `align_audio=auto`（默认）：
+  - 用 `ffprobe -v error -show_entries format=duration -of csv=p=0 <audio>` 拿音轨时长 `T`
+  - 单图时长 = `T / 图片数`
+- 否则：每张图固定 `per_image_duration` 秒
+
+### 4. 生成 concat 列表
+
+ffmpeg concat demuxer 用法：
+
+```bash
+mkdir -p "$(dirname "$OUTPUT")"
+LIST=/tmp/video_compose_list.txt
+> "$LIST"
+for f in $(ls $IMAGES_GLOB | sort); do
+  echo "file '$f'" >> "$LIST"
+  echo "duration $PER_IMG" >> "$LIST"
+done
+# ffmpeg quirk：最后一张图片要再列一次（不带 duration）才会被显示完整时长
+LAST=$(ls $IMAGES_GLOB | sort | tail -n1)
+echo "file '$LAST'" >> "$LIST"
+```
+
+### 5. 合成视频流（可选烧字幕）
+
+无字幕版本：
+```bash
+ffmpeg -y -f concat -safe 0 -i "$LIST" \
+  -vf "scale=${WIDTH}:${HEIGHT}:force_original_aspect_ratio=increase,crop=${WIDTH}:${HEIGHT},fps=${FPS}" \
+  -c:v libx264 -crf ${CRF} -pix_fmt yuv420p /tmp/video_only.mp4
+```
+
+带字幕版本（filter 链尾加 subtitles 滤镜）：
+```bash
+ffmpeg -y -f concat -safe 0 -i "$LIST" \
+  -vf "scale=${WIDTH}:${HEIGHT}:force_original_aspect_ratio=increase,crop=${WIDTH}:${HEIGHT},fps=${FPS},subtitles=${SRT}:force_style='Fontname=${FONT},Fontsize=${FONT_SIZE},PrimaryColour=&H00${FONT_COLOR}&,Outline=2,BorderStyle=1'" \
+  -c:v libx264 -crf ${CRF} -pix_fmt yuv420p /tmp/video_only.mp4
+```
+
+> ⚠️ Windows 路径里反斜杠 `\` 会被 ffmpeg subtitles 滤镜当转义字符吃掉。**字幕路径强制用正斜杠 `/`**，或者 `\\:` 转义盘符冒号。
+
+### 6. 合入音轨（如果有）
+
+```bash
+if [ -n "$AUDIO" ]; then
+  ffmpeg -y -i /tmp/video_only.mp4 -i "$AUDIO" \
+    -c:v copy -c:a aac -b:a 192k \
+    -shortest "$OUTPUT"
+else
+  cp /tmp/video_only.mp4 "$OUTPUT"
+fi
+```
+
+### 7. 校验产物
+
+```bash
+ffprobe -v error -show_entries stream=codec_type,duration -of default=noprint_wrappers=1 "$OUTPUT"
+SIZE=$(stat -c%s "$OUTPUT" 2>/dev/null || stat -f%z "$OUTPUT")
+```
+
+- 文件存在且 size > 100KB
+- 至少有 1 个 video 流；如果传了 audio 还应该有 1 个 audio 流
+- 总时长 > 1 秒
+
+任一项不满足 → 报错并打印 ffprobe 输出供 debug。
+
+### 8. 收尾输出
+
+```
+saved: <OUTPUT> (resolution=<WIDTH>x<HEIGHT>, duration=<DUR>s, size=<MB>MB)
+```
+
+## 字体路径速查
+
+| OS | 字体名（filter 用） | 实际文件 |
+|---|---|---|
+| Windows | `Microsoft YaHei` 或 `SimHei` | `C:\Windows\Fonts\msyh.ttc` |
+| macOS | `PingFang SC` | `/System/Library/Fonts/PingFang.ttc` |
+| Linux | `Noto Sans CJK SC` | `/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc` |
+
+如果 force_style 找不到字体，会 fallback 到 Arial（中文会变方块），用 `fc-list :lang=zh-cn` 看本机有哪些中文字体。
+
+## 注意事项
+
+- **ffmpeg 滤镜里的引号嵌套很难写**：双引号包围整个 `-vf` 值，里面用单引号；force_style 的 key=value 用 `=` 不要用空格
+- subtitles 滤镜路径必须**用正斜杠**，盘符冒号转义成 `\\:`（Win 上 `C:/path/x.srt` → `C\\:/path/x.srt`）
+- 不接受**纯静态图片**作输入 —— 至少 2 张才合理；如果调用方只有 1 张图，让它用 ffmpeg `-loop 1` 单独处理（不走本 skill）
+- 不假设视频用途（短视频 / 长视频 / 横屏 / 竖屏 / 方形）—— 全部走参数

package/workflows/book-review-short.yaml

@@ -0,0 +1,99 @@
+name: book-review-short
+description: |
+  从书名生成 YouTube Shorts 书评短视频（60 秒）：
+  调研 → 60 秒口播脚本 → 缩略图 prompt → meta.json。
+  P0 跑通 steps 1/2/3/5/6/7（step 4 loop/钩子标题 P1 启用）。
+version: "0.1"
+
+inputs:
+  - name: book
+    type: string
+    required: true
+    description: "书名（中英都行）"
+  - name: angle
+    type: enum
+    values: [insight, contrarian, beginner]
+    default: insight
+  - name: lang
+    type: enum
+    values: [zh, en]
+    default: zh
+
+steps:
+  # 1. 调研（确定性工具）
+  - id: research
+    tool: WebSearch
+    args:
+      query: "${inputs.book} 核心观点 书评 ${inputs.lang}"
+    capture:
+      content: research_data
+
+  # 2. 60 秒短视频脚本（llm 单轮，不开工具）
+  - id: script
+    llm: |
+      你是一名 YouTube Shorts 创作者。基于以下调研，为书 "${inputs.book}" 写一段
+      60 秒口播脚本，视角是 ${inputs.angle}（insight=洞察、contrarian=逆向、beginner=入门）。
+      语言：${inputs.lang}。
+      要求：
+      - 开头 3 秒强钩子（一个反直觉论断 / 数字 / 提问）
+      - 中段 40 秒展开 2-3 个核心要点，每点配一句金句
+      - 结尾 10 秒行动号召
+      - 全文 ≤ 180 字（中文）/ 150 词（英文）
+      只输出脚本本体，不要注释/标题/分段标记。
+
+      调研材料：
+      ${research_data}
+    capture:
+      text: script_text
+
+  # 3. 写脚本到文件（确定性工具）
+  - id: write_script
+    tool: Write
+    args:
+      file_path: "videos/${inputs.book}/script.txt"
+      content: "${script_text}"
+
+  # 4. 生成 3 个钩子标题（loop + llm）—— P1 启用
+  # - id: gen_hooks
+  #   type: loop
+  #   over: "[1, 2, 3]"
+  #   as: idx
+  #   do:
+  #     - id: hook_${idx}
+  #       llm: |
+  #         为 "${inputs.book}" 书评 Shorts 生成第 ${idx} 个标题（≤20 字 / ≤8 words）。
+  #         风格序号 1=金句、2=反问、3=数字承诺。
+  #         只输出标题本体。
+  #       capture:
+  #         text: hook_${idx}
+
+  # 5. 缩略图 prompt（llm 单轮）
+  - id: thumbnail
+    llm: |
+      为书 "${inputs.book}" 的 YouTube Shorts 缩略图生成英文文生图 prompt：
+      - 主体：书 + 一个隐喻物
+      - 色调：高饱和对比
+      - 构图：竖屏 9:16，主体居中
+      - 风格：editorial, photorealistic
+      ≤100 词，单段。
+    capture:
+      text: thumb_prompt
+
+  # 6. 元数据汇总（确定性工具）
+  - id: meta
+    tool: Write
+    args:
+      file_path: "videos/${inputs.book}/meta.json"
+      content: |
+        {
+          "book": "${inputs.book}",
+          "angle": "${inputs.angle}",
+          "lang": "${inputs.lang}",
+          "thumbnail_prompt": "${thumb_prompt}"
+        }
+
+  # 7. 守门 assert
+  - id: verify
+    type: assert
+    condition: 'fileExists("videos/${inputs.book}/script.txt") && fileExists("videos/${inputs.book}/meta.json")'
+    onFail: "脚本或 meta 未写盘，请检查 Write 工具"

package/workflows/e2e-write-greet.yaml

@@ -0,0 +1,27 @@
+name: e2e-write-greet
+description: E2E 极简 workflow，证明 /workflow CLI 端到端通（无 LLM 无网络）
+version: "0.1"
+
+inputs:
+  - name: topic
+    type: string
+    required: true
+
+steps:
+  - id: write_note
+    tool: Write
+    args:
+      file_path: "out/${inputs.topic}/note.txt"
+      content: "topic=${inputs.topic} ok"
+    capture:
+      args.content: note_body
+
+  - id: verify_file
+    type: assert
+    condition: 'fileExists("out/${inputs.topic}/note.txt")'
+    onFail: "note.txt 未落盘"
+
+  - id: verify_capture
+    type: assert
+    condition: 'length(note_body) > 0'
+    onFail: "capture 没绑到 note_body"

package/workflows/schema.json

@@ -0,0 +1,74 @@
+{
+  "$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" }
+    },
+    "__meta": { "type": "object" }
+  },
+  "definitions": {
+    "step": {
+      "type": "object",
+      "required": ["id"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "tool": { "type": "string" },
+        "skill": { "type": "string" },
+        "llm": { "type": "string" },
+        "type": { "enum": ["assert", "branch", "loop", "pause"] },
+        "args": { "type": "object" },
+        "input": { "type": "string" },
+        "capture": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "when": { "type": "string" },
+        "onError": { "enum": ["halt", "continue"] },
+        "maxTurns": { "type": "number" },
+        "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" }
+      }
+    }
+  }
+}