All tools
ToolRead

Get library file

get_library_file

Use when you already have a library file id and need its metadata plus bounded extracted text.

When to use it

Use when you already have a library file id and need its metadata plus bounded extracted text. For binary image, audio, or video bytes, follow with get_library_media.

Typical workflow

Search chunks, read only the precise chunk or bounded text needed, cite ids.

What it returns

Source text, chunks, snippets, ids, and citation-ready context.

Avoid using it when

Prefer search_library mode chunks and get_library_file_chunk for long PDFs, filings, transcripts, imports, or precise citations.

Advanced input contract

Agent hosts use this JSON Schema to validate the exact input shape.

View full registry notes

Read one uploaded, imported, RSS, email, or text-note library source by id. Returns metadata plus bounded extracted text; prefer chunk tools for long sources when precise citations are needed. Use when: Use when you already have a library file id and need its metadata plus bounded extracted text. For binary image, audio, or video bytes, follow with get_library_media. Avoid when: Prefer search_library mode chunks and get_library_file_chunk for long PDFs, filings, transcripts, imports, or precise citations.

View JSON Schema
{
  "type": "object",
  "properties": {
    "fileId": {
      "type": "string",
      "format": "uuid"
    },
    "maxCharacters": {
      "type": "integer",
      "minimum": 500,
      "maximum": 100000,
      "default": 8000
    }
  },
  "required": [
    "fileId"
  ],
  "additionalProperties": false
}

Useful next tools