Files
microsoft--semantic-kernel/python/semantic_kernel/processes/dapr_runtime/dapr_step_info.py
T
wehub-resource-sync b957a53def
CodeQL / Analyze (csharp) (push) Waiting to run
CodeQL / Analyze (python) (push) Waiting to run
chore: import upstream snapshot with attribution
2026-07-13 13:21:23 +08:00

62 lines
2.6 KiB
Python

# Copyright (c) Microsoft. All rights reserved.
from collections.abc import Sequence
from typing import Literal
from pydantic import Field
from semantic_kernel.exceptions.kernel_exceptions import KernelException
from semantic_kernel.kernel_pydantic import KernelBaseModel
from semantic_kernel.processes.kernel_process.kernel_process_edge import KernelProcessEdge
from semantic_kernel.processes.kernel_process.kernel_process_state import KernelProcessState
from semantic_kernel.processes.kernel_process.kernel_process_step_info import KernelProcessStepInfo
from semantic_kernel.processes.kernel_process.kernel_process_step_state import KernelProcessStepState
from semantic_kernel.processes.step_utils import (
DEFAULT_ALLOWED_MODULE_PREFIXES,
get_fully_qualified_name,
get_step_class_from_qualified_name,
)
from semantic_kernel.utils.feature_stage_decorator import experimental
@experimental
class DaprStepInfo(KernelBaseModel):
"""A Dapr step info."""
type: Literal["DaprStepInfo"] = "DaprStepInfo"
inner_step_python_type: str
state: KernelProcessState | KernelProcessStepState
edges: dict[str, list[KernelProcessEdge]] = Field(default_factory=dict)
def to_kernel_process_step_info(
self, allowed_module_prefixes: Sequence[str] | None = DEFAULT_ALLOWED_MODULE_PREFIXES
) -> KernelProcessStepInfo:
"""Converts the Dapr step info to a kernel process step info.
Args:
allowed_module_prefixes: Sequence of module prefixes that are allowed
for step class loading. Defaults to DEFAULT_ALLOWED_MODULE_PREFIXES
("semantic_kernel.",). Pass None to disable the allowlist and allow
any module (not recommended for production). An empty sequence blocks
all modules.
"""
inner_step_type = get_step_class_from_qualified_name(
self.inner_step_python_type,
allowed_module_prefixes=allowed_module_prefixes,
)
return KernelProcessStepInfo(inner_step_type=inner_step_type, state=self.state, output_edges=self.edges)
@classmethod
def from_kernel_step_info(cls, kernel_step_info: KernelProcessStepInfo) -> "DaprStepInfo":
"""Creates a Dapr step info from a kernel step info."""
if kernel_step_info is None:
raise KernelException("Kernel step info must be provided")
inner_step_type = get_fully_qualified_name(kernel_step_info.inner_step_type)
return DaprStepInfo(
inner_step_python_type=inner_step_type,
state=kernel_step_info.state,
edges={key: list(value) for key, value in kernel_step_info.edges.items()},
)