#  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.

import datetime
from pydantic import BaseModel, Field, ConfigDict
from ulid import ULID
from typing import Any, Dict
import asyncio
from kilostar.core.work.workflow.workflow import KiloStarWorkflow


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

    model_config = ConfigDict(arbitrary_types_allowed=True)
    trace_id: str = Field(
        default_factory=lambda: str(ULID()), description="事件的唯一标识符"
    )
    platform: str = Field(description="消息来源的平台")
    user_id: str = Field(description="用户id")
    user_name: str = Field(description="用户名")
    create_time: str = Field(
        default_factory=lambda: str(
            datetime.datetime.now(datetime.timezone.utc).isoformat()
        ),
        description="事件创建时间",
    )
    message: str = Field(description="用户发来的消息")
    attachment: Dict[str, str] | None = Field(default=None, description="附件")
    # --------------------------------------------------------------------------------------------------------------
    context: Dict[str, Any] = Field(
        default_factory=dict, description="事件上下文内容，可包含工作流模板等信息"
    )
    workflow: KiloStarWorkflow | None = Field(default=None, description="工作流")
    pending_queue: asyncio.Queue[str] | None = Field(
        default=None, description="待处理队列"
    )
    receive_queue: asyncio.Queue[str] | None = Field(
        default=None, description="待接收队列"
    )