feat: refactored the kernel

Author: jhkwapisz

.check_core_imports.yaml

@@ -11,10 +11,14 @@ check_directory: hexdag/kernel
 
 # Forbidden import patterns (regex)
 forbidden_patterns:
+  - '^from\s+hexdag\.api'
   - '^from\s+hexdag\.drivers'
   - '^from\s+hexdag\.stdlib'
+  - '^from\s+hexdag\.cli'
+  - '^import\s+hexdag\.api'
   - '^import\s+hexdag\.drivers'
   - '^import\s+hexdag\.stdlib'
+  - '^import\s+hexdag\.cli'
   # Legacy paths (catch any leftovers from pre-rename)
   - '^from\s+hexdag\.adapters'
   - '^from\s+hexdag\.builtin'
@@ -46,12 +50,6 @@ allowed_exceptions:
   hexdag/kernel/orchestration/components/execution_coordinator.py:
     - "from hexdag.stdlib.nodes.mapped_input import FieldExtractor"
 
-  # Prompt __init__ re-exports advanced prompts for backward compatibility
-  # These were moved to stdlib but are still part of kernel API surface.
-  # Rationale: Maintains public API while allowing modular organization.
-  hexdag/kernel/orchestration/prompt/__init__.py:
-    - "from hexdag.stdlib.prompts.base import ("
-
   # Models.py has doctest examples that import adapters for demonstration
   # These are documentation/test imports, not runtime dependencies.
   # Rationale: Doctests need concrete examples to be runnable.
@@ -60,6 +58,12 @@ allowed_exceptions:
     - "from hexdag.stdlib.adapters.openai import OpenAIAdapter"
     - "from hexdag.stdlib.adapters.anthropic import AnthropicAdapter"
 
+  # lib_base.py is a backward-compat re-export shim.
+  # The canonical location is hexdag.stdlib.lib_base.
+  # Rationale: Maintains import compatibility while lib contract lives in stdlib.
+  hexdag/kernel/lib_base.py:
+    - "from hexdag.stdlib.lib_base import HexDAGLib, get_lib_tool_schemas  # noqa: F401"
+
   # Resolver imports stdlib.nodes to trigger auto-discovery and alias registration
   # Also imports adapter/macro discovery for the unified alias system.
   # These are lazy imports inside _ensure_builtin_bootstrapped(), not module-level dependencies.

docs/generated/mcp/node_guide.md

@@ -180,8 +180,8 @@ Multi-step reasoning agent.
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `name` | `str` | Yes | Agent name |
-| `main_prompt` | `str | hexdag.kernel.orchestration.prompt.template.PromptTemplate | hexdag.stdlib.prompts.base.ChatPromptTemplate | hexdag.stdlib.prompts.base.ChatFewShotTemplate | hexdag.stdlib.prompts.base.FewShotPromptTemplate` | Yes | Initial reasoning prompt |
-| `continuation_prompts` | `dict[str, str | hexdag.kernel.orchestration.prompt.template.PromptTemplate | hexdag.stdlib.prompts.base.ChatPromptTemplate | hexdag.stdlib.prompts.base.ChatFewShotTemplate | hexdag.stdlib.prompts.base.FewShotPromptTemplate] | None` | No | Phase-specific prompts |
+| `main_prompt` | `str | hexdag.kernel.orchestration.prompt.template.PromptTemplate | hexdag.kernel.orchestration.prompt.template.ChatPromptTemplate | hexdag.kernel.orchestration.prompt.template.ChatFewShotTemplate | hexdag.kernel.orchestration.prompt.template.FewShotPromptTemplate` | Yes | Initial reasoning prompt |
+| `continuation_prompts` | `dict[str, str | hexdag.kernel.orchestration.prompt.template.PromptTemplate | hexdag.kernel.orchestration.prompt.template.ChatPromptTemplate | hexdag.kernel.orchestration.prompt.template.ChatFewShotTemplate | hexdag.kernel.orchestration.prompt.template.FewShotPromptTemplate] | None` | No | Phase-specific prompts |
 | `output_schema` | `dict[str, type] | type[pydantic.main.BaseModel] | None` | No | Custom output schema for tool_end results |
 | `config` | `hexdag.stdlib.nodes.agent_node.AgentConfig | None` | No | Agent configuration |
 | `deps` | `list[str] | None` | No | Dependencies |

hexdag/api/components.py

@@ -15,6 +15,7 @@
 from typing import Any
 
 from hexdag.kernel.pipeline_builder.tag_discovery import discover_tags, get_tag_schema
+from hexdag.kernel.ports.detection import detect_port_type as detect_port_type
 from hexdag.kernel.resolver import get_builtin_aliases, resolve
 from hexdag.kernel.schema import SchemaGenerator
 
@@ -266,89 +267,6 @@ def list_adapters(port_type: str | None = None) -> list[dict[str, Any]]:
     return sorted(unique_adapters, key=lambda x: (x["port_type"], x["name"]))
 
 
-def detect_port_type(adapter_class: type) -> str:
-    """Detect port type from adapter class using protocol inspection.
-
-    Adapters MUST inherit from their port protocol to be properly detected.
-    This is a convention enforced by hexDAG - no name-based guessing.
-
-    Port Protocol Convention
-    ------------------------
-    All adapters must inherit from their corresponding port protocol:
-
-    - LLM adapters: inherit from `LLM`, `SupportsGeneration`, `SupportsFunctionCalling`, etc.
-    - Memory adapters: inherit from `Memory`
-    - Database adapters: inherit from `Database` or `SQLAdapter`
-    - Secret adapters: inherit from `SecretStore`
-    - Storage adapters: inherit from `FileStorage` or `VectorStorePort`
-    - Tool adapters: inherit from `ToolRouter`
-
-    Example::
-
-        from hexdag.kernel.ports.llm import LLM
-
-        class MyCustomLLMAdapter(LLM):
-            async def aresponse(self, messages):
-                ...
-
-    Parameters
-    ----------
-    adapter_class : type
-        The adapter class to inspect
-
-    Returns
-    -------
-    str
-        Port type: "llm", "memory", "database", "secret", "storage", "tool_router", or "unknown"
-
-    Examples
-    --------
-    >>> from hexdag.stdlib.adapters.openai import OpenAIAdapter
-    >>> detect_port_type(OpenAIAdapter)
-    'llm'
-    """
-    # Check explicit decorator metadata first (future @adapter decorator)
-    explicit_port = getattr(adapter_class, "_hexdag_implements_port", None)
-    if explicit_port:
-        return str(explicit_port)
-
-    # Check protocol inheritance (required convention)
-    mro_names = [c.__name__ for c in adapter_class.__mro__]
-
-    # LLM adapters implement LLM, SupportsGeneration, SupportsFunctionCalling, etc.
-    llm_protocols = {"LLM", "SupportsGeneration", "SupportsFunctionCalling", "SupportsVision"}
-    if any(name in mro_names for name in llm_protocols):
-        return "llm"
-
-    # Memory adapters implement Memory protocol
-    if "Memory" in mro_names:
-        return "memory"
-
-    # Database adapters implement Database or SQLAdapter
-    if "Database" in mro_names or "DatabasePort" in mro_names or "SQLAdapter" in mro_names:
-        return "database"
-
-    # Secret adapters implement SecretStore
-    if "SecretStore" in mro_names or "SecretPort" in mro_names:
-        return "secret"
-
-    # Storage adapters implement FileStorage or VectorStorePort
-    storage_ports = ("FileStorage", "FileStoragePort", "VectorStorePort")
-    if any(name in mro_names for name in storage_ports):
-        return "storage"
-
-    # DataStore adapters implement DataStore
-    if "DataStore" in mro_names:
-        return "data_store"
-
-    # Tool router adapters implement ToolRouter
-    if "ToolRouter" in mro_names:
-        return "tool_router"
-
-    # No fallback - adapters must follow the convention
-    return "unknown"
-
-
 def _discover_entities(
     discover_fn: Any,
     builtin_modules: list[str],

hexdag/drivers/http_client/__init__.py

@@ -0,0 +1,5 @@
+"""HTTP client driver for the APICall port."""
+
+from hexdag.drivers.http_client.http_client import HttpClientDriver
+
+__all__ = ["HttpClientDriver"]