{
  "openapi": "3.1.0",
  "info": {
    "title": "ZeRaLD Shell Service Protocol",
    "version": "1.0.0",
    "description": "Shell Protocol v1 for linked ZeRaLD installations. Control plane and direct provider operations. The independent Python partner simulator is for local wire-format testing only; third-party identity enrollment and production partner token issuance are NOT implemented."
  },
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "x-zerald-protocol-version": "1",
  "x-zerald-status": "source-candidate; not yet real-server accepted",
  "x-zerald-app-entry": {
    "mode": "local-managed-panel-cli",
    "transport": "JSON stdin/stdout",
    "request": {
      "protocol_version": "1",
      "alias": "orders",
      "operation": "list",
      "payload": {
        "limit": 50,
        "offset": 0
      }
    },
    "description": "Applications do not call provider HTTP directly; the installed Panel resolves aliases, identities and grants. PHP: ZeRaLDServiceClient::fromManagedPanel()."
  },
  "x-zerald-capabilities": {
    "database.resource": {
      "version": "1",
      "read": [
        "list",
        "read"
      ],
      "write": [
        "create",
        "update",
        "delete",
        "update_many",
        "delete_many"
      ],
      "list_filter_operators": [
        "eq",
        "ne",
        "gt",
        "gte",
        "lt",
        "lte",
        "in"
      ],
      "single_record_unique_key": true,
      "explicit_bulk_operations": true
    },
    "media.store": {
      "version": "1",
      "read": [
        "list",
        "metadata",
        "download"
      ],
      "write": [
        "upload",
        "replace",
        "delete"
      ],
      "reference_pattern": "^m_[a-f0-9]{32}$",
      "public_url": false,
      "binary_transfer": "multipart upload; streamed GET download"
    }
  },
  "servers": [
    {
      "url": "https://zerald.dev",
      "description": "ZeRaLD central installation control plane"
    },
    {
      "url": "https://{panelHost}{panelPath}",
      "description": "The granted provider Panel; resolve from the currently linked installation, not a hard-coded address",
      "variables": {
        "panelHost": {
          "default": "provider.example",
          "description": "Provider HTTPS host resolved by ZeRaLD"
        },
        "panelPath": {
          "default": "/panel",
          "description": "Provider current Panel path (if any)"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "control plane"
    },
    {
      "name": "provider data plane"
    }
  ],
  "paths": {
    "/api/installations/{installationId}/shell/connections": {
      "get": {
        "summary": "Read linked installations",
        "operationId": "listShellConnections",
        "description": "Linked is a relationship state, not a live health probe.",
        "servers": [
          {
            "url": "https://zerald.dev",
            "description": "ZeRaLD central installation control plane"
          }
        ],
        "security": [
          {
            "installationToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON control or result envelope",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "installationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/api/installations/{installationId}/shell/services": {
      "get": {
        "summary": "Discover currently granted services",
        "operationId": "listShellServices",
        "description": "Only currently granted services are returned; each has provider identity and Read/Write permissions.",
        "servers": [
          {
            "url": "https://zerald.dev",
            "description": "ZeRaLD central installation control plane"
          }
        ],
        "security": [
          {
            "installationToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON control or result envelope",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "installationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/api/installations/{installationId}/shell/database-services": {
      "post": {
        "summary": "Publish provider-owned database resource",
        "operationId": "publishShellDatabase",
        "description": "Publication alone never grants a consumer Read or Write.",
        "servers": [
          {
            "url": "https://zerald.dev",
            "description": "ZeRaLD central installation control plane"
          }
        ],
        "security": [
          {
            "installationToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON control or result envelope",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "definition"
                ],
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "definition": {
                    "type": "object",
                    "description": "Provider-owned project_id and resource with table, columns, primary_key and writable fields."
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "installationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/api/installations/{installationId}/shell/media-services": {
      "post": {
        "summary": "Publish provider-owned managed media store",
        "operationId": "publishShellMedia",
        "description": "Only managed storage; the caller does not supply a filesystem path.",
        "servers": [
          {
            "url": "https://zerald.dev",
            "description": "ZeRaLD central installation control plane"
          }
        ],
        "security": [
          {
            "installationToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON control or result envelope",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "installationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/api/installations/{installationId}/shell/database-services/{serviceId}/authorize": {
      "post": {
        "summary": "Provider authorizes database consumer operation",
        "operationId": "authorizeShellDatabase",
        "description": "Internal provider-to-central verification; never expose returned private service definitions to consuming applications.",
        "servers": [
          {
            "url": "https://zerald.dev",
            "description": "ZeRaLD central installation control plane"
          }
        ],
        "security": [
          {
            "installationToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON control or result envelope",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "operation",
                  "consumer_access_token"
                ],
                "properties": {
                  "operation": {
                    "type": "string",
                    "enum": [
                      "list",
                      "read",
                      "create",
                      "update",
                      "delete",
                      "update_many",
                      "delete_many"
                    ]
                  },
                  "consumer_access_token": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "installationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "serviceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$"
            }
          }
        ]
      }
    },
    "/api/installations/{installationId}/shell/media-services/{serviceId}/authorize": {
      "post": {
        "summary": "Provider authorizes media consumer operation",
        "operationId": "authorizeShellMedia",
        "description": "Internal provider-to-central verification; not a public token exchange.",
        "servers": [
          {
            "url": "https://zerald.dev",
            "description": "ZeRaLD central installation control plane"
          }
        ],
        "security": [
          {
            "installationToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON control or result envelope",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "operation",
                  "consumer_access_token"
                ],
                "properties": {
                  "operation": {
                    "type": "string",
                    "enum": [
                      "list",
                      "metadata",
                      "download",
                      "upload",
                      "replace",
                      "delete"
                    ]
                  },
                  "consumer_access_token": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "installationId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "serviceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$"
            }
          }
        ]
      }
    },
    "/shell-database.php": {
      "post": {
        "summary": "Execute a granted database operation on provider",
        "operationId": "executeShellDatabase",
        "description": "POST application/json. Requesting a single-record operation requires a unique provider-published record key; bulk operations have distinct names. Never send arbitrary SQL or schema definitions.",
        "servers": [
          {
            "url": "https://{panelHost}{panelPath}",
            "description": "The granted provider Panel; resolve from the currently linked installation, not a hard-coded address",
            "variables": {
              "panelHost": {
                "default": "provider.example",
                "description": "Provider HTTPS host resolved by ZeRaLD"
              },
              "panelPath": {
                "default": "/panel",
                "description": "Provider current Panel path (if any)"
              }
            }
          }
        ],
        "security": [
          {
            "installationToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Operation-specific JSON result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ok",
                    "protocol_version",
                    "service_id",
                    "operation",
                    "result"
                  ],
                  "properties": {
                    "ok": {
                      "type": "boolean"
                    },
                    "protocol_version": {
                      "type": "string",
                      "const": "1"
                    },
                    "service_id": {
                      "type": "integer"
                    },
                    "operation": {
                      "type": "string"
                    },
                    "result": {}
                  }
                }
              }
            }
          },
          "401": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DatabaseRequest"
              }
            }
          }
        }
      }
    },
    "/shell-media.php": {
      "get": {
        "summary": "Download media bytes from provider",
        "operationId": "downloadShellMedia",
        "description": "The active Read grant is checked before streaming the file.",
        "servers": [
          {
            "url": "https://{panelHost}{panelPath}",
            "description": "The granted provider Panel; resolve from the currently linked installation, not a hard-coded address",
            "variables": {
              "panelHost": {
                "default": "provider.example",
                "description": "Provider HTTPS host resolved by ZeRaLD"
              },
              "panelPath": {
                "default": "/panel",
                "description": "Provider current Panel path (if any)"
              }
            }
          }
        ],
        "security": [
          {
            "installationToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Streamed binary file (not JSON or a public URL)",
            "headers": {
              "X-ZeRaLD-Media-Reference": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "service_id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "reference",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      },
      "post": {
        "summary": "Manage media objects on provider",
        "operationId": "executeShellMedia",
        "description": "List/metadata/delete use JSON POST. Upload/replace use multipart/form-data (stream the file). There is no anonymous public object URL.",
        "servers": [
          {
            "url": "https://{panelHost}{panelPath}",
            "description": "The granted provider Panel; resolve from the currently linked installation, not a hard-coded address",
            "variables": {
              "panelHost": {
                "default": "provider.example",
                "description": "Provider HTTPS host resolved by ZeRaLD"
              },
              "panelPath": {
                "default": "/panel",
                "description": "Provider current Panel path (if any)"
              }
            }
          }
        ],
        "security": [
          {
            "installationToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "JSON control or result envelope",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Structured error; exact code depends on boundary",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "service_id",
                  "operation"
                ],
                "properties": {
                  "service_id": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "operation": {
                    "type": "string",
                    "enum": [
                      "list",
                      "metadata",
                      "delete"
                    ]
                  },
                  "reference": {
                    "type": "string"
                  },
                  "offset": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1
                  }
                }
              }
            },
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "service_id",
                  "operation",
                  "file"
                ],
                "properties": {
                  "service_id": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "operation": {
                    "type": "string",
                    "enum": [
                      "upload",
                      "replace"
                    ]
                  },
                  "file": {
                    "type": "string",
                    "format": "binary"
                  },
                  "reference": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "installationToken": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "opaque",
        "description": "Short-lived installation access token obtained through existing signed challenge/verify flow; this is NOT an application/user/API key."
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "ok",
          "error"
        ],
        "properties": {
          "ok": {
            "type": "boolean",
            "const": false
          },
          "protocol_version": {
            "type": "string",
            "const": "1"
          },
          "error": {
            "type": "object",
            "required": [
              "code"
            ],
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            }
          }
        }
      },
      "Service": {
        "type": "object",
        "required": [
          "id",
          "name",
          "capability_type",
          "capability_version",
          "protocol_version",
          "provider",
          "permissions"
        ],
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "capability_type": {
            "type": "string",
            "enum": [
              "database.resource",
              "media.store"
            ]
          },
          "capability_version": {
            "type": "string",
            "const": "1"
          },
          "protocol_version": {
            "type": "string",
            "const": "1"
          },
          "provider": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            }
          },
          "permissions": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "read",
                "write"
              ]
            }
          }
        }
      },
      "DatabaseRequest": {
        "type": "object",
        "required": [
          "service_id",
          "operation",
          "payload"
        ],
        "properties": {
          "service_id": {
            "type": "integer",
            "minimum": 1
          },
          "operation": {
            "type": "string",
            "enum": [
              "list",
              "read",
              "create",
              "update",
              "delete",
              "update_many",
              "delete_many"
            ]
          },
          "payload": {
            "type": "object",
            "description": "Operation-specific values; accepts list filters/sort, unique id and/or published field values"
          }
        }
      },
      "MediaMetadata": {
        "type": "object",
        "required": [
          "reference",
          "name",
          "mime",
          "bytes",
          "sha256",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "reference": {
            "type": "string",
            "pattern": "^m_[a-f0-9]{32}$"
          },
          "name": {
            "type": "string"
          },
          "mime": {
            "type": "string"
          },
          "bytes": {
            "type": "integer",
            "minimum": 0
          },
          "sha256": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          }
        }
      }
    }
  },
  "x-zerald-partner-fixture": {
    "path": "/protocol/examples/shell-v1-partner-simulator.py",
    "language": "Python 3 standard library",
    "mode": "local loopback provider and independent consumer",
    "test_authority": "fixture bearer + in-memory grant scopes only (not ZeRaLD grants)",
    "production_partner_identity": false,
    "real_partner_interoperability_accepted": false,
    "fixture_service_ids": {
      "database.resource": 101,
      "media.store": 202
    },
    "local_run": "python3 shell-v1-partner-simulator.py --port 0 --test-token local-fixture-token"
  }
}
