llama-cloud 0.1.5__py3-none-any.whl → 0.1.6__py3-none-any.whl

llama_cloud/types/eval_dataset.py

@@ -21,8 +21,8 @@ class EvalDataset(pydantic.BaseModel):
     """
 
     id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(description="Creation datetime")
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(description="Update datetime")
     name: str = pydantic.Field(description="The name of the EvalDataset.")
     project_id: str
 

llama_cloud/types/eval_dataset_job_record.py

@@ -28,21 +28,27 @@ class EvalDatasetJobRecord(pydantic.BaseModel):
     partitions: typing.Dict[str, str] = pydantic.Field(
         description="The partitions for this execution. Used for determining where to save job output."
     )
-    parameters: typing.Optional[EvalDatasetJobParams]
-    session_id: typing.Optional[str]
-    correlation_id: typing.Optional[str]
-    parent_job_execution_id: typing.Optional[str]
-    user_id: typing.Optional[str]
+    parameters: typing.Optional[EvalDatasetJobParams] = pydantic.Field(
+        description="Additional input parameters for the eval execution."
+    )
+    session_id: typing.Optional[str] = pydantic.Field(
+        description="The upstream request ID that created this job. Used for tracking the job across services."
+    )
+    correlation_id: typing.Optional[str] = pydantic.Field(
+        description="The correlation ID for this job. Used for tracking the job across services."
+    )
+    parent_job_execution_id: typing.Optional[str] = pydantic.Field(description="The ID of the parent job execution.")
+    user_id: typing.Optional[str] = pydantic.Field(description="The ID of the user that created this job")
     created_at: typing.Optional[dt.datetime] = pydantic.Field(description="Creation datetime")
     id: typing.Optional[str] = pydantic.Field(description="Unique identifier")
     status: StatusEnum
     error_code: typing.Optional[str]
     error_message: typing.Optional[str]
-    attempts: typing.Optional[int]
+    attempts: typing.Optional[int] = pydantic.Field(description="The number of times this job has been attempted")
     started_at: typing.Optional[dt.datetime]
     ended_at: typing.Optional[dt.datetime]
     updated_at: typing.Optional[dt.datetime] = pydantic.Field(description="Update datetime")
-    data: typing.Optional[Base]
+    data: typing.Optional[Base] = pydantic.Field(description="Additional metadata for the job execution.")
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

llama_cloud/types/eval_execution_params_override.py

@@ -20,8 +20,12 @@ class EvalExecutionParamsOverride(pydantic.BaseModel):
     Schema for the params override for an eval execution.
     """
 
-    llm_model: typing.Optional[SupportedLlmModelNames]
-    qa_prompt_tmpl: typing.Optional[str]
+    llm_model: typing.Optional[SupportedLlmModelNames] = pydantic.Field(
+        description="The LLM model to use within eval execution."
+    )
+    qa_prompt_tmpl: typing.Optional[str] = pydantic.Field(
+        description="The template to use for the question answering prompt."
+    )
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

llama_cloud/types/eval_question.py

@@ -16,8 +16,8 @@ except ImportError:
 
 class EvalQuestion(pydantic.BaseModel):
     id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(description="Creation datetime")
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(description="Update datetime")
     content: str = pydantic.Field(description="The content of the question.")
     eval_dataset_id: str
     eval_dataset_index: int = pydantic.Field(

llama_cloud/types/extraction_result.py

@@ -22,8 +22,8 @@ class ExtractionResult(pydantic.BaseModel):
     """
 
     id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(description="Creation datetime")
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(description="Update datetime")
     schema_id: str = pydantic.Field(description="The id of the schema")
     data: typing.Dict[str, typing.Optional[ExtractionResultDataValue]] = pydantic.Field(
         description="The data extracted from the file"

llama_cloud/types/extraction_schema.py

@@ -21,11 +21,13 @@ class ExtractionSchema(pydantic.BaseModel):
     """
 
     id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(description="Creation datetime")
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(description="Update datetime")
     name: str = pydantic.Field(description="The name of the extraction schema")
     project_id: str = pydantic.Field(description="The ID of the project that the extraction schema belongs to")
-    data_schema: typing.Optional[typing.Dict[str, typing.Optional[ExtractionSchemaDataSchemaValue]]]
+    data_schema: typing.Optional[typing.Dict[str, typing.Optional[ExtractionSchemaDataSchemaValue]]] = pydantic.Field(
+        description="The schema of the data"
+    )
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

llama_cloud/types/file.py

@@ -4,6 +4,7 @@ import datetime as dt
 import typing
 
 from ..core.datetime_utils import serialize_datetime
+from .file_permission_info_value import FilePermissionInfoValue
 from .file_resource_info_value import FileResourceInfoValue
 
 try:
@@ -21,15 +22,22 @@ class File(pydantic.BaseModel):
     """
 
     id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(description="Creation datetime")
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(description="Update datetime")
     name: str
-    file_size: typing.Optional[int]
-    file_type: typing.Optional[str]
+    file_size: typing.Optional[int] = pydantic.Field(description="Size of the file in bytes")
+    file_type: typing.Optional[str] = pydantic.Field(description="File type (e.g. pdf, docx, etc.)")
     project_id: str = pydantic.Field(description="The ID of the project that the file belongs to")
-    last_modified_at: typing.Optional[dt.datetime]
-    resource_info: typing.Optional[typing.Dict[str, typing.Optional[FileResourceInfoValue]]]
-    data_source_id: typing.Optional[str]
+    last_modified_at: typing.Optional[dt.datetime] = pydantic.Field(description="The last modified time of the file")
+    resource_info: typing.Optional[typing.Dict[str, typing.Optional[FileResourceInfoValue]]] = pydantic.Field(
+        description="Resource information for the file"
+    )
+    permission_info: typing.Optional[typing.Dict[str, typing.Optional[FilePermissionInfoValue]]] = pydantic.Field(
+        description="Permission information for the file"
+    )
+    data_source_id: typing.Optional[str] = pydantic.Field(
+        description="The ID of the data source that the file belongs to"
+    )
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

llama_cloud/types/file_permission_info_value.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+FilePermissionInfoValue = typing.Union[typing.Dict[str, typing.Any], typing.List[typing.Any], str, int, float, bool]

llama_cloud/types/filter_operator.py

@@ -36,7 +36,7 @@ class FilterOperator(str, enum.Enum):
         in_: typing.Callable[[], T_Result],
         nin: typing.Callable[[], T_Result],
         any: typing.Callable[[], T_Result],
-        all: typing.Callable[[], T_Result],
+        all_: typing.Callable[[], T_Result],
         text_match: typing.Callable[[], T_Result],
         contains: typing.Callable[[], T_Result],
         is_empty: typing.Callable[[], T_Result],
@@ -60,7 +60,7 @@ class FilterOperator(str, enum.Enum):
         if self is FilterOperator.ANY:
             return any()
         if self is FilterOperator.ALL:
-            return all()
+            return all_()
         if self is FilterOperator.TEXT_MATCH:
             return text_match()
         if self is FilterOperator.CONTAINS:

llama_cloud/types/gemini_embedding.py

@@ -17,12 +17,16 @@ except ImportError:
 class GeminiEmbedding(pydantic.BaseModel):
     model_name: typing.Optional[str] = pydantic.Field(description="The modelId of the Gemini model to use.")
     embed_batch_size: typing.Optional[int] = pydantic.Field(description="The batch size for embedding calls.")
-    num_workers: typing.Optional[int]
-    title: typing.Optional[str]
-    task_type: typing.Optional[str]
-    api_key: typing.Optional[str]
-    api_base: typing.Optional[str]
-    transport: typing.Optional[str]
+    num_workers: typing.Optional[int] = pydantic.Field(
+        description="The number of workers to use for async embedding calls."
+    )
+    title: typing.Optional[str] = pydantic.Field(
+        description="Title is only applicable for retrieval_document tasks, and is used to represent a document title. For other tasks, title is invalid."
+    )
+    task_type: typing.Optional[str] = pydantic.Field(description="The task for embedding model.")
+    api_key: typing.Optional[str] = pydantic.Field(description="API key to access the model. Defaults to None.")
+    api_base: typing.Optional[str] = pydantic.Field(description="API base to access the model. Defaults to None.")
+    transport: typing.Optional[str] = pydantic.Field(description="Transport to access the model. Defaults to None.")
     class_name: typing.Optional[str]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/hugging_face_inference_api_embedding.py

@@ -4,8 +4,8 @@ import datetime as dt
 import typing
 
 from ..core.datetime_utils import serialize_datetime
-from .hugging_face_inference_api_embedding_token import HuggingFaceInferenceApiEmbeddingToken
 from .pooling import Pooling
+from .token import Token
 
 try:
     import pydantic
@@ -17,19 +17,35 @@ except ImportError:
 
 
 class HuggingFaceInferenceApiEmbedding(pydantic.BaseModel):
-    model_name: typing.Optional[str]
+    model_name: typing.Optional[str] = pydantic.Field(
+        description="Hugging Face model name. If None, the task will be used."
+    )
     embed_batch_size: typing.Optional[int] = pydantic.Field(description="The batch size for embedding calls.")
-    num_workers: typing.Optional[int]
-    pooling: typing.Optional[Pooling]
-    query_instruction: typing.Optional[str]
-    text_instruction: typing.Optional[str]
-    token: typing.Optional[HuggingFaceInferenceApiEmbeddingToken] = pydantic.Field(
+    num_workers: typing.Optional[int] = pydantic.Field(
+        description="The number of workers to use for async embedding calls."
+    )
+    pooling: typing.Optional[Pooling] = pydantic.Field(
+        description="Pooling strategy. If None, the model's default pooling is used."
+    )
+    query_instruction: typing.Optional[str] = pydantic.Field(
+        description="Instruction to prepend during query embedding."
+    )
+    text_instruction: typing.Optional[str] = pydantic.Field(description="Instruction to prepend during text embedding.")
+    token: typing.Optional[Token] = pydantic.Field(
         description="Hugging Face token. Will default to the locally saved token. Pass token=False if you don’t want to send your token to the server."
     )
-    timeout: typing.Optional[float]
-    headers: typing.Optional[typing.Dict[str, typing.Optional[str]]]
-    cookies: typing.Optional[typing.Dict[str, typing.Optional[str]]]
-    task: typing.Optional[str]
+    timeout: typing.Optional[float] = pydantic.Field(
+        description="The maximum number of seconds to wait for a response from the server. Loading a new model in Inference API can take up to several minutes. Defaults to None, meaning it will loop until the server is available."
+    )
+    headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = pydantic.Field(
+        description="Additional headers to send to the server. By default only the authorization and user-agent headers are sent. Values in this dictionary will override the default values."
+    )
+    cookies: typing.Optional[typing.Dict[str, typing.Optional[str]]] = pydantic.Field(
+        description="Additional cookies to send to the server."
+    )
+    task: typing.Optional[str] = pydantic.Field(
+        description="Optional task to pick Hugging Face's recommended model, used when model_name is left as default of None."
+    )
     class_name: typing.Optional[str]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/input_message.py

@@ -23,7 +23,9 @@ class InputMessage(pydantic.BaseModel):
     id: str = pydantic.Field(description="ID of the message, if any. a UUID.")
     role: MessageRole
     content: str
-    data: typing.Optional[typing.Dict[str, typing.Any]]
+    data: typing.Optional[typing.Dict[str, typing.Any]] = pydantic.Field(
+        description="Additional data to be stored with the message."
+    )
     class_name: typing.Optional[str]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/job_name_mapping.py

@@ -18,6 +18,7 @@ class JobNameMapping(str, enum.Enum):
     PARSE = "PARSE"
     TRANSFORM = "TRANSFORM"
     INGESTION = "INGESTION"
+    METADATA_UPDATE = "METADATA_UPDATE"
 
     def visit(
         self,
@@ -28,6 +29,7 @@ class JobNameMapping(str, enum.Enum):
         parse: typing.Callable[[], T_Result],
         transform: typing.Callable[[], T_Result],
         ingestion: typing.Callable[[], T_Result],
+        metadata_update: typing.Callable[[], T_Result],
     ) -> T_Result:
         if self is JobNameMapping.MANAGED_INGESTION:
             return managed_ingestion()
@@ -43,3 +45,5 @@ class JobNameMapping(str, enum.Enum):
             return transform()
         if self is JobNameMapping.INGESTION:
             return ingestion()
+        if self is JobNameMapping.METADATA_UPDATE:
+            return metadata_update()

llama_cloud/types/llama_parse_parameters.py

@@ -27,15 +27,22 @@ class LlamaParseParameters(pydantic.BaseModel):
     disable_reconstruction: typing.Optional[bool]
     disable_image_extraction: typing.Optional[bool]
     invalidate_cache: typing.Optional[bool]
+    output_pdf_of_document: typing.Optional[bool]
     do_not_cache: typing.Optional[bool]
     fast_mode: typing.Optional[bool]
     skip_diagonal_text: typing.Optional[bool]
     gpt_4_o_mode: typing.Optional[bool] = pydantic.Field(alias="gpt4o_mode")
     gpt_4_o_api_key: typing.Optional[str] = pydantic.Field(alias="gpt4o_api_key")
     do_not_unroll_columns: typing.Optional[bool]
+    html_make_all_elements_visible: typing.Optional[bool]
+    html_remove_fixed_elements: typing.Optional[bool]
     guess_xlsx_sheet_name: typing.Optional[bool]
     page_separator: typing.Optional[str]
     bounding_box: typing.Optional[str]
+    bbox_top: typing.Optional[float]
+    bbox_right: typing.Optional[float]
+    bbox_bottom: typing.Optional[float]
+    bbox_left: typing.Optional[float]
     target_pages: typing.Optional[str]
     use_vendor_multimodal_model: typing.Optional[bool]
     vendor_multimodal_model_name: typing.Optional[str]
@@ -61,6 +68,10 @@ class LlamaParseParameters(pydantic.BaseModel):
     auto_mode_trigger_on_text_in_page: typing.Optional[str]
     auto_mode_trigger_on_table_in_page: typing.Optional[bool]
     auto_mode_trigger_on_image_in_page: typing.Optional[bool]
+    structured_output: typing.Optional[bool]
+    structured_output_json_schema: typing.Optional[str]
+    structured_output_json_schema_name: typing.Optional[str]
+    max_pages: typing.Optional[int]
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

llama_cloud/types/llm.py

@@ -34,7 +34,7 @@ class Llm(pydantic.BaseModel):
     """
 
     callback_manager: typing.Optional[typing.Any]
-    system_prompt: typing.Optional[str]
+    system_prompt: typing.Optional[str] = pydantic.Field(description="System prompt for LLM calls.")
     messages_to_prompt: typing.Optional[str] = pydantic.Field(
         description="Function to convert a list of messages to an LLM prompt."
     )
@@ -43,7 +43,9 @@ class Llm(pydantic.BaseModel):
     )
     output_parser: typing.Optional[typing.Any]
     pydantic_program_mode: typing.Optional[PydanticProgramMode]
-    query_wrapper_prompt: typing.Optional[BasePromptTemplate]
+    query_wrapper_prompt: typing.Optional[BasePromptTemplate] = pydantic.Field(
+        description="Query wrapper prompt for LLM calls."
+    )
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

llama_cloud/types/llm_parameters.py

@@ -19,8 +19,11 @@ class LlmParameters(pydantic.BaseModel):
     model_name: typing.Optional[SupportedLlmModelNames] = pydantic.Field(
         description="The name of the model to use for LLM completions."
     )
-    system_prompt: typing.Optional[str]
-    temperature: typing.Optional[float]
+    system_prompt: typing.Optional[str] = pydantic.Field(description="The system prompt to use for the completion.")
+    temperature: typing.Optional[float] = pydantic.Field(description="The temperature value for the model.")
+    use_chain_of_thought_reasoning: typing.Optional[bool] = pydantic.Field(
+        description="Whether to use chain of thought reasoning."
+    )
     class_name: typing.Optional[str]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/local_eval.py

@@ -21,17 +21,19 @@ class LocalEval(pydantic.BaseModel):
     Output of an BaseEvaluator.
     """
 
-    query: typing.Optional[str]
-    contexts: typing.Optional[typing.List[str]]
-    response: typing.Optional[str]
-    passing: typing.Optional[bool]
-    feedback: typing.Optional[str]
-    score: typing.Optional[float]
-    pairwise_source: typing.Optional[str]
+    query: typing.Optional[str] = pydantic.Field(description="Query string")
+    contexts: typing.Optional[typing.List[str]] = pydantic.Field(description="Context strings")
+    response: typing.Optional[str] = pydantic.Field(description="Response string")
+    passing: typing.Optional[bool] = pydantic.Field(description="Binary evaluation result (passing or not)")
+    feedback: typing.Optional[str] = pydantic.Field(description="Feedback or reasoning for the response")
+    score: typing.Optional[float] = pydantic.Field(description="Score for the response")
+    pairwise_source: typing.Optional[str] = pydantic.Field(
+        description="Used only for pairwise and specifies whether it is from original order of presented answers or flipped order"
+    )
     invalid_result: typing.Optional[bool] = pydantic.Field(
         description="Whether the evaluation result is an invalid one."
     )
-    invalid_reason: typing.Optional[str]
+    invalid_reason: typing.Optional[str] = pydantic.Field(description="Reason for invalid evaluation.")
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

llama_cloud/types/local_eval_results.py

@@ -21,7 +21,7 @@ class LocalEvalResults(pydantic.BaseModel):
     """
 
     project_id: str = pydantic.Field(description="The ID of the project.")
-    eval_set_id: typing.Optional[str]
+    eval_set_id: typing.Optional[str] = pydantic.Field(description="The ID of the local eval result set.")
     app_name: str = pydantic.Field(description="The name of the app.")
     eval_name: str = pydantic.Field(description="The name of the eval.")
     result: LocalEval = pydantic.Field(description="The eval results.")

llama_cloud/types/managed_ingestion_status_response.py

@@ -17,10 +17,12 @@ except ImportError:
 
 
 class ManagedIngestionStatusResponse(pydantic.BaseModel):
-    job_id: typing.Optional[str]
-    deployment_date: typing.Optional[dt.datetime]
+    job_id: typing.Optional[str] = pydantic.Field(description="ID of the latest job.")
+    deployment_date: typing.Optional[dt.datetime] = pydantic.Field(description="Date of the deployment.")
     status: ManagedIngestionStatus = pydantic.Field(description="Status of the ingestion.")
-    error: typing.Optional[typing.List[IngestionErrorResponse]]
+    error: typing.Optional[typing.List[IngestionErrorResponse]] = pydantic.Field(
+        description="List of errors that occurred during ingestion."
+    )
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

llama_cloud/types/markdown_element_node_parser.py

@@ -29,12 +29,14 @@ class MarkdownElementNodeParser(pydantic.BaseModel):
     )
     include_prev_next_rel: typing.Optional[bool] = pydantic.Field(description="Include prev/next node relationships.")
     callback_manager: typing.Optional[typing.Any]
-    id_func: typing.Optional[str]
-    llm: typing.Optional[Llm]
+    id_func: typing.Optional[str] = pydantic.Field(description="Function to generate node IDs.")
+    llm: typing.Optional[Llm] = pydantic.Field(description="LLM model to use for summarization.")
     summary_query_str: typing.Optional[str] = pydantic.Field(description="Query string to use for summarization.")
     num_workers: typing.Optional[int] = pydantic.Field(description="Num of workers for async jobs.")
     show_progress: typing.Optional[bool] = pydantic.Field(description="Whether to show progress.")
-    nested_node_parser: typing.Optional[NodeParser]
+    nested_node_parser: typing.Optional[NodeParser] = pydantic.Field(
+        description="Other types of node parsers to handle some types of nodes."
+    )
     class_name: typing.Optional[str]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/markdown_node_parser.py

@@ -31,7 +31,7 @@ class MarkdownNodeParser(pydantic.BaseModel):
     )
     include_prev_next_rel: typing.Optional[bool] = pydantic.Field(description="Include prev/next node relationships.")
     callback_manager: typing.Optional[typing.Any]
-    id_func: typing.Optional[str]
+    id_func: typing.Optional[str] = pydantic.Field(description="Function to generate node IDs.")
     class_name: typing.Optional[str]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/metadata_filter.py

@@ -5,7 +5,7 @@ import typing
 
 from ..core.datetime_utils import serialize_datetime
 from .filter_operator import FilterOperator
-from .metadata_filter_value import MetadataFilterValue
+from .value import Value
 
 try:
     import pydantic
@@ -27,7 +27,7 @@ class MetadataFilter(pydantic.BaseModel):
     """
 
     key: str
-    value: typing.Optional[MetadataFilterValue]
+    value: typing.Optional[Value]
     operator: typing.Optional[FilterOperator]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/metric_result.py

@@ -15,9 +15,9 @@ except ImportError:
 
 
 class MetricResult(pydantic.BaseModel):
-    passing: typing.Optional[bool]
-    score: typing.Optional[float]
-    feedback: typing.Optional[str]
+    passing: typing.Optional[bool] = pydantic.Field(description="Whether the metric passed or not.")
+    score: typing.Optional[float] = pydantic.Field(description="The score for the metric.")
+    feedback: typing.Optional[str] = pydantic.Field(description="The reasoning for the metric.")
 
     def json(self, **kwargs: typing.Any) -> str:
         kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}

llama_cloud/types/node_parser.py

@@ -24,7 +24,7 @@ class NodeParser(pydantic.BaseModel):
     )
     include_prev_next_rel: typing.Optional[bool] = pydantic.Field(description="Include prev/next node relationships.")
     callback_manager: typing.Optional[typing.Any]
-    id_func: typing.Optional[str]
+    id_func: typing.Optional[str] = pydantic.Field(description="Function to generate node IDs.")
     class_name: typing.Optional[str]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/open_ai_embedding.py

@@ -17,20 +17,26 @@ except ImportError:
 class OpenAiEmbedding(pydantic.BaseModel):
     model_name: typing.Optional[str] = pydantic.Field(description="The name of the OpenAI embedding model.")
     embed_batch_size: typing.Optional[int] = pydantic.Field(description="The batch size for embedding calls.")
-    num_workers: typing.Optional[int]
+    num_workers: typing.Optional[int] = pydantic.Field(
+        description="The number of workers to use for async embedding calls."
+    )
     additional_kwargs: typing.Optional[typing.Dict[str, typing.Any]] = pydantic.Field(
         description="Additional kwargs for the OpenAI API."
     )
-    api_key: typing.Optional[str]
-    api_base: typing.Optional[str]
-    api_version: typing.Optional[str]
+    api_key: typing.Optional[str] = pydantic.Field(description="The OpenAI API key.")
+    api_base: typing.Optional[str] = pydantic.Field(description="The base URL for OpenAI API.")
+    api_version: typing.Optional[str] = pydantic.Field(description="The version for OpenAI API.")
     max_retries: typing.Optional[int] = pydantic.Field(description="Maximum number of retries.")
     timeout: typing.Optional[float] = pydantic.Field(description="Timeout for each request.")
-    default_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]]
+    default_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = pydantic.Field(
+        description="The default headers for API requests."
+    )
     reuse_client: typing.Optional[bool] = pydantic.Field(
         description="Reuse the OpenAI client between requests. When doing anything with large volumes of async API calls, setting this to false can improve stability."
     )
-    dimensions: typing.Optional[int]
+    dimensions: typing.Optional[int] = pydantic.Field(
+        description="The number of dimensions on the output embedding vectors. Works only with v3 embedding models."
+    )
     class_name: typing.Optional[str]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/organization.py

@@ -20,8 +20,8 @@ class Organization(pydantic.BaseModel):
     """
 
     id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(description="Creation datetime")
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(description="Update datetime")
     name: str = pydantic.Field(description="A name for the organization.")
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/page_splitter_node_parser.py

@@ -24,8 +24,8 @@ class PageSplitterNodeParser(pydantic.BaseModel):
     )
     include_prev_next_rel: typing.Optional[bool] = pydantic.Field(description="Include prev/next node relationships.")
     callback_manager: typing.Optional[typing.Any]
-    id_func: typing.Optional[str]
-    page_separator: typing.Optional[str]
+    id_func: typing.Optional[str] = pydantic.Field(description="Function to generate node IDs.")
+    page_separator: typing.Optional[str] = pydantic.Field(description="Separator to split text into pages.")
     class_name: typing.Optional[str]
 
     def json(self, **kwargs: typing.Any) -> str:

llama_cloud/types/parsing_job_structured_result.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+from ..core.datetime_utils import serialize_datetime
+
+try:
+    import pydantic
+    if pydantic.__version__.startswith("1."):
+        raise ImportError
+    import pydantic.v1 as pydantic  # type: ignore
+except ImportError:
+    import pydantic  # type: ignore
+
+
+class ParsingJobStructuredResult(pydantic.BaseModel):
+    structured: typing.Any
+    job_metadata: typing.Any
+
+    def json(self, **kwargs: typing.Any) -> str:
+        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
+        return super().json(**kwargs_with_defaults)
+
+    def dict(self, **kwargs: typing.Any) -> typing.Dict[str, typing.Any]:
+        kwargs_with_defaults: typing.Any = {"by_alias": True, "exclude_unset": True, **kwargs}
+        return super().dict(**kwargs_with_defaults)
+
+    class Config:
+        frozen = True
+        smart_union = True
+        json_encoders = {dt.datetime: serialize_datetime}

llama_cloud/types/permission.py

@@ -20,10 +20,10 @@ class Permission(pydantic.BaseModel):
     """
 
     id: str = pydantic.Field(description="Unique identifier")
-    created_at: typing.Optional[dt.datetime]
-    updated_at: typing.Optional[dt.datetime]
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(description="Creation datetime")
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(description="Update datetime")
     name: str = pydantic.Field(description="A name for the permission.")
-    description: typing.Optional[str]
+    description: typing.Optional[str] = pydantic.Field(description="A description for the permission.")
     access: bool = pydantic.Field(description="Whether the permission is granted or not.")
 
     def json(self, **kwargs: typing.Any) -> str: