opencodeinstall

Documentation

Overview

Package opencodeinstall owns the explicit OpenCode notification lifecycle.

Index

• Constants
• func Apply(ctx context.Context, r Request) error
• func ChannelsFromSnapshot(s installruntime.PolicySnapshot, executable, goos, goarch string) (bool, bool)
• func PrepareNativeSpool(context.Context, string) (string, error)
• func PrepareNativeSpoolFor(context.Context, string, DesktopProduct) (string, error)
• func RegisteredFromSnapshot(s installruntime.PolicySnapshot, executable, goos, goarch string) bool
• func RevokeChannels(ctx context.Context, controlRoot, runtimeRoot string) error
• func SetupPermission(context.Context, string, bool) (string, error)
• func StageWindowsShortcut(DesktopProduct, string, string, bool, installruntime.Ledger) (*installruntime.File, error)
• func WindowsShortcutReadyFor(DesktopProduct, string, string) error
• type Action
• type BundleRenderer
• type CurrentGate
  • func (g CurrentGate) Channels(ctx context.Context) (bool, bool)
  • func (g CurrentGate) Enabled(ctx context.Context) bool
• type DesktopProduct
• type RegistrationLease
  • func AcquireRegistration(ctx context.Context, root string, expected installruntime.PolicySnapshot, ...) (*RegistrationLease, error)
  • func (l *RegistrationLease) Channels() (bool, bool)
  • func (l *RegistrationLease) Close()
  • func (l *RegistrationLease) Registration() installruntime.OpenCodeRegistration
• type Request
  • func DefaultRequest(action Action) Request

Constants

const (
	OpenCodeDesktop DesktopProduct = iota + 1
	GeminiDesktop
	CopilotVSCodeDesktop
	OpenCodeToastAppID      = "Genius.AgentNotifications.OpenCode"
	GeminiToastAppID        = "Genius.AgentNotifications.Gemini"
	CopilotVSCodeToastAppID = "Genius.AgentNotifications.CopilotVSCode"
	GeminiConsumerID        = "gemini-notifications"
)

Functions

func Apply

func Apply(ctx context.Context, r Request) error

func ChannelsFromSnapshot

func ChannelsFromSnapshot(s installruntime.PolicySnapshot, executable, goos, goarch string) (bool, bool)

ChannelsFromSnapshot validates OpenCode ownership and explicit consent in an already-read policy snapshot. It is safe to use inside a setup/native lease callback after the caller revalidates that snapshot under the component lock.

func PrepareNativeSpool

func PrepareNativeSpool(context.Context, string) (string, error)

func PrepareNativeSpoolFor

func PrepareNativeSpoolFor(context.Context, string, DesktopProduct) (string, error)

func RegisteredFromSnapshot

func RegisteredFromSnapshot(s installruntime.PolicySnapshot, executable, goos, goarch string) bool

RegisteredFromSnapshot checks the owned OpenCode command without requiring desktop consent, so explicit permission setup can precede channel enablement.

func RevokeChannels

func RevokeChannels(ctx context.Context, controlRoot, runtimeRoot string) error

RevokeChannels turns off only OpenCode's two channel consents. It is the first removal step and remains available when a delivery asset is missing or damaged; cleanup may report its own conflict afterward.

func SetupPermission

func SetupPermission(context.Context, string, bool) (string, error)

func StageWindowsShortcut

func StageWindowsShortcut(DesktopProduct, string, string, bool, installruntime.Ledger) (*installruntime.File, error)

func WindowsShortcutReadyFor

func WindowsShortcutReadyFor(DesktopProduct, string, string) error

Types

type Action

type Action string

const (
	Install Action = "install"
	Update  Action = "update"
	Remove  Action = "remove"
	Recover Action = "recover"
)

type BundleRenderer

type BundleRenderer interface {
	RenderRegistration(executable, controlRoot, origin string) ([]byte, error)
}

BundleRenderer is the setup-only E2 port for the third fixed origin token. A nil renderer keeps legacy placement usable, without admitting its frames.

type CurrentGate

type CurrentGate struct{ ControlRoot, Executable, GOOS, GOARCH string }

CurrentGate reads the product registration on each event. No recovery or config mutation occurs on this observation path.

func (CurrentGate) Channels

func (g CurrentGate) Channels(ctx context.Context) (bool, bool)

func (CurrentGate) Enabled

func (g CurrentGate) Enabled(ctx context.Context) bool

type DesktopProduct

type DesktopProduct uint8

DesktopProduct selects an installer-owned observer identity. Config and native event data cannot supply an AUMID, shortcut or namespace.

type RegistrationLease

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

RegistrationLease can only be constructed by exact kernel lease validation. Native references retain the same fence; there is no reacquisition or bypass.

func AcquireRegistration

func AcquireRegistration(ctx context.Context, root string, expected installruntime.PolicySnapshot, executable, goos, goarch, origin string) (*RegistrationLease, error)

func (*RegistrationLease) Channels

func (l *RegistrationLease) Channels() (bool, bool)

func (*RegistrationLease) Close

func (l *RegistrationLease) Close()

func (*RegistrationLease) Registration

func (l *RegistrationLease) Registration() installruntime.OpenCodeRegistration

type Request

type Request struct {
	Renderer                                  BundleRenderer
	Action                                    Action
	ControlRoot, RuntimeRoot, BinarySource    string
	NativeSource                              string
	HomeDir, XDGConfigHome, OpenCodeConfigDir string
	ChannelPreimage                           string
	Desktop, Webhook                          bool
	// Platform is supplied by the CLI. Tests use disposable platform fixtures.
	GOOS, GOARCH string
}

func DefaultRequest

func DefaultRequest(action Action) Request