omnibase_infra 0.3.2__py3-none-any.whl → 0.4.0__py3-none-any.whl

omnibase_infra/handlers/models/model_slack_alert_payload.py

@@ -0,0 +1,77 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 OmniNode Team
+"""Slack Alert Input Payload Model.
+
+Provides the input payload model for Slack alert operations.
+"""
+
+from __future__ import annotations
+
+from uuid import UUID, uuid4
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from omnibase_core.types import JsonType
+from omnibase_infra.handlers.models.enum_alert_severity import EnumAlertSeverity
+
+
+class ModelSlackAlert(BaseModel):
+    """Input payload for Slack alert operations.
+
+    This model defines the structure of alert payloads sent to
+    the HandlerSlackWebhook. The handler transforms this into
+    Slack Block Kit formatted messages.
+
+    Attributes:
+        severity: Alert severity level for visual formatting
+        message: Main alert message (required)
+        title: Optional alert title (defaults to severity-based title)
+        details: Optional key-value details to include in the alert
+        channel: Optional channel override (webhook default if not specified)
+        correlation_id: UUID for distributed tracing
+
+    Example:
+        >>> alert = ModelSlackAlert(
+        ...     severity=EnumAlertSeverity.WARNING,
+        ...     message="High memory usage detected",
+        ...     title="Resource Alert",
+        ...     details={"node": "registry-effect", "memory_pct": "85"},
+        ... )
+    """
+
+    model_config = ConfigDict(
+        frozen=True,
+        extra="forbid",
+        from_attributes=True,  # Support pytest-xdist compatibility
+    )
+
+    severity: EnumAlertSeverity = Field(
+        default=EnumAlertSeverity.INFO,
+        description="Alert severity level for visual formatting",
+    )
+    message: str = Field(
+        ...,
+        min_length=1,
+        max_length=3000,
+        description="Main alert message content",
+    )
+    title: str | None = Field(
+        default=None,
+        max_length=150,
+        description="Optional alert title (defaults to severity-based title)",
+    )
+    details: dict[str, JsonType] = Field(
+        default_factory=dict,
+        description="Additional key-value details to include in the alert",
+    )
+    channel: str | None = Field(
+        default=None,
+        description="Optional channel override (uses webhook default if not specified)",
+    )
+    correlation_id: UUID = Field(
+        default_factory=uuid4,
+        description="UUID for distributed tracing",
+    )
+
+
+__all__ = ["ModelSlackAlert"]

omnibase_infra/handlers/models/model_slack_alert_result.py

@@ -0,0 +1,73 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 OmniNode Team
+"""Slack Alert Result Model.
+
+Provides the response model for Slack webhook operations.
+"""
+
+from __future__ import annotations
+
+from uuid import UUID
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ModelSlackAlertResult(BaseModel):
+    """Response from Slack webhook operations.
+
+    This model captures the result of a Slack alert send operation,
+    including success/failure status, timing, and retry information.
+
+    Attributes:
+        success: Whether the alert was delivered successfully
+        duration_ms: Time taken for the operation in milliseconds
+        correlation_id: UUID from the original request for tracing
+        error: Sanitized error message if success is False
+        error_code: Error code for programmatic handling
+        retry_count: Number of retry attempts made
+
+    Example:
+        >>> result = ModelSlackAlertResult(
+        ...     success=True,
+        ...     duration_ms=123.45,
+        ...     correlation_id=uuid4(),
+        ... )
+        >>> print(result.success)
+        True
+    """
+
+    model_config = ConfigDict(
+        frozen=True,
+        extra="forbid",
+        from_attributes=True,
+    )
+
+    success: bool = Field(
+        ...,
+        description="Whether the alert was delivered successfully",
+    )
+    duration_ms: float = Field(
+        default=0.0,
+        ge=0.0,
+        description="Time taken for the operation in milliseconds",
+    )
+    correlation_id: UUID = Field(
+        ...,
+        description="UUID from the original request for tracing",
+    )
+    error: str | None = Field(
+        default=None,
+        description="Sanitized error message if success is False",
+    )
+    error_code: str | None = Field(
+        default=None,
+        description="Error code for programmatic handling",
+    )
+    retry_count: int = Field(
+        default=0,
+        ge=0,
+        description="Number of retry attempts made",
+    )
+
+
+__all__ = ["ModelSlackAlertResult"]

omnibase_infra/mixins/mixin_node_introspection.py

@@ -154,6 +154,7 @@ Usage:
             config = ModelIntrospectionConfig(
                 node_id=node_config.node_id,
                 node_type=EnumNodeKind.EFFECT,
+                node_name="my_node",
                 event_bus=event_bus,
             )
             self.initialize_introspection(config)
@@ -214,6 +215,7 @@ from omnibase_infra.capabilities import ContractCapabilityExtractor
 from omnibase_infra.constants_topic_patterns import TOPIC_NAME_PATTERN
 from omnibase_infra.enums import EnumInfraTransportType, EnumIntrospectionReason
 from omnibase_infra.errors import ModelInfraErrorContext, ProtocolConfigurationError
+from omnibase_infra.models import ModelNodeIdentity
 from omnibase_infra.models.discovery import (
     ModelDiscoveredCapabilities,
     ModelIntrospectionConfig,
@@ -422,6 +424,7 @@ class MixinNodeIntrospection:
                 config = ModelIntrospectionConfig(
                     node_id=node_id,
                     node_type=EnumNodeKind.EFFECT,
+                    node_name="postgres_adapter",
                     event_bus=adapter_config.event_bus,
                 )
                 self.initialize_introspection(config)
@@ -463,6 +466,9 @@ class MixinNodeIntrospection:
     _introspection_node_type: EnumNodeKind | None
     _introspection_event_bus: ProtocolEventBus | None
     _introspection_version: str
+    _introspection_node_name: str
+    _introspection_env: str
+    _introspection_service: str
     _introspection_start_time: float | None
     _introspection_contract: ModelContractBase | None
 
@@ -590,6 +596,7 @@ class MixinNodeIntrospection:
                     config = ModelIntrospectionConfig(
                         node_id=node_config.node_id,
                         node_type=EnumNodeKind.EFFECT,
+                        node_name="my_node",
                         event_bus=node_config.event_bus,
                         version="1.2.0",
                     )
@@ -601,6 +608,7 @@ class MixinNodeIntrospection:
                     config = ModelIntrospectionConfig(
                         node_id=node_config.node_id,
                         node_type=EnumNodeKind.EFFECT,
+                        node_name="my_effect_node",
                         event_bus=node_config.event_bus,
                         operation_keywords=frozenset({"fetch", "upload", "download"}),
                     )
@@ -638,6 +646,9 @@ class MixinNodeIntrospection:
             )
         self._introspection_event_bus = config.event_bus
         self._introspection_version = config.version
+        self._introspection_node_name = config.node_name
+        self._introspection_env = config.env
+        self._introspection_service = config.service
         self._introspection_cache_ttl = config.cache_ttl
 
         # Capability discovery configuration - frozensets are immutable, no copy needed
@@ -984,38 +995,40 @@ class MixinNodeIntrospection:
     ) -> ModelNodeEventBusConfig | None:
         """Extract and resolve event_bus config from contract.
 
-        Extracts topic suffixes from the contract's event_bus subcontract and
-        resolves them to full environment-qualified topic strings.
+        Extracts topic names from the contract's event_bus subcontract.
+        Topics are realm-agnostic in ONEX - environment/realm is enforced via
+        envelope identity, not topic naming.
 
-        Topic Resolution:
-            Contract topics are suffixes (e.g., "onex.evt.intent-classified.v1").
-            This method prepends the environment prefix to create full topics
-            (e.g., "dev.onex.evt.intent-classified.v1").
+        Topic Format:
+            Topics follow ONEX naming convention:
+            onex.{kind}.{producer}.{event-name}.v{n}
+
+            Example: "onex.evt.intent-classified.v1"
 
         Args:
-            env_prefix: Environment prefix (e.g., "dev", "prod", "staging").
-                Must be a valid identifier without dots or special characters.
+            env_prefix: Environment prefix (retained for compatibility, but no longer
+                used for topic resolution as topics are realm-agnostic).
 
         Returns:
-            Resolved event bus config with full topic strings, or None if:
+            Resolved event bus config with topic strings, or None if:
             - No contract is configured (_introspection_contract is None)
             - Contract has no event_bus subcontract
             - event_bus subcontract has no publish_topics or subscribe_topics
 
         Raises:
-            ValueError: If topic resolution fails due to unresolved placeholders
-                (e.g., "{env}" or "{namespace}" remaining in the resolved topic).
+            ValueError: If topic validation fails due to unresolved placeholders
+                (e.g., "{env}" or "{namespace}" remaining in the topic).
                 This is a fail-fast mechanism to prevent misconfigured topics
                 from being published to the registry.
 
         Example:
             >>> config = self._extract_event_bus_config("dev")
             >>> config.publish_topic_strings
-            ['dev.onex.evt.node-registered.v1']
+            ['onex.evt.node-registered.v1']
 
         See Also:
-            - ModelEventBusSubcontract: Contract model with topic suffixes
-            - ModelNodeEventBusConfig: Registry storage model with full topics
+            - ModelEventBusSubcontract: Contract model with topics
+            - ModelNodeEventBusConfig: Registry storage model
         """
         if self._introspection_contract is None:
             return None
@@ -1037,8 +1050,12 @@ class MixinNodeIntrospection:
             return None
 
         def resolve_topic(suffix: str) -> str:
-            """Resolve topic suffix to full topic with env prefix."""
-            # Full topic format: {env}.{suffix}
+            """Resolve topic suffix to topic name (realm-agnostic).
+
+            Topics are realm-agnostic in ONEX. The environment/realm is enforced via
+            envelope identity, not topic naming. This enables cross-environment event
+            routing when needed while maintaining proper isolation through identity.
+            """
             # Strip whitespace from suffix to handle YAML formatting artifacts
             suffix = suffix.strip()
 
@@ -1065,9 +1082,8 @@ class MixinNodeIntrospection:
                     parameter="topic_suffix",
                 )
 
-            full_topic = f"{env_prefix}.{suffix}"
-
-            return full_topic
+            # Return topic unchanged - topics are realm-agnostic
+            return suffix
 
         def build_entry(suffix: str) -> ModelEventBusTopicEntry:
             """Build topic entry from suffix."""
@@ -2081,9 +2097,15 @@ class MixinNodeIntrospection:
             return False
 
         request_topic = self._request_introspection_topic
+        node_identity = ModelNodeIdentity(
+            env=self._introspection_env,
+            service=self._introspection_service,
+            node_name=self._introspection_node_name,
+            version=self._introspection_version,
+        )
         unsubscribe = await event_bus.subscribe(
             topic=request_topic,
-            group_id=f"introspection-{self._introspection_node_id}",
+            node_identity=node_identity,
             on_message=self._handle_introspection_request,
         )
         self._registry_unsubscribe = unsubscribe

omnibase_infra/models/discovery/model_dependency_spec.py

@@ -89,6 +89,7 @@ class ModelDependencySpec(BaseModel):
     model_config = ConfigDict(
         frozen=True,
         extra="forbid",
+        from_attributes=True,  # ORM/pytest-xdist compatibility
     )
 
     # Identity

omnibase_infra/models/discovery/model_discovered_capabilities.py

@@ -27,7 +27,7 @@ class ModelDiscoveredCapabilities(BaseModel):
         ... )
     """
 
-    model_config = ConfigDict(extra="forbid", frozen=True)
+    model_config = ConfigDict(extra="forbid", frozen=True, from_attributes=True)
 
     operations: tuple[str, ...] = Field(
         default=(),

omnibase_infra/models/discovery/model_introspection_config.py

@@ -108,6 +108,7 @@ class ModelIntrospectionConfig(BaseModel):
                 config = ModelIntrospectionConfig(
                     node_id=node_id,
                     node_type=EnumNodeKind.EFFECT,  # Use enum directly (preferred)
+                    node_name="my_effect_node",
                     event_bus=event_bus,
                     version="1.2.0",
                 )
@@ -119,6 +120,7 @@ class ModelIntrospectionConfig(BaseModel):
                 config = ModelIntrospectionConfig(
                     node_id=node_id or uuid4(),
                     node_type=EnumNodeKind.EFFECT,  # Use enum directly (preferred)
+                    node_name="my_custom_effect_node",
                     event_bus=event_bus,
                     operation_keywords=frozenset({"fetch", "upload", "download"}),
                 )
@@ -141,6 +143,27 @@ class ModelIntrospectionConfig(BaseModel):
         "Accepts EnumNodeKind directly (preferred) or string (deprecated, will be coerced).",
     )
 
+    node_name: str = Field(  # pattern-ok: canonical identifier, not a foreign key reference
+        ...,
+        min_length=1,
+        description="Node name for consumer group identification (e.g., 'claude_hook_effect'). "
+        "Cannot be empty.",
+    )
+
+    env: str = Field(
+        default="dev",
+        min_length=1,
+        description="Environment identifier (e.g., 'dev', 'staging', 'prod'). "
+        "Used for node identity in event bus subscriptions. Cannot be empty.",
+    )
+
+    service: str = Field(
+        default="onex",
+        min_length=1,
+        description="Service name (e.g., 'omniintelligence', 'omnibridge'). "
+        "Used for node identity in event bus subscriptions. Cannot be empty.",
+    )
+
     # Event bus for publishing introspection events.
     # Uses _EventBusType which provides:
     # - ProtocolEventBus | None during static analysis (TYPE_CHECKING)
@@ -155,7 +178,8 @@ class ModelIntrospectionConfig(BaseModel):
 
     version: str = Field(
         default="1.0.0",
-        description="Node version string",
+        min_length=1,
+        description="Node version string. Cannot be empty.",
     )
 
     cache_ttl: float = Field(
@@ -284,6 +308,7 @@ class ModelIntrospectionConfig(BaseModel):
     model_config = ConfigDict(
         frozen=True,
         extra="forbid",
+        from_attributes=True,  # ORM/pytest-xdist compatibility
         arbitrary_types_allowed=True,  # Allow arbitrary types for event_bus
         json_schema_extra={
             "examples": [
@@ -291,6 +316,7 @@ class ModelIntrospectionConfig(BaseModel):
                 {
                     "node_id": "550e8400-e29b-41d4-a716-446655440000",
                     "node_type": "EFFECT",
+                    "node_name": "example_effect_node",
                     "event_bus": None,
                     "version": "1.0.0",
                     "cache_ttl": 300.0,
@@ -305,6 +331,7 @@ class ModelIntrospectionConfig(BaseModel):
                 {
                     "node_id": "550e8400-e29b-41d4-a716-446655440001",
                     "node_type": "COMPUTE",
+                    "node_name": "example_compute_node",
                     "event_bus": None,
                     "version": "2.1.0",
                     "cache_ttl": 120.0,

omnibase_infra/models/discovery/model_introspection_performance_metrics.py

@@ -131,6 +131,7 @@ class ModelIntrospectionPerformanceMetrics(BaseModel):
     model_config = ConfigDict(
         frozen=True,
         extra="forbid",
+        from_attributes=True,  # ORM/pytest-xdist compatibility
         json_schema_extra={
             "examples": [
                 {

omnibase_infra/models/discovery/model_introspection_task_config.py

@@ -96,6 +96,7 @@ class ModelIntrospectionTaskConfig(BaseModel):
     model_config = ConfigDict(
         frozen=True,
         extra="forbid",
+        from_attributes=True,  # ORM/pytest-xdist compatibility
         json_schema_extra={
             "examples": [
                 {

omnibase_infra/models/runtime/__init__.py

@@ -26,6 +26,9 @@ from omnibase_infra.models.runtime.model_plugin_load_context import (
 from omnibase_infra.models.runtime.model_plugin_load_summary import (
     ModelPluginLoadSummary,
 )
+from omnibase_infra.models.runtime.model_resolved_dependencies import (
+    ModelResolvedDependencies,
+)
 
 # ModelContractLoadResult and ModelRuntimeContractConfig are exported from
 # omnibase_infra.runtime.models (canonical location for runtime loader models)
@@ -45,5 +48,6 @@ __all__ = [
     "ModelLoadedHandler",
     "ModelPluginLoadContext",
     "ModelPluginLoadSummary",
+    "ModelResolvedDependencies",
     "ModelRuntimeContractConfig",
 ]

omnibase_infra/models/runtime/model_resolved_dependencies.py

@@ -0,0 +1,116 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2025 OmniNode Team
+"""Model for resolved protocol dependencies.
+
+This module provides ModelResolvedDependencies, a container for protocol
+instances resolved from the container service_registry at node creation time.
+
+Part of OMN-1732: Runtime dependency injection for zero-code nodes.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ModelResolvedDependencies(BaseModel):
+    """Container for resolved protocol dependencies.
+
+    Holds protocol instances resolved from ModelONEXContainer.service_registry
+    for injection into node constructors. This model is immutable after creation.
+
+    The protocols dict maps protocol class names to their resolved instances:
+    - Key: Protocol class name (e.g., "ProtocolPostgresAdapter")
+    - Value: Resolved instance from container
+
+    Example:
+        >>> resolved = ModelResolvedDependencies(
+        ...     protocols={
+        ...         "ProtocolPostgresAdapter": postgres_adapter,
+        ...         "ProtocolCircuitBreakerAware": circuit_breaker,
+        ...     }
+        ... )
+        >>> adapter = resolved.get("ProtocolPostgresAdapter")
+
+    .. versionadded:: 0.x.x
+        Part of OMN-1732 runtime dependency injection.
+    """
+
+    model_config = ConfigDict(
+        frozen=True,
+        extra="forbid",
+        arbitrary_types_allowed=True,  # Required for protocol instances
+    )
+
+    # ONEX_EXCLUDE: any_type - dict[str, Any] required for heterogeneous protocol instances
+    # resolved from container.service_registry. Type varies by protocol (ProtocolPostgresAdapter,
+    # ProtocolCircuitBreakerAware, etc.). Cannot use Union as protocols are open-ended.
+    protocols: dict[str, Any] = Field(
+        default_factory=dict,
+        description="Map of protocol class names to resolved instances",
+    )
+
+    # ONEX_EXCLUDE: any_type - returns heterogeneous protocol instance from protocols dict
+    def get(self, protocol_name: str) -> Any:
+        """Get a resolved protocol by name.
+
+        Args:
+            protocol_name: The protocol class name (e.g., "ProtocolPostgresAdapter")
+
+        Returns:
+            The resolved protocol instance.
+
+        Raises:
+            KeyError: If protocol_name is not in the resolved protocols.
+
+        Example:
+            >>> adapter = resolved.get("ProtocolPostgresAdapter")
+        """
+        if protocol_name not in self.protocols:
+            raise KeyError(
+                f"Protocol '{protocol_name}' not found in resolved dependencies. "
+                f"Available: {list(self.protocols.keys())}"
+            )
+        return self.protocols[protocol_name]
+
+    # ONEX_EXCLUDE: any_type - returns heterogeneous protocol instance, default can be any type
+    def get_optional(self, protocol_name: str, default: Any = None) -> Any:
+        """Get a resolved protocol by name, returning default if not found.
+
+        Args:
+            protocol_name: The protocol class name
+            default: Value to return if protocol not found
+
+        Returns:
+            The resolved protocol instance or default.
+        """
+        return self.protocols.get(protocol_name, default)
+
+    def has(self, protocol_name: str) -> bool:
+        """Check if a protocol is available.
+
+        Args:
+            protocol_name: The protocol class name
+
+        Returns:
+            True if protocol is resolved, False otherwise.
+        """
+        return protocol_name in self.protocols
+
+    def __len__(self) -> int:
+        """Return number of resolved protocols."""
+        return len(self.protocols)
+
+    def __bool__(self) -> bool:
+        """Return True if any protocols are resolved.
+
+        Warning:
+            **Non-standard __bool__ behavior**: Returns True only when
+            at least one protocol is resolved.
+        """
+        return len(self.protocols) > 0
+
+
+__all__ = ["ModelResolvedDependencies"]

omnibase_infra/nodes/contract_registry_reducer/contract.yaml

@@ -38,19 +38,20 @@ description: |
   are separated.
 # Event Consumption Configuration
 # ================================
-# Topics follow 5-segment naming: {env}.onex.{category}.{domain}.{event-name}.v{version}
+# Topics are realm-agnostic: onex.{category}.{domain}.{event-name}.v{version}
 # Categories: evt (external events), int (internal events), cmd (commands)
+# Note: Environment/realm is enforced via envelope identity, not topic naming.
 consumed_events:
-  - topic: "{env}.onex.evt.platform.contract-registered.v1"
+  - topic: "onex.evt.platform.contract-registered.v1"
     event_type: "ModelContractRegisteredEvent"
     description: "Contract registration from nodes on startup"
-  - topic: "{env}.onex.evt.platform.contract-deregistered.v1"
+  - topic: "onex.evt.platform.contract-deregistered.v1"
     event_type: "ModelContractDeregisteredEvent"
     description: "Explicit contract deregistration on graceful shutdown"
-  - topic: "{env}.onex.evt.platform.node-heartbeat.v1"
+  - topic: "onex.evt.platform.node-heartbeat.v1"
     event_type: "ModelNodeHeartbeatEvent"
     description: "Heartbeat for liveness tracking and last_seen_at updates"
-  - topic: "{env}.onex.int.platform.runtime-tick.v1"
+  - topic: "onex.int.platform.runtime-tick.v1"
     event_type: "ModelRuntimeTick"
     internal: true
     description: "Periodic tick for staleness computation - marks contracts as stale/inactive"

omnibase_infra/nodes/contract_registry_reducer/reducer.py

@@ -632,30 +632,14 @@ class ContractRegistryReducer:
         Parses the contract_yaml for consumed_events and published_events,
         then creates postgres.update_topic intents for each topic suffix.
 
-        Environment Placeholder Handling:
-            Topic suffixes from contract_yaml may contain ``{env}.`` placeholders
-            (e.g., ``{env}.onex.evt.platform.contract-registered.v1``). This reducer
-            stores these values **as-is** without stripping the placeholder.
+        Realm-Agnostic Topics:
+            Topics in ONEX are realm-agnostic. The environment/realm is enforced via
+            envelope identity, not topic naming. Contract topics are stored without
+            any environment prefix (e.g., ``onex.evt.platform.contract-registered.v1``).
 
-            This is intentional for several reasons:
-
-            1. **Reducer Purity**: The reducer remains environment-agnostic and
-               deterministic - it doesn't need to know about deployment environments.
-
-            2. **Effect Layer Responsibility**: The PostgresAdapter (Effect layer)
-               is responsible for resolving or stripping the ``{env}.`` placeholder
-               at write time, when the actual environment context is available.
-
-            3. **Auditing**: Storing the raw contract value preserves the original
-               contract specification for debugging and auditing purposes.
-
-            4. **Query Flexibility**: Downstream consumers can query topics with
-               or without the placeholder depending on their needs.
-
-            The Effect layer should handle ``{env}.`` resolution via one of:
-            - Stripping the prefix before storage (simple)
-            - Replacing with actual environment (e.g., ``dev.``, ``prod.``)
-            - Storing as-is with environment-aware queries
+            The Effect layer (PostgresAdapter) may still encounter legacy topics with
+            ``{env}.`` placeholders and will strip them during storage normalization.
+            See ``normalize_topic_for_storage()`` in handler_postgres_topic_update.py.
 
         Args:
             event: Contract registered event with contract_yaml.
@@ -697,9 +681,8 @@ class ContractRegistryReducer:
         if isinstance(consumed_events, list):
             for consumed in consumed_events:
                 if isinstance(consumed, dict):
-                    # NOTE: topic_suffix may contain {env}. placeholder (e.g.,
-                    # "{env}.onex.evt.platform.contract-registered.v1").
-                    # We store it as-is; the Effect layer handles resolution.
+                    # Topics are realm-agnostic (e.g., "onex.evt.platform.contract-registered.v1").
+                    # Legacy topics with {env}. prefix are normalized by the Effect layer.
                     topic_suffix = consumed.get("topic")
                     if topic_suffix and isinstance(topic_suffix, str):
                         # Validate event_type is string (may be missing or wrong type in malformed YAML)