/** * acr parts — 列出所有可用零件(內建清單,不依賴 registry.arcrun.dev) * acr parts scaffold — 輸出 config 範本(可直接貼入 workflow.yaml) * acr parts publish — 提交零件至公眾 registry(Phase 5,封測後) */ import { readFileSync, existsSync } from 'node:fs'; import { join } from 'node:path'; import chalk from 'chalk'; import { loadConfig, getCypherExecutorUrl } from '../lib/config.js'; // ── 內建零件定義 ──────────────────────────────────────────────────────────────── interface CredentialRequirement { key: string; type: string; inject_as: string; } interface ComponentDef { canonical_id: string; display_name: string; category: 'logic' | 'data' | 'api' | 'ai'; description: string; config_example: string; credentials_required?: CredentialRequirement[]; } const BUILTIN_COMPONENTS: ComponentDef[] = [ // ── 控制類(Logic) ──────────────────────────────────────────────────────── { canonical_id: 'if_control', display_name: 'If Control', category: 'logic', description: '條件分支:condition 為 true 走 ON_SUCCESS,否則走 ON_FAIL', config_example: ` if_node: component: if_control condition: "status === active"`, }, { canonical_id: 'switch', display_name: 'Switch', category: 'logic', description: '多分支條件:根據 value 欄位選擇對應分支', config_example: ` switch_node: component: switch key: status cases: active: branch_a inactive: branch_b`, }, { canonical_id: 'foreach_control', display_name: 'Foreach', category: 'logic', description: '迭代:對陣列每個元素執行下游節點', config_example: ` loop_node: component: foreach_control iterator: item`, }, { canonical_id: 'filter', display_name: 'Filter', category: 'logic', description: '過濾陣列:保留符合 condition 的元素', config_example: ` filter_node: component: filter key: items condition: "status === active"`, }, { canonical_id: 'merge', display_name: 'Merge', category: 'logic', description: '合併多個上游節點的輸出(Fan-in)', config_example: ` merge_node: component: merge`, }, { canonical_id: 'try_catch', display_name: 'Try Catch', category: 'logic', description: '錯誤捕捉:下游失敗時執行 catch 分支', config_example: ` safe_node: component: try_catch`, }, { canonical_id: 'wait', display_name: 'Wait', category: 'logic', description: '延遲執行:等待指定毫秒後繼續', config_example: ` delay_node: component: wait ms: 1000`, }, // ── 資料類(Data) ───────────────────────────────────────────────────────── { canonical_id: 'set', display_name: 'Set', category: 'data', description: '設定欄位:將靜態值寫入 context', config_example: ` set_node: component: set values: status: active source: webhook`, }, { canonical_id: 'array_ops', display_name: 'Array Ops', category: 'data', description: '陣列操作:push / pop / slice / length', config_example: ` arr_node: component: array_ops operation: push key: items value: "{{new_item}}"`, }, { canonical_id: 'string_ops', display_name: 'String Ops', category: 'data', description: '字串操作:upper / lower / trim / replace / split / join / length', config_example: ` str_node: component: string_ops operation: upper input: "{{text}}"`, }, { canonical_id: 'number_ops', display_name: 'Number Ops', category: 'data', description: '數字操作:add / sub / mul / div / round / floor / ceil / abs', config_example: ` num_node: component: number_ops operation: add a: "{{price}}" b: 10`, }, { canonical_id: 'date_ops', display_name: 'Date Ops', category: 'data', description: '日期操作:now / format / diff / add_days', config_example: ` date_node: component: date_ops operation: now format: "2006-01-02 15:04:05"`, }, { canonical_id: 'validate_json', display_name: 'Validate JSON', category: 'data', description: '驗證 context 欄位是否符合 JSON Schema', config_example: ` validate_node: component: validate_json schema: type: object required: [email, name] properties: email: type: string format: email`, }, // ── AI 類:已移除 ────────────────────────────────────────────────────────── // ai_transform_compile / ai_transform_run 於 2026-05-29 刪除(mindset §2:arcrun 是 // AI 呼叫的工具,不是工具回頭呼叫 LLM)。需要 AI 判斷/轉換由操盤的 CC 自己做。 // ── API 整合類(Recipe 型,不需 deploy Worker) ──────────────────────────── { canonical_id: 'http_request', display_name: 'HTTP Request', category: 'api', description: '通用 HTTP 請求:支援任意 method / headers / body', config_example: ` api_node: component: http_request url: "https://api.example.com/data" method: POST headers: Content-Type: application/json body: key: "{{value}}"`, }, { canonical_id: 'gmail_send', display_name: 'Gmail Send', category: 'api', description: '透過 recipe 寄送 Gmail(recipe gmail_send,auth: google service_account)。注意:Gmail 讀取尚無對應 recipe(待 seed 補 gmail_list)。', config_example: ` # 寄信用內建 recipe gmail_send;body 帶 raw(base64url MIME) mail_node: component: gmail_send method: POST body: raw: "{{mime_base64url}}"`, }, { canonical_id: 'google_sheets_append', display_name: 'Google Sheets Append', category: 'api', description: '透過 recipe 追加一列到 Sheets(recipe google_sheets_append;讀取用 google_sheets_read。auth: google service_account)', config_example: ` # 追加用內建 recipe google_sheets_append(讀取改用 google_sheets_read) sheet_node: component: google_sheets_append method: POST _path: "/v4/spreadsheets/{{spreadsheet_id}}/values/Sheet1!A:B:append?valueInputOption=RAW" body: values: - ["{{name}}", "{{email}}"]`, }, { canonical_id: 'telegram_send', display_name: 'Telegram Send', category: 'api', description: '透過 recipe 發送 Telegram 訊息(recipe telegram_send,auth: static_key,token 注入 URL path)', config_example: ` # 內建 recipe telegram_send(token 由 auth 注入 URL,不寫在這) tg_node: component: telegram_send chat_id: "123456789" text: "{{message}}"`, }, { canonical_id: 'line_notify_send', display_name: 'LINE Notify', category: 'api', description: '透過 recipe 發送 LINE Notify 通知(recipe line_notify_send,auth: static_key Bearer)', config_example: ` # 內建 recipe line_notify_send(POST notify,body form-urlencoded) line_node: component: line_notify_send method: POST body: message: "{{notification}}"`, }, { canonical_id: 'notion', display_name: 'Notion', category: 'api', description: '透過 recipe 操作 Notion API(需先 acr recipe push)', config_example: ` # 先上傳 recipe:acr recipe push notion.yaml notion_node: component: rec_xxxxxxxx # acr recipe push 後得到的 hash database_id: "{{db_id}}" properties: Name: "{{title}}"`, }, ]; // ── 指令實作 ────────────────────────────────────────────────────────────────── export async function cmdParts(): Promise { const categoryLabels: Record = { logic: '控制類(Control Flow)', data: '資料類(Data)', api: '整合類(API / Integration)', ai: 'AI 類', }; const grouped: Record = {}; for (const comp of BUILTIN_COMPONENTS) { if (!grouped[comp.category]) grouped[comp.category] = []; grouped[comp.category].push(comp); } console.log(chalk.bold(`\n arcrun 零件庫(${BUILTIN_COMPONENTS.length} 個內建零件)\n`)); for (const cat of ['logic', 'data', 'ai', 'api']) { const comps = grouped[cat]; if (!comps?.length) continue; console.log(chalk.bold.underline(` ${categoryLabels[cat]}`)); for (const comp of comps) { const credStr = comp.credentials_required?.length ? chalk.yellow(` (需要 ${comp.credentials_required.map(c => c.key).join(', ')})`) : ''; console.log(` • ${chalk.cyan(comp.canonical_id.padEnd(22))}${comp.display_name}${credStr}`); console.log(chalk.gray(` ${comp.description}`)); } console.log(''); } console.log(chalk.gray(' 使用 acr parts scaffold 取得 config 範本')); console.log(chalk.gray(' 第三方服務整合(Notion/Slack/GitHub 等):acr auth-recipe list')); console.log(chalk.gray(' API 整合類若需打自訂服務,請用 acr recipe push 建立 recipe\n')); } export async function cmdPartsScaffold(componentId: string): Promise { const comp = BUILTIN_COMPONENTS.find(c => c.canonical_id === componentId); if (!comp) { // 找不到內建零件 → 嘗試 auth recipe const config = loadConfig(); const baseUrl = getCypherExecutorUrl(config); try { const res = await fetch(`${baseUrl}/auth-recipes/${componentId}`); if (res.ok) { const data = await res.json() as { recipe: { display_name?: string; description?: string; required_secrets: Array<{ key: string; label: string; type?: string; help?: string; help_url?: string }> } }; const recipe = data.recipe; console.log(chalk.bold(`\n ${componentId} — ${recipe.display_name ?? componentId}\n`)); if (recipe.description) console.log(chalk.gray(` ${recipe.description}\n`)); console.log(chalk.cyan(' # credentials.yaml 範本(填入後執行 acr creds push)\n')); for (const s of recipe.required_secrets) { if (s.help) console.log(chalk.gray(` # ${s.label}`)); if (s.help) console.log(chalk.gray(` # ${s.help}`)); if (s.help_url) console.log(chalk.gray(` # 說明文件:${s.help_url}`)); if (s.type === 'json_blob') { console.log(` ${s.key}: |`); console.log(` {`); console.log(` "type": "service_account",`); console.log(` ...`); console.log(` }`); } else { console.log(` ${s.key}: ""`); } console.log(''); } console.log(chalk.cyan(' # workflow.yaml config 範例\n')); console.log(` ${componentId}_node:`); console.log(` component: ${componentId}`); console.log(` method: POST`); console.log(` _path: /your-endpoint-path`); console.log(''); console.log(chalk.gray(` 完整說明:acr auth-recipe info ${componentId}\n`)); return; } } catch { // 離線或服務不可用,繼續顯示錯誤 } console.error(chalk.red(`找不到零件 "${componentId}"。`)); console.log(chalk.gray('執行 acr parts 查看內建零件。')); console.log(chalk.gray('執行 acr auth-recipe list 查看第三方服務整合。')); process.exit(1); } console.log(chalk.bold(`\n ${comp.canonical_id} — ${comp.display_name}\n`)); console.log(chalk.gray(` ${comp.description}\n`)); console.log(chalk.cyan(' # 貼入 workflow.yaml 的 config: 區塊')); console.log(comp.config_example.split('\n').map(l => ` ${l}`).join('\n')); if (comp.credentials_required?.length) { console.log(chalk.bold('\n credentials.yaml 範本(填入後執行 acr creds push)\n')); for (const cred of comp.credentials_required) { console.log(chalk.cyan(` # ${cred.type}(執行時自動注入為 ${cred.inject_as} 欄位)`)); console.log(` ${cred.key}: "your-token-here"\n`); } } console.log(''); } export async function cmdPartsPublish(componentDir: string, options: { status?: string }): Promise { const REGISTRY_URL = 'https://registry.arcrun.dev'; if (options.status) { try { const res = await fetch(`${REGISTRY_URL}/submit/status/${options.status}`); const data = await res.json() as { status: string; visibility?: string; failed_step?: string; reason?: string; approved_at?: string }; console.log(chalk.bold(`\n 提交狀態:${options.status}\n`)); console.log(` 狀態:${data.status}`); if (data.visibility) console.log(` Visibility:${data.visibility}`); if (data.failed_step) console.log(chalk.red(` 失敗步驟:${data.failed_step}`)); if (data.reason) console.log(chalk.red(` 原因:${data.reason}`)); if (data.approved_at) console.log(chalk.green(` 核准時間:${data.approved_at}`)); } catch (e) { console.error(chalk.red(`查詢失敗:${e instanceof Error ? e.message : e}`)); } return; } const config = loadConfig(); if (!config.api_key) { console.error(chalk.red('缺少 API Key,請執行 acr init')); process.exit(1); } const contractPath = join(componentDir, 'component.contract.yaml'); const mainGoPath = join(componentDir, 'main.go'); const wasmName = componentDir.split('/').pop() ?? componentDir; const wasmPath = join(componentDir, `${wasmName}.wasm`); if (!existsSync(contractPath)) { console.error(chalk.red(`找不到 ${contractPath}`)); process.exit(1); } if (!existsSync(wasmPath)) { console.error(chalk.red(`找不到 ${wasmPath}(請先編譯:tinygo build -o ${wasmName}.wasm -target wasi .)`)); process.exit(1); } console.log(chalk.bold('\n 提交零件至 registry.arcrun.dev...\n')); const formData = new FormData(); formData.append('contract', new Blob([readFileSync(contractPath)], { type: 'application/yaml' }), 'component.contract.yaml'); if (existsSync(mainGoPath)) { formData.append('source', new Blob([readFileSync(mainGoPath)], { type: 'text/plain' }), 'main.go'); } formData.append('wasm', new Blob([readFileSync(wasmPath)], { type: 'application/wasm' }), `${wasmName}.wasm`); try { const res = await fetch(`${REGISTRY_URL}/submit`, { method: 'POST', headers: { 'X-Arcrun-API-Key': config.api_key }, body: formData, }); if (!res.ok) { const err = await res.text(); console.error(chalk.red(`提交失敗(${res.status}):${err.slice(0, 200)}`)); process.exit(1); } const data = await res.json() as { submission_id: string; status: string; visibility?: string }; console.log(chalk.green(`✓ 提交成功`)); console.log(`\n Submission ID:${chalk.cyan(data.submission_id)}`); console.log(` 狀態:${data.status}`); if (data.visibility) console.log(` Visibility:${data.visibility}`); console.log(chalk.gray(`\n 查詢進度:acr parts publish --status ${data.submission_id}\n`)); } catch (e) { console.error(chalk.red(`提交失敗:${e instanceof Error ? e.message : e}`)); process.exit(1); } }