attune-ai 2.0.0__py3-none-any.whl

attune_ai-2.0.0.dist-info/METADATA

@@ -0,0 +1,1026 @@
+Metadata-Version: 2.4
+Name: attune-ai
+Version: 2.0.0
+Summary: AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (10 patterns including Anthropic-inspired), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
+Author-email: Patrick Roebuck <admin@smartaimemory.com>
+Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
+License:                                  Apache License
+                                   Version 2.0, January 2004
+                                http://www.apache.org/licenses/
+        
+           TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+        
+           1. Definitions.
+        
+              "License" shall mean the terms and conditions for use, reproduction,
+              and distribution as defined by Sections 1 through 9 of this document.
+        
+              "Licensor" shall mean the copyright owner or entity authorized by
+              the copyright owner that is granting the License.
+        
+              "Legal Entity" shall mean the union of the acting entity and all
+              other entities that control, are controlled by, or are under common
+              control with that entity. For the purposes of this definition,
+              "control" means (i) the power, direct or indirect, to cause the
+              direction or management of such entity, whether by contract or
+              otherwise, or (ii) ownership of fifty percent (50%) or more of the
+              outstanding shares, or (iii) beneficial ownership of such entity.
+        
+              "You" (or "Your") shall mean an individual or Legal Entity
+              exercising permissions granted by this License.
+        
+              "Source" form shall mean the preferred form for making modifications,
+              including but not limited to software source code, documentation
+              source, and configuration files.
+        
+              "Object" form shall mean any form resulting from mechanical
+              transformation or translation of a Source form, including but
+              not limited to compiled object code, generated documentation,
+              and conversions to other media types.
+        
+              "Work" shall mean the work of authorship, whether in Source or
+              Object form, made available under the License, as indicated by a
+              copyright notice that is included in or attached to the work
+              (an example is provided in the Appendix below).
+        
+              "Derivative Works" shall mean any work, whether in Source or Object
+              form, that is based on (or derived from) the Work and for which the
+              editorial revisions, annotations, elaborations, or other modifications
+              represent, as a whole, an original work of authorship. For the purposes
+              of this License, Derivative Works shall not include works that remain
+              separable from, or merely link (or bind by name) to the interfaces of,
+              the Work and Derivative Works thereof.
+        
+              "Contribution" shall mean any work of authorship, including
+              the original version of the Work and any modifications or additions
+              to that Work or Derivative Works thereof, that is intentionally
+              submitted to Licensor for inclusion in the Work by the copyright owner
+              or by an individual or Legal Entity authorized to submit on behalf of
+              the copyright owner. For the purposes of this definition, "submitted"
+              means any form of electronic, verbal, or written communication sent
+              to the Licensor or its representatives, including but not limited to
+              communication on electronic mailing lists, source code control systems,
+              and issue tracking systems that are managed by, or on behalf of, the
+              Licensor for the purpose of discussing and improving the Work, but
+              excluding communication that is conspicuously marked or otherwise
+              designated in writing by the copyright owner as "Not a Contribution."
+        
+              "Contributor" shall mean Licensor and any individual or Legal Entity
+              on behalf of whom a Contribution has been received by Licensor and
+              subsequently incorporated within the Work.
+        
+           2. Grant of Copyright License. Subject to the terms and conditions of
+              this License, each Contributor hereby grants to You a perpetual,
+              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+              copyright license to reproduce, prepare Derivative Works of,
+              publicly display, publicly perform, sublicense, and distribute the
+              Work and such Derivative Works in Source or Object form.
+        
+           3. Grant of Patent License. Subject to the terms and conditions of
+              this License, each Contributor hereby grants to You a perpetual,
+              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+              (except as stated in this section) patent license to make, have made,
+              use, offer to sell, sell, import, and otherwise transfer the Work,
+              where such license applies only to those patent claims licensable
+              by such Contributor that are necessarily infringed by their
+              Contribution(s) alone or by combination of their Contribution(s)
+              with the Work to which such Contribution(s) was submitted. If You
+              institute patent litigation against any entity (including a
+              cross-claim or counterclaim in a lawsuit) alleging that the Work
+              or a Contribution incorporated within the Work constitutes direct
+              or contributory patent infringement, then any patent licenses
+              granted to You under this License for that Work shall terminate
+              as of the date such litigation is filed.
+        
+           4. Redistribution. You may reproduce and distribute copies of the
+              Work or Derivative Works thereof in any medium, with or without
+              modifications, and in Source or Object form, provided that You
+              meet the following conditions:
+        
+              (a) You must give any other recipients of the Work or
+                  Derivative Works a copy of this License; and
+        
+              (b) You must cause any modified files to carry prominent notices
+                  stating that You changed the files; and
+        
+              (c) You must retain, in the Source form of any Derivative Works
+                  that You distribute, all copyright, patent, trademark, and
+                  attribution notices from the Source form of the Work,
+                  excluding those notices that do not pertain to any part of
+                  the Derivative Works; and
+        
+              (d) If the Work includes a "NOTICE" text file as part of its
+                  distribution, then any Derivative Works that You distribute must
+                  include a readable copy of the attribution notices contained
+                  within such NOTICE file, excluding those notices that do not
+                  pertain to any part of the Derivative Works, in at least one
+                  of the following places: within a NOTICE text file distributed
+                  as part of the Derivative Works; within the Source form or
+                  documentation, if provided along with the Derivative Works; or,
+                  within a display generated by the Derivative Works, if and
+                  wherever such third-party notices normally appear. The contents
+                  of the NOTICE file are for informational purposes only and
+                  do not modify the License. You may add Your own attribution
+                  notices within Derivative Works that You distribute, alongside
+                  or as an addendum to the NOTICE text from the Work, provided
+                  that such additional attribution notices cannot be construed
+                  as modifying the License.
+        
+              You may add Your own copyright statement to Your modifications and
+              may provide additional or different license terms and conditions
+              for use, reproduction, or distribution of Your modifications, or
+              for any such Derivative Works as a whole, provided Your use,
+              reproduction, and distribution of the Work otherwise complies with
+              the conditions stated in this License.
+        
+           5. Submission of Contributions. Unless You explicitly state otherwise,
+              any Contribution intentionally submitted for inclusion in the Work
+              by You to the Licensor shall be under the terms and conditions of
+              this License, without any additional terms or conditions.
+              Notwithstanding the above, nothing herein shall supersede or modify
+              the terms of any separate license agreement you may have executed
+              with Licensor regarding such Contributions.
+        
+           6. Trademarks. This License does not grant permission to use the trade
+              names, trademarks, service marks, or product names of the Licensor,
+              except as required for reasonable and customary use in describing the
+              origin of the Work and reproducing the content of the NOTICE file.
+        
+           7. Disclaimer of Warranty. Unless required by applicable law or
+              agreed to in writing, Licensor provides the Work (and each
+              Contributor provides its Contributions) on an "AS IS" BASIS,
+              WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+              implied, including, without limitation, any warranties or conditions
+              of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+              PARTICULAR PURPOSE. You are solely responsible for determining the
+              appropriateness of using or redistributing the Work and assume any
+              risks associated with Your exercise of permissions under this License.
+        
+           8. Limitation of Liability. In no event and under no legal theory,
+              whether in tort (including negligence), contract, or otherwise,
+              unless required by applicable law (such as deliberate and grossly
+              negligent acts) or agreed to in writing, shall any Contributor be
+              liable to You for damages, including any direct, indirect, special,
+              incidental, or consequential damages of any character arising as a
+              result of this License or out of the use or inability to use the
+              Work (including but not limited to damages for loss of goodwill,
+              work stoppage, computer failure or malfunction, or any and all
+              other commercial damages or losses), even if such Contributor
+              has been advised of the possibility of such damages.
+        
+           9. Accepting Warranty or Additional Liability. While redistributing
+              the Work or Derivative Works thereof, You may choose to offer,
+              and charge a fee for, acceptance of support, warranty, indemnity,
+              or other liability obligations and/or rights consistent with this
+              License. However, in accepting such obligations, You may act only
+              on Your own behalf and on Your sole responsibility, not on behalf
+              of any other Contributor, and only if You agree to indemnify,
+              defend, and hold each Contributor harmless for any liability
+              incurred by, or claims asserted against, such Contributor by reason
+              of your accepting any such warranty or additional liability.
+        
+           END OF TERMS AND CONDITIONS
+        
+           APPENDIX: How to apply the Apache License to your work.
+        
+              To apply the Apache License to your work, attach the following
+              boilerplate notice, with the fields enclosed by brackets "[]"
+              replaced with your own identifying information. (Don't include
+              the brackets!)  The text should be enclosed in the appropriate
+              comment syntax for the file format. We also recommend that a
+              file or class name and description of purpose be included on the
+              same "printed page" as the copyright notice for easier
+              identification within third-party archives.
+        
+           Copyright 2025 Deep Study AI, LLC
+        
+           Licensed under the Apache License, Version 2.0 (the "License");
+           you may not use this file except in compliance with the License.
+           You may obtain a copy of the License at
+        
+               http://www.apache.org/licenses/LICENSE-2.0
+        
+           Unless required by applicable law or agreed to in writing, software
+           distributed under the License is distributed on an "AS IS" BASIS,
+           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+           See the License for the specific language governing permissions and
+           limitations under the License.
+        
+Project-URL: Homepage, https://www.smartaimemory.com
+Project-URL: Documentation, https://www.smartaimemory.com/framework-docs/
+Project-URL: Getting Started, https://www.smartaimemory.com/framework-docs/tutorials/quickstart/
+Project-URL: FAQ, https://www.smartaimemory.com/framework-docs/reference/FAQ/
+Project-URL: Book, https://www.smartaimemory.com/book
+Project-URL: Repository, https://github.com/Smart-AI-Memory/attune-ai
+Project-URL: Issues, https://github.com/Smart-AI-Memory/attune-ai/issues
+Project-URL: Discussions, https://github.com/Smart-AI-Memory/attune-ai/discussions
+Project-URL: Changelog, https://github.com/Smart-AI-Memory/attune-ai/blob/main/CHANGELOG.md
+Keywords: ai,collaboration,empathy,anticipatory-ai,systems-thinking,llm,claude,memdocs,level-5-ai,code-inspection,static-analysis,code-quality,sarif,github-actions,developer-tools
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE_CHANGE_ANNOUNCEMENT.md
+Requires-Dist: pydantic<3.0.0,>=2.0.0
+Requires-Dist: typing-extensions<5.0.0,>=4.0.0
+Requires-Dist: python-dotenv<2.0.0,>=1.0.0
+Requires-Dist: structlog<26.0.0,>=23.0.0
+Requires-Dist: defusedxml<1.0.0,>=0.7.0
+Requires-Dist: rich<14.0.0,>=13.0.0
+Requires-Dist: typer<1.0.0,>=0.9.0
+Requires-Dist: pyyaml<7.0,>=6.0
+Requires-Dist: anthropic<1.0.0,>=0.25.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "anthropic"
+Provides-Extra: openai
+Requires-Dist: openai<2.0.0,>=1.12.0; extra == "openai"
+Provides-Extra: google
+Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "google"
+Provides-Extra: llm
+Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "llm"
+Requires-Dist: openai<2.0.0,>=1.12.0; extra == "llm"
+Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "llm"
+Provides-Extra: memdocs
+Requires-Dist: memdocs>=1.0.0; extra == "memdocs"
+Provides-Extra: agents
+Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "agents"
+Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "agents"
+Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "agents"
+Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "agents"
+Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "agents"
+Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "agents"
+Provides-Extra: crewai
+Requires-Dist: crewai<1.0.0,>=0.1.0; extra == "crewai"
+Requires-Dist: langchain<2.0.0,>=0.1.0; extra == "crewai"
+Requires-Dist: langchain-core<2.0.0,>=1.2.6; extra == "crewai"
+Provides-Extra: cache
+Requires-Dist: sentence-transformers<4.0.0,>=2.0.0; extra == "cache"
+Requires-Dist: torch<3.0.0,>=2.0.0; extra == "cache"
+Requires-Dist: numpy<3.0.0,>=1.24.0; extra == "cache"
+Provides-Extra: healthcare
+Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "healthcare"
+Requires-Dist: openai<2.0.0,>=1.12.0; extra == "healthcare"
+Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "healthcare"
+Requires-Dist: memdocs>=1.0.0; extra == "healthcare"
+Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "healthcare"
+Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "healthcare"
+Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "healthcare"
+Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "healthcare"
+Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "healthcare"
+Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "healthcare"
+Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "healthcare"
+Requires-Dist: pyyaml<7.0,>=6.0; extra == "healthcare"
+Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "healthcare"
+Requires-Dist: uvicorn<1.0.0,>=0.20.0; extra == "healthcare"
+Requires-Dist: starlette<1.0.0,>=0.40.0; extra == "healthcare"
+Requires-Dist: bcrypt<5.0.0,>=4.0.0; extra == "healthcare"
+Requires-Dist: PyJWT[crypto]>=2.8.0; extra == "healthcare"
+Requires-Dist: opentelemetry-api<2.0.0,>=1.20.0; extra == "healthcare"
+Requires-Dist: opentelemetry-sdk<2.0.0,>=1.20.0; extra == "healthcare"
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2.0.0,>=1.20.0; extra == "healthcare"
+Requires-Dist: redis<6.0.0,>=5.0.0; extra == "healthcare"
+Provides-Extra: software
+Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "software"
+Requires-Dist: pyyaml<7.0,>=6.0; extra == "software"
+Provides-Extra: backend
+Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "backend"
+Requires-Dist: uvicorn<1.0.0,>=0.20.0; extra == "backend"
+Requires-Dist: starlette<1.0.0,>=0.40.0; extra == "backend"
+Requires-Dist: bcrypt<5.0.0,>=4.0.0; extra == "backend"
+Requires-Dist: PyJWT[crypto]>=2.8.0; extra == "backend"
+Provides-Extra: lsp
+Requires-Dist: pygls<2.0.0,>=1.0.0; extra == "lsp"
+Requires-Dist: lsprotocol<2024.0.0,>=2023.0.0; extra == "lsp"
+Provides-Extra: windows
+Requires-Dist: colorama<1.0.0,>=0.4.6; extra == "windows"
+Provides-Extra: otel
+Requires-Dist: opentelemetry-api<2.0.0,>=1.20.0; extra == "otel"
+Requires-Dist: opentelemetry-sdk<2.0.0,>=1.20.0; extra == "otel"
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2.0.0,>=1.20.0; extra == "otel"
+Provides-Extra: docs
+Requires-Dist: mkdocs<2.0.0,>=1.5.0; extra == "docs"
+Requires-Dist: mkdocs-material<10.0.0,>=9.4.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]<1.0.0,>=0.24.0; extra == "docs"
+Requires-Dist: mkdocs-with-pdf<1.0.0,>=0.9.3; extra == "docs"
+Requires-Dist: pymdown-extensions<11.0,>=10.0; extra == "docs"
+Provides-Extra: dev
+Requires-Dist: pytest<10.0,>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio<2.0,>=0.21; extra == "dev"
+Requires-Dist: pytest-cov<8.0,>=4.0; extra == "dev"
+Requires-Dist: pytest-mock<4.0,>=3.14.0; extra == "dev"
+Requires-Dist: pytest-xdist<4.0,>=3.5.0; extra == "dev"
+Requires-Dist: pytest-testmon<3.0,>=2.1.0; extra == "dev"
+Requires-Dist: pytest-picked<1.0,>=0.5.0; extra == "dev"
+Requires-Dist: black<27.0,>=24.3.0; extra == "dev"
+Requires-Dist: mypy<2.0,>=1.0; extra == "dev"
+Requires-Dist: ruff<1.0,>=0.1; extra == "dev"
+Requires-Dist: coverage<8.0,>=7.0; extra == "dev"
+Requires-Dist: bandit<2.0,>=1.7; extra == "dev"
+Requires-Dist: pre-commit<5.0,>=3.0; extra == "dev"
+Requires-Dist: httpx<1.0.0,>=0.27.0; extra == "dev"
+Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "dev"
+Requires-Dist: requests<3.0.0,>=2.28.0; extra == "dev"
+Provides-Extra: developer
+Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "developer"
+Requires-Dist: openai<2.0.0,>=1.12.0; extra == "developer"
+Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "developer"
+Requires-Dist: memdocs>=1.0.0; extra == "developer"
+Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "developer"
+Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "developer"
+Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "developer"
+Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "developer"
+Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "developer"
+Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "developer"
+Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "developer"
+Requires-Dist: pyyaml<7.0,>=6.0; extra == "developer"
+Provides-Extra: enterprise
+Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "enterprise"
+Requires-Dist: openai<2.0.0,>=1.12.0; extra == "enterprise"
+Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "enterprise"
+Requires-Dist: memdocs>=1.0.0; extra == "enterprise"
+Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "enterprise"
+Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "enterprise"
+Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "enterprise"
+Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "enterprise"
+Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "enterprise"
+Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "enterprise"
+Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "enterprise"
+Requires-Dist: pyyaml<7.0,>=6.0; extra == "enterprise"
+Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "enterprise"
+Requires-Dist: uvicorn<1.0.0,>=0.20.0; extra == "enterprise"
+Requires-Dist: starlette<1.0.0,>=0.40.0; extra == "enterprise"
+Requires-Dist: bcrypt<5.0.0,>=4.0.0; extra == "enterprise"
+Requires-Dist: PyJWT[crypto]>=2.8.0; extra == "enterprise"
+Requires-Dist: opentelemetry-api<2.0.0,>=1.20.0; extra == "enterprise"
+Requires-Dist: opentelemetry-sdk<2.0.0,>=1.20.0; extra == "enterprise"
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2.0.0,>=1.20.0; extra == "enterprise"
+Provides-Extra: full
+Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "full"
+Requires-Dist: openai<2.0.0,>=1.12.0; extra == "full"
+Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "full"
+Requires-Dist: memdocs>=1.0.0; extra == "full"
+Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "full"
+Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "full"
+Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "full"
+Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "full"
+Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "full"
+Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "full"
+Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "full"
+Requires-Dist: pyyaml<7.0,>=6.0; extra == "full"
+Provides-Extra: all
+Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "all"
+Requires-Dist: openai<2.0.0,>=1.12.0; extra == "all"
+Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "all"
+Requires-Dist: memdocs>=1.0.0; extra == "all"
+Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "all"
+Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "all"
+Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "all"
+Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "all"
+Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "all"
+Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "all"
+Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "all"
+Requires-Dist: pyyaml<7.0,>=6.0; extra == "all"
+Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "all"
+Requires-Dist: uvicorn<1.0.0,>=0.20.0; extra == "all"
+Requires-Dist: starlette<1.0.0,>=0.40.0; extra == "all"
+Requires-Dist: bcrypt<5.0.0,>=4.0.0; extra == "all"
+Requires-Dist: PyJWT[crypto]>=2.8.0; extra == "all"
+Requires-Dist: pygls<2.0.0,>=1.0.0; extra == "all"
+Requires-Dist: lsprotocol<2024.0.0,>=2023.0.0; extra == "all"
+Requires-Dist: colorama<1.0.0,>=0.4.6; extra == "all"
+Requires-Dist: opentelemetry-api<2.0.0,>=1.20.0; extra == "all"
+Requires-Dist: opentelemetry-sdk<2.0.0,>=1.20.0; extra == "all"
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2.0.0,>=1.20.0; extra == "all"
+Requires-Dist: mkdocs<2.0.0,>=1.5.0; extra == "all"
+Requires-Dist: mkdocs-material<10.0.0,>=9.4.0; extra == "all"
+Requires-Dist: mkdocstrings[python]<1.0.0,>=0.24.0; extra == "all"
+Requires-Dist: mkdocs-with-pdf<1.0.0,>=0.9.3; extra == "all"
+Requires-Dist: pymdown-extensions<11.0,>=10.0; extra == "all"
+Requires-Dist: pytest<10.0,>=7.0; extra == "all"
+Requires-Dist: pytest-asyncio<2.0,>=0.21; extra == "all"
+Requires-Dist: pytest-cov<8.0,>=4.0; extra == "all"
+Requires-Dist: black<27.0,>=24.3.0; extra == "all"
+Requires-Dist: mypy<2.0,>=1.0; extra == "all"
+Requires-Dist: ruff<1.0,>=0.1; extra == "all"
+Requires-Dist: coverage<8.0,>=7.0; extra == "all"
+Requires-Dist: bandit<2.0,>=1.7; extra == "all"
+Requires-Dist: pre-commit<5.0,>=3.0; extra == "all"
+Requires-Dist: httpx<1.0.0,>=0.27.0; extra == "all"
+Requires-Dist: urllib3<3.0.0,>=2.3.0; extra == "all"
+Requires-Dist: aiohttp<4.0.0,>=3.10.0; extra == "all"
+Requires-Dist: filelock<4.0.0,>=3.16.0; extra == "all"
+Dynamic: license-file
+
+# Empathy Framework
+
+**AI-powered developer workflows with cost optimization and pattern learning.**
+
+Run code review, debugging, testing, and release workflows from your terminal or Claude Code. Smart tier routing saves 34-86% on LLM costs.
+
+[![PyPI](https://img.shields.io/pypi/v/attune-ai?color=blue)](https://pypi.org/project/attune-ai/)
+[![Tests](https://img.shields.io/badge/tests-7%2C168%20passing%20(99.9%25)-brightgreen)](https://github.com/Smart-AI-Memory/attune-ai/actions)
+[![Python](https://img.shields.io/badge/python-3.10+-blue)](https://www.python.org)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+[![Performance](https://img.shields.io/badge/performance-18x%20faster-success)](https://github.com/Smart-AI-Memory/attune-ai/blob/main/CHANGELOG.md)
+
+```bash
+pip install attune-ai[developer]
+```
+
+---
+
+## 🎯 Transitioning to Claude-Native Architecture
+
+**Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
+
+- **📦 Prompt Caching:** 90% cost reduction on repeated prompts
+- **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases
+- **🧠 Extended Thinking:** See Claude's internal reasoning process
+- **🔧 Advanced Tool Use:** Optimized for agentic workflows
+
+**Timeline:**
+
+- ✅ **v4.8.0 (Jan 2026):** Deprecation warnings for OpenAI/Google/Ollama providers
+- ✅ **v5.0.0 (Jan 26, 2026):** Non-Anthropic providers removed (BREAKING - COMPLETE)
+- ✅ **v5.0.2 (Jan 28, 2026):** Cost optimization suite with batch processing and caching monitoring
+
+**Migration Guide:** [docs/CLAUDE_NATIVE.md](docs/CLAUDE_NATIVE.md)
+
+---
+
+## What's New in v5.3.0
+
+**🎨 Dashboard Enhancements** - Improved usability and clarity:
+
+- **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., "Code Analyzer" instead of UUID)
+- **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup
+- **UX Improvements** - "Source Agent:" label clarity, "Redis Requires Enabling" status message
+- **Browser Cache Busting** - Date-based versioning ensures updates appear immediately
+
+**📚 Documentation Improvements**:
+
+- Clarified flexible context strategy (200K subscription + 1M API routing)
+- Added Redis requirement documentation for dashboard
+- Root directory cleanup (8 archived files)
+
+**🧪 Test Infrastructure**:
+
+- Sequential test execution to fix import timing issues
+- All agent tracking tests passing (19/19)
+
+[See Full Changelog](CHANGELOG.md#530---2026-01-31)
+
+---
+
+## What's New in v5.1.0
+
+**🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
+
+- **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns:
+  - Agent heartbeats and status tracking
+  - Inter-agent coordination signals
+  - Event streaming across agent workflows
+  - Approval gates for human-in-the-loop
+  - Quality feedback and performance metrics
+  - Demo mode with test data generation
+
+- **Custom Agents** - Build specialized agents for your workflow needs
+- **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities
+- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**
+
+**🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
+
+```bash
+# Interactive setup
+python -m attune.models.auth_cli setup
+
+# View current configuration
+python -m attune.models.auth_cli status
+
+# Get recommendation for a file
+python -m attune.models.auth_cli recommend src/module.py
+```
+
+**💰 Automatic Cost Optimization** - Workflows choose the best auth method:
+
+- Small/medium modules (<2000 LOC) → Claude subscription (free)
+- Large modules (>2000 LOC) → Anthropic API (pay for what you need)
+- 7 workflows integrated: document-gen, test-gen, code-review, bug-predict, security-audit, perf-audit, release-prep
+- Auth mode tracking in all workflow outputs for telemetry
+
+**🧪 Comprehensive Testing** - 7 new integration tests for auth strategy:
+
+- All workflows tested with auth enabled/disabled
+- API and subscription mode verification
+- Cost tracking validation
+
+**📖 Documentation** - 950+ lines across 3 guides:
+
+- [AUTH_STRATEGY_GUIDE.md](docs/AUTH_STRATEGY_GUIDE.md) - User guide for configuration
+- [AUTH_CLI_IMPLEMENTATION.md](docs/AUTH_CLI_IMPLEMENTATION.md) - CLI command reference
+- [AUTH_WORKFLOW_INTEGRATIONS.md](docs/AUTH_WORKFLOW_INTEGRATIONS.md) - Integration patterns
+
+[See Full Changelog](CHANGELOG.md#510---2026-01-29)
+
+---
+
+## What's New in v5.0.2
+
+**💰 50% Cost Savings with Batch API** - Process non-urgent tasks asynchronously:
+
+```bash
+empathy batch submit batch_requests.json  # Submit batch job
+empathy batch status msgbatch_abc123      # Check progress
+empathy batch results msgbatch_abc123 output.json  # Download results
+```
+
+Perfect for: log analysis, report generation, bulk classification, test generation
+
+**📊 Precise Token Counting** - >98% accurate cost tracking:
+
+- Integrated Anthropic's `count_tokens()` API for billing-accurate measurements
+- 3-tier fallback: API → tiktoken (local) → heuristic
+- Cache-aware cost calculation (25% write markup, 90% read discount)
+
+**📈 Cache Performance Monitoring** - Track your 20-30% caching savings:
+
+```bash
+empathy cache stats           # Show hit rates and cost savings
+empathy cache stats --verbose # Detailed token metrics
+empathy cache stats --format json  # Machine-readable output
+```
+
+**🧭 Adaptive Routing Analytics** - Intelligent tier recommendations:
+
+```bash
+empathy routing stats <workflow>    # Performance metrics
+empathy routing check --all         # Tier upgrade recommendations
+empathy routing models --provider anthropic  # Compare models
+```
+
+**🔧 Dashboard Fixes** - All 6 agent coordination patterns now operational:
+- Agent heartbeats displaying correctly
+- Event streaming functional
+- Coordination signals working
+- Approval gates operational
+
+[See Full Changelog](CHANGELOG.md#502---2026-01-28) | [Batch API Guide](docs/BATCH_API_GUIDE.md) | [User API Docs](docs/USER_API_DOCUMENTATION.md)
+
+---
+
+## What's New in v4.9.0
+
+**⚡ 18x Faster Performance** - Massive performance gains through Phase 2 optimizations:
+
+- **Redis Two-Tier Caching:** 2x faster memory operations (37,000x for cached keys)
+- **Generator Expressions:** 99.9% memory reduction across 27 optimizations
+- **Parallel Scanning:** Multi-core processing enabled by default (2-4x faster)
+- **Incremental Scanning:** Git diff-based updates (10x faster)
+
+**🧭 Natural Language Workflows** - Use plain English instead of workflow names:
+
+```bash
+/workflows "find security vulnerabilities"  # → security-audit
+/workflows "check code performance"         # → perf-audit
+/workflows "predict bugs"                   # → bug-predict
+/plan "review my code"                      # → code-review
+```
+
+**📊 Real-World Performance:**
+
+- Combined workflow: 3.59s → 0.2s (**18x faster**)
+- Full scan: 3,472 files in 0.98s (was 3.59s)
+- Redis cached operations: 37ms → 0.001ms
+
+**🎯 Improved Navigation:**
+
+- Split `/workflow` into `/workflows` (automated analysis) and `/plan` (planning/review)
+- Clearer hub organization with better categorization
+- Natural language routing matches intent to workflow
+
+[See CHANGELOG.md](CHANGELOG.md) | [Performance Docs](docs/REDIS_OPTIMIZATION_SUMMARY.md)
+
+---
+
+## What's New in v4.7.0
+
+**$0 Workflows via Skills** - Multi-agent workflows run through Claude Code's Task tool instead of API calls. No additional cost with your Claude subscription.
+
+**Socratic Workflows** - Interactive discovery through guided questions. Workflows ask what you need rather than requiring upfront configuration.
+
+**Security Hardened** - Fixed critical vulnerabilities (path traversal, JWT, SSRF).
+
+**Hub-Based Commands** - Organized workflows into intuitive command hubs.
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install attune-ai[developer]
+```
+
+### 2. Configure
+
+```bash
+# Auto-detect API keys
+python -m attune.models.cli provider
+
+# Or set explicitly
+python -m attune.models.cli provider --set anthropic
+```
+
+### 3. Use
+
+**In Claude Code:**
+
+```bash
+/dev           # Developer tools (debug, commit, PR, review)
+/testing       # Run tests, coverage, benchmarks
+/workflows     # Automated analysis (security, bugs, perf)
+/plan          # Planning, TDD, code review
+/docs          # Documentation generation
+/release       # Release preparation
+
+# Natural language support:
+/workflows "find security issues"
+/plan "review my code"
+
+# Direct tool access via MCP (v5.1.1+):
+# Claude Code automatically discovers Empathy tools through the MCP server
+# Just describe what you need in natural language:
+"Run a security audit on src/"          → Invokes security_audit tool
+"Generate tests for config.py"          → Invokes test_generation tool
+"Check my auth configuration"           → Invokes auth_status tool
+"Analyze performance bottlenecks"       → Invokes performance_audit tool
+```
+
+**MCP Server Integration (v5.1.1+):**
+
+Empathy Framework now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
+
+- **10 Tools Available:** security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status
+- **Automatic Discovery:** No manual configuration needed - Claude Code finds tools via `.claude/mcp.json`
+- **Natural Language Access:** Describe your need and Claude invokes the appropriate tool
+- **Verification Hooks:** Automatic validation of Python/JSON files and workflow outputs
+
+To verify MCP integration:
+
+```bash
+# Check server is running
+echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m attune.mcp.server
+
+# Restart Claude Code to load the MCP server
+# Tools will appear in Claude's tool list automatically
+```
+
+See [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integration details.
+
+**CLI:**
+
+```bash
+empathy workflow run security-audit --path ./src
+empathy workflow run test-coverage --target 90
+empathy telemetry show  # View cost savings
+```
+
+**Python:**
+
+```python
+from attune import EmpathyOS
+
+async with EmpathyOS() as empathy:
+    result = await empathy.level_2_guided(
+        "Review this code for security issues"
+    )
+    print(result["response"])
+```
+
+---
+
+## Command Hubs
+
+Workflows are organized into hubs for easy discovery:
+
+| Hub               | Command       | Description                                  |
+| ----------------- | ------------- | -------------------------------------------- |
+| **Developer**     | `/dev`        | Debug, commit, PR, code review, quality      |
+| **Testing**       | `/testing`    | Run tests, coverage analysis, benchmarks     |
+| **Documentation** | `/docs`       | Generate and manage documentation            |
+| **Release**       | `/release`    | Release prep, security scan, publishing      |
+| **Workflows**     | `/workflows`  | Automated analysis (security, bugs, perf)    |
+| **Plan**          | `/plan`       | Planning, TDD, code review, refactoring      |
+| **Utilities**     | `/utilities`  | Project init, dependencies, profiling        |
+| **Learning**      | `/learning`   | Pattern learning and session evaluation      |
+| **Context**       | `/context`    | State management and memory                  |
+| **Agent**         | `/agent`      | Create and manage custom agents              |
+
+**Natural Language Support:**
+
+```bash
+# Use plain English - intelligent routing matches your intent
+/workflows "find security vulnerabilities"  # → security-audit
+/workflows "check code performance"         # → perf-audit
+/workflows "predict bugs"                   # → bug-predict
+/plan "review my code"                      # → code-review
+/plan "help me plan this feature"           # → planning
+
+# Or use traditional workflow names
+/workflows security-audit
+/plan code-review
+```
+
+**Interactive menus:**
+
+```bash
+/dev                    # Show interactive menu
+/dev "debug auth error" # Jump directly to debugging
+/testing "run coverage" # Run coverage analysis
+/release                # Start release preparation
+```
+
+---
+
+## Socratic Method
+
+Workflows guide you through discovery instead of requiring upfront configuration:
+
+```text
+You: /dev
+
+Claude: What development task do you need?
+  1. Debug issue
+  2. Create commit
+  3. PR workflow
+  4. Quality check
+
+You: 1
+
+Claude: What error or unexpected behavior are you seeing?
+```
+
+**How it works:**
+
+1. **Discovery** - Workflow asks targeted questions to understand your needs
+2. **Context gathering** - Collects relevant code, errors, and constraints
+3. **Dynamic agent creation** - Assembles the right team based on your answers
+4. **Execution** - Runs with appropriate tier selection
+
+**Create custom agents with Socratic guidance:**
+
+```bash
+/agent create    # Guided agent creation
+/agent team      # Build multi-agent teams interactively
+```
+
+---
+
+## Cost Optimization
+
+### Skills = $0 (Claude Code)
+
+When using Claude Code, workflows run as skills through the Task tool - **no API costs**:
+
+```bash
+/dev           # $0 - uses your Claude subscription
+/testing       # $0
+/release       # $0
+/agent create  # $0
+```
+
+### API Mode (CI/CD, Automation)
+
+For programmatic use, smart tier routing saves 34-86%:
+
+| Tier    | Model               | Use Case                    | Cost        |
+| ------- | ------------------- | --------------------------- | ----------- |
+| CHEAP   | Haiku / GPT-4o-mini | Formatting, simple tasks    | ~$0.005     |
+| CAPABLE | Sonnet / GPT-4o     | Bug fixes, code review      | ~$0.08      |
+| PREMIUM | Opus / o1           | Architecture, complex design | ~$0.45      |
+
+```bash
+# Track API usage and savings
+empathy telemetry savings --days 30
+```
+
+---
+
+## Key Features
+
+### Multi-Agent Workflows
+
+```bash
+# 4 parallel agents check release readiness
+empathy orchestrate release-prep
+
+# Sequential coverage improvement
+empathy orchestrate test-coverage --target 90
+```
+
+### Response Caching
+
+Up to 57% cache hit rate on similar prompts. Zero config needed.
+
+```python
+from attune.workflows import SecurityAuditWorkflow
+
+workflow = SecurityAuditWorkflow(enable_cache=True)
+result = await workflow.execute(target_path="./src")
+print(f"Cache hit rate: {result.cost_report.cache_hit_rate:.1f}%")
+```
+
+### Pattern Learning
+
+Workflows learn from outcomes and improve over time:
+
+```python
+from attune.orchestration.config_store import ConfigurationStore
+
+store = ConfigurationStore()
+best = store.get_best_for_task("release_prep")
+print(f"Success rate: {best.success_rate:.1%}")
+```
+
+### Multi-Provider Support
+
+```python
+from attune_llm.providers import (
+    AnthropicProvider,  # Claude
+    OpenAIProvider,     # GPT-4
+    GeminiProvider,     # Gemini
+    LocalProvider,      # Ollama, LM Studio
+)
+```
+
+---
+
+## CLI Reference
+
+```bash
+# Provider configuration
+python -m attune.models.cli provider
+python -m attune.models.cli provider --set hybrid
+
+# Workflows
+empathy workflow list
+empathy workflow run <workflow-name>
+
+# Cost tracking
+empathy telemetry show
+empathy telemetry savings --days 30
+empathy telemetry export --format csv
+
+# Orchestration
+empathy orchestrate release-prep
+empathy orchestrate test-coverage --target 90
+
+# Meta-workflows
+empathy meta-workflow list
+empathy meta-workflow run release-prep --real
+```
+
+---
+
+## Install Options
+
+```bash
+# Individual developers (recommended)
+pip install attune-ai[developer]
+
+# All LLM providers
+pip install attune-ai[llm]
+
+# With caching (semantic similarity)
+pip install attune-ai[cache]
+
+# Enterprise (auth, rate limiting)
+pip install attune-ai[enterprise]
+
+# Healthcare (HIPAA compliance)
+pip install attune-ai[healthcare]
+
+# Development
+git clone https://github.com/Smart-AI-Memory/attune-ai.git
+cd attune-ai && pip install -e .[dev]
+```
+
+---
+
+## Environment Setup
+
+```bash
+# At least one provider required
+export ANTHROPIC_API_KEY="sk-ant-..."
+export OPENAI_API_KEY="sk-..."
+export GOOGLE_API_KEY="..."
+
+# Optional (but required for Agent Dashboard): Redis for memory
+export REDIS_URL="redis://localhost:6379"
+```
+
+---
+
+## VSCode Extension
+
+Install the Empathy VSCode extension for:
+
+- **Dashboard** - Health score, costs, patterns
+- **One-Click Workflows** - Run from command palette
+- **Memory Panel** - Manage Redis and patterns
+- **Cost Tracking** - Real-time savings display
+
+---
+
+## Documentation
+
+- [Quick Start Guide](docs/quickstart.md)
+- [CLI Reference](docs/cli-reference.md)
+- [Testing Guide](docs/testing-guide.md)
+- [Keyboard Shortcuts](docs/keyboard-shortcuts.md)
+- [Full Documentation](https://smartaimemory.com/framework-docs/)
+
+---
+
+## Security
+
+- Path traversal protection on all file operations
+- JWT authentication with rate limiting
+- PII scrubbing in telemetry
+- HIPAA/GDPR compliance options
+- **Automated security scanning** with 82% accuracy (Phase 3 AST-based detection)
+
+See [SECURITY.md](SECURITY.md) for vulnerability reporting.
+
+### Security Scanning
+
+**Automated security scanning in CI/CD** - 82% accuracy, blocks critical issues:
+
+```bash
+# Run security audit locally
+empathy workflow run security-audit
+
+# Scan specific directory
+empathy workflow run security-audit --input '{"path":"./src"}'
+```
+
+**Documentation:**
+
+- **[Developer Workflow Guide](docs/DEVELOPER_SECURITY_WORKFLOW.md)** - Quick reference for handling security findings (all developers)
+- **[CI/CD Integration Guide](docs/CI_SECURITY_SCANNING.md)** - Complete setup and troubleshooting (DevOps, developers)
+- **[Scanner Architecture](docs/SECURITY_SCANNER_ARCHITECTURE.md)** - Technical implementation details (engineers, architects)
+- **[Remediation Process](docs/SECURITY_REMEDIATION_PROCESS.md)** - 3-phase methodology for improving scanners (security teams, leadership)
+- **[API Reference](docs/api-reference/security-scanner.md)** - Complete API documentation (developers extending scanner)
+
+**Key achievements:**
+
+- 82.3% reduction in false positives (350 → 62 findings)
+- 16x improvement in scanner accuracy
+- <15 minute average fix time for critical issues
+- Zero critical vulnerabilities in production code
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+**Apache License 2.0** - Free and open source for everyone. Use it, modify it, build commercial products with it. [Details →](LICENSE)
+
+---
+
+## Acknowledgements
+
+This project stands on the shoulders of giants. We are deeply grateful to the open source community and all the amazing projects that make this framework possible.
+
+**[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)**
+
+Special thanks to:
+
+- **[Anthropic](https://www.anthropic.com/)** - For Claude AI and the Model Context Protocol
+- **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our meta-orchestration
+- **[FastAPI](https://github.com/tiangolo/fastapi)** - Modern Python web framework
+- **[pytest](https://github.com/pytest-dev/pytest)** - Testing framework making quality assurance effortless
+
+And to all 50+ open source projects we depend on. [See the complete list →](ACKNOWLEDGEMENTS.md)
+
+Want to contribute? See [CONTRIBUTORS.md](CONTRIBUTORS.md)
+
+---
+
+**Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [Examples](examples/) · [Issues](https://github.com/Smart-AI-Memory/attune-ai/issues)