{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "docx",
        "pdf",
        "pptx",
        "xlsx",
        "artifact"
      ],
      "description": "docx → Word (+ PDF); pdf → only the PDF; pptx → PowerPoint (+ PDF); xlsx → Excel (+ PDF); artifact → web page. If the user didn't say, leave it out and Doconda decides from the prompt."
    },
    "prompt": {
      "type": "string",
      "description": "What to write, in the user's words (topic, audience, length, tone). Formatting wishes too, e.g. 'blue centred headings, with a cover page'."
    },
    "markdown": {
      "type": "string",
      "description": "Content already written, in Markdown (instead of prompt). For an artifact, the content its page shows."
    },
    "style": {
      "type": "string",
      "description": "Optional: the look in plain words, e.g. 'blue centred headings, Lora font, page numbers, table of contents'."
    },
    "name": {
      "type": "string",
      "description": "Optional: a name to find it later, e.g. 'Contrato piso Malasaña'. It also names the files."
    },
    "source_file_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Uploaded files (upload_file) or documents already made (their id, from list_documents): documents to base the text on (up to 5, with prompt) and pictures to put in the document (up to 10; with markdown, refer to them as ![caption](img:1), the first picture)."
    },
    "data": {
      "type": "string",
      "enum": [
        "shared",
        "local"
      ],
      "description": "Artifacts only. shared (default): everyone with the link sees the same data (polls, team lists). local: each visitor keeps their own in their browser (calculators, personal checklists). With retention none, only local."
    },
    "retention": {
      "type": "string",
      "enum": [
        "none",
        "1d",
        "7d",
        "30d",
        "90d"
      ],
      "description": "Optional: how long Doconda keeps it once finished (none = 15 minutes). Without it, the project's retention (30 days unless changed). The user should save the file before then."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "A public URL to download the file from."
    },
    "content_base64": {
      "type": "string",
      "description": "The file's bytes in base64 (for small files)."
    },
    "filename": {
      "type": "string",
      "description": "Its name with extension, e.g. contract.docx. Needed with content_base64."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "file_id": {
      "type": "string",
      "description": "From upload_file, or the id of a document Doconda made (list_documents)."
    }
  },
  "required": [
    "file_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "file_id": {
      "type": "string",
      "description": "From upload_file, or the id of a document Doconda made (list_documents)."
    },
    "instructions": {
      "type": "string",
      "description": "What to change, in the user's words."
    }
  },
  "required": [
    "file_id",
    "instructions"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "How many, 1–100 (default 20)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "document_id": {
      "type": "string",
      "description": "doc_…"
    }
  },
  "required": [
    "document_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "document_id": {
      "type": "string",
      "description": "doc_…"
    }
  },
  "required": [
    "document_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "document_id": {
      "type": "string",
      "description": "The artifact's doc_… id."
    },
    "collection": {
      "type": "string",
      "description": "Optional: one collection's records instead of the list of collections."
    }
  },
  "required": [
    "document_id"
  ],
  "additionalProperties": false
}