agents

type ArchiveReader interface {
	// ReadManifest reads manifest.json from the archive.
	ReadManifest(path string) (*SessionManifest, error)
	// ExtractSubtree extracts the requested archive subtree into dst.
	ExtractSubtree(path, archivePath, dst string) error
	// Contains reports whether the requested archive subtree exists.
	Contains(path, archivePath string) (bool, error)
}

type ArchiveStore interface {
	// Download fetches an archive and stores it under a temporary provider path.
	Download(ctx context.Context, url, runID string, provider console.AgentRuntimeType) (*DownloadedArchive, error)
	// Finalize moves the archive under the provider directory recorded by the manifest.
	Finalize(download *DownloadedArchive, runID string, provider console.AgentRuntimeType) (*DownloadedArchive, error)
}

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

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

type Command interface {
	// Run executes command with inherited stdio.
	Run(ctx context.Context, command string, args ...string) error
	// Output executes command and returns trimmed combined output.
	Output(ctx context.Context, command string, args ...string) (string, error)
}

type Confirmer interface {
	// Confirm asks a yes/no question and returns the selected value.
	Confirm(message string, def bool) (bool, error)
}

type DirectoryPrompter interface {
	// Directory asks the user for an existing directory path.
	Directory(message, def string) (string, error)
}

type DownloadedArchive struct {
	// Path is the local archive file path.
	Path string
	// WorkDir is the directory containing the archive and temporary restore data.
	WorkDir string
}

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

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

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

type Interaction interface {
	Confirmer
	Selector
	DirectoryPrompter
}

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

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

type OverwritePrompt func(path string) (bool, error)

type PreparedSession struct {
	// RepoPath is the local repository where the provider resume command runs.
	RepoPath string
	// WorkDir is the local directory containing restored provider files.
	WorkDir string
	// SessionID is the provider-specific session identifier to resume.
	SessionID string
}

type Repository interface {
	// Prepare checks out or creates the branch that should be used for resume.
	Prepare(ctx context.Context, run *console.AgentRunMinimalFragment, bundle *SessionBundle, repoPath string) (string, error)
	// ValidateRepository verifies the local repository origin matches the session manifest.
	ValidateRepository(repoPath string, manifest *SessionManifest) error
	// Validate verifies the local repository matches the session manifest.
	Validate(repoPath string, manifest *SessionManifest) error
}

type RestoreOptions struct {
	// RepoPath is the selected local repository checkout.
	RepoPath string
	// ArchivePath is the local path to the downloaded session archive.
	ArchivePath string
	// WorkDir is the local directory used for extracted restore data.
	WorkDir string
	// Manifest is the validated session manifest from the archive.
	Manifest *SessionManifest
	// Interaction prompts before overwriting existing provider session data.
	Interaction Confirmer
	// ConfirmOverwrite overrides overwrite prompting for tests and custom flows.
	ConfirmOverwrite OverwritePrompt
}

type RestorerRegistry interface {
	// ForProvider returns the restorer registered for provider.
	ForProvider(provider console.AgentRuntimeType) (SessionRestorer, error)
}

type Selector interface {
	// Select asks the user to choose one option from the supplied list.
	Select(message string, options []string) (string, error)
}

type SessionBundle struct {
	// Run is the minimal console run metadata needed for local resume.
	Run *console.AgentRunMinimalFragment
	// Manifest is the validated manifest read from the session archive.
	Manifest *SessionManifest
	// ArchivePath is the local path to the finalized session archive.
	ArchivePath string
	// WorkDir is the local working directory used while restoring the session.
	WorkDir string
}

type SessionManifest struct {
	// Version is the manifest schema version.
	Version int `json:"version"`
	// AgentRunID is the console agent run that produced the archive.
	AgentRunID string `json:"agentRunId"`
	// Provider identifies the runtime whose local state is stored in the archive.
	Provider console.AgentRuntimeType `json:"provider"`
	// Repository is the git remote URL expected for the local checkout.
	Repository string `json:"repository"`
	// Branch is the expected local branch after repository preparation.
	Branch string `json:"branch,omitempty"`
	// Session describes where provider-specific session state is stored.
	Session SessionMetadata `json:"session"`
}

type SessionMetadata struct {
	// ID is the provider-specific session identifier used by resume commands.
	ID string `json:"id,omitempty"`
	// Path is the original provider session path recorded by the runtime.
	Path string `json:"path,omitempty"`
	// ArchivePath is the subtree in the archive containing session files.
	ArchivePath string `json:"archivePath,omitempty"`
}

type SessionRestorer interface {
	// Provider returns the console runtime type this restorer supports.
	Provider() console.AgentRuntimeType
	// Prepare restores provider state from the archive into local files.
	Prepare(ctx context.Context, opts RestoreOptions) (*PreparedSession, error)
	// Resume launches the provider-specific resume command.
	Resume(ctx context.Context, prepared *PreparedSession) error
}

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

type SessionServiceOption func(*SessionService)

type SurveyInteraction struct{}

type TarGzipArchiveReader struct{}