android

type AppIdentity struct {
	Package string
	Variant string
	Name    string
}

type AppInfo struct {
	Package  string
	Activity string
	Label    string
}

type DispatchReceipt struct {
	Package  string
	Activity string
	Strategy string
}

type FailureReason string

type ForegroundState struct {
	BootID      string
	Permission  string
	SampledMs   int64
	ElapsedMs   int64
	Version     int
	Interactive bool
	Unlocked    bool
}

type Host interface {
	// InspectTarget reports whether the definition's package and activity are
	// installed and launchable. A nil error means they are; a *HostError says
	// why not.
	InspectTarget(definition *LaunchDefinition) error
	// InstalledCores lists the launcher core files the host found. scanned is
	// false when the host has not looked, which is not evidence of absence.
	InstalledCores() (files []string, scanned bool)
	// MediaFolders returns the references of the media folders Core may
	// index now. A folder whose grant was revoked is not listed.
	MediaFolders(ctx context.Context) ([]string, error)
	// ReadMediaDir lists the directory at segments below the folder named by
	// reference; no segments lists the folder itself.
	ReadMediaDir(ctx context.Context, reference string, segments []string) ([]platforms.SourceEntry, error)
	// ReadFile returns up to limit+1 bytes of the file at segments below the
	// folder named by reference, so an oversized file is detectable. It is
	// used only at launch, to read the small amount of a media file's own
	// content a launch needs; indexing never reads a file's content.
	ReadFile(ctx context.Context, reference string, segments []string, limit int64) ([]byte, error)
	// Dispatch starts a validated definition for the file at segments below
	// the folder named by reference. Cancelling ctx abandons a dispatch in
	// flight. A *HostError says why the host refused.
	Dispatch(
		ctx context.Context,
		definition *LaunchDefinition,
		reference string,
		segments []string,
	) (DispatchReceipt, error)
	// InstalledApps lists the launchable apps the host found. scanned is false
	// when the host has not looked, which is not evidence of absence.
	InstalledApps() (apps []AppInfo, scanned bool)
	// AppIcon returns a readable, app-private PNG for a launchable package.
	// An unavailable icon is not evidence that the app is absent.
	AppIcon(packageName string) (path string, err error)
	// DispatchApp starts a definition that carries no media. A *HostError says
	// why the host refused.
	DispatchApp(definition *LaunchDefinition) (DispatchReceipt, error)
	// ForegroundState reads a fresh framework snapshot: boot identity, Usage
	// Access permission, and screen/keyguard state, on both the wall and
	// elapsed clocks. It is read fresh before every dispatch and
	// reconciliation pass; the platform never caches it.
	ForegroundState() (ForegroundState, error)
	// ForegroundEvents queries a bounded window of privacy-filtered
	// foreground evidence for one already-dispatched launch's whole
	// package - never a specific activity, so an intent that forwards
	// through more than one activity of the same app still reads as one
	// session. Cancelling ctx abandons a query in flight.
	ForegroundEvents(
		ctx context.Context, launchID, target string, fromMs, toMs int64,
	) (database.ForegroundEvidence, error)
}

type HostError struct {
	Reason FailureReason
}

type HostReturn struct {
	// ObserverStartedElapsedMs is when the UI process now reporting started.
	// A launch dispatched before it came from a process that died, so no
	// return can ever be observed for it. Zero when unknown.
	ObserverStartedElapsedMs int64
	// ReturnedWallMs and ReturnedElapsedMs are the earliest launcher resume
	// the host has not yet delivered. Zero when there was none.
	ReturnedWallMs    int64
	ReturnedElapsedMs int64
}

type LaunchDefinition struct {
	ID            string `json:"id"`
	Name          string `json:"name,omitempty"`
	Variant       string `json:"variant,omitempty"`
	System        string `json:"system"`
	Package       string `json:"package"`
	Activity      string `json:"activity"`
	Action        string `json:"action"`
	Strategy      string `json:"strategy"`
	StorageAccess string `json:"storageAccess"`
	Repair        string `json:"repair"`
	DataSource    string `json:"dataSource,omitempty"`
	// Data is an Intent data URI, set only at dispatch from a file the
	// definition itself carries no reference to. Reserved for the one
	// package whose exported activity reads its target from Intent data
	// (scummVMPackage); every other definition must leave it empty.
	Data         string        `json:"data,omitempty"`
	Extensions   []string      `json:"extensions"`
	Extras       []LaunchExtra `json:"extras,omitempty"`
	Version      int           `json:"version"`
	MaxTargetSDK int           `json:"maxTargetSdk,omitempty"`
	GrantReadURI bool          `json:"grantReadUri,omitempty"`
	ClipData     bool          `json:"clipData,omitempty"`
}

type LaunchExtra struct {
	Name   string `json:"name"`
	Type   string `json:"type"`
	Source string `json:"source"`
	Suffix string `json:"suffix,omitempty"`
	Value  string `json:"value,omitempty"`
}

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