BellD / DevelopersDocumentation · latest

Bridge API reference

Source: docs/04-api/bridge-api/openapi.yaml

Download OpenAPI 3.1 · Authentication, errors, pagination and versioning

Security

{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "securitySchemes": {
    "bearerAuth": {
      "type": "http",
      "scheme": "bearer",
      "bearerFormat": "JWT"
    }
  }
}

POST /v1/capabilities/{capability}/{action}

Invoke a capability as an OIDC service identity (CC-016 §3)

{
  "summary": "Invoke a capability as an OIDC service identity (CC-016 §3)",
  "parameters": [
    {
      "name": "capability",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "enum": [
          "ai.generate",
          "storage.object",
          "data.kv",
          "email.send"
        ]
      }
    },
    {
      "name": "action",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "enum": [
          "generate",
          "read",
          "write",
          "delete",
          "list",
          "get",
          "set",
          "increment",
          "send"
        ]
      }
    },
    {
      "name": "X-Correlation-Id",
      "in": "header",
      "required": false,
      "schema": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64
      }
    },
    {
      "name": "Idempotency-Key",
      "in": "header",
      "required": false,
      "schema": {
        "type": "string",
        "minLength": 1,
        "maxLength": 256
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/BridgeRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Capability output",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/BridgeOutput"
          }
        }
      }
    },
    "400": {
      "description": "Bad request",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/Problem"
          }
        }
      }
    },
    "401": {
      "description": "Unauthenticated",
      "headers": {
        "WWW-Authenticate": {
          "schema": {
            "type": "string"
          }
        }
      },
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/Problem"
          }
        }
      }
    },
    "403": {
      "description": "Forbidden",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/Problem"
          }
        }
      }
    },
    "404": {
      "description": "Not found",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/Problem"
          }
        }
      }
    },
    "409": {
      "description": "Conflict",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/Problem"
          }
        }
      }
    },
    "422": {
      "description": "Validation failed",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/Problem"
          }
        }
      }
    },
    "429": {
      "description": "Rate or budget exhausted",
      "headers": {
        "Retry-After": {
          "schema": {
            "type": "string"
          }
        }
      },
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/Problem"
          }
        }
      }
    },
    "500": {
      "description": "Internal error",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/Problem"
          }
        }
      }
    },
    "503": {
      "description": "Unavailable",
      "content": {
        "application/problem+json": {
          "schema": {
            "$ref": "#/components/schemas/Problem"
          }
        }
      }
    }
  }
}

Components

securitySchemes

bearerAuth

{
  "type": "http",
  "scheme": "bearer",
  "bearerFormat": "JWT"
}

schemas

SourceFreezeAccepted

{
  "type": "object",
  "properties": {
    "source_freeze_id": {
      "type": "string",
      "pattern": "^frz_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "status": {
      "type": "string",
      "const": "pending"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "links": {
      "type": "object",
      "properties": {
        "self": {
          "type": "string"
        }
      },
      "required": [
        "self"
      ]
    }
  },
  "required": [
    "source_freeze_id",
    "status",
    "product_id",
    "links"
  ]
}

SourceFreeze

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "frozen",
        "rejected",
        "failed"
      ]
    },
    "product": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        "workspace_id": {
          "type": "string",
          "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        "type": {
          "type": "string",
          "const": "hosted-app"
        },
        "created_at": {
          "$ref": "#/$defs/__schema0"
        }
      },
      "required": [
        "id",
        "workspace_id",
        "type",
        "created_at"
      ]
    },
    "revision": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        "product_id": {
          "type": "string",
          "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        "input_type": {
          "type": "string",
          "const": "repository"
        },
        "created_at": {
          "$ref": "#/$defs/__schema0"
        }
      },
      "required": [
        "id",
        "product_id",
        "input_type",
        "created_at"
      ]
    },
    "snapshot": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string",
          "minLength": 1
        },
        "sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "uri",
        "sha256",
        "size_bytes"
      ]
    },
    "replayed": {
      "type": "boolean"
    },
    "rejection": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "size_limit",
                "file_count_limit",
                "depth_limit",
                "file_size_limit",
                "path_length",
                "traversal",
                "symlink_escape",
                "ref_not_found",
                "host_not_allowed",
                "private_source_unsupported",
                "fetch_timeout",
                "fetch_failed"
              ]
            },
            "detail": {
              "type": "object",
              "properties": {
                "actual": {
                  "type": "number"
                },
                "limit": {
                  "type": "number"
                }
              },
              "required": [
                "actual",
                "limit"
              ]
            }
          },
          "required": [
            "code"
          ]
        },
        {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "const": "credential_in_descriptor"
            },
            "detail": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string"
                }
              },
              "required": [
                "field"
              ]
            }
          },
          "required": [
            "code"
          ]
        }
      ]
    },
    "problem": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "status": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "detail": {
          "type": "string"
        },
        "instance": {
          "type": "string"
        },
        "code": {
          "type": "string",
          "enum": [
            "bad_request",
            "unauthenticated",
            "forbidden",
            "not_found",
            "conflict",
            "validation_failed",
            "rate_limited",
            "internal",
            "unavailable"
          ]
        },
        "correlation_id": {
          "type": "string",
          "pattern": "^evt_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        "reason": {
          "type": "string"
        },
        "errors": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "retryable": {
                "type": "boolean"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "path"
            ]
          }
        }
      },
      "required": [
        "type",
        "title",
        "status",
        "detail",
        "instance",
        "code",
        "correlation_id"
      ]
    }
  },
  "required": [
    "status"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

SourceIntakeProblem

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "detail": {
      "type": "string"
    },
    "instance": {
      "type": "string"
    },
    "code": {
      "type": "string",
      "enum": [
        "bad_request",
        "unauthenticated",
        "forbidden",
        "not_found",
        "conflict",
        "validation_failed",
        "rate_limited",
        "internal",
        "unavailable"
      ]
    },
    "correlation_id": {
      "type": "string",
      "pattern": "^evt_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "reason": {
      "type": "string"
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "retryable": {
            "type": "boolean"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "path"
        ]
      }
    }
  },
  "required": [
    "type",
    "title",
    "status",
    "detail",
    "instance",
    "code",
    "correlation_id"
  ]
}

ReleaseCreateRequest

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "version_id": {
      "type": "string",
      "pattern": "^ver_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "channel": {
      "type": "string",
      "const": "staged"
    },
    "audience": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "internal",
            "workspace",
            "custom"
          ]
        }
      },
      "required": [
        "kind"
      ]
    },
    "window": {
      "type": "object",
      "properties": {
        "starts_at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        "ends_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "starts_at",
        "ends_at"
      ]
    }
  },
  "required": [
    "product_id",
    "version_id",
    "channel",
    "audience",
    "window"
  ]
}

Release

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "version_id": {
      "type": "string",
      "pattern": "^ver_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "channel": {
      "type": "string",
      "enum": [
        "preview_internal",
        "staged",
        "production"
      ]
    },
    "audience": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "internal",
            "workspace",
            "custom"
          ]
        }
      },
      "required": [
        "kind"
      ]
    },
    "window": {
      "type": "object",
      "properties": {
        "starts_at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        "ends_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "starts_at",
        "ends_at"
      ]
    },
    "id": {
      "type": "string",
      "pattern": "^rel_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "status": {
      "type": "string",
      "enum": [
        "draft",
        "ready",
        "live",
        "retired",
        "blocked",
        "pending_approval"
      ]
    },
    "frozen_at": {
      "anyOf": [
        {
          "$ref": "#/$defs/__schema0"
        },
        {
          "type": "null"
        }
      ]
    },
    "reason_code": {
      "type": [
        "string",
        "null"
      ]
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    }
  },
  "required": [
    "product_id",
    "version_id",
    "channel",
    "audience",
    "window",
    "id",
    "workspace_id",
    "status",
    "frozen_at",
    "reason_code",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

ReleaseDeploymentRequest

{
  "type": "object",
  "properties": {
    "environment_type": {
      "default": "staging",
      "type": "string",
      "const": "staging"
    }
  }
}

ReleaseDeployment

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^dep_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "revision_id": {
      "type": "string",
      "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "pipeline_run_id": {
      "type": "string",
      "pattern": "^pipe_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "environment_id": {
      "type": "string",
      "pattern": "^env_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "environment_type": {
      "type": "string",
      "const": "staging"
    },
    "slot": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "planned",
        "applying",
        "active",
        "superseded",
        "blocked",
        "failed"
      ]
    },
    "reason_code": {
      "type": "string"
    },
    "required_isolation_profile": {
      "type": "string",
      "const": "isolated-vm"
    },
    "egress": {
      "type": "string",
      "const": "deny"
    },
    "isolation": {
      "type": "object",
      "properties": {
        "profile": {
          "type": "string",
          "const": "isolated-vm"
        },
        "enforced": {
          "type": "boolean"
        }
      },
      "required": [
        "profile",
        "enforced"
      ]
    },
    "health": {
      "type": "object",
      "properties": {
        "checked_at": {
          "$ref": "#/$defs/__schema0"
        },
        "attempts": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "latency_ms": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "checked_at",
        "attempts",
        "latency_ms"
      ]
    },
    "endpoint": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "address"
      ]
    },
    "superseded_deployment_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^dep_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "surface_id": {
      "type": "string",
      "pattern": "^srf_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "findings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "kind",
          "severity",
          "code",
          "message"
        ]
      }
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    },
    "source": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "release"
        },
        "release_id": {
          "type": "string",
          "pattern": "^rel_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        "version_id": {
          "type": "string",
          "pattern": "^ver_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        }
      },
      "required": [
        "kind",
        "release_id",
        "version_id"
      ]
    }
  },
  "required": [
    "id",
    "workspace_id",
    "product_id",
    "revision_id",
    "environment_type",
    "slot",
    "status",
    "required_isolation_profile",
    "egress",
    "findings",
    "created_at",
    "updated_at",
    "source"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

CapabilityContract

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "revision_id": {
      "type": "string",
      "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "capabilities": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "const": "ai.generate"
              },
              "required": {
                "$ref": "#/$defs/__schema0"
              },
              "actions": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "$ref": "#/$defs/__schema1"
                }
              },
              "scope": {
                "type": "object",
                "properties": {
                  "models": {
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "$ref": "#/$defs/__schema2"
                    }
                  },
                  "max_tokens_per_call": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "models",
                  "max_tokens_per_call"
                ]
              },
              "credential_owner": {
                "$ref": "#/$defs/__schema3"
              },
              "provider": {
                "$ref": "#/$defs/__schema4"
              }
            },
            "required": [
              "id",
              "required",
              "actions",
              "scope",
              "credential_owner",
              "provider"
            ]
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "const": "storage.object"
              },
              "required": {
                "$ref": "#/$defs/__schema0"
              },
              "actions": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "$ref": "#/$defs/__schema5"
                }
              },
              "scope": {
                "type": "object",
                "properties": {
                  "prefix": {
                    "type": "string",
                    "pattern": "^\\/(?!.*\\.\\.).*$"
                  },
                  "max_object_bytes": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "prefix",
                  "max_object_bytes"
                ]
              },
              "credential_owner": {
                "$ref": "#/$defs/__schema3"
              },
              "provider": {
                "$ref": "#/$defs/__schema4"
              }
            },
            "required": [
              "id",
              "required",
              "actions",
              "scope",
              "credential_owner",
              "provider"
            ]
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "const": "data.kv"
              },
              "required": {
                "$ref": "#/$defs/__schema0"
              },
              "actions": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "$ref": "#/$defs/__schema6"
                }
              },
              "scope": {
                "type": "object",
                "properties": {
                  "prefix": {
                    "type": "string",
                    "pattern": "^\\/(?!.*\\.\\.).*$"
                  },
                  "max_value_bytes": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 65536
                  },
                  "max_keys": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 100000
                  }
                },
                "required": [
                  "prefix",
                  "max_value_bytes",
                  "max_keys"
                ]
              },
              "credential_owner": {
                "type": "string",
                "const": "platform"
              },
              "provider": {
                "type": "object",
                "properties": {
                  "allow": {
                    "minItems": 1,
                    "maxItems": 1,
                    "type": "array",
                    "items": {
                      "$ref": "#/$defs/__schema7"
                    }
                  },
                  "prefer": {
                    "type": "string",
                    "const": "platform"
                  },
                  "fallback": {
                    "type": "string",
                    "const": "none"
                  }
                },
                "required": [
                  "allow",
                  "fallback"
                ]
              }
            },
            "required": [
              "id",
              "required",
              "actions",
              "scope",
              "credential_owner",
              "provider"
            ]
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "const": "email.send"
              },
              "required": {
                "$ref": "#/$defs/__schema0"
              },
              "actions": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "$ref": "#/$defs/__schema8"
                }
              },
              "scope": {
                "type": "object",
                "properties": {
                  "from_addresses": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "$ref": "#/$defs/__schema9"
                    }
                  },
                  "recipient_domains": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "$ref": "#/$defs/__schema10"
                    }
                  },
                  "max_recipients": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 50
                  },
                  "max_message_bytes": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 1048576
                  }
                },
                "required": [
                  "from_addresses",
                  "recipient_domains",
                  "max_recipients",
                  "max_message_bytes"
                ]
              },
              "credential_owner": {
                "$ref": "#/$defs/__schema3"
              },
              "provider": {
                "$ref": "#/$defs/__schema4"
              }
            },
            "required": [
              "id",
              "required",
              "actions",
              "scope",
              "credential_owner",
              "provider"
            ]
          }
        ]
      }
    },
    "contract_hash": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$"
    },
    "confirmed_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "id": {
      "type": "string",
      "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "created_at": {
      "$ref": "#/$defs/__schema11"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema11"
    }
  },
  "required": [
    "product_id",
    "revision_id",
    "workspace_id",
    "capabilities",
    "contract_hash",
    "confirmed_at",
    "id",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "boolean"
    },
    "__schema1": {
      "type": "string",
      "enum": [
        "generate"
      ]
    },
    "__schema2": {
      "type": "string",
      "enum": [
        "text",
        "embedding"
      ]
    },
    "__schema3": {
      "type": "string",
      "const": "workspace"
    },
    "__schema4": {
      "type": "object",
      "properties": {
        "allow": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "prefer": {
          "type": "string"
        },
        "fallback": {
          "type": "string",
          "enum": [
            "none",
            "listed"
          ]
        }
      },
      "required": [
        "allow",
        "fallback"
      ]
    },
    "__schema5": {
      "type": "string",
      "enum": [
        "read",
        "write",
        "delete",
        "list"
      ]
    },
    "__schema6": {
      "type": "string",
      "enum": [
        "get",
        "set",
        "delete",
        "list",
        "increment"
      ]
    },
    "__schema7": {
      "type": "string",
      "const": "platform"
    },
    "__schema8": {
      "type": "string",
      "enum": [
        "send"
      ]
    },
    "__schema9": {
      "type": "string",
      "maxLength": 254,
      "pattern": "^(?!.*[A-Z])(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"(?:[ !#-[\\]-~]|\\\\[ -~])*\")@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
    },
    "__schema10": {
      "type": "string",
      "maxLength": 253,
      "pattern": "^(?:\\*|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)$"
    },
    "__schema11": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

PlanRequest

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "enum": [
        "free",
        "team",
        "enterprise"
      ]
    }
  },
  "required": [
    "plan"
  ]
}

Plan

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "plan": {
      "type": "string",
      "enum": [
        "free",
        "team",
        "enterprise"
      ]
    },
    "entitlements": {
      "type": "object",
      "properties": {
        "ai_tokens": {
          "type": "boolean"
        },
        "runtime": {
          "type": "boolean"
        },
        "provider_call": {
          "type": "boolean"
        },
        "storage": {
          "type": "boolean"
        }
      },
      "required": [
        "ai_tokens",
        "runtime",
        "provider_call",
        "storage"
      ]
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "plan",
    "entitlements",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

BudgetRequest

{
  "type": "object",
  "properties": {
    "limit_units": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "limit_units"
  ]
}

Budget

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "usage_category": {
      "type": "string",
      "enum": [
        "ai_tokens",
        "runtime",
        "provider_call",
        "storage"
      ]
    },
    "month": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$"
    },
    "limit_units": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "used_units": {
      "type": "number",
      "minimum": 0
    },
    "reserved_units": {
      "type": "number",
      "minimum": 0
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "usage_category",
    "month",
    "limit_units",
    "used_units",
    "reserved_units",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

Budgets

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "workspace_id": {
            "type": "string",
            "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
          },
          "usage_category": {
            "type": "string",
            "enum": [
              "ai_tokens",
              "runtime",
              "provider_call",
              "storage"
            ]
          },
          "month": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}$"
          },
          "limit_units": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ]
          },
          "used_units": {
            "type": "number",
            "minimum": 0
          },
          "reserved_units": {
            "type": "number",
            "minimum": 0
          },
          "created_at": {
            "$ref": "#/$defs/__schema0"
          },
          "updated_at": {
            "$ref": "#/$defs/__schema0"
          }
        },
        "required": [
          "id",
          "workspace_id",
          "usage_category",
          "month",
          "limit_units",
          "used_units",
          "reserved_units",
          "created_at",
          "updated_at"
        ]
      }
    },
    "next_cursor": {
      "type": "null"
    }
  },
  "required": [
    "items",
    "next_cursor"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

Health

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "ok",
        "ready"
      ]
    }
  },
  "required": [
    "status"
  ]
}

ProductIntakeRequest

{
  "type": "object",
  "properties": {
    "repo_url": {
      "type": "string",
      "minLength": 1
    },
    "ref": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "auth": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "none"
            }
          },
          "required": [
            "kind"
          ]
        }
      ]
    },
    "product_type": {
      "type": "string",
      "const": "hosted-app"
    },
    "input_type": {
      "type": "string",
      "const": "repository"
    }
  },
  "required": [
    "repo_url",
    "ref",
    "auth"
  ]
}

DescriptorConfirmationRequest

{
  "type": "object",
  "properties": {
    "edits": {
      "type": "object",
      "properties": {
        "build_plan": {
          "type": "object",
          "properties": {
            "install": {
              "type": "object",
              "properties": {
                "command": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "command"
              ],
              "additionalProperties": false
            },
            "build": {
              "type": "object",
              "properties": {
                "command": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "command"
              ],
              "additionalProperties": false
            },
            "start": {
              "type": "object",
              "properties": {
                "command": {
                  "type": "string"
                }
              },
              "required": [
                "command"
              ],
              "additionalProperties": false
            },
            "health": {
              "type": "object",
              "properties": {
                "path": {
                  "type": "string",
                  "pattern": "^\\/.*"
                }
              },
              "required": [
                "path"
              ],
              "additionalProperties": false
            }
          },
          "additionalProperties": false
        },
        "runtime": {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "node"
            },
            "version": {
              "type": "string",
              "minLength": 1
            }
          },
          "required": [
            "kind",
            "version"
          ]
        },
        "entrypoint": {
          "type": "object",
          "properties": {
            "command": {
              "type": "string",
              "minLength": 1
            },
            "args": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "command",
            "args"
          ]
        },
        "ports": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "port": {
                "type": "integer",
                "minimum": 1,
                "maximum": 65535
              },
              "protocol": {
                "type": "string",
                "const": "http"
              }
            },
            "required": [
              "port",
              "protocol"
            ]
          }
        }
      }
    }
  }
}

EnsureRequest

{
  "type": "object",
  "properties": {}
}

AccessRequest

{
  "type": "object",
  "properties": {}
}

SessionCreateRequest

{
  "type": "object",
  "properties": {
    "surface_id": {
      "type": "string",
      "pattern": "^srf_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    }
  },
  "required": [
    "surface_id"
  ]
}

InvocationCreateRequest

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "const": "http_request"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE",
        "HEAD",
        "OPTIONS"
      ]
    },
    "path": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "pattern": "^\\/[^?#]*$"
    },
    "query_evidence": {
      "$ref": "#/$defs/__schema0"
    },
    "body_evidence": {
      "anyOf": [
        {
          "$ref": "#/$defs/__schema0"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "kind",
    "method",
    "path",
    "body_evidence"
  ],
  "$defs": {
    "__schema0": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string",
          "minLength": 1
        },
        "sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "uri",
        "sha256",
        "size_bytes"
      ]
    }
  }
}

Product

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "type": {
      "type": "string",
      "const": "hosted-app"
    },
    "input_revision_id": {
      "type": "string",
      "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "type",
    "input_revision_id",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

Revision

{
  "type": "object",
  "properties": {
    "capability_contract": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "const": "rejected"
        },
        "reason": {
          "type": "string",
          "enum": [
            "unknown_capability",
            "unknown_action",
            "scope_invalid",
            "scope_widened",
            "owner_not_supported",
            "contract_too_large"
          ]
        }
      },
      "required": [
        "status",
        "reason"
      ]
    },
    "id": {
      "type": "string",
      "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "input_revision_id": {
      "type": "string",
      "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_type": {
      "type": "string",
      "const": "hosted-app"
    },
    "descriptor": {
      "type": "object",
      "properties": {
        "build_plan": {
          "type": "object",
          "properties": {
            "runtime": {
              "$ref": "#/$defs/__schema0"
            },
            "workdir": {
              "$ref": "#/$defs/__schema1"
            },
            "install": {
              "$ref": "#/$defs/__schema2"
            },
            "build": {
              "$ref": "#/$defs/__schema3"
            },
            "start": {
              "$ref": "#/$defs/__schema4"
            },
            "port": {
              "$ref": "#/$defs/__schema5"
            },
            "health": {
              "$ref": "#/$defs/__schema6"
            },
            "env": {
              "$ref": "#/$defs/__schema7"
            }
          },
          "required": [
            "runtime",
            "workdir",
            "install",
            "build",
            "start",
            "port",
            "health",
            "env"
          ]
        },
        "runtime": {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "node",
                "shell"
              ]
            },
            "version": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "kind",
            "version"
          ]
        },
        "entrypoint": {
          "type": "object",
          "properties": {
            "command": {
              "type": "string"
            },
            "args": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "command",
            "args"
          ]
        },
        "ports": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "port": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "protocol": {
                "type": "string",
                "const": "http"
              }
            },
            "required": [
              "port",
              "protocol"
            ]
          }
        },
        "field_sources": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "string",
            "enum": [
              "detected",
              "developer"
            ]
          }
        }
      },
      "required": [
        "runtime",
        "entrypoint",
        "ports",
        "field_sources"
      ]
    },
    "descriptor_hash": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$"
    },
    "confirmed_by": {
      "type": "string",
      "pattern": "^usr_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "created_at": {
      "$ref": "#/$defs/__schema8"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema8"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "product_id",
    "input_revision_id",
    "product_type",
    "descriptor",
    "descriptor_hash",
    "confirmed_by",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "node",
            "shell"
          ]
        },
        "version": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "kind",
        "version"
      ]
    },
    "__schema1": {
      "type": "string",
      "pattern": "^\\/.*"
    },
    "__schema2": {
      "type": "object",
      "properties": {
        "package_manager": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "pnpm",
                "npm",
                "yarn"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "command": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "package_manager",
        "command"
      ]
    },
    "__schema3": {
      "type": "object",
      "properties": {
        "command": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "command"
      ]
    },
    "__schema4": {
      "type": "object",
      "properties": {
        "command": {
          "type": "string"
        }
      },
      "required": [
        "command"
      ]
    },
    "__schema5": {
      "type": "integer",
      "minimum": 1,
      "maximum": 65535
    },
    "__schema6": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "pattern": "^\\/.*"
        },
        "timeout_ms": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "path",
        "timeout_ms"
      ]
    },
    "__schema7": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "PORT",
          "NODE_ENV"
        ]
      }
    },
    "__schema8": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

CapabilityContractRejected

{
  "type": "object",
  "properties": {
    "capability_contract": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "const": "rejected"
        },
        "reason": {
          "type": "string",
          "enum": [
            "unknown_capability",
            "unknown_action",
            "scope_invalid",
            "scope_widened",
            "owner_not_supported",
            "contract_too_large"
          ]
        }
      },
      "required": [
        "status",
        "reason"
      ]
    }
  },
  "required": [
    "capability_contract"
  ]
}

PipelineRun

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^pipe_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "revision_id": {
      "type": "string",
      "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "intent": {
      "type": "string",
      "const": "preview"
    },
    "status": {
      "type": "string",
      "enum": [
        "pending_snapshot",
        "authorization_requested",
        "blocked",
        "admitted",
        "requested",
        "reported",
        "completed",
        "failed"
      ]
    },
    "reason_code": {
      "type": "string"
    },
    "findings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "kind",
          "severity",
          "code",
          "message"
        ]
      }
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "revision_id",
    "intent",
    "status",
    "findings",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

Deployment

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^dep_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "revision_id": {
      "type": "string",
      "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "pipeline_run_id": {
      "type": "string",
      "pattern": "^pipe_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "environment_id": {
      "type": "string",
      "pattern": "^env_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "environment_type": {
      "type": "string",
      "enum": [
        "preview",
        "staging",
        "production"
      ]
    },
    "slot": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "planned",
        "applying",
        "active",
        "superseded",
        "blocked",
        "failed"
      ]
    },
    "reason_code": {
      "type": "string"
    },
    "required_isolation_profile": {
      "type": "string",
      "const": "isolated-vm"
    },
    "egress": {
      "type": "string",
      "const": "deny"
    },
    "isolation": {
      "type": "object",
      "properties": {
        "profile": {
          "type": "string",
          "const": "isolated-vm"
        },
        "enforced": {
          "type": "boolean"
        }
      },
      "required": [
        "profile",
        "enforced"
      ]
    },
    "health": {
      "type": "object",
      "properties": {
        "checked_at": {
          "$ref": "#/$defs/__schema0"
        },
        "attempts": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "latency_ms": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "checked_at",
        "attempts",
        "latency_ms"
      ]
    },
    "endpoint": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "address"
      ]
    },
    "superseded_deployment_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^dep_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "surface_id": {
      "type": "string",
      "pattern": "^srf_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "findings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string"
          },
          "severity": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "kind",
          "severity",
          "code",
          "message"
        ]
      }
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    },
    "source": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "revision"
            }
          },
          "required": [
            "kind"
          ]
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "release"
            },
            "release_id": {
              "type": "string",
              "pattern": "^rel_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
            },
            "version_id": {
              "type": "string",
              "pattern": "^ver_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
            }
          },
          "required": [
            "kind",
            "release_id",
            "version_id"
          ]
        }
      ]
    }
  },
  "required": [
    "id",
    "workspace_id",
    "product_id",
    "revision_id",
    "environment_type",
    "slot",
    "status",
    "required_isolation_profile",
    "egress",
    "findings",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

Surface

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^srf_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "deployment_id": {
      "type": "string",
      "pattern": "^dep_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "environment_id": {
      "type": "string",
      "pattern": "^env_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "environment_type": {
      "type": "string",
      "enum": [
        "preview",
        "staging",
        "production"
      ]
    },
    "surface_type": {
      "type": "string",
      "const": "web"
    },
    "status": {
      "type": "string",
      "enum": [
        "awaiting_expiration_registration",
        "validating",
        "active",
        "expiration_registration_failed",
        "configuration_failed",
        "expired"
      ]
    },
    "reason_code": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "route": {
      "type": "object",
      "properties": {
        "host": {
          "type": "string"
        },
        "path": {
          "type": "string"
        }
      },
      "required": [
        "host",
        "path"
      ]
    },
    "identity_requirement": {
      "type": "string",
      "const": "none"
    },
    "access_policy": {
      "type": "string",
      "const": "preview_direct"
    },
    "expires_at": {
      "$ref": "#/$defs/__schema0"
    },
    "deadline_id": {
      "type": "string",
      "pattern": "^ddl_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "reachability": {
      "type": "object",
      "properties": {
        "checked_at": {
          "$ref": "#/$defs/__schema0"
        },
        "status_code": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "latency_ms": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "checked_at",
        "status_code",
        "latency_ms"
      ]
    },
    "activated_at": {
      "$ref": "#/$defs/__schema0"
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "product_id",
    "deployment_id",
    "environment_id",
    "environment_type",
    "surface_type",
    "status",
    "identity_requirement",
    "access_policy",
    "expires_at",
    "deadline_id",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

Access

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^acc_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "account_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^usr_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "surface_id": {
      "type": "string",
      "pattern": "^srf_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "deployment_id": {
      "type": "string",
      "pattern": "^dep_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "access_entry": {
      "type": "string",
      "const": "direct_surface"
    },
    "entitlement_source": {
      "type": "string",
      "const": "direct"
    },
    "expires_at": {
      "$ref": "#/$defs/__schema0"
    },
    "session_id": {
      "type": "string",
      "pattern": "^ses_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "reused_existing_access": {
      "type": "boolean"
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "account_id",
    "product_id",
    "surface_id",
    "deployment_id",
    "access_entry",
    "entitlement_source",
    "expires_at",
    "reused_existing_access",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

Session

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^ses_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "surface_id": {
      "type": "string",
      "pattern": "^srf_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "account_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^usr_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "access_id": {
      "type": "string",
      "pattern": "^acc_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "environment_id": {
      "type": "string",
      "pattern": "^env_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "state": {
      "type": "string",
      "enum": [
        "active",
        "closed"
      ]
    },
    "closed_at": {
      "anyOf": [
        {
          "$ref": "#/$defs/__schema0"
        },
        {
          "type": "null"
        }
      ]
    },
    "created_at": {
      "$ref": "#/$defs/__schema0"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema0"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "product_id",
    "surface_id",
    "account_id",
    "access_id",
    "environment_id",
    "state",
    "closed_at",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

Invocation

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^inv_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "session_id": {
      "type": "string",
      "pattern": "^ses_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "surface_id": {
      "type": "string",
      "pattern": "^srf_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "account_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^usr_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "access_id": {
      "type": "string",
      "pattern": "^acc_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "sequence": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "input": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "http_request"
        },
        "method": {
          "type": "string",
          "enum": [
            "GET",
            "POST",
            "PUT",
            "PATCH",
            "DELETE",
            "HEAD",
            "OPTIONS"
          ]
        },
        "path": {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048,
          "pattern": "^\\/[^?#]*$"
        },
        "query_evidence": {
          "$ref": "#/$defs/__schema0"
        },
        "body_evidence": {
          "anyOf": [
            {
              "$ref": "#/$defs/__schema0"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "kind",
        "method",
        "path",
        "body_evidence"
      ]
    },
    "admission": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "invocation_id": {
              "$ref": "#/$defs/__schema1"
            },
            "session_id": {
              "$ref": "#/$defs/__schema2"
            },
            "workspace_id": {
              "$ref": "#/$defs/__schema3"
            },
            "product_id": {
              "$ref": "#/$defs/__schema4"
            },
            "surface_id": {
              "$ref": "#/$defs/__schema5"
            },
            "account_id": {
              "$ref": "#/$defs/__schema6"
            },
            "outcome": {
              "$ref": "#/$defs/__schema7"
            },
            "reason": {
              "$ref": "#/$defs/__schema8"
            },
            "execution_id": {
              "$ref": "#/$defs/__schema9"
            },
            "pending_operation_id": {
              "$ref": "#/$defs/__schema10"
            },
            "checks": {
              "$ref": "#/$defs/__schema11"
            },
            "message": {
              "$ref": "#/$defs/__schema13"
            },
            "decided_at": {
              "$ref": "#/$defs/__schema14"
            }
          },
          "required": [
            "invocation_id",
            "session_id",
            "workspace_id",
            "product_id",
            "surface_id",
            "account_id",
            "outcome",
            "reason",
            "execution_id",
            "pending_operation_id",
            "checks",
            "message",
            "decided_at"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "execution": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "execution_id": {
              "$ref": "#/$defs/__schema15"
            },
            "invocation_id": {
              "$ref": "#/$defs/__schema16"
            },
            "session_id": {
              "$ref": "#/$defs/__schema17"
            },
            "workspace_id": {
              "$ref": "#/$defs/__schema18"
            },
            "product_id": {
              "$ref": "#/$defs/__schema19"
            },
            "deployment_id": {
              "$ref": "#/$defs/__schema20"
            },
            "execution_mode": {
              "$ref": "#/$defs/__schema21"
            },
            "status": {
              "$ref": "#/$defs/__schema22"
            },
            "failure": {
              "$ref": "#/$defs/__schema23"
            },
            "result": {
              "$ref": "#/$defs/__schema24"
            },
            "log_evidence": {
              "$ref": "#/$defs/__schema26"
            },
            "usage": {
              "$ref": "#/$defs/__schema27"
            },
            "started_at": {
              "$ref": "#/$defs/__schema28"
            },
            "finished_at": {
              "$ref": "#/$defs/__schema29"
            }
          },
          "required": [
            "execution_id",
            "invocation_id",
            "session_id",
            "workspace_id",
            "product_id",
            "deployment_id",
            "execution_mode",
            "status",
            "failure",
            "result",
            "log_evidence",
            "usage",
            "started_at",
            "finished_at"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "created_at": {
      "$ref": "#/$defs/__schema30"
    },
    "updated_at": {
      "$ref": "#/$defs/__schema30"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "product_id",
    "session_id",
    "surface_id",
    "account_id",
    "access_id",
    "sequence",
    "input",
    "admission",
    "execution",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string",
          "minLength": 1
        },
        "sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "uri",
        "sha256",
        "size_bytes"
      ]
    },
    "__schema1": {
      "type": "string",
      "pattern": "^inv_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema2": {
      "type": "string",
      "pattern": "^ses_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema3": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema4": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema5": {
      "type": "string",
      "pattern": "^srf_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema6": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^usr_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "__schema7": {
      "type": "string",
      "enum": [
        "admitted",
        "denied",
        "pending"
      ]
    },
    "__schema8": {
      "type": "string",
      "enum": [
        "admitted",
        "permission_denied",
        "policy_blocked",
        "binding_unavailable",
        "verification_blocked",
        "usage_denied",
        "rate_limited",
        "pending_consent"
      ]
    },
    "__schema9": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^exe_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "__schema10": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^pend_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "__schema11": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "$ref": "#/$defs/__schema12"
      }
    },
    "__schema12": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "enum": [
            "permission",
            "policy",
            "binding",
            "verification",
            "usage"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "passed",
            "failed",
            "skipped"
          ]
        }
      },
      "required": [
        "name",
        "status"
      ]
    },
    "__schema13": {
      "type": "string",
      "maxLength": 512
    },
    "__schema14": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "__schema15": {
      "type": "string",
      "pattern": "^exe_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema16": {
      "type": "string",
      "pattern": "^inv_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema17": {
      "type": "string",
      "pattern": "^ses_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema18": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema19": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema20": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^dep_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "__schema21": {
      "type": "string",
      "enum": [
        "managed",
        "remote",
        "bridge"
      ]
    },
    "__schema22": {
      "type": "string",
      "enum": [
        "completed",
        "failed",
        "cancelled",
        "timed_out"
      ]
    },
    "__schema23": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "product_error",
                "runtime_error",
                "timeout",
                "cancelled",
                "isolation_violation"
              ]
            },
            "message": {
              "type": "string",
              "maxLength": 2048
            }
          },
          "required": [
            "code",
            "message"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "__schema24": {
      "type": "object",
      "properties": {
        "http_status": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 100,
              "maximum": 599
            },
            {
              "type": "null"
            }
          ]
        },
        "body_evidence": {
          "anyOf": [
            {
              "$ref": "#/$defs/__schema25"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "http_status",
        "body_evidence"
      ]
    },
    "__schema25": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string",
          "minLength": 1
        },
        "sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "uri",
        "sha256",
        "size_bytes"
      ]
    },
    "__schema26": {
      "anyOf": [
        {
          "$ref": "#/$defs/__schema25"
        },
        {
          "type": "null"
        }
      ]
    },
    "__schema27": {
      "type": "object",
      "properties": {
        "duration_ms": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "cpu_ms": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "memory_peak_bytes": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "duration_ms",
        "cpu_ms",
        "memory_peak_bytes"
      ]
    },
    "__schema28": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "__schema29": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "__schema30": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}

Problem

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "detail": {
      "type": "string"
    },
    "instance": {
      "type": "string"
    },
    "code": {
      "type": "string",
      "enum": [
        "bad_request",
        "unauthenticated",
        "forbidden",
        "not_found",
        "conflict",
        "validation_failed",
        "rate_limited",
        "internal",
        "unavailable"
      ]
    },
    "correlation_id": {
      "type": "string",
      "pattern": "^evt_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "reason": {
      "type": "string"
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "path",
          "message"
        ]
      }
    }
  },
  "required": [
    "type",
    "title",
    "status",
    "detail",
    "instance",
    "code",
    "correlation_id"
  ]
}

CredentialRequest

{
  "type": "object",
  "properties": {
    "secret": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384
    },
    "provider": {
      "$ref": "#/$defs/__schema0"
    },
    "capability": {
      "$ref": "#/$defs/__schema0"
    },
    "actions": {
      "minItems": 1,
      "maxItems": 64,
      "type": "array",
      "items": {
        "$ref": "#/$defs/__schema0"
      }
    },
    "scope": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "$ref": "#/$defs/__schema0"
      }
    },
    "expires_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "secret",
    "provider",
    "capability",
    "actions",
    "scope",
    "expires_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  }
}

Credential

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^cred_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "string",
          "const": "ws_platform"
        }
      ]
    },
    "owner_kind": {
      "type": "string",
      "enum": [
        "workspace",
        "platform"
      ]
    },
    "provider": {
      "type": "string"
    },
    "capability": {
      "type": "string"
    },
    "actions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "scope": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "expires_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "created_by": {
      "type": "string",
      "pattern": "^usr_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "owner_kind",
    "provider",
    "capability",
    "actions",
    "scope",
    "expires_at",
    "created_by",
    "created_at",
    "updated_at"
  ]
}

ProviderBindingRequest

{
  "type": "object",
  "properties": {
    "credential_id": {
      "type": "string",
      "pattern": "^cred_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "capability": {
      "$ref": "#/$defs/__schema0"
    },
    "actions": {
      "minItems": 1,
      "maxItems": 64,
      "type": "array",
      "items": {
        "$ref": "#/$defs/__schema0"
      }
    },
    "scope": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "$ref": "#/$defs/__schema0"
      }
    },
    "budget": {
      "type": "object",
      "properties": {
        "units": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "unit": {
          "type": "string",
          "const": "tokens"
        }
      },
      "required": [
        "units",
        "unit"
      ]
    },
    "capability_scope": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "ai.generate"
            },
            "scope": {
              "type": "object",
              "properties": {
                "models": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema1"
                  }
                },
                "max_tokens_per_call": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "models",
                "max_tokens_per_call"
              ]
            },
            "provider_models": {
              "type": "object",
              "properties": {
                "text": {
                  "type": "string",
                  "minLength": 1
                },
                "embedding": {
                  "type": "string",
                  "minLength": 1
                }
              }
            }
          },
          "required": [
            "id",
            "scope",
            "provider_models"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "storage.object"
            },
            "scope": {
              "type": "object",
              "properties": {
                "prefix": {
                  "type": "string",
                  "pattern": "^\\/(?!.*\\.\\.).*$"
                },
                "max_object_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "prefix",
                "max_object_bytes"
              ]
            }
          },
          "required": [
            "id",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "data.kv"
            },
            "scope": {
              "type": "object",
              "properties": {
                "prefix": {
                  "type": "string",
                  "pattern": "^\\/(?!.*\\.\\.).*$"
                },
                "max_value_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 65536
                },
                "max_keys": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 100000
                }
              },
              "required": [
                "prefix",
                "max_value_bytes",
                "max_keys"
              ]
            }
          },
          "required": [
            "id",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "email.send"
            },
            "scope": {
              "type": "object",
              "properties": {
                "from_addresses": {
                  "minItems": 1,
                  "maxItems": 32,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema2"
                  }
                },
                "recipient_domains": {
                  "minItems": 1,
                  "maxItems": 32,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema3"
                  }
                },
                "max_recipients": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 50
                },
                "max_message_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 1048576
                }
              },
              "required": [
                "from_addresses",
                "recipient_domains",
                "max_recipients",
                "max_message_bytes"
              ]
            }
          },
          "required": [
            "id",
            "scope"
          ]
        }
      ]
    },
    "expires_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "credential_id",
    "capability",
    "actions",
    "scope",
    "expires_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "__schema1": {
      "type": "string",
      "enum": [
        "text",
        "embedding"
      ]
    },
    "__schema2": {
      "type": "string",
      "maxLength": 254,
      "pattern": "^(?!.*[A-Z])(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"(?:[ !#-[\\]-~]|\\\\[ -~])*\")@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
    },
    "__schema3": {
      "type": "string",
      "maxLength": 253,
      "pattern": "^(?:\\*|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)$"
    }
  }
}

ProviderBinding

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "string",
          "const": "ws_platform"
        }
      ]
    },
    "owner_kind": {
      "type": "string",
      "enum": [
        "workspace",
        "platform"
      ]
    },
    "provider": {
      "type": "string"
    },
    "capability": {
      "type": "string"
    },
    "actions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "scope": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "expires_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "budget": {
      "type": "object",
      "properties": {
        "units": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "unit": {
          "type": "string",
          "const": "tokens"
        }
      },
      "required": [
        "units",
        "unit"
      ]
    },
    "id": {
      "type": "string",
      "pattern": "^bind_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "credential_id": {
      "type": "string",
      "pattern": "^cred_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "requested_by": {
      "type": "string",
      "pattern": "^usr_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "state": {
      "type": "string",
      "enum": [
        "requested",
        "active",
        "blocked",
        "revoked"
      ]
    },
    "reason": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "workspace_id",
    "owner_kind",
    "provider",
    "capability",
    "actions",
    "scope",
    "expires_at",
    "created_at",
    "updated_at",
    "id",
    "credential_id",
    "requested_by",
    "state",
    "reason"
  ]
}

ProviderBindings

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "workspace_id": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
              },
              {
                "type": "string",
                "const": "ws_platform"
              }
            ]
          },
          "owner_kind": {
            "type": "string",
            "enum": [
              "workspace",
              "platform"
            ]
          },
          "provider": {
            "type": "string"
          },
          "capability": {
            "type": "string"
          },
          "actions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "scope": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
          },
          "budget": {
            "type": "object",
            "properties": {
              "units": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "unit": {
                "type": "string",
                "const": "tokens"
              }
            },
            "required": [
              "units",
              "unit"
            ]
          },
          "id": {
            "type": "string",
            "pattern": "^bind_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
          },
          "credential_id": {
            "type": "string",
            "pattern": "^cred_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
          },
          "requested_by": {
            "type": "string",
            "pattern": "^usr_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
          },
          "state": {
            "type": "string",
            "enum": [
              "requested",
              "active",
              "blocked",
              "revoked"
            ]
          },
          "reason": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "workspace_id",
          "owner_kind",
          "provider",
          "capability",
          "actions",
          "scope",
          "expires_at",
          "created_at",
          "updated_at",
          "id",
          "credential_id",
          "requested_by",
          "state",
          "reason"
        ]
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "items",
    "next_cursor"
  ]
}

BridgeRequest

{
  "type": "object",
  "properties": {
    "request": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "ai.generate"
            },
            "action": {
              "type": "string",
              "const": "generate"
            },
            "model_kind": {
              "type": "string",
              "enum": [
                "text",
                "embedding"
              ]
            },
            "max_tokens": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "action",
            "model_kind",
            "max_tokens"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "storage.object"
            },
            "action": {
              "type": "string",
              "enum": [
                "read",
                "write",
                "delete",
                "list"
              ]
            },
            "key": {
              "type": "string",
              "pattern": "^\\/(?!.*\\.\\.).*$"
            },
            "bytes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "action",
            "key"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "data.kv"
            },
            "action": {
              "type": "string",
              "enum": [
                "get",
                "set",
                "delete",
                "list",
                "increment"
              ]
            },
            "key": {
              "type": "string",
              "pattern": "^\\/(?!.*\\.\\.).*$"
            },
            "bytes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "action",
            "key"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "email.send"
            },
            "action": {
              "type": "string",
              "const": "send"
            },
            "from": {
              "$ref": "#/$defs/__schema0"
            },
            "recipients": {
              "minItems": 1,
              "maxItems": 50,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema0"
              }
            },
            "bytes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "action",
            "from",
            "recipients",
            "bytes"
          ]
        }
      ]
    },
    "input": {
      "oneOf": [
        {
          "$ref": "#/$defs/__schema1"
        },
        {
          "$ref": "#/$defs/__schema2"
        }
      ]
    }
  },
  "required": [
    "request",
    "input"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "maxLength": 254,
      "pattern": "^(?!.*[A-Z])(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"(?:[ !#-[\\]-~]|\\\\[ -~])*\")@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
    },
    "__schema1": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "inline"
        },
        "json": {}
      },
      "required": [
        "kind",
        "json"
      ]
    },
    "__schema2": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string"
        },
        "sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "kind": {
          "type": "string",
          "const": "evidence"
        }
      },
      "required": [
        "uri",
        "sha256",
        "size_bytes",
        "kind"
      ]
    }
  }
}

BridgeOutput

{
  "oneOf": [
    {
      "$ref": "#/$defs/__schema0"
    },
    {
      "$ref": "#/$defs/__schema1"
    }
  ],
  "$defs": {
    "__schema0": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "inline"
        },
        "json": {}
      },
      "required": [
        "kind",
        "json"
      ]
    },
    "__schema1": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string"
        },
        "sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "kind": {
          "type": "string",
          "const": "evidence"
        }
      },
      "required": [
        "uri",
        "sha256",
        "size_bytes",
        "kind"
      ]
    }
  }
}

ServiceIdentityRequest

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "scope": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "ai.generate"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema0"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "models": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema1"
                  }
                },
                "max_tokens_per_call": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "models",
                "max_tokens_per_call"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "storage.object"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema2"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "prefix": {
                  "type": "string",
                  "pattern": "^\\/(?!.*\\.\\.).*$"
                },
                "max_object_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "prefix",
                "max_object_bytes"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "data.kv"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema3"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "prefix": {
                  "type": "string",
                  "pattern": "^\\/(?!.*\\.\\.).*$"
                },
                "max_value_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 65536
                },
                "max_keys": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 100000
                }
              },
              "required": [
                "prefix",
                "max_value_bytes",
                "max_keys"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "email.send"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema4"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "from_addresses": {
                  "minItems": 1,
                  "maxItems": 32,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema5"
                  }
                },
                "recipient_domains": {
                  "minItems": 1,
                  "maxItems": 32,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema6"
                  }
                },
                "max_recipients": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 50
                },
                "max_message_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 1048576
                }
              },
              "required": [
                "from_addresses",
                "recipient_domains",
                "max_recipients",
                "max_message_bytes"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        }
      ]
    },
    "budget": {
      "type": "object",
      "properties": {
        "units": {
          "type": "number",
          "minimum": 0
        },
        "unit": {
          "type": "string",
          "enum": [
            "tokens",
            "bytes",
            "calls"
          ]
        }
      },
      "required": [
        "units",
        "unit"
      ]
    }
  },
  "required": [
    "product_id",
    "scope",
    "budget"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "enum": [
        "generate"
      ]
    },
    "__schema1": {
      "type": "string",
      "enum": [
        "text",
        "embedding"
      ]
    },
    "__schema2": {
      "type": "string",
      "enum": [
        "read",
        "write",
        "delete",
        "list"
      ]
    },
    "__schema3": {
      "type": "string",
      "enum": [
        "get",
        "set",
        "delete",
        "list",
        "increment"
      ]
    },
    "__schema4": {
      "type": "string",
      "enum": [
        "send"
      ]
    },
    "__schema5": {
      "type": "string",
      "maxLength": 254,
      "pattern": "^(?!.*[A-Z])(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"(?:[ !#-[\\]-~]|\\\\[ -~])*\")@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
    },
    "__schema6": {
      "type": "string",
      "maxLength": 253,
      "pattern": "^(?:\\*|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)$"
    }
  }
}

ServiceIdentity

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^svc_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "service_identity_id": {
      "type": "string",
      "pattern": "^svc_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "oidc_client_id": {
      "type": "string",
      "minLength": 1
    },
    "scope": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "ai.generate"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema0"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "models": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema1"
                  }
                },
                "max_tokens_per_call": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "models",
                "max_tokens_per_call"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "storage.object"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema2"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "prefix": {
                  "type": "string",
                  "pattern": "^\\/(?!.*\\.\\.).*$"
                },
                "max_object_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "prefix",
                "max_object_bytes"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "data.kv"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema3"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "prefix": {
                  "type": "string",
                  "pattern": "^\\/(?!.*\\.\\.).*$"
                },
                "max_value_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 65536
                },
                "max_keys": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 100000
                }
              },
              "required": [
                "prefix",
                "max_value_bytes",
                "max_keys"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "email.send"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema4"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "from_addresses": {
                  "minItems": 1,
                  "maxItems": 32,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema5"
                  }
                },
                "recipient_domains": {
                  "minItems": 1,
                  "maxItems": 32,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema6"
                  }
                },
                "max_recipients": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 50
                },
                "max_message_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 1048576
                }
              },
              "required": [
                "from_addresses",
                "recipient_domains",
                "max_recipients",
                "max_message_bytes"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        }
      ]
    },
    "budget": {
      "type": "object",
      "properties": {
        "units": {
          "type": "number",
          "minimum": 0
        },
        "unit": {
          "type": "string",
          "enum": [
            "tokens",
            "bytes",
            "calls"
          ]
        }
      },
      "required": [
        "units",
        "unit"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "revoked"
      ]
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "id",
    "service_identity_id",
    "workspace_id",
    "product_id",
    "oidc_client_id",
    "scope",
    "budget",
    "status",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "enum": [
        "generate"
      ]
    },
    "__schema1": {
      "type": "string",
      "enum": [
        "text",
        "embedding"
      ]
    },
    "__schema2": {
      "type": "string",
      "enum": [
        "read",
        "write",
        "delete",
        "list"
      ]
    },
    "__schema3": {
      "type": "string",
      "enum": [
        "get",
        "set",
        "delete",
        "list",
        "increment"
      ]
    },
    "__schema4": {
      "type": "string",
      "enum": [
        "send"
      ]
    },
    "__schema5": {
      "type": "string",
      "maxLength": 254,
      "pattern": "^(?!.*[A-Z])(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"(?:[ !#-[\\]-~]|\\\\[ -~])*\")@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
    },
    "__schema6": {
      "type": "string",
      "maxLength": 253,
      "pattern": "^(?:\\*|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)$"
    }
  }
}

ServiceIdentityCreated

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^svc_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "service_identity_id": {
      "type": "string",
      "pattern": "^svc_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "oidc_client_id": {
      "type": "string",
      "minLength": 1
    },
    "scope": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "ai.generate"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema0"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "models": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema1"
                  }
                },
                "max_tokens_per_call": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "models",
                "max_tokens_per_call"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "storage.object"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema2"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "prefix": {
                  "type": "string",
                  "pattern": "^\\/(?!.*\\.\\.).*$"
                },
                "max_object_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "prefix",
                "max_object_bytes"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "data.kv"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema3"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "prefix": {
                  "type": "string",
                  "pattern": "^\\/(?!.*\\.\\.).*$"
                },
                "max_value_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 65536
                },
                "max_keys": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 100000
                }
              },
              "required": [
                "prefix",
                "max_value_bytes",
                "max_keys"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "email.send"
            },
            "actions": {
              "minItems": 1,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema4"
              }
            },
            "scope": {
              "type": "object",
              "properties": {
                "from_addresses": {
                  "minItems": 1,
                  "maxItems": 32,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema5"
                  }
                },
                "recipient_domains": {
                  "minItems": 1,
                  "maxItems": 32,
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/__schema6"
                  }
                },
                "max_recipients": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 50
                },
                "max_message_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 1048576
                }
              },
              "required": [
                "from_addresses",
                "recipient_domains",
                "max_recipients",
                "max_message_bytes"
              ]
            }
          },
          "required": [
            "id",
            "actions",
            "scope"
          ]
        }
      ]
    },
    "budget": {
      "type": "object",
      "properties": {
        "units": {
          "type": "number",
          "minimum": 0
        },
        "unit": {
          "type": "string",
          "enum": [
            "tokens",
            "bytes",
            "calls"
          ]
        }
      },
      "required": [
        "units",
        "unit"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "revoked"
      ]
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "client_secret": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "service_identity_id",
    "workspace_id",
    "product_id",
    "oidc_client_id",
    "scope",
    "budget",
    "status",
    "created_at",
    "updated_at"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "enum": [
        "generate"
      ]
    },
    "__schema1": {
      "type": "string",
      "enum": [
        "text",
        "embedding"
      ]
    },
    "__schema2": {
      "type": "string",
      "enum": [
        "read",
        "write",
        "delete",
        "list"
      ]
    },
    "__schema3": {
      "type": "string",
      "enum": [
        "get",
        "set",
        "delete",
        "list",
        "increment"
      ]
    },
    "__schema4": {
      "type": "string",
      "enum": [
        "send"
      ]
    },
    "__schema5": {
      "type": "string",
      "maxLength": 254,
      "pattern": "^(?!.*[A-Z])(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"(?:[ !#-[\\]-~]|\\\\[ -~])*\")@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
    },
    "__schema6": {
      "type": "string",
      "maxLength": 253,
      "pattern": "^(?:\\*|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)$"
    }
  }
}

CapabilityInvocation

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^cap_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "workspace_id": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "product_id": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "revision_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^rev_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "execution_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^exe_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "bridge_invocation_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^inv_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "capability": {
      "type": [
        "string",
        "null"
      ]
    },
    "action": {
      "type": [
        "string",
        "null"
      ]
    },
    "outcome": {
      "type": "string",
      "enum": [
        "requested",
        "completed",
        "denied",
        "failed"
      ]
    },
    "reason": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "outside_contract",
            "permission_denied",
            "policy_blocked",
            "binding_missing",
            "binding_revoked",
            "usage_denied",
            "provider_unavailable",
            "provider_rejected",
            "output_blocked"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "provider": {
      "type": [
        "string",
        "null"
      ]
    },
    "is_fallback_used": {
      "type": "boolean"
    },
    "usage_units": {
      "type": "number",
      "minimum": 0
    },
    "usage_unit": {
      "type": "string",
      "enum": [
        "tokens",
        "ms",
        "calls",
        "bytes"
      ]
    },
    "requested_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "finished_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "id",
    "workspace_id",
    "product_id",
    "revision_id",
    "execution_id",
    "bridge_invocation_id",
    "capability",
    "action",
    "outcome",
    "reason",
    "provider",
    "is_fallback_used",
    "usage_units",
    "usage_unit",
    "requested_at",
    "finished_at",
    "created_at",
    "updated_at"
  ]
}

RunnerCapabilityRequest

{
  "type": "object",
  "properties": {
    "execution_id": {
      "type": "string",
      "pattern": "^exe_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "request_event_id": {
      "type": "string",
      "pattern": "^evt_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "correlation_id": {
      "type": "string",
      "pattern": "^(mres|ws|usr|prod|rev|ver|rel|env|dep|srf|acc|ses|inv|exe|evt|pend|ddl|ntf|pipe|fnd|qual|cred|bind|hdl|cap|svc|frz)_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "request": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "ai.generate"
            },
            "action": {
              "type": "string",
              "const": "generate"
            },
            "model_kind": {
              "type": "string",
              "enum": [
                "text",
                "embedding"
              ]
            },
            "max_tokens": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "action",
            "model_kind",
            "max_tokens"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "storage.object"
            },
            "action": {
              "type": "string",
              "enum": [
                "read",
                "write",
                "delete",
                "list"
              ]
            },
            "key": {
              "type": "string",
              "pattern": "^\\/(?!.*\\.\\.).*$"
            },
            "bytes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "action",
            "key"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "data.kv"
            },
            "action": {
              "type": "string",
              "enum": [
                "get",
                "set",
                "delete",
                "list",
                "increment"
              ]
            },
            "key": {
              "type": "string",
              "pattern": "^\\/(?!.*\\.\\.).*$"
            },
            "bytes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "action",
            "key"
          ]
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "const": "email.send"
            },
            "action": {
              "type": "string",
              "const": "send"
            },
            "from": {
              "$ref": "#/$defs/__schema0"
            },
            "recipients": {
              "minItems": 1,
              "maxItems": 50,
              "type": "array",
              "items": {
                "$ref": "#/$defs/__schema0"
              }
            },
            "bytes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "action",
            "from",
            "recipients",
            "bytes"
          ]
        }
      ]
    },
    "input": {
      "oneOf": [
        {
          "$ref": "#/$defs/__schema1"
        },
        {
          "$ref": "#/$defs/__schema2"
        }
      ]
    }
  },
  "required": [
    "execution_id",
    "request_event_id",
    "correlation_id",
    "request",
    "input"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "maxLength": 254,
      "pattern": "^(?!.*[A-Z])(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"(?:[ !#-[\\]-~]|\\\\[ -~])*\")@(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$"
    },
    "__schema1": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "inline"
        },
        "json": {}
      },
      "required": [
        "kind",
        "json"
      ]
    },
    "__schema2": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string"
        },
        "sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "kind": {
          "type": "string",
          "const": "evidence"
        }
      },
      "required": [
        "uri",
        "sha256",
        "size_bytes",
        "kind"
      ]
    }
  }
}

RunnerCapabilityResult

{
  "type": "object",
  "properties": {
    "event_id": {
      "$ref": "#/$defs/__schema0"
    },
    "event_type": {
      "type": "string",
      "const": "H-361.capability.invocation_resulted"
    },
    "schema_version": {
      "type": "string",
      "const": "1.0.0"
    },
    "occurred_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "producer": {
      "type": "string",
      "const": "use"
    },
    "workspace_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "string",
          "const": "ws_platform"
        }
      ]
    },
    "correlation_id": {
      "type": "string",
      "pattern": "^(mres|ws|usr|prod|rev|ver|rel|env|dep|srf|acc|ses|inv|exe|evt|pend|ddl|ntf|pipe|fnd|qual|cred|bind|hdl|cap|svc|frz)_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "causation_id": {
      "anyOf": [
        {
          "$ref": "#/$defs/__schema0"
        },
        {
          "type": "null"
        }
      ]
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "payload": {
      "type": "object",
      "properties": {
        "binding_id": {
          "$ref": "#/$defs/__schema1"
        },
        "capability_invocation_id": {
          "$ref": "#/$defs/__schema2"
        },
        "workspace_id": {
          "$ref": "#/$defs/__schema3"
        },
        "product_id": {
          "$ref": "#/$defs/__schema4"
        },
        "outcome": {
          "$ref": "#/$defs/__schema5"
        },
        "reason": {
          "$ref": "#/$defs/__schema6"
        },
        "output": {
          "$ref": "#/$defs/__schema7"
        },
        "provider": {
          "$ref": "#/$defs/__schema10"
        },
        "fallback_used": {
          "$ref": "#/$defs/__schema11"
        },
        "usage": {
          "$ref": "#/$defs/__schema12"
        },
        "finished_at": {
          "$ref": "#/$defs/__schema13"
        }
      },
      "required": [
        "capability_invocation_id",
        "workspace_id",
        "product_id",
        "outcome",
        "reason",
        "output",
        "provider",
        "fallback_used",
        "usage",
        "finished_at"
      ]
    }
  },
  "required": [
    "event_id",
    "event_type",
    "schema_version",
    "occurred_at",
    "producer",
    "workspace_id",
    "correlation_id",
    "causation_id",
    "idempotency_key",
    "payload"
  ],
  "$defs": {
    "__schema0": {
      "type": "string",
      "pattern": "^evt_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema1": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^bind_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "__schema2": {
      "type": "string",
      "pattern": "^cap_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema3": {
      "type": "string",
      "pattern": "^ws_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema4": {
      "type": "string",
      "pattern": "^prod_[0-7][0123456789abcdefghjkmnpqrstvwxyz]{25}$"
    },
    "__schema5": {
      "type": "string",
      "enum": [
        "completed",
        "denied",
        "failed"
      ]
    },
    "__schema6": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "outside_contract",
            "permission_denied",
            "policy_blocked",
            "binding_missing",
            "binding_revoked",
            "usage_denied",
            "provider_unavailable",
            "provider_rejected",
            "output_blocked"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "__schema7": {
      "anyOf": [
        {
          "oneOf": [
            {
              "$ref": "#/$defs/__schema8"
            },
            {
              "$ref": "#/$defs/__schema9"
            }
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "__schema8": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "const": "inline"
        },
        "json": {}
      },
      "required": [
        "kind",
        "json"
      ]
    },
    "__schema9": {
      "type": "object",
      "properties": {
        "uri": {
          "type": "string"
        },
        "sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "size_bytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "kind": {
          "type": "string",
          "const": "evidence"
        }
      },
      "required": [
        "uri",
        "sha256",
        "size_bytes",
        "kind"
      ]
    },
    "__schema10": {
      "type": [
        "string",
        "null"
      ]
    },
    "__schema11": {
      "type": "boolean"
    },
    "__schema12": {
      "type": "object",
      "properties": {
        "units": {
          "type": "number",
          "minimum": 0
        },
        "unit": {
          "type": "string",
          "enum": [
            "tokens",
            "ms",
            "calls",
            "bytes"
          ]
        }
      },
      "required": [
        "units",
        "unit"
      ]
    },
    "__schema13": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  }
}