krons 0.2.2__py3-none-any.whl → 0.2.4__py3-none-any.whl

krons/agent/message/common.py

@@ -2,7 +2,7 @@ from typing import Any, Protocol, runtime_checkable
 
 from pydantic import BaseModel
 
-from krons.core.types import Enum, MaybeUnset, Unset
+from krons.core.types import Enum
 
 
 @runtime_checkable

krons/agent/message/prepare_msg.py

@@ -1,8 +1,7 @@
 # Copyright (c) 2025 - 2026, HaiyangLi <quantocean.li at gmail dot com>
 # SPDX-License-Identifier: Apache-2.0
 
-from collections.abc import Callable
-from typing import TYPE_CHECKING, Any, Literal, cast
+from typing import Any, cast
 
 from pydantic import JsonValue
 

krons/core/base/__init__.py

@@ -26,8 +26,6 @@ _LAZY_IMPORTS: dict[str, tuple[str, str]] = {
     "Edge": ("krons.core.base.graph", "Edge"),
     "EdgeCondition": ("krons.core.base.graph", "EdgeCondition"),
     "Graph": ("krons.core.base.graph", "Graph"),
-    # log
-    "DataLoggerConfig": ("krons.core.base.log", "DataLoggerConfig"),
     # node
     "NODE_REGISTRY": ("krons.core.base.node", "NODE_REGISTRY"),
     "PERSISTABLE_NODE_REGISTRY": ("krons.core.base.node", "PERSISTABLE_NODE_REGISTRY"),
@@ -79,7 +77,6 @@ if TYPE_CHECKING:
     from .eventbus import EventBus, Handler
     from .flow import Flow
     from .graph import Edge, EdgeCondition, Graph
-    from .log import DataLoggerConfig
     from .node import (
         NODE_REGISTRY,
         PERSISTABLE_NODE_REGISTRY,
@@ -100,7 +97,6 @@ __all__ = [
     "PERSISTABLE_NODE_REGISTRY",
     # classes
     "Broadcaster",
-    "DataLoggerConfig",
     "Edge",
     "EdgeCondition",
     "Element",

krons/core/base/flow.py

@@ -321,6 +321,13 @@ class Flow(Element, Generic[E, P]):
 
         return self.items.remove(uid)
 
+    @synchronized
+    def clear(self) -> None:
+        """Clear all items and progressions."""
+        self.items.clear()
+        self.progressions.clear()
+        self._progression_names.clear()
+
     def __repr__(self) -> str:
         name_str = f", name='{self.name}'" if self.name else ""
         return f"Flow(items={len(self.items)}, progressions={len(self.progressions)}{name_str})"

krons/core/base/node.py

@@ -745,9 +745,12 @@ def create_node(
         has_embedding = True
 
     # 1. Build all possible specs
+    # Extract meta_key from config_kwargs if provided, else use default
+    meta_key = config_kwargs.get("meta_key", "node_metadata")
     all_specs = ContentSpecs.get_specs(
         content_type=content if content else Unset,
         dim=resolved_embedding_dim,
+        meta_key=meta_key,
     ) + AuditSpecs.get_specs(use_uuid=True)
 
     # 2. Track which fields to include
@@ -837,19 +840,17 @@ def _extract_base_type(annotation: Any) -> Any:
     return annotation
 
 
-def generate_ddl(
-    node_cls: type[Node],
-    *,
-    include_audit_columns: bool = True,
-) -> str:
+def generate_ddl(node_cls: type[Node]) -> str:
     """Generate CREATE TABLE DDL from Node subclass.
 
     Flattens content fields (if configured), adds audit columns, and
     generates PostgreSQL DDL with pgvector support for embeddings.
 
+    Audit column inclusion is driven by NodeConfig settings (track_updated_at,
+    soft_delete, versioning, etc.).
+
     Args:
         node_cls: Persistable Node subclass (must have table_name)
-        include_audit_columns: Include audit columns from NodeConfig
 
     Returns:
         CREATE TABLE IF NOT EXISTS statement
@@ -875,7 +876,8 @@ def generate_ddl(
     )
 
     all_specs = ContentSpecs.get_specs(
-        dim=config.embedding_dim if config.embedding_enabled else Unset
+        dim=config.embedding_dim if config.embedding_enabled else Unset,
+        meta_key=config.meta_key,
     ) + AuditSpecs.get_specs(use_uuid=True)
 
     # Flatten content: extract fields from BaseModel instead of generic JSONB
@@ -900,25 +902,24 @@ def generate_ddl(
     ):
         include.add("content")
 
-    include.add("metadata")
-
-    if include_audit_columns:
-        if config.track_updated_at:
-            include.add("updated_at")
-        if config.track_updated_by:
-            include.add("updated_by")
-        if config.track_is_active:
-            include.add("is_active")
-        if config.soft_delete:
-            include.update({"is_deleted", "deleted_at"})
-            if config.track_deleted_by:
-                include.add("deleted_by")
-        if config.versioning:
-            include.add("version")
-        if config.content_hashing:
-            include.add("content_hash")
-        if config.integrity_hashing:
-            include.add("integrity_hash")
+    if not config.is_sentinel_field("meta_key") and config.meta_key != "metadata":
+        include.add(config.meta_key)
+
+    audit_cols = {
+        "updated_at": config.track_updated_at,
+        "updated_by": config.track_updated_by,
+        "is_active": config.track_is_active,
+        "is_deleted": config.soft_delete,
+        "deleted_at": config.soft_delete,
+        "deleted_by": config.soft_delete and config.track_deleted_by,
+        "version": config.versioning,
+        "content_hash": config.content_hashing,
+        "integrity_hash": config.integrity_hashing,
+    }
+
+    for col, enabled in audit_cols.items():
+        if enabled:
+            include.add(col)
 
     # If flattened, include the extracted content field names
     if config.flatten_content and content_type is not None:

krons/core/specs/adapters/_utils.py

@@ -2,10 +2,52 @@ from __future__ import annotations
 
 import types
 from functools import reduce
-from typing import Any, Union, get_args, get_origin
+from typing import Annotated, Any, ForwardRef, Union, get_args, get_origin
+from uuid import UUID
+
+
+def _resolve_forward_ref(fwd: ForwardRef) -> dict[str, Any]:
+    """Handle ForwardRef annotations (from 'from __future__ import annotations').
+
+    Parses the string representation to extract type info for DDL generation.
+    FK[Model] -> Annotated[UUID, FKMeta(model_name)], Vector[dim] -> list[float], etc.
+
+    Uses parse_forward_ref from db_types as canonical parser.
+    """
+    from krons.core.types.db_types import parse_forward_ref
+
+    fk, vec, nullable = parse_forward_ref(fwd)
+
+    # FK[Model] -> Annotated[UUID, FKMeta]
+    if fk is not None:
+        base_type = Annotated[UUID, fk]
+        return {"base_type": base_type, "nullable": nullable, "listable": False}
+
+    # Vector[dim] -> Annotated[list[float], VectorMeta]
+    if vec is not None:
+        base_type = Annotated[list[float], vec]
+        return {"base_type": base_type, "nullable": nullable, "listable": False}
+
+    # Default: treat as generic type (will map to TEXT in SQL)
+    return {"base_type": str, "nullable": nullable, "listable": False}
 
 
 def resolve_annotation_to_base_types(annotation: Any) -> dict[str, Any]:
+    """Resolve an annotation to its base types, detecting nullable and listable.
+
+    Args:
+        annotation: Type annotation to resolve (may include Optional, list, etc.)
+
+    Returns:
+        Dict with keys:
+            - base_type: The innermost type
+            - nullable: Whether None is allowed
+            - listable: Whether it's a list type
+    """
+    # Handle ForwardRef (from 'from __future__ import annotations')
+    if isinstance(annotation, ForwardRef):
+        return _resolve_forward_ref(annotation)
+
     def resolve_nullable_inner_type(_anno: Any) -> tuple[bool, Any]:
         origin = get_origin(_anno)
 

krons/core/specs/catalog/_content.py

@@ -33,12 +33,14 @@ class ContentSpecs(BaseModel):
         *,
         content_type: type | UnsetType = Unset,
         dim: int | UnsetType = Unset,
+        meta_key: str | UnsetType = Unset,
     ) -> list[Spec]:
         """Get list of content Specs.
 
         Args:
             content_type: Type for content/metadata fields (default: dict).
             dim: Embedding dimension. Unset = list[float], int = Vector[dim].
+            meta_key: DB alias for metadata field (e.g., "node_metadata").
         """
         operable = Operable.from_structure(cls)
         specs = {spec.name: spec for spec in operable.get_specs()}
@@ -48,6 +50,10 @@ class ContentSpecs(BaseModel):
             specs["content"] = Spec(content_type, name="content").as_nullable()
             specs["metadata"] = Spec(content_type, name="metadata").as_nullable()
 
+        # Add meta_key alias if specified (DB mode uses this to avoid SQL reserved word)
+        if meta_key is not Unset and isinstance(meta_key, str):
+            specs[meta_key] = Spec(dict[str, Any], name=meta_key).as_nullable()
+
         # Override embedding with vector dimension if specified
         if dim is not Unset and isinstance(dim, int):
             specs["embedding"] = Spec(

krons/core/types/db_types.py

@@ -14,8 +14,9 @@ Extraction:
 
 from __future__ import annotations
 
+import re
 import types
-from typing import Annotated, Any, Literal, Union, get_args, get_origin
+from typing import Annotated, Any, ForwardRef, Literal, Union, get_args, get_origin
 from uuid import UUID
 
 from krons.core.types._sentinel import Unset, UnsetType, not_sentinel
@@ -32,6 +33,7 @@ __all__ = [
     "Vector",
     "VectorMeta",
     "extract_kron_db_meta",
+    "parse_forward_ref",
 ]
 
 
@@ -200,6 +202,88 @@ def _find_in_field_info(field_info: Any, meta_type: type) -> Any | None:
     return None
 
 
+def _is_spec_like(obj: Any) -> bool:
+    """Check if object looks like a Spec (duck typing to avoid hard import)."""
+    return (
+        hasattr(obj, "get")
+        and hasattr(obj, "__class__")
+        and "Spec" in type(obj).__name__
+    )
+
+
+def _detect_nullable(arg: str) -> bool:
+    """Detect nullability from annotation string.
+
+    Handles:
+        - X | None, None | X (PEP 604 union)
+        - Optional[X] (typing.Optional)
+        - Union[X, None], Union[None, X] (typing.Union with nested types)
+    """
+    # PEP 604 style: X | None or None | X
+    if re.search(r"\|\s*None\b", arg) or re.search(r"\bNone\s*\|", arg):
+        return True
+    # Optional[X]
+    if re.search(r"\bOptional\s*\[", arg):
+        return True
+    # Union[..., None, ...] - if Union is present and None is anywhere in string
+    # This handles nested types like Union[FK[User], None]
+    if re.search(r"\bUnion\s*\[", arg) and re.search(r"\bNone\b", arg):
+        return True
+    return False
+
+
+def parse_forward_ref(
+    fwd: ForwardRef,
+) -> tuple[FKMeta | None, VectorMeta | None, bool]:
+    """Parse FK/Vector metadata and nullability from a ForwardRef string.
+
+    Canonical parser for ForwardRef annotations from 'from __future__ import annotations'.
+
+    Handles:
+        - FK[Model], FK["Model"], FK['Model'] (bare and string refs)
+        - Vector[1536] (dimension as int literal)
+        - Nullability: X | None, Optional[X], Union[X, None]
+
+    Args:
+        fwd: ForwardRef to parse
+
+    Returns:
+        Tuple of (fk_meta, vector_meta, is_nullable)
+        - fk_meta: FKMeta if FK[...] found, else None
+        - vector_meta: VectorMeta if Vector[dim] found, else None
+        - is_nullable: True if nullable pattern detected
+    """
+    arg = fwd.__forward_arg__
+    fk: FKMeta | None = None
+    vec: VectorMeta | None = None
+    nullable = _detect_nullable(arg)
+
+    # Match FK[ModelName] or FK["ModelName"] or FK['ModelName']
+    fk_match = re.search(r"FK\[(['\"]?)(\w+)\1\]", arg)
+    if fk_match:
+        model_name = fk_match.group(2)
+        fk = FKMeta(model_name)
+
+    # Match Vector[dim]
+    vec_match = re.search(r"Vector\[(\d+)\]", arg)
+    if vec_match:
+        dim = int(vec_match.group(1))
+        vec = VectorMeta(dim)
+
+    return fk, vec, nullable
+
+
+def _extract_from_forward_ref(
+    fwd: ForwardRef,
+) -> tuple[FKMeta | UnsetType, VectorMeta | UnsetType]:
+    """Extract FK/Vector metadata from a ForwardRef (returns Unset for missing).
+
+    Wrapper around parse_forward_ref for extract_kron_db_meta compatibility.
+    """
+    fk, vec, _ = parse_forward_ref(fwd)
+    return (fk if fk is not None else Unset, vec if vec is not None else Unset)
+
+
 def extract_kron_db_meta(
     from_: Any,
     metas: Literal["FK", "Vector", "BOTH"] = "BOTH",
@@ -209,7 +293,7 @@ def extract_kron_db_meta(
     Unified extraction dispatching on source type:
     - FieldInfo: searches Pydantic metadata and annotation
     - type/annotation: searches Annotated/Union structure
-    - Spec: reads spec metadata directly
+    - Spec: reads spec metadata directly (if available)
 
     Args:
         from_: FieldInfo, type annotation, or Spec instance
@@ -228,6 +312,10 @@ def extract_kron_db_meta(
         if metas in ("Vector", "BOTH"):
             vec = _find_in_field_info(from_, VectorMeta) or Unset
 
+    elif isinstance(from_, ForwardRef):
+        # Handle ForwardRef from 'from __future__ import annotations'
+        fk, vec = _extract_from_forward_ref(from_)
+
     elif get_origin(from_) is not None or isinstance(from_, type):
         # Raw type annotation
         if metas in ("FK", "BOTH"):
@@ -235,23 +323,20 @@ def extract_kron_db_meta(
         if metas in ("Vector", "BOTH"):
             vec = _find_in_annotation(from_, VectorMeta) or Unset
 
+    elif _is_spec_like(from_):
+        # Spec-like object (duck typed to avoid circular imports)
+        if metas in ("FK", "BOTH"):
+            fk_val = from_.get("as_fk", Unset)
+            if not_sentinel(fk_val, {"none"}) and isinstance(fk_val, FKMeta):
+                fk = fk_val
+        if metas in ("Vector", "BOTH"):
+            vec_val = from_.get("embedding", Unset)
+            if not_sentinel(vec_val, {"none"}) and isinstance(vec_val, VectorMeta):
+                vec = vec_val
     else:
-        # Try Spec (lazy import to avoid circular)
-        from krons.core.specs.spec import Spec
-
-        if isinstance(from_, Spec):
-            if metas in ("FK", "BOTH"):
-                fk_val = from_.get("as_fk", Unset)
-                if not_sentinel(fk_val, {"none"}) and isinstance(fk_val, FKMeta):
-                    fk = fk_val
-            if metas in ("Vector", "BOTH"):
-                vec_val = from_.get("embedding", Unset)
-                if not_sentinel(vec_val, {"none"}) and isinstance(vec_val, VectorMeta):
-                    vec = vec_val
-        else:
-            raise TypeError(
-                f"from_ must be FieldInfo, type annotation, or Spec, got {type(from_).__name__}"
-            )
+        raise TypeError(
+            f"from_ must be FieldInfo, type annotation, or Spec, got {type(from_).__name__}"
+        )
 
     if metas == "FK":
         return fk

krons/session/session.py

@@ -14,11 +14,9 @@ import contextlib
 from collections.abc import AsyncGenerator, Iterable
 from pathlib import Path
 from typing import Any, Literal
-
-from krons.core.base.log import DataLoggerConfig
 from uuid import UUID
 
-from pydantic import Field, PrivateAttr, model_validator
+from pydantic import Field, PrivateAttr, field_serializer, model_validator
 
 from krons.core import Element, Flow, Pile, Progression
 from krons.core.types import HashableModel, Unset, UnsetType, not_sentinel
@@ -63,25 +61,43 @@ class SessionConfig(HashableModel):
     default_gen_model: str | None = None
     default_parse_model: str | None = None
     auto_create_default_branch: bool = True
-    log_config: DataLoggerConfig | None = Field(
+
+    # Logging configuration
+    log_persist_dir: str | Path | None = Field(
         default=None,
-        description="DataLoggerConfig for auto-logging (None = disabled)",
+        description="Directory for session dumps. None disables logging.",
+    )
+    log_auto_save_on_exit: bool = Field(
+        default=True,
+        description="Register atexit handler on Session creation.",
     )
 
+    @property
+    def logging_enabled(self) -> bool:
+        """True if logging is configured (log_persist_dir is set)."""
+        return self.log_persist_dir is not None
+
 
 class Session(Element):
     user: str | None = None
     communications: Flow[Message, Branch] = Field(
         default_factory=lambda: Flow(item_type=Message)
     )
-    resources: ResourceRegistry = Field(default_factory=ResourceRegistry)
-    operations: OperationRegistry = Field(default_factory=OperationRegistry)
+    resources: ResourceRegistry = Field(default_factory=ResourceRegistry, exclude=True)
+    operations: OperationRegistry = Field(
+        default_factory=OperationRegistry, exclude=True
+    )
     config: SessionConfig = Field(default_factory=SessionConfig)
     default_branch_id: UUID | None = None
 
     _registered_atexit: bool = PrivateAttr(default=False)
     _dump_count: int = PrivateAttr(default=0)
 
+    @field_serializer("communications")
+    def _serialize_communications(self, flow: Flow) -> dict:
+        """Use Flow's custom to_dict for proper nested serialization."""
+        return flow.to_dict(mode="json")
+
     @model_validator(mode="after")
     def _validate_default_branch(self) -> Session:
         """Auto-create default branch and register built-in operations."""
@@ -96,8 +112,8 @@ class Session(Element):
 
         # Register atexit handler if configured
         if (
-            self.config.log_config is not None
-            and self.config.log_config.auto_save_on_exit
+            self.config.logging_enabled
+            and self.config.log_auto_save_on_exit
             and not self._registered_atexit
         ):
             atexit.register(self._save_at_exit)
@@ -406,96 +422,87 @@ class Session(Element):
         async for result in handler(params, ctx):
             yield result
 
-    def dump_messages(self, clear: bool = False) -> Path | None:
-        """Sync dump all session messages to file.
+    def dump(self, clear: bool = False) -> Path | None:
+        """Sync dump entire session state for replay.
+
+        Serializes session (messages, branches, config) to JSON.
+        Resources and operations are excluded (re-register on restore).
+        To restore: Session.from_dict(data), then re-register resources.
 
         Args:
-            clear: Clear messages after dump (default False).
+            clear: Clear communications after dump (default False).
 
         Returns:
-            Path to written file, or None if no log_config or no messages.
+            Path to session file, or None if logging disabled or empty.
         """
-        from krons.utils import create_path, json_dumpb, json_lines_iter
+        from krons.utils import create_path, json_dumpb
         from krons.utils.concurrency import run_async
 
-        if self.config.log_config is None or len(self.messages) == 0:
+        if not self.config.logging_enabled or len(self.messages) == 0:
             return None
 
-        cfg = self.config.log_config
         self._dump_count += 1
 
         filepath = run_async(
             create_path(
-                directory=cfg.persist_dir,
+                directory=self.config.log_persist_dir,
                 filename=f"session_{str(self.id)[:8]}_{self._dump_count}",
-                extension=cfg.extension,
+                extension=".json",
                 timestamp=True,
                 file_exist_ok=True,
             )
         )
 
-        items = [msg.to_dict(mode="json") for msg in self.messages]
-
+        data = json_dumpb(self.to_dict(mode="json"), safe_fallback=True)
         std_path = Path(filepath)
-        if cfg.extension == ".jsonl":
-            with std_path.open("wb") as f:
-                for chunk in json_lines_iter(items, safe_fallback=True):
-                    f.write(chunk)
-        else:
-            data = json_dumpb(items, safe_fallback=True)
-            std_path.write_bytes(data)
+        std_path.write_bytes(data)
 
         if clear:
-            self.communications.items.clear()
+            self.communications.clear()
 
         return std_path
 
-    async def adump_messages(self, clear: bool = False) -> Path | None:
-        """Async dump all session messages to file with lock protection.
+    async def adump(self, clear: bool = False) -> Path | None:
+        """Async dump entire session state for replay.
+
+        Serializes the full session (messages, branches, config) to JSON.
+        To restore: Session.from_dict(data), then re-register resources.
 
         Args:
-            clear: Clear messages after dump (default False).
+            clear: Clear communications after dump (default False).
 
         Returns:
-            Path to written file, or None if no log_config or no messages.
+            Path to session file, or None if logging disabled or empty.
         """
-        from krons.utils import create_path, json_dumpb, json_lines_iter
+        from krons.utils import create_path, json_dumpb
 
-        if self.config.log_config is None or len(self.messages) == 0:
+        if not self.config.logging_enabled or len(self.messages) == 0:
             return None
 
-        cfg = self.config.log_config
-
         async with self.messages:
             self._dump_count += 1
 
             filepath = await create_path(
-                directory=cfg.persist_dir,
+                directory=self.config.log_persist_dir,
                 filename=f"session_{str(self.id)[:8]}_{self._dump_count}",
-                extension=cfg.extension,
+                extension=".json",
                 timestamp=True,
                 file_exist_ok=True,
             )
 
-            items = [msg.to_dict(mode="json") for msg in self.messages]
-
-            if cfg.extension == ".jsonl":
-                content = b"".join(json_lines_iter(items, safe_fallback=True))
-                await filepath.write_bytes(content)
-            else:
-                data = json_dumpb(items, safe_fallback=True)
-                await filepath.write_bytes(data)
+            data = json_dumpb(self.to_dict(mode="json"), safe_fallback=True)
+            await filepath.write_bytes(data)
 
             if clear:
-                self.communications.items.clear()
+                self.communications.clear()
 
         return Path(filepath)
 
     def _save_at_exit(self) -> None:
-        """atexit callback. Dumps messages synchronously. Errors are suppressed."""
+        """atexit callback. Dumps session synchronously. Errors are suppressed."""
         if len(self.messages) > 0:
             try:
-                self.dump_messages(clear=False)
+                self.dump(clear=False)
             except Exception:
                 pass  # Silent failure during interpreter shutdown
 

{krons-0.2.2.dist-info → krons-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: krons
-Version: 0.2.2
+Version: 0.2.4
 Summary: Spec-based composable framework for building type-safe systems
 Project-URL: Homepage, https://github.com/khive-ai/krons
 Project-URL: Repository, https://github.com/khive-ai/krons

{krons-0.2.2.dist-info → krons-0.2.4.dist-info}/RECORD

@@ -10,9 +10,9 @@ krons/agent/mcps/wrapper.py,sha256=tW4aXzMMBqh4BtcuEaLxYqLxttGRJ06UQSjWmqdsGfI,2
 krons/agent/message/__init__.py,sha256=vumj0lHyraEoshw0tx8yWt5fyUUuAC3qVBiSLQuq-9A,499
 krons/agent/message/action.py,sha256=ynONthCd78gWzl3dbQughJOGd-Iys6lbOzzYwuLXGWU,2047
 krons/agent/message/assistant.py,sha256=V75490V9mQLKbBkH9cYAmnva2-Q3hwCAj_4flLUCvOE,1459
-krons/agent/message/common.py,sha256=j9rpVoZhH6FV9JLVv6K-IgRJqPGnT5Vcw80UsEWv5ME,1282
+krons/agent/message/common.py,sha256=9z2QRoOLdZ_CrChn0bqC7j1Ard660h7osMIfzGYd5i4,1263
 krons/agent/message/instruction.py,sha256=jouxli_yDwRcLJhXs8f9cR0MdreW3pNRDIw2ha7K4uE,4793
-krons/agent/message/prepare_msg.py,sha256=85XB-S2qxzXAUxn0cu46LNbWq0JL6w1IO1soJ3ci0Y4,7017
+krons/agent/message/prepare_msg.py,sha256=YkA4S9J_UPJ5zNRjJtnBRovTAM2QGkyyIx6xLmWkN-w,6956
 krons/agent/message/role.py,sha256=wKY5gIov4yHuvHiXEGFJ8YIaDR2YcmyH83JnDLgnFtI,1397
 krons/agent/message/system.py,sha256=vCwFrYtM8K-5bVvl-mo0xW-Q_1AWqIAOgwDnNQ41DeA,1884
 krons/agent/operations/__init__.py,sha256=UqKGE99xyYBGHnEHPVLq8Bf7dvs195gAnpMH3zpjNNA,2095
@@ -37,15 +37,14 @@ krons/agent/third_party/claude_code.py,sha256=NBYMsdPheb0PqGgTO2_aUAR2XoGDsPUwsB
 krons/agent/third_party/gemini_models.py,sha256=2dag2WbSTKLBd8t0F7t_TXCcl7aqsTFgDI6XLkhsZwM,17416
 krons/agent/third_party/openai_models.py,sha256=L-GkJ-bBW5zwPbgCWEYHMNqRiZfFTAUJE96AVZoDAkQ,8040
 krons/core/__init__.py,sha256=TKi3toVRYybyjUwUJlng--pfWzWihUWQBCNh0UTfTSQ,3611
-krons/core/base/__init__.py,sha256=emyypsuiFK0UzYsDeamD84ygXnO1TLx2A5mBxGTBidE,3755
+krons/core/base/__init__.py,sha256=Edl_HH2F1l0SMHMzuEPU_IFjkigRR1vtqVXcPm-mr1o,3614
 krons/core/base/broadcaster.py,sha256=Es__WfL-j2h5NS6aU18fgaFkZsJIL-zDe86Qvlea-io,4013
 krons/core/base/element.py,sha256=LqBbmPttXoDAFy56JzWhSJ4sBw_LW7hMGxZUog85N8g,7642
 krons/core/base/event.py,sha256=iZQ65Xg3a8eaCEl4Hca-pxPNtckhrHkydEqYyppbuo0,11524
 krons/core/base/eventbus.py,sha256=z45ORtGey5A1N9hdyEPOhlX1whaTTdqdk7g3XEDL-_8,3761
-krons/core/base/flow.py,sha256=eqsYm8QO7bD5Y9VYnlpHFWpaUCY0rCeKGrDrFUyBVA4,12364
+krons/core/base/flow.py,sha256=bFG5x7PEbWApsD24GTgpD5VsedLO6364scaAxvYw6LM,12561
 krons/core/base/graph.py,sha256=FiTMArxuz6At3oYPEoamES3FtBM-AM6QnA7EQ8G18mo,15972
-krons/core/base/log.py,sha256=SMJlruIG4YHk6Ls45jQ9SrPxFCcnypUmTGaWd90wiwM,923
-krons/core/base/node.py,sha256=0_-R6uNe6-LF3adQRZowSIICdy6ep3cQIQRdF0oosoQ,34699
+krons/core/base/node.py,sha256=Kg9rSKHjbeqxA9ypnJCJ2CKPIxfm5Do3fpdGxzgVu2w,34891
 krons/core/base/pile.py,sha256=ZKvnX3BjMsrH989TLNZII1dDWv4yPhSRzLKXx2yzyKQ,21108
 krons/core/base/processor.py,sha256=GrdNZa5YD0tXle847ttnxuWe4Ego1MhULzWHmSz5RqQ,18768
 krons/core/base/progression.py,sha256=srcrmp_zALgg7II5TJsuMM9DdNJszgTxLxvES0WBOTE,9844
@@ -55,7 +54,7 @@ krons/core/specs/operable.py,sha256=zO15i56_UzTTuM3yg_-EMtQY1Equ_WBi3rUCoCKrYck,
 krons/core/specs/protocol.py,sha256=Se-Cow7de4hF4vkvw5qYj14c37JJ-4aJSDIvJHFyst8,4392
 krons/core/specs/spec.py,sha256=QaVWN3ZrX8l1x15xXtfpNGzSIV01X0H3jy9Mjv9vT8Y,18706
 krons/core/specs/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-krons/core/specs/adapters/_utils.py,sha256=ChWH-C2LRXaXiWM3n7P0DZ8Oci5dSDq59DIJtHx2h-g,1365
+krons/core/specs/adapters/_utils.py,sha256=0H5aGHqx8sGrnZTrH3ng_tN4hnSkOEvX3tfbCuBE_0g,2954
 krons/core/specs/adapters/dataclass_field.py,sha256=thhgC3iQsrkfMkKzB4XmDbwh4fpLYocdL0KvY_zxbzo,8802
 krons/core/specs/adapters/factory.py,sha256=_LoSMCtHNkK5kNL5LUDjHvJJ2BtDHAaW1gly5LpNPXQ,1572
 krons/core/specs/adapters/pydantic_adapter.py,sha256=UxnOtJdeIyJEPBBjSACWE-JVc0yWxHSepz5i2SZhS6A,10410
@@ -63,12 +62,12 @@ krons/core/specs/adapters/sql_ddl.py,sha256=NTttvx16X926qeQNWxqdoLlToeiMwufpKEPW
 krons/core/specs/catalog/__init__.py,sha256=TwS7hvGxa4-2Usu5rKGlhmUS0hhBlRzVNFNKDE7q8eU,1231
 krons/core/specs/catalog/_audit.py,sha256=g-L4eSJw3H0hfejex5LwsnepaGyTUPrL8JbPU7lPycY,1260
 krons/core/specs/catalog/_common.py,sha256=ItOPWV1fEeaz6ss5XNZYUetp204saIs7s5Bl0Jt8AOQ,1207
-krons/core/specs/catalog/_content.py,sha256=pQAbgjoObZcAQLe8Wg-_sqQ8VYZUGsRQJnjuiCjH-p0,1972
+krons/core/specs/catalog/_content.py,sha256=XeWYlTX2Jf_Hl5H0c3OLOSGPn1TJOIZ65RCd5WJFi8Y,2324
 krons/core/specs/catalog/_enforcement.py,sha256=JlKF_qGc-Xk7E_ebvq6lQs19iRBAWk2TOe1Qm7XMf1k,2126
 krons/core/types/__init__.py,sha256=pJ6kuop7vSLZp5jMBs-CQ7CHRjvUuO8kHhpZ34KM85I,1049
 krons/core/types/_sentinel.py,sha256=QJGyRAYNkJ2ylw6dhxPHJNgmxqBdorBd-xx7pNrUykw,8855
 krons/core/types/base.py,sha256=Un3MrPGuyns9SgPczJ5vbQExemTO-9B2Eks87NDd--A,12330
-krons/core/types/db_types.py,sha256=3ZaAXJe4dartmF-IyKr59NVlL2EbGpx7AtVqqbrIXIk,8136
+krons/core/types/db_types.py,sha256=zY-DQH-TIDo3XbZBgbIAxdgLI2X1A500F4_NeoH2jVI,10929
 krons/core/types/identity.py,sha256=Ccb5oJArC1PEzdzNPlLi_oK87uKx7BFevX9rvY9y-14,1949
 krons/resource/__init__.py,sha256=h83vOSa6zXXMRdfxch7yg7kGy6Pe_6c0wWANByATbZ8,2783
 krons/resource/backend.py,sha256=mW1kkAZrUwnBZeMOY_0I_egpTKpuNyIs5Mps4r2cOxk,10979
@@ -87,7 +86,7 @@ krons/session/constraints.py,sha256=DvmLKyf5eYUX2nxCDcco1-uDipGjiIJwoUxWVtX2w84,
 krons/session/exchange.py,sha256=QChEqK5NFZJpHWxPrXd8LkGBCFg6LNONd1ZEy0MufpI,9165
 krons/session/message.py,sha256=mtZ-PYCCoyWLy7BSB5TL5a0hIt0aQX2zdckOCIl6NZ0,2007
 krons/session/registry.py,sha256=13pPKmDZJaj9q27oUOdtH6-jrHP_HDFF8lCdcNF--EE,999
-krons/session/session.py,sha256=_y3-NEQxgBa51mRd6LiD7zTqJFikKCP4avLqMai6O08,16966
+krons/session/session.py,sha256=D-ENpVZYCQZ80iiPiuuJXj8jt6qtoHkDSbSWYYM4bFs,17218
 krons/utils/__init__.py,sha256=V-jTKULdofjJXxcEHygefKV_v6XE4H3poCdxPLjvf_4,1718
 krons/utils/_function_arg_parser.py,sha256=H5JVLBVY8W9ZNkZ4_YVtVVY1rFYvnIRhSrAhKEdj2Qc,3479
 krons/utils/_hash.py,sha256=W2Ma9v8-INPaGkur7GTtbF8KwuXSJNSwk8DCNPRvx8Q,6859
@@ -146,7 +145,7 @@ krons/work/rules/common/mapping.py,sha256=Loq54MNEtwpnHN0aypTjFOqwoOKLEysddHh-JE
 krons/work/rules/common/model.py,sha256=xmM6coEThf_fgIiqJiyDgvdfib_FpVeY6LgWPVcWSwU,3026
 krons/work/rules/common/number.py,sha256=cCukgMSpQu5RdYK5rXAUyop9qXgDRfLCioMvE8kIzHg,3162
 krons/work/rules/common/string.py,sha256=zHp_OLh0FL4PvmSlyDTEzb2I97-DBSEyI2zcMo10voA,5090
-krons-0.2.2.dist-info/METADATA,sha256=X1gYH9GGL-V2GhH3_iy96GzRZOCwO-HKt7NpNrzmgcg,2527
-krons-0.2.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-krons-0.2.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-krons-0.2.2.dist-info/RECORD,,
+krons-0.2.4.dist-info/METADATA,sha256=Gx3-BD7Bbtp9hwlcgThGcWABG9DlklrBV9z8N3kUQ7Q,2527
+krons-0.2.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+krons-0.2.4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+krons-0.2.4.dist-info/RECORD,,

krons/core/base/log.py

@@ -1,32 +0,0 @@
-# Copyright (c) 2025 - 2026, HaiyangLi <quantocean.li at gmail dot com>
-# SPDX-License-Identifier: Apache-2.0
-
-"""Logging configuration for Session message persistence.
-
-Provides DataLoggerConfig for configuring automatic message dumps.
-"""
-
-from __future__ import annotations
-
-from pathlib import Path
-from typing import Literal
-
-from pydantic import Field
-
-from krons.core.types import HashableModel
-
-__all__ = ("DataLoggerConfig",)
-
-
-class DataLoggerConfig(HashableModel):
-    """Configuration for Session message persistence.
-
-    Attributes:
-        persist_dir: Directory for dump files.
-        extension: Output format (.json array or .jsonl newline-delimited).
-        auto_save_on_exit: Register atexit handler on Session creation.
-    """
-
-    persist_dir: str | Path = Field(default="./logs")
-    extension: Literal[".json", ".jsonl"] = Field(default=".jsonl")
-    auto_save_on_exit: bool = Field(default=True)