@kindgi/api 0.1.4-rc.0 → 0.1.4-rc.1

package/openapi.json

@@ -347,6 +347,9 @@
             "type": "string",
             "description": "Set on a replay run: the eval run that started it."
           },
+          "versions": {
+            "$ref": "#/components/schemas/FlowVersionOverrides"
+          },
           "publicAccessToken": {
             "type": "string",
             "description": "Only in the response to `POST /v1/runs`, when the deployment issues public run tokens: a read-only token for this run (and its descendants) to hand to a browser, for `GET /v1/runs/{runId}/progress` and its stream."
@@ -571,6 +574,9 @@
                   "type": "string",
                   "description": "Set on a replay run: the eval run that started it."
                 },
+                "versions": {
+                  "$ref": "#/components/schemas/FlowVersionOverrides"
+                },
                 "publicAccessToken": {
                   "type": "string",
                   "description": "Only in the response to `POST /v1/runs`, when the deployment issues public run tokens: a read-only token for this run (and its descendants) to hand to a browser, for `GET /v1/runs/{runId}/progress` and its stream."
@@ -3235,6 +3241,27 @@
           }
         }
       },
+      "FlowVersionOverrides": {
+        "description": "Agents and tools a flow runs at other exact versions than the flow version's pins (\"this flow, with `acme.scorer` at 0.4.0\"), without publishing a new flow version: a comparison's flow candidate (`versions` on the start body and the run's `comparison`), and the flow runs that replay it (a run's `versions`). Each id must be an agent or tool the flow uses.",
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "tools": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Tool id → exact version."
+          },
+          "agents": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Agent id → exact version, for agent nodes with or without a version of their own."
+          }
+        }
+      },
       "PublishAgentBody": {
         "description": "Full `defineAgent` spec. Validated server-side via `@kindgi/agents.defineAgent` — validation failures return `400 validation-failed` with the issue list under `details.issues`.",
         "type": "object",
@@ -8635,6 +8662,658 @@
             "type": "integer",
             "minimum": 1,
             "maximum": 100
+          },
+          "versions": {
+            "$ref": "#/components/schemas/FlowVersionOverrides"
+          }
+        }
+      },
+      "ComparisonMetric": {
+        "description": "One metric, the recorded runs beside the candidate. `null` where a side had no judged evidence; `n` / `weight` are the candidate's evidence (cases with judged items, and the judgment weight behind them), `baselineN` / `baselineWeight` the recorded side's.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "baseline",
+          "candidate",
+          "delta",
+          "n",
+          "weight",
+          "baselineN",
+          "baselineWeight",
+          "direction"
+        ],
+        "properties": {
+          "baseline": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "candidate": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "delta": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "n": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "weight": {
+            "type": "number",
+            "minimum": 0
+          },
+          "baselineN": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "baselineWeight": {
+            "type": "number",
+            "minimum": 0
+          },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "higher"
+            ]
+          },
+          "k": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "`weightedPrecisionAtK`: the ranked items it looked at."
+          },
+          "spread": {
+            "type": "number",
+            "description": "With more than one repetition: the candidate's max − min across them."
+          }
+        }
+      },
+      "ComparisonCandidate": {
+        "description": "What ran on the cases: an agent version, or a flow version (with any versions it swapped in).",
+        "oneOf": [
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "kind",
+              "agentId",
+              "version"
+            ],
+            "properties": {
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "agent"
+                ]
+              },
+              "agentId": {
+                "type": "string"
+              },
+              "version": {
+                "type": "string"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "kind",
+              "flowId",
+              "version"
+            ],
+            "properties": {
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "flow"
+                ]
+              },
+              "flowId": {
+                "type": "string"
+              },
+              "version": {
+                "type": "string"
+              },
+              "versions": {
+                "$ref": "#/components/schemas/FlowVersionOverrides"
+              }
+            }
+          }
+        ]
+      },
+      "JudgedComparisonSummary": {
+        "description": "What a comparison concluded: the candidate beside the recorded runs, the case counts, and the metrics. What a promotion gate reads.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "evalRunId",
+          "status",
+          "completedAt",
+          "suite",
+          "candidate",
+          "baseline",
+          "scope",
+          "cases",
+          "diverged",
+          "refusedWrites",
+          "errors",
+          "stopped",
+          "reads",
+          "sampling",
+          "repetitions",
+          "metrics"
+        ],
+        "properties": {
+          "evalRunId": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "completed",
+              "partial",
+              "failed"
+            ]
+          },
+          "completedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "suite": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "version"
+            ],
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "version": {
+                "type": "string"
+              }
+            }
+          },
+          "candidate": {
+            "$ref": "#/components/schemas/ComparisonCandidate"
+          },
+          "baseline": {
+            "description": "What the candidate was compared with: `recorded` (the test set's recorded runs, with the versions that served them), or another version.",
+            "oneOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "kind",
+                  "versions"
+                ],
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "recorded"
+                    ]
+                  },
+                  "versions": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": false,
+                      "required": [
+                        "version",
+                        "cases"
+                      ],
+                      "properties": {
+                        "agentId": {
+                          "type": "string"
+                        },
+                        "flowId": {
+                          "type": "string"
+                        },
+                        "version": {
+                          "type": "string"
+                        },
+                        "cases": {
+                          "type": "integer",
+                          "minimum": 0
+                        }
+                      }
+                    }
+                  }
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "kind",
+                  "agentId",
+                  "version",
+                  "via"
+                ],
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "version"
+                    ]
+                  },
+                  "agentId": {
+                    "type": "string"
+                  },
+                  "version": {
+                    "type": "string"
+                  },
+                  "via": {
+                    "type": "string",
+                    "enum": [
+                      "explicit",
+                      "live"
+                    ]
+                  },
+                  "liveScope": {
+                    "type": "object",
+                    "additionalProperties": true
+                  }
+                }
+              }
+            ]
+          },
+          "scope": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Where the test set's judgments came from.",
+            "properties": {
+              "projectId": {
+                "type": "string"
+              }
+            }
+          },
+          "cases": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "diverged": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Cases where a read with no recording ran live under `reads: 'recorded'`."
+          },
+          "refusedWrites": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Tool calls refused across the cases (what the candidate would have done)."
+          },
+          "errors": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Cases none of whose repetitions ran."
+          },
+          "stopped": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Flow cases that stopped at a write the replay refused: no output to score, so they're left out of the metrics."
+          },
+          "reads": {
+            "type": "string",
+            "enum": [
+              "recorded",
+              "live"
+            ]
+          },
+          "sampling": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "models"
+            ],
+            "properties": {
+              "models": {
+                "type": "array",
+                "description": "The models that answered the candidate's replays, and how many replays each.",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "providerId",
+                    "model",
+                    "runs"
+                  ],
+                  "properties": {
+                    "providerId": {
+                      "type": "string"
+                    },
+                    "model": {
+                      "type": "string"
+                    },
+                    "runs": {
+                      "type": "integer",
+                      "minimum": 0
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "repetitions": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "metrics": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "weightedYesShare",
+              "judgedCoverage",
+              "weightedPrecisionAtK"
+            ],
+            "properties": {
+              "weightedYesShare": {
+                "$ref": "#/components/schemas/ComparisonMetric"
+              },
+              "judgedCoverage": {
+                "$ref": "#/components/schemas/ComparisonMetric"
+              },
+              "weightedPrecisionAtK": {
+                "$ref": "#/components/schemas/ComparisonMetric"
+              }
+            }
+          }
+        }
+      },
+      "ComparisonCaseResult": {
+        "description": "One case of a comparison: its replay runs, the scores, the items kept, dropped and new, the tool calls, and why it didn't run when it didn't.",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "caseId",
+          "runIds",
+          "baseline",
+          "candidate",
+          "diverged",
+          "refusedWrites",
+          "noContext",
+          "approvalSkipped"
+        ],
+        "properties": {
+          "caseId": {
+            "type": "string"
+          },
+          "runIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The candidate's replay runs, one per repetition."
+          },
+          "baseline": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "yesWeight",
+              "totalWeight",
+              "items",
+              "judgedItems",
+              "topK"
+            ],
+            "description": "An output's score: Σ yesWeight and Σ totalWeight over its judged items, and over those among the first `k` ranked items.",
+            "properties": {
+              "yesWeight": {
+                "type": "number"
+              },
+              "totalWeight": {
+                "type": "number"
+              },
+              "items": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "judgedItems": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "topK": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "yesWeight",
+                  "totalWeight"
+                ],
+                "properties": {
+                  "yesWeight": {
+                    "type": "number"
+                  },
+                  "totalWeight": {
+                    "type": "number"
+                  }
+                }
+              }
+            }
+          },
+          "candidate": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "yesWeight",
+                "totalWeight",
+                "items",
+                "judgedItems",
+                "topK"
+              ],
+              "description": "An output's score: Σ yesWeight and Σ totalWeight over its judged items, and over those among the first `k` ranked items.",
+              "properties": {
+                "yesWeight": {
+                  "type": "number"
+                },
+                "totalWeight": {
+                  "type": "number"
+                },
+                "items": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "judgedItems": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "topK": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "yesWeight",
+                    "totalWeight"
+                  ],
+                  "properties": {
+                    "yesWeight": {
+                      "type": "number"
+                    },
+                    "totalWeight": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            },
+            "description": "One per repetition that ran."
+          },
+          "changes": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "kept",
+              "dropped",
+              "new"
+            ],
+            "description": "The first repetition's items against the judged ones.",
+            "properties": {
+              "kept": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "key"
+                  ],
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "rankBefore": {
+                      "type": "integer"
+                    },
+                    "rank": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              },
+              "dropped": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "key"
+                  ],
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "rankBefore": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              },
+              "new": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "key",
+                    "pointer"
+                  ],
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "pointer": {
+                      "type": "string"
+                    },
+                    "rank": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "tools": {
+            "type": "array",
+            "description": "The first repetition's tool calls, and what happened to each.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "step",
+                "callId",
+                "toolId",
+                "toolVersion",
+                "arguments",
+                "source"
+              ],
+              "properties": {
+                "step": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "callId": {
+                  "type": "string"
+                },
+                "toolId": {
+                  "type": "string"
+                },
+                "toolVersion": {
+                  "type": "string"
+                },
+                "arguments": {},
+                "source": {
+                  "type": "string",
+                  "enum": [
+                    "live",
+                    "recorded",
+                    "refused"
+                  ]
+                },
+                "reason": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "diverged": {
+            "type": "boolean"
+          },
+          "refusedWrites": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "noContext": {
+            "type": "boolean"
+          },
+          "approvalSkipped": {
+            "type": "boolean"
+          },
+          "error": {
+            "type": "string"
+          },
+          "stopped": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "toolId",
+              "arguments"
+            ],
+            "description": "Set when the replay stopped at a refused write: what it would have done.",
+            "properties": {
+              "toolId": {
+                "type": "string"
+              },
+              "arguments": {},
+              "reason": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      },
+      "JudgedComparisonResult": {
+        "description": "A comparison's `result` (a `judged` eval run's): the summary and each case. `EvalRun.result` stays an open object, since each kind has its own; the clients read it as this (TS `comparisonOf(run)`, Python `comparison_of(run)`).",
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "summary",
+          "perCase"
+        ],
+        "properties": {
+          "summary": {
+            "$ref": "#/components/schemas/JudgedComparisonSummary"
+          },
+          "perCase": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ComparisonCaseResult"
+            }
           }
         }
       },
@@ -8700,7 +9379,7 @@
           "result": {
             "type": "object",
             "additionalProperties": true,
-            "description": "Kind-specific opaque JSON. For `accuracy`, contains `{ passCount, totalCount, meanScore, perCase[] }`. For `judged` (a comparison), `{ summary, perCase[] }`: the summary has the baseline (the versions behind the recorded runs) and the candidate (`{ kind: \"agent\", agentId, version }` or `{ kind: \"flow\", flowId, version }`), the case counts (`cases`, `diverged`, `refusedWrites`, `errors`, and `stopped`: flow cases that stopped at a write the replay refused, left out of the metrics), the models that answered, and `metrics` (`weightedYesShare`, `judgedCoverage`, `weightedPrecisionAtK`, each `{ baseline, candidate, delta, n, weight, baselineN, baselineWeight, direction, k?, spread? }`); each case has its replay runs, the scores, the items kept, dropped and new, the tool calls with what happened to each, and `stopped` (what it would have done) when it stopped. Other kinds define their own shapes as their dispatchers ship."
+            "description": "Kind-specific opaque JSON. For `accuracy`, contains `{ passCount, totalCount, meanScore, perCase[] }`. For `judged` (a comparison), `{ summary, perCase[] }`: the summary has the baseline (the versions behind the recorded runs) and the candidate (`{ kind: \"agent\", agentId, version }` or `{ kind: \"flow\", flowId, version, versions? }`), the case counts (`cases`, `diverged`, `refusedWrites`, `errors`, and `stopped`: flow cases that stopped at a write the replay refused, left out of the metrics), the models that answered, and `metrics` (`weightedYesShare`, `judgedCoverage`, `weightedPrecisionAtK`, each `{ baseline, candidate, delta, n, weight, baselineN, baselineWeight, direction, k?, spread? }`); each case has its replay runs, the scores, the items kept, dropped and new, the tool calls with what happened to each, and `stopped` (what it would have done) when it stopped. Other kinds define their own shapes as their dispatchers ship."
           },
           "error": {
             "type": "string"
@@ -8778,9 +9457,12 @@
             "type": "integer",
             "minimum": 1,
             "maximum": 100
+          },
+          "versions": {
+            "$ref": "#/components/schemas/FlowVersionOverrides"
           }
         },
-        "description": "Exactly one of `agentRef` or `flowRef` MUST be supplied. `dryRun: true` returns a plan preview without invoking the subject. For a `judged` suite (a test set), the run is a comparison: `agentRef` or `flowRef` with its `version` is the candidate, replayed on each case without doing anything the past run didn't (a flow stops at a write the replay refuses); `baseline` (default `'recorded'`), `reads` (default `recorded`), `repetitions` (default 1) and `k` (default 10) set how."
+        "description": "Exactly one of `agentRef` or `flowRef` MUST be supplied. `dryRun: true` returns a plan preview without invoking the subject. For a `judged` suite (a test set), the run is a comparison: `agentRef` or `flowRef` with its `version` is the candidate, replayed on each case without doing anything the past run didn't (a flow stops at a write the replay refuses); `baseline` (default `'recorded'`), `reads` (default `recorded`), `repetitions` (default 1) and `k` (default 10) set how. With `flowRef`, `versions` runs the flow with some of its agents or tools at other versions; an id the flow doesn't use, or a version that isn't published, is refused (`400 validation-failed`, each under `details.issues`)."
       },
       "StartEvalRunResult": {
         "type": "object",
@@ -15397,7 +16079,7 @@
             }
           },
           "409": {
-            "description": "Agent already registered at that (id, version).",
+            "description": "Agent already registered at that (id, version). Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -15589,6 +16271,16 @@
           "agents"
         ],
         "responses": {
+          "200": {
+            "description": "An active version already holds this definition and these pins (the same swap derived before, or a deploy that registered it): that version, unchanged.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Agent"
+                }
+              }
+            }
+          },
           "201": {
             "description": "The derived agent version.",
             "content": {
@@ -15630,7 +16322,7 @@
             }
           },
           "409": {
-            "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
+            "description": "Idempotency-Key was reused with a different body, or resource-state conflict. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -15804,7 +16496,7 @@
             }
           },
           "409": {
-            "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
+            "description": "Idempotency-Key was reused with a different body, or resource-state conflict. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -15910,7 +16602,7 @@
             }
           },
           "409": {
-            "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
+            "description": "Idempotency-Key was reused with a different body, or resource-state conflict. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -16113,7 +16805,7 @@
             }
           },
           "409": {
-            "description": "Flow already registered at that (id, version).",
+            "description": "Flow already registered at that (id, version). Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -16414,7 +17106,7 @@
             }
           },
           "409": {
-            "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
+            "description": "Idempotency-Key was reused with a different body, or resource-state conflict. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -16520,7 +17212,7 @@
             }
           },
           "409": {
-            "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
+            "description": "Idempotency-Key was reused with a different body, or resource-state conflict. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -16723,7 +17415,7 @@
             }
           },
           "409": {
-            "description": "Tool already registered at that id.",
+            "description": "Tool already registered at that id. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -17045,7 +17737,7 @@
             }
           },
           "409": {
-            "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
+            "description": "Idempotency-Key was reused with a different body, or resource-state conflict. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -17151,7 +17843,7 @@
             }
           },
           "409": {
-            "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
+            "description": "Idempotency-Key was reused with a different body, or resource-state conflict. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -17354,7 +18046,7 @@
             }
           },
           "409": {
-            "description": "Guardrail already registered at that id.",
+            "description": "Guardrail already registered at that id. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -17510,7 +18202,7 @@
             }
           },
           "409": {
-            "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
+            "description": "Idempotency-Key was reused with a different body, or resource-state conflict. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -26576,7 +27268,7 @@
             }
           },
           "409": {
-            "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
+            "description": "Idempotency-Key was reused with a different body, or resource-state conflict. Or `registry-read-only`: this registry takes no writes (under `kindgi dev`, the pack's files are the source); the message says what to do instead.",
             "content": {
               "application/json": {
                 "schema": {
@@ -27902,6 +28594,16 @@
               }
             }
           },
+          "404": {
+            "description": "org-not-found: `orgId` names no org of the tenant (it never existed, or it was deleted).",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/WireError"
+                }
+              }
+            }
+          },
           "409": {
             "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
             "content": {
@@ -28039,7 +28741,7 @@
             }
           },
           "404": {
-            "description": "No team with that id under this tenant.",
+            "description": "team-not-found: no team with that id under this tenant; or org-not-found: `orgId` names no org of the tenant (it never existed, or it was deleted).",
             "content": {
               "application/json": {
                 "schema": {
@@ -28677,6 +29379,16 @@
               }
             }
           },
+          "404": {
+            "description": "org-not-found: `orgId` names no org of the tenant (it never existed, or it was deleted).",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/WireError"
+                }
+              }
+            }
+          },
           "409": {
             "description": "Idempotency-Key was reused with a different body, or resource-state conflict.",
             "content": {
@@ -28815,7 +29527,7 @@
             }
           },
           "404": {
-            "description": "No project with that id under this tenant.",
+            "description": "project-not-found: no project with that id under this tenant; or org-not-found: `orgId` names no org of the tenant (it never existed, or it was deleted).",
             "content": {
               "application/json": {
                 "schema": {