howso-engine 60.2.2__tar.gz → 60.3.1__tar.gz

{howso_engine-60.2.2 → howso_engine-60.3.1}/LICENSE-3RD-PARTY.txt

@@ -1,10 +1,10 @@
 Faker
-40.19.1
+40.23.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.13.13/lib/python3.13/site-packages/faker-40.19.1.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/faker-40.23.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.13.13/lib/python3.13/site-packages/pyyaml-6.0.3.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/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.13.13/lib/python3.13/site-packages/pygments-2.20.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/pygments-2.20.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.13.13/lib/python3.13/site-packages/build-1.5.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/build-1.5.0.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.13.13/lib/python3.13/site-packages/certifi-2026.5.20.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/certifi-2026.5.20.dist-info/licenses/LICENSE
 This package contains a modified version of ca-bundle.crt:
 
 ca-bundle.crt -- Bundle of CA Root Certificates
@@ -153,7 +153,7 @@ 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.13.13/lib/python3.13/site-packages/charset_normalizer-3.4.7.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/charset_normalizer-3.4.7.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.13.13/lib/python3.13/site-packages/click-8.4.1.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/click-8.4.1.dist-info/licenses/LICENSE.txt
 Copyright 2014 Pallets
 
 Redistribution and use in source and binary forms, with or without
@@ -220,7 +220,7 @@ MIT
 Jason Moiron <jmoiron@jmoiron.net>
 https://github.com/python-humanize/humanize
 Python humanize utilities
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/humanize-4.15.0.dist-info/licenses/LICENCE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/humanize-4.15.0.dist-info/licenses/LICENCE
 Copyright (c) 2010-2020 Jason Moiron and Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining
@@ -244,12 +244,12 @@ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 
 idna
-3.16
+3.18
 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.13.13/lib/python3.13/site-packages/idna-3.16.dist-info/licenses/LICENSE.md
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/idna-3.18.dist-info/licenses/LICENSE.md
 BSD 3-Clause License
 
 Copyright (c) 2013-2026, Kim Davies and contributors.
@@ -289,7 +289,7 @@ BSD-3-Clause
 Gael Varoquaux <gael.varoquaux@normalesup.org>
 https://joblib.readthedocs.io
 Lightweight pipelining with Python functions
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/joblib-1.5.3.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/joblib-1.5.3.dist-info/licenses/LICENSE.txt
 BSD 3-Clause License
 
 Copyright (c) 2008-2021, The joblib developers.
@@ -327,7 +327,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.13.13/lib/python3.13/site-packages/markdown_it_py-4.2.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/markdown_it_py-4.2.0.dist-info/licenses/LICENSE
 MIT License
 
 Copyright (c) 2020 ExecutableBookProject
@@ -357,7 +357,7 @@ MIT License
 Taneli Hukkinen <hukkin@users.noreply.github.com>
 https://github.com/executablebooks/mdurl
 Markdown URL utilities
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/mdurl-0.1.2.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/mdurl-0.1.2.dist-info/LICENSE
 Copyright (c) 2015 Vitaly Puzrin, Alex Kocharin.
 Copyright (c) 2021 Taneli Hukkinen
 
@@ -412,7 +412,7 @@ 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.13.13/lib/python3.13/site-packages/mmh3-5.2.1.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/mmh3-5.2.1.dist-info/licenses/LICENSE
 MIT License
 
 Copyright (c) 2011-2026 Hajime Senuma
@@ -441,7 +441,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.13.13/lib/python3.13/site-packages/numpy-2.4.6.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/numpy-2.4.6.dist-info/licenses/LICENSE.txt
 Copyright (c) 2005-2025, NumPy Developers.
 All rights reserved.
 
@@ -1385,7 +1385,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.13.13/lib/python3.13/site-packages/packaging-26.2.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/packaging-26.2.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.
@@ -1397,7 +1397,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.13.13/lib/python3.13/site-packages/pandas-2.3.3.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/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
@@ -2655,7 +2655,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.13.13/lib/python3.13/site-packages/pip_tools-7.5.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/pip_tools-7.5.0.dist-info/licenses/LICENSE
 BSD 3-Clause License
 
 Copyright (c). All rights reserved.
@@ -2692,7 +2692,7 @@ BSD-3-Clause
 Giampaolo Rodola
 https://github.com/giampaolo/psutil
 Cross-platform lib for process and system monitoring.
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/psutil-7.2.2.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/psutil-7.2.2.dist-info/LICENSE
 BSD 3-Clause License
 
 Copyright (c) 2009, Jay Loden, Dave Daeschler, Giampaolo Rodola
@@ -2730,7 +2730,7 @@ MIT License
 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.13.13/lib/python3.13/site-packages/pyproject_hooks-1.2.0.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/pyproject_hooks-1.2.0.dist-info/LICENSE
 The MIT License (MIT)
 
 Copyright (c) 2017 Thomas Kluyver
@@ -2760,7 +2760,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.13.13/lib/python3.13/site-packages/python_dateutil-2.9.0.post0.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/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)
 
@@ -2822,7 +2822,7 @@ MIT License
 Stuart Bishop
 http://pythonhosted.org/pytz
 World timezone definitions, modern and historical
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/pytz-2026.2.dist-info/LICENSE.txt
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/pytz-2026.2.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
@@ -2850,7 +2850,7 @@ 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.13.13/lib/python3.13/site-packages/regex-2026.5.9.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/regex-2026.5.9.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.
@@ -3067,7 +3067,7 @@ Apache Software License
 Kenneth Reitz <me@kennethreitz.org>
 https://github.com/psf/requests
 Python HTTP for Humans.
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/requests-2.34.2.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/requests-2.34.2.dist-info/licenses/LICENSE
 
                                  Apache License
                            Version 2.0, January 2004
@@ -3251,7 +3251,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.13.13/lib/python3.13/site-packages/rich-15.0.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/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
@@ -3279,7 +3279,7 @@ MIT License
 UNKNOWN
 https://github.com/hplt-project/sacremoses
 SacreMoses
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/sacremoses-0.1.1.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/sacremoses-0.1.1.dist-info/LICENSE
 MIT License
 
 Copyright (c) 2020 alvations
@@ -3309,7 +3309,7 @@ BSD License
 Raphaël Barrois
 https://github.com/rbarrois/python-semanticversion
 A library implementing the 'SemVer' scheme.
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/semantic_version-2.10.0.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/semantic_version-2.10.0.dist-info/LICENSE
 Copyright (c) The python-semanticversion project
 All rights reserved.
 
@@ -3340,7 +3340,7 @@ MIT License
 Benjamin Peterson
 https://github.com/benjaminp/six
 Python 2 and 3 compatibility utilities
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/six-1.17.0.dist-info/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/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
@@ -3362,12 +3362,12 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 
 tqdm
-4.67.3
+4.68.2
 MPL-2.0 AND MIT
 UNKNOWN
 https://tqdm.github.io
 Fast, Extensible Progress Meter
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/tqdm-4.67.3.dist-info/licenses/LICENCE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/tqdm-4.68.2.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
@@ -3425,7 +3425,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.13.13/lib/python3.13/site-packages/typing_extensions-4.15.0.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/typing_extensions-4.15.0.dist-info/licenses/LICENSE
 A. HISTORY OF THE SOFTWARE
 ==========================
 
@@ -3713,7 +3713,7 @@ Apache-2.0
 Python Software Foundation
 https://github.com/python/tzdata
 Provider of IANA time zone data
-/home/runner/.pyenv/versions/3.13.13/lib/python3.13/site-packages/tzdata-2026.2.dist-info/licenses/LICENSE
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/tzdata-2026.2.dist-info/licenses/LICENSE
 Apache Software License 2.0
 
 Copyright (c) 2020, Paul Ganssle (Google)
@@ -3737,7 +3737,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.13.13/lib/python3.13/site-packages/urllib3-2.7.0.dist-info/licenses/LICENSE.txt
+/home/runner/.pyenv/versions/3.13.14/lib/python3.13/site-packages/urllib3-2.7.0.dist-info/licenses/LICENSE.txt
 MIT License
 
 Copyright (c) 2008-2020 Andrey Petrov and contributors.

{howso_engine-60.2.2/howso_engine.egg-info → howso_engine-60.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: howso-engine
-Version: 60.2.2
+Version: 60.3.1
 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==31.0.1
+Requires-Dist: amalgam-lang==32.0.1
 Provides-Extra: dev
 Requires-Dist: dill~=0.0; extra == "dev"
 Requires-Dist: flake8-docstrings; extra == "dev"

{howso_engine-60.2.2 → howso_engine-60.3.1}/howso/client/base.py

@@ -1900,6 +1900,10 @@ class AbstractHowsoClient(ABC):
                 If True, outputs the distance contribution (expected total
                 surprisal contribution) for the reacted case. Uses both context
                 and action feature values.
+            - residual_contribution : bool, optional
+                If True, outputs the residual contribution (average feature
+                residual surprisal) for the reacted case. Uses both context
+                and action feature values.
             - distance_ratio : bool, optional
                 If True, outputs the ratio of distance (relative surprisal)
                 between this reacted case and its nearest case to the minimum
@@ -1913,6 +1917,11 @@ class AbstractHowsoClient(ABC):
                 not when computing details robustly. Details will be computed
                 for all context and action features if this value is not
                 specified.
+            - feature_density_convictions : bool, optional
+                If True, outputs the feature density convictions for the local data around the prediction.
+                Computed as the average weighted mean absolute deviation of local values / weighted mean absolute deviation of local values.
+                Will also return 'feature_average_local_mad' and 'feature_local_mad' as explanation details under each of
+                their respective keys.
             - feature_deviations : bool, optional
                 If True, outputs computed feature deviations for all (context
                 and action) features locally around the prediction.
@@ -3591,6 +3600,7 @@ class AbstractHowsoClient(ABC):
         overwrite: bool = False,
         p_value_of_addition: bool | str = False,
         p_value_of_removal: bool | str = False,
+        residual_contribution: bool | str = False,
         similarity_conviction: bool | str = False,
         use_case_weights: t.Optional[bool] = None,
         weight_feature: t.Optional[str] = None,
@@ -3651,6 +3661,10 @@ class AbstractHowsoClient(ABC):
             The name of the feature to store distance contribution.
             If set to True the values will be stored to the
             feature 'distance_contribution'.
+        residual_contribution : bool or str, default False
+            The name of the feature to store residual contribution.
+            If set to True the values will be stored to the
+            feature 'residual_contribution'.
         weight_feature : str, optional
             Name of feature whose values to use as case weights.
             When left unspecified uses the internally managed case weight.
@@ -3675,6 +3689,7 @@ class AbstractHowsoClient(ABC):
             "overwrite": overwrite,
             "p_value_of_addition": p_value_of_addition,
             "p_value_of_removal": p_value_of_removal,
+            "residual_contribution": residual_contribution,
             "similarity_conviction": similarity_conviction,
             "distance_contribution": distance_contribution,
             "weight_feature": weight_feature,

{howso_engine-60.2.2 → howso_engine-60.3.1}/howso/client/schemas/reaction.py

@@ -84,6 +84,15 @@ class ReactDetails(TypedDict, total=False):
     distance_ratio_parts: pd.DataFrame
     """A DataFrame of the parts that are used to compute the distance ratio for each case."""
 
+    feature_density_convictions: pd.DataFrame
+    """A DataFrame of the feature density convictions for the local data around this case. Computed as the average weighted mean absolute deviation of local values / weighted mean absolute deviation of local values"""
+
+    feature_average_local_mad: pd.DataFrame
+    """A DataFrame of the average weighted mean absolute deviation of all local cases for a specific case, using each case's local data for computation."""
+
+    feature_local_mad: pd.DataFrame
+    """A DataFrame of the weighted mean absolute deviation of all local cases for a specific case, using each case's local data for computation."""
+
     feature_deviations: pd.DataFrame
     """
     A DataFrame of the mean absolute error of predicting each feature using the full set of context features and
@@ -210,6 +219,9 @@ class ReactDetails(TypedDict, total=False):
     relevant_values: list[dict[str, pd.Series]]
     """A list of dict mapping feature name to the list of relevant values for each context."""
 
+    residual_contribution: list[float]
+    """A list of the computed residual contribution for each given case."""
+
     similarity_conviction: list[float]
     """A list of the average similarity conviction of cases in each group."""
 

{howso_engine-60.2.2 → howso_engine-60.3.1}/howso/engine/trainee.py

@@ -1493,6 +1493,10 @@ class Trainee(BaseTrainee):
                 If True, outputs the distance contribution (expected total
                 surprisal contribution) for the reacted case. Uses both context
                 and action feature values.
+            - residual_contribution : bool, optional
+                If True, outputs the residual contribution (average feature
+                residual surprisal) for the reacted case. Uses both context
+                and action feature values.
             - distance_ratio : bool, optional
                 If True, outputs the ratio of distance (relative surprisal)
                 between this reacted case and its nearest case to the minimum
@@ -1506,6 +1510,11 @@ class Trainee(BaseTrainee):
                 not when computing details robustly. Details will be computed
                 for all context and action features if this value is not
                 specified.
+            - feature_density_convictions : bool, optional
+                If True, outputs the feature density convictions for the local data around the prediction.
+                Computed as the average weighted mean absolute deviation of local values / weighted mean absolute deviation of local values.
+                Will also return 'feature_average_local_mad' and 'feature_local_mad' as explanation details under each of
+                their respective keys.
             - feature_deviations : bool, optional
                 If True, outputs computed feature deviations for all (context
                 and action) features locally around the prediction.
@@ -3530,6 +3539,7 @@ class Trainee(BaseTrainee):
         overwrite: bool = False,
         p_value_of_addition: str | bool = False,
         p_value_of_removal: str | bool = False,
+        residual_contribution: bool | str = False,
         similarity_conviction: str | bool = False,
         use_case_weights: t.Optional[bool] = None,
         weight_feature: t.Optional[str] = None,
@@ -3584,6 +3594,10 @@ class Trainee(BaseTrainee):
             The name of the feature to store p value of removal
             values. If set to True the values will be stored to the feature
             'p_value_of_removal'.
+        residual_contribution : bool or str, default False
+            The name of the feature to store residual contribution.
+            If set to True the values will be stored to the
+            feature 'residual_contribution'.
         similarity_conviction : bool or str, default False
             The name of the feature to store similarity conviction
             values. If set to True the values will be stored to the feature
@@ -3610,6 +3624,7 @@ class Trainee(BaseTrainee):
                 overwrite=overwrite,
                 p_value_of_addition=p_value_of_addition,
                 p_value_of_removal=p_value_of_removal,
+                residual_contribution=residual_contribution,
                 similarity_conviction=similarity_conviction,
                 features=features,
                 use_case_weights=use_case_weights,

{howso_engine-60.2.2 → howso_engine-60.3.1}/howso/howso-engine/version.json

@@ -1,10 +1,10 @@
 {
-  "version": "115.3.2",
+  "version": "115.4.1",
   "dependencies": {
-    "amalgam": "78.0.2"
+    "amalgam": "80.0.2"
   },
   "display_title": "",
   "build_date": "",
-  "sha": "91523a9761f1d5fd5fa7fb34c791739e8b0aa516",
-  "url": "https://github.com/howsoai/howso-engine/releases/tag/115.3.2"
+  "sha": "7857102e12dcbfe51ea98f9806595a0e9cc594af",
+  "url": "https://github.com/howsoai/howso-engine/releases/tag/115.4.1"
 }

{howso_engine-60.2.2 → howso_engine-60.3.1}/howso/scikit/scikit.py

@@ -714,6 +714,11 @@ class HowsoEstimator(BaseEstimator):
                 not when computing details robustly. Details will be computed
                 for all context and action features if this value is not
                 specified.
+            - feature_density_convictions : bool, optional
+                If True, outputs the feature density convictions for the local data around the prediction.
+                Computed as the average weighted mean absolute deviation of local values / weighted mean absolute deviation of local values.
+                Will also return 'feature_average_local_mad' and 'feature_local_mad' as explanation details under each of
+                their respective keys.
             - feature_deviations : bool, optional
                 If True, outputs computed feature deviations for all (context
                 and action) features locally around the prediction.

{howso_engine-60.2.2 → howso_engine-60.3.1/howso_engine.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: howso-engine
-Version: 60.2.2
+Version: 60.3.1
 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==31.0.1
+Requires-Dist: amalgam-lang==32.0.1
 Provides-Extra: dev
 Requires-Dist: dill~=0.0; extra == "dev"
 Requires-Dist: flake8-docstrings; extra == "dev"

{howso_engine-60.2.2 → howso_engine-60.3.1}/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==31.0.1
+amalgam-lang==32.0.1
 
 [dev]
 dill~=0.0

{howso_engine-60.2.2 → howso_engine-60.3.1}/pyproject.toml

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

{howso_engine-60.2.2 → howso_engine-60.3.1}/requirements-3.10-dev.txt

@@ -4,7 +4,7 @@
 #
 #    pip-compile --allow-unsafe --cert=None --client-cert=None --extra=dev --extra=scikit --index-url=None --no-emit-index-url --output-file=requirements-3.10-dev.txt --pip-args=None
 #
-amalgam-lang==31.0.1
+amalgam-lang==32.0.1
     # via howso-engine (pyproject.toml)
 astroid==4.0.4
     # via pylint
@@ -20,7 +20,7 @@ click==8.4.1
     # via
     #   pip-tools
     #   sacremoses
-coverage[toml]==7.14.0
+coverage[toml]==7.14.1
     # via pytest-cov
 dill==0.4.1
     # via
@@ -30,7 +30,7 @@ exceptiongroup==1.3.1
     # via pytest
 execnet==2.1.2
     # via pytest-xdist
-faker==40.19.1
+faker==40.23.0
     # via howso-engine (pyproject.toml)
 flake8==3.9.2
     # via
@@ -42,7 +42,7 @@ flake8-import-order==0.19.2
     # via howso-engine (pyproject.toml)
 humanize==4.15.0
     # via howso-engine (pyproject.toml)
-idna==3.16
+idna==3.18
     # via requests
 iniconfig==2.3.0
     # via pytest
@@ -82,9 +82,9 @@ pandas==2.3.3
     # via howso-engine (pyproject.toml)
 pip-tools==7.5.3
     # via howso-engine (pyproject.toml)
-pipdeptree==2.35.3
+pipdeptree==3.1.0
     # via howso-engine (pyproject.toml)
-platformdirs==4.9.6
+platformdirs==4.10.0
     # via pylint
 pluggy==1.6.0
     # via
@@ -149,7 +149,7 @@ sentinels==1.1.1
     # via mongomock
 six==1.17.0
     # via python-dateutil
-snowballstemmer==3.0.1
+snowballstemmer==3.1.1
     # via pydocstyle
 threadpoolctl==3.6.0
     # via scikit-learn
@@ -158,11 +158,12 @@ tomli==2.4.1
     #   build
     #   coverage
     #   pip-tools
+    #   pipdeptree
     #   pylint
     #   pytest
 tomlkit==0.15.0
     # via pylint
-tqdm==4.67.3
+tqdm==4.68.2
     # via sacremoses
 typing-extensions==4.15.0
     # via
@@ -179,7 +180,7 @@ wheel==0.47.0
     # via pip-tools
 
 # The following packages are considered to be unsafe in a requirements file:
-pip==26.1.1
+pip==26.1.2
     # via pip-tools
 setuptools==82.0.1
     # via

{howso_engine-60.2.2 → howso_engine-60.3.1}/requirements-3.10.txt

@@ -4,7 +4,7 @@
 #
 #    pip-compile --allow-unsafe --cert=None --client-cert=None --index-url=None --no-emit-index-url --output-file=requirements-3.10.txt --pip-args=None
 #
-amalgam-lang==31.0.1
+amalgam-lang==32.0.1
     # via howso-engine (pyproject.toml)
 certifi==2026.5.20
     # via
@@ -14,11 +14,11 @@ charset-normalizer==3.4.7
     # via requests
 click==8.4.1
     # via sacremoses
-faker==40.19.1
+faker==40.23.0
     # via howso-engine (pyproject.toml)
 humanize==4.15.0
     # via howso-engine (pyproject.toml)
-idna==3.16
+idna==3.18
     # via requests
 joblib==1.5.3
     # via sacremoses
@@ -60,7 +60,7 @@ semantic-version==2.10.0
     # via howso-engine (pyproject.toml)
 six==1.17.0
     # via python-dateutil
-tqdm==4.67.3
+tqdm==4.68.2
     # via sacremoses
 typing-extensions==4.15.0
     # via howso-engine (pyproject.toml)