@argosvix/mcp-server 0.14.0-alpha.1 → 0.20.0-alpha.1

package/dist/tools.js

@@ -14,6 +14,8 @@
  * write tools:
  * - silence_alert / unsilence_alert = alert のミュート操作 (= Phase 2)
  * - create_alert = 新規 alert ルール作成 (= Phase 3)
+ * - update_alert / delete_alert = alert lifecycle 完結 (= v1.6 #13-4)
+ * - create_annotation / update_annotation / delete_annotation = annotation CRUD (= v1.6 #13-3)
  *
  * 残 (= acknowledge_alert / HTTP transport / resources・prompts) は後続 phase。
  */
@@ -48,6 +50,24 @@ const TOOL_ARG_ALLOWLIST = {
         "enabled",
         "conditions",
     ],
+    // 2026-06-03 v1.6 #13-4 = update_alert / delete_alert tools (= axis 1 強化)。
+    // backend PATCH/DELETE /v1/alerts/:id の wrap。 alertType は immutable (= backend
+    // validateUpdate で 400)、 schema 側にも入れない。 alertId は path 直前置換、
+    // body field のみ allowlist。
+    update_alert: [
+        "alertId",
+        "name",
+        "thresholdValue",
+        "windowMinutes",
+        "filterProvider",
+        "filterModel",
+        "channelKinds",
+        "channelTargets",
+        "sleepMinutes",
+        "enabled",
+        "conditions",
+    ],
+    delete_alert: ["alertId"],
     // Phase 3 read tools = alertId は path 直前置換 (= GET /v1/alerts/:id)。
     // list_alert_events は query param (limit / alertId) のみ allowlist。
     get_alert: ["alertId"],
@@ -61,15 +81,46 @@ const TOOL_ARG_ALLOWLIST = {
     list_annotations_for_call: ["callId"],
     list_annotations_by_label: ["label", "limit"],
     get_annotation: ["annotationId"],
+    // 2026-06-03 v1.6 #13-3 = annotation CRUD write tools (= axis 1 強化、
+    // 全社未対応領域での 新規優位)。 backend POST/PATCH/DELETE /v1/annotations を
+    // allowlist 経由で wrap。 annotation_text / label / quality_score の値域は
+    // backend で 最終 validation (= 2000 char / 50 char + 英数 _ - / 1-5 integer)。
+    create_annotation: ["callId", "annotationText", "label", "qualityScore"],
+    update_annotation: ["annotationId", "annotationText", "label", "qualityScore"],
+    delete_annotation: ["annotationId"],
     // 2026-06-02 v1.5 = eval criteria read tools。 global default + 自 account custom
     // の両方を visible。 criterionId は AUTOINCREMENT integer、 dispatch 側で validate。
     list_eval_criteria: [],
     get_eval_criterion: ["criterionId"],
+    // 2026-06-03 v1.6 #13-2 = eval criteria write tools (= axis 1 強化、 Langfuse 未対応領域)。
+    // Pro+ 専用。 create + update = full replace (= name + rubric + scaleMin + scaleMax 全
+    // 必須)、 delete = 自 account 内 only (= global default は 構造防御で対象外)。
+    create_eval_criterion: ["name", "rubric", "scaleMin", "scaleMax"],
+    update_eval_criterion: ["criterionId", "name", "rubric", "scaleMin", "scaleMax"],
+    delete_eval_criterion: ["criterionId"],
+    // 2026-06-03 v1.6 #13-5 = test_webhook tool (= alert webhook 試送 path)。
+    // backend POST /v1/alerts/test-webhook を allowlist 経由で wrap。 URL は SSRF
+    // 防御 (= validateWebhookTarget)、 secret は HMAC 署名用、 rate limit 5/分。
+    test_webhook: ["url", "secret", "alertName"],
+    // 2026-06-03 v1.6 #13-7 = LLM feature budget tools (= safety classifier +
+    // PII audit + eval baseline runner の 月予算 cap)。 get は Free / Pro+ 共通、
+    // raise は Pro+ 専用、 $5-$500 hard cap。 default $5 で 月跨ぎ で 自動 reset。
+    get_llm_budget: [],
+    raise_llm_budget: ["budgetUsd"],
     // 2026-06-02 v1.5 Round F = prompt registry read tools。 user の保存 prompt
     // template を tap で取得、 AI agent が template + variables + labels を context
     // に取り込む path。 name / label / limit は query param、 promptId は path 直前置換。
     list_prompts: ["label", "name", "limit"],
     get_prompt: ["promptId"],
+    // 2026-06-03 v1.6 #13-1 = prompt registry write tools (= axis 1 強化、 Langfuse
+    // 比較で同等領域)。 Pro+ 専用。 create = 新 version 作成、 update = template /
+    // variables / labels / description の部分更新、 rename = name + version 変更
+    // (= typo 修正軸、 UNIQUE 衝突 → 409)、 delete = 削除 (= 204)。 backend が field
+    // validation + plan gate + Origin/Referer CSRF 防御を carry する path に乗る。
+    create_prompt: ["name", "version", "template", "variables", "labels", "description"],
+    update_prompt: ["promptId", "template", "variables", "labels", "description"],
+    rename_prompt: ["promptId", "name", "version"],
+    delete_prompt: ["promptId"],
     // 2026-06-02 v1.5 closure = safety classifier read tools。 OpenAI Moderation
     // cron が書き込んだ assessment を AI agent から閲覧する path。 callId は
     // /v1/safety-assessments?call_id= query param、 assessmentId は path 直前置換。
@@ -79,7 +130,9 @@ const TOOL_ARG_ALLOWLIST = {
     // は scores 同梱、 run は POST (= Pro+ で startEvalRun に渡す軸)。
     list_eval_runs: ["limit"],
     get_eval_run: ["runId"],
-    run_eval: ["name", "recentCount", "label", "promptRegistryId"],
+    // 2026-06-02 Codex round 2 🔴 fix = idempotencyKey 必須 path (= AI agent が
+    // retry した時に backend で dedup)、 client が opaque string 64 char で carry。
+    run_eval: ["name", "recentCount", "label", "promptRegistryId", "idempotencyKey"],
 };
 export const tools = [
     {
@@ -353,6 +406,126 @@ export const tools = [
             },
         },
     },
+    {
+        name: "update_alert",
+        description: "既存 alert の設定を更新する (= PATCH /v1/alerts/:id)。 alertType (= 監視タイプ) は immutable で、 " +
+            "変更したい場合は新規 alert を作成してから旧 alert を delete する (= alert lifecycle 完結)。 " +
+            "閾値 / 評価窓 / 通知チャンネル / 名前 / 有効化フラグ / 複合条件 を 部分 update 可能 (= 全フィールド optional)。 " +
+            "例: 「月予算 alert の threshold を $100 → $50 に下げて」 / 「通知チャンネルを Slack に追加」。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["alertId"],
+            properties: {
+                alertId: {
+                    type: "string",
+                    description: "対象 alert の ID (= list_alerts で取得)",
+                    pattern: "^[A-Za-z0-9-]{1,64}$",
+                },
+                name: {
+                    type: "string",
+                    description: "alert の表示名 (1-100 文字、 改行不可)。 省略で 既存値維持",
+                    minLength: 1,
+                    maxLength: 100,
+                    pattern: "^[^\\r\\n]{1,100}$",
+                },
+                thresholdValue: {
+                    type: "number",
+                    description: "閾値 (= 0 以上)。 省略で 既存値維持",
+                    minimum: 0,
+                },
+                windowMinutes: {
+                    type: "integer",
+                    description: "集計時間窓 (分、 5-43200)。 省略で 既存値維持",
+                    minimum: 5,
+                    maximum: 43200,
+                },
+                filterProvider: {
+                    type: "string",
+                    description: "対象 provider。 省略で 既存値維持、 明示 null で 全 provider に解除",
+                    enum: ["openai", "anthropic", "gemini", "mistral"],
+                },
+                filterModel: {
+                    type: "string",
+                    description: "対象 model (部分一致)。 省略で 既存値維持、 明示 null で 全 model に解除",
+                    maxLength: 128,
+                },
+                channelKinds: {
+                    type: "array",
+                    description: "有効化する通知チャンネル種別。 省略で 既存値維持。 channelTargets と同時更新推奨",
+                    minItems: 1,
+                    items: { type: "string", enum: ["email", "slack", "webhook", "discord", "teams"] },
+                },
+                channelTargets: {
+                    type: "object",
+                    description: "channelKinds に挙げた各 kind の宛先 object。 省略で 既存値維持",
+                    additionalProperties: false,
+                    properties: {
+                        email: { type: "string", description: "通知先メールアドレス" },
+                        slack: { type: "string", description: "Slack Incoming Webhook URL" },
+                        webhook: { type: "string", description: "汎用 webhook URL (https)" },
+                        discord: { type: "string", description: "Discord webhook URL" },
+                        teams: { type: "string", description: "Microsoft Teams Incoming Webhook URL" },
+                    },
+                },
+                sleepMinutes: {
+                    type: "integer",
+                    description: "連続通知の抑制時間 (分、 5-10080)。 省略で 既存値維持",
+                    minimum: 5,
+                    maximum: 10080,
+                },
+                enabled: {
+                    type: "boolean",
+                    description: "alert の有効化フラグ。 false で 一時的に評価を止める (= silence と違い再 enable には PATCH 必要)",
+                },
+                conditions: {
+                    type: "object",
+                    description: "v1.5 multi-condition alert の更新。 指定すると 単 metric path を ignore し " +
+                        "AND/OR 集約 path に switch。 既存の 単 metric / multi-condition の どちらにも上書き可能。",
+                    required: ["operator", "conditions"],
+                    additionalProperties: false,
+                    properties: {
+                        operator: { type: "string", enum: ["AND", "OR"] },
+                        conditions: {
+                            type: "array",
+                            minItems: 1,
+                            maxItems: 8,
+                            items: {
+                                type: "object",
+                                additionalProperties: false,
+                                required: ["metric", "threshold", "windowMinutes", "comparator"],
+                                properties: {
+                                    metric: { type: "string" },
+                                    threshold: { type: "number" },
+                                    windowMinutes: { type: "integer", minimum: 5, maximum: 43200 },
+                                    comparator: { type: "string", enum: [">", "<", ">=", "<="] },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    {
+        name: "delete_alert",
+        description: "alert を 削除する (= DELETE /v1/alerts/:id)。 関連する alert_events も CASCADE 削除される。 " +
+            "誤削除防御のため、 必要に応じて事前に get_alert で 詳細確認を推奨。 " +
+            "alert を一時停止したいだけなら delete でなく silence_alert (= ミュート) または update_alert で " +
+            "enabled=false を 推奨 (= 復活可能)。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["alertId"],
+            properties: {
+                alertId: {
+                    type: "string",
+                    description: "対象 alert の ID (= list_alerts で取得)",
+                    pattern: "^[A-Za-z0-9-]{1,64}$",
+                },
+            },
+        },
+    },
     {
         name: "get_alert",
         description: "指定 alert の詳細設定と直近の trigger 履歴を返す。 list_alerts で得た alertId を渡す。 " +
@@ -478,6 +651,95 @@ export const tools = [
             },
         },
     },
+    {
+        name: "create_annotation",
+        description: "LLM call に対する新規 annotation (= human review / ラベル付け) を作成する。 " +
+            "annotationText / label / qualityScore のうち少なくとも 1 つを指定する (= 「空 annotation」 は backend で 400)。 " +
+            "用例: 「Claude、 この call を 『badly-summarized』 ラベルで quality 2 にして」、 " +
+            "「eval ループ用に positive / negative の 二極ラベルを 大量付与する」。 " +
+            "eval baseline runner (= run_eval) と 組み合わせると、 annotation を ground truth として 評価軸 を 校正できる。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["callId"],
+            properties: {
+                callId: {
+                    type: "string",
+                    description: "対象 call の id (= query_calls.records[].id)",
+                    pattern: "^[A-Za-z0-9_-]{1,128}$",
+                },
+                annotationText: {
+                    type: "string",
+                    description: "自由記述コメント (0-2000 文字)。 backend で長さ validation",
+                    maxLength: 2000,
+                },
+                label: {
+                    type: "string",
+                    description: "ラベル (0-50 文字、 英数 + _ - のみ)。 dashboard filter で 使える",
+                    maxLength: 50,
+                    pattern: "^[A-Za-z0-9_-]{0,50}$",
+                },
+                qualityScore: {
+                    type: "integer",
+                    description: "品質スコア (= 1-5 integer)。 省略で NULL",
+                    minimum: 1,
+                    maximum: 5,
+                },
+            },
+        },
+    },
+    {
+        name: "update_annotation",
+        description: "既存 annotation の annotationText / label / qualityScore を 部分更新する (= PATCH /v1/annotations/:id)。 " +
+            "callId は immutable。 「ラベルを 修正したい」 「qualityScore を 再評価して 4 → 5 に上げる」 用途。 " +
+            "annotation_id は list_annotations_for_call で取得した annotations[].id を渡す。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["annotationId"],
+            properties: {
+                annotationId: {
+                    type: "integer",
+                    description: "対象 annotation の id (= AUTOINCREMENT 数値)",
+                    minimum: 1,
+                },
+                annotationText: {
+                    type: "string",
+                    description: "新しいコメント (0-2000 文字)。 省略で 既存値維持",
+                    maxLength: 2000,
+                },
+                label: {
+                    type: "string",
+                    description: "新しいラベル (0-50 文字、 英数 + _ - のみ)。 省略で 既存値維持",
+                    maxLength: 50,
+                    pattern: "^[A-Za-z0-9_-]{0,50}$",
+                },
+                qualityScore: {
+                    type: "integer",
+                    description: "新しい品質スコア (= 1-5)。 省略で 既存値維持",
+                    minimum: 1,
+                    maximum: 5,
+                },
+            },
+        },
+    },
+    {
+        name: "delete_annotation",
+        description: "annotation を 削除する (= DELETE /v1/annotations/:id)。 関連 row は他に存在しないので CASCADE 影響なし。 " +
+            "誤削除防御のため、 必要に応じて事前に get_annotation で 詳細確認を推奨。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["annotationId"],
+            properties: {
+                annotationId: {
+                    type: "integer",
+                    description: "対象 annotation の id (= AUTOINCREMENT 数値)",
+                    minimum: 1,
+                },
+            },
+        },
+    },
     {
         name: "list_eval_criteria",
         description: "LLM-as-judge の評価軸 (criteria) 一覧を返す。 global default 5 軸 " +
@@ -510,6 +772,177 @@ export const tools = [
             },
         },
     },
+    {
+        name: "create_eval_criterion",
+        description: "自 account custom eval criterion を 1 件作成する (= Pro+ 専用、 v1.6 #13-2)。 " +
+            "name + rubric + scaleMin + scaleMax の 4 field 全部必須。 同 account 内で 同 name 既存 = 409。 " +
+            "global default と同 name は 構造的に重複可 (= UNIQUE (account_id, name) で account_id IS NULL と分離)。 " +
+            "AI agent が dogfood eval で 「この基準を追加」 と判断した時の axis 1 path。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["name", "rubric", "scaleMin", "scaleMax"],
+            properties: {
+                name: {
+                    type: "string",
+                    description: "criterion 名 (= 1-50 文字、 英数始まり、 [A-Za-z0-9 _\\-.] のみ)。 例 'helpfulness' / 'concise'",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9 _\\-.]{0,49}$",
+                    minLength: 1,
+                    maxLength: 50,
+                },
+                rubric: {
+                    type: "string",
+                    description: "scoring rubric 本文 (= 10-2000 文字、 judge LLM が score の根拠とする narrative)",
+                    minLength: 10,
+                    maxLength: 2000,
+                },
+                scaleMin: {
+                    type: "integer",
+                    description: "score 下限 (= 1-100 範囲、 scaleMax より小さい)",
+                    minimum: 1,
+                    maximum: 100,
+                },
+                scaleMax: {
+                    type: "integer",
+                    description: "score 上限 (= 1-100 範囲、 scaleMin より大きい)",
+                    minimum: 1,
+                    maximum: 100,
+                },
+            },
+        },
+    },
+    {
+        name: "update_eval_criterion",
+        description: "自 account custom criterion を full replace で更新する (= Pro+ 専用、 PATCH /v1/eval-criteria/:id)。 " +
+            "name + rubric + scaleMin + scaleMax の 4 field 全部必須 (= 部分更新ではない、 全 field 上書き)。 " +
+            "global default (= account_id IS NULL) は 構造的に対象外 (= 404)、 他 account の custom も 404。 " +
+            "同 account 内 で 同 name 衝突 = 409。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["criterionId", "name", "rubric", "scaleMin", "scaleMax"],
+            properties: {
+                criterionId: {
+                    type: "integer",
+                    description: "対象 criterion の id (= list_eval_criteria.criteria[].id)",
+                    minimum: 1,
+                },
+                name: {
+                    type: "string",
+                    description: "新 name (= 1-50 文字、 英数始まり、 [A-Za-z0-9 _\\-.] のみ)",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9 _\\-.]{0,49}$",
+                    minLength: 1,
+                    maxLength: 50,
+                },
+                rubric: {
+                    type: "string",
+                    description: "新 rubric (= 10-2000 文字)",
+                    minLength: 10,
+                    maxLength: 2000,
+                },
+                scaleMin: {
+                    type: "integer",
+                    description: "新 scaleMin (= 1-100、 scaleMax より小さい)",
+                    minimum: 1,
+                    maximum: 100,
+                },
+                scaleMax: {
+                    type: "integer",
+                    description: "新 scaleMax (= 1-100、 scaleMin より大きい)",
+                    minimum: 1,
+                    maximum: 100,
+                },
+            },
+        },
+    },
+    {
+        name: "get_llm_budget",
+        description: "現在の LLM feature 月予算 (= safety classifier + PII 二次 audit + eval baseline runner の 3 軸 LLM cost cap) を取得する (= v1.6 #13-7)。 " +
+            "response = { budgetUsd, spentUsd, remainingUsd, periodStart, defaultBudgetUsd, minBudgetUsd, maxBudgetUsd }。 " +
+            "Free / Pro+ 共通で読み取り可能、 「予算 80% 到達したか?」 「raise すべきか?」 を AI agent が 判断する path で使う。 " +
+            "default = $5/月、 月跨ぎ (= YYYY-MM 単位) で 自動 reset。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {},
+        },
+    },
+    {
+        name: "raise_llm_budget",
+        description: "LLM feature 月予算 を 引き上げる / 引き下げる (= Pro+ 専用、 v1.6 #13-7)。 " +
+            "range = $5 - $500 (= hard cap で runaway 防御)、 0.01 USD 単位。 既存 spent は そのまま carry、 月跨ぎ で 自動 reset。 " +
+            "用例: 「予算が 80% 到達した、 今月だけ $30 に上げて」 / 「使いすぎたから来月は $10 に下げて」。 " +
+            "新規 値 < 現 spent でも accept (= remaining が 0 になるだけ、 月跨ぎで 0 から計上 carry)。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["budgetUsd"],
+            properties: {
+                budgetUsd: {
+                    type: "number",
+                    description: "新 月予算 USD (= 5-500、 0.01 単位)。 例 30 / 50.5 / 100",
+                    minimum: 5,
+                    maximum: 500,
+                },
+            },
+        },
+    },
+    {
+        name: "test_webhook",
+        description: "指定 URL に 1 件 fabricated alert を 試送する (= Pro+ 専用、 v1.6 #13-5)。 " +
+            "user が webhook URL を 登録する 前 に 「届くか」 を 確認する 主用途。 " +
+            "SSRF 防御で https 必須 + private / loopback / cloud metadata IP は reject。 " +
+            "secret 指定時は HMAC-SHA256 署名 (= X-Argosvix-Signature) を 添付。 " +
+            "rate limit = account 単位 5/分 (= 60s sliding window、 worker instance 越境で 超過余地あり)。 " +
+            "response.delivered = receiver が 5s 以内に 2xx 返した か。 false の場合は 「URL 不正 / timeout / 5xx / network error」 のいずれか。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["url"],
+            properties: {
+                url: {
+                    type: "string",
+                    description: "送信先 webhook URL (= https、 SSRF 防御済、 1-500 chars)",
+                    minLength: 1,
+                    maxLength: 500,
+                },
+                secret: {
+                    type: "string",
+                    description: "HMAC-SHA256 署名用 secret (= 任意、 1-256 chars、 receiver 側で X-Argosvix-Signature 検証)",
+                    minLength: 1,
+                    maxLength: 256,
+                },
+                alertName: {
+                    type: "string",
+                    description: "fabricated alert の name (= 任意、 1-64 chars、 [A-Za-z0-9 _\\-.] のみ)。 省略時は 'argosvix test alert'",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9 _\\-.]{0,63}$",
+                    minLength: 1,
+                    maxLength: 64,
+                },
+            },
+        },
+    },
+    {
+        name: "delete_eval_criterion",
+        description: "自 account custom criterion を 削除する (= Pro+ 専用、 DELETE /v1/eval-criteria/:id、 204)。 " +
+            "global default (= account_id IS NULL) は 構造防御で対象外 = 404、 他 account も 404。 " +
+            "⚠ 過去全 eval_run の 該当 criterion score 行 (= eval_scores) も ON DELETE CASCADE で 同時に物理削除される、 " +
+            "履歴比較や score 推移分析が 永久に不可になる。 " +
+            "AI agent が 「criterion 整理」 で 軽い気持ちで 呼ぶ tool ではない、 過去 run の 該当 score が要らないと user が明示確認した時のみ carry。 " +
+            "rename したい だけ なら update_eval_criterion (= full replace) で name + rubric + scaleMin + scaleMax を carry する 方が 履歴を 失わずに 済む。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["criterionId"],
+            properties: {
+                criterionId: {
+                    type: "integer",
+                    description: "対象 criterion の id (= list_eval_criteria.criteria[].id)",
+                    minimum: 1,
+                },
+            },
+        },
+    },
     {
         name: "list_prompts",
         description: "user が登録した prompt template の一覧を返す (= migration 0038 prompt_registry、 v1.5 Round F)。 " +
@@ -559,6 +992,139 @@ export const tools = [
             },
         },
     },
+    {
+        name: "create_prompt",
+        description: "新 prompt template を 1 件登録する (= Pro+ 専用、 v1.6 #13-1)。 name + version + template が 必須、 " +
+            "variables / labels / description は 任意。 同 (name, version) が 既存 = 409 を 返す (= UNIQUE 制約)。 " +
+            "AI agent が dogfood eval / experiment 用に template を 自動登録する path で 使う。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["name", "version", "template"],
+            properties: {
+                name: {
+                    type: "string",
+                    description: "prompt 名 (= 同 series 識別子、 [A-Za-z0-9][A-Za-z0-9_-]{0,63})。 例 'customer_support'",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+                },
+                version: {
+                    type: "string",
+                    description: "version 識別子 (= [A-Za-z0-9][A-Za-z0-9._-]{0,63})。 例 'v1' / '1.0.2' / '2026-06-03'",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
+                },
+                template: {
+                    type: "string",
+                    description: "prompt body 本文 (= 非空、 最大 50000 文字)。 {{var}} で variables 補完。",
+                    minLength: 1,
+                    maxLength: 50000,
+                },
+                variables: {
+                    type: "object",
+                    description: "template 内 {{var}} の default 値 (= plain object、 JSON 化後 4096 bytes 上限)。 任意。",
+                    additionalProperties: true,
+                },
+                labels: {
+                    type: "array",
+                    description: "label 配列 (= 最大 8 件、 各 [A-Za-z0-9][A-Za-z0-9_-]{0,31})。 例 ['production', 'staging']。",
+                    items: { type: "string", pattern: "^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$" },
+                    maxItems: 8,
+                },
+                description: {
+                    type: "string",
+                    description: "説明文 (= 最大 500 文字)。 任意。",
+                    maxLength: 500,
+                },
+            },
+        },
+    },
+    {
+        name: "update_prompt",
+        description: "既存 prompt の template / variables / labels / description を 部分更新する (= Pro+ 専用、 PATCH /v1/prompts/:id)。 " +
+            "name + version は immutable (= 変更は rename_prompt 経由)。 promptId 必須、 残 field は 指定 した もの のみ 更新。 " +
+            "AI agent が label の付け替え (= 'staging' → 'production' 昇格) や 微修正 patch path で 使う。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["promptId"],
+            properties: {
+                promptId: {
+                    type: "integer",
+                    description: "対象 prompt の id (= list_prompts.prompts[].id)",
+                    minimum: 1,
+                },
+                template: {
+                    type: "string",
+                    description: "新 template 本文 (= 非空、 最大 50000 文字)。",
+                    minLength: 1,
+                    maxLength: 50000,
+                },
+                variables: {
+                    type: "object",
+                    description: "新 variables (= plain object、 null で 全消し)。",
+                    additionalProperties: true,
+                },
+                labels: {
+                    type: "array",
+                    description: "新 labels (= 完全置換、 最大 8 件、 各 [A-Za-z0-9][A-Za-z0-9_-]{0,31})。",
+                    items: { type: "string", pattern: "^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$" },
+                    maxItems: 8,
+                },
+                description: {
+                    type: "string",
+                    description: "新 description (= 1-500 文字)。 既存 description を 明示的に clear したい場合は この field を 渡さずに 他 field のみ で PATCH する (= 空文字 '' は schema 拒否、 LLM の hallucination で 既存 description が 消える 事故防止)。",
+                    minLength: 1,
+                    maxLength: 500,
+                },
+            },
+        },
+    },
+    {
+        name: "rename_prompt",
+        description: "既存 prompt の name + version を 変更する (= Pro+ 専用、 POST /v1/prompts/:id/rename)。 " +
+            "typo 修正軸 (= 'customer_supprt' → 'customer_support') が 主用途。 同 account 内で 既存 (name, version) と 衝突 = 409。 " +
+            "update_prompt が name/version を 変えない 規約な ので、 rename は 別 tool で 意味的分離。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["promptId", "name", "version"],
+            properties: {
+                promptId: {
+                    type: "integer",
+                    description: "対象 prompt の id (= list_prompts.prompts[].id)",
+                    minimum: 1,
+                },
+                name: {
+                    type: "string",
+                    description: "新 name (= [A-Za-z0-9][A-Za-z0-9_-]{0,63})",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+                },
+                version: {
+                    type: "string",
+                    description: "新 version (= [A-Za-z0-9][A-Za-z0-9._-]{0,63})",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
+                },
+            },
+        },
+    },
+    {
+        name: "delete_prompt",
+        description: "既存 prompt を 削除する (= Pro+ 専用、 DELETE /v1/prompts/:id、 204 No Content)。 " +
+            "自 account scope (= 他 account の id は 404)。 ⚠ 物理削除な ので 復元不可、 " +
+            "過去の eval_runs の prompt_registry_id は SET NULL になり 「どの prompt template で run したか」 の trace が失われる (= 履歴比較で 紐付き 不可)。 " +
+            "AI agent は 「rotation で 旧 version を sunset」 で 使う 場合 でも、 過去 run trace が 残っている うちは update_prompt で labels を 'sunset' 等に carry して論理 sunset する 方が安全。",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            required: ["promptId"],
+            properties: {
+                promptId: {
+                    type: "integer",
+                    description: "対象 prompt の id (= list_prompts.prompts[].id)",
+                    minimum: 1,
+                },
+            },
+        },
+    },
     {
         name: "list_safety_assessments",
         description: "safety classifier (= OpenAI Moderation cron) が 書き込んだ assessment を 一覧取得する。 " +
@@ -672,6 +1238,12 @@ export const tools = [
                     description: "対象 prompt registry の id (= list_prompts.prompts[].id)。 省略 = ad-hoc run。",
                     minimum: 1,
                 },
+                idempotencyKey: {
+                    type: "string",
+                    description: "retry dedup 用の opaque key (= UUID 推奨、 64 char cap)。 同 key で 60 分以内に再 POST すると 既存 run を そのまま返す。",
+                    minLength: 1,
+                    maxLength: 64,
+                },
             },
         },
     },
@@ -774,6 +1346,29 @@ export async function dispatchTool(input) {
                     jsonBody: safeArgs,
                 });
             }
+            case "update_alert": {
+                // 2026-06-03 v1.6 #13-4 = PATCH /v1/alerts/:id 経由で 既存 alert を partial update。
+                // alertId は path 直前置換、 body は残りの allowlist 済 field (= name /
+                // thresholdValue / windowMinutes / filterProvider / filterModel /
+                // channelKinds / channelTargets / sleepMinutes / enabled / conditions)。
+                // alertType は schema にも入れていない (= immutable)。 backend validateUpdate が
+                // 二重防御で最終 validation。
+                const alertId = validateAlertId(safeArgs["alertId"]);
+                if (!alertId) {
+                    return errorResponse("alertId required (pattern: [A-Za-z0-9-]{1,64})");
+                }
+                const { alertId: _ignore, ...body } = safeArgs;
+                return await callApi(apiBase, `/v1/alerts/${encodeURIComponent(alertId)}`, {}, apiKey, { method: "PATCH", jsonBody: body });
+            }
+            case "delete_alert": {
+                // 2026-06-03 v1.6 #13-4 = DELETE /v1/alerts/:id。 関連 alert_events も backend
+                // 側で CASCADE 削除される。 body なし、 alertId のみ path 直前置換。
+                const alertId = validateAlertId(safeArgs["alertId"]);
+                if (!alertId) {
+                    return errorResponse("alertId required (pattern: [A-Za-z0-9-]{1,64})");
+                }
+                return await callApi(apiBase, `/v1/alerts/${encodeURIComponent(alertId)}`, {}, apiKey, { method: "DELETE" });
+            }
             case "get_alert": {
                 const alertId = validateAlertId(safeArgs["alertId"]);
                 if (!alertId) {
@@ -822,6 +1417,38 @@ export async function dispatchTool(input) {
                 }
                 return await callApi(apiBase, `/v1/annotations/${encodeURIComponent(annotationId)}`, {}, apiKey);
             }
+            case "create_annotation": {
+                // 2026-06-03 v1.6 #13-3 = POST /v1/annotations。 callId は body 必須、
+                // annotationText / label / qualityScore のうち少なくとも 1 つは backend で
+                // validate される (= 「空 annotation」 を 400)。 safeArgs は allowlist 済。
+                const callId = validateCallId(safeArgs["callId"]);
+                if (!callId) {
+                    return errorResponse("callId required (pattern: [A-Za-z0-9_-]{1,128})");
+                }
+                return await callApi(apiBase, "/v1/annotations", {}, apiKey, {
+                    method: "POST",
+                    jsonBody: safeArgs,
+                });
+            }
+            case "update_annotation": {
+                // 2026-06-03 v1.6 #13-3 = PATCH /v1/annotations/:id with allowlisted body。
+                // annotationId は path 直前置換、 body は残りの 3 field (= annotationText /
+                // label / qualityScore)。 callId は immutable (= schema 不在で 二重防御)。
+                const annotationId = validateAnnotationId(safeArgs["annotationId"]);
+                if (!annotationId) {
+                    return errorResponse("annotationId required (positive integer up to 10 digits)");
+                }
+                const { annotationId: _ignore, ...body } = safeArgs;
+                return await callApi(apiBase, `/v1/annotations/${encodeURIComponent(annotationId)}`, {}, apiKey, { method: "PATCH", jsonBody: body });
+            }
+            case "delete_annotation": {
+                // 2026-06-03 v1.6 #13-3 = DELETE /v1/annotations/:id。 body なし。
+                const annotationId = validateAnnotationId(safeArgs["annotationId"]);
+                if (!annotationId) {
+                    return errorResponse("annotationId required (positive integer up to 10 digits)");
+                }
+                return await callApi(apiBase, `/v1/annotations/${encodeURIComponent(annotationId)}`, {}, apiKey, { method: "DELETE" });
+            }
             case "list_eval_criteria": {
                 return await callApi(apiBase, "/v1/eval-criteria", {}, apiKey);
             }
@@ -832,6 +1459,63 @@ export async function dispatchTool(input) {
                 }
                 return await callApi(apiBase, `/v1/eval-criteria/${encodeURIComponent(criterionId)}`, {}, apiKey);
             }
+            case "create_eval_criterion": {
+                if (typeof safeArgs["name"] !== "string" ||
+                    typeof safeArgs["rubric"] !== "string" ||
+                    typeof safeArgs["scaleMin"] !== "number" ||
+                    typeof safeArgs["scaleMax"] !== "number") {
+                    return errorResponse("name + rubric + scaleMin + scaleMax required");
+                }
+                return await callApi(apiBase, "/v1/eval-criteria", {}, apiKey, {
+                    method: "POST",
+                    jsonBody: safeArgs,
+                });
+            }
+            case "update_eval_criterion": {
+                const criterionId = validateAnnotationId(safeArgs["criterionId"]);
+                if (!criterionId) {
+                    return errorResponse("criterionId required (positive integer up to 10 digits)");
+                }
+                if (typeof safeArgs["name"] !== "string" ||
+                    typeof safeArgs["rubric"] !== "string" ||
+                    typeof safeArgs["scaleMin"] !== "number" ||
+                    typeof safeArgs["scaleMax"] !== "number") {
+                    return errorResponse("name + rubric + scaleMin + scaleMax required");
+                }
+                const { criterionId: _ignore, ...body } = safeArgs;
+                return await callApi(apiBase, `/v1/eval-criteria/${encodeURIComponent(criterionId)}`, {}, apiKey, {
+                    method: "PATCH",
+                    jsonBody: body,
+                });
+            }
+            case "delete_eval_criterion": {
+                const criterionId = validateAnnotationId(safeArgs["criterionId"]);
+                if (!criterionId) {
+                    return errorResponse("criterionId required (positive integer up to 10 digits)");
+                }
+                return await callApi(apiBase, `/v1/eval-criteria/${encodeURIComponent(criterionId)}`, {}, apiKey, { method: "DELETE" });
+            }
+            case "test_webhook": {
+                if (typeof safeArgs["url"] !== "string") {
+                    return errorResponse("url required (https://...)");
+                }
+                return await callApi(apiBase, "/v1/alerts/test-webhook", {}, apiKey, {
+                    method: "POST",
+                    jsonBody: safeArgs,
+                });
+            }
+            case "get_llm_budget": {
+                return await callApi(apiBase, "/v1/account/llm-feature-budget", {}, apiKey);
+            }
+            case "raise_llm_budget": {
+                if (typeof safeArgs["budgetUsd"] !== "number") {
+                    return errorResponse("budgetUsd required (number, 5-500)");
+                }
+                return await callApi(apiBase, "/v1/account/llm-feature-budget", {}, apiKey, {
+                    method: "PATCH",
+                    jsonBody: safeArgs,
+                });
+            }
             case "list_prompts": {
                 const q = {};
                 if (typeof safeArgs["label"] === "string")
@@ -849,6 +1533,46 @@ export async function dispatchTool(input) {
                 }
                 return await callApi(apiBase, `/v1/prompts/${encodeURIComponent(promptId)}`, {}, apiKey);
             }
+            case "create_prompt": {
+                if (typeof safeArgs["name"] !== "string" || typeof safeArgs["version"] !== "string" || typeof safeArgs["template"] !== "string") {
+                    return errorResponse("name + version + template required");
+                }
+                return await callApi(apiBase, "/v1/prompts", {}, apiKey, {
+                    method: "POST",
+                    jsonBody: safeArgs,
+                });
+            }
+            case "update_prompt": {
+                const promptId = validateAnnotationId(safeArgs["promptId"]);
+                if (!promptId) {
+                    return errorResponse("promptId required (positive integer up to 10 digits)");
+                }
+                const { promptId: _ignore, ...body } = safeArgs;
+                return await callApi(apiBase, `/v1/prompts/${encodeURIComponent(promptId)}`, {}, apiKey, {
+                    method: "PATCH",
+                    jsonBody: body,
+                });
+            }
+            case "rename_prompt": {
+                const promptId = validateAnnotationId(safeArgs["promptId"]);
+                if (!promptId) {
+                    return errorResponse("promptId required (positive integer up to 10 digits)");
+                }
+                if (typeof safeArgs["name"] !== "string" || typeof safeArgs["version"] !== "string") {
+                    return errorResponse("name + version required");
+                }
+                return await callApi(apiBase, `/v1/prompts/${encodeURIComponent(promptId)}/rename`, {}, apiKey, {
+                    method: "POST",
+                    jsonBody: { name: safeArgs["name"], version: safeArgs["version"] },
+                });
+            }
+            case "delete_prompt": {
+                const promptId = validateAnnotationId(safeArgs["promptId"]);
+                if (!promptId) {
+                    return errorResponse("promptId required (positive integer up to 10 digits)");
+                }
+                return await callApi(apiBase, `/v1/prompts/${encodeURIComponent(promptId)}`, {}, apiKey, { method: "DELETE" });
+            }
             case "list_safety_assessments": {
                 const q = {};
                 if (typeof safeArgs["callId"] === "string") {
@@ -891,6 +1615,8 @@ export async function dispatchTool(input) {
                     body["label"] = safeArgs["label"];
                 if (typeof safeArgs["promptRegistryId"] === "number")
                     body["promptRegistryId"] = safeArgs["promptRegistryId"];
+                if (typeof safeArgs["idempotencyKey"] === "string")
+                    body["idempotencyKey"] = safeArgs["idempotencyKey"];
                 return await callApi(apiBase, "/v1/eval-runs", {}, apiKey, {
                     method: "POST",
                     jsonBody: body,