KiloStar/kilostar/core/individual/consciousness_node/template.py

#  Copyright 2026 zhaoxi826
#
#  Licensed under the Apache License, Version 2.0 (the "License");
#  you may not use this file except in compliance with the License.
#  You may obtain a copy of the License at
#
#       http://www.apache.org/licenses/LICENSE-2.0
#
#  Unless required by applicable law or agreed to in writing, software
#  distributed under the License is distributed on an "AS IS" BASIS,
#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#  See the License for the specific language governing permissions and
#  limitations under the License.


from kilostar.core.work.workflow.workflow import KiloStarWorkflow, WorkflowStep
from kilostar.utils.agent_model import ResponseModel, DepsModel, InputModel
from pydantic import Field


# 意识节点回复类
class ConsciousnessNodeResponse(ResponseModel):
    """Consciousness response model,是意识节点所有回复类型的父类"""

    pass


class ForWorkflowEngine(ConsciousnessNodeResponse):
    """生成workflow并放入WorkflowEngine"""

    workflow: KiloStarWorkflow = Field(
        ..., description="生成好的符合规范的完整工作流对象。"
    )
    reasoning: str = Field(..., description="生成此工作流的原因和思路简述。")


class ForWorkflow(ConsciousnessNodeResponse):
    """处理workflow中需要ConsciousnessNode的工作"""

    output: str = Field(..., description="对当前工作流步骤的具体处理结果或指导意见。")


class ForregulatoryNode(ConsciousnessNodeResponse):
    """工作流完成后进行校验并返回给regulatoryNode"""

    output: str = Field(
        ..., description="为监控节点提供的全工作流执行情况的技术性总结报告。"
    )


class ConsciousnessNodeDeps(DepsModel):
    """ConsciousnessNodeDeps 核心组件类。
    这是一个系统执行节点类，作为多智能体架构中的独立处理单元。它能够接收工作流上下文，根据内置的大模型策略进行意图理解和自主决策，从而驱动特定阶段的任务闭环。"""

    original_command: str
    command: str
    available_skills: list[dict] | None = None


class ConsciousnessNodeInput(InputModel):
    """ConsciousnessNodeInput 核心组件类。
    这是一个系统执行节点类，作为多智能体架构中的独立处理单元。它能够接收工作流上下文，根据内置的大模型策略进行意图理解和自主决策，从而驱动特定阶段的任务闭环。"""

    pass


class ForWorkflowEngineInput(ConsciousnessNodeInput):
    """ForWorkflowEngineInput 核心组件类。
    这是一个领域数据模型或功能封装类，承载了 ForWorkflowEngineInput 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""

    original_command: str
    available_skills: list[dict] | None = None


class ForWorkflowInput(ConsciousnessNodeInput):
    """ForWorkflowInput 核心组件类。
    这是一个领域数据模型或功能封装类，承载了 ForWorkflowInput 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""

    workflow_step: WorkflowStep
    original_command: str


class ForregulatoryInput(ConsciousnessNodeInput):
    """ForregulatoryInput 核心组件类。
    这是一个领域数据模型或功能封装类，承载了 ForregulatoryInput 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""

    workflow: KiloStarWorkflow
    original_command: str