howso-engine 67.1.0__tar.gz → 67.2.0__tar.gz

{howso_engine-67.1.0 → howso_engine-67.2.0}/LICENSE-3RD-PARTY.txt

@@ -1,10 +1,10 @@
 Faker
-40.39.0
+40.41.0
 MIT License
 joke2k
 https://github.com/joke2k/faker
 Faker is a Python package that generates fake data for you.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/faker-40.39.0.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/faker-40.41.0.dist-info/licenses/LICENSE.txt
 Copyright (c) 2012 Daniele Faraglia
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -32,7 +32,7 @@ MIT License
 Kirill Simonov
 https://pyyaml.org/
 YAML parser and emitter for Python
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/pyyaml-6.0.3.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/pyyaml-6.0.3.dist-info/licenses/LICENSE
 Copyright (c) 2017-2021 Ingy döt Net
 Copyright (c) 2006-2016 Kirill Simonov
 
@@ -61,7 +61,7 @@ BSD-2-Clause
 Georg Brandl <georg@python.org>
 https://pygments.org
 Pygments is a syntax highlighting package written in Python.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/pygments-2.21.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/pygments-2.21.0.dist-info/licenses/LICENSE
 Copyright (c) 2006-2022 by the respective authors (see AUTHORS file).
 All rights reserved.
 
@@ -95,7 +95,7 @@ MIT
 Filipe Laíns <lains@riseup.net>, Bernát Gábor <gaborjbernat@gmail.com>, layday <layday@protonmail.com>, Henry Schreiner <henryschreineriii@gmail.com>
 https://build.pypa.io
 A simple, correct Python build frontend
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/build-1.6.1.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/build-1.6.1.dist-info/licenses/LICENSE
 Copyright © 2019 Filipe Laíns <filipe.lains@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a
@@ -124,7 +124,7 @@ Mozilla Public License 2.0 (MPL 2.0)
 Kenneth Reitz
 https://github.com/certifi/python-certifi
 Python package for providing Mozilla's CA Bundle.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/certifi-2026.7.22.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/certifi-2026.7.22.dist-info/licenses/LICENSE
 This package contains a modified version of ca-bundle.crt:
 
 ca-bundle.crt -- Bundle of CA Root Certificates
@@ -148,12 +148,12 @@ one at http://mozilla.org/MPL/2.0/.
 
 
 charset-normalizer
-3.5.1
+3.5.2
 MIT
 "Ahmed R. TAHRI" <tahri.ahmed@proton.me>
 https://github.com/jawah/charset_normalizer/blob/master/CHANGELOG.md
 The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/charset_normalizer-3.5.1.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/charset_normalizer-3.5.2.dist-info/licenses/LICENSE
 MIT License
 
 Copyright (c) 2025 TAHRI Ahmed R.
@@ -183,7 +183,7 @@ BSD-3-Clause
 UNKNOWN
 https://github.com/pallets/click/
 Composable command line interface toolkit
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/click-8.5.0.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/click-8.5.0.dist-info/licenses/LICENSE.txt
 Copyright 2014 Pallets
 
 Redistribution and use in source and binary forms, with or without
@@ -220,7 +220,7 @@ BSD License
 The cloudpickle developer team
 https://github.com/cloudpipe/cloudpickle
 Pickler class to extend the standard pickle.Pickler functionality
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/cloudpickle-3.1.2.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/cloudpickle-3.1.2.dist-info/licenses/LICENSE
 This module was extracted from the `cloud` package, developed by
 PiCloud, Inc.
 
@@ -261,7 +261,7 @@ MIT
 Jason Moiron <jmoiron@jmoiron.net>
 https://github.com/python-humanize/humanize
 Python humanize utilities
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/humanize-4.16.0.dist-info/licenses/LICENCE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/humanize-4.16.0.dist-info/licenses/LICENCE
 Copyright (c) 2010-2020 Jason Moiron and Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining
@@ -290,7 +290,7 @@ BSD-3-Clause
 Kim Davies <kim+pypi@gumleaf.org>
 https://github.com/kjd/idna
 Internationalized Domain Names in Applications (IDNA)
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/idna-3.20.dist-info/licenses/LICENSE.md
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/idna-3.20.dist-info/licenses/LICENSE.md
 BSD 3-Clause License
 
 Copyright (c) 2013-2026, Kim Davies and contributors.
@@ -330,7 +330,7 @@ BSD-3-Clause
 Gael Varoquaux <gael.varoquaux@normalesup.org>
 https://joblib.readthedocs.io
 Lightweight pipelining with Python functions
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/joblib-1.6.0.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/joblib-1.6.0.dist-info/licenses/LICENSE.txt
 BSD 3-Clause License
 
 Copyright (c) 2008-2021, The joblib developers.
@@ -368,7 +368,7 @@ MIT License
 Chris Sewell <chrisj_sewell@hotmail.com>
 https://github.com/executablebooks/markdown-it-py
 Python port of markdown-it. Markdown parsing, done right!
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/markdown_it_py-4.2.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/markdown_it_py-4.2.0.dist-info/licenses/LICENSE
 MIT License
 
 Copyright (c) 2020 ExecutableBookProject
@@ -398,7 +398,7 @@ MIT License
 Taneli Hukkinen <hukkin@users.noreply.github.com>
 https://github.com/executablebooks/mdurl
 Markdown URL utilities
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/mdurl-0.1.2.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/mdurl-0.1.2.dist-info/LICENSE
 Copyright (c) 2015 Vitaly Puzrin, Alex Kocharin.
 Copyright (c) 2021 Taneli Hukkinen
 
@@ -448,12 +448,12 @@ IN THE SOFTWARE.
 
 
 mmh3
-5.3.0
+5.3.1
 MIT License
 Hajime Senuma <hajime.senuma@gmail.com>
 https://pypi.org/project/mmh3/
 Python extension for MurmurHash (MurmurHash3), a set of fast and robust hash functions.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/mmh3-5.3.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/mmh3-5.3.1.dist-info/licenses/LICENSE
 MIT License
 
 Copyright (c) 2011-2026 Hajime Senuma
@@ -482,7 +482,7 @@ BSD-3-Clause AND 0BSD AND MIT AND Zlib AND CC0-1.0
 Travis E. Oliphant et al.
 https://numpy.org
 Fundamental package for array computing in Python
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/numpy-2.4.6.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/numpy-2.4.6.dist-info/licenses/LICENSE.txt
 Copyright (c) 2005-2025, NumPy Developers.
 All rights reserved.
 
@@ -1426,7 +1426,7 @@ Apache-2.0 OR BSD-2-Clause
 Donald Stufft <donald@stufft.io>
 https://github.com/pypa/packaging
 Core utilities for Python packages
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/packaging-26.3.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/packaging-26.3.dist-info/licenses/LICENSE
 This software is made available under the terms of *either* of the licenses
 found in LICENSE.APACHE or LICENSE.BSD. Contributions to this software is made
 under the terms of *both* these licenses.
@@ -1438,7 +1438,7 @@ BSD License
 The Pandas Development Team <pandas-dev@python.org>
 https://pandas.pydata.org
 Powerful data structures for data analysis, time series, and statistics
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/pandas-2.3.3.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/pandas-2.3.3.dist-info/LICENSE
 BSD 3-Clause License
 
 Copyright (c) 2008-2011, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
@@ -2696,7 +2696,7 @@ BSD License
 Vincent Driessen <me@nvie.com>
 https://github.com/jazzband/pip-tools/
 pip-tools keeps your pinned dependencies fresh.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/pip_tools-7.4.1.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/pip_tools-7.4.1.dist-info/LICENSE
 BSD 3-Clause License
 
 Copyright (c). All rights reserved.
@@ -2733,7 +2733,7 @@ BSD-3-Clause
 Giampaolo Rodola
 https://github.com/giampaolo/psutil
 Cross-platform lib for process and system monitoring.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/psutil-7.2.2.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/psutil-7.2.2.dist-info/LICENSE
 BSD 3-Clause License
 
 Copyright (c) 2009, Jay Loden, Dave Daeschler, Giampaolo Rodola
@@ -2771,7 +2771,7 @@ MIT
 Thomas Kluyver <thomas@kluyver.me.uk>
 https://github.com/pypa/pyproject-hooks
 Wrappers to call pyproject.toml-based build backend hooks.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/pyproject_hooks-1.3.3.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/pyproject_hooks-1.3.3.dist-info/licenses/LICENSE
 The MIT License (MIT)
 
 Copyright (c) 2017 Thomas Kluyver
@@ -2801,7 +2801,7 @@ Apache Software License; BSD License
 Gustavo Niemeyer
 https://github.com/dateutil/dateutil
 Extensions to the standard Python datetime module
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/python_dateutil-2.9.0.post0.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/python_dateutil-2.9.0.post0.dist-info/LICENSE
 Copyright 2017- Paul Ganssle <paul@ganssle.io>
 Copyright 2017- dateutil contributors (see AUTHORS file)
 
@@ -2858,12 +2858,12 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 The above BSD License Applies to all code, even that also covered by Apache 2.0.
 
 pytz
-2026.4
+2026.5
 MIT License
 Stuart Bishop
 http://pythonhosted.org/pytz
 World timezone definitions, modern and historical
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/pytz-2026.4.dist-info/LICENSE.txt
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/pytz-2026.5.dist-info/LICENSE.txt
 Copyright (c) 2003-2019 Stuart Bishop <stuart@stuartbishop.net>
 
 Permission is hereby granted, free of charge, to any person obtaining a
@@ -2886,12 +2886,12 @@ DEALINGS IN THE SOFTWARE.
 
 
 regex
-2026.9.10
+2026.9.29
 Apache-2.0 AND CNRI-Python
 Matthew Barnett <regex@mrabarnett.plus.com>
 https://github.com/mrabarnett/mrab-regex
 Alternative regular expression module, to replace re.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/regex-2026.9.10.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/regex-2026.9.29.dist-info/licenses/LICENSE.txt
 This work was derived from the 're' module of CPython 2.6 and CPython 3.1,
 copyright (c) 1998-2001 by Secret Labs AB and licensed under CNRI's Python 1.6
 license.
@@ -3108,7 +3108,7 @@ Apache Software License
 Kenneth Reitz <me@kennethreitz.org>
 https://github.com/psf/requests
 Python HTTP for Humans.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/requests-2.34.2.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/requests-2.34.2.dist-info/licenses/LICENSE
 
                                  Apache License
                            Version 2.0, January 2004
@@ -3292,7 +3292,7 @@ MIT License
 Will McGugan
 https://github.com/Textualize/rich
 Render rich text, tables, progress bars, syntax highlighting, markdown and more to the terminal
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/rich-15.0.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/rich-15.0.0.dist-info/licenses/LICENSE
 Copyright (c) 2020 Will McGugan
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -3320,7 +3320,7 @@ MIT License
 UNKNOWN
 https://github.com/hplt-project/sacremoses
 SacreMoses
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/sacremoses-0.2.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/sacremoses-0.2.0.dist-info/licenses/LICENSE
 MIT License
 
 Copyright (c) 2020 alvations
@@ -3350,7 +3350,7 @@ BSD License
 Raphaël Barrois
 https://github.com/rbarrois/python-semanticversion
 A library implementing the 'SemVer' scheme.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/semantic_version-2.10.0.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/semantic_version-2.10.0.dist-info/LICENSE
 Copyright (c) The python-semanticversion project
 All rights reserved.
 
@@ -3381,7 +3381,7 @@ MIT License
 Benjamin Peterson
 https://github.com/benjaminp/six
 Python 2 and 3 compatibility utilities
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/six-1.17.0.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/six-1.17.0.dist-info/LICENSE
 Copyright (c) 2010-2024 Benjamin Peterson
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
@@ -3408,7 +3408,7 @@ MPL-2.0 AND MIT
 UNKNOWN
 https://tqdm.github.io
 Fast, Extensible Progress Meter
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/tqdm-4.70.1.dist-info/licenses/LICENCE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/tqdm-4.70.1.dist-info/licenses/LICENCE
 `tqdm` is a product of collaborative work.
 Unless otherwise stated, all authors (see commit logs) retain copyright
 for their respective work, and release the work under the MIT licence
@@ -3466,7 +3466,7 @@ PSF-2.0
 "Guido van Rossum, Jukka Lehtosalo, Łukasz Langa, Michael Lee" <levkivskyi@gmail.com>
 https://github.com/python/typing_extensions
 Backported and Experimental Type Hints for Python 3.9+
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/typing_extensions-4.16.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/typing_extensions-4.16.0.dist-info/licenses/LICENSE
 A. HISTORY OF THE SOFTWARE
 ==========================
 
@@ -3749,12 +3749,12 @@ PERFORMANCE OF THIS SOFTWARE.
 
 
 tzdata
-2026.4
+2026.5
 Apache-2.0
 Python Software Foundation
 https://github.com/python/tzdata
 Provider of IANA time zone data
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/tzdata-2026.4.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/tzdata-2026.5.dist-info/licenses/LICENSE
 Apache Software License 2.0
 
 Copyright (c) 2020, Paul Ganssle (Google)
@@ -3779,7 +3779,7 @@ MIT
 Andrey Petrov <andrey.petrov@shazow.net>
 https://github.com/urllib3/urllib3/blob/main/CHANGES.rst
 HTTP library with thread-safe connection pooling, file post, and more.
-/home/runner/.pyenv/versions/3.14.7/lib/python3.14/site-packages/urllib3-2.8.0.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.14.8/lib/python3.14/site-packages/urllib3-2.8.0.dist-info/licenses/LICENSE.txt
 MIT License
 
 Copyright (c) 2008-2020 Andrey Petrov and contributors.

{howso_engine-67.1.0/howso_engine.egg-info → howso_engine-67.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: howso-engine
-Version: 67.1.0
+Version: 67.2.0
 Summary: The Howso Engine™ is a natively and fully explainable ML engine, serving as an alternative to black box AI neural networks.
 Author: Howso Incorporated
 Author-email: support@howso.com
@@ -705,7 +705,7 @@ Requires-Dist: sacremoses
 Requires-Dist: semantic-version~=2.0
 Requires-Dist: typing-extensions~=4.9
 Requires-Dist: urllib3>=2.6.3
-Requires-Dist: amalgam-lang==35.0.1
+Requires-Dist: amalgam-lang==35.1.0
 Provides-Extra: dev
 Requires-Dist: dill~=0.0; extra == "dev"
 Requires-Dist: flake8-docstrings; extra == "dev"

{howso_engine-67.1.0 → howso_engine-67.2.0}/howso/client/base.py

@@ -1865,6 +1865,10 @@ class AbstractHowsoClient(ABC):
         produces action_values for the specified action_features conditioned
         on the optionally provided contexts.
 
+        Large requests are split into batches (see ``batch_size``). When the
+        client runs batches concurrently, they do not report engine progress
+        under ``task_id``; ``progress_callback`` reports overall progress.
+
         Parameters
         ----------
         trainee_id : str
@@ -3024,6 +3028,10 @@ class AbstractHowsoClient(ABC):
         corresponding "action" where "action" is the completed 'matrix' for the
         corresponding `action_features` and `derived_action_features`.
 
+        Large requests are split into batches (see ``batch_size``). When the
+        client runs batches concurrently, they do not report engine progress
+        under ``task_id``; ``progress_callback`` reports overall progress.
+
         Parameters
         ----------
         trainee_id : str
@@ -3558,6 +3566,10 @@ class AbstractHowsoClient(ABC):
         r"""
         React to series data predicting stationary feature values.
 
+        Large requests are split into batches (see ``batch_size``). When the
+        client runs batches concurrently, they do not report engine progress
+        under ``task_id``; ``progress_callback`` reports overall progress.
+
         Parameters
         ----------
         trainee_id : str

{howso_engine-67.1.0 → howso_engine-67.2.0}/howso/direct/client.py

@@ -5,6 +5,7 @@ from concurrent.futures import Future, ThreadPoolExecutor
 from contextlib import contextmanager
 from copy import deepcopy
 from datetime import datetime, timezone
+from functools import cached_property
 from http import HTTPStatus
 import importlib.metadata
 import inspect
@@ -66,6 +67,9 @@ VERSION_CHECK_HOST = "https://version-check.howso.com"
 SUBTRAINEE_CONTAINER = ".trainee_container"
 """The name of the Amalgam entity that contains sub-Trainees in hierarchy."""
 
+GARBAGE_COLLECTION_KEY = "garbage_collection"
+"""The key within the Amalgam options that holds garbage-collection parameters."""
+
 # Cache of trainee information shared across client instances
 _trainee_cache = TraineeCache()
 
@@ -91,7 +95,11 @@ class HowsoDirectClient(AbstractHowsoClient):
     Parameters
     ----------
     amalgam : Mapping, optional
-        Keyword-argument overrides to the underlying Amalgam instance.
+        Keyword-argument overrides to the underlying Amalgam instance. The
+        optional ``garbage_collection`` key is not passed to the Amalgam
+        constructor; its value is a mapping of native garbage-collection
+        parameters applied via :meth:`set_garbage_collection_params` once
+        the Amalgam library is loaded.
     config_path : str or Path or None, optional
         A configuration file in yaml format that specifies Howso engine
         settings.
@@ -217,6 +225,10 @@ class HowsoDirectClient(AbstractHowsoClient):
 
     def __init_amalgam(self, options: t.Optional[Mapping[str, t.Any]] = None):
         """Initialize the Amalgam instance."""
+        gc_params = None
+        if options and GARBAGE_COLLECTION_KEY in options:
+            options = dict(options)
+            gc_params = options.pop(GARBAGE_COLLECTION_KEY)
         # The parameters to pass to the Amalgam instance
         amlg_params = {
             'library_path': None,
@@ -243,6 +255,8 @@ class HowsoDirectClient(AbstractHowsoClient):
                 UnsupportedArgumentWarning)
         amlg_params = {k: v for k, v in amlg_params.items() if k in allowed_amlg_params}
         self.amlg = Amalgam(**amlg_params)
+        if gc_params:
+            self.set_garbage_collection_params(gc_params)
 
     def check_version(self) -> str | None:
         """Check if there is a more recent version."""
@@ -770,6 +784,83 @@ class HowsoDirectClient(AbstractHowsoClient):
         """
         return self._trace_enabled
 
+    def get_num_active_threads(self) -> int:
+        """
+        Return the number of threads the Amalgam library is actively executing.
+
+        This is an instantaneous measurement that may change very rapidly as
+        tasks are dispatched and decomposed, so it is most useful when many
+        samples are aggregated over a time period. OpenMP threads are not
+        included in the count.
+
+        Returns
+        -------
+        int
+            The current number of active threads.
+        """
+        return self.amlg.get_num_active_threads()
+
+    @cached_property
+    def _garbage_collection_param_names(self) -> frozenset[str]:
+        """
+        The names of the garbage-collection parameters the Amalgam library supports.
+
+        The library reports every parameter it supports, so these are the
+        names returned by :meth:`get_garbage_collection_params`. They are
+        fixed for the loaded library and read from it once per client.
+
+        Returns
+        -------
+        frozenset of str
+            The supported garbage-collection parameter names.
+        """
+        return frozenset(self.get_garbage_collection_params())
+
+    def get_garbage_collection_params(self) -> dict[str, t.Any]:
+        """
+        Get the native garbage-collection parameters of the Amalgam library.
+
+        These parameters are global to the loaded Amalgam library and are
+        therefore shared by every client and Trainee in the process.
+
+        Returns
+        -------
+        dict
+            A mapping of each garbage-collection parameter name to its
+            current value.
+        """
+        return json.loads(self.amlg.get_garbage_collection_params())
+
+    def set_garbage_collection_params(self, params: Mapping[str, t.Any]) -> None:
+        """
+        Update the native garbage-collection parameters of the Amalgam library.
+
+        These parameters are global to the loaded Amalgam library and are
+        therefore shared by every client and Trainee in the process. Omitted
+        parameters keep their current values. A value outside its allowed
+        range resets that parameter to its default.
+
+        Parameters
+        ----------
+        params : Mapping
+            Any subset of the parameters named by
+            :attr:`_garbage_collection_param_names`. Unrecognized parameters
+            are ignored with a warning.
+        """
+        if not isinstance(params, Mapping):
+            raise TypeError(
+                "Garbage-collection parameters must be a mapping of parameter "
+                f"names to values, got: {type(params).__name__}"
+            )
+        supported_params = self._garbage_collection_param_names
+        if unknown_params := params.keys() - supported_params:
+            warnings.warn(
+                f"Unknown garbage-collection parameters were specified and ignored: {unknown_params}",
+                UnsupportedArgumentWarning)
+        known_params = {k: v for k, v in params.items() if k in supported_params}
+        if known_params:
+            self.amlg.set_garbage_collection_params(json.dumps(known_params))
+
     def get_version(self) -> HowsoVersion:
         """
         Return the Howso version.

{howso_engine-67.1.0 → howso_engine-67.2.0}/howso/engine/trainee.py

@@ -1413,6 +1413,10 @@ class Trainee(BaseTrainee):
         react. Provided a list of ``contexts``, the trainee reacts to the data
         and produces predictions for the specified actions.
 
+        Large requests are split into batches (see ``batch_size``). When the
+        client runs batches concurrently, they do not report engine progress
+        under ``task_id``; ``progress_callback`` reports overall progress.
+
         Parameters
         ----------
         contexts : DataFrame or 2-dimensional list of object, optional
@@ -2099,6 +2103,10 @@ class Trainee(BaseTrainee):
         corresponding "action" where "action" is the completed 'matrix' for
         the corresponding action_features and derived_action_features.
 
+        Large requests are split into batches (see ``batch_size``). When the
+        client runs batches concurrently, they do not report engine progress
+        under ``task_id``; ``progress_callback`` reports overall progress.
+
         Parameters
         ----------
         action_features : list of str, optional
@@ -2379,6 +2387,10 @@ class Trainee(BaseTrainee):
         r"""
         React to series data predicting stationary feature values.
 
+        Large requests are split into batches (see ``batch_size``). When the
+        client runs batches concurrently, they do not report engine progress
+        under ``task_id``; ``progress_callback`` reports overall progress.
+
         Parameters
         ----------
         trainee_id : str

{howso_engine-67.1.0 → howso_engine-67.2.0}/howso/utilities/internals.py

@@ -1139,7 +1139,13 @@ class ReactInBatches:
         self._consume_ready_futures()
 
     def parallel(self) -> None:
-        """Run the operation using parallel threads."""
+        """
+        Run the operation using parallel threads.
+
+        Batch requests omit ``task_id``, since one task identifier cannot
+        describe several in-flight requests.  Overall progress is reported
+        through the progress callback.
+        """
         logger.debug("starting parallel batch react")
         batch_start = 0
         self._send_progress(None)
@@ -1151,6 +1157,10 @@ class ReactInBatches:
                     # Submit a new batch of cases
                     batch_end = min(batch_start + self._batch_scaler.batch_size, self._progress.total_ticks)
                     batch_params = self._params_for_batch(self._params, batch_start, batch_end)
+                    # One task_id cannot describe several in-flight requests: the engine
+                    # would merge their progress into a single entry that the first
+                    # finished batch clears.
+                    batch_params.pop("task_id", None)
                     future = executor.submit(self._react_function, self._trainee_id, batch_params)
                     self._futures.append((batch_end - batch_start, future))
                     self._running.add(future)

{howso_engine-67.1.0 → howso_engine-67.2.0/howso_engine.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: howso-engine
-Version: 67.1.0
+Version: 67.2.0
 Summary: The Howso Engine™ is a natively and fully explainable ML engine, serving as an alternative to black box AI neural networks.
 Author: Howso Incorporated
 Author-email: support@howso.com
@@ -705,7 +705,7 @@ Requires-Dist: sacremoses
 Requires-Dist: semantic-version~=2.0
 Requires-Dist: typing-extensions~=4.9
 Requires-Dist: urllib3>=2.6.3
-Requires-Dist: amalgam-lang==35.0.1
+Requires-Dist: amalgam-lang==35.1.0
 Provides-Extra: dev
 Requires-Dist: dill~=0.0; extra == "dev"
 Requires-Dist: flake8-docstrings; extra == "dev"

{howso_engine-67.1.0 → howso_engine-67.2.0}/howso_engine.egg-info/requires.txt

@@ -14,7 +14,7 @@ sacremoses
 semantic-version~=2.0
 typing-extensions~=4.9
 urllib3>=2.6.3
-amalgam-lang==35.0.1
+amalgam-lang==35.1.0
 
 [dev]
 dill~=0.0

{howso_engine-67.1.0 → howso_engine-67.2.0}/pyproject.toml

@@ -48,7 +48,7 @@ dependencies = [
     "semantic-version~=2.0",
     "typing-extensions~=4.9",
     "urllib3>=2.6.3",
-    "amalgam-lang==35.0.1", # Use exact since Engine is exact in version.json
+    "amalgam-lang==35.1.0", # Use exact since Engine is exact in version.json
 ]
 
 [project.optional-dependencies]