braintrust 0.3.14__py3-none-any.whl → 0.4.0__py3-none-any.whl

braintrust/_generated_types.py

@@ -6,11 +6,12 @@ Auto-generated file -- do not modify.
 
 from __future__ import annotations
 
-from typing import Any, Literal, Mapping, Optional, Sequence, TypedDict, Union
+from collections.abc import Mapping, Sequence
+from typing import Any, Literal, TypeAlias, TypedDict
 
 from typing_extensions import NotRequired
 
-AclObjectType = Literal[
+AclObjectType: TypeAlias = Literal[
     'organization',
     'project',
     'experiment',
@@ -23,6 +24,9 @@ AclObjectType = Literal[
     'project_log',
     'org_project',
 ]
+"""
+The object type that the ACL applies to
+"""
 
 
 class AISecret(TypedDict):
@@ -30,11 +34,11 @@ class AISecret(TypedDict):
     """
     Unique identifier for the AI secret
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of AI secret creation
     """
-    updated_at: NotRequired[Optional[str]]
+    updated_at: NotRequired[str | None]
     """
     Date of last AI secret update
     """
@@ -46,9 +50,9 @@ class AISecret(TypedDict):
     """
     Name of the AI secret
     """
-    type: NotRequired[Optional[str]]
-    metadata: NotRequired[Optional[Mapping[str, Any]]]
-    preview_secret: NotRequired[Optional[str]]
+    type: NotRequired[str | None]
+    metadata: NotRequired[Mapping[str, Any] | None]
+    preview_secret: NotRequired[str | None]
 
 
 class AnyModelParamsToolChoiceFunction(TypedDict):
@@ -69,7 +73,7 @@ class ApiKey(TypedDict):
     """
     Unique identifier for the api key
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of api key creation
     """
@@ -78,23 +82,23 @@ class ApiKey(TypedDict):
     Name of the api key
     """
     preview_name: str
-    user_id: NotRequired[Optional[str]]
+    user_id: NotRequired[str | None]
     """
     Unique identifier for the user
     """
-    user_email: NotRequired[Optional[str]]
+    user_email: NotRequired[str | None]
     """
     The user's email
     """
-    user_given_name: NotRequired[Optional[str]]
+    user_given_name: NotRequired[str | None]
     """
     Given name of the user
     """
-    user_family_name: NotRequired[Optional[str]]
+    user_family_name: NotRequired[str | None]
     """
     Family name of the user
     """
-    org_id: NotRequired[Optional[str]]
+    org_id: NotRequired[str | None]
     """
     Unique identifier for the organization
     """
@@ -116,15 +120,15 @@ class AsyncScoringControlAsyncScoringControl3(TypedDict):
 class AsyncScoringStateAsyncScoringState(TypedDict):
     status: Literal['enabled']
     token: str
-    function_ids: Sequence
-    skip_logging: NotRequired[Optional[bool]]
+    function_ids: Sequence[Any]
+    skip_logging: NotRequired[bool | None]
 
 
 class AsyncScoringStateAsyncScoringState1(TypedDict):
     status: Literal['disabled']
 
 
-AsyncScoringState = Optional[Union[AsyncScoringStateAsyncScoringState, AsyncScoringStateAsyncScoringState1]]
+AsyncScoringState: TypeAlias = AsyncScoringStateAsyncScoringState | AsyncScoringStateAsyncScoringState1 | None
 
 
 class BraintrustAttachmentReference(TypedDict):
@@ -147,75 +151,75 @@ class BraintrustAttachmentReference(TypedDict):
 
 
 class BraintrustModelParams(TypedDict):
-    use_cache: NotRequired[Optional[bool]]
-    reasoning_enabled: NotRequired[Optional[bool]]
-    reasoning_budget: NotRequired[Optional[float]]
+    use_cache: NotRequired[bool | None]
+    reasoning_enabled: NotRequired[bool | None]
+    reasoning_budget: NotRequired[float | None]
 
 
 class CallEventCallEvent(TypedDict):
-    id: NotRequired[Optional[str]]
+    id: NotRequired[str | None]
     data: str
     event: Literal['text_delta']
 
 
 class CallEventCallEvent1(TypedDict):
-    id: NotRequired[Optional[str]]
+    id: NotRequired[str | None]
     data: str
     event: Literal['reasoning_delta']
 
 
 class CallEventCallEvent2(TypedDict):
-    id: NotRequired[Optional[str]]
+    id: NotRequired[str | None]
     data: str
     event: Literal['json_delta']
 
 
 class CallEventCallEvent3(TypedDict):
-    id: NotRequired[Optional[str]]
+    id: NotRequired[str | None]
     data: str
     event: Literal['progress']
 
 
 class CallEventCallEvent4(TypedDict):
-    id: NotRequired[Optional[str]]
+    id: NotRequired[str | None]
     data: str
     event: Literal['error']
 
 
 class CallEventCallEvent5(TypedDict):
-    id: NotRequired[Optional[str]]
+    id: NotRequired[str | None]
     data: str
     event: Literal['console']
 
 
 class CallEventCallEvent6(TypedDict):
-    id: NotRequired[Optional[str]]
+    id: NotRequired[str | None]
     event: Literal['start']
     data: Literal['']
 
 
 class CallEventCallEvent7(TypedDict):
-    id: NotRequired[Optional[str]]
+    id: NotRequired[str | None]
     event: Literal['done']
     data: Literal['']
 
 
-CallEvent = Union[
-    CallEventCallEvent,
-    CallEventCallEvent1,
-    CallEventCallEvent2,
-    CallEventCallEvent3,
-    CallEventCallEvent4,
-    CallEventCallEvent5,
-    CallEventCallEvent6,
-    CallEventCallEvent7,
-]
+CallEvent: TypeAlias = (
+    CallEventCallEvent
+    | CallEventCallEvent1
+    | CallEventCallEvent2
+    | CallEventCallEvent3
+    | CallEventCallEvent4
+    | CallEventCallEvent5
+    | CallEventCallEvent6
+    | CallEventCallEvent7
+)
 
 
 class ChatCompletionContentPartFileFile(TypedDict):
-    file_data: NotRequired[Optional[str]]
-    filename: NotRequired[Optional[str]]
-    file_id: NotRequired[Optional[str]]
+    file_data: NotRequired[str | None]
+    filename: NotRequired[str | None]
+    file_id: NotRequired[str | None]
 
 
 class ChatCompletionContentPartFileWithTitle(TypedDict):
@@ -225,7 +229,7 @@ class ChatCompletionContentPartFileWithTitle(TypedDict):
 
 class ChatCompletionContentPartImageWithTitleImageUrl(TypedDict):
     url: str
-    detail: NotRequired[Optional[Union[Literal['auto'], Literal['low'], Literal['high']]]]
+    detail: NotRequired[Literal['auto'] | Literal['low'] | Literal['high'] | None]
 
 
 class ChatCompletionContentPartImageWithTitle(TypedDict):
@@ -240,7 +244,7 @@ class ChatCompletionContentPartTextCacheControl(TypedDict):
 class ChatCompletionContentPartText(TypedDict):
     text: str
     type: Literal['text']
-    cache_control: NotRequired[Optional[ChatCompletionContentPartTextCacheControl]]
+    cache_control: NotRequired[ChatCompletionContentPartTextCacheControl | None]
 
 
 class ChatCompletionContentPartTextWithTitleCacheControl(TypedDict):
@@ -250,13 +254,13 @@ class ChatCompletionContentPartTextWithTitleCacheControl(TypedDict):
 class ChatCompletionContentPartTextWithTitle(TypedDict):
     text: str
     type: Literal['text']
-    cache_control: NotRequired[Optional[ChatCompletionContentPartTextWithTitleCacheControl]]
+    cache_control: NotRequired[ChatCompletionContentPartTextWithTitleCacheControl | None]
 
 
 class ChatCompletionMessageParamChatCompletionMessageParam(TypedDict):
-    content: Union[str, Sequence[ChatCompletionContentPartText]]
+    content: str | Sequence[ChatCompletionContentPartText]
     role: Literal['system']
-    name: NotRequired[Optional[str]]
+    name: NotRequired[str | None]
 
 
 class ChatCompletionMessageParamChatCompletionMessageParam2FunctionCall(TypedDict):
@@ -265,31 +269,31 @@ class ChatCompletionMessageParamChatCompletionMessageParam2FunctionCall(TypedDic
 
 
 class ChatCompletionMessageParamChatCompletionMessageParam3(TypedDict):
-    content: Union[str, Sequence[ChatCompletionContentPartText]]
+    content: str | Sequence[ChatCompletionContentPartText]
     role: Literal['tool']
     tool_call_id: str
 
 
 class ChatCompletionMessageParamChatCompletionMessageParam4(TypedDict):
-    content: Optional[str]
+    content: str | None
     name: str
     role: Literal['function']
 
 
 class ChatCompletionMessageParamChatCompletionMessageParam5(TypedDict):
-    content: Union[str, Sequence[ChatCompletionContentPartText]]
+    content: str | Sequence[ChatCompletionContentPartText]
     role: Literal['developer']
-    name: NotRequired[Optional[str]]
+    name: NotRequired[str | None]
 
 
 class ChatCompletionMessageParamChatCompletionMessageParam6(TypedDict):
     role: Literal['model']
-    content: NotRequired[Optional[str]]
+    content: NotRequired[str | None]
 
 
 class ChatCompletionMessageReasoning(TypedDict):
-    id: NotRequired[Optional[str]]
-    content: NotRequired[Optional[str]]
+    id: NotRequired[str | None]
+    content: NotRequired[str | None]
 
 
 class ChatCompletionMessageToolCallFunction(TypedDict):
@@ -304,9 +308,9 @@ class ChatCompletionMessageToolCall(TypedDict):
 
 
 class ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam(TypedDict):
-    content: Union[str, Sequence[ChatCompletionContentPartText]]
+    content: str | Sequence[ChatCompletionContentPartText]
     role: Literal['system']
-    name: NotRequired[Optional[str]]
+    name: NotRequired[str | None]
 
 
 class ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam2FunctionCall(TypedDict):
@@ -316,35 +320,35 @@ class ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam2FunctionC
 
 class ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam2(TypedDict):
     role: Literal['assistant']
-    content: NotRequired[Optional[Union[str, Sequence[ChatCompletionContentPartText]]]]
-    function_call: NotRequired[Optional[ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam2FunctionCall]]
-    name: NotRequired[Optional[str]]
-    tool_calls: NotRequired[Optional[Sequence[ChatCompletionMessageToolCall]]]
-    reasoning: NotRequired[Optional[Sequence[ChatCompletionMessageReasoning]]]
+    content: NotRequired[str | Sequence[ChatCompletionContentPartText] | None]
+    function_call: NotRequired[ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam2FunctionCall | None]
+    name: NotRequired[str | None]
+    tool_calls: NotRequired[Sequence[ChatCompletionMessageToolCall] | None]
+    reasoning: NotRequired[Sequence[ChatCompletionMessageReasoning] | None]
 
 
 class ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam3(TypedDict):
-    content: Union[str, Sequence[ChatCompletionContentPartText]]
+    content: str | Sequence[ChatCompletionContentPartText]
     role: Literal['tool']
     tool_call_id: str
 
 
 class ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam4(TypedDict):
-    content: Optional[str]
+    content: str | None
     name: str
     role: Literal['function']
 
 
 class ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam5(TypedDict):
-    content: Union[str, Sequence[ChatCompletionContentPartText]]
+    content: str | Sequence[ChatCompletionContentPartText]
     role: Literal['developer']
-    name: NotRequired[Optional[str]]
+    name: NotRequired[str | None]
 
 
 class ChatCompletionToolFunction(TypedDict):
     name: str
-    description: NotRequired[Optional[str]]
-    parameters: NotRequired[Optional[Mapping[str, Any]]]
+    description: NotRequired[str | None]
+    parameters: NotRequired[Mapping[str, Any] | None]
 
 
 class ChatCompletionTool(TypedDict):
@@ -353,7 +357,7 @@ class ChatCompletionTool(TypedDict):
 
 
 class CodeBundleRuntimeContext(TypedDict):
-    runtime: Literal['node', 'python', 'browser']
+    runtime: Literal['node', 'python', 'browser', 'quickjs']
     version: str
 
 
@@ -369,7 +373,7 @@ class CodeBundleLocationPosition1(TypedDict):
 class CodeBundleLocation(TypedDict):
     type: Literal['experiment']
     eval_name: str
-    position: Union[CodeBundleLocationPosition, CodeBundleLocationPosition1]
+    position: CodeBundleLocationPosition | CodeBundleLocationPosition1
 
 
 class CodeBundleLocation1(TypedDict):
@@ -379,9 +383,9 @@ class CodeBundleLocation1(TypedDict):
 
 class CodeBundle(TypedDict):
     runtime_context: CodeBundleRuntimeContext
-    location: Union[CodeBundleLocation, CodeBundleLocation1]
+    location: CodeBundleLocation | CodeBundleLocation1
     bundle_id: str
-    preview: NotRequired[Optional[str]]
+    preview: NotRequired[str | None]
     """
     A preview of the code
     """
@@ -400,30 +404,30 @@ class Dataset(TypedDict):
     """
     Name of the dataset. Within a project, dataset names are unique
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the dataset
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of dataset creation
     """
-    deleted_at: NotRequired[Optional[str]]
+    deleted_at: NotRequired[str | None]
     """
     Date of dataset deletion, or null if the dataset is still active
     """
-    user_id: NotRequired[Optional[str]]
+    user_id: NotRequired[str | None]
     """
     Identifies the user who created the dataset
     """
-    metadata: NotRequired[Optional[Mapping[str, Any]]]
+    metadata: NotRequired[Mapping[str, Any] | None]
     """
     User-controlled metadata about the dataset
     """
 
 
 class DatasetEventMetadata(TypedDict):
-    model: NotRequired[Optional[str]]
+    model: NotRequired[str | None]
     """
     The model used for this example
     """
@@ -446,68 +450,80 @@ class EnvVar(TypedDict):
     """
     The name of the environment variable
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of environment variable creation
     """
-    used: NotRequired[Optional[str]]
+    used: NotRequired[str | None]
     """
     Date the environment variable was last used
     """
+    metadata: NotRequired[Mapping[str, Any] | None]
+    """
+    Optional metadata associated with the environment variable when managed via the function secrets API
+    """
+    secret_type: NotRequired[str | None]
+    """
+    Optional classification for the secret (for example, the AI provider name)
+    """
+    secret_category: NotRequired[Literal['env_var', 'ai_provider'] | None]
+    """
+    The category of the secret: env_var for regular environment variables, ai_provider for AI provider API keys
+    """
 
 
 class ExperimentEventMetadata(TypedDict):
-    model: NotRequired[Optional[str]]
+    model: NotRequired[str | None]
     """
     The model used for this example
     """
 
 
 class ExperimentEventMetrics(TypedDict):
-    start: NotRequired[Optional[float]]
+    start: NotRequired[float | None]
     """
     A unix timestamp recording when the section of code which produced the experiment event started
     """
-    end: NotRequired[Optional[float]]
+    end: NotRequired[float | None]
     """
     A unix timestamp recording when the section of code which produced the experiment event finished
     """
-    prompt_tokens: NotRequired[Optional[int]]
+    prompt_tokens: NotRequired[int | None]
     """
     The number of tokens in the prompt used to generate the experiment event (only set if this is an LLM span)
     """
-    completion_tokens: NotRequired[Optional[int]]
+    completion_tokens: NotRequired[int | None]
     """
     The number of tokens in the completion generated by the model (only set if this is an LLM span)
     """
-    tokens: NotRequired[Optional[int]]
+    tokens: NotRequired[int | None]
     """
     The total number of tokens in the input and output of the experiment event.
     """
-    caller_functionname: NotRequired[Optional[Any]]
+    caller_functionname: NotRequired[Any | None]
     """
     This metric is deprecated
     """
-    caller_filename: NotRequired[Optional[Any]]
+    caller_filename: NotRequired[Any | None]
     """
     This metric is deprecated
     """
-    caller_lineno: NotRequired[Optional[Any]]
+    caller_lineno: NotRequired[Any | None]
     """
     This metric is deprecated
     """
 
 
 class ExperimentEventContext(TypedDict):
-    caller_functionname: NotRequired[Optional[str]]
+    caller_functionname: NotRequired[str | None]
     """
     The function in code which created the experiment event
     """
-    caller_filename: NotRequired[Optional[str]]
+    caller_filename: NotRequired[str | None]
     """
     Name of the file in code where the experiment event was created
     """
-    caller_lineno: NotRequired[Optional[int]]
+    caller_lineno: NotRequired[int | None]
     """
     Line of code where the experiment event was created
     """
@@ -518,24 +534,12 @@ class ExtendedSavedFunctionIdExtendedSavedFunctionId(TypedDict):
     id: str
 
 
-class ExtendedSavedFunctionIdExtendedSavedFunctionId1(TypedDict):
-    type: Literal['global']
-    name: str
-
-
 class ExtendedSavedFunctionIdExtendedSavedFunctionId2(TypedDict):
     type: Literal['slug']
     project_id: str
     slug: str
 
 
-ExtendedSavedFunctionId = Union[
-    ExtendedSavedFunctionIdExtendedSavedFunctionId,
-    ExtendedSavedFunctionIdExtendedSavedFunctionId1,
-    ExtendedSavedFunctionIdExtendedSavedFunctionId2,
-]
-
-
 class ExternalAttachmentReference(TypedDict):
     type: Literal['external_attachment']
     """
@@ -555,21 +559,34 @@ class ExternalAttachmentReference(TypedDict):
     """
 
 
+class PreprocessorPreprocessor(TypedDict):
+    type: Literal['function']
+    id: str
+
+
+class PreprocessorPreprocessor2(TypedDict):
+    pass
+
+
+class PreprocessorPreprocessor3(PreprocessorPreprocessor, PreprocessorPreprocessor2):
+    pass
+
+
 class FunctionOrigin(TypedDict):
-    object_type: Optional[AclObjectType]
+    object_type: AclObjectType
     object_id: str
     """
     Id of the object the function is originating from
     """
-    internal: NotRequired[Optional[bool]]
+    internal: NotRequired[bool | None]
     """
     The function exists for internal purposes and should not be displayed in the list of functions.
     """
 
 
 class FunctionFunctionSchema(TypedDict):
-    parameters: NotRequired[Optional[Any]]
-    returns: NotRequired[Optional[Any]]
+    parameters: NotRequired[Any | None]
+    returns: NotRequired[Any | None]
 
 
 class FunctionDataFunctionData(TypedDict):
@@ -581,7 +598,7 @@ class Data(CodeBundle):
 
 
 class FunctionDataFunctionData1DataRuntimeContext(TypedDict):
-    runtime: Literal['node', 'python', 'browser']
+    runtime: Literal['node', 'python', 'browser', 'quickjs']
     version: str
 
 
@@ -589,11 +606,15 @@ class FunctionDataFunctionData1Data(TypedDict):
     type: Literal['inline']
     runtime_context: FunctionDataFunctionData1DataRuntimeContext
     code: str
+    code_hash: NotRequired[str | None]
+    """
+    SHA256 hash of the code, computed at save time
+    """
 
 
 class FunctionDataFunctionData1(TypedDict):
     type: Literal['code']
-    data: Union[Data, FunctionDataFunctionData1Data]
+    data: Data | FunctionDataFunctionData1Data
 
 
 class FunctionDataFunctionData2(TypedDict):
@@ -603,12 +624,7 @@ class FunctionDataFunctionData2(TypedDict):
     parameters: Mapping[str, Any]
 
 
-class FunctionDataFunctionData3(TypedDict):
-    type: Literal['global']
-    name: str
-
-
-FunctionFormat = Literal['llm', 'code', 'global', 'graph']
+FunctionFormat: TypeAlias = Literal['llm', 'code', 'global', 'graph']
 
 
 class FunctionIdFunctionId(TypedDict):
@@ -616,7 +632,7 @@ class FunctionIdFunctionId(TypedDict):
     """
     The ID of the function
     """
-    version: NotRequired[Optional[str]]
+    version: NotRequired[str | None]
     """
     The version of the function
     """
@@ -631,19 +647,12 @@ class FunctionIdFunctionId1(TypedDict):
     """
     The slug of the function
     """
-    version: NotRequired[Optional[str]]
+    version: NotRequired[str | None]
     """
     The version of the function
     """
 
 
-class FunctionIdFunctionId2(TypedDict):
-    global_function: str
-    """
-    The name of the global function. Currently, the global namespace includes the functions in autoevals
-    """
-
-
 class FunctionIdFunctionId3(TypedDict):
     prompt_session_id: str
     """
@@ -653,14 +662,14 @@ class FunctionIdFunctionId3(TypedDict):
     """
     The ID of the function in the prompt session
     """
-    version: NotRequired[Optional[str]]
+    version: NotRequired[str | None]
     """
     The version of the function
     """
 
 
 class FunctionIdFunctionId4InlineContext(TypedDict):
-    runtime: Literal['node', 'python', 'browser']
+    runtime: Literal['node', 'python', 'browser', 'quickjs']
     version: str
 
 
@@ -670,25 +679,27 @@ class FunctionIdFunctionId4(TypedDict):
     """
     The inline code to execute
     """
-    name: NotRequired[Optional[str]]
+    name: NotRequired[str | None]
     """
     The name of the inline code function
     """
 
 
-FunctionIdRef = Mapping[str, Any]
+FunctionIdRef: TypeAlias = Mapping[str, Any]
 
 
-FunctionObjectType = Literal['prompt', 'tool', 'scorer', 'task', 'agent', 'custom_view']
+FunctionObjectType: TypeAlias = Literal[
+    'prompt', 'tool', 'scorer', 'task', 'agent', 'custom_view', 'preprocessor', 'facet'
+]
 
 
-FunctionOutputType = Literal['completion', 'score', 'any']
+FunctionOutputType: TypeAlias = Literal['completion', 'score', 'any']
 
 
-FunctionTypeEnum = Literal['llm', 'scorer', 'task', 'tool', 'custom_view']
+FunctionTypeEnum: TypeAlias = Literal['llm', 'scorer', 'task', 'tool', 'custom_view', 'preprocessor', 'facet']
 
 
-FunctionTypeEnumNullish = Literal['llm', 'scorer', 'task', 'tool', 'custom_view']
+FunctionTypeEnumNullish: TypeAlias = Literal['llm', 'scorer', 'task', 'tool', 'custom_view', 'preprocessor', 'facet']
 
 
 class GitMetadataSettings(TypedDict):
@@ -747,11 +758,11 @@ class GraphNodeGraphNodePosition(TypedDict):
 
 
 class GraphNodeGraphNode(TypedDict):
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     The description of the node
     """
-    position: NotRequired[Optional[GraphNodeGraphNodePosition]]
+    position: NotRequired[GraphNodeGraphNodePosition | None]
     """
     The position of the node
     """
@@ -771,11 +782,11 @@ class GraphNodeGraphNode1Position(TypedDict):
 
 
 class GraphNodeGraphNode1(TypedDict):
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     The description of the node
     """
-    position: NotRequired[Optional[GraphNodeGraphNode1Position]]
+    position: NotRequired[GraphNodeGraphNode1Position | None]
     """
     The position of the node
     """
@@ -797,11 +808,11 @@ class GraphNodeGraphNode2Position(TypedDict):
 
 
 class GraphNodeGraphNode2(TypedDict):
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     The description of the node
     """
-    position: NotRequired[Optional[GraphNodeGraphNode2Position]]
+    position: NotRequired[GraphNodeGraphNode2Position | None]
     """
     The position of the node
     """
@@ -823,16 +834,16 @@ class GraphNodeGraphNode3Position(TypedDict):
 
 
 class GraphNodeGraphNode3(TypedDict):
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     The description of the node
     """
-    position: NotRequired[Optional[GraphNodeGraphNode3Position]]
+    position: NotRequired[GraphNodeGraphNode3Position | None]
     """
     The position of the node
     """
     type: Literal['literal']
-    value: NotRequired[Optional[Any]]
+    value: NotRequired[Any | None]
     """
     A literal value to be returned
     """
@@ -850,11 +861,11 @@ class GraphNodeGraphNode4Position(TypedDict):
 
 
 class GraphNodeGraphNode4(TypedDict):
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     The description of the node
     """
-    position: NotRequired[Optional[GraphNodeGraphNode4Position]]
+    position: NotRequired[GraphNodeGraphNode4Position | None]
     """
     The position of the node
     """
@@ -877,16 +888,16 @@ class GraphNodeGraphNode5Position(TypedDict):
 
 
 class GraphNodeGraphNode5(TypedDict):
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     The description of the node
     """
-    position: NotRequired[Optional[GraphNodeGraphNode5Position]]
+    position: NotRequired[GraphNodeGraphNode5Position | None]
     """
     The position of the node
     """
     type: Literal['gate']
-    condition: NotRequired[Optional[str]]
+    condition: NotRequired[str | None]
     """
     A BTQL expression to be evaluated
     """
@@ -904,11 +915,11 @@ class GraphNodeGraphNode6Position(TypedDict):
 
 
 class GraphNodeGraphNode6(TypedDict):
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     The description of the node
     """
-    position: NotRequired[Optional[GraphNodeGraphNode6Position]]
+    position: NotRequired[GraphNodeGraphNode6Position | None]
     """
     The position of the node
     """
@@ -937,11 +948,11 @@ class Group(TypedDict):
 
     It is forbidden to change the org after creating a group
     """
-    user_id: NotRequired[Optional[str]]
+    user_id: NotRequired[str | None]
     """
     Identifies the user who created the group
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of group creation
     """
@@ -949,19 +960,19 @@ class Group(TypedDict):
     """
     Name of the group
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the group
     """
-    deleted_at: NotRequired[Optional[str]]
+    deleted_at: NotRequired[str | None]
     """
     Date of group deletion, or null if the group is still active
     """
-    member_users: NotRequired[Optional[Sequence[str]]]
+    member_users: NotRequired[Sequence[str] | None]
     """
     Ids of users which belong to this group
     """
-    member_groups: NotRequired[Optional[Sequence[str]]]
+    member_groups: NotRequired[Sequence[str] | None]
     """
     Ids of the groups this group inherits from
 
@@ -969,7 +980,72 @@ class Group(TypedDict):
     """
 
 
-IfExists = Literal['error', 'ignore', 'replace']
+IfExists: TypeAlias = Literal['error', 'ignore', 'replace']
+
+
+class InvokeFunctionInvokeFunction(TypedDict):
+    function_id: str
+    """
+    The ID of the function
+    """
+    version: NotRequired[str | None]
+    """
+    The version of the function
+    """
+
+
+class InvokeFunctionInvokeFunction1(TypedDict):
+    project_name: str
+    """
+    The name of the project containing the function
+    """
+    slug: str
+    """
+    The slug of the function
+    """
+    version: NotRequired[str | None]
+    """
+    The version of the function
+    """
+
+
+class InvokeFunctionInvokeFunction3(TypedDict):
+    prompt_session_id: str
+    """
+    The ID of the prompt session
+    """
+    prompt_session_function_id: str
+    """
+    The ID of the function in the prompt session
+    """
+    version: NotRequired[str | None]
+    """
+    The version of the function
+    """
+
+
+class InvokeFunctionInvokeFunction4InlineContext(TypedDict):
+    runtime: Literal['node', 'python', 'browser', 'quickjs']
+    version: str
+
+
+class InvokeFunctionInvokeFunction4(TypedDict):
+    inline_context: InvokeFunctionInvokeFunction4InlineContext
+    code: str
+    """
+    The inline code to execute
+    """
+    name: NotRequired[str | None]
+    """
+    The name of the inline code function
+    """
+
+
+class InvokeFunctionMcpAuth(TypedDict):
+    oauth_token: NotRequired[str | None]
+    """
+    The OAuth token to use
+    """
 
 
 class InvokeParentInvokeParentRowIds(TypedDict):
@@ -993,20 +1069,58 @@ class InvokeParentInvokeParent(TypedDict):
     """
     The id of the container object you are logging to
     """
-    row_ids: NotRequired[Optional[InvokeParentInvokeParentRowIds]]
+    row_ids: NotRequired[InvokeParentInvokeParentRowIds | None]
     """
     Identifiers for the row to to log a subspan under
     """
-    propagated_event: NotRequired[Optional[Mapping[str, Any]]]
+    propagated_event: NotRequired[Mapping[str, Any] | None]
     """
     Include these properties in every span created under this parent
     """
 
 
-InvokeParent = Union[InvokeParentInvokeParent, str]
+InvokeParent: TypeAlias = InvokeParentInvokeParent | str
+"""
+Options for tracing the function call
+"""
 
 
-MessageRole = Literal['system', 'user', 'assistant', 'function', 'tool', 'model', 'developer']
+class MCPServer(TypedDict):
+    id: str
+    """
+    Unique identifier for the MCP server
+    """
+    project_id: str
+    """
+    Unique identifier for the project that the MCP server belongs under
+    """
+    user_id: NotRequired[str | None]
+    """
+    Identifies the user who created the MCP server
+    """
+    created: NotRequired[str | None]
+    """
+    Date of MCP server creation
+    """
+    deleted_at: NotRequired[str | None]
+    """
+    Date of MCP server deletion, or null if the MCP server is still active
+    """
+    name: str
+    """
+    Name of the MCP server. Within a project, MCP server names are unique
+    """
+    description: NotRequired[str | None]
+    """
+    Textual description of the MCP server
+    """
+    url: str
+    """
+    URL of the MCP server endpoint
+    """
+
+
+MessageRole: TypeAlias = Literal['system', 'user', 'assistant', 'function', 'tool', 'model', 'developer']
 
 
 class ModelParamsModelParamsToolChoiceFunction(TypedDict):
@@ -1023,42 +1137,67 @@ class ModelParamsModelParamsFunctionCall(TypedDict):
 
 
 class ModelParamsModelParams1(TypedDict):
-    use_cache: NotRequired[Optional[bool]]
-    reasoning_enabled: NotRequired[Optional[bool]]
-    reasoning_budget: NotRequired[Optional[float]]
+    use_cache: NotRequired[bool | None]
+    reasoning_enabled: NotRequired[bool | None]
+    reasoning_budget: NotRequired[float | None]
     max_tokens: float
     temperature: float
-    top_p: NotRequired[Optional[float]]
-    top_k: NotRequired[Optional[float]]
-    stop_sequences: NotRequired[Optional[Sequence[str]]]
-    max_tokens_to_sample: NotRequired[Optional[float]]
+    top_p: NotRequired[float | None]
+    top_k: NotRequired[float | None]
+    stop_sequences: NotRequired[Sequence[str] | None]
+    max_tokens_to_sample: NotRequired[float | None]
     """
     This is a legacy parameter that should not be used.
     """
 
 
 class ModelParamsModelParams2(TypedDict):
-    use_cache: NotRequired[Optional[bool]]
-    reasoning_enabled: NotRequired[Optional[bool]]
-    reasoning_budget: NotRequired[Optional[float]]
-    temperature: NotRequired[Optional[float]]
-    maxOutputTokens: NotRequired[Optional[float]]
-    topP: NotRequired[Optional[float]]
-    topK: NotRequired[Optional[float]]
+    use_cache: NotRequired[bool | None]
+    reasoning_enabled: NotRequired[bool | None]
+    reasoning_budget: NotRequired[float | None]
+    temperature: NotRequired[float | None]
+    maxOutputTokens: NotRequired[float | None]
+    topP: NotRequired[float | None]
+    topK: NotRequired[float | None]
 
 
 class ModelParamsModelParams3(TypedDict):
-    use_cache: NotRequired[Optional[bool]]
-    reasoning_enabled: NotRequired[Optional[bool]]
-    reasoning_budget: NotRequired[Optional[float]]
-    temperature: NotRequired[Optional[float]]
-    topK: NotRequired[Optional[float]]
+    use_cache: NotRequired[bool | None]
+    reasoning_enabled: NotRequired[bool | None]
+    reasoning_budget: NotRequired[float | None]
+    temperature: NotRequired[float | None]
+    topK: NotRequired[float | None]
 
 
 class ModelParamsModelParams4(TypedDict):
-    use_cache: NotRequired[Optional[bool]]
-    reasoning_enabled: NotRequired[Optional[bool]]
-    reasoning_budget: NotRequired[Optional[float]]
+    use_cache: NotRequired[bool | None]
+    reasoning_enabled: NotRequired[bool | None]
+    reasoning_budget: NotRequired[float | None]
+
+
+NullableFunctionTypeEnum: TypeAlias = Literal['llm', 'scorer', 'task', 'tool', 'custom_view', 'preprocessor', 'facet']
+"""
+The type of global function. If unspecified, defaults to 'scorer' for backward compatibility.
+"""
+
+
+class NullableSavedFunctionIdNullableSavedFunctionId(TypedDict):
+    type: Literal['function']
+    id: str
+
+
+class NullableSavedFunctionIdNullableSavedFunctionId1(TypedDict):
+    type: Literal['global']
+    name: str
+    function_type: NotRequired[NullableFunctionTypeEnum | None]
+
+
+NullableSavedFunctionId: TypeAlias = (
+    NullableSavedFunctionIdNullableSavedFunctionId | NullableSavedFunctionIdNullableSavedFunctionId1 | None
+)
+"""
+Default preprocessor for this project. When set, functions that use preprocessors will use this instead of their built-in default.
+"""
 
 
 class ObjectReference(TypedDict):
@@ -1074,11 +1213,11 @@ class ObjectReference(TypedDict):
     """
     ID of the original event.
     """
-    _xact_id: NotRequired[Optional[str]]
+    _xact_id: NotRequired[str | None]
     """
     Transaction ID of the original event.
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Created timestamp of the original event. Used to help sort in the UI
     """
@@ -1097,11 +1236,11 @@ class ObjectReferenceNullish(TypedDict):
     """
     ID of the original event.
     """
-    _xact_id: NotRequired[Optional[str]]
+    _xact_id: NotRequired[str | None]
     """
     Transaction ID of the original event.
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Created timestamp of the original event. Used to help sort in the UI
     """
@@ -1116,17 +1255,24 @@ class Organization(TypedDict):
     """
     Name of the organization
     """
-    api_url: NotRequired[Optional[str]]
-    is_universal_api: NotRequired[Optional[bool]]
-    proxy_url: NotRequired[Optional[str]]
-    realtime_url: NotRequired[Optional[str]]
-    created: NotRequired[Optional[str]]
+    api_url: NotRequired[str | None]
+    is_universal_api: NotRequired[bool | None]
+    proxy_url: NotRequired[str | None]
+    realtime_url: NotRequired[str | None]
+    created: NotRequired[str | None]
     """
     Date of organization creation
     """
 
 
-Permission = Literal['create', 'read', 'update', 'delete', 'create_acls', 'read_acls', 'update_acls', 'delete_acls']
+Permission: TypeAlias = Literal[
+    'create', 'read', 'update', 'delete', 'create_acls', 'read_acls', 'update_acls', 'delete_acls'
+]
+"""
+Each permission permits a certain type of operation on an object in the system
+
+Permissions can be assigned to to objects on an individual basis, or grouped into roles
+"""
 
 
 class ProjectAutomationConfigAction(TypedDict):
@@ -1140,6 +1286,25 @@ class ProjectAutomationConfigAction(TypedDict):
     """
 
 
+class ProjectAutomationConfigAction1(TypedDict):
+    type: Literal['slack']
+    """
+    The type of action to take
+    """
+    workspace_id: str
+    """
+    The Slack workspace ID to post to
+    """
+    channel: str
+    """
+    The Slack channel ID to post to
+    """
+    message_template: NotRequired[str | None]
+    """
+    Custom message template for the alert
+    """
+
+
 class ProjectAutomationConfig(TypedDict):
     event_type: Literal['logs']
     """
@@ -1153,7 +1318,7 @@ class ProjectAutomationConfig(TypedDict):
     """
     Perform the triggered action at most once in this interval of seconds
     """
-    action: ProjectAutomationConfigAction
+    action: ProjectAutomationConfigAction | ProjectAutomationConfigAction1
     """
     The action to take when the automation rule is triggered
     """
@@ -1192,11 +1357,11 @@ class ProjectAutomationConfig1(TypedDict):
     """
     The type of automation.
     """
-    export_definition: Union[
-        ProjectAutomationConfig1ExportDefinition,
-        ProjectAutomationConfig1ExportDefinition1,
-        ProjectAutomationConfig1ExportDefinition2,
-    ]
+    export_definition: (
+        ProjectAutomationConfig1ExportDefinition
+        | ProjectAutomationConfig1ExportDefinition1
+        | ProjectAutomationConfig1ExportDefinition2
+    )
     """
     The definition of what to export
     """
@@ -1213,64 +1378,109 @@ class ProjectAutomationConfig1(TypedDict):
     Perform the triggered action at most once in this interval of seconds
     """
     credentials: ProjectAutomationConfig1Credentials
-    batch_size: NotRequired[Optional[float]]
+    batch_size: NotRequired[float | None]
     """
     The number of rows to export in each batch
     """
 
 
+class ProjectAutomationConfig3Action(TypedDict):
+    type: Literal['webhook']
+    """
+    The type of action to take
+    """
+    url: str
+    """
+    The webhook URL to send the request to
+    """
+
+
+class ProjectAutomationConfig3Action1(TypedDict):
+    type: Literal['slack']
+    """
+    The type of action to take
+    """
+    workspace_id: str
+    """
+    The Slack workspace ID to post to
+    """
+    channel: str
+    """
+    The Slack channel ID to post to
+    """
+    message_template: NotRequired[str | None]
+    """
+    Custom message template for the alert
+    """
+
+
+class ProjectAutomationConfig3(TypedDict):
+    event_type: Literal['environment_update']
+    """
+    The type of automation.
+    """
+    environment_filter: NotRequired[Sequence[str] | None]
+    """
+    Optional list of environment slugs to filter by
+    """
+    action: ProjectAutomationConfig3Action | ProjectAutomationConfig3Action1
+    """
+    The action to take when the automation rule is triggered
+    """
+
+
 class ProjectLogsEventMetadata(TypedDict):
-    model: NotRequired[Optional[str]]
+    model: NotRequired[str | None]
     """
     The model used for this example
     """
 
 
 class ProjectLogsEventMetrics(TypedDict):
-    start: NotRequired[Optional[float]]
+    start: NotRequired[float | None]
     """
     A unix timestamp recording when the section of code which produced the project logs event started
     """
-    end: NotRequired[Optional[float]]
+    end: NotRequired[float | None]
     """
     A unix timestamp recording when the section of code which produced the project logs event finished
     """
-    prompt_tokens: NotRequired[Optional[int]]
+    prompt_tokens: NotRequired[int | None]
     """
     The number of tokens in the prompt used to generate the project logs event (only set if this is an LLM span)
     """
-    completion_tokens: NotRequired[Optional[int]]
+    completion_tokens: NotRequired[int | None]
     """
     The number of tokens in the completion generated by the model (only set if this is an LLM span)
     """
-    tokens: NotRequired[Optional[int]]
+    tokens: NotRequired[int | None]
     """
     The total number of tokens in the input and output of the project logs event.
     """
-    caller_functionname: NotRequired[Optional[Any]]
+    caller_functionname: NotRequired[Any | None]
     """
     This metric is deprecated
     """
-    caller_filename: NotRequired[Optional[Any]]
+    caller_filename: NotRequired[Any | None]
     """
     This metric is deprecated
     """
-    caller_lineno: NotRequired[Optional[Any]]
+    caller_lineno: NotRequired[Any | None]
     """
     This metric is deprecated
     """
 
 
 class ProjectLogsEventContext(TypedDict):
-    caller_functionname: NotRequired[Optional[str]]
+    caller_functionname: NotRequired[str | None]
     """
     The function in code which created the project logs event
     """
-    caller_filename: NotRequired[Optional[str]]
+    caller_filename: NotRequired[str | None]
     """
     Name of the file in code where the project logs event was created
     """
-    caller_lineno: NotRequired[Optional[int]]
+    caller_lineno: NotRequired[int | None]
     """
     Line of code where the project logs event was created
     """
@@ -1287,43 +1497,47 @@ class ProjectScoreCategory(TypedDict):
     """
 
 
-ProjectScoreType = Literal['slider', 'categorical', 'weighted', 'minimum', 'maximum', 'online', 'free-form']
+ProjectScoreType: TypeAlias = Literal['slider', 'categorical', 'weighted', 'minimum', 'maximum', 'online', 'free-form']
+"""
+The type of the configured score
+"""
 
 
 class ProjectSettingsSpanFieldOrderItem(TypedDict):
     object_type: str
     column_id: str
     position: str
-    layout: NotRequired[Optional[Union[Literal['full'], Literal['two_column']]]]
+    layout: NotRequired[Literal['full'] | Literal['two_column'] | None]
 
 
 class ProjectSettingsRemoteEvalSource(TypedDict):
     url: str
     name: str
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
 
 
 class ProjectSettings(TypedDict):
-    comparison_key: NotRequired[Optional[str]]
+    comparison_key: NotRequired[str | None]
     """
     The key used to join two experiments (defaults to `input`)
     """
-    baseline_experiment_id: NotRequired[Optional[str]]
+    baseline_experiment_id: NotRequired[str | None]
     """
     The id of the experiment to use as the default baseline for comparisons
     """
-    spanFieldOrder: NotRequired[Optional[Sequence[ProjectSettingsSpanFieldOrderItem]]]
+    spanFieldOrder: NotRequired[Sequence[ProjectSettingsSpanFieldOrderItem] | None]
     """
     The order of the fields to display in the trace view
     """
-    remote_eval_sources: NotRequired[Optional[Sequence[ProjectSettingsRemoteEvalSource]]]
+    remote_eval_sources: NotRequired[Sequence[ProjectSettingsRemoteEvalSource] | None]
     """
     The remote eval sources to use for the project
     """
-    disable_realtime_queries: NotRequired[Optional[bool]]
+    disable_realtime_queries: NotRequired[bool | None]
     """
     If true, disable real-time queries for this project. This can improve query performance for high-volume logs.
     """
+    default_preprocessor: NotRequired[NullableSavedFunctionId | None]
 
 
 class ProjectTag(TypedDict):
@@ -1336,7 +1550,7 @@ class ProjectTag(TypedDict):
     Unique identifier for the project that the project tag belongs under
     """
     user_id: str
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of project tag creation
     """
@@ -1344,15 +1558,15 @@ class ProjectTag(TypedDict):
     """
     Name of the project tag
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the project tag
     """
-    color: NotRequired[Optional[str]]
+    color: NotRequired[str | None]
     """
     Color of the tag for the UI
     """
-    position: NotRequired[Optional[str]]
+    position: NotRequired[str | None]
     """
     An optional LexoRank-based string that sets the sort position for the tag in the UI
     """
@@ -1369,15 +1583,15 @@ class PromptBlockDataNullishPromptBlockDataNullish1(TypedDict):
 
 
 class PromptDataOrigin(TypedDict):
-    prompt_id: NotRequired[Optional[str]]
-    project_id: NotRequired[Optional[str]]
-    prompt_version: NotRequired[Optional[str]]
+    prompt_id: NotRequired[str | None]
+    project_id: NotRequired[str | None]
+    prompt_version: NotRequired[str | None]
 
 
 class PromptDataNullishOrigin(TypedDict):
-    prompt_id: NotRequired[Optional[str]]
-    project_id: NotRequired[Optional[str]]
-    prompt_version: NotRequired[Optional[str]]
+    prompt_id: NotRequired[str | None]
+    project_id: NotRequired[str | None]
+    prompt_version: NotRequired[str | None]
 
 
 class PromptParserNullish(TypedDict):
@@ -1399,7 +1613,7 @@ class PromptSessionEvent(TypedDict):
     """
     The timestamp the prompt session event was created
     """
-    _pagination_key: NotRequired[Optional[str]]
+    _pagination_key: NotRequired[str | None]
     """
     A stable, time-ordered key that can be used to paginate over prompt session events. This field is auto-generated by Braintrust and only exists in Brainstore.
     """
@@ -1411,67 +1625,67 @@ class PromptSessionEvent(TypedDict):
     """
     Unique identifier for the prompt
     """
-    prompt_session_data: NotRequired[Optional[Any]]
+    prompt_session_data: NotRequired[Any | None]
     """
     Data about the prompt session
     """
-    prompt_data: NotRequired[Optional[Any]]
+    prompt_data: NotRequired[Any | None]
     """
     Data about the prompt
     """
-    function_data: NotRequired[Optional[Any]]
+    function_data: NotRequired[Any | None]
     """
     Data about the function
     """
-    function_type: NotRequired[Optional[FunctionTypeEnumNullish]]
-    object_data: NotRequired[Optional[Any]]
+    function_type: NotRequired[FunctionTypeEnumNullish | None]
+    object_data: NotRequired[Any | None]
     """
     Data about the mapped data
     """
-    completion: NotRequired[Optional[Any]]
+    completion: NotRequired[Any | None]
     """
     Data about the completion
     """
-    tags: NotRequired[Optional[Sequence[str]]]
+    tags: NotRequired[Sequence[str] | None]
     """
     A list of tags to log
     """
 
 
 class RepoInfo(TypedDict):
-    commit: NotRequired[Optional[str]]
+    commit: NotRequired[str | None]
     """
     SHA of most recent commit
     """
-    branch: NotRequired[Optional[str]]
+    branch: NotRequired[str | None]
     """
     Name of the branch the most recent commit belongs to
     """
-    tag: NotRequired[Optional[str]]
+    tag: NotRequired[str | None]
     """
     Name of the tag on the most recent commit
     """
-    dirty: NotRequired[Optional[bool]]
+    dirty: NotRequired[bool | None]
     """
     Whether or not the repo had uncommitted changes when snapshotted
     """
-    author_name: NotRequired[Optional[str]]
+    author_name: NotRequired[str | None]
     """
     Name of the author of the most recent commit
     """
-    author_email: NotRequired[Optional[str]]
+    author_email: NotRequired[str | None]
     """
     Email of the author of the most recent commit
     """
-    commit_message: NotRequired[Optional[str]]
+    commit_message: NotRequired[str | None]
     """
     Most recent commit message
     """
-    commit_time: NotRequired[Optional[str]]
+    commit_time: NotRequired[str | None]
     """
     Time of the most recent commit
     """
-    git_diff: NotRequired[Optional[str]]
+    git_diff: NotRequired[str | None]
     """
     If the repo was dirty when run, this includes the diff between the current state of the repo and the most recent commit.
     """
@@ -1487,9 +1701,9 @@ class ResponseFormatResponseFormat2(TypedDict):
 
 class ResponseFormatJsonSchema(TypedDict):
     name: str
-    description: NotRequired[Optional[str]]
-    schema: NotRequired[Optional[Union[Mapping[str, Any], str]]]
-    strict: NotRequired[Optional[bool]]
+    description: NotRequired[str | None]
+    schema: NotRequired[Mapping[str, Any] | str | None]
+    strict: NotRequired[bool | None]
 
 
 class ResponseFormatNullishResponseFormatNullish(TypedDict):
@@ -1505,21 +1719,23 @@ class ResponseFormatNullishResponseFormatNullish2(TypedDict):
     type: Literal['text']
 
 
-ResponseFormatNullish = Optional[
-    Union[
-        ResponseFormatNullishResponseFormatNullish,
-        ResponseFormatNullishResponseFormatNullish1,
-        ResponseFormatNullishResponseFormatNullish2,
-    ]
-]
+ResponseFormatNullish: TypeAlias = (
+    ResponseFormatNullishResponseFormatNullish
+    | ResponseFormatNullishResponseFormatNullish1
+    | ResponseFormatNullishResponseFormatNullish2
+    | None
+)
 
 
-RetentionObjectType = Literal['project_logs', 'experiment', 'dataset']
+RetentionObjectType: TypeAlias = Literal['project_logs', 'experiment', 'dataset']
+"""
+The object type that the retention policy applies to
+"""
 
 
 class RoleMemberPermission(TypedDict):
     permission: Permission
-    restrict_object_type: NotRequired[Optional[AclObjectType]]
+    restrict_object_type: NotRequired[AclObjectType | None]
 
 
 class Role(TypedDict):
@@ -1527,7 +1743,7 @@ class Role(TypedDict):
     """
     Unique identifier for the role
     """
-    org_id: NotRequired[Optional[str]]
+    org_id: NotRequired[str | None]
     """
     Unique id for the organization that the role belongs under
 
@@ -1535,11 +1751,11 @@ class Role(TypedDict):
 
     It is forbidden to change the org after creating a role
     """
-    user_id: NotRequired[Optional[str]]
+    user_id: NotRequired[str | None]
     """
     Identifies the user who created the role
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of role creation
     """
@@ -1547,19 +1763,19 @@ class Role(TypedDict):
     """
     Name of the role
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the role
     """
-    deleted_at: NotRequired[Optional[str]]
+    deleted_at: NotRequired[str | None]
     """
     Date of role deletion, or null if the role is still active
     """
-    member_permissions: NotRequired[Optional[Sequence[RoleMemberPermission]]]
+    member_permissions: NotRequired[Sequence[RoleMemberPermission] | None]
     """
     (permission, restrict_object_type) tuples which belong to this role
     """
-    member_roles: NotRequired[Optional[Sequence[str]]]
+    member_roles: NotRequired[Sequence[str] | None]
     """
     Ids of the roles this role inherits from
 
@@ -1569,17 +1785,156 @@ class Role(TypedDict):
 
 class RunEvalData(TypedDict):
     dataset_id: str
-    _internal_btql: NotRequired[Optional[Mapping[str, Any]]]
+    _internal_btql: NotRequired[Mapping[str, Any] | None]
 
 
 class RunEvalData1(TypedDict):
     project_name: str
     dataset_name: str
-    _internal_btql: NotRequired[Optional[Mapping[str, Any]]]
+    _internal_btql: NotRequired[Mapping[str, Any] | None]
 
 
 class RunEvalData2(TypedDict):
-    data: Sequence
+    data: Sequence[Any]
+
+
+class TaskTask(TypedDict):
+    function_id: str
+    """
+    The ID of the function
+    """
+    version: NotRequired[str | None]
+    """
+    The version of the function
+    """
+
+
+class TaskTask1(TypedDict):
+    project_name: str
+    """
+    The name of the project containing the function
+    """
+    slug: str
+    """
+    The slug of the function
+    """
+    version: NotRequired[str | None]
+    """
+    The version of the function
+    """
+
+
+class TaskTask2(TypedDict):
+    global_function: str
+    """
+    The name of the global function. Currently, the global namespace includes the functions in autoevals
+    """
+    function_type: NotRequired[NullableFunctionTypeEnum | None]
+
+
+class TaskTask3(TypedDict):
+    prompt_session_id: str
+    """
+    The ID of the prompt session
+    """
+    prompt_session_function_id: str
+    """
+    The ID of the function in the prompt session
+    """
+    version: NotRequired[str | None]
+    """
+    The version of the function
+    """
+
+
+class TaskTask4InlineContext(TypedDict):
+    runtime: Literal['node', 'python', 'browser', 'quickjs']
+    version: str
+
+
+class TaskTask4(TypedDict):
+    inline_context: TaskTask4InlineContext
+    code: str
+    """
+    The inline code to execute
+    """
+    name: NotRequired[str | None]
+    """
+    The name of the inline code function
+    """
+
+
+class TaskTask7(TypedDict):
+    pass
+
+
+class TaskTask8(TaskTask, TaskTask7):
+    pass
+
+
+class TaskTask9(TaskTask1, TaskTask7):
+    pass
+
+
+class TaskTask10(TaskTask2, TaskTask7):
+    pass
+
+
+class TaskTask11(TaskTask3, TaskTask7):
+    pass
+
+
+class TaskTask12(TaskTask4, TaskTask7):
+    pass
+
+
+class ParentParentRowIds(TypedDict):
+    id: str
+    """
+    The id of the row
+    """
+    span_id: str
+    """
+    The span_id of the row
+    """
+    root_span_id: str
+    """
+    The root_span_id of the row
+    """
+
+
+class ParentParent(TypedDict):
+    object_type: Literal['project_logs', 'experiment', 'playground_logs']
+    object_id: str
+    """
+    The id of the container object you are logging to
+    """
+    row_ids: NotRequired[ParentParentRowIds | None]
+    """
+    Identifiers for the row to to log a subspan under
+    """
+    propagated_event: NotRequired[Mapping[str, Any] | None]
+    """
+    Include these properties in every span created under this parent
+    """
+
+
+class ParentParent1(TypedDict):
+    pass
+
+
+class ParentParent2(ParentParent, ParentParent1):
+    pass
+
+
+Parent: TypeAlias = ParentParent2
+
+
+class RunEvalMcpAuth(TypedDict):
+    oauth_token: NotRequired[str | None]
+    """
+    The OAuth token to use
+    """
 
 
 class SavedFunctionIdSavedFunctionId(TypedDict):
@@ -1590,9 +1945,10 @@ class SavedFunctionIdSavedFunctionId(TypedDict):
 class SavedFunctionIdSavedFunctionId1(TypedDict):
     type: Literal['global']
     name: str
+    function_type: NotRequired[NullableFunctionTypeEnum | None]
 
 
-SavedFunctionId = Union[SavedFunctionIdSavedFunctionId, SavedFunctionIdSavedFunctionId1]
+SavedFunctionId: TypeAlias = SavedFunctionIdSavedFunctionId | SavedFunctionIdSavedFunctionId1
 
 
 class ServiceToken(TypedDict):
@@ -1600,7 +1956,7 @@ class ServiceToken(TypedDict):
     """
     Unique identifier for the service token
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of service token creation
     """
@@ -1609,19 +1965,19 @@ class ServiceToken(TypedDict):
     Name of the service token
     """
     preview_name: str
-    service_account_id: NotRequired[Optional[str]]
+    service_account_id: NotRequired[str | None]
     """
     Unique identifier for the service token
     """
-    service_account_email: NotRequired[Optional[str]]
+    service_account_email: NotRequired[str | None]
     """
     The service account email (not routable)
     """
-    service_account_name: NotRequired[Optional[str]]
+    service_account_name: NotRequired[str | None]
     """
     The service account name
     """
-    org_id: NotRequired[Optional[str]]
+    org_id: NotRequired[str | None]
     """
     Unique identifier for the organization
     """
@@ -1636,15 +1992,15 @@ class SpanIFrame(TypedDict):
     """
     Unique identifier for the project that the span iframe belongs under
     """
-    user_id: NotRequired[Optional[str]]
+    user_id: NotRequired[str | None]
     """
     Identifies the user who created the span iframe
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of span iframe creation
     """
-    deleted_at: NotRequired[Optional[str]]
+    deleted_at: NotRequired[str | None]
     """
     Date of span iframe deletion, or null if the span iframe is still active
     """
@@ -1652,7 +2008,7 @@ class SpanIFrame(TypedDict):
     """
     Name of the span iframe
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the span iframe
     """
@@ -1660,13 +2016,28 @@ class SpanIFrame(TypedDict):
     """
     URL to embed the project viewer in an iframe
     """
-    post_message: NotRequired[Optional[bool]]
+    post_message: NotRequired[bool | None]
     """
     Whether to post messages to the iframe containing the span's data. This is useful when you want to render more data than fits in the URL.
     """
 
 
-SpanType = Literal['llm', 'score', 'function', 'eval', 'task', 'tool']
+class SpanScope(TypedDict):
+    type: Literal['span']
+    root_span_id: str
+    """
+    The root span id is a unique identifier for the trace.
+    """
+    id: str
+    """
+    A unique identifier for the span.
+    """
+
+
+SpanType: TypeAlias = Literal['llm', 'score', 'function', 'eval', 'task', 'tool']
+"""
+Type of the span, for display purposes only
+"""
 
 
 class SSEConsoleEventData(TypedDict):
@@ -1680,7 +2051,7 @@ class SSEProgressEventData(TypedDict):
     The id of the span this event is for
     """
     object_type: FunctionObjectType
-    origin: NotRequired[Optional[ObjectReferenceNullish]]
+    origin: NotRequired[ObjectReferenceNullish | None]
     format: FunctionFormat
     output_type: FunctionOutputType
     name: str
@@ -1688,14 +2059,17 @@ class SSEProgressEventData(TypedDict):
     data: str
 
 
-StreamingMode = Literal['auto', 'parallel']
+StreamingMode: TypeAlias = Literal['auto', 'parallel', 'json', 'text']
+"""
+The mode format of the returned value (defaults to 'auto')
+"""
 
 
 class ToolFunctionDefinitionFunction(TypedDict):
     name: str
-    description: NotRequired[Optional[str]]
-    parameters: NotRequired[Optional[Mapping[str, Any]]]
-    strict: NotRequired[Optional[bool]]
+    description: NotRequired[str | None]
+    parameters: NotRequired[Mapping[str, Any] | None]
+    strict: NotRequired[bool | None]
 
 
 class ToolFunctionDefinition(TypedDict):
@@ -1703,7 +2077,15 @@ class ToolFunctionDefinition(TypedDict):
     function: ToolFunctionDefinitionFunction
 
 
-UploadStatus = Literal['uploading', 'done', 'error']
+class TraceScope(TypedDict):
+    type: Literal['trace']
+    root_span_id: str
+    """
+    The root span id is a unique identifier for the trace.
+    """
+
+
+UploadStatus: TypeAlias = Literal['uploading', 'done', 'error']
 
 
 class User(TypedDict):
@@ -1711,50 +2093,51 @@ class User(TypedDict):
     """
     Unique identifier for the user
     """
-    given_name: NotRequired[Optional[str]]
+    given_name: NotRequired[str | None]
     """
     Given name of the user
     """
-    family_name: NotRequired[Optional[str]]
+    family_name: NotRequired[str | None]
     """
     Family name of the user
     """
-    email: NotRequired[Optional[str]]
+    email: NotRequired[str | None]
     """
     The user's email
     """
-    avatar_url: NotRequired[Optional[str]]
+    avatar_url: NotRequired[str | None]
     """
     URL of the user's Avatar image
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of user creation
     """
 
 
 class ViewDataSearch(TypedDict):
-    filter: NotRequired[Optional[Sequence[Any]]]
-    tag: NotRequired[Optional[Sequence[Any]]]
-    match: NotRequired[Optional[Sequence[Any]]]
-    sort: NotRequired[Optional[Sequence[Any]]]
+    filter: NotRequired[Sequence[Any] | None]
+    tag: NotRequired[Sequence[Any] | None]
+    match: NotRequired[Sequence[Any] | None]
+    sort: NotRequired[Sequence[Any] | None]
 
 
 class ViewOptionsViewOptionsOptions(TypedDict):
-    spanType: NotRequired[Optional[Literal['range', 'frame']]]
-    rangeValue: NotRequired[Optional[str]]
-    frameStart: NotRequired[Optional[str]]
-    frameEnd: NotRequired[Optional[str]]
-    tzUTC: NotRequired[Optional[bool]]
-    chartVisibility: NotRequired[Optional[Mapping[str, Any]]]
-    projectId: NotRequired[Optional[str]]
-    type: NotRequired[Optional[Literal['project', 'experiment']]]
-    groupBy: NotRequired[Optional[str]]
+    spanType: NotRequired[Literal['range', 'frame'] | None]
+    rangeValue: NotRequired[str | None]
+    frameStart: NotRequired[str | None]
+    frameEnd: NotRequired[str | None]
+    tzUTC: NotRequired[bool | None]
+    chartVisibility: NotRequired[Mapping[str, Any] | None]
+    projectId: NotRequired[str | None]
+    type: NotRequired[Literal['project', 'experiment'] | None]
+    groupBy: NotRequired[str | None]
 
 
 class ViewOptionsViewOptions(TypedDict):
     viewType: Literal['monitor']
     options: ViewOptionsViewOptionsOptions
+    freezeColumns: NotRequired[bool | None]
 
 
 class ViewOptionsViewOptions1ExcludedMeasure(TypedDict):
@@ -1792,28 +2175,32 @@ ViewOptionsViewOptions1TimeRangeFilter = TypedDict(
 
 
 class ViewOptionsViewOptions1(TypedDict):
-    columnVisibility: NotRequired[Optional[Mapping[str, Any]]]
-    columnOrder: NotRequired[Optional[Sequence[str]]]
-    columnSizing: NotRequired[Optional[Mapping[str, Any]]]
-    grouping: NotRequired[Optional[str]]
-    rowHeight: NotRequired[Optional[str]]
-    tallGroupRows: NotRequired[Optional[bool]]
-    layout: NotRequired[Optional[str]]
-    chartHeight: NotRequired[Optional[float]]
-    excludedMeasures: NotRequired[Optional[Sequence[ViewOptionsViewOptions1ExcludedMeasure]]]
-    yMetric: NotRequired[Optional[ViewOptionsViewOptions1YMetric]]
-    xAxis: NotRequired[Optional[ViewOptionsViewOptions1XAxis]]
-    symbolGrouping: NotRequired[Optional[ViewOptionsViewOptions1SymbolGrouping]]
-    xAxisAggregation: NotRequired[Optional[str]]
+    columnVisibility: NotRequired[Mapping[str, Any] | None]
+    columnOrder: NotRequired[Sequence[str] | None]
+    columnSizing: NotRequired[Mapping[str, Any] | None]
+    grouping: NotRequired[str | None]
+    rowHeight: NotRequired[str | None]
+    tallGroupRows: NotRequired[bool | None]
+    layout: NotRequired[str | None]
+    chartHeight: NotRequired[float | None]
+    excludedMeasures: NotRequired[Sequence[ViewOptionsViewOptions1ExcludedMeasure] | None]
+    yMetric: NotRequired[ViewOptionsViewOptions1YMetric | None]
+    xAxis: NotRequired[ViewOptionsViewOptions1XAxis | None]
+    symbolGrouping: NotRequired[ViewOptionsViewOptions1SymbolGrouping | None]
+    xAxisAggregation: NotRequired[str | None]
     """
     One of 'avg', 'sum', 'min', 'max', 'median', 'all'
     """
-    chartAnnotations: NotRequired[Optional[Sequence[ViewOptionsViewOptions1ChartAnnotation]]]
-    timeRangeFilter: NotRequired[Optional[Union[str, ViewOptionsViewOptions1TimeRangeFilter]]]
-    queryShape: NotRequired[Optional[Literal['traces', 'spans']]]
+    chartAnnotations: NotRequired[Sequence[ViewOptionsViewOptions1ChartAnnotation] | None]
+    timeRangeFilter: NotRequired[str | ViewOptionsViewOptions1TimeRangeFilter | None]
+    queryShape: NotRequired[Literal['traces', 'spans'] | None]
+    freezeColumns: NotRequired[bool | None]
 
 
-ViewOptions = Optional[Union[ViewOptionsViewOptions, ViewOptionsViewOptions1]]
+ViewOptions: TypeAlias = ViewOptionsViewOptions | ViewOptionsViewOptions1 | None
+"""
+Options for the view in the app
+"""
 
 
 class Acl(TypedDict):
@@ -1821,22 +2208,22 @@ class Acl(TypedDict):
     """
     Unique identifier for the acl
     """
-    object_type: Optional[AclObjectType]
+    object_type: AclObjectType
     object_id: str
     """
     The id of the object the ACL applies to
     """
-    user_id: NotRequired[Optional[str]]
+    user_id: NotRequired[str | None]
     """
     Id of the user the ACL applies to. Exactly one of `user_id` and `group_id` will be provided
     """
-    group_id: NotRequired[Optional[str]]
+    group_id: NotRequired[str | None]
     """
     Id of the group the ACL applies to. Exactly one of `user_id` and `group_id` will be provided
     """
-    permission: NotRequired[Optional[Permission]]
-    restrict_object_type: NotRequired[Optional[AclObjectType]]
-    role_id: NotRequired[Optional[str]]
+    permission: NotRequired[Permission | None]
+    restrict_object_type: NotRequired[AclObjectType | None]
+    role_id: NotRequired[str | None]
     """
     Id of the role the ACL grants. Exactly one of `permission` and `role_id` will be provided
     """
@@ -1844,41 +2231,41 @@ class Acl(TypedDict):
     """
     The organization the ACL's referred object belongs to
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of acl creation
     """
 
 
 class AnyModelParams(TypedDict):
-    temperature: NotRequired[Optional[float]]
-    top_p: NotRequired[Optional[float]]
+    temperature: NotRequired[float | None]
+    top_p: NotRequired[float | None]
     max_tokens: float
-    max_completion_tokens: NotRequired[Optional[float]]
+    max_completion_tokens: NotRequired[float | None]
     """
     The successor to max_tokens
     """
-    frequency_penalty: NotRequired[Optional[float]]
-    presence_penalty: NotRequired[Optional[float]]
-    response_format: NotRequired[Optional[ResponseFormatNullish]]
-    tool_choice: NotRequired[Optional[Union[Literal['auto'], Literal['none'], Literal['required'], AnyModelParamsToolChoice]]]
-    function_call: NotRequired[Optional[Union[Literal['auto'], Literal['none'], AnyModelParamsFunctionCall]]]
-    n: NotRequired[Optional[float]]
-    stop: NotRequired[Optional[Sequence[str]]]
-    reasoning_effort: NotRequired[Optional[Literal['none', 'minimal', 'low', 'medium', 'high']]]
-    verbosity: NotRequired[Optional[Literal['low', 'medium', 'high']]]
-    top_k: NotRequired[Optional[float]]
-    stop_sequences: NotRequired[Optional[Sequence[str]]]
-    reasoning_enabled: NotRequired[Optional[bool]]
-    reasoning_budget: NotRequired[Optional[float]]
-    max_tokens_to_sample: NotRequired[Optional[float]]
+    frequency_penalty: NotRequired[float | None]
+    presence_penalty: NotRequired[float | None]
+    response_format: NotRequired[ResponseFormatNullish | None]
+    tool_choice: NotRequired[Literal['auto'] | Literal['none'] | Literal['required'] | AnyModelParamsToolChoice | None]
+    function_call: NotRequired[Literal['auto'] | Literal['none'] | AnyModelParamsFunctionCall | None]
+    n: NotRequired[float | None]
+    stop: NotRequired[Sequence[str] | None]
+    reasoning_effort: NotRequired[Literal['none', 'minimal', 'low', 'medium', 'high'] | None]
+    verbosity: NotRequired[Literal['low', 'medium', 'high'] | None]
+    top_k: NotRequired[float | None]
+    stop_sequences: NotRequired[Sequence[str] | None]
+    reasoning_enabled: NotRequired[bool | None]
+    reasoning_budget: NotRequired[float | None]
+    max_tokens_to_sample: NotRequired[float | None]
     """
     This is a legacy parameter that should not be used.
     """
-    maxOutputTokens: NotRequired[Optional[float]]
-    topP: NotRequired[Optional[float]]
-    topK: NotRequired[Optional[float]]
-    use_cache: NotRequired[Optional[bool]]
+    maxOutputTokens: NotRequired[float | None]
+    topP: NotRequired[float | None]
+    topK: NotRequired[float | None]
+    use_cache: NotRequired[bool | None]
 
 
 class AsyncScoringControlAsyncScoringControl1(TypedDict):
@@ -1886,72 +2273,72 @@ class AsyncScoringControlAsyncScoringControl1(TypedDict):
     state: AsyncScoringState
 
 
-AsyncScoringControl = Union[
-    AsyncScoringControlAsyncScoringControl,
-    AsyncScoringControlAsyncScoringControl1,
-    AsyncScoringControlAsyncScoringControl2,
-    AsyncScoringControlAsyncScoringControl3,
-]
+AsyncScoringControl: TypeAlias = (
+    AsyncScoringControlAsyncScoringControl
+    | AsyncScoringControlAsyncScoringControl1
+    | AsyncScoringControlAsyncScoringControl2
+    | AsyncScoringControlAsyncScoringControl3
+)
 
 
-AttachmentReference = Union[BraintrustAttachmentReference, ExternalAttachmentReference]
+AttachmentReference: TypeAlias = BraintrustAttachmentReference | ExternalAttachmentReference
 
 
 class AttachmentStatus(TypedDict):
     upload_status: UploadStatus
-    error_message: NotRequired[Optional[str]]
+    error_message: NotRequired[str | None]
     """
     Describes the error encountered while uploading.
     """
 
 
-ChatCompletionContentPart = Union[
-    ChatCompletionContentPartTextWithTitle,
-    ChatCompletionContentPartImageWithTitle,
-    ChatCompletionContentPartFileWithTitle,
-]
+ChatCompletionContentPart: TypeAlias = (
+    ChatCompletionContentPartTextWithTitle
+    | ChatCompletionContentPartImageWithTitle
+    | ChatCompletionContentPartFileWithTitle
+)
 
 
 class ChatCompletionMessageParamChatCompletionMessageParam1(TypedDict):
-    content: Union[str, Sequence[ChatCompletionContentPart]]
+    content: str | Sequence[ChatCompletionContentPart]
     role: Literal['user']
-    name: NotRequired[Optional[str]]
+    name: NotRequired[str | None]
 
 
 class ChatCompletionMessageParamChatCompletionMessageParam2(TypedDict):
     role: Literal['assistant']
-    content: NotRequired[Optional[Union[str, Sequence[ChatCompletionContentPartText]]]]
-    function_call: NotRequired[Optional[ChatCompletionMessageParamChatCompletionMessageParam2FunctionCall]]
-    name: NotRequired[Optional[str]]
-    tool_calls: NotRequired[Optional[Sequence[ChatCompletionMessageToolCall]]]
-    reasoning: NotRequired[Optional[Sequence[ChatCompletionMessageReasoning]]]
-
-
-ChatCompletionMessageParam = Union[
-    ChatCompletionMessageParamChatCompletionMessageParam,
-    ChatCompletionMessageParamChatCompletionMessageParam1,
-    ChatCompletionMessageParamChatCompletionMessageParam2,
-    ChatCompletionMessageParamChatCompletionMessageParam3,
-    ChatCompletionMessageParamChatCompletionMessageParam4,
-    ChatCompletionMessageParamChatCompletionMessageParam5,
-    ChatCompletionMessageParamChatCompletionMessageParam6,
-]
+    content: NotRequired[str | Sequence[ChatCompletionContentPartText] | None]
+    function_call: NotRequired[ChatCompletionMessageParamChatCompletionMessageParam2FunctionCall | None]
+    name: NotRequired[str | None]
+    tool_calls: NotRequired[Sequence[ChatCompletionMessageToolCall] | None]
+    reasoning: NotRequired[Sequence[ChatCompletionMessageReasoning] | None]
+
+
+ChatCompletionMessageParam: TypeAlias = (
+    ChatCompletionMessageParamChatCompletionMessageParam
+    | ChatCompletionMessageParamChatCompletionMessageParam1
+    | ChatCompletionMessageParamChatCompletionMessageParam2
+    | ChatCompletionMessageParamChatCompletionMessageParam3
+    | ChatCompletionMessageParamChatCompletionMessageParam4
+    | ChatCompletionMessageParamChatCompletionMessageParam5
+    | ChatCompletionMessageParamChatCompletionMessageParam6
+)
 
 
 class ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam1(TypedDict):
-    content: Union[str, Sequence[ChatCompletionContentPart]]
+    content: str | Sequence[ChatCompletionContentPart]
     role: Literal['user']
-    name: NotRequired[Optional[str]]
+    name: NotRequired[str | None]
 
 
-ChatCompletionOpenAIMessageParam = Union[
-    ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam,
-    ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam1,
-    ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam2,
-    ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam3,
-    ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam4,
-    ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam5,
-]
+ChatCompletionOpenAIMessageParam: TypeAlias = (
+    ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam
+    | ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam1
+    | ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam2
+    | ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam3
+    | ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam4
+    | ChatCompletionOpenAIMessageParamChatCompletionOpenAIMessageParam5
+)
 
 
 class DatasetEvent(TypedDict):
@@ -1967,7 +2354,7 @@ class DatasetEvent(TypedDict):
     """
     The timestamp the dataset event was created
     """
-    _pagination_key: NotRequired[Optional[str]]
+    _pagination_key: NotRequired[str | None]
     """
     A stable, time-ordered key that can be used to paginate over dataset events. This field is auto-generated by Braintrust and only exists in Brainstore.
     """
@@ -1979,19 +2366,19 @@ class DatasetEvent(TypedDict):
     """
     Unique identifier for the dataset
     """
-    input: NotRequired[Optional[Any]]
+    input: NotRequired[Any | None]
     """
     The argument that uniquely define an input case (an arbitrary, JSON serializable object)
     """
-    expected: NotRequired[Optional[Any]]
+    expected: NotRequired[Any | None]
     """
     The output of your application, including post-processing (an arbitrary, JSON serializable object)
     """
-    metadata: NotRequired[Optional[DatasetEventMetadata]]
+    metadata: NotRequired[DatasetEventMetadata | None]
     """
     A dictionary with additional data about the test example, model outputs, or just about anything else that's relevant, that you can use to help find and analyze examples later. For example, you could log the `prompt`, example's `id`, or anything else that would be useful to slice/dice later. The values in `metadata` can be any JSON-serializable type, but its keys must be strings
     """
-    tags: NotRequired[Optional[Sequence[str]]]
+    tags: NotRequired[Sequence[str] | None]
     """
     A list of tags to log
     """
@@ -2003,16 +2390,16 @@ class DatasetEvent(TypedDict):
     """
     A unique identifier for the trace this dataset event belongs to
     """
-    is_root: NotRequired[Optional[bool]]
+    is_root: NotRequired[bool | None]
     """
     Whether this span is a root span
     """
-    origin: NotRequired[Optional[ObjectReferenceNullish]]
-    comments: NotRequired[Optional[Sequence[Any]]]
+    origin: NotRequired[ObjectReferenceNullish | None]
+    comments: NotRequired[Sequence[Any] | None]
     """
     Optional list of comments attached to this event
     """
-    audit_data: NotRequired[Optional[Sequence[Any]]]
+    audit_data: NotRequired[Sequence[Any] | None]
     """
     Optional list of audit entries attached to this event
     """
@@ -2031,32 +2418,32 @@ class Experiment(TypedDict):
     """
     Name of the experiment. Within a project, experiment names are unique
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the experiment
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of experiment creation
     """
-    repo_info: NotRequired[Optional[RepoInfo]]
-    commit: NotRequired[Optional[str]]
+    repo_info: NotRequired[RepoInfo | None]
+    commit: NotRequired[str | None]
     """
     Commit, taken directly from `repo_info.commit`
     """
-    base_exp_id: NotRequired[Optional[str]]
+    base_exp_id: NotRequired[str | None]
     """
     Id of default base experiment to compare against when viewing this experiment
     """
-    deleted_at: NotRequired[Optional[str]]
+    deleted_at: NotRequired[str | None]
     """
     Date of experiment deletion, or null if the experiment is still active
     """
-    dataset_id: NotRequired[Optional[str]]
+    dataset_id: NotRequired[str | None]
     """
     Identifier of the linked dataset, or null if the experiment is not linked to a dataset
     """
-    dataset_version: NotRequired[Optional[str]]
+    dataset_version: NotRequired[str | None]
     """
     Version number of the linked dataset the experiment was run against. This can be used to reproduce the experiment after the dataset has been modified.
     """
@@ -2064,51 +2451,126 @@ class Experiment(TypedDict):
     """
     Whether or not the experiment is public. Public experiments can be viewed by anybody inside or outside the organization
     """
-    user_id: NotRequired[Optional[str]]
+    user_id: NotRequired[str | None]
     """
     Identifies the user who created the experiment
     """
-    metadata: NotRequired[Optional[Mapping[str, Any]]]
+    metadata: NotRequired[Mapping[str, Any] | None]
     """
     User-controlled metadata about the experiment
     """
-    tags: NotRequired[Optional[Sequence[str]]]
+    tags: NotRequired[Sequence[str] | None]
     """
     A list of tags for the experiment
     """
 
 
+class ExtendedSavedFunctionIdExtendedSavedFunctionId1(TypedDict):
+    type: Literal['global']
+    name: str
+    function_type: NotRequired[NullableFunctionTypeEnum | None]
+
+
+ExtendedSavedFunctionId: TypeAlias = (
+    ExtendedSavedFunctionIdExtendedSavedFunctionId
+    | ExtendedSavedFunctionIdExtendedSavedFunctionId1
+    | ExtendedSavedFunctionIdExtendedSavedFunctionId2
+)
+
+
+class PreprocessorPreprocessor1(TypedDict):
+    type: Literal['global']
+    name: str
+    function_type: NotRequired[NullableFunctionTypeEnum | None]
+
+
+class PreprocessorPreprocessor4(PreprocessorPreprocessor1, PreprocessorPreprocessor2):
+    pass
+
+
+Preprocessor: TypeAlias = PreprocessorPreprocessor3 | PreprocessorPreprocessor4
+
+
+class FacetData(TypedDict):
+    type: Literal['facet']
+    preprocessor: NotRequired[Preprocessor | None]
+    prompt: str
+    """
+    The prompt to use for LLM extraction. The preprocessed text will be provided as context.
+    """
+    model: NotRequired[str | None]
+    """
+    The model to use for facet extraction
+    """
+    no_match_pattern: NotRequired[str | None]
+    """
+    Regex pattern to identify outputs that do not match the facet. If the output matches, the facet will be saved as 'no_match'
+    """
+
+
+class FunctionDataFunctionData3(TypedDict):
+    type: Literal['global']
+    name: str
+    function_type: NotRequired[NullableFunctionTypeEnum | None]
+    config: NotRequired[Mapping[str, Any] | None]
+    """
+    Configuration options to pass to the global function (e.g., for preprocessor customization)
+    """
+
+
+class FunctionIdFunctionId2(TypedDict):
+    global_function: str
+    """
+    The name of the global function. Currently, the global namespace includes the functions in autoevals
+    """
+    function_type: NotRequired[NullableFunctionTypeEnum | None]
+
+
+class InvokeFunctionInvokeFunction2(TypedDict):
+    global_function: str
+    """
+    The name of the global function. Currently, the global namespace includes the functions in autoevals
+    """
+    function_type: NotRequired[NullableFunctionTypeEnum | None]
+
+
+InvokeScope: TypeAlias = SpanScope | TraceScope
+"""
+The scope at which to operate (span or trace)
+"""
+
+
 class ModelParamsModelParams(TypedDict):
-    use_cache: NotRequired[Optional[bool]]
-    reasoning_enabled: NotRequired[Optional[bool]]
-    reasoning_budget: NotRequired[Optional[float]]
-    temperature: NotRequired[Optional[float]]
-    top_p: NotRequired[Optional[float]]
-    max_tokens: NotRequired[Optional[float]]
-    max_completion_tokens: NotRequired[Optional[float]]
+    use_cache: NotRequired[bool | None]
+    reasoning_enabled: NotRequired[bool | None]
+    reasoning_budget: NotRequired[float | None]
+    temperature: NotRequired[float | None]
+    top_p: NotRequired[float | None]
+    max_tokens: NotRequired[float | None]
+    max_completion_tokens: NotRequired[float | None]
     """
     The successor to max_tokens
     """
-    frequency_penalty: NotRequired[Optional[float]]
-    presence_penalty: NotRequired[Optional[float]]
-    response_format: NotRequired[Optional[ResponseFormatNullish]]
+    frequency_penalty: NotRequired[float | None]
+    presence_penalty: NotRequired[float | None]
+    response_format: NotRequired[ResponseFormatNullish | None]
     tool_choice: NotRequired[
-        Union[Literal['auto'], Literal['none'], Literal['required'], ModelParamsModelParamsToolChoice]
+        Literal['auto'] | Literal['none'] | Literal['required'] | ModelParamsModelParamsToolChoice
     ]
-    function_call: NotRequired[Optional[Union[Literal['auto'], Literal['none'], ModelParamsModelParamsFunctionCall]]]
-    n: NotRequired[Optional[float]]
-    stop: NotRequired[Optional[Sequence[str]]]
-    reasoning_effort: NotRequired[Optional[Literal['none', 'minimal', 'low', 'medium', 'high']]]
-    verbosity: NotRequired[Optional[Literal['low', 'medium', 'high']]]
-
-
-ModelParams = Union[
-    ModelParamsModelParams,
-    ModelParamsModelParams1,
-    ModelParamsModelParams2,
-    ModelParamsModelParams3,
-    ModelParamsModelParams4,
-]
+    function_call: NotRequired[Literal['auto'] | Literal['none'] | ModelParamsModelParamsFunctionCall | None]
+    n: NotRequired[float | None]
+    stop: NotRequired[Sequence[str] | None]
+    reasoning_effort: NotRequired[Literal['none', 'minimal', 'low', 'medium', 'high'] | None]
+    verbosity: NotRequired[Literal['low', 'medium', 'high'] | None]
+
+
+ModelParams: TypeAlias = (
+    ModelParamsModelParams
+    | ModelParamsModelParams1
+    | ModelParamsModelParams2
+    | ModelParamsModelParams3
+    | ModelParamsModelParams4
+)
 
 
 class OnlineScoreConfig(TypedDict):
@@ -2120,19 +2582,19 @@ class OnlineScoreConfig(TypedDict):
     """
     The list of scorers to use for online scoring
     """
-    btql_filter: NotRequired[Optional[str]]
+    btql_filter: NotRequired[str | None]
     """
     Filter logs using BTQL
     """
-    apply_to_root_span: NotRequired[Optional[bool]]
+    apply_to_root_span: NotRequired[bool | None]
     """
     Whether to trigger online scoring on the root span of each trace
     """
-    apply_to_span_names: NotRequired[Optional[Sequence[str]]]
+    apply_to_span_names: NotRequired[Sequence[str] | None]
     """
     Trigger online scoring on any spans with a name in this list
     """
-    skip_logging: NotRequired[Optional[bool]]
+    skip_logging: NotRequired[bool | None]
     """
     Whether to skip adding scorer spans when computing scores
     """
@@ -2151,19 +2613,23 @@ class Project(TypedDict):
     """
     Name of the project
     """
-    created: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
+    """
+    Textual description of the project
+    """
+    created: NotRequired[str | None]
     """
     Date of project creation
     """
-    deleted_at: NotRequired[Optional[str]]
+    deleted_at: NotRequired[str | None]
     """
     Date of project deletion, or null if the project is still active
     """
-    user_id: NotRequired[Optional[str]]
+    user_id: NotRequired[str | None]
     """
     Identifies the user who created the project
     """
-    settings: NotRequired[Optional[ProjectSettings]]
+    settings: NotRequired[ProjectSettings | None]
 
 
 class ProjectAutomationConfig2(TypedDict):
@@ -2187,11 +2653,11 @@ class ProjectAutomation(TypedDict):
     """
     Unique identifier for the project that the project automation belongs under
     """
-    user_id: NotRequired[Optional[str]]
+    user_id: NotRequired[str | None]
     """
     Identifies the user who created the project automation
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of project automation creation
     """
@@ -2199,55 +2665,55 @@ class ProjectAutomation(TypedDict):
     """
     Name of the project automation
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the project automation
     """
-    config: Union[ProjectAutomationConfig, ProjectAutomationConfig1, ProjectAutomationConfig2]
+    config: ProjectAutomationConfig | ProjectAutomationConfig1 | ProjectAutomationConfig2 | ProjectAutomationConfig3
     """
     The configuration for the automation rule
     """
 
 
-ProjectScoreCategories = Optional[Union[Sequence[ProjectScoreCategory], Mapping[str, float], Sequence[str]]]
+ProjectScoreCategories: TypeAlias = Sequence[ProjectScoreCategory] | Mapping[str, float] | Sequence[str] | None
 
 
 class ProjectScoreConfig(TypedDict):
-    multi_select: NotRequired[Optional[bool]]
-    destination: NotRequired[Optional[str]]
-    online: NotRequired[Optional[OnlineScoreConfig]]
+    multi_select: NotRequired[bool | None]
+    destination: NotRequired[str | None]
+    online: NotRequired[OnlineScoreConfig | None]
 
 
 class PromptBlockDataPromptBlockData(TypedDict):
     type: Literal['chat']
     messages: Sequence[ChatCompletionMessageParam]
-    tools: NotRequired[Optional[str]]
+    tools: NotRequired[str | None]
 
 
-PromptBlockData = Union[PromptBlockDataPromptBlockData, PromptBlockDataPromptBlockData1]
+PromptBlockData: TypeAlias = PromptBlockDataPromptBlockData | PromptBlockDataPromptBlockData1
 
 
 class PromptBlockDataNullishPromptBlockDataNullish(TypedDict):
     type: Literal['chat']
     messages: Sequence[ChatCompletionMessageParam]
-    tools: NotRequired[Optional[str]]
+    tools: NotRequired[str | None]
 
 
-PromptBlockDataNullish = Optional[
-    Union[PromptBlockDataNullishPromptBlockDataNullish, PromptBlockDataNullishPromptBlockDataNullish1]
-]
+PromptBlockDataNullish: TypeAlias = (
+    PromptBlockDataNullishPromptBlockDataNullish | PromptBlockDataNullishPromptBlockDataNullish1 | None
+)
 
 
 class PromptOptions(TypedDict):
-    model: NotRequired[Optional[str]]
-    params: NotRequired[Optional[ModelParams]]
-    position: NotRequired[Optional[str]]
+    model: NotRequired[str | None]
+    params: NotRequired[ModelParams | None]
+    position: NotRequired[str | None]
 
 
 class PromptOptionsNullish(TypedDict):
-    model: NotRequired[Optional[str]]
-    params: NotRequired[Optional[ModelParams]]
-    position: NotRequired[Optional[str]]
+    model: NotRequired[str | None]
+    params: NotRequired[ModelParams | None]
+    position: NotRequired[str | None]
 
 
 class ResponseFormatResponseFormat1(TypedDict):
@@ -2255,20 +2721,22 @@ class ResponseFormatResponseFormat1(TypedDict):
     json_schema: ResponseFormatJsonSchema
 
 
-ResponseFormat = Union[ResponseFormatResponseFormat, ResponseFormatResponseFormat1, ResponseFormatResponseFormat2]
+ResponseFormat: TypeAlias = (
+    ResponseFormatResponseFormat | ResponseFormatResponseFormat1 | ResponseFormatResponseFormat2
+)
 
 
 class SpanAttributes(TypedDict):
-    name: NotRequired[Optional[str]]
+    name: NotRequired[str | None]
     """
     Name of the span, for display purposes only
     """
-    type: NotRequired[Optional[SpanType]]
+    type: NotRequired[SpanType | None]
 
 
 class ViewData(TypedDict):
-    search: NotRequired[Optional[ViewDataSearch]]
-    custom_charts: NotRequired[Optional[Any]]
+    search: NotRequired[ViewDataSearch | None]
+    custom_charts: NotRequired[Any | None]
 
 
 class ExperimentEvent(TypedDict):
@@ -2284,7 +2752,7 @@ class ExperimentEvent(TypedDict):
     """
     The timestamp the experiment event was created
     """
-    _pagination_key: NotRequired[Optional[str]]
+    _pagination_key: NotRequired[str | None]
     """
     A stable, time-ordered key that can be used to paginate over experiment events. This field is auto-generated by Braintrust and only exists in Brainstore.
     """
@@ -2296,39 +2764,39 @@ class ExperimentEvent(TypedDict):
     """
     Unique identifier for the experiment
     """
-    input: NotRequired[Optional[Any]]
+    input: NotRequired[Any | None]
     """
     The arguments that uniquely define a test case (an arbitrary, JSON serializable object). Later on, Braintrust will use the `input` to know whether two test cases are the same between experiments, so they should not contain experiment-specific state. A simple rule of thumb is that if you run the same experiment twice, the `input` should be identical
     """
-    output: NotRequired[Optional[Any]]
+    output: NotRequired[Any | None]
     """
     The output of your application, including post-processing (an arbitrary, JSON serializable object), that allows you to determine whether the result is correct or not. For example, in an app that generates SQL queries, the `output` should be the _result_ of the SQL query generated by the model, not the query itself, because there may be multiple valid queries that answer a single question
     """
-    expected: NotRequired[Optional[Any]]
+    expected: NotRequired[Any | None]
     """
     The ground truth value (an arbitrary, JSON serializable object) that you'd compare to `output` to determine if your `output` value is correct or not. Braintrust currently does not compare `output` to `expected` for you, since there are so many different ways to do that correctly. Instead, these values are just used to help you navigate your experiments while digging into analyses. However, we may later use these values to re-score outputs or fine-tune your models
     """
-    error: NotRequired[Optional[Any]]
+    error: NotRequired[Any | None]
     """
     The error that occurred, if any.
     """
-    scores: NotRequired[Optional[Mapping[str, Any]]]
+    scores: NotRequired[Mapping[str, Any] | None]
     """
     A dictionary of numeric values (between 0 and 1) to log. The scores should give you a variety of signals that help you determine how accurate the outputs are compared to what you expect and diagnose failures. For example, a summarization app might have one score that tells you how accurate the summary is, and another that measures the word similarity between the generated and grouth truth summary. The word similarity score could help you determine whether the summarization was covering similar concepts or not. You can use these scores to help you sort, filter, and compare experiments
     """
-    metadata: NotRequired[Optional[ExperimentEventMetadata]]
+    metadata: NotRequired[ExperimentEventMetadata | None]
     """
     A dictionary with additional data about the test example, model outputs, or just about anything else that's relevant, that you can use to help find and analyze examples later. For example, you could log the `prompt`, example's `id`, or anything else that would be useful to slice/dice later. The values in `metadata` can be any JSON-serializable type, but its keys must be strings
     """
-    tags: NotRequired[Optional[Sequence[str]]]
+    tags: NotRequired[Sequence[str] | None]
     """
     A list of tags to log
     """
-    metrics: NotRequired[Optional[ExperimentEventMetrics]]
+    metrics: NotRequired[ExperimentEventMetrics | None]
     """
     Metrics are numerical measurements tracking the execution of the code that produced the experiment event. Use "start" and "end" to track the time span over which the experiment event was produced
     """
-    context: NotRequired[Optional[ExperimentEventContext]]
+    context: NotRequired[ExperimentEventContext | None]
     """
     Context is additional information about the code that produced the experiment event. It is essentially the textual counterpart to `metrics`. Use the `caller_*` attributes to track the location in code which produced the experiment event
     """
@@ -2336,7 +2804,7 @@ class ExperimentEvent(TypedDict):
     """
     A unique identifier used to link different experiment events together as part of a full trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full details on tracing
     """
-    span_parents: NotRequired[Optional[Sequence[str]]]
+    span_parents: NotRequired[Sequence[str] | None]
     """
     An array of the parent `span_ids` of this experiment event. This should be empty for the root span of a trace, and should most often contain just one parent element for subspans
     """
@@ -2344,28 +2812,28 @@ class ExperimentEvent(TypedDict):
     """
     A unique identifier for the trace this experiment event belongs to
     """
-    span_attributes: NotRequired[Optional[SpanAttributes]]
-    is_root: NotRequired[Optional[bool]]
+    span_attributes: NotRequired[SpanAttributes | None]
+    is_root: NotRequired[bool | None]
     """
     Whether this span is a root span
     """
-    origin: NotRequired[Optional[ObjectReferenceNullish]]
-    comments: NotRequired[Optional[Sequence[Any]]]
+    origin: NotRequired[ObjectReferenceNullish | None]
+    comments: NotRequired[Sequence[Any] | None]
     """
     Optional list of comments attached to this event
     """
-    audit_data: NotRequired[Optional[Sequence[Any]]]
+    audit_data: NotRequired[Sequence[Any] | None]
     """
     Optional list of audit entries attached to this event
     """
 
 
 class GraphNodeGraphNode7(TypedDict):
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     The description of the node
     """
-    position: NotRequired[Optional[GraphNodeGraphNode7Position]]
+    position: NotRequired[GraphNodeGraphNode7Position | None]
     """
     The position of the node
     """
@@ -2373,16 +2841,90 @@ class GraphNodeGraphNode7(TypedDict):
     prompt: PromptBlockData
 
 
-GraphNode = Union[
-    GraphNodeGraphNode,
-    GraphNodeGraphNode1,
-    GraphNodeGraphNode2,
-    GraphNodeGraphNode3,
-    GraphNodeGraphNode4,
-    GraphNodeGraphNode5,
-    GraphNodeGraphNode6,
-    GraphNodeGraphNode7,
-]
+GraphNode: TypeAlias = (
+    GraphNodeGraphNode
+    | GraphNodeGraphNode1
+    | GraphNodeGraphNode2
+    | GraphNodeGraphNode3
+    | GraphNodeGraphNode4
+    | GraphNodeGraphNode5
+    | GraphNodeGraphNode6
+    | GraphNodeGraphNode7
+)
+
+
+class InvokeContext(TypedDict):
+    object_type: Literal['project_logs', 'experiment', 'dataset', 'playground_logs']
+    """
+    The type of object containing the span data
+    """
+    object_id: str
+    """
+    The ID of the object containing the span data
+    """
+    scope: InvokeScope
+
+
+class InvokeFunctionInvokeFunction7(TypedDict):
+    input: NotRequired[Any | None]
+    """
+    Argument to the function, which can be any JSON serializable value
+    """
+    expected: NotRequired[Any | None]
+    """
+    The expected output of the function
+    """
+    metadata: NotRequired[Mapping[str, Any] | None]
+    """
+    Any relevant metadata. This will be logged and available as the `metadata` argument.
+    """
+    tags: NotRequired[Sequence[str] | None]
+    """
+    Any relevant tags to log on the span.
+    """
+    messages: NotRequired[Sequence[ChatCompletionMessageParam] | None]
+    """
+    If the function is an LLM, additional messages to pass along to it
+    """
+    context: NotRequired[InvokeContext | None]
+    parent: NotRequired[InvokeParent | None]
+    stream: NotRequired[bool | None]
+    """
+    Whether to stream the response. If true, results will be returned in the Braintrust SSE format.
+    """
+    mode: NotRequired[StreamingMode | None]
+    strict: NotRequired[bool | None]
+    """
+    If true, throw an error if one of the variables in the prompt is not present in the input
+    """
+    mcp_auth: NotRequired[Mapping[str, InvokeFunctionMcpAuth] | None]
+    """
+    Map of MCP server URL to auth credentials
+    """
+    overrides: NotRequired[Mapping[str, Any] | None]
+    """
+    Partial function definition to merge with the function being invoked. Fields are validated against the function type's schema at runtime. For facets: { preprocessor?, prompt?, model? }. For prompts: { model?, ... }.
+    """
+
+
+class InvokeFunctionInvokeFunction8(InvokeFunctionInvokeFunction, InvokeFunctionInvokeFunction7):
+    pass
+
+
+class InvokeFunctionInvokeFunction9(InvokeFunctionInvokeFunction1, InvokeFunctionInvokeFunction7):
+    pass
+
+
+class InvokeFunctionInvokeFunction10(InvokeFunctionInvokeFunction2, InvokeFunctionInvokeFunction7):
+    pass
+
+
+class InvokeFunctionInvokeFunction11(InvokeFunctionInvokeFunction3, InvokeFunctionInvokeFunction7):
+    pass
+
+
+class InvokeFunctionInvokeFunction12(InvokeFunctionInvokeFunction4, InvokeFunctionInvokeFunction7):
+    pass
 
 
 class ProjectLogsEvent(TypedDict):
@@ -2394,7 +2936,7 @@ class ProjectLogsEvent(TypedDict):
     """
     The transaction id of an event is unique to the network operation that processed the event insertion. Transaction ids are monotonically increasing over time and can be used to retrieve a versioned snapshot of the project logs (see the `version` parameter)
     """
-    _pagination_key: NotRequired[Optional[str]]
+    _pagination_key: NotRequired[str | None]
     """
     A stable, time-ordered key that can be used to paginate over project logs events. This field is auto-generated by Braintrust and only exists in Brainstore.
     """
@@ -2414,39 +2956,39 @@ class ProjectLogsEvent(TypedDict):
     """
     A literal 'g' which identifies the log as a project log
     """
-    input: NotRequired[Optional[Any]]
+    input: NotRequired[Any | None]
     """
     The arguments that uniquely define a user input (an arbitrary, JSON serializable object).
     """
-    output: NotRequired[Optional[Any]]
+    output: NotRequired[Any | None]
     """
     The output of your application, including post-processing (an arbitrary, JSON serializable object), that allows you to determine whether the result is correct or not. For example, in an app that generates SQL queries, the `output` should be the _result_ of the SQL query generated by the model, not the query itself, because there may be multiple valid queries that answer a single question.
     """
-    expected: NotRequired[Optional[Any]]
+    expected: NotRequired[Any | None]
     """
     The ground truth value (an arbitrary, JSON serializable object) that you'd compare to `output` to determine if your `output` value is correct or not. Braintrust currently does not compare `output` to `expected` for you, since there are so many different ways to do that correctly. Instead, these values are just used to help you navigate while digging into analyses. However, we may later use these values to re-score outputs or fine-tune your models.
     """
-    error: NotRequired[Optional[Any]]
+    error: NotRequired[Any | None]
     """
     The error that occurred, if any.
     """
-    scores: NotRequired[Optional[Mapping[str, Any]]]
+    scores: NotRequired[Mapping[str, Any] | None]
     """
     A dictionary of numeric values (between 0 and 1) to log. The scores should give you a variety of signals that help you determine how accurate the outputs are compared to what you expect and diagnose failures. For example, a summarization app might have one score that tells you how accurate the summary is, and another that measures the word similarity between the generated and grouth truth summary. The word similarity score could help you determine whether the summarization was covering similar concepts or not. You can use these scores to help you sort, filter, and compare logs.
     """
-    metadata: NotRequired[Optional[ProjectLogsEventMetadata]]
+    metadata: NotRequired[ProjectLogsEventMetadata | None]
     """
     A dictionary with additional data about the test example, model outputs, or just about anything else that's relevant, that you can use to help find and analyze examples later. For example, you could log the `prompt`, example's `id`, or anything else that would be useful to slice/dice later. The values in `metadata` can be any JSON-serializable type, but its keys must be strings
     """
-    tags: NotRequired[Optional[Sequence[str]]]
+    tags: NotRequired[Sequence[str] | None]
     """
     A list of tags to log
     """
-    metrics: NotRequired[Optional[ProjectLogsEventMetrics]]
+    metrics: NotRequired[ProjectLogsEventMetrics | None]
     """
     Metrics are numerical measurements tracking the execution of the code that produced the project logs event. Use "start" and "end" to track the time span over which the project logs event was produced
     """
-    context: NotRequired[Optional[ProjectLogsEventContext]]
+    context: NotRequired[ProjectLogsEventContext | None]
     """
     Context is additional information about the code that produced the project logs event. It is essentially the textual counterpart to `metrics`. Use the `caller_*` attributes to track the location in code which produced the project logs event
     """
@@ -2454,7 +2996,7 @@ class ProjectLogsEvent(TypedDict):
     """
     A unique identifier used to link different project logs events together as part of a full trace. See the [tracing guide](https://www.braintrust.dev/docs/guides/tracing) for full details on tracing
     """
-    span_parents: NotRequired[Optional[Sequence[str]]]
+    span_parents: NotRequired[Sequence[str] | None]
     """
     An array of the parent `span_ids` of this project logs event. This should be empty for the root span of a trace, and should most often contain just one parent element for subspans
     """
@@ -2462,21 +3004,21 @@ class ProjectLogsEvent(TypedDict):
     """
     A unique identifier for the trace this project logs event belongs to
     """
-    is_root: NotRequired[Optional[bool]]
+    is_root: NotRequired[bool | None]
     """
     Whether this span is a root span
     """
-    span_attributes: NotRequired[Optional[SpanAttributes]]
-    origin: NotRequired[Optional[ObjectReferenceNullish]]
-    comments: NotRequired[Optional[Sequence[Any]]]
+    span_attributes: NotRequired[SpanAttributes | None]
+    origin: NotRequired[ObjectReferenceNullish | None]
+    comments: NotRequired[Sequence[Any] | None]
     """
     Optional list of comments attached to this event
     """
-    audit_data: NotRequired[Optional[Sequence[Any]]]
+    audit_data: NotRequired[Sequence[Any] | None]
     """
     Optional list of audit entries attached to this event
     """
-    _async_scoring_state: NotRequired[Optional[Any]]
+    _async_scoring_state: NotRequired[Any | None]
     """
     The async scoring state for this event
     """
@@ -2492,7 +3034,7 @@ class ProjectScore(TypedDict):
     Unique identifier for the project that the project score belongs under
     """
     user_id: str
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of project score creation
     """
@@ -2500,33 +3042,67 @@ class ProjectScore(TypedDict):
     """
     Name of the project score
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the project score
     """
     score_type: ProjectScoreType
-    categories: NotRequired[Optional[ProjectScoreCategories]]
-    config: NotRequired[Optional[ProjectScoreConfig]]
-    position: NotRequired[Optional[str]]
+    categories: NotRequired[ProjectScoreCategories | None]
+    config: NotRequired[ProjectScoreConfig | None]
+    position: NotRequired[str | None]
     """
     An optional LexoRank-based string that sets the sort position for the score in the UI
     """
 
 
 class PromptData(TypedDict):
-    prompt: NotRequired[Optional[PromptBlockDataNullish]]
-    options: NotRequired[Optional[PromptOptionsNullish]]
-    parser: NotRequired[Optional[PromptParserNullish]]
-    tool_functions: NotRequired[Optional[Sequence[SavedFunctionId]]]
-    origin: NotRequired[Optional[PromptDataOrigin]]
+    prompt: NotRequired[PromptBlockDataNullish | None]
+    options: NotRequired[PromptOptionsNullish | None]
+    parser: NotRequired[PromptParserNullish | None]
+    tool_functions: NotRequired[Sequence[SavedFunctionId] | None]
+    template_format: NotRequired[Literal['mustache', 'nunjucks', 'none'] | None]
+    mcp: NotRequired[Mapping[str, Any] | None]
+    origin: NotRequired[PromptDataOrigin | None]
 
 
 class PromptDataNullish(TypedDict):
-    prompt: NotRequired[Optional[PromptBlockDataNullish]]
-    options: NotRequired[Optional[PromptOptionsNullish]]
-    parser: NotRequired[Optional[PromptParserNullish]]
-    tool_functions: NotRequired[Optional[Sequence[SavedFunctionId]]]
-    origin: NotRequired[Optional[PromptDataNullishOrigin]]
+    prompt: NotRequired[PromptBlockDataNullish | None]
+    options: NotRequired[PromptOptionsNullish | None]
+    parser: NotRequired[PromptParserNullish | None]
+    tool_functions: NotRequired[Sequence[SavedFunctionId] | None]
+    template_format: NotRequired[Literal['mustache', 'nunjucks', 'none'] | None]
+    mcp: NotRequired[Mapping[str, Any] | None]
+    origin: NotRequired[PromptDataNullishOrigin | None]
+
+
+class TaskTask5(TypedDict):
+    inline_prompt: NotRequired[PromptData | None]
+    inline_function: Mapping[str, Any]
+    function_type: NotRequired[FunctionTypeEnum | None]
+    name: NotRequired[str | None]
+    """
+    The name of the inline function
+    """
+
+
+class TaskTask6(TypedDict):
+    inline_prompt: PromptData
+    function_type: NotRequired[FunctionTypeEnum | None]
+    name: NotRequired[str | None]
+    """
+    The name of the inline prompt
+    """
+
+
+class TaskTask13(TaskTask5, TaskTask7):
+    pass
+
+
+class TaskTask14(TaskTask6, TaskTask7):
+    pass
+
+
+Task: TypeAlias = TaskTask8 | TaskTask9 | TaskTask10 | TaskTask11 | TaskTask12 | TaskTask13 | TaskTask14
 
 
 class View(TypedDict):
@@ -2534,7 +3110,7 @@ class View(TypedDict):
     """
     Unique identifier for the view
     """
-    object_type: Optional[AclObjectType]
+    object_type: AclObjectType
     object_id: str
     """
     The id of the object the view applies to
@@ -2562,27 +3138,27 @@ class View(TypedDict):
     """
     Name of the view
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of view creation
     """
-    view_data: NotRequired[Optional[ViewData]]
-    options: NotRequired[Optional[ViewOptions]]
-    user_id: NotRequired[Optional[str]]
+    view_data: NotRequired[ViewData | None]
+    options: NotRequired[ViewOptions | None]
+    user_id: NotRequired[str | None]
     """
     Identifies the user who created the view
     """
-    deleted_at: NotRequired[Optional[str]]
+    deleted_at: NotRequired[str | None]
     """
     Date of role deletion, or null if the role is still active
     """
 
 
 class FunctionIdFunctionId5(TypedDict):
-    inline_prompt: NotRequired[Optional[PromptData]]
+    inline_prompt: NotRequired[PromptData | None]
     inline_function: Mapping[str, Any]
-    function_type: NotRequired[Optional[FunctionTypeEnum]]
-    name: NotRequired[Optional[str]]
+    function_type: NotRequired[FunctionTypeEnum | None]
+    name: NotRequired[str | None]
     """
     The name of the inline function
     """
@@ -2590,22 +3166,25 @@ class FunctionIdFunctionId5(TypedDict):
 
 class FunctionIdFunctionId6(TypedDict):
     inline_prompt: PromptData
-    function_type: NotRequired[Optional[FunctionTypeEnum]]
-    name: NotRequired[Optional[str]]
+    function_type: NotRequired[FunctionTypeEnum | None]
+    name: NotRequired[str | None]
     """
     The name of the inline prompt
     """
 
 
-FunctionId = Union[
-    FunctionIdFunctionId,
-    FunctionIdFunctionId1,
-    FunctionIdFunctionId2,
-    FunctionIdFunctionId3,
-    FunctionIdFunctionId4,
-    FunctionIdFunctionId5,
-    FunctionIdFunctionId6,
-]
+FunctionId: TypeAlias = (
+    FunctionIdFunctionId
+    | FunctionIdFunctionId1
+    | FunctionIdFunctionId2
+    | FunctionIdFunctionId3
+    | FunctionIdFunctionId4
+    | FunctionIdFunctionId5
+    | FunctionIdFunctionId6
+)
+"""
+Options for identifying a function
+"""
 
 
 class GraphData(TypedDict):
@@ -2614,39 +3193,47 @@ class GraphData(TypedDict):
     edges: Mapping[str, GraphEdge]
 
 
-class InvokeFunction(TypedDict):
-    input: NotRequired[Optional[Any]]
-    """
-    Argument to the function, which can be any JSON serializable value
-    """
-    expected: NotRequired[Optional[Any]]
-    """
-    The expected output of the function
-    """
-    metadata: NotRequired[Optional[Mapping[str, Any]]]
-    """
-    Any relevant metadata. This will be logged and available as the `metadata` argument.
-    """
-    tags: NotRequired[Optional[Sequence[str]]]
-    """
-    Any relevant tags to log on the span.
-    """
-    messages: NotRequired[Optional[Sequence[ChatCompletionMessageParam]]]
-    """
-    If the function is an LLM, additional messages to pass along to it
-    """
-    parent: NotRequired[Optional[InvokeParent]]
-    stream: NotRequired[Optional[bool]]
+class InvokeFunctionInvokeFunction5(TypedDict):
+    inline_prompt: NotRequired[PromptData | None]
+    inline_function: Mapping[str, Any]
+    function_type: NotRequired[FunctionTypeEnum | None]
+    name: NotRequired[str | None]
     """
-    Whether to stream the response. If true, results will be returned in the Braintrust SSE format.
+    The name of the inline function
     """
-    mode: NotRequired[Optional[StreamingMode]]
-    strict: NotRequired[Optional[bool]]
+
+
+class InvokeFunctionInvokeFunction6(TypedDict):
+    inline_prompt: PromptData
+    function_type: NotRequired[FunctionTypeEnum | None]
+    name: NotRequired[str | None]
     """
-    If true, throw an error if one of the variables in the prompt is not present in the input
+    The name of the inline prompt
     """
 
 
+class InvokeFunctionInvokeFunction13(InvokeFunctionInvokeFunction5, InvokeFunctionInvokeFunction7):
+    pass
+
+
+class InvokeFunctionInvokeFunction14(InvokeFunctionInvokeFunction6, InvokeFunctionInvokeFunction7):
+    pass
+
+
+InvokeFunction: TypeAlias = (
+    InvokeFunctionInvokeFunction8
+    | InvokeFunctionInvokeFunction9
+    | InvokeFunctionInvokeFunction10
+    | InvokeFunctionInvokeFunction11
+    | InvokeFunctionInvokeFunction12
+    | InvokeFunctionInvokeFunction13
+    | InvokeFunctionInvokeFunction14
+)
+"""
+Options for identifying a function
+"""
+
+
 class Prompt(TypedDict):
     id: str
     """
@@ -2676,24 +3263,24 @@ class Prompt(TypedDict):
     """
     Unique identifier for the prompt
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the prompt
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of prompt creation
     """
-    prompt_data: NotRequired[Optional[PromptDataNullish]]
-    tags: NotRequired[Optional[Sequence[str]]]
+    prompt_data: NotRequired[PromptDataNullish | None]
+    tags: NotRequired[Sequence[str] | None]
     """
     A list of tags for the prompt
     """
-    metadata: NotRequired[Optional[Mapping[str, Any]]]
+    metadata: NotRequired[Mapping[str, Any] | None]
     """
     User-controlled metadata about the prompt
     """
-    function_type: NotRequired[Optional[FunctionTypeEnumNullish]]
+    function_type: NotRequired[FunctionTypeEnumNullish | None]
 
 
 class RunEval(TypedDict):
@@ -2701,79 +3288,81 @@ class RunEval(TypedDict):
     """
     Unique identifier for the project to run the eval in
     """
-    data: Union[RunEvalData, RunEvalData1, RunEvalData2]
+    data: RunEvalData | RunEvalData1 | RunEvalData2
     """
     The dataset to use
     """
-    task: FunctionId
+    task: Task
     scores: Sequence[FunctionId]
     """
     The functions to score the eval on
     """
-    experiment_name: NotRequired[Optional[str]]
+    experiment_name: NotRequired[str | None]
     """
     An optional name for the experiment created by this eval. If it conflicts with an existing experiment, it will be suffixed with a unique identifier.
     """
-    metadata: NotRequired[Optional[Mapping[str, Any]]]
+    metadata: NotRequired[Mapping[str, Any] | None]
     """
     Optional experiment-level metadata to store about the evaluation. You can later use this to slice & dice across experiments.
     """
-    parent: NotRequired[Optional[InvokeParent]]
-    stream: NotRequired[Optional[bool]]
+    parent: NotRequired[Parent | None]
+    stream: NotRequired[bool | None]
     """
     Whether to stream the results of the eval. If true, the request will return two events: one to indicate the experiment has started, and another upon completion. If false, the request will return the evaluation's summary upon completion.
     """
-    trial_count: NotRequired[Optional[float]]
+    trial_count: NotRequired[float | None]
     """
     The number of times to run the evaluator per input. This is useful for evaluating applications that have non-deterministic behavior and gives you both a stronger aggregate measure and a sense of the variance in the results.
     """
-    is_public: NotRequired[Optional[bool]]
+    is_public: NotRequired[bool | None]
     """
     Whether the experiment should be public. Defaults to false.
     """
-    timeout: NotRequired[Optional[float]]
+    timeout: NotRequired[float | None]
     """
     The maximum duration, in milliseconds, to run the evaluation. Defaults to undefined, in which case there is no timeout.
     """
-    max_concurrency: NotRequired[Optional[float]]
+    max_concurrency: NotRequired[float | None]
     """
     The maximum number of tasks/scorers that will be run concurrently. Defaults to 10. If null is provided, no max concurrency will be used.
     """
-    base_experiment_name: NotRequired[Optional[str]]
+    base_experiment_name: NotRequired[str | None]
     """
     An optional experiment name to use as a base. If specified, the new experiment will be summarized and compared to this experiment.
     """
-    base_experiment_id: NotRequired[Optional[str]]
+    base_experiment_id: NotRequired[str | None]
     """
     An optional experiment id to use as a base. If specified, the new experiment will be summarized and compared to this experiment.
     """
-    git_metadata_settings: NotRequired[Optional[GitMetadataSettings]]
-    repo_info: NotRequired[Optional[RepoInfo]]
-    strict: NotRequired[Optional[bool]]
+    git_metadata_settings: NotRequired[GitMetadataSettings | None]
+    repo_info: NotRequired[RepoInfo | None]
+    strict: NotRequired[bool | None]
     """
     If true, throw an error if one of the variables in the prompt is not present in the input
     """
-    stop_token: NotRequired[Optional[str]]
+    stop_token: NotRequired[str | None]
     """
     The token to stop the run
     """
-    extra_messages: NotRequired[Optional[str]]
+    extra_messages: NotRequired[str | None]
     """
     A template path of extra messages to append to the conversion. These messages will be appended to the end of the conversation, after the last message.
     """
-    tags: NotRequired[Optional[Sequence[str]]]
+    tags: NotRequired[Sequence[str] | None]
     """
     Optional tags that will be added to the experiment.
     """
+    mcp_auth: NotRequired[Mapping[str, RunEvalMcpAuth] | None]
 
 
-FunctionData = Union[
-    FunctionDataFunctionData,
-    FunctionDataFunctionData1,
-    GraphData,
-    FunctionDataFunctionData2,
-    FunctionDataFunctionData3,
-]
+FunctionData: TypeAlias = (
+    FunctionDataFunctionData
+    | FunctionDataFunctionData1
+    | GraphData
+    | FunctionDataFunctionData2
+    | FunctionDataFunctionData3
+    | FacetData
+)
 
 
 class Function(TypedDict):
@@ -2805,27 +3394,27 @@ class Function(TypedDict):
     """
     Unique identifier for the prompt
     """
-    description: NotRequired[Optional[str]]
+    description: NotRequired[str | None]
     """
     Textual description of the prompt
     """
-    created: NotRequired[Optional[str]]
+    created: NotRequired[str | None]
     """
     Date of prompt creation
     """
-    prompt_data: NotRequired[Optional[PromptDataNullish]]
-    tags: NotRequired[Optional[Sequence[str]]]
+    prompt_data: NotRequired[PromptDataNullish | None]
+    tags: NotRequired[Sequence[str] | None]
     """
     A list of tags for the prompt
     """
-    metadata: NotRequired[Optional[Mapping[str, Any]]]
+    metadata: NotRequired[Mapping[str, Any] | None]
     """
     User-controlled metadata about the prompt
     """
-    function_type: NotRequired[Optional[FunctionTypeEnumNullish]]
+    function_type: NotRequired[FunctionTypeEnumNullish | None]
     function_data: FunctionData
-    origin: NotRequired[Optional[FunctionOrigin]]
-    function_schema: NotRequired[Optional[FunctionFunctionSchema]]
+    origin: NotRequired[FunctionOrigin | None]
+    function_schema: NotRequired[FunctionFunctionSchema | None]
     """
     JSON schema for the function's parameters and return type
     """