cli

type AppArgs struct {
	Config *config.Config
	Stdin  io.Reader
	Stdout io.Writer
	// RuntimeURL 是 --url 指定的 Runtime Server 地址；为空时 getRuntimeConnection 依次用 client.url、本机 serve（没有就自动拉起）。
	RuntimeURL string
	// Stderr 接收 serve、acp 和 app-server 的文本日志，以及客户端的旧 serve 提示；codex 子进程使用它，正常退出后追加重连提示。TUI 不使用。
	Stderr io.Writer
	// Version 是程序版本，写入遥测的 service.version。
	Version string
	// IdleTimeout 是 serve 的隐藏参数 --idle-timeout：大于 0 时没有连接且没有 Turn 在执行这么久后 serve 自己退出；为 0 时常驻。
	IdleTimeout time.Duration
	// ConfigFlags 保存显式传入的配置文件、Agent 目录、模型目录和 Agent 名称，格式为 --name=value；仅配置文件转为绝对路径。自动启动 serve 时原样传入，不含 Codex 的 -c/--config。
	ConfigFlags []string
	// Executable 是当前进程的可执行文件路径，客户端用它自动拉起 serve；取不到时为空，拉起 serve 会失败。
	Executable string
	// ConfigPath 是读取的配置文件的绝对路径（--config-file、OPENVAALA_CONFIG 或默认位置）；app-server 把它所在目录交给 Codex 客户端。
	ConfigPath string
	// ConfigOpt 是加载 Config 用的选项；serve 把它交给 config.ConfigFiles，重新加载时用同一个配置路径和 flag。
	ConfigOpt *config.LoadConfigOpt
	// AppServerListen 是 app-server 的 --listen，默认 stdio://。
	AppServerListen string
	// IsAppServerStdio 是否传入了 --stdio？
	IsAppServerStdio bool
	// PrintAppServerStartupConfig 是否只输出 Codex 桌面启动检查需要的 JSON，然后退出？
	PrintAppServerStartupConfig bool
	// UnsupportedWebSocketFlags 是 app-server 收到的 codex WebSocket 认证参数名（--ws-auth 等）：OpenVaala 不支持，出现就报错。
	UnsupportedWebSocketFlags []string
	// IgnoredCodexFlags 是用户传入的 codex 参数名（-c/--config、--enable、--disable、--strict-config，
	// 以及 app-server 的分析、code-mode、remote-control 和启动客户端、退出登录参数）；普通 app-server 启动时写一条 Debug 日志。
	IgnoredCodexFlags []string
	// CodexRootArguments 是用户传入的 codex 根命令参数，按 codex 的写法排好（-c k=v、--enable x、--disable y、--strict-config）；
	// openvaala codex 把它们交给 codex，app-server 等命令收下不用。
	CodexRootArguments []string
	// CodexArguments 是 openvaala codex 之后的参数（codex 自己的参数写在 -- 之后），接在 CodexRootArguments 之后交给 codex；
	// codex app 时是可选的一个工作目录。其他命令不收位置参数，为空。
	CodexArguments []string
}

type CLIFlags struct {
	ConfigFilePath  string
	AgentsDirectory string
	ModelsDirectory string
	AgentName       string
}

type CLIOpt struct {
	Stdout  io.Writer
	Stderr  io.Writer
	Version string
}

type RuntimeServerConnection struct {
	URL   string `yaml:"url"`
	Token string `yaml:"token"`
	// Executable 是 serve 的可执行文件路径（软链接已解析），取不到时为空；客户端拿它和自己的可执行文件比较，发现升级或重新编译前的旧 serve。
	Executable string `yaml:"executable"`
	// ExecutableModifiedAt 是 serve 启动时 Executable 的修改时间，取不到时为零值。
	ExecutableModifiedAt time.Time `yaml:"executable_modified_at"`
	// ServerID 标识这台机器上的 serve，重启后沿用；客户端读到的和 initialize 返回的一致时，两边用的是同一个文件系统。
	ServerID string `yaml:"server_id"`
}

type RuntimeServerStartOpt struct {
	Executable  string
	ConfigFlags []string
	IdleTimeout time.Duration
	LogFile     string
}