agentvisor

package module

Go to main page

Versions in this module

v0

v0.4.4

Nov 5, 2026

v0.4.3

Nov 2, 2026

v0.4.2

Nov 1, 2026

v0.4.1

Nov 1, 2026

v0.4.0

Nov 1, 2026

Changes in this version

type Client

+ func (c *Client) Purge(ctx context.Context, p PurgeSpec) error

type Options

+ KeepFragments time.Duration

+ type PurgeSpec struct

+ Harness string

+ Session string

+ VendorID string

+ func (p PurgeSpec) Validate() error

type StartSpec

+ LogFragments bool

type Visor

+ func (v *Visor) Purge(ctx context.Context, p PurgeSpec) error

v0.3.3

Nov 1, 2026

v0.3.2

Nov 1, 2026

v0.3.1

Nov 1, 2026

v0.3.0

Nov 1, 2026

Changes in this version

+ type Catalog interface

+ Folders func(ctx context.Context) ([]string, error)

+ type Discoverer interface

+ Adopt func(ctx context.Context, s Session, key string) (Handle, error)

+ Found func() <-chan Found

+ type Found struct

+ Dir string

+ Harness string

+ Key string

+ Labels map[string]string

+ Title string

type HookCall

+ Labels map[string]string

+ type Labeler interface

+ Labels func() map[string]string

+ type TextTerminal interface

+ Keys func(ctx context.Context, data []byte) error

+ Output func(ctx context.Context) (string, error)

+ Paste func(ctx context.Context, text string) error

+ Screen func(ctx context.Context) (Screen, error)

v0.2.1

Oct 31, 2026

v0.2.0

Oct 31, 2026

Changes in this version

+ const LoginBrowser

+ const LoginCode

+ const LoginDone

+ const LoginFailed

+ const LoginStarting

+ const LoginVerifying

+ const OwnFromBackup

+ const OwnFromEmpty

+ const OwnFromUser

+ const SideHome

+ const SideUser

+ const UpdatesAuto

+ const UpdatesKeep

+ var ErrStale = errors.New("agentvisor: changed since the read")

type Client

+ func (c *Client) CancelHarnessLogin(ctx context.Context, name string) error

+ func (c *Client) CheckHarnesses(ctx context.Context) error

+ func (c *Client) HarnessFiles(ctx context.Context, name string) ([]HomeFile, error)

+ func (c *Client) HarnessLogin(ctx context.Context, name string) (Login, error)

+ func (c *Client) HarnessLoginCode(ctx context.Context, name, code string) (Login, error)

+ func (c *Client) HarnessLoginToken(ctx context.Context, name, token string) (Harness, error)

+ func (c *Client) OwnHarnessFile(ctx context.Context, name, key string, start OwnStart) (HomeFile, error)

+ func (c *Client) ReadHarnessFile(ctx context.Context, name, key, side string) (FileContent, error)

+ func (c *Client) SetHarnessUpdates(ctx context.Context, name string, mode UpdateMode, version string) (Harness, error)

+ func (c *Client) ShareHarnessFile(ctx context.Context, name, key string) (HomeFile, error)

+ func (c *Client) WriteHarnessFile(ctx context.Context, name, key, content, ifMatch string) (FileContent, error)

+ type FileContent = harness.FileContent

+ type HarnessPolicy = harness.Policy

+ type HarnessUpdate = harness.Update

+ type HomeFile = harness.HomeFile

+ type LoginPhase = harness.LoginPhase

+ type LoginSpec = harness.LoginSpec

+ type OwnStart = harness.OwnStart

+ type UpdateMode = harness.UpdateMode

type Visor

+ func (v *Visor) CancelHarnessLogin(ctx context.Context, name string) error

+ func (v *Visor) CheckHarnesses(ctx context.Context) error

+ func (v *Visor) HarnessFiles(ctx context.Context, name string) ([]HomeFile, error)

+ func (v *Visor) HarnessLogin(ctx context.Context, name string) (Login, error)

+ func (v *Visor) HarnessLoginCode(ctx context.Context, name, code string) (Login, error)

+ func (v *Visor) HarnessLoginToken(ctx context.Context, name, token string) (Harness, error)

+ func (v *Visor) OwnHarnessFile(ctx context.Context, name, key string, start OwnStart) (HomeFile, error)

+ func (v *Visor) ReadHarnessFile(ctx context.Context, name, key, side string) (FileContent, error)

+ func (v *Visor) SetHarnessUpdates(ctx context.Context, name string, mode UpdateMode, version string) (Harness, error)

+ func (v *Visor) ShareHarnessFile(ctx context.Context, name, key string) (HomeFile, error)

+ func (v *Visor) WriteHarnessFile(ctx context.Context, name, key, content, ifMatch string) (FileContent, error)

v0.1.2

Oct 30, 2026

v0.1.1

Oct 30, 2026

v0.1.0

Oct 30, 2026

Changes in this version

+ const AuthExpired

+ const AuthMissing

+ const AuthOK

+ const AuthSeparate

+ const AuthShared

+ const AuthUnknown

+ const EnvPort

+ const EnvSession

+ const EnvSocket

+ const EnvWorkdir

+ const HookInstalled

+ const HookMissing

+ const HookOutdated

+ const HookUntrusted

+ const MaxInFlight

+ const Protocol

+ const SourceSystem

+ const SourceVisor

+ const WorkdirActive

+ const WorkdirArchived

+ const WorkdirFolder

+ const WorkdirMain

+ const WorkdirWorktree

+ var ErrBusy = errors.New("agentvisor: busy")

+ var ErrClosed = errors.New("agentvisor: closed")

+ var ErrInvalid = errors.New("agentvisor: invalid request")

+ var ErrNotFound = errors.New("agentvisor: not found")

+ var ErrProtocol = errors.New("agentvisor: unknown protocol")

+ var ErrState = errors.New("agentvisor: wrong session state")

+ var ErrUnsupported = errors.New("agentvisor: not supported")

+ func Listen(ctx context.Context, socket string) (net.Listener, error)

+ func ParseLabel(s string) (string, string, error)

+ func Serve(ctx context.Context, v *Visor, socket string) error

+ func ServeListener(ctx context.Context, v *Visor, ln net.Listener) error

+ type Answer struct

+ Allow bool

+ Message string

+ UpdatedInput json.RawMessage

+ type AttachOptions struct

+ After uint64

+ Cols int

+ Rows int

+ View AttachView

+ type AttachStream struct

+ func (a *AttachStream) Close() error

+ func (a *AttachStream) Handle(ctx context.Context, f ClientFrame) error

+ func (a *AttachStream) Input(ctx context.Context, p []byte) error

+ func (a *AttachStream) Recv(ctx context.Context) (Frame, error)

+ func (a *AttachStream) View() AttachView

+ type AttachView string

+ const ViewChat

+ const ViewTerminal

+ type Attachment struct

+ Data []byte

+ MIME string

+ Path string

+ type AuthMode = harness.AuthMode

+ type AuthState = harness.AuthState

+ type Backend interface

+ Caps func(harness string) Caps

+ Close func(ctx context.Context) error

+ Kind func() Kind

+ Recover func(ctx context.Context) ([]Handle, error)

+ Start func(ctx context.Context, l Launch) (Handle, error)

+ type Caps struct

+ Permissions bool

+ Resume bool

+ Steer bool

+ Structured bool

+ Survives bool

+ Terminal bool

+ type Client struct

+ func Dial(ctx context.Context, socket string) (*Client, error)

+ func (c *Client) Answer(ctx context.Context, id, requestID string, a Answer) error

+ func (c *Client) ArchiveWorkdir(ctx context.Context, id string) error

+ func (c *Client) Attach(ctx context.Context, id string, o AttachOptions) (*AttachStream, error)

+ func (c *Client) Close(context.Context) error

+ func (c *Client) EnsureWorkdir(ctx context.Context, w WorkdirSpec) (Workdir, error)

+ func (c *Client) Events(ctx context.Context, f Filter, after uint64) (*EventStream, error)

+ func (c *Client) ForgetProject(ctx context.Context, id string) error

+ func (c *Client) Handover(ctx context.Context, id string, to Kind) error

+ func (c *Client) Harness(ctx context.Context, name string) (Harness, error)

+ func (c *Client) HarnessModels(ctx context.Context, name string) ([]Model, error)

+ func (c *Client) Harnesses(ctx context.Context) ([]Harness, error)

+ func (c *Client) Hello(ctx context.Context, h Hello) (Info, error)

+ func (c *Client) Hook(ctx context.Context, call HookCall) (Session, error)

+ func (c *Client) Hooks(ctx context.Context, spec HookSpec) ([]HookStatus, error)

+ func (c *Client) Info(ctx context.Context) (Info, error)

+ func (c *Client) InstallHarness(ctx context.Context, name, version string) (Harness, error)

+ func (c *Client) InstallHooks(ctx context.Context, spec HookSpec) ([]HookStatus, error)

+ func (c *Client) Interrupt(ctx context.Context, id string) error

+ func (c *Client) Keys(ctx context.Context, id string, data []byte) error

+ func (c *Client) LoginHarness(ctx context.Context, name string) (Login, error)

+ func (c *Client) LogoutHarness(ctx context.Context, name string) error

+ func (c *Client) Output(ctx context.Context, id string) (string, error)

+ func (c *Client) Paste(ctx context.Context, id, text string) error

+ func (c *Client) Projects(ctx context.Context, f Filter) ([]Project, error)

+ func (c *Client) RemoveHooks(ctx context.Context, spec HookSpec) ([]HookStatus, error)

+ func (c *Client) RemoveWorkdir(ctx context.Context, id string, force bool) error

+ func (c *Client) RestoreWorkdir(ctx context.Context, id string) (Workdir, error)

+ func (c *Client) Screen(ctx context.Context, id string) (Screen, error)

+ func (c *Client) Send(ctx context.Context, id string, in Input) (Delivery, error)

+ func (c *Client) Session(ctx context.Context, id string) (Session, error)

+ func (c *Client) Sessions(ctx context.Context, f Filter) ([]Session, error)

+ func (c *Client) SetHarnessAuth(ctx context.Context, name string, mode AuthMode) (Harness, error)

+ func (c *Client) SetHarnessEnv(ctx context.Context, name string, env map[string]string) error

+ func (c *Client) Start(ctx context.Context, spec StartSpec) (Session, error)

+ func (c *Client) Stop(ctx context.Context, id string) error

+ func (c *Client) UpdateHarness(ctx context.Context, name, version string) (Harness, error)

+ func (c *Client) Upgrade(ctx context.Context, spec UpgradeSpec) (Info, error)

+ func (c *Client) Workdirs(ctx context.Context, f Filter) ([]Workdir, error)

+ type ClientFrame struct

+ After *uint64

+ Cols int

+ Data []byte

+ Rows int

+ Seq uint64

+ Text string

+ Type ClientFrameType

+ View AttachView

+ func DecodeClientFrame(isBinary bool, data []byte) (ClientFrame, error)

+ func (f ClientFrame) Encode() (isBinary bool, data []byte, err error)

+ func (f ClientFrame) Options() AttachOptions

+ type ClientFrameType string

+ const ClientAck

+ const ClientAttach

+ const ClientControl

+ const ClientInput

+ const ClientInterrupt

+ const ClientRelease

+ const ClientSend

+ type Delivery string

+ const DeliveryHeld

+ const DeliveryPrompted

+ const DeliverySteered

+ type EndReason string

+ const EndClosed

+ const EndExited

+ type Event struct

+ At time.Time

+ Code string

+ Data json.RawMessage

+ Delta bool

+ EndReason string

+ Error string

+ ExitCode *int

+ Harness string

+ Input bool

+ Limits *Limits

+ Request *Request

+ RequestID string

+ Result *Result

+ Seq uint64

+ Session string

+ State State

+ Status string

+ Text string

+ Tool *Tool

+ Turn int

+ Type EventType

+ Usage *Usage

+ VendorID string

+ func (e Event) Wire() (agentwire.Event, bool)

+ type EventStream struct

+ func (s *EventStream) C() <-chan Event

+ func (s *EventStream) Close() error

+ func (s *EventStream) Err() error

+ func (s *EventStream) Next(ctx context.Context) (Event, error)

+ type EventType string

+ const EventAssistant

+ const EventError

+ const EventExit

+ const EventHarnessChanged

+ const EventHook

+ const EventInit

+ const EventLimits

+ const EventRequest

+ const EventRequestClosed

+ const EventRestarting

+ const EventResult

+ const EventScript

+ const EventSessionState

+ const EventStatus

+ const EventThought

+ const EventTool

+ const EventUsage

+ const EventUser

+ type Filter struct

+ Key string

+ Kind Kind

+ Labels map[string]string

+ Project string

+ Role Role

+ Session string

+ States []State

+ Workdir string

+ type Frame struct

+ Code string

+ Cols int

+ Data []byte

+ From uint64

+ Holder LeaseHolder

+ Message string

+ Op FrameOp

+ Reason EndReason

+ Resizable bool

+ Rows int

+ Seq uint64

+ Source Kind

+ Title string

+ To uint64

+ Turns []Turn

+ Type FrameType

+ View AttachView

+ Writable bool

+ func DecodeFrame(isBinary bool, data []byte) (Frame, error)

+ func (f Frame) Binary() bool

+ func (f Frame) Encode() ([]byte, error)

+ type FrameOp byte

+ const OpInput

+ const OpOutput

+ const OpSnapshot

+ type FrameType string

+ const FrameAttached

+ const FrameEnded

+ const FrameError

+ const FrameLease

+ const FrameResized

+ const FrameTurns

+ type Handle interface

+ Answer func(ctx context.Context, requestID string, a Answer) error

+ Close func(ctx context.Context) error

+ Events func() <-chan Event

+ Interrupt func(ctx context.Context) error

+ PID func() int

+ Send func(ctx context.Context, in Input) (Delivery, error)

+ Session func() string

+ VendorID func() string

+ type Harness = harness.Harness

+ type HarnessFacts = harness.Facts

+ type HarnessOptions = harness.Options

+ type HarnessSource = harness.Source

+ type Hello struct

+ Binary string

+ Build string

+ Client string

+ Protocol string

+ type HookCall struct

+ At time.Time

+ Harness string

+ Payload json.RawMessage

+ Session string

+ type HookSpec struct

+ Auth AuthMode

+ Dir string

+ Harnesses []string

+ type HookSpool struct

+ func NewHookSpool(home string) *HookSpool

+ func (s *HookSpool) Write(c HookCall) error

+ type HookState = hooks.State

+ type HookStatus struct

+ Auth AuthMode

+ Dir string

+ Harness string

+ State HookState

+ type Info struct

+ Build string

+ Client string

+ Home string

+ PID int

+ Protocol string

+ Seq uint64

+ Upgrade string

+ type Input struct

+ Attachments []Attachment

+ Kind string

+ Text string

+ type Kind string

+ const KindObserved

+ const KindPTY

+ const KindWire

+ type Launch struct

+ Binary string

+ Dir string

+ Env map[string]string

+ Home string

+ Prompt *Input

+ Resume bool

+ Session Session

+ Spec StartSpec

+ type LeaseHolder string

+ const LeaseNone

+ const LeaseOther

+ const LeaseYou

+ type LimitWindow = harness.LimitWindow

+ type Limits = harness.Limits

+ type Login = harness.Login

+ type MCPServer struct

+ Args []string

+ Command string

+ Env map[string]string

+ Headers map[string]string

+ Name string

+ URL string

+ type Model = harness.Model

+ type Options struct

+ Backends []Backend

+ Build string

+ Client string

+ ClientVersion string

+ Drivers map[string]agentwire.Driver

+ Env map[string]string

+ Exec func(binary string, args, env []string) error

+ Harness HarnessOptions

+ HolderCommand []string

+ Home string

+ HookCommand []string

+ KeepExited time.Duration

+ Logger *slog.Logger

+ Now func() time.Time

+ Socket string

+ TerminalCommand TerminalCommand

+ UpgradeWait time.Duration

+ type Permissions struct

+ AllowTools []string

+ Mode agentwire.PermissionMode

+ type Project = workdir.Project

+ type Request struct

+ ID string

+ Input string

+ Kind string

+ Options []string

+ Question string

+ Tool string

+ ToolUseID string

+ type RestartMode string

+ const RestartNotify

+ const RestartResume

+ type RestartPolicy struct

+ Mode RestartMode

+ Prompt string

+ type Result struct

+ Code string

+ EndReason string

+ IsError bool

+ Subtype string

+ Text string

+ Usage Usage

+ VendorID string

+ type Role string

+ const RoleAgent

+ const RoleScript

+ const RoleShell

+ type Screen struct

+ Cols int

+ CursorCol int

+ CursorRow int

+ Lines []string

+ Rows int

+ type Server struct

+ func NewServer(v *Visor) *Server

+ func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

+ type Session struct

+ CreatedAt time.Time

+ Effort string

+ EnvKeys []string

+ Error string

+ ExitCode *int

+ Harness string

+ ID string

+ Kind Kind

+ Labels map[string]string

+ Model string

+ PID int

+ Pending []Request

+ Project string

+ Restart RestartPolicy

+ Role Role

+ Seq uint64

+ State State

+ Title string

+ Turns int

+ UpdatedAt time.Time

+ VendorID string

+ Workdir string

+ WorkingDir string

+ type Skill struct

+ Dir string

+ Name string

+ type StartSpec struct

+ Binary string

+ Command []string

+ Effort string

+ Env map[string]string

+ ExtraArgs []string

+ Harness string

+ Instructions string

+ Kind Kind

+ Labels map[string]string

+ MCPServers []MCPServer

+ Model string

+ Permissions Permissions

+ Prompt string

+ Raw map[string]any

+ Restart RestartPolicy

+ ResumeID string

+ Role Role

+ Skills []Skill

+ Title string

+ Workdir string

+ WorkingDir string

+ func (s StartSpec) Validate() error

+ type State string

+ const StateExited

+ const StateIdle

+ const StateLost

+ const StateRunning

+ const StateStarting

+ const StateSuspended

+ const StateWaiting

+ func (s State) Busy() bool

+ func (s State) CanMove(to State) bool

+ func (s State) Live() bool

+ type TerminalCommand func(l Launch) ([]string, error)

+ type Tool struct

+ ExitCode *int

+ ID string

+ Input string

+ Kind string

+ Name string

+ Output string

+ Paths []string

+ Status string

+ type Turn struct

+ At time.Time

+ Role TurnRole

+ Seq uint64

+ Text string

+ Tool *Tool

+ type TurnRole string

+ const TurnAssistant

+ const TurnResult

+ const TurnTool

+ const TurnUser

+ type UpgradeSpec struct

+ Binary string

+ Build string

+ Protocol string

+ type Usage struct

+ CacheCreation int64

+ CacheRead int64

+ CostUSD float64

+ Input int64

+ Model string

+ Output int64

+ type Visor struct

+ func New(ctx context.Context, o Options) (*Visor, error)

+ func (v *Visor) Answer(ctx context.Context, id, requestID string, a Answer) error

+ func (v *Visor) ArchiveWorkdir(ctx context.Context, id string) error

+ func (v *Visor) Attach(_ context.Context, id string, o AttachOptions) (*AttachStream, error)

+ func (v *Visor) Close(ctx context.Context) error

+ func (v *Visor) EnsureWorkdir(ctx context.Context, w WorkdirSpec) (Workdir, error)

+ func (v *Visor) Events(ctx context.Context, f Filter, after uint64) (*EventStream, error)

+ func (v *Visor) ForgetProject(ctx context.Context, id string) error

+ func (v *Visor) Handover(ctx context.Context, id string, to Kind) error

+ func (v *Visor) Harness(ctx context.Context, name string) (Harness, error)

+ func (v *Visor) HarnessModels(ctx context.Context, name string) ([]Model, error)

+ func (v *Visor) Harnesses(ctx context.Context) ([]Harness, error)

+ func (v *Visor) Hello(ctx context.Context, h Hello) (Info, error)

+ func (v *Visor) Hook(ctx context.Context, c HookCall) (Session, error)

+ func (v *Visor) Hooks(ctx context.Context, spec HookSpec) ([]HookStatus, error)

+ func (v *Visor) Info(context.Context) (Info, error)

+ func (v *Visor) InstallHarness(ctx context.Context, name, version string) (Harness, error)

+ func (v *Visor) InstallHooks(ctx context.Context, spec HookSpec) ([]HookStatus, error)

+ func (v *Visor) Interrupt(ctx context.Context, id string) error

+ func (v *Visor) Keys(_ context.Context, id string, data []byte) error

+ func (v *Visor) LoginHarness(ctx context.Context, name string) (Login, error)

+ func (v *Visor) LogoutHarness(ctx context.Context, name string) error

+ func (v *Visor) Output(_ context.Context, id string) (string, error)

+ func (v *Visor) Paste(_ context.Context, id, text string) error

+ func (v *Visor) Projects(ctx context.Context, _ Filter) ([]Project, error)

+ func (v *Visor) RemoveHooks(ctx context.Context, spec HookSpec) ([]HookStatus, error)

+ func (v *Visor) RemoveWorkdir(ctx context.Context, id string, force bool) error

+ func (v *Visor) RestoreWorkdir(ctx context.Context, id string) (Workdir, error)

+ func (v *Visor) Screen(_ context.Context, id string) (Screen, error)

+ func (v *Visor) Send(ctx context.Context, id string, in Input) (Delivery, error)

+ func (v *Visor) Session(_ context.Context, id string) (Session, error)

+ func (v *Visor) Sessions(_ context.Context, f Filter) ([]Session, error)

+ func (v *Visor) SetHarnessAuth(ctx context.Context, name string, mode AuthMode) (Harness, error)

+ func (v *Visor) SetHarnessEnv(ctx context.Context, name string, env map[string]string) error

+ func (v *Visor) Start(ctx context.Context, spec StartSpec) (Session, error)

+ func (v *Visor) Stop(ctx context.Context, id string) error

+ func (v *Visor) UpdateHarness(ctx context.Context, name, version string) (Harness, error)

+ func (v *Visor) Upgrade(ctx context.Context, spec UpgradeSpec) (Info, error)

+ func (v *Visor) Workdirs(ctx context.Context, f Filter) ([]Workdir, error)

+ type Workdir = workdir.Workdir

+ type WorkdirKind = workdir.Kind

+ type WorkdirSpec = workdir.Spec

+ type WorkdirState = workdir.State

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL