installer

type Action string

type Engine struct{}

type Inspection struct {
	StateRoot       string `json:"state_root"`
	HasTransaction  bool   `json:"has_transaction"`
	HasResult       bool   `json:"has_result"`
	State           string `json:"state,omitempty"`
	TransactionID   string `json:"transaction_id,omitempty"`
	Action          string `json:"action,omitempty"`
	Version         string `json:"version,omitempty"`
	ActiveVersion   string `json:"active_version,omitempty"`
	LocalMCPURL     string `json:"local_mcp_url,omitempty"`
	PublicURL       string `json:"public_url,omitempty"`
	Healthy         bool   `json:"healthy"`
	ManifestPath    string `json:"manifest_path,omitempty"`
	HasUnixManifest bool   `json:"has_unix_manifest"`
	HasWinManifest  bool   `json:"has_windows_manifest"`
	// Windows generation pointer 与 self-update 事务的权威评估。
	// Setup/卸载脚本必须消费这些结构化结论，不得自行解析 active-version.json
	// 或 update/transaction.json 再解释状态。pointer 缺失时是 missing，
	// 存在但读不出来/结构非法时是 invalid，其余透传 pointer 内的 state。
	PointerState             string `json:"pointer_state,omitempty"`
	PointerActiveVersion     string `json:"pointer_active_version,omitempty"`
	PointerFallbackVersion   string `json:"pointer_fallback_version,omitempty"`
	PendingUpdateTransaction bool   `json:"pending_update_transaction"`
}

type OptionalString struct {
	Set   bool
	Value string
}

type Phase string

type Request struct {
	Action Action

	InstallRoot        string
	RuntimeRoot        string
	RuntimeRootLiteral string
	PayloadDir         string
	BinaryPath         string
	LiveBinary         string
	SkillBundle        string
	Version            string
	Channel            string

	Host     string
	Port     int
	LogLevel string

	TunnelMode      string
	ServerURL       string
	TunnelToken     string
	TunnelTokenFile string
	CloudflaredPath string

	ServiceName     string
	ServiceUser     string
	ServiceGroup    string
	ServiceManager  string
	DataDir         string
	SystemdDir      string
	OpenRCDir       string
	LaunchAgentsDir string

	AuthToken        OptionalString
	OAuthPassword    OptionalString
	OAuthTokenSecret OptionalString
	RotateOAuth      bool

	RegisterService bool
	StartService    bool
	NonInteractive  bool

	PurgeConfig bool
	PurgeData   bool

	PrivilegeMode               string
	AgentDockHome               string
	AgentDockDefaultDir         string
	TaskName                    string
	StartupValueName            string
	TrayStartupValueName        string
	CloudflaredStartupValueName string

	SkipHealth      bool
	SkipSkills      bool
	SkipServiceUser bool
	NoPrivilege     bool

	// DeferCommit 让 install/repair 在 verify 完成后停在 trial。
	// Windows 脚本还要写 HKCU/Task/tray；那些完成之前不能出现 committed。
	DeferCommit bool
	// MarkHealthy 只给外层 OS adapter 的 commit 使用：adapter 已经完成自己的 health-check，
	// Engine 不重复探测，只把这个已验证事实投影到权威 Result。
	MarkHealthy bool
	// RollbackFailed 只给 abandon 用：外部 rollback 没做完，禁止宣称 rolled_back。
	RollbackFailed bool
	// TransactionID 绑定 commit/abandon 到明确的 install 事务，不能拿上一笔 result.json 冒充成功。
	TransactionID string
}

type Result struct {
	SchemaVersion   int                `json:"schema_version"`
	TransactionID   string             `json:"transaction_id"`
	Platform        string             `json:"platform"`
	Action          Action             `json:"action"`
	State           updateengine.State `json:"state"`
	Phase           Phase              `json:"phase"`
	Version         string             `json:"version"`
	ActiveVersion   string             `json:"active_version,omitempty"`
	FallbackVersion string             `json:"fallback_version,omitempty"`
	LocalMCPURL     string             `json:"local_mcp_url,omitempty"`
	PublicURL       string             `json:"public_url,omitempty"`
	Healthy         bool               `json:"healthy"`
	PrivilegeMode   string             `json:"privilege_mode,omitempty"`
	// TaskName 只在 uninstall Result 里返回：engine 解析后的计划任务名是 Windows
	// adapter 删除任务的单一来源，脚本不得再自行解析 runtime.json 重复判定。
	TaskName    string                `json:"task_name,omitempty"`
	Failure     *updateengine.Failure `json:"failure,omitempty"`
	Warnings    []string              `json:"warnings,omitempty"`
	StartedAt   time.Time             `json:"started_at"`
	CompletedAt time.Time             `json:"completed_at"`
}

type Store struct {
	// contains filtered or unexported fields
}

type Transaction struct {
	SchemaVersion   int                `json:"schema_version"`
	TransactionID   string             `json:"transaction_id"`
	Platform        string             `json:"platform"`
	Action          Action             `json:"action"`
	SourceVersion   string             `json:"source_version,omitempty"`
	TargetVersion   string             `json:"target_version"`
	ActiveVersion   string             `json:"active_version,omitempty"`
	FallbackVersion string             `json:"fallback_version,omitempty"`
	State           updateengine.State `json:"state"`
	Phase           Phase              `json:"phase"`
	InstallRoot     string             `json:"install_root"`
	RuntimeRoot     string             `json:"runtime_root"`
	// PurgeConfig / PurgeData 是 uninstall 的事务意图。trial 重入必须逐项匹配，
	// 否则同一 transaction 会在第二次请求下执行比首次承诺更强或更弱的清理。
	PurgeConfig         bool                  `json:"purge_config,omitempty"`
	PurgeData           bool                  `json:"purge_data,omitempty"`
	ServiceUser         string                `json:"service_user,omitempty"`
	AgentDockHome       string                `json:"agentdock_home,omitempty"`
	AgentDockDefaultDir string                `json:"agentdock_default_dir,omitempty"`
	StartedAt           time.Time             `json:"started_at"`
	UpdatedAt           time.Time             `json:"updated_at"`
	CompletedAt         *time.Time            `json:"completed_at,omitempty"`
	Failure             *updateengine.Failure `json:"failure,omitempty"`
	Warnings            []string              `json:"warnings,omitempty"`
}