dark 1e74ae3cd6 feat: 增加 PAM 部署 Agent 交互式 CLI 与真实 LLM 配置
- 新增 OpenAI-compatible LLM client,支持 base_url、api_key、model 配置
- 固化意图识别、参数抽取、部署计划生成的结构化 JSON 提示词
- 增加 MCP client 配置读取和真实 session 接入说明
- 实现 checkpoint 自动保存、resume 断点续跑和已完成步骤跳过
- 实现人工确认流程,支持失败 IP 回滚 approve/reject
- 新增 chat 常驻式 CLI 对话框,支持自然语言分析、参数设置、执行确认、状态查看、回滚确认和续跑
- 同步 README,补充 LLM、MCP、checkpoint、confirm/resume、chat 使用方式
- 增加相关单元测试,覆盖 LLM client、MCP 配置、确认/续跑和交互式 CLI
2026-06-01 10:26:40 +08:00

104 lines
3.3 KiB
Python

"""Shared dataclasses for the PAM deploy agent."""
from __future__ import annotations
from dataclasses import dataclass, field
from typing import Any, Literal
BackendName = Literal["mcp", "script", "fake"]
ExecutionStrategy = Literal["hybrid_node_mcp", "script_only", "fake"]
IntentName = Literal["deploy", "show_usage", "preview", "query_node_ips", "rollback"]
ModePreference = Literal["MCP", "API脚本", "未指定"]
StrategyPreference = Literal["hybrid_node_mcp", "script_only", "fake", "未指定"]
@dataclass(slots=True)
class ActionResult:
action: str
backend: BackendName
ok: bool
values: dict[str, Any] = field(default_factory=dict)
exit_code: int = 0
tool_name: str = ""
stdout: str = ""
stderr: str = ""
raw_output: str = ""
error_summary: str = ""
@dataclass(slots=True)
class SkillPolicy:
name: str
source_path: str
description: str = ""
allowed_modes: tuple[str, ...] = ("MCP", "API脚本")
allowed_actions: tuple[str, ...] = ()
required_confirmations: tuple[str, ...] = (
"params",
"target_scope",
"rollback",
)
required_params: tuple[str, ...] = ()
optional_params: dict[str, Any] = field(default_factory=dict)
action_sequence: tuple[str, ...] = ()
ip_action_sequence: tuple[str, ...] = ()
forbidden_actions: tuple[str, ...] = (
"script-main-flow",
"auto-rollback",
"modify-deploy-scripts",
)
@dataclass(slots=True)
class LlmIntentResult:
intent: IntentName
mode_preference: ModePreference = "未指定"
strategy_preference: StrategyPreference = "未指定"
confidence: float = 0.0
reasons: list[str] = field(default_factory=list)
needs_clarification: bool = False
clarification_questions: list[str] = field(default_factory=list)
@dataclass(slots=True)
class LlmParamResult:
extracted_params: dict[str, Any] = field(default_factory=dict)
extracted_control: dict[str, Any] = field(default_factory=dict)
missing_required_params: list[str] = field(default_factory=list)
ambiguous_fields: list[str] = field(default_factory=list)
sensitive_fields_present: list[str] = field(default_factory=list)
@dataclass(slots=True)
class LlmDeployPlan:
summary: str
risk_notes: list[str] = field(default_factory=list)
planned_actions: list[str] = field(default_factory=list)
requires_confirmation: bool = True
execution_strategy: StrategyPreference = "未指定"
@dataclass(slots=True)
class AgentState:
run_id: str
params: dict[str, Any]
execution_strategy: ExecutionStrategy
action_backends: dict[str, BackendName]
script_entry: str = ""
script_base_dir: str = "."
config_path: str = ""
trace_file_path: str = ""
node_mcp_server_name: str = ""
node_mcp_tool_names: dict[str, str] = field(default_factory=dict)
completed_global_steps: list[str] = field(default_factory=list)
hash_code: str = ""
node_url: str = ""
online_ips: list[str] = field(default_factory=list)
target_ips: list[str] = field(default_factory=list)
ip_states: dict[str, dict[str, Any]] = field(default_factory=dict)
pending_confirmation: str = ""
last_success_step: str = ""
last_failed_step: str = ""
checkpoint_path: str = ""
events: list[dict[str, Any]] = field(default_factory=list)