lionagi 0.14.6__tar.gz → 0.14.7__tar.gz

{lionagi-0.14.6 → lionagi-0.14.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lionagi
-Version: 0.14.6
+Version: 0.14.7
 Summary: An Intelligence Operating System.
 Author-email: HaiyangLi <quantocean.li@gmail.com>, Liangbingyan Luo <llby_luo@outlook.com>
 License:            Apache License
@@ -234,9 +234,9 @@ Requires-Dist: tiktoken>=0.8.0
 Requires-Dist: toml>=0.9.0
 Provides-Extra: all
 Requires-Dist: aiosqlite>=0.21.0; extra == 'all'
-Requires-Dist: claude-code-sdk>=0.0.14; extra == 'all'
+Requires-Dist: claude-code-sdk>=0.0.15; extra == 'all'
 Requires-Dist: datamodel-code-generator>=0.31.2; extra == 'all'
-Requires-Dist: docling>=2.15.1; extra == 'all'
+Requires-Dist: docling>=2.15.0; extra == 'all'
 Requires-Dist: fastmcp>=2.10.5; extra == 'all'
 Requires-Dist: matplotlib>=3.7.0; extra == 'all'
 Requires-Dist: networkx>=3.0.0; extra == 'all'
@@ -244,36 +244,26 @@ Requires-Dist: ollama>=0.4.0; extra == 'all'
 Requires-Dist: pydapter[postgres]; extra == 'all'
 Requires-Dist: rich>=13.0.0; extra == 'all'
 Provides-Extra: claude-code
-Requires-Dist: claude-code-sdk>=0.0.14; extra == 'claude-code'
-Provides-Extra: docs
-Requires-Dist: furo>=2024.8.6; extra == 'docs'
-Requires-Dist: sphinx-autobuild>=2024.10.3; extra == 'docs'
-Requires-Dist: sphinx>=8.1.3; extra == 'docs'
+Requires-Dist: claude-code-sdk>=0.0.15; extra == 'claude-code'
 Provides-Extra: graph
 Requires-Dist: matplotlib>=3.7.0; extra == 'graph'
 Requires-Dist: networkx>=3.0.0; extra == 'graph'
-Provides-Extra: lint
-Requires-Dist: black[jupyter]>=24.10.0; extra == 'lint'
-Requires-Dist: isort>=5.13.2; extra == 'lint'
-Requires-Dist: pre-commit>=4.0.1; extra == 'lint'
 Provides-Extra: mcp
 Requires-Dist: fastmcp>=2.10.5; extra == 'mcp'
 Provides-Extra: ollama
 Requires-Dist: ollama>=0.4.0; extra == 'ollama'
 Provides-Extra: postgres
-Requires-Dist: aiosqlite>=0.21.0; extra == 'postgres'
 Requires-Dist: pydapter[postgres]; extra == 'postgres'
 Provides-Extra: reader
-Requires-Dist: docling>=2.15.1; extra == 'reader'
+Requires-Dist: docling>=2.15.0; extra == 'reader'
 Provides-Extra: rich
 Requires-Dist: rich>=13.0.0; extra == 'rich'
 Provides-Extra: schema
 Requires-Dist: datamodel-code-generator>=0.31.2; extra == 'schema'
-Provides-Extra: test
-Requires-Dist: pytest-asyncio>=1.0.0; extra == 'test'
-Requires-Dist: pytest>=8.3.4; extra == 'test'
+Provides-Extra: sqlite
+Requires-Dist: aiosqlite>=0.21.0; extra == 'sqlite'
 Provides-Extra: tools
-Requires-Dist: docling>=2.15.1; extra == 'tools'
+Requires-Dist: docling>=2.15.0; extra == 'tools'
 Description-Content-Type: text/markdown
 
 ![PyPI - Version](https://img.shields.io/pypi/v/lionagi?labelColor=233476aa&color=231fc935)
@@ -416,7 +406,7 @@ Seamlessly route to different models in the same workflow.
 
 ### Claude Code Integration
 
-LionAGI now supports Anthropic's [Claude Code SDK](https://github.com/anthropics/claude-code-sdk), enabling autonomous coding capabilities with persistent session management:
+LionAGI now supports Anthropic's [Claude Code Python SDK](https://github.com/anthropics/claude-code-sdk-python), enabling autonomous coding capabilities with persistent session management:
 
 ```python
 from lionagi import iModel, Branch

{lionagi-0.14.6 → lionagi-0.14.7}/README.md

@@ -138,7 +138,7 @@ Seamlessly route to different models in the same workflow.
 
 ### Claude Code Integration
 
-LionAGI now supports Anthropic's [Claude Code SDK](https://github.com/anthropics/claude-code-sdk), enabling autonomous coding capabilities with persistent session management:
+LionAGI now supports Anthropic's [Claude Code Python SDK](https://github.com/anthropics/claude-code-sdk-python), enabling autonomous coding capabilities with persistent session management:
 
 ```python
 from lionagi import iModel, Branch

lionagi-0.14.7/cookbooks/007_fan_out_in.py

@@ -0,0 +1,110 @@
+from lionagi import Branch, Builder, Session, iModel
+from lionagi.fields import LIST_INSTRUCT_FIELD_MODEL, Instruct
+
+CC_WORKSPACE = ".khive/workspace"
+
+
+def create_cc(
+    subdir: str,
+    model: str = "sonnet",
+    verbose_output: bool = True,
+    permission_mode="default",
+    auto_finish: bool = False,
+):
+    return iModel(
+        provider="claude_code",
+        endpoint="query_cli",
+        model=model,
+        api_key="dummy_api_key",
+        ws=f"{CC_WORKSPACE}/{subdir}",
+        verbose_output=verbose_output,
+        add_dir="../../../",
+        permission_mode=permission_mode,
+        cli_display_theme="dark",
+        auto_finish=auto_finish,
+    )
+
+
+prompt = """
+Task: Investigate the codebase in the specified directory and provide a comprehensive overview.
+
+---START
+read into the specified dir, glance over the key components and pay attention to architecture, 
+design patterns, and any notable features. Think deeply about the codebase and give three parallel
+instructions, as part of the structured output (`instruct_models`) in the final response message.
+
+---Then
+The instruct models will be run in parallel by each researcher branch, and I will provide you with 
+the researchers' findings for you to continue your investigation.
+
+---Finally
+Once the researchers have completed their tasks, synthesize the information they provided into a cohesive
+overview of the codebase, including:
+1. Key components and their roles
+2. Architectural patterns used
+3. Design patterns and notable features
+---END
+"""
+
+
+async def main():
+    try:
+        orc_cc = create_cc("orchestrator")
+        orc_branch = Branch(
+            chat_model=orc_cc,
+            parse_model=orc_cc,
+            use_lion_system_message=True,
+            system_datetime=True,
+            name="orchestrator",
+        )
+        session = Session(default_branch=orc_branch)
+
+        builder = Builder("CodeInvestigator")
+        root = builder.add_operation(
+            "operate",
+            instruct=Instruct(
+                instruction=prompt,
+                context="lionagi",
+            ),
+            reason=True,
+            field_models=[LIST_INSTRUCT_FIELD_MODEL],
+        )
+
+        result = await session.flow(builder.get_graph())
+
+        instruct_models: list[Instruct] = result["operation_results"][
+            root
+        ].instruct_models
+        research_nodes = []
+
+        for i in instruct_models:
+            node = builder.add_operation(
+                "communicate",
+                depends_on=[root],
+                chat_model=create_cc("researcher"),
+                **i.to_dict(),
+            )
+            research_nodes.append(node)
+
+        synthesis = builder.add_aggregation(
+            "communicate",
+            source_node_ids=research_nodes,
+            branch=orc_branch,
+            instruction="Synthesize the information from the researcher branches.",
+        )
+
+        result2 = await session.flow(builder.get_graph())
+        result_synthesis = result2["operation_results"][synthesis]
+        print(result_synthesis)
+
+    except Exception as e:
+        print(f"Error: {e}")
+        import traceback
+
+        traceback.print_exc()
+
+
+if __name__ == "__main__":
+    import anyio
+
+    anyio.run(main)

lionagi-0.14.7/cookbooks/claude_proxy/README.md

@@ -0,0 +1,31 @@
+# LionAGI Claude Code Proxy
+
+to use please first install `lionagi` and `fastapi`
+
+```bash
+uv add lionagi fastapi loguru
+```
+
+then run the proxy with:
+
+```bash
+uv run cookbooks/claude_proxy/claude_code_proxy.py --port 8000
+```
+
+Next, configure a cutsom endpoint 
+
+```python
+from lionagi.service import Endpoint, EndpointConfig, iModel
+claude_code_config = EndpointConfig(
+    name="claude_code_cli_proxy",
+    provider="claude_code_proxy",
+    base_url="http://localhost:8000/v1",
+    endpoint="query",
+    api_key="dummy_api_key",
+    kwargs={"model": "sonnet"},
+)
+cc_proxy_endpoint = Endpoint(claude_code_config)
+claude_code = iModel(endpoint=cc_proxy_endpoint)
+```
+
+Done, now you can run `claude code` in jupyter or any other environment that supports `lionagi`.

lionagi-0.14.7/cookbooks/claude_proxy/claude_code_proxy.py

@@ -0,0 +1,132 @@
+#!/usr/bin/env python3
+"""
+Claude Code Proxy API Server - OpenAI Compatible
+A FastAPI server that proxies requests to Claude Code CLI using OpenAI API format.
+Compatible with Roo Code, Cline, and other OpenAI API clients.
+"""
+
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+from contextlib import asynccontextmanager
+
+import uvicorn
+from fastapi import FastAPI, HTTPException, Request, Response
+from loguru import logger
+
+from lionagi.service.connections.providers.claude_code_cli import (
+    ClaudeCodeCLIEndpoint,
+    ClaudeCodeRequest,
+)
+
+# Configure logging
+logger.remove()
+logger.add(sys.stderr, level="INFO")
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    check_claude_code()
+    logger.info("Claude Code CLI Proxy API started successfully")
+    yield
+    pass
+
+
+# FastAPI app
+app = FastAPI(
+    title="Claude Code Proxy API - OpenAI Compatible",
+    description="Proxy server for Claude Code CLI - Personal Development Use",
+    version="1.0.0",
+    lifespan=lifespan,
+)
+
+
+# Check if Claude Code is available
+def check_claude_code():
+    """Verify Claude Code CLI is installed and accessible"""
+    try:
+        from lionagi.service.connections.providers._claude_code.stream_cli import (
+            CLAUDE,
+        )
+
+        result = subprocess.run(
+            [CLAUDE, "--version"], capture_output=True, text=True
+        )
+        if result.returncode != 0:
+            raise RuntimeError(
+                f"Claude Code not found, please install it first:\n"
+            )
+        logger.info(f"Claude Code found: {result.stdout.strip()}")
+    except Exception as e:
+        logger.error(f"Claude Code check failed: {e}")
+        raise RuntimeError(
+            "Claude Code CLI not found. Please install it first:\n"
+            "npm install -g @anthropic-ai/claude-code"
+        )
+
+
+# Health check
+@app.get("/health")
+async def health_check():
+    return {"status": "healthy", "service": "claude-code-cli-proxy"}
+
+
+@app.post("/v1/query")
+async def query(request: ClaudeCodeRequest):
+
+    endpoint = ClaudeCodeCLIEndpoint()
+    try:
+        return await endpoint._call(payload={"request": request}, headers={})
+    except Exception as e:
+        logger.error(f"Error processing request: {e}")
+        raise HTTPException(
+            status_code=500, detail=f"Internal server error: {str(e)}"
+        )
+
+
+# Error handling
+@app.exception_handler(Exception)
+async def general_exception_handler(request: Request, exc: Exception):
+    logger.error(f"Unhandled exception: {exc}")
+    return Response(
+        content=json.dumps(
+            {
+                "error": {
+                    "message": str(exc),
+                    "type": "internal_error",
+                    "param": None,
+                    "code": None,
+                }
+            }
+        ),
+        status_code=500,
+        media_type="application/json",
+    )
+
+
+if __name__ == "__main__":
+    # Parse command line arguments
+    import argparse
+
+    parser = argparse.ArgumentParser(
+        description="Claude Code Proxy API Server"
+    )
+    parser.add_argument("--host", default="127.0.0.1", help="Host to bind to")
+    parser.add_argument(
+        "--port", type=int, default=8000, help="Port to bind to"
+    )
+    parser.add_argument(
+        "--reload", action="store_true", help="Enable auto-reload"
+    )
+    args = parser.parse_args()
+
+    # Run server
+    uvicorn.run(
+        "claude_code_proxy:app" if args.reload else app,
+        host=args.host,
+        port=args.port,
+        reload=args.reload,
+        log_level="info",
+    )

lionagi-0.14.7/cookbooks/claude_proxy/run_w_claude_code_proxy.ipynb

@@ -0,0 +1,217 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "d2ceb407",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from lionagi.service.connections.endpoint_config import EndpointConfig\n",
+    "from lionagi.service.imodel import Endpoint\n",
+    "from lionagi.service.connections.providers.claude_code_cli import (\n",
+    "    ClaudeCodeRequest,\n",
+    ")\n",
+    "\n",
+    "claude_code_config = EndpointConfig(\n",
+    "    name=\"claude_code_cli_proxy\",\n",
+    "    provider=\"claude_code\",\n",
+    "    base_url=\"http://localhost:8000/v1\",\n",
+    "    endpoint=\"query\",\n",
+    "    api_key=\"dummy_api_key\",\n",
+    "    kwargs={\"model\": \"sonnet\"},\n",
+    ")\n",
+    "claude_code = Endpoint(claude_code_config)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "5fc216f4",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'session_id': 'bb6041af-a950-4364-bef1-f80f40698ec6',\n",
+       " 'model': 'claude-sonnet-4-20250514',\n",
+       " 'chunks': [{'raw': {'type': 'system',\n",
+       "    'subtype': 'init',\n",
+       "    'cwd': '/Users/lion/lionagi/notebooks/using_claude_code',\n",
+       "    'session_id': 'bb6041af-a950-4364-bef1-f80f40698ec6',\n",
+       "    'tools': ['Task',\n",
+       "     'Bash',\n",
+       "     'Glob',\n",
+       "     'Grep',\n",
+       "     'LS',\n",
+       "     'ExitPlanMode',\n",
+       "     'Read',\n",
+       "     'Edit',\n",
+       "     'MultiEdit',\n",
+       "     'Write',\n",
+       "     'NotebookRead',\n",
+       "     'NotebookEdit',\n",
+       "     'WebFetch',\n",
+       "     'TodoWrite',\n",
+       "     'WebSearch'],\n",
+       "    'mcp_servers': [],\n",
+       "    'model': 'claude-sonnet-4-20250514',\n",
+       "    'permissionMode': 'default',\n",
+       "    'apiKeySource': 'none'},\n",
+       "   'type': 'system',\n",
+       "   'thinking': None,\n",
+       "   'text': None,\n",
+       "   'tool_use': None,\n",
+       "   'tool_result': None},\n",
+       "  {'raw': {'type': 'assistant',\n",
+       "    'message': {'id': 'msg_016an9mp2mrH7Fe1Vr6xwSUP',\n",
+       "     'type': 'message',\n",
+       "     'role': 'assistant',\n",
+       "     'model': 'claude-sonnet-4-20250514',\n",
+       "     'content': [{'type': 'text',\n",
+       "       'text': '```python\\ndef factorial(n):\\n    if n < 0:\\n        raise ValueError(\"Factorial is not defined for negative numbers\")\\n    if n == 0 or n == 1:\\n        return 1\\n    \\n    result = 1\\n    for i in range(2, n + 1):\\n        result *= i\\n    return result\\n```'}],\n",
+       "     'stop_reason': None,\n",
+       "     'stop_sequence': None,\n",
+       "     'usage': {'input_tokens': 4,\n",
+       "      'cache_creation_input_tokens': 18345,\n",
+       "      'cache_read_input_tokens': 11019,\n",
+       "      'output_tokens': 85,\n",
+       "      'service_tier': 'standard'}},\n",
+       "    'parent_tool_use_id': None,\n",
+       "    'session_id': 'bb6041af-a950-4364-bef1-f80f40698ec6'},\n",
+       "   'type': 'assistant',\n",
+       "   'thinking': None,\n",
+       "   'text': '```python\\ndef factorial(n):\\n    if n < 0:\\n        raise ValueError(\"Factorial is not defined for negative numbers\")\\n    if n == 0 or n == 1:\\n        return 1\\n    \\n    result = 1\\n    for i in range(2, n + 1):\\n        result *= i\\n    return result\\n```',\n",
+       "   'tool_use': None,\n",
+       "   'tool_result': None},\n",
+       "  {'raw': {'type': 'result',\n",
+       "    'subtype': 'success',\n",
+       "    'is_error': False,\n",
+       "    'duration_ms': 3322,\n",
+       "    'duration_api_ms': 3202,\n",
+       "    'num_turns': 1,\n",
+       "    'result': '```python\\ndef factorial(n):\\n    if n < 0:\\n        raise ValueError(\"Factorial is not defined for negative numbers\")\\n    if n == 0 or n == 1:\\n        return 1\\n    \\n    result = 1\\n    for i in range(2, n + 1):\\n        result *= i\\n    return result\\n```',\n",
+       "    'session_id': 'bb6041af-a950-4364-bef1-f80f40698ec6',\n",
+       "    'total_cost_usd': 0.07340145000000001,\n",
+       "    'usage': {'input_tokens': 4,\n",
+       "     'cache_creation_input_tokens': 18345,\n",
+       "     'cache_read_input_tokens': 11019,\n",
+       "     'output_tokens': 86,\n",
+       "     'server_tool_use': {'web_search_requests': 0},\n",
+       "     'service_tier': 'standard'}},\n",
+       "   'type': 'result',\n",
+       "   'thinking': None,\n",
+       "   'text': None,\n",
+       "   'tool_use': None,\n",
+       "   'tool_result': None}],\n",
+       " 'thinking_log': [],\n",
+       " 'messages': [{'id': 'msg_016an9mp2mrH7Fe1Vr6xwSUP',\n",
+       "   'type': 'message',\n",
+       "   'role': 'assistant',\n",
+       "   'model': 'claude-sonnet-4-20250514',\n",
+       "   'content': [{'type': 'text',\n",
+       "     'text': '```python\\ndef factorial(n):\\n    if n < 0:\\n        raise ValueError(\"Factorial is not defined for negative numbers\")\\n    if n == 0 or n == 1:\\n        return 1\\n    \\n    result = 1\\n    for i in range(2, n + 1):\\n        result *= i\\n    return result\\n```'}],\n",
+       "   'stop_reason': None,\n",
+       "   'stop_sequence': None,\n",
+       "   'usage': {'input_tokens': 4,\n",
+       "    'cache_creation_input_tokens': 18345,\n",
+       "    'cache_read_input_tokens': 11019,\n",
+       "    'output_tokens': 85,\n",
+       "    'service_tier': 'standard'}}],\n",
+       " 'tool_uses': [],\n",
+       " 'tool_results': [],\n",
+       " 'result': '```python\\ndef factorial(n):\\n    if n < 0:\\n        raise ValueError(\"Factorial is not defined for negative numbers\")\\n    if n == 0 or n == 1:\\n        return 1\\n    \\n    result = 1\\n    for i in range(2, n + 1):\\n        result *= i\\n    return result\\n```\\n```python\\ndef factorial(n):\\n    if n < 0:\\n        raise ValueError(\"Factorial is not defined for negative numbers\")\\n    if n == 0 or n == 1:\\n        return 1\\n    \\n    result = 1\\n    for i in range(2, n + 1):\\n        result *= i\\n    return result\\n```',\n",
+       " 'usage': {'input_tokens': 4,\n",
+       "  'cache_creation_input_tokens': 18345,\n",
+       "  'cache_read_input_tokens': 11019,\n",
+       "  'output_tokens': 86,\n",
+       "  'server_tool_use': {'web_search_requests': 0},\n",
+       "  'service_tier': 'standard'},\n",
+       " 'total_cost_usd': 0.07340145000000001,\n",
+       " 'num_turns': 1,\n",
+       " 'duration_ms': 3322,\n",
+       " 'duration_api_ms': 3202,\n",
+       " 'is_error': False}"
+      ]
+     },
+     "execution_count": 2,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "prompt = \"reply in text only, Write a Python function to calculate the factorial of a number.\"\n",
+    "\n",
+    "await claude_code.call(request=ClaudeCodeRequest(prompt=prompt))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "4c173814",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from lionagi import iModel\n",
+    "\n",
+    "claude_code = iModel(endpoint=claude_code)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "fe6dcca4",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "API call failed: 404, message=\"Request failed with status 404: {'detail': 'Not Found'}\", url='http://localhost:8000/v1/query'\n"
+     ]
+    }
+   ],
+   "source": [
+    "result = await claude_code.invoke(\n",
+    "    messages=[\n",
+    "        {\n",
+    "            \"role\": \"user\",\n",
+    "            \"content\": \"reply in text only, Write a Python function to calculate the factorial of a number.\",\n",
+    "        }\n",
+    "    ]\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "88db9e9a",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "result.response"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "lionagi",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.15"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

lionagi-0.14.7/lionagi/libs/hash/__init__.py

@@ -0,0 +1,3 @@
+from .manager import HashUtils
+
+__all__ = ("HashUtils",)

lionagi-0.14.7/lionagi/libs/hash/hash_dict.py

@@ -0,0 +1,108 @@
+import copy
+
+from pydantic import BaseModel as PydanticBaseModel
+
+__all__ = ("hash_dict",)
+
+# --- Canonical Representation Generator ---
+_PRIMITIVE_TYPES = (str, int, float, bool, type(None))
+_TYPE_MARKER_DICT = 0
+_TYPE_MARKER_LIST = 1
+_TYPE_MARKER_TUPLE = 2
+_TYPE_MARKER_SET = 3
+_TYPE_MARKER_FROZENSET = 4
+_TYPE_MARKER_PYDANTIC = 5  # Distinguishes dumped Pydantic models
+
+
+def _generate_hashable_representation(item: any) -> any:
+    """
+    Recursively converts a Python object into a stable, hashable representation.
+    This ensures that logically identical but structurally different inputs
+    (e.g., dicts with different key orders) produce the same representation.
+    """
+    if isinstance(item, _PRIMITIVE_TYPES):
+        return item
+
+    if isinstance(item, PydanticBaseModel):
+        # Process the Pydantic model by first dumping it to a dict, then processing that dict.
+        # The type marker distinguishes this from a regular dictionary.
+        return (
+            _TYPE_MARKER_PYDANTIC,
+            _generate_hashable_representation(item.model_dump()),
+        )
+
+    if isinstance(item, dict):
+        # Sort dictionary items by key (stringified) for order-insensitivity.
+        return (
+            _TYPE_MARKER_DICT,
+            tuple(
+                (str(k), _generate_hashable_representation(v))
+                for k, v in sorted(item.items(), key=lambda x: str(x[0]))
+            ),
+        )
+
+    if isinstance(item, list):
+        return (
+            _TYPE_MARKER_LIST,
+            tuple(_generate_hashable_representation(elem) for elem in item),
+        )
+
+    if isinstance(item, tuple):
+        return (
+            _TYPE_MARKER_TUPLE,
+            tuple(_generate_hashable_representation(elem) for elem in item),
+        )
+
+    # frozenset must be checked before set
+    if isinstance(item, frozenset):
+        try:  # Attempt direct sort for comparable elements
+            sorted_elements = sorted(list(item))
+        except TypeError:  # Fallback for unorderable mixed types
+            sorted_elements = sorted(
+                list(item), key=lambda x: (str(type(x)), str(x))
+            )
+        return (
+            _TYPE_MARKER_FROZENSET,
+            tuple(
+                _generate_hashable_representation(elem)
+                for elem in sorted_elements
+            ),
+        )
+
+    if isinstance(item, set):
+        try:
+            sorted_elements = sorted(list(item))
+        except TypeError:
+            sorted_elements = sorted(
+                list(item), key=lambda x: (str(type(x)), str(x))
+            )
+        return (
+            _TYPE_MARKER_SET,
+            tuple(
+                _generate_hashable_representation(elem)
+                for elem in sorted_elements
+            ),
+        )
+
+    # Fallback for other types (e.g., custom objects not derived from the above)
+    try:
+        return str(item)
+    except Exception:  # If str() fails for some reason
+        return repr(item)
+
+
+def hash_dict(data: any, strict: bool = False) -> int:
+    data_to_process = data
+    if strict:
+        data_to_process = copy.deepcopy(data)
+
+    hashable_repr = _generate_hashable_representation(data_to_process)
+
+    try:
+        return hash(hashable_repr)
+    except TypeError as e:
+        raise TypeError(
+            f"The generated representation for the input data was not hashable. "
+            f"Input type: {type(data).__name__}, Representation type: {type(hashable_repr).__name__}. "
+            f"Original error: {e}"
+        )