DeepFabric 4.8.2__tar.gz → 4.9.0__tar.gz

{deepfabric-4.8.2 → deepfabric-4.9.0}/.github/workflows/docs.yml

@@ -23,7 +23,7 @@ jobs:
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v5
 
       - name: Install uv
-        uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+        uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
 
       - name: Set up Python
         run: uv python install

{deepfabric-4.8.2 → deepfabric-4.9.0}/.github/workflows/integration.yml

@@ -58,7 +58,7 @@ jobs:
           cache: pip
 
       - name: Install uv
-        uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+        uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
         with:
             enable-cache: true
 

{deepfabric-4.8.2 → deepfabric-4.9.0}/.github/workflows/publish.yml

@@ -24,7 +24,7 @@ jobs:
           python-version: '3.x'
 
       - name: Install uv
-        uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+        uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
 
       - name: Build distributions
         run: uv build

{deepfabric-4.8.2 → deepfabric-4.9.0}/.github/workflows/test.yml

@@ -22,7 +22,7 @@ jobs:
         python-version: ${{ matrix.python-version }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@681c641aba71e4a1c380be3ab5e12ad51f415867 # v7
+      uses: astral-sh/setup-uv@61cb8a9741eeb8a550a1b8544337180c0fc8476b # v7
       with:
         enable-cache: true
 

deepfabric-4.9.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,77 @@
+
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to make participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+  advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies within all project spaces, and it also applies when
+an individual is representing the project or its community in public spaces.
+Examples of representing a project or community include using an official
+project e-mail address, posting via an official social media account, or acting
+as an appointed representative at an online or offline event. Representation of
+a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at [hello@alwaysfurther.ai](mailto:hello@alwaysfurther.ai).
+All complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

deepfabric-4.9.0/CONTRIBUTING.md

@@ -0,0 +1,256 @@
+## Contributing
+
+Thank you for considering contributing to [deepfabric](https://github.com/always-further/deepfabric)!
+
+When contributing, please first discuss the change you wish to make via [issue](https://github.com/always-further/deepfabric/issues), [email](mailto:hello@alwaysfurther.ai), or any other method with the owners of this repository before making a change.
+
+Note that we have a [Code of Conduct](./CODE_OF_CONDUCT.md), please follow it in all your interactions with the project.
+
+## Setup
+
+### Prerequisites
+
+- **Python 3.10 or later**
+
+## Development
+
+### 1. Fork and clone the repository
+
+Fork this repository and create your branch from `main`.
+
+```sh
+git clone https://github.com/<YOUR-USERNAME>/deepfabric
+cd deepfabric
+```
+
+### 2. Create and activate a virtual environment
+
+We strongly recommend using an isolated virtual environment.
+
+#### Option A: Using `venv` (standard Python)
+
+```sh
+python -m venv .venv
+source .venv/bin/activate
+```
+
+#### Option B: Using [`uv`](https://docs.astral.sh/uv/) (recommended)
+
+DeepFabric supports running all development tasks via [`uv`](https://docs.astral.sh/uv/), which provides fast and reproducible environments without manual virtual environment activation.
+
+### 3. Install the project and development dependencies
+
+DeepFabric uses [PEP 621 (pyproject.toml)](https://peps.python.org/pep-0621/) with [Hatch](https://hatch.pypa.io/latest/) as the build backend.
+
+<details>
+<summary>Option A: Standard Python (`venv` + `pip`)</summary>
+
+```sh
+# Make sure your virtual environment is activated.
+pip install -U pip
+pip install -e '.[dev]'
+```
+</details>
+
+<details>
+<summary>Option B: Using `uv` (recommended)</summary>
+
+```sh
+uv sync --extra dev
+```
+</details>
+
+This installs:
+- test dependencies (`pytest`, `pytest-cov`, etc.)
+- linting and security tools (`ruff`, `bandit`)
+
+### 4. Run the test suite
+
+Ensure all tests pass before submitting changes.
+
+#### Unit tests (required)
+
+At a minimum, please run the unit test suite. Additional integration and security checks are recommended when relevant.
+
+<details>
+<summary>Option A: Standard Python (`venv` + `pip`)</summary>
+
+```sh
+# Make sure your virtual environment is activated.
+pytest tests/unit/
+```
+</details>
+
+<details>
+<summary>Option B: Using `uv` (recommended)</summary>
+
+```sh
+uv run pytest tests/unit/
+```
+</details>
+
+#### Integration tests (optional, but recommended)
+
+Integration tests cover interactions with external systems (e.g. LLM providers). They may require additional environment variables or credentials.
+Please refer to the [Makefile](./Makefile) for available integration test targets.
+
+#### Security checks (optional)
+
+We recommend running security checks before submitting larger or user-facing changes.
+
+<details>
+<summary>Option A: Standard Python (`venv` + `pip`)</summary>
+
+```sh
+# Make sure your virtual environment is activated.
+bandit -r deepfabric/
+```
+</details>
+
+<details>
+<summary>Option B: Using `uv` (recommended)</summary>
+
+```sh
+uv run bandit -r deepfabric/
+```
+</details>
+
+### 5. Lint and format the code
+
+Ensure the codebase is properly linted and formatted before submitting changes.
+
+<details>
+<summary>Option A: Standard Python (`venv` + `pip`)</summary>
+
+```sh
+# Make sure your virtual environment is activated.
+ruff format deepfabric/ tests/
+ruff check . --exclude notebooks/
+```
+</details>
+
+<details>
+<summary>Option B: Using `uv` (recommended)</summary>
+
+```sh
+uv run ruff format deepfabric/ tests/
+uv run ruff check . --exclude notebooks/
+```
+</details>
+
+### 6. Commit your changes
+
+We strongly recommend following the [Conventional Commits specification](https://www.conventionalcommits.org/en/v1.0.0/) when committing:
+
+- **feat:** new features
+- **fix:** bug fixes
+- **docs:** documentation-only changes
+- **refactor:** code refactoring
+- **test:** adding or updating tests
+- **chore:** tooling and maintenance
+
+Example:
+
+```sh
+git commit -m "feat: add dataset validation pipeline"
+```
+
+## Documentation
+
+### 1. Install documentation dependencies
+
+DeepFabric uses [MkDocs](https://www.mkdocs.org/) with the [Material theme](https://squidfunk.github.io/mkdocs-material/) for documentation.
+
+<details>
+<summary>Option A: Standard Python (`venv` + `pip`)</summary>
+
+```sh
+# Make sure your virtual environment is activated.
+pip install -U pip
+pip install -e '.[docs]'
+```
+</details>
+
+<details>
+<summary>Option B: Using `uv` (recommended)</summary>
+
+```sh
+uv sync --extra docs
+```
+</details>
+
+This installs:
+- MkDocs and the Material theme (`mkdocs-material`)
+- Python API documentation support via `mkdocstrings[python]`
+
+### 2. Writing documentation
+
+- User-facing documentation lives in the [docs](./docs) directory.
+- API documentation is generated from [Python docstrings](https://peps.python.org/pep-0257/) via `mkdocstrings`.
+- Please follow the existing style and structure when adding new pages.
+
+### 3. Docstring conventions
+
+DeepFabric enforces [Google-style docstrings](https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings), consistent with the `ruff` configuration:
+
+```toml
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+```
+
+Example:
+
+```python
+def load_dataset(path: str) -> Dataset:
+    """Load a dataset from disk.
+
+    Args:
+        path: Path to the dataset directory.
+
+    Returns:
+        The loaded dataset.
+    """
+    ...
+```
+
+### 4. Serve the documentation locally
+
+Ensure you can preview the documentation site locally before submitting changes.
+
+<details>
+<summary>Option A: Standard Python (`venv` + `pip`)</summary>
+
+```sh
+# Make sure your virtual environment is activated.
+mkdocs serve
+```
+</details>
+
+<details>
+<summary>Option B: Using `uv` (recommended)</summary>
+
+```sh
+uv run mkdocs serve
+```
+</details>
+
+### 5. Build the documentation
+
+Ensure you generate the static documentation site before publishing or submitting changes.
+
+<details>
+<summary>Option A: Standard Python (`venv` + `pip`)</summary>
+
+```sh
+# Make sure your virtual environment is activated.
+mkdocs build
+```
+</details>
+
+<details>
+<summary>Option B: Using `uv` (recommended)</summary>
+
+```sh
+uv run mkdocs build
+```
+</details>

{deepfabric-4.8.2 → deepfabric-4.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DeepFabric
-Version: 4.8.2
+Version: 4.9.0
 Summary: Curate High Quality Datasets, Train, Evaluate and Ship
 Author-email: DeepFabric Team <oss@alwaysfurther.ai>
 License-File: LICENSE
@@ -11,7 +11,7 @@ Requires-Dist: componentize-py>=0.19.3
 Requires-Dist: datasets<5.0,>=3.0
 Requires-Dist: google-api-core>=2.0.0
 Requires-Dist: google-genai>=1.56.0
-Requires-Dist: huggingface-hub==0.36.0
+Requires-Dist: huggingface-hub>=1.3.1
 Requires-Dist: kagglehub>=0.3.0
 Requires-Dist: mermaid-py>=0.8.0
 Requires-Dist: ollama>=0.6.1
@@ -25,7 +25,7 @@ Requires-Dist: pyyaml>=6.0.1
 Requires-Dist: rich>=13.0.0
 Requires-Dist: sentencepiece>=0.1.99
 Requires-Dist: spin-sdk>=3.4.1
-Requires-Dist: transformers>=4.57.1
+Requires-Dist: transformers==5.0.0rc2
 Provides-Extra: dev
 Requires-Dist: bandit>=1.7.10; extra == 'dev'
 Requires-Dist: mermaid-py>=0.2.0; extra == 'dev'

{deepfabric-4.8.2 → deepfabric-4.9.0}/deepfabric/config.py

@@ -109,6 +109,10 @@ class TopicsConfig(BaseModel):
         description="Maximum concurrent LLM calls during graph expansion (helps avoid rate limits)",
     )
     save_as: str | None = Field(default=None, description="Where to save the generated topics")
+    prompt_style: Literal["default", "isolated", "anchored"] = Field(
+        default="default",
+        description="For graph mode: 'default' enables cross-connections with generic prompts, 'isolated' disables connections with generic prompts, 'anchored' disables connections and uses domain-aware prompts with examples for focused topic generation",
+    )
 
     # Optional LLM overrides (inherits from top-level llm if not specified)
     llm: LLMConfig | None = Field(
@@ -603,6 +607,7 @@ See documentation for full examples.
             "depth": self.topics.depth,
             "degree": self.topics.degree,
             "max_concurrent": self.topics.max_concurrent,
+            "prompt_style": self.topics.prompt_style,
         }
 
         # Handle overrides

{deepfabric-4.8.2 → deepfabric-4.9.0}/deepfabric/graph.py

@@ -5,7 +5,7 @@ import textwrap
 import uuid
 
 from datetime import datetime, timezone
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Literal
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -19,7 +19,11 @@ from .constants import (
 from .llm import LLMClient
 from .llm.rate_limit_detector import RateLimitDetector
 from .metrics import trace
-from .prompts import GRAPH_EXPANSION_PROMPT
+from .prompts import (
+    GRAPH_EXPANSION_PROMPT,
+    GRAPH_EXPANSION_PROMPT_NO_CONNECTIONS,
+    GraphPromptBuilder,
+)
 from .schemas import GraphSubtopics
 from .stream_simulator import simulate_stream
 from .topic_model import TopicModel
@@ -70,6 +74,10 @@ class GraphConfig(BaseModel):
         default=None,
         description="Base URL for API endpoint (e.g., custom OpenAI-compatible servers)",
     )
+    prompt_style: Literal["default", "isolated", "anchored"] = Field(
+        default="default",
+        description="Prompt style: 'default' (cross-connections, generic), 'isolated' (no connections, generic), 'anchored' (no connections, domain-aware)",
+    )
 
 
 class GraphMetadata(BaseModel):
@@ -148,6 +156,7 @@ class Graph(TopicModel):
         self.degree = self.config.degree
         self.depth = self.config.depth
         self.max_concurrent = self.config.max_concurrent
+        self.prompt_style = self.config.prompt_style
 
         # Initialize LLM client
         llm_kwargs = {}
@@ -493,6 +502,17 @@ class Graph(TopicModel):
         )
         return None
 
+    def _get_path_to_node(self, node: Node) -> list[str]:
+        """Get the topic path from root to the given node."""
+        path = []
+        current = node
+        while current is not None:
+            path.append(current.topic)
+            # First parent is the primary parent from tree expansion;
+            # cross-connections are added later and appear after index 0
+            current = current.parents[0] if current.parents else None
+        return list(reversed(path))
+
     async def get_subtopics_and_connections(
         self, parent_node: Node, num_subtopics: int
     ) -> tuple[int, int]:
@@ -505,15 +525,35 @@ class Graph(TopicModel):
         Returns:
             A tuple of (subtopics_added, connections_added).
         """
-        graph_summary = (
-            self.to_json()
-            if len(self.nodes) <= TOPIC_GRAPH_SUMMARY
-            else "Graph too large to display"
-        )
-
-        graph_prompt = GRAPH_EXPANSION_PROMPT.replace("{{current_graph_summary}}", graph_summary)
-        graph_prompt = graph_prompt.replace("{{current_topic}}", parent_node.topic)
-        graph_prompt = graph_prompt.replace("{{num_subtopics}}", str(num_subtopics))
+        # Choose prompt based on prompt_style setting
+        if self.prompt_style == "anchored":
+            # Domain-aware prompts with examples for focused generation
+            topic_path = self._get_path_to_node(parent_node)
+            domain = GraphPromptBuilder.detect_domain(self.model_system_prompt, topic_path)
+            graph_prompt = GraphPromptBuilder.build_anchored_prompt(
+                topic_path=topic_path,
+                num_subtopics=num_subtopics,
+                system_prompt=self.model_system_prompt,
+                domain=domain,
+            )
+        elif self.prompt_style == "isolated":
+            # No connections, generic prompt
+            graph_prompt = GRAPH_EXPANSION_PROMPT_NO_CONNECTIONS.replace(
+                "{{current_topic}}", parent_node.topic
+            )
+            graph_prompt = graph_prompt.replace("{{num_subtopics}}", str(num_subtopics))
+        else:
+            # default: cross-connections enabled, generic prompt
+            graph_summary = (
+                self.to_json()
+                if len(self.nodes) <= TOPIC_GRAPH_SUMMARY
+                else "Graph too large to display"
+            )
+            graph_prompt = GRAPH_EXPANSION_PROMPT.replace(
+                "{{current_graph_summary}}", graph_summary
+            )
+            graph_prompt = graph_prompt.replace("{{current_topic}}", parent_node.topic)
+            graph_prompt = graph_prompt.replace("{{num_subtopics}}", str(num_subtopics))
 
         response = await self._generate_subtopics_with_retry(graph_prompt, parent_node)
         if response is None:

{deepfabric-4.8.2 → deepfabric-4.9.0}/deepfabric/metrics.py

@@ -19,8 +19,8 @@ except (ImportError, importlib.metadata.PackageNotFoundError):
 
 # Initialize PostHog client
 posthog = Posthog(
-    project_api_key="phc_Kn8hKQIXHm5OHp5OTxvMvFDUmT7HyOUNlJvWkduB9qO",
-    host="https://us.i.posthog.com",
+    project_api_key="phc_JZWiTzIDNnBp6Jj6uUb0JQKuIp3dv0gkay9aU50n38h",
+    host="https://eu.i.posthog.com",
 )
 
 logger = logging.getLogger(__name__)

{deepfabric-4.8.2 → deepfabric-4.9.0}/deepfabric/prompts.py

@@ -264,6 +264,142 @@ Generate a list of {{num_subtopics}} subtopics. For each subtopic, provide:
 2. A "connections" list of IDs of existing topics it should connect to for creating cross-links (use empty list if no connections)
 """
 
+GRAPH_EXPANSION_PROMPT_NO_CONNECTIONS = """
+You are an expert in topic generation. Your task is to expand a topic into a set of focused subtopics.
+
+You are expanding the topic: "{{current_topic}}"
+
+Generate a list of {{num_subtopics}} subtopics. For each subtopic, provide:
+1. A "topic" string - the name of the new subtopic
+2. A "connections" list - ALWAYS use an empty list []
+
+IMPORTANT: Do NOT create cross-connections between topics. Each subtopic should be independent and directly related only to its parent topic. Always return connections as an empty list [].
+"""
+
+
+class GraphPromptBuilder:
+    """Build domain-aware prompts for graph topic expansion with anchoring examples."""
+
+    MAX_PROMPT_EXAMPLES = 3
+
+    SECURITY_KEYWORDS = frozenset(
+        {
+            "security",
+            "attack",
+            "credential",
+            "exfiltration",
+            "injection",
+            "malicious",
+            "adversarial",
+            "threat",
+        }
+    )
+
+    # Domain-specific expansion examples - formatted to match GraphSubtopics schema
+    EXAMPLES = {
+        "security": [
+            {
+                "path": ["Security Threats", "Credential Access"],
+                "subtopics": [
+                    {"topic": "reading .env files", "connections": []},
+                    {"topic": "extracting API keys", "connections": []},
+                    {"topic": "accessing SSH keys", "connections": []},
+                    {"topic": "dumping AWS credentials", "connections": []},
+                    {"topic": "stealing database passwords", "connections": []},
+                ],
+            },
+            {
+                "path": ["Security Threats", "Data Exfiltration"],
+                "subtopics": [
+                    {"topic": "sending to webhooks", "connections": []},
+                    {"topic": "encoding in base64", "connections": []},
+                    {"topic": "uploading to external URLs", "connections": []},
+                    {"topic": "email forwarding", "connections": []},
+                    {"topic": "DNS tunneling", "connections": []},
+                ],
+            },
+        ],
+        "technical": [
+            {
+                "path": ["Programming", "Python"],
+                "subtopics": [
+                    {"topic": "pandas", "connections": []},
+                    {"topic": "flask", "connections": []},
+                    {"topic": "pytest", "connections": []},
+                    {"topic": "asyncio", "connections": []},
+                    {"topic": "django", "connections": []},
+                ],
+            },
+            {
+                "path": ["Infrastructure", "Kubernetes"],
+                "subtopics": [
+                    {"topic": "pods", "connections": []},
+                    {"topic": "deployments", "connections": []},
+                    {"topic": "services", "connections": []},
+                    {"topic": "ingress", "connections": []},
+                    {"topic": "helm charts", "connections": []},
+                ],
+            },
+        ],
+    }
+
+    @classmethod
+    def build_anchored_prompt(
+        cls,
+        topic_path: list[str],
+        num_subtopics: int,
+        system_prompt: str = "",
+        domain: str = "technical",
+    ) -> str:
+        """Build a domain-anchored prompt for graph expansion.
+
+        Returns a prompt that produces focused, on-topic subtopics by providing
+        domain-specific examples and the full topic path context.
+        """
+        path_str = " -> ".join(f'"{topic}"' for topic in topic_path)
+        examples = cls._format_examples(cls.EXAMPLES.get(domain, cls.EXAMPLES["technical"]))
+
+        return f"""Generate {num_subtopics} subtopics for training data organization.
+
+Task: Create diverse but related subtopics that expand on the given topic path.
+
+Examples:
+{examples}
+
+Context: {system_prompt}
+
+Topic path: {path_str}
+
+Generate {num_subtopics} subtopics. For each subtopic, provide:
+1. A "topic" string - a specific, concrete subtopic directly related to the parent
+2. A "connections" list - ALWAYS use an empty list []
+
+Return focused subtopics that stay on-topic with the path above."""
+
+    @classmethod
+    def _format_examples(cls, examples: list) -> str:
+        """Format examples for inclusion in prompt."""
+        formatted = []
+        for ex in examples[: cls.MAX_PROMPT_EXAMPLES]:
+            path_str = " -> ".join(f'"{topic}"' for topic in ex["path"])
+            subtopics_str = str(ex["subtopics"])
+            formatted.append(f"Path: {path_str}\nSubtopics: {subtopics_str}")
+        return "\n\n".join(formatted)
+
+    @classmethod
+    def detect_domain(cls, system_prompt: str, topic_path: list[str]) -> str:
+        """Detect the appropriate domain for prompt examples based on context.
+
+        Returns 'security' or 'technical' based on keywords in the system prompt
+        and topic path. Defaults to 'technical' if no security keywords found.
+        """
+        combined_text = f"{system_prompt} {' '.join(topic_path)}".lower()
+
+        if any(word in combined_text for word in cls.SECURITY_KEYWORDS):
+            return "security"
+        return "technical"
+
+
 # Chain of Thought prompts for reasoning-based dataset generation
 FREETEXT_COT_PROMPT = """Generate a reasoning problem that requires analytical thinking to solve.
 

{deepfabric-4.8.2 → deepfabric-4.9.0}/deepfabric/schemas.py

@@ -136,7 +136,9 @@ class MCPInputSchemaProperty(BaseModel):
 
     model_config = {"extra": "allow"}
 
-    type: str | list[str] = Field(default="string", description="JSON Schema type (string or array for nullable)")
+    type: str | list[str] = Field(
+        default="string", description="JSON Schema type (string or array for nullable)"
+    )
     description: str = Field(default="", description="Property description")
     default: Any | None = Field(default=None, description="Default value")