步驟5 缺口②：recipe 補 payload／回應正規化／binding 三層（leo 三層模型的第③層）

問題：舊 recipe schema 只有 {canonical_id, endpoint, method, auth_service}（body 有但淺）
⇒ ①帶 body 的 API 只能繞過 recipe 把整包寫進 workflow code
  ②回應解析綁死單一供應商（rag_chat 的 finalize 2786 字元全在對付 Gemini 形狀）
  ③Cloudflare binding（env.AI/VECTORIZE/BROWSER/QUEUE）整類被「只認 HTTP+金鑰」的抽象排除
⇒ 換 LLM 供應商＝改 workflow，而非換 recipe，違背「外部 API 只有一條一致的路」。

新增 lib/recipe-payload.ts（純函式，好測）：
- renderBodyTemplate：遞迴插值，單一 {{x}} 保留原型別、混合文字拼字串、
  支援 dot path、取不到保留原樣（不靜默吞掉，看得見才好 debug）。
  語義刻意與 graph-executor 的 interpolateData 一致，不新造第二種插值行為。
- applyResponseMap：text_path 取值／thinking_model 剔除 thought=true 取最後一個非 thought／
  answer_marker 用 lastIndexOf（自檢清單內文也會提到標記）／strip_prefixes 循環剝殼
  （實撞三型「Draft: 【答】」「* 【答】」「Answer: * 【答】」，單趟剝不乾淨）。

RecipeDefinition 加四個**全選填**欄位：body_template／response_map／auth／binding_name。
- component-loader：body_template 優先於 body，兩者皆無才沿用 ctx 當 body（既有行為）
- response_map 有設才附 text 欄，未設原樣回傳 ⇒ 既有 recipe 行為完全不變
- 新增 makeBindingRecipeRunner＋pickRecipeRunner：auth='binding' 走平台 binding（免金鑰、
  開機即可用），其餘一律走既有 HTTP 路徑。binding 缺綁定/無 run() 時回可操作錯誤，不假綠。
  這型不是為 Workers AI 開特例——一次打開 env.AI/VECTORIZE/BROWSER/QUEUE 整排。

payload 用法要「查得到」（同 branch_hint 動機，leo 08-01 的 n8n 式逐顆查）：
buildPayloadHint() 讓 recipe 的查詢回應說得出「payload 怎麼填、回應怎麼取值、
認證誰負責」，wire 進 discover 混搜／legacy 逐顆／target=recipe 三條路徑。
金鑰鐵律 D36：hint 只說「走 auth recipe X，金鑰由系統注入、你不必也不該填」，不吐值。

測試：tests/recipe-payload-response.test.ts 14 項全綠（含三家形狀 Gemini/Claude/Workers AI
用不同 path 都取得出文字＝換源＝換 recipe 的實證；未設 response_map 原樣回傳的相容性）。
全套 209 passed（前 179 +30 新），失敗數維持既有 9 筆未變；tsc --noEmit 綠。

SDD: workflow-discovery task 3.12｜CP: arcrun-usable 步驟 5

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

cypher-executor/src/actions/search-nodes.ts

@@ -54,6 +54,18 @@ export type NodeInfo = {
   /** recipe found 時附上（AI 看得懂這個 recipe 在打哪個 API）。 */
   description?: string;
   endpoint?: string;
+  /**
+   * recipe 的 payload／回應用法自我說明（3.12，同 branch_hint 的動機）：
+   * 逐顆查 recipe 時光看 endpoint 不知道「payload 怎麼填、回應怎麼取值」⇒ 會退回寫 code。
+   */
+  payload_hint?: {
+    /** 這個 recipe 期望的 body 形狀（body_template 的欄位骨架，值是 {{var}} 佔位） */
+    body_template?: unknown;
+    /** 回應正規化規則存在時，說明取值路徑等 */
+    response_map?: unknown;
+    /** 一行說明：怎麼用這個 recipe */
+    usage: string;
+  };
   /**
    * not_found 時的分型指路（task 3.7）：兩庫（零件 registry＋recipe 庫）都查過才點名，
    * 並告訴 AI 該走哪條補件路＋去哪裡看做法。欄位名 `suggestion`（單數字串）＝verify.sh 03 組契約。
@@ -240,6 +252,7 @@ export async function searchNodes(
         source: 'recipe',
         description: recipe.description,
         endpoint: recipe.endpoint,
+        payload_hint: buildPayloadHint(recipe),
       };
       continue;
     }
@@ -377,6 +390,7 @@ async function legacyPerNodeLookup(
       info: {
         status: 'found', componentId: recipe.canonical_id, type: role, source: 'recipe',
         description: recipe.description, endpoint: recipe.endpoint,
+        payload_hint: buildPayloadHint(recipe),
       },
       missing: false,
     };
@@ -553,6 +567,41 @@ function buildSuggestion(componentId: string): string {
   );
 }
 
+/**
+ * recipe 的 payload／回應用法自我說明（3.12）。
+ * 動機同 branch_hint：逐顆查 recipe（n8n 式）時，光看 endpoint 不知道 payload 怎麼填、
+ * 回應怎麼取值 ⇒ AI 會退回把整包寫進 workflow code。
+ */
+export function buildPayloadHint(recipe: RecipeDefinition): NodeInfo['payload_hint'] {
+  const parts: string[] = [];
+
+  if (recipe.body_template) {
+    parts.push('payload 已收在 recipe 的 body_template 裡，你只要把 {{變數}} 對應的值放進節點 context');
+  } else if (recipe.body) {
+    parts.push('payload 形狀見 body 欄位（{{變數}} 由節點 context 填）');
+  } else {
+    parts.push('未定義 body_template：節點 context 會整包當 body 送出（_ 開頭的內部欄位會被剔除）');
+  }
+
+  if (recipe.response_map) {
+    parts.push('回應已正規化：執行結果除了原始 data，另附 text（取值路徑等規則寫在 recipe 裡，換源不必改 workflow）');
+  } else {
+    parts.push('未定義 response_map：回應原樣放在 data，取值要自己指路徑');
+  }
+
+  if (recipe.auth === 'binding') {
+    parts.push(`認證＝binding（免金鑰，用平台內建 ${recipe.binding_name ?? 'AI'}）`);
+  } else if (recipe.auth_service) {
+    parts.push(`認證走 auth recipe「${recipe.auth_service}」（金鑰由系統在執行前注入，你不必也不該填）`);
+  }
+
+  return {
+    body_template: recipe.body_template,
+    response_map: recipe.response_map,
+    usage: parts.join('；') + '。',
+  };
+}
+
 // ── registry 查詢 ─────────────────────────────────────────────────────────────
 
 type CatalogEntry = {

cypher-executor/src/actions/target-search.ts

@@ -16,7 +16,7 @@
 
 import { wasmWorkerUrl } from '../lib/component-loader';
 import { fetchTenantWorkflowSearch } from '../lib/workflow-search';
-import { listAllRecipes, type SearchNodesEnv } from './search-nodes';
+import { listAllRecipes, buildPayloadHint, type SearchNodesEnv } from './search-nodes';
 import { branchHintFor } from '../lib/branch-hints';
 
 export type TargetQueryEnv = SearchNodesEnv & {
@@ -74,7 +74,10 @@ export async function searchByTarget(
     const q = query.toLowerCase();
     // 與 discover 混搜同一份庫（私庫＝workflow 實際引用得到的）；子字串比對、canonical 去重
     const seen = new Set<string>();
-    const results: Array<{ canonical_id: string; display_name?: string; description?: string; endpoint: string }> = [];
+    const results: Array<{
+      canonical_id: string; display_name?: string; description?: string; endpoint: string;
+      payload_hint?: unknown;
+    }> = [];
     for (const r of all) {
       if (seen.has(r.canonical_id)) continue;
       const hay = `${r.canonical_id} ${r.display_name ?? ''} ${r.description ?? ''}`.toLowerCase();
@@ -85,6 +88,8 @@ export async function searchByTarget(
         display_name: r.display_name,
         description: r.description,
         endpoint: r.endpoint,
+        // 3.12：逐顆查 recipe 時也要說得出「payload 怎麼填、回應怎麼取值」
+        payload_hint: buildPayloadHint(r),
       });
     }
     return {