@tocca-systems/twp-cli 0.14.0 → 0.15.0

package/command-model/private-agent-loop.json

@@ -0,0 +1,850 @@
+{
+  "domain": "private-agent-loop",
+  "operations": [
+    {
+      "name": "claim",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.claim",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/claim",
+      "summary": "pending アイテムをアトミックに取得",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "claim-schedule-window",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.claimScheduleWindow",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/schedules/{scheduleId}/claim",
+      "summary": "枠をアトミックに獲得する",
+      "pathParams": [
+        {
+          "name": "scheduleId",
+          "type": "string",
+          "required": true,
+          "source": "spec"
+        }
+      ],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "consume-counter",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.consumeCounter",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/counters/consume",
+      "summary": "カウンタを1つ消費する",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "count",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.count",
+      "method": "GET",
+      "path": "/v2/tasks/private/agent-loop/count",
+      "summary": "アイテム件数を概算取得（非同期・非ブロッキング用）",
+      "pathParams": [],
+      "queryParams": [
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "1ページあたりの件数",
+          "source": "curation"
+        },
+        {
+          "name": "cursor",
+          "type": "string",
+          "required": false,
+          "description": "次ページの取得に使うカーソル",
+          "source": "curation"
+        }
+      ],
+      "body": null,
+      "resultPath": "",
+      "risk": "read",
+      "aliases": []
+    },
+    {
+      "name": "counters",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.counters",
+      "method": "GET",
+      "path": "/v2/tasks/private/agent-loop/counters",
+      "summary": "カウンタ一覧を取得する",
+      "pathParams": [],
+      "queryParams": [
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "1ページあたりの件数",
+          "source": "curation"
+        },
+        {
+          "name": "cursor",
+          "type": "string",
+          "required": false,
+          "description": "次ページの取得に使うカーソル",
+          "source": "curation"
+        }
+      ],
+      "body": null,
+      "resultPath": null,
+      "risk": "read",
+      "aliases": []
+    },
+    {
+      "name": "create",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.store",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop",
+      "summary": "アイテムを作成",
+      "pathParams": [],
+      "queryParams": [],
+      "body": {
+        "schema": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string",
+              "maxLength": 255
+            },
+            "prompt": {
+              "type": "string"
+            },
+            "ai_type": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "enum": [
+                "claude",
+                "gemini",
+                "codex",
+                "copilot",
+                null
+              ]
+            },
+            "ai_model": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 100
+            },
+            "ai_effort": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "enum": [
+                "low",
+                "medium",
+                "high",
+                "xhigh",
+                "max",
+                null
+              ]
+            },
+            "task_key": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 50
+            }
+          },
+          "required": [
+            "label",
+            "prompt"
+          ]
+        }
+      },
+      "resultPath": "",
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "delete",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.destroy",
+      "method": "DELETE",
+      "path": "/v2/tasks/private/agent-loop/{itemId}",
+      "summary": "アイテムを削除",
+      "pathParams": [
+        {
+          "name": "itemId",
+          "type": "string",
+          "required": true,
+          "source": "spec"
+        }
+      ],
+      "queryParams": [],
+      "body": null,
+      "resultPath": "",
+      "risk": "destructive",
+      "aliases": []
+    },
+    {
+      "name": "deregister-runner",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.deregisterRunner",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/runners/deregister",
+      "summary": "ランナーの登録解除（正常終了時）",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": "",
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "destroy-schedule-definition",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.destroyScheduleDefinition",
+      "method": "DELETE",
+      "path": "/v2/tasks/private/agent-loop/schedules/definitions/{scheduleId}",
+      "summary": "定義を削除（`revision` の楽観ロック）",
+      "pathParams": [
+        {
+          "name": "scheduleId",
+          "type": "string",
+          "required": true,
+          "source": "spec"
+        }
+      ],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "destructive",
+      "aliases": []
+    },
+    {
+      "name": "finish-plan",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.finishPlan",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/plan/finish",
+      "summary": "計画ロックを解放",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "get",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.show",
+      "method": "GET",
+      "path": "/v2/tasks/private/agent-loop/{itemId}",
+      "summary": "アイテムを取得",
+      "pathParams": [
+        {
+          "name": "itemId",
+          "type": "string",
+          "required": true,
+          "source": "spec"
+        }
+      ],
+      "queryParams": [
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "1ページあたりの件数",
+          "source": "curation"
+        },
+        {
+          "name": "cursor",
+          "type": "string",
+          "required": false,
+          "description": "次ページの取得に使うカーソル",
+          "source": "curation"
+        }
+      ],
+      "body": null,
+      "resultPath": "",
+      "risk": "read",
+      "aliases": []
+    },
+    {
+      "name": "heartbeat-runner",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.heartbeatRunner",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/runners/heartbeat",
+      "summary": "ランナーのハートビート",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": "",
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "list",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.index",
+      "method": "GET",
+      "path": "/v2/tasks/private/agent-loop",
+      "summary": "アイテム一覧を取得",
+      "pathParams": [],
+      "queryParams": [
+        {
+          "name": "status",
+          "type": "string",
+          "required": false,
+          "source": "spec"
+        },
+        {
+          "name": "cursor",
+          "type": "string",
+          "required": false,
+          "description": "次ページの取得に使うカーソル",
+          "source": "curation"
+        },
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "1ページあたりの件数",
+          "source": "curation"
+        }
+      ],
+      "body": null,
+      "resultPath": "",
+      "risk": "read",
+      "aliases": []
+    },
+    {
+      "name": "reclaim",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.reclaim",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/reclaim",
+      "summary": "死んだランナーが握ったままのアイテムを回収",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": "",
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "record-schedule-outcome",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.recordScheduleOutcome",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/schedules/{scheduleId}/record",
+      "summary": "実行結果を書き戻す",
+      "pathParams": [
+        {
+          "name": "scheduleId",
+          "type": "string",
+          "required": true,
+          "source": "spec"
+        }
+      ],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "record-schedule-outcome-by-item",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.recordScheduleOutcomeByItem",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/schedules/record",
+      "summary": "`item_id` だけで枠を解決して結果を書き戻す",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "register-runner",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.registerRunner",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/runners/register",
+      "summary": "ランナーを登録（起動時）",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": "",
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "release-plan-lock",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.releasePlanLock",
+      "method": "DELETE",
+      "path": "/v2/tasks/private/agent-loop/plan/lock",
+      "summary": "計画ロックを手動で解除",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "destructive",
+      "aliases": []
+    },
+    {
+      "name": "release-schedule-window",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.releaseScheduleWindow",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/schedules/{scheduleId}/release",
+      "summary": "孤立した枠を `failed` で終端する（救済経路）",
+      "pathParams": [
+        {
+          "name": "scheduleId",
+          "type": "string",
+          "required": true,
+          "source": "spec"
+        }
+      ],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "reorder",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.reorder",
+      "method": "PUT",
+      "path": "/v2/tasks/private/agent-loop/reorder",
+      "summary": "アイテムの並び替え",
+      "pathParams": [],
+      "queryParams": [],
+      "body": {
+        "schema": {
+          "type": "object",
+          "properties": {
+            "item_ids": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "format": "uuid"
+              },
+              "minItems": 1,
+              "uniqueItems": true
+            }
+          },
+          "required": [
+            "item_ids"
+          ]
+        }
+      },
+      "resultPath": "",
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "runners",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.runners",
+      "method": "GET",
+      "path": "/v2/tasks/private/agent-loop/runners",
+      "summary": "ランナー一覧を取得",
+      "pathParams": [],
+      "queryParams": [
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "1ページあたりの件数",
+          "source": "curation"
+        },
+        {
+          "name": "cursor",
+          "type": "string",
+          "required": false,
+          "description": "次ページの取得に使うカーソル",
+          "source": "curation"
+        }
+      ],
+      "body": null,
+      "resultPath": "",
+      "risk": "read",
+      "aliases": []
+    },
+    {
+      "name": "schedule-definitions",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.scheduleDefinitions",
+      "method": "GET",
+      "path": "/v2/tasks/private/agent-loop/schedules/definitions",
+      "summary": "定義一覧＋グローバル設定を取得",
+      "pathParams": [],
+      "queryParams": [
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "1ページあたりの件数",
+          "source": "curation"
+        },
+        {
+          "name": "cursor",
+          "type": "string",
+          "required": false,
+          "description": "次ページの取得に使うカーソル",
+          "source": "curation"
+        }
+      ],
+      "body": null,
+      "resultPath": "",
+      "risk": "read",
+      "aliases": []
+    },
+    {
+      "name": "schedule-history",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.scheduleHistory",
+      "method": "GET",
+      "path": "/v2/tasks/private/agent-loop/schedules/history",
+      "summary": "履歴を取得する",
+      "pathParams": [],
+      "queryParams": [
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "1ページあたりの件数",
+          "source": "curation"
+        },
+        {
+          "name": "cursor",
+          "type": "string",
+          "required": false,
+          "description": "次ページの取得に使うカーソル",
+          "source": "curation"
+        }
+      ],
+      "body": null,
+      "resultPath": null,
+      "risk": "read",
+      "aliases": []
+    },
+    {
+      "name": "start-plan",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.startPlan",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/plan/start",
+      "summary": "計画ロックを獲得",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "state",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.state",
+      "method": "GET",
+      "path": "/v2/tasks/private/agent-loop/state",
+      "summary": "ループ全体の状態を取得",
+      "pathParams": [],
+      "queryParams": [
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "1ページあたりの件数",
+          "source": "curation"
+        },
+        {
+          "name": "cursor",
+          "type": "string",
+          "required": false,
+          "description": "次ページの取得に使うカーソル",
+          "source": "curation"
+        }
+      ],
+      "body": null,
+      "resultPath": "",
+      "risk": "read",
+      "aliases": []
+    },
+    {
+      "name": "store-schedule-definition",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.storeScheduleDefinition",
+      "method": "POST",
+      "path": "/v2/tasks/private/agent-loop/schedules/definitions",
+      "summary": "定義を追加",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "update",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.update",
+      "method": "PUT",
+      "path": "/v2/tasks/private/agent-loop/{itemId}",
+      "summary": "アイテムを更新",
+      "pathParams": [
+        {
+          "name": "itemId",
+          "type": "string",
+          "required": true,
+          "source": "spec"
+        }
+      ],
+      "queryParams": [],
+      "body": {
+        "schema": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "type": "string",
+              "maxLength": 255
+            },
+            "prompt": {
+              "type": "string"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "pending",
+                "processing",
+                "completed",
+                "failed"
+              ]
+            },
+            "ai_type": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "enum": [
+                "claude",
+                "gemini",
+                "codex",
+                "copilot",
+                null
+              ]
+            },
+            "ai_model": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 100
+            },
+            "ai_effort": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "enum": [
+                "low",
+                "medium",
+                "high",
+                "xhigh",
+                "max",
+                null
+              ]
+            },
+            "task_key": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 50
+            },
+            "result": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 102400
+            },
+            "error_message": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 10240
+            },
+            "started_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "completed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "run_id": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 255
+            },
+            "duration_ms": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "minimum": 0
+            },
+            "turns": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "minimum": 0
+            },
+            "tokens_in": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "minimum": 0
+            },
+            "tokens_out": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "minimum": 0
+            },
+            "cost_usd": {
+              "type": [
+                "number",
+                "null"
+              ],
+              "minimum": 0
+            },
+            "skill": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 100
+            },
+            "effort": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "enum": [
+                "low",
+                "medium",
+                "high",
+                "xhigh",
+                "max",
+                null
+              ]
+            },
+            "exit_reason": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "enum": [
+                "ok",
+                "timeout",
+                "rate_limited",
+                "interrupted",
+                "error",
+                null
+              ]
+            },
+            "outcome_code": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "maxLength": 200
+            },
+            "log_s3_key": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "pattern": "#^tenants/[A-Za-z0-9_-]+/agent-loop-logs/[A-Za-z0-9_:-]+/\\d{4}/\\d{2}/\\d{2}/[A-Za-z0-9_-]+\\.log$#D",
+              "maxLength": 512
+            }
+          }
+        }
+      },
+      "resultPath": "",
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "update-schedule-config",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.updateScheduleConfig",
+      "method": "PUT",
+      "path": "/v2/tasks/private/agent-loop/schedules/config",
+      "summary": "グローバル設定（`max_per_cycle` / `gates`）を更新",
+      "pathParams": [],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    },
+    {
+      "name": "update-schedule-definition",
+      "domain": "private-agent-loop",
+      "operationId": "privateAgentLoop.updateScheduleDefinition",
+      "method": "PUT",
+      "path": "/v2/tasks/private/agent-loop/schedules/definitions/{scheduleId}",
+      "summary": "定義を更新（`revision` の楽観ロック）",
+      "pathParams": [
+        {
+          "name": "scheduleId",
+          "type": "string",
+          "required": true,
+          "source": "spec"
+        }
+      ],
+      "queryParams": [],
+      "body": null,
+      "resultPath": null,
+      "risk": "write",
+      "aliases": []
+    }
+  ]
+}