{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/FileSchema",
  "title": "FileSchema",
  "properties": {
    "source_id": {
      "type": "string",
      "title": "Source Id",
      "description": "Deprecated: Use `folder_id` field instead. The unique identifier of the source associated with the document.",
      "deprecated": true
    },
    "file_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "File Name",
      "description": "The name of the file."
    },
    "original_file_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Original File Name",
      "description": "The original name of the file as uploaded."
    },
    "file_path": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "File Path",
      "description": "The path to the file."
    },
    "file_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "File Type",
      "description": "The type of the file (MIME type)."
    },
    "file_size": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "File Size",
      "description": "The size of the file in bytes."
    },
    "file_creation_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "File Creation Date",
      "description": "The creation date of the file."
    },
    "file_last_modified_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "File Last Modified Date",
      "description": "The last modified date of the file."
    },
    "processing_status": {
      "$ref": "#/components/schemas/FileProcessingStatus",
      "description": "The current processing status of the file (e.g. pending, parsing, embedding, completed, error).",
      "default": "pending"
    },
    "error_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Error Message",
      "description": "Optional error message if the file failed processing."
    },
    "total_chunks": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Total Chunks",
      "description": "Total number of chunks for the file."
    },
    "chunks_embedded": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Chunks Embedded",
      "description": "Number of chunks that have been embedded."
    },
    "content": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Content",
      "description": "Optional full-text content of the file; only populated on demand due to its size."
    },
    "id": {
      "type": "string",
      "title": "Id",
      "description": "Human-readable identifier for this file in the file"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "source_id",
    "id"
  ],
  "description": "File with human-readable ID for agent file"
}