{
  "lexicon": 1,
  "id": "sh.tangled.repo.blob",
  "defs": {
    "main": {
      "type": "query",
      "parameters": {
        "type": "params",
        "required": [
          "repo",
          "ref",
          "path"
        ],
        "properties": {
          "repo": {
            "type": "string",
            "format": "at-uri",
            "description": "AT-URI of the sh.tangled.repo record"
          },
          "ref": {
            "type": "string",
            "description": "Git reference (branch, tag, or commit SHA)"
          },
          "path": {
            "type": "string",
            "description": "Path to the file within the repository"
          },
          "raw": {
            "type": "boolean",
            "description": "Return raw file content instead of JSON response",
            "default": false
          }
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "type": "object",
          "required": [
            "ref",
            "path"
          ],
          "properties": {
            "ref": {
              "type": "string",
              "description": "The git reference used"
            },
            "path": {
              "type": "string",
              "description": "The file path"
            },
            "content": {
              "type": "string",
              "description": "File content (base64 encoded for binary files)"
            },
            "encoding": {
              "type": "string",
              "description": "Content encoding",
              "enum": [
                "utf-8",
                "base64"
              ]
            },
            "size": {
              "type": "integer",
              "description": "File size in bytes"
            },
            "isBinary": {
              "type": "boolean",
              "description": "Whether the file is binary"
            },
            "mimeType": {
              "type": "string",
              "description": "MIME type of the file"
            },
            "submodule": {
              "type": "ref",
              "ref": "#submodule",
              "description": "Submodule information if path is a submodule"
            },
            "lastCommit": {
              "type": "ref",
              "ref": "#lastCommit"
            },
            "fileTooLarge": {
              "type": "boolean"
            }
          }
        }
      },
      "errors": [
        {
          "name": "RepoNotFound",
          "description": "Repository not found or access denied"
        },
        {
          "name": "RefNotFound",
          "description": "Git reference not found"
        },
        {
          "name": "FileNotFound",
          "description": "File not found at the specified path"
        },
        {
          "name": "InvalidRequest",
          "description": "Invalid request parameters"
        }
      ]
    },
    "lastCommit": {
      "type": "object",
      "required": [
        "hash",
        "message",
        "when"
      ],
      "properties": {
        "hash": {
          "type": "string",
          "description": "Commit hash"
        },
        "message": {
          "type": "string",
          "description": "Commit message"
        },
        "author": {
          "type": "ref",
          "ref": "#signature"
        },
        "when": {
          "type": "string",
          "format": "datetime",
          "description": "Commit timestamp"
        }
      }
    },
    "signature": {
      "type": "object",
      "required": [
        "name",
        "email",
        "when"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "Author name"
        },
        "email": {
          "type": "string",
          "description": "Author email"
        },
        "when": {
          "type": "string",
          "format": "datetime",
          "description": "Author timestamp"
        }
      }
    },
    "submodule": {
      "type": "object",
      "required": [
        "name",
        "url"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "Submodule name"
        },
        "url": {
          "type": "string",
          "description": "Submodule repository URL"
        },
        "branch": {
          "type": "string",
          "description": "Branch to track in the submodule"
        }
      }
    }
  }
}
