UncountablePythonSDK 0.0.184__tar.gz → 0.0.186__tar.gz

{uncountablepythonsdk-0.0.184/UncountablePythonSDK.egg-info → uncountablepythonsdk-0.0.186}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UncountablePythonSDK
-Version: 0.0.184
+Version: 0.0.186
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git
@@ -34,7 +34,7 @@ Requires-Dist: paramiko==5.*
 Requires-Dist: boto3==1.*
 Requires-Dist: flask==3.*
 Requires-Dist: simplejson==3.*
-Requires-Dist: grpcio==1.78.0
+Requires-Dist: grpcio==1.83.0
 Requires-Dist: protobuf>=4.21.1
 Requires-Dist: azure-storage-blob==12.*
 Requires-Dist: azure-storage-file-share==12.*

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186/UncountablePythonSDK.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: UncountablePythonSDK
-Version: 0.0.184
+Version: 0.0.186
 Summary: Uncountable SDK
 Project-URL: Homepage, https://github.com/uncountableinc/uncountable-python-sdk
 Project-URL: Repository, https://github.com/uncountableinc/uncountable-python-sdk.git
@@ -34,7 +34,7 @@ Requires-Dist: paramiko==5.*
 Requires-Dist: boto3==1.*
 Requires-Dist: flask==3.*
 Requires-Dist: simplejson==3.*
-Requires-Dist: grpcio==1.78.0
+Requires-Dist: grpcio==1.83.0
 Requires-Dist: protobuf>=4.21.1
 Requires-Dist: azure-storage-blob==12.*
 Requires-Dist: azure-storage-file-share==12.*

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/UncountablePythonSDK.egg-info/SOURCES.txt

@@ -47,6 +47,7 @@ examples/integration-server/pyproject.toml
 examples/integration-server/jobs/materials_auto/concurrent_cron.py
 examples/integration-server/jobs/materials_auto/example_cron.py
 examples/integration-server/jobs/materials_auto/example_http.py
+examples/integration-server/jobs/materials_auto/example_http_get.py
 examples/integration-server/jobs/materials_auto/example_instrument.py
 examples/integration-server/jobs/materials_auto/example_parse.py
 examples/integration-server/jobs/materials_auto/example_predictions.py
@@ -322,6 +323,7 @@ uncountable/types/api/condition_parameters/__init__.py
 uncountable/types/api/condition_parameters/upsert_condition_match.py
 uncountable/types/api/condition_parameters/upsert_condition_matches.py
 uncountable/types/api/entity/__init__.py
+uncountable/types/api/entity/add_entity_comment.py
 uncountable/types/api/entity/create_entities.py
 uncountable/types/api/entity/create_entity.py
 uncountable/types/api/entity/create_or_update_entities.py

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/UncountablePythonSDK.egg-info/requires.txt

@@ -16,7 +16,7 @@ paramiko==5.*
 boto3==1.*
 flask==3.*
 simplejson==3.*
-grpcio==1.78.0
+grpcio==1.83.0
 protobuf>=4.21.1
 azure-storage-blob==12.*
 azure-storage-file-share==12.*

uncountablepythonsdk-0.0.186/examples/integration-server/jobs/materials_auto/example_http_get.py

@@ -0,0 +1,44 @@
+import json
+
+from uncountable.integration.http_server import (
+    GenericHttpRequest,
+    GenericHttpResponse,
+    HttpException,
+)
+from uncountable.integration.job import CustomHttpJob, register_job
+from uncountable.types import job_definition_t
+
+_EXPECTED_USER_ID = 1
+
+
+@register_job
+class HttpGetExample(CustomHttpJob):
+    @staticmethod
+    def validate_request(
+        *,
+        request: GenericHttpRequest,
+        job_definition: job_definition_t.HttpJobDefinitionBase,  # ruff:ignore[unused-static-method-argument]
+        profile_meta: job_definition_t.ProfileMetadata,
+    ) -> None:
+        if (
+            CustomHttpJob.get_validated_oauth_request_user_id(
+                request=request, profile_metadata=profile_meta
+            )
+            != _EXPECTED_USER_ID
+        ):
+            raise HttpException(
+                message="unauthorized; invalid oauth token", error_code=401
+            )
+
+    @staticmethod
+    def handle_request(
+        *,
+        request: GenericHttpRequest,
+        job_definition: job_definition_t.HttpJobDefinitionBase,  # ruff:ignore[unused-static-method-argument]
+        profile_meta: job_definition_t.ProfileMetadata,  # ruff:ignore[unused-static-method-argument]
+    ) -> GenericHttpResponse:
+        return GenericHttpResponse(
+            response=json.dumps(request.query_params),
+            status_code=200,
+            headers={"Content-Type": "application/json"},
+        )

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/examples/integration-server/jobs/materials_auto/profile.yaml

@@ -74,6 +74,13 @@ jobs:
     executor:
       type: script
       import_path: example_http
+  - id: example_http_get
+    type: custom_http
+    name: Custom HTTP GET
+    http_method: get
+    executor:
+      type: script
+      import_path: example_http_get
   - id: example_runsheet_wh
     type: webhook
     name: Runsheet Webhook

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/pkgs/serialization_util/_get_type_for_serialization.py

@@ -17,11 +17,11 @@ class SerializationType(StrEnum):
 
 
 @functools.lru_cache(maxsize=500000)
-def get_serialization_type(type: Any) -> SerializationType:
-    super_classes = set(type.__mro__)
+def get_serialization_type(obj_type: Any) -> SerializationType:
+    super_classes = set(obj_type.__mro__)
 
     # check is named tuple
-    if tuple in super_classes and hasattr(type, "_fields"):
+    if tuple in super_classes and hasattr(obj_type, "_fields"):
         return SerializationType.NAMED_TUPLE
 
     if list in super_classes or set in super_classes or tuple in super_classes:
@@ -30,7 +30,7 @@ def get_serialization_type(type: Any) -> SerializationType:
     if dict in super_classes:
         return SerializationType.DICT
 
-    if dataclasses.is_dataclass(type):
+    if dataclasses.is_dataclass(obj_type):
         return SerializationType.DATACLASS
 
     if Enum in super_classes and str in super_classes:

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/pkgs/serialization_util/serialization_helpers.py

@@ -210,8 +210,7 @@ def serialize_for_api(obj: Any) -> JsonValue:
         serialization_type == SerializationType.UNKNOWN
     ):  # performance optimization to not do function lookup
         return obj  # type: ignore
-    r = _CONVERSION_SERIALIZATION_FUNCS[serialization_type](obj)
-    return r
+    return _CONVERSION_SERIALIZATION_FUNCS[serialization_type](obj)
 
 
 _SERIALIZATION_FUNCS_DICT: dict[

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/pkgs/type_spec/emit_python.py

@@ -1,4 +1,5 @@
 import dataclasses
+import functools
 import io
 import os
 from decimal import Decimal
@@ -1148,6 +1149,17 @@ def refer_to(ctx: TrackingContext, stype: builder.SpecType) -> str:
 SpecEndpoint = builder.SpecEndpoint
 
 
+def _route_identifier(
+    endpoint: SpecEndpoint, *, endpoint_root: str
+) -> tuple[str, str, str]:
+    endpoint_specific_path = endpoint.path_per_api_endpoint[endpoint_root]
+    return (
+        endpoint_specific_path.path_dirname,
+        endpoint_specific_path.path_basename,
+        endpoint.method,
+    )
+
+
 def _emit_routes(*, builder: builder.SpecBuilder, config: PythonConfig) -> None:
     for endpoint_root in builder.api_endpoints:
         endpoints: list[SpecEndpoint] = []
@@ -1188,17 +1200,13 @@ from main.site.framework.types import {static_route_imports}
 """
         )
 
-        def _route_identifier(endpoint: SpecEndpoint) -> tuple[str, str, str]:
-            endpoint_specific_path = endpoint.path_per_api_endpoint[endpoint_root]
-            return (
-                endpoint_specific_path.path_dirname,
-                endpoint_specific_path.path_basename,
-                endpoint.method,
-            )
+        route_identifier = functools.partial(
+            _route_identifier, endpoint_root=endpoint_root
+        )
 
-        sorted_endpoints = sorted(endpoints, key=_route_identifier)
+        sorted_endpoints = sorted(endpoints, key=route_identifier)
 
-        assert len(endpoints) == len(set(map(_route_identifier, endpoints))), (
+        assert len(endpoints) == len(set(map(route_identifier, endpoints))), (
             "Endpoints are not unique"
         )
 
@@ -1309,39 +1317,64 @@ def _emit_namespace_imports(
 
 def _emit_id_source(*, builder: builder.SpecBuilder, config: PythonConfig) -> None:
     """
-    Create a map of full-type-name to enums for use in id-source.
+    Create a map of full-type-name to enum data for use in id-source. The values are
+    plain data (member values, labels, deprecated) so importing this file does not pull
+    in the generated type modules.
     """
     id_source_output = config.id_source_output
     if id_source_output is None:
         return
-    enum_out = io.StringIO()
-    enum_out.write(f"{LINT_HEADER}{MODIFY_NOTICE}\n")
-    enum_out.write("import typing\n")
-    enum_out.write("from enum import StrEnum\n")
 
-    ctx = TrackingContext()
-    # In this context the propername
     named_enums = {
-        builder.resolve_proper_name(string_enum): refer_to(ctx, string_enum)
+        builder.resolve_proper_name(string_enum): string_enum
         for string_enum in builder.emit_id_source_enums
     }
 
-    _emit_namespace_imports(
-        out=enum_out, namespaces=ctx.namespaces, from_namespace=None, config=config
-    )
-
+    body = io.StringIO()
     known_keys = []
-    enum_out.write("\nENUM_MAP: dict[str, type[StrEnum]] = {\n")
+    any_labels = False
+    body.write("\nENUM_MAP: dict[str, EnumRegistryEntry] = {\n")
     for key in sorted(named_enums.keys()):
-        enum_out.write(f'{INDENT}"{key}": {named_enums[key]},\n')
+        string_enum = named_enums[key]
+        entries = list(string_enum.values.values())
+        member_values = [f'"{entry.value}"' for entry in entries]
+        members = ", ".join(member_values)
+        single_element_comma = "," if len(member_values) == 1 else ""
+        labels = {
+            entry.value: entry.label for entry in entries if entry.label is not None
+        }
+        deprecated = [entry.value for entry in entries if entry.deprecated is True]
+        body.write(f'{INDENT}"{key}": EnumRegistryEntry(\n')
+        body.write(f"{2 * INDENT}members=({members}{single_element_comma}),\n")
+        if labels:
+            any_labels = True
+            body.write(f"{2 * INDENT}labels=MappingProxyType({{\n")
+            for value, label in labels.items():
+                body.write(f'{3 * INDENT}"{value}": "{label}",\n')
+            body.write(f"{2 * INDENT}}}),\n")
+        if deprecated:
+            dep = ", ".join(f'"{value}"' for value in deprecated)
+            body.write(f"{2 * INDENT}deprecated=frozenset({{{dep}}}),\n")
+        body.write(f"{INDENT}),\n")
         known_keys.append(f'"{key}"')
-    enum_out.write(f"}}\n{MODIFY_NOTICE}\n")
+    body.write(f"}}\n{MODIFY_NOTICE}\n")
+
+    enum_out = io.StringIO()
+    enum_out.write(f"{LINT_HEADER}{MODIFY_NOTICE}\n")
+    enum_out.write("import typing\n")
+    if any_labels:
+        enum_out.write("from types import MappingProxyType\n")
+    enum_out.write(
+        "from main.unc.materials.id_source_construct.enum_registry import "
+        "EnumRegistryEntry\n"
+    )
+    enum_out.write(body.getvalue())
 
     enum_out.write(f"\nKnownEnumsType = typing.Literal[\n{INDENT}")
     enum_out.write(f",\n{INDENT}".join(known_keys))
     enum_out.write(f"\n]\n{MODIFY_NOTICE}\n")
 
-    enum_out.write(f'\n{MODIFY_NOTICE}\n__all__ = ["ENUM_MAP"]\n')
+    enum_out.write(f'\n{MODIFY_NOTICE}\n__all__ = ["ENUM_MAP", "KnownEnumsType"]\n')
     enum_out.write(f"{MODIFY_NOTICE}\n{LINT_FOOTER}")
 
     util.rewrite_file(id_source_output, enum_out.getvalue())

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/pkgs/type_spec/test.py

@@ -2,11 +2,11 @@ from .util import format_parsed_type, parse_type_str
 
 
 def test_parse() -> None:
-    def check(input: str) -> None:
-        pt = parse_type_str(input)
+    def check(type_str: str) -> None:
+        pt = parse_type_str(type_str)
         fmt = format_parsed_type(pt)
-        assert input == fmt
-        print(input, "=", fmt)
+        assert type_str == fmt
+        print(type_str, "=", fmt)
 
     check("Simple.path.more")
     check("path.List<Integer>")

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/pkgs/type_spec/ui_entry_actions/generate_ui_entry_actions.py

@@ -53,12 +53,12 @@ def ui_entry_variable_to_type_spec_type(
 
 
 def construct_inputs_type_data(
-    vars: dict[str, ui_entry_actions_t.UiEntryActionVariable],
+    action_vars: dict[str, ui_entry_actions_t.UiEntryActionVariable],
 ) -> RawDict:
-    if len(vars) == 0:
+    if len(action_vars) == 0:
         return {"type": BaseTypeName.s_object}
     properties: dict[str, dict[str, str]] = {}
-    for input_name, input_defn in (vars).items():
+    for input_name, input_defn in (action_vars).items():
         properties[f"{input_name}"] = {
             "type": ui_entry_variable_to_type_spec_type(input_defn)
         }
@@ -66,12 +66,12 @@ def construct_inputs_type_data(
 
 
 def construct_outputs_type_data(
-    vars: dict[str, ui_entry_actions_t.UiEntryActionOutput],
+    action_vars: dict[str, ui_entry_actions_t.UiEntryActionOutput],
 ) -> RawDict:
-    if len(vars) == 0:
+    if len(action_vars) == 0:
         return {"type": BaseTypeName.s_object}
     properties: dict[str, dict[str, str]] = {}
-    for output_name, output_defn in (vars).items():
+    for output_name, output_defn in (action_vars).items():
         # All outputs are optional
         properties[f"{output_name}"] = {
             "type": f"Optional<{convert_from_value_spec_type(output_defn.vs_type)}>"
@@ -82,7 +82,7 @@ def construct_outputs_type_data(
 def construct_outputs_type(
     *,
     action_scope: ui_entry_actions_t.ActionScope,
-    vars: dict[str, ui_entry_actions_t.UiEntryActionOutput],
+    action_vars: dict[str, ui_entry_actions_t.UiEntryActionOutput],
     builder: SpecBuilder,
     namespace: SpecNamespace,
 ) -> SpecTypeDefnObject:
@@ -93,7 +93,7 @@ def construct_outputs_type(
     namespace.types[stype.name] = stype
     stype.process(
         builder=builder,
-        data=construct_outputs_type_data(vars=vars),
+        data=construct_outputs_type_data(action_vars=action_vars),
     )
     return stype
 
@@ -101,7 +101,7 @@ def construct_outputs_type(
 def construct_inputs_type(
     *,
     action_scope: ui_entry_actions_t.ActionScope,
-    vars: dict[str, ui_entry_actions_t.UiEntryActionVariable],
+    action_vars: dict[str, ui_entry_actions_t.UiEntryActionVariable],
     builder: SpecBuilder,
     namespace: SpecNamespace,
 ) -> SpecTypeDefnObject:
@@ -109,7 +109,7 @@ def construct_inputs_type(
         namespace=namespace,
         name=emit_typescript_util.ts_type_name(f"{action_scope}_inputs"),
     )
-    stype.process(builder=builder, data=construct_inputs_type_data(vars))
+    stype.process(builder=builder, data=construct_inputs_type_data(action_vars))
     namespace.types[stype.name] = stype
     return stype
 
@@ -140,13 +140,13 @@ def emit_entry_action_definition(
 ) -> EntryActionTypeInfo:
     inputs_type = construct_inputs_type(
         action_scope=action_scope,
-        vars=defn.inputs,
+        action_vars=defn.inputs,
         builder=builder,
         namespace=ctx.namespace,
     )
     outputs_type = construct_outputs_type(
         action_scope=action_scope,
-        vars=defn.outputs,
+        action_vars=defn.outputs,
         builder=builder,
         namespace=ctx.namespace,
     )
@@ -158,12 +158,12 @@ def emit_entry_action_definition(
     )
 
 
-def _validate_input(input: ui_entry_actions_t.UiEntryActionVariable) -> None:
-    if "_" in input.vs_var_name:
-        raise ValueError(f"Expected camelCase for variable {input.vs_var_name}")
-    if not re.fullmatch(base_t.REF_NAME_STRICT_REGEX, input.vs_var_name):
+def _validate_input(variable: ui_entry_actions_t.UiEntryActionVariable) -> None:
+    if "_" in variable.vs_var_name:
+        raise ValueError(f"Expected camelCase for variable {variable.vs_var_name}")
+    if not re.fullmatch(base_t.REF_NAME_STRICT_REGEX, variable.vs_var_name):
         raise ValueError(
-            f"Variable {input.vs_var_name} has invalid syntax. See REF_NAME_STRICT_REGEX"
+            f"Variable {variable.vs_var_name} has invalid syntax. See REF_NAME_STRICT_REGEX"
         )
 
 

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/pyproject.toml

@@ -69,7 +69,7 @@ dependencies = [
     "boto3 == 1.*",
     "flask == 3.*",
     "simplejson == 3.*",
-    "grpcio == 1.78.0",
+    "grpcio == 1.83.0",
     "protobuf >= 4.21.1",
     "azure-storage-blob == 12.*",
     "azure-storage-file-share == 12.*",

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/uncountable/integration/http_server/types.py

@@ -68,6 +68,7 @@ class HttpException(Exception):
 class GenericHttpRequest:
     body_base64: str
     headers: dict[str, str]
+    query_params: dict[str, list[str]]
 
     @functools.cached_property
     def body_bytes(self) -> bytes:

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/uncountable/integration/webhook_server/entrypoint.py

@@ -1,4 +1,5 @@
 import base64
+from typing import assert_never
 
 import flask
 from flask.typing import ResponseReturnValue
@@ -16,12 +17,31 @@ from uncountable.types import job_definition_t
 
 app = flask.Flask(__name__)
 
+HttpJobDefinition = (
+    job_definition_t.CustomHttpJobDefinition
+    | job_definition_t.WebhookJobDefinition
+    | job_definition_t.UncountableWebhookJobDefinition
+)
+
+
+def _resolve_route_http_method(job: HttpJobDefinition) -> job_definition_t.HttpMethod:
+    match job:
+        case job_definition_t.CustomHttpJobDefinition():
+            return job.http_method
+        case (
+            job_definition_t.WebhookJobDefinition()
+            | job_definition_t.UncountableWebhookJobDefinition()
+        ):
+            return job_definition_t.HttpMethod.POST
+        case _:
+            assert_never(job)
+
 
 def register_route(
     *,
     server_logger: Logger,
     profile_meta: job_definition_t.ProfileMetadata,
-    job: job_definition_t.HttpJobDefinitionBase,
+    job: HttpJobDefinition,
 ) -> None:
     route = f"/{profile_meta.name}/{job.id}"
     log_attributes = {
@@ -56,6 +76,7 @@ def register_route(
                 http_request = GenericHttpRequest(
                     body_base64=base64.b64encode(flask.request.get_data()).decode(),
                     headers=dict(flask.request.headers),
+                    query_params=flask.request.args.to_dict(flat=False),
                 )
                 job_instance.validate_request(
                     request=http_request, job_definition=job, profile_meta=profile_meta
@@ -88,7 +109,7 @@ def register_route(
         route,
         endpoint=f"handle_request_{job.id}",
         view_func=handle_request,
-        methods=["POST"],
+        methods=[_resolve_route_http_method(job).value.upper()],
     )
 
     server_logger.log_debug(
@@ -103,10 +124,21 @@ def main() -> None:
     for profile_metadata in profiles:
         server_logger = Logger(get_current_span())
         for job in profile_metadata.jobs:
-            if isinstance(job, job_definition_t.HttpJobDefinitionBase):
-                register_route(
-                    server_logger=server_logger, profile_meta=profile_metadata, job=job
-                )
+            match job:
+                case job_definition_t.CronJobDefinition():
+                    continue
+                case (
+                    job_definition_t.CustomHttpJobDefinition()
+                    | job_definition_t.WebhookJobDefinition()
+                    | job_definition_t.UncountableWebhookJobDefinition()
+                ):
+                    register_route(
+                        server_logger=server_logger,
+                        profile_meta=profile_metadata,
+                        job=job,
+                    )
+                case _:
+                    assert_never(job)
 
 
 main()

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/uncountable/types/__init__.py

@@ -2,6 +2,7 @@
 # ruff: noqa: E402 Q003
 # fmt: off
 # isort: skip_file
+from .api.entity import add_entity_comment as add_entity_comment_t
 from .api.file_folders import add_file_to_folder as add_file_to_folder_t
 from .api.notebooks import add_notebook_content as add_notebook_content_t
 from .api.recipes import add_recipe_to_project as add_recipe_to_project_t
@@ -166,6 +167,7 @@ from . import workflows_t as workflows_t
 
 
 __all__: list[str] = [
+    "add_entity_comment_t",
     "add_file_to_folder_t",
     "add_notebook_content_t",
     "add_recipe_to_project_t",

uncountablepythonsdk-0.0.186/uncountable/types/api/entity/add_entity_comment.py

@@ -0,0 +1,43 @@
+# DO NOT MODIFY -- This file is generated by type_spec
+# ruff: noqa: E402 Q003
+# fmt: off
+# isort: skip_file
+from __future__ import annotations
+import typing  # noqa: F401
+import datetime  # noqa: F401
+from decimal import Decimal  # noqa: F401
+import dataclasses
+from pkgs.serialization import serial_class
+from ... import entity_t
+
+__all__: list[str] = [
+    "Arguments",
+    "Data",
+    "ENDPOINT_DESCRIPTION",
+    "ENDPOINT_METHOD",
+    "ENDPOINT_PATH",
+]
+
+ENDPOINT_METHOD = "POST"
+ENDPOINT_PATH = "api/external/entity/external_add_entity_comment"
+ENDPOINT_DESCRIPTION = "Adds a comment to an entity, creating the entity's comment thread when one does not exist yet. Watchers of the entity and of its comment thread are notified. Comments are not idempotent: each call adds a new comment."
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.add_entity_comment.Arguments",
+)
+@dataclasses.dataclass(slots=True, kw_only=True)
+class Arguments:
+    entity_identifier: entity_t.EntityIdentifier
+    content: str
+
+
+# DO NOT MODIFY -- This file is generated by type_spec
+@serial_class(
+    named_type_path="sdk.api.entity.add_entity_comment.Data",
+)
+@dataclasses.dataclass(slots=True, kw_only=True)
+class Data:
+    pass
+# DO NOT MODIFY -- This file is generated by type_spec

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/uncountable/types/api/files/download_file.py

@@ -30,7 +30,7 @@ __all__: list[str] = [
 
 ENDPOINT_METHOD = "GET"
 ENDPOINT_PATH = "api/external/files/download_file"
-ENDPOINT_DESCRIPTION = "Download an attachment field value from an entity (e.g. a file attached to a form field) by entity + field reference, or download a text document by its ID. When querying by entity field, if the field contains a single file it is returned directly (X-File-Download-Type: raw); if multiple files are attached, they are bundled into a ZIP archive (X-File-Download-Type: archive). For downloading the binary file stored on a recipe output of type image or file, use recipes/external_download_recipe_output_file instead."
+ENDPOINT_DESCRIPTION = "Download an attachment field value from an entity (e.g. a file attached to a form field) by entity + field reference, or download a text document by its ID. When querying by entity field, if the field contains a single file it is returned directly (X-File-Download-Type: raw); if multiple files are attached, they are bundled into a ZIP archive (X-File-Download-Type: archive). For downloading the binary file stored on a recipe output of type image or file, use recipes/external_download_recipe_output_file instead. A file that has not cleared virus scanning is not returned: a file still being scanned responds with HTTP 422 indicating the scan is in progress, and a file that failed the scan responds with HTTP 422 indicating a security-scan failure."
 
 
 # DO NOT MODIFY -- This file is generated by type_spec

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/uncountable/types/api/uploader/invoke_uploader.py

@@ -23,7 +23,7 @@ __all__: list[str] = [
 
 ENDPOINT_METHOD = "POST"
 ENDPOINT_PATH = "api/external/uploader/invoke_uploader"
-ENDPOINT_DESCRIPTION = "Processes one or more uploaded files through a configured uploader, parsing and writing the extracted data to a recipe destination. Resolves the uploader by its identifier key and requires READ_ALL permission on the uploader entity. The file_ids parameter is preferred; file_id is deprecated. Non-SDK users should use file_upload/external_create_file_record to upload files first. SDK users can use the client.upload_files() helper method. Supports async batch execution."
+ENDPOINT_DESCRIPTION = "Processes one or more uploaded files through a configured uploader, parsing and writing the extracted data to a recipe destination. Resolves the uploader by its identifier key, or selects it by detection keyword and file extension when uploader_key is null. Requires READ_ALL permission on the uploader entity. The file_ids parameter is preferred; file_id is deprecated. Non-SDK users should use file_upload/external_create_file_record to upload files first. SDK users can use the client.upload_files() helper method. Supports async batch execution."
 
 
 # DO NOT MODIFY -- This file is generated by type_spec
@@ -32,7 +32,7 @@ ENDPOINT_DESCRIPTION = "Processes one or more uploaded files through a configure
 )
 @dataclasses.dataclass(slots=True, kw_only=True)
 class Arguments:
-    uploader_key: identifier_t.IdentifierKey
+    uploader_key: identifier_t.IdentifierKey | None
     destination: generic_upload_t.UploadDestination
     file_id: base_t.ObjectId | None = None
     file_ids: list[base_t.ObjectId] | None = None

{uncountablepythonsdk-0.0.184 → uncountablepythonsdk-0.0.186}/uncountable/types/async_batch_processor.py

@@ -532,16 +532,17 @@ class AsyncBatchProcessorBase(ABC):
     def invoke_uploader(
         self,
         *,
-        uploader_key: identifier_t.IdentifierKey,
+        uploader_key: identifier_t.IdentifierKey | None,
         destination: generic_upload_t.UploadDestination,
         file_id: base_t.ObjectId | None = None,
         file_ids: list[base_t.ObjectId] | None = None,
         depends_on: list[str] | None = None,
         _request_options: client_config_t.RequestOptions | None = None,
     ) -> async_batch_t.QueuedAsyncBatchRequest:
-        """Processes one or more uploaded files through a configured uploader, parsing and writing the extracted data to a recipe destination. Resolves the uploader by its identifier key and requires READ_ALL permission on the uploader entity. The file_ids parameter is preferred; file_id is deprecated. Non-SDK users should use file_upload/external_create_file_record to upload files first. SDK users can use the client.upload_files() helper method. Supports async batch execution.
+        """Processes one or more uploaded files through a configured uploader, parsing and writing the extracted data to a recipe destination. Resolves the uploader by its identifier key, or selects it by detection keyword and file extension when uploader_key is null. Requires READ_ALL permission on the uploader entity. The file_ids parameter is preferred; file_id is deprecated. Non-SDK users should use file_upload/external_create_file_record to upload files first. SDK users can use the client.upload_files() helper method. Supports async batch execution.
 
         :param file_id: DEPRECATED: use file_ids
+        :param uploader_key: Name an uploader, or pass null to select one by detection keyword and file extension, which fails unless exactly one uploader matches.
         :param depends_on: A list of batch reference keys to process before processing this request
         """
         args = invoke_uploader_t.Arguments(