nv-ingest-client 2025.10.9.dev20251009__py3-none-any.whl → 2025.10.10.dev20251010__py3-none-any.whl

nv_ingest_client/client/client.py

@@ -239,6 +239,9 @@ class _ConcurrentProcessor:
 
         is_failed, description = check_ingest_result(result_data)
 
+        if trace_id:
+            self.client.register_parent_trace_id(trace_id)
+
         if is_failed:
             failed_job_spec = self.client._job_index_to_job_spec.get(job_index)
             self.failures.append((f"{job_index}:{failed_job_spec.source_id}", description))
@@ -722,6 +725,7 @@ class NvIngestClient:
         except ValueError:
             self._telemetry_max_calls = 10000
         self._telemetry = {}
+        self._completed_parent_trace_ids: List[str] = []  # 1054
         self.reset_telemetry()
 
     def __str__(self) -> str:
@@ -1794,3 +1798,19 @@ class NvIngestClient:
             job_ids.append(job_id)
 
         return job_ids
+
+    def register_parent_trace_id(self, trace_id: Optional[str]) -> None:
+        """Record a parent trace identifier once its aggregation completed."""
+
+        if not trace_id:
+            return
+
+        if trace_id not in self._completed_parent_trace_ids:
+            self._completed_parent_trace_ids.append(trace_id)
+
+    def consume_completed_parent_trace_ids(self) -> List[str]:
+        """Return and clear the set of completed parent trace identifiers."""
+
+        trace_ids = list(self._completed_parent_trace_ids)
+        self._completed_parent_trace_ids.clear()
+        return trace_ids

nv_ingest_client/client/interface.py

@@ -426,20 +426,25 @@ class Ingestor:
             'concurrency_limit', 'timeout', 'max_job_retries', 'retry_delay',
             'data_only', 'return_full_response', 'verbose'. Unrecognized keys are passed
             through to process_jobs_concurrently.
+            Optional flags include `include_parent_trace_ids=True` to also return
+            parent job trace identifiers gathered during ingestion.
 
         Returns
         -------
-        results : list
-            When `return_failures` is False:
-            - Default: List of response['data'] per job (list[list[dict]]).
-            - If `return_full_response=True`: List of full response envelopes (each dict
-              contains keys like 'data', 'trace', 'annotations').
+        results : list of dict
+            List of successful job results when `return_failures` is False.
+
         results, failures : tuple (list of dict, list of tuple of str)
             Tuple containing successful results and failure information when `return_failures` is True.
+
+        If `include_parent_trace_ids=True` is provided via kwargs, an additional
+        list of parent trace IDs is appended to the return value.
         """
         if save_to_disk and (not self._output_config):
             self.save_to_disk()
 
+        include_parent_trace_ids = bool(kwargs.pop("include_parent_trace_ids", False))
+
         self._prepare_ingest_run()
 
         # Add jobs locally first
@@ -641,7 +646,15 @@ class Ingestor:
             except Exception:
                 pass
 
-        return (results, failures) if return_failures else results
+        parent_trace_ids = self._client.consume_completed_parent_trace_ids() if include_parent_trace_ids else []
+
+        if return_failures and include_parent_trace_ids:
+            return results, failures, parent_trace_ids
+        if return_failures:
+            return results, failures
+        if include_parent_trace_ids:
+            return results, parent_trace_ids
+        return results
 
     def ingest_async(self, **kwargs: Any) -> Future:
         """

{nv_ingest_client-2025.10.9.dev20251009.dist-info → nv_ingest_client-2025.10.10.dev20251010.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nv-ingest-client
-Version: 2025.10.9.dev20251009
+Version: 2025.10.10.dev20251010
 Summary: Python client for the nv-ingest service
 Author-email: Jeremy Dyer <jdyer@nvidia.com>
 License:                                  Apache License

{nv_ingest_client-2025.10.9.dev20251009.dist-info → nv_ingest_client-2025.10.10.dev20251010.dist-info}/RECORD

@@ -6,9 +6,9 @@ nv_ingest_client/cli/util/click.py,sha256=YjQU1uF148FU5D3ozC2m1kkfOOJxO1U8U552-T
 nv_ingest_client/cli/util/processing.py,sha256=ULGCYQF1RTDQV_b35YM1WQRqIjR2wQRMJWu41DogagE,6259
 nv_ingest_client/cli/util/system.py,sha256=AQLq0DD2Ns8jRanrKu1tmVBKPA9rl-F3-ZsGI6FXLqE,1105
 nv_ingest_client/client/__init__.py,sha256=eEX9l1qmkLH2lAAZU3eP17SCV06ZjjrshHAB_xbboHA,375
-nv_ingest_client/client/client.py,sha256=egPegAoe8sVYxWWbNl1V5xJdaABJxgVxX7AHRoa049w,76058
+nv_ingest_client/client/client.py,sha256=gCbOSDoNnt7AYFvyCIjfH36gVxFHNDl2vtpKPKFKSzs,76802
 nv_ingest_client/client/ingest_job_handler.py,sha256=i2PC5AUaglN5aGAqE4Nrbk95TyLYN7P_Nwba0C_19xA,16810
-nv_ingest_client/client/interface.py,sha256=c1SRgS_ryz-DAYRPr8OIW0HpWzUx-GsnlfEK2_K7fZg,48897
+nv_ingest_client/client/interface.py,sha256=1WKdCynIqdSJGpcLIim85hzDj8vKPtKuPjGkKYCMp4I,49421
 nv_ingest_client/client/util/processing.py,sha256=Ky7x7QbLn3BlgYwmrmoIc-o1VwmlmrcP9tn7GVTi0t0,2502
 nv_ingest_client/primitives/__init__.py,sha256=3rbpLCI7Bl0pntGatAxXD_V01y6dcLhHFheI3wqet-I,269
 nv_ingest_client/primitives/jobs/__init__.py,sha256=-yohgHv3LcCtSleHSaxjv1oO7nNcMCjN3ZYoOkIypIk,469
@@ -47,9 +47,9 @@ nv_ingest_client/util/vdb/__init__.py,sha256=ZmoEzeM9LzwwrVvu_DVUnjRNx-x8ahkNeIr
 nv_ingest_client/util/vdb/adt_vdb.py,sha256=UubzAMSfyrqqpD-OQErpBs25hC2Mw8zGZ4waenGXPOk,515
 nv_ingest_client/util/vdb/milvus.py,sha256=dYXszrWdwYYASBW6t8lMI6QK9-BzhV6HAUYjt3cIDsE,78602
 nv_ingest_client/util/vdb/opensearch.py,sha256=I4FzF95VWCOkyzhfm-szdfK1Zd9ugUc8AxxpAdEMWGE,7538
-nv_ingest_client-2025.10.9.dev20251009.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-nv_ingest_client-2025.10.9.dev20251009.dist-info/METADATA,sha256=rscM-NBJXWXk1Ghg5KG0KTU56a4yWAV0c419opVrDS0,30626
-nv_ingest_client-2025.10.9.dev20251009.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-nv_ingest_client-2025.10.9.dev20251009.dist-info/entry_points.txt,sha256=3uQVZkTZIjO08_bjTV-g0CDF5H1nrP1zWXU9gJOweuI,137
-nv_ingest_client-2025.10.9.dev20251009.dist-info/top_level.txt,sha256=1eMhBFD3SiWmpXnod2LM66C1HrSLSk96ninZi5XX-cE,17
-nv_ingest_client-2025.10.9.dev20251009.dist-info/RECORD,,
+nv_ingest_client-2025.10.10.dev20251010.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+nv_ingest_client-2025.10.10.dev20251010.dist-info/METADATA,sha256=h-6OgmvZctiJWktQqbyJk5xcpCtAkrdTN5h9PuzllA0,30627
+nv_ingest_client-2025.10.10.dev20251010.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+nv_ingest_client-2025.10.10.dev20251010.dist-info/entry_points.txt,sha256=3uQVZkTZIjO08_bjTV-g0CDF5H1nrP1zWXU9gJOweuI,137
+nv_ingest_client-2025.10.10.dev20251010.dist-info/top_level.txt,sha256=1eMhBFD3SiWmpXnod2LM66C1HrSLSk96ninZi5XX-cE,17
+nv_ingest_client-2025.10.10.dev20251010.dist-info/RECORD,,