owner-clone-ai-mcp 1.78.0 → 1.78.2

package/domains/video.js

@@ -64,7 +64,7 @@ const tools = [
       title: { type: 'string' },
       timeline: { type: 'object', description: 'タイムラインJSON（全置換・形式は get_video_timeline_spec）' },
       deck_id: { type: 'string', description: '参照スライドデッキの差し替え。スライドを作り直した場合はここで新しいデッキIDを指定し、timeline 側の各クリップの deckId も同じ値に揃えてください（尺やタイミングはそのまま保てます）' },
-      base_updated_at: { type: 'string', description: 'get_video_project で取得した updated_at。渡すと、その後にユーザーが編集画面で保存していた場合に上書きせずエラーを返します（推奨）' },
+      base_updated_at: { type: 'string', description: 'get_video_project で取得した updated_at。渡すと、その後にユーザーが編集画面で保存していた場合に上書きせずエラー（409）を返します（推奨）。⚠️ 409 の本文には最新の updated_at と changed（違いのある層: telop/audio/video など）、meta_only（違いが素材のメタ情報だけか）が入ります。meta_only:true は編集画面がファイルを割り当てただけの公算が高く、返ってきた updated_at をそのまま base_updated_at に入れて再送して差し支えありません。changed に自分が書き換える層が挙がっているときは、get_video_project で取り込んでから判断してください。なお同じ内容を再送した場合は 409 ではなく unchanged:true の成功が返るため、リトライは安全です' },
     }, required: ['id'] },
   },
   {
@@ -92,7 +92,7 @@ const tools = [
       gain: { type: 'number', description: '音量（1=100%・BGMは0.3程度）' },
       muted: { type: 'boolean', description: 'video のとき true でその動画の音を使わない' },
       media_id: { type: 'string', description: '複数の素材を使い分けるときの識別子（省略時は type から自動）' },
-      base_updated_at: { type: 'string', description: '競合防止（get_video_project の updated_at）' },
+      base_updated_at: { type: 'string', description: '競合防止（get_video_project の updated_at）。⚠️ 409 の本文に最新 updated_at / changed（違いのある層）/ meta_only が入る。meta_only:true はそのまま再送可。同一内容の再送は 409 にならず unchanged:true の成功が返る' },
     }, required: ['id', 'type', 'file_name'] },
   },
   {
@@ -116,7 +116,7 @@ const tools = [
       lead_sec: { type: 'number', description: '発話より何秒早く出すか（既定0.4）' },
       max_chars: { type: 'number', description: '1行の最大文字数。超えたら自動で改行する（既定20）' },
       replace: { type: 'boolean', description: 'true=既存のテロップを置き換える（省略=追加）' },
-      base_updated_at: { type: 'string', description: '競合防止（get_video_project の updated_at）' },
+      base_updated_at: { type: 'string', description: '競合防止（get_video_project の updated_at）。⚠️ 409 の本文に最新 updated_at / changed（違いのある層）/ meta_only が入る。meta_only:true はそのまま再送可。同一内容の再送は 409 にならず unchanged:true の成功が返る' },
     }, required: ['id', 'srt'] },
   },
   {
@@ -130,7 +130,7 @@ const tools = [
       media_id: { type: 'string', description: '同じ種類が複数あるときの絞り込み（mediaId）' },
       clips: { type: 'array', items: { type: 'object' }, description: 'そのトラックのクリップ配列（全置換）。形式は get_video_timeline_spec' },
       remove: { type: 'boolean', description: 'true=このトラックを削除する' },
-      base_updated_at: { type: 'string', description: '競合防止（get_video_project の updated_at）' },
+      base_updated_at: { type: 'string', description: '競合防止（get_video_project の updated_at）。⚠️ 409 の本文に最新 updated_at / changed（違いのある層）/ meta_only が入る。meta_only:true はそのまま再送可。同一内容の再送は 409 にならず unchanged:true の成功が返る' },
     }, required: ['id', 'type'] },
   },
   {

package/lib/api.js

@@ -6,6 +6,43 @@ const API_KEY  = process.env.OCR_API_KEY;
 //    （配布物 manifest.json / install.ps1 / 案内はすべて api.ownercloneai.com 指定済み）。
 const BASE_URL = (process.env.OCR_BASE_URL || 'https://api.ownercloneai.com').replace(/\/$/, '');
 
+// ── エラー応答を「AIがそのまま読んで判断できる」文に組み立てる ────────────────
+// ⚠️ 2026-10-01: 以前は json.error と json.detail しか見ておらず、
+//    サーバーが返している updated_at / changed / meta_only / hint を**捨てていた**。
+//    そのため B-5（409の往復をなくす）の情報が AI に届かず、
+//    結局 get_video_project を取り直す往復が必要なままだった。
+//    ⚠️ 汎用にする: 既知のキーだけでなく、未知の付加フィールドも落とさず載せる。
+//    将来サーバーが新しい手がかりを足しても、パッケージの改修なしで AI に届く。
+const PRIMARY_KEYS = ['error', 'message', 'detail'];
+// 値が長くなりすぎるもの（本体データ）は載せない。手がかりだけを渡す
+const SKIP_KEYS = ['timeline', 'deck', 'tracks', 'slides', 'chapters', 'items', 'rows'];
+
+function formatValue(v) {
+  if (Array.isArray(v)) return v.length ? v.join(', ') : '（なし）';
+  if (v && typeof v === 'object') return JSON.stringify(v);
+  return String(v);
+}
+
+function buildApiError(json, status) {
+  if (!json || typeof json !== 'object') return new Error(`API error ${status}`);
+  const head = json.detail
+    ? `${json.error || 'エラー'}: ${json.detail}`
+    : (json.error || json.message || `API error ${status}`);
+  const extras = [];
+  for (const [k, v] of Object.entries(json)) {
+    if (PRIMARY_KEYS.includes(k) || SKIP_KEYS.includes(k)) continue;
+    if (v === undefined || v === null || v === '') continue;
+    extras.push(`${k}: ${formatValue(v)}`);
+  }
+  // hint はサーバーが「次に何をすべきか」を書いた文。最後に独立した行で出す
+  const hint = typeof json.hint === 'string' ? json.hint : null;
+  const body = extras.filter(x => !x.startsWith('hint: ')).join(' / ');
+  const err = new Error([head, body, hint].filter(Boolean).join('\n'));
+  err.status = status;
+  err.body = json;          // プログラムから読みたいときのために原本も残す
+  return err;
+}
+
 async function callApi(path, options = {}) {
   // ⚠️ 2026-09-30: `callApi(path, 'POST', body)` という別流儀で書かれた2箇所が静かに壊れていた
   //    （domains/slides.js の save_brand_theme / apply_brand_theme）。文字列を options として
@@ -30,11 +67,9 @@ async function callApi(path, options = {}) {
   });
   const json = await res.json();
   if (!res.ok) {
-    // バックエンドが detail（DB例外メッセージ等）を返す場合は原因特定のため併記
-    const msg = json && json.detail ? `${json.error || 'エラー'}: ${json.detail}` : (json.error || `API error ${res.status}`);
-    throw new Error(msg);
+    throw buildApiError(json, res.status);
   }
   return json;
 }
 
-module.exports = { callApi };
+module.exports = { callApi, buildApiError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "owner-clone-ai-mcp",
-  "version": "1.78.0",
+  "version": "1.78.2",
   "description": "MCP server for Owner Clone AI — exposes knowledge and agent presets to Claude Code",
   "main": "index.js",
   "bin": {