@greatwait/contracts 0.1.0-alpha.1 → 0.1.0-alpha.3

package/generated/v1/openapi.json

@@ -8968,6 +8968,269 @@
         ]
       }
     },
+    "/v1/context": {
+      "get": {
+        "description": "Reports the authority the presented credential carries: the project it acts in, which of that project's two environments, and the scopes the service will enforce for it. The answer comes entirely from the verified principal, so there is no parameter that could name another project and no way for the reply to describe anything but the caller itself. It requires a principal and no scope, because every value in it is a property of the credential being presented rather than of anything the credential may reach: a caller that could not read this could still act, and would simply be acting without being able to say where. A signed-in member is not accepted — a session's authority is an organization and it names its project per request, so there is no single answer to give one.",
+        "operationId": "context.read",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "example": {
+                  "environmentKind": "test",
+                  "principal": "api-credential",
+                  "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+                  "scopes": ["schedules:read", "schedules:write"]
+                },
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "environmentKind": {
+                      "type": "string",
+                      "enum": ["test", "live"]
+                    },
+                    "principal": {
+                      "type": "string",
+                      "enum": ["api-credential", "oauth"]
+                    },
+                    "project": {
+                      "type": "string",
+                      "pattern": "^proj_[0-9abcdefghjkmnpqrstvwxyz]{26}$"
+                    },
+                    "scopes": {
+                      "minItems": 1,
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "enum": [
+                          "credentials:administer",
+                          "credentials:read",
+                          "credentials:write",
+                          "endpoints:read",
+                          "endpoints:write",
+                          "forecast:read",
+                          "grants:read",
+                          "grants:write",
+                          "occurrences:read",
+                          "occurrences:redeliver",
+                          "projects:read",
+                          "projects:write",
+                          "schedules:read",
+                          "schedules:write",
+                          "usage:read"
+                        ]
+                      }
+                    }
+                  },
+                  "required": [
+                    "environmentKind",
+                    "principal",
+                    "project",
+                    "scopes"
+                  ]
+                }
+              }
+            },
+            "description": "Read this credential's authority"
+          },
+          "401": {
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "x-problem-codes": [
+                        "authentication_required",
+                        "credential_expired",
+                        "credential_revoked"
+                      ]
+                    },
+                    "detail": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pointer": {
+                            "type": "string",
+                            "pattern": "^\\/.*"
+                          },
+                          "reason": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": ["pointer", "reason"]
+                      }
+                    },
+                    "retryAfterSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "status": {
+                      "type": "integer",
+                      "minimum": 400,
+                      "maximum": 599
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "traceId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "type": {
+                      "type": "string",
+                      "const": "about:blank"
+                    }
+                  },
+                  "required": ["code", "status", "title", "type"]
+                }
+              }
+            },
+            "description": "Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked."
+          },
+          "429": {
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "x-problem-codes": ["rate_limited"]
+                    },
+                    "detail": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pointer": {
+                            "type": "string",
+                            "pattern": "^\\/.*"
+                          },
+                          "reason": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": ["pointer", "reason"]
+                      }
+                    },
+                    "retryAfterSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "status": {
+                      "type": "integer",
+                      "minimum": 400,
+                      "maximum": 599
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "traceId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "type": {
+                      "type": "string",
+                      "const": "about:blank"
+                    }
+                  },
+                  "required": ["code", "status", "title", "type"]
+                }
+              }
+            },
+            "description": "Problem document. Possible codes at this status: rate_limited."
+          },
+          "503": {
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "x-problem-codes": ["service_unavailable"]
+                    },
+                    "detail": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pointer": {
+                            "type": "string",
+                            "pattern": "^\\/.*"
+                          },
+                          "reason": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": ["pointer", "reason"]
+                      }
+                    },
+                    "retryAfterSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "status": {
+                      "type": "integer",
+                      "minimum": 400,
+                      "maximum": 599
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "traceId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "type": {
+                      "type": "string",
+                      "const": "about:blank"
+                    }
+                  },
+                  "required": ["code", "status", "title", "type"]
+                }
+              }
+            },
+            "description": "Problem document. Possible codes at this status: service_unavailable."
+          }
+        },
+        "summary": "Read this credential's authority",
+        "security": [
+          {
+            "apiCredential": []
+          }
+        ]
+      }
+    },
     "/v1/credentials": {
       "post": {
         "description": "Issues an API credential bound to one project and environment, with scopes capped by the issuing member's current role. The full secret is in this response and in no other, is not recoverable afterwards, and there is deliberately no reveal endpoint. The value is the sixteen-character display prefix followed immediately by thirty-two more characters; the example below is a visible placeholder rather than that shape, because a realistic credential in a committed file is one the repository's own secret scanner refuses.",
@@ -10005,6 +10268,432 @@
         ]
       }
     },
+    "/v1/credentials/{credentialId}/connection": {
+      "get": {
+        "description": "Reads what a key this project issued should be able to do over MCP: the endpoint to point a client at, the discovery document beside it, the scopes fixed into the key when it was made, and the MCP tool names those scopes authorize. It returns no secret and cannot: the transient value is shown once at creation and is never sent here. The credential is addressed by identifier and re-resolved against the signed-in member's own project and environment, so a key belonging to another project answers exactly as one that does not exist. `state` distinguishes a key that still verifies from one that was revoked and one whose rotation overlap has run out, because a client configured with either fails identically and the remedies differ.",
+        "operationId": "credentials.connection",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "credentialId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "example": {
+                  "discovery": "https://api.greatwait.dev/.well-known/oauth-protected-resource/mcp",
+                  "displayPrefix": "pt_test_a1b2c3d4",
+                  "endpoint": "https://api.greatwait.dev/mcp",
+                  "id": "ak_01h8xyz9k2m4n6p8r0t2v4w6y8",
+                  "scopes": [
+                    "occurrences:read",
+                    "schedules:read",
+                    "schedules:write"
+                  ],
+                  "state": "usable",
+                  "tools": [
+                    "occurrences_list",
+                    "occurrences_read",
+                    "schedules_cancel",
+                    "schedules_create",
+                    "schedules_list",
+                    "schedules_read"
+                  ]
+                },
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "discovery": {
+                      "type": "string",
+                      "format": "uri"
+                    },
+                    "displayPrefix": {
+                      "type": "string",
+                      "pattern": "^pt_(?:live|test)_[0-9a-z]{8}$"
+                    },
+                    "endpoint": {
+                      "type": "string",
+                      "format": "uri"
+                    },
+                    "id": {
+                      "type": "string",
+                      "pattern": "^ak_[0-9abcdefghjkmnpqrstvwxyz]{26}$"
+                    },
+                    "scopes": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "enum": [
+                          "credentials:administer",
+                          "credentials:read",
+                          "credentials:write",
+                          "endpoints:read",
+                          "endpoints:write",
+                          "forecast:read",
+                          "grants:read",
+                          "grants:write",
+                          "occurrences:read",
+                          "occurrences:redeliver",
+                          "projects:read",
+                          "projects:write",
+                          "schedules:read",
+                          "schedules:write",
+                          "usage:read"
+                        ]
+                      }
+                    },
+                    "state": {
+                      "type": "string",
+                      "enum": ["usable", "revoked", "expired"]
+                    },
+                    "tools": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "discovery",
+                    "displayPrefix",
+                    "endpoint",
+                    "id",
+                    "scopes",
+                    "state",
+                    "tools"
+                  ]
+                }
+              }
+            },
+            "description": "Read a credential's MCP connection"
+          },
+          "401": {
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "x-problem-codes": [
+                        "authentication_required",
+                        "credential_expired",
+                        "credential_revoked"
+                      ]
+                    },
+                    "detail": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pointer": {
+                            "type": "string",
+                            "pattern": "^\\/.*"
+                          },
+                          "reason": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": ["pointer", "reason"]
+                      }
+                    },
+                    "retryAfterSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "status": {
+                      "type": "integer",
+                      "minimum": 400,
+                      "maximum": 599
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "traceId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "type": {
+                      "type": "string",
+                      "const": "about:blank"
+                    }
+                  },
+                  "required": ["code", "status", "title", "type"]
+                }
+              }
+            },
+            "description": "Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked."
+          },
+          "403": {
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "x-problem-codes": ["scope_missing"]
+                    },
+                    "detail": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pointer": {
+                            "type": "string",
+                            "pattern": "^\\/.*"
+                          },
+                          "reason": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": ["pointer", "reason"]
+                      }
+                    },
+                    "retryAfterSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "status": {
+                      "type": "integer",
+                      "minimum": 400,
+                      "maximum": 599
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "traceId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "type": {
+                      "type": "string",
+                      "const": "about:blank"
+                    }
+                  },
+                  "required": ["code", "status", "title", "type"]
+                }
+              }
+            },
+            "description": "Problem document. Possible codes at this status: scope_missing."
+          },
+          "404": {
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "x-problem-codes": ["not_found"]
+                    },
+                    "detail": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pointer": {
+                            "type": "string",
+                            "pattern": "^\\/.*"
+                          },
+                          "reason": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": ["pointer", "reason"]
+                      }
+                    },
+                    "retryAfterSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "status": {
+                      "type": "integer",
+                      "minimum": 400,
+                      "maximum": 599
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "traceId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "type": {
+                      "type": "string",
+                      "const": "about:blank"
+                    }
+                  },
+                  "required": ["code", "status", "title", "type"]
+                }
+              }
+            },
+            "description": "Problem document. Possible codes at this status: not_found."
+          },
+          "429": {
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "x-problem-codes": ["rate_limited"]
+                    },
+                    "detail": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pointer": {
+                            "type": "string",
+                            "pattern": "^\\/.*"
+                          },
+                          "reason": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": ["pointer", "reason"]
+                      }
+                    },
+                    "retryAfterSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "status": {
+                      "type": "integer",
+                      "minimum": 400,
+                      "maximum": 599
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "traceId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "type": {
+                      "type": "string",
+                      "const": "about:blank"
+                    }
+                  },
+                  "required": ["code", "status", "title", "type"]
+                }
+              }
+            },
+            "description": "Problem document. Possible codes at this status: rate_limited."
+          },
+          "503": {
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$schema": "https://json-schema.org/draft/2020-12/schema",
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "x-problem-codes": ["service_unavailable"]
+                    },
+                    "detail": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "pointer": {
+                            "type": "string",
+                            "pattern": "^\\/.*"
+                          },
+                          "reason": {
+                            "type": "string",
+                            "minLength": 1
+                          }
+                        },
+                        "required": ["pointer", "reason"]
+                      }
+                    },
+                    "retryAfterSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "status": {
+                      "type": "integer",
+                      "minimum": 400,
+                      "maximum": 599
+                    },
+                    "title": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "traceId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "type": {
+                      "type": "string",
+                      "const": "about:blank"
+                    }
+                  },
+                  "required": ["code", "status", "title", "type"]
+                }
+              }
+            },
+            "description": "Problem document. Possible codes at this status: service_unavailable."
+          }
+        },
+        "summary": "Read a credential's MCP connection",
+        "security": [
+          {
+            "memberSession": ["credentials:read"],
+            "memberSessionEnvironment": [],
+            "memberSessionProject": []
+          }
+        ]
+      }
+    },
     "/v1/projects": {
       "get": {
         "description": "Lists the projects in the signed-in member's organization that they may act in, with the environment kinds each one has. This is what a browser asks before it can address anything else: an API credential and an OAuth token each carry one project intrinsically, but a member belongs to an organization and chooses. Archived and deleted projects are omitted, because a member cannot act in one. The result is a display aid rather than an authorization control — naming a project on a later request re-resolves it against the member's own organization, and a project that is not theirs answers exactly as one that does not exist.",
@@ -23555,7 +24244,7 @@
         "maxHoldMs": 45000,
         "maxRetainedDeliveries": 50,
         "maxSinksPerEnvironment": 10,
-        "maxRequestBodyBytes": 65536,
+        "maxRequestBodyBytes": 69632,
         "maxRetainedBodyBytes": 4096
       },
       "clientErrorStatuses": [400, 401, 403, 404, 409, 410, 422],