agent

package
v0.1.9 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 6, 2026 License: MIT Imports: 18 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func BuildShellCommandString

func BuildShellCommandString(
	ide string,
	modelName string,
	addDirs []string,
	reasoningEffort string,
	accessMode string,
) string

BuildShellCommandString renders a shell preview for the configured ACP agent bootstrap command.

func DisplayName

func DisplayName(ide string) string

DisplayName returns the human-readable display name for an agent runtime.

func EnsureAvailable

func EnsureAvailable(cfg *model.RuntimeConfig) error

EnsureAvailable verifies that the configured ACP agent binary is installed and executable.

func ResolveRuntimeModel added in v0.1.9

func ResolveRuntimeModel(ide string, modelName string) (string, error)

ResolveRuntimeModel returns the effective model after applying the IDE default when needed.

func ValidateAddDirSupport added in v0.1.9

func ValidateAddDirSupport(fieldName string, ide string, addDirs []string) error

ValidateAddDirSupport verifies that the selected runtime supports extra writable roots.

func ValidateRuntimeConfig

func ValidateRuntimeConfig(cfg *model.RuntimeConfig) error

ValidateRuntimeConfig verifies that the runtime config references a supported agent runtime.

Types

type AvailabilityError added in v0.1.3

type AvailabilityError struct {
	IDE         string
	DisplayName string
	Command     []string
	DocsURL     string
	InstallHint string
	Output      string
	Cause       error
}

AvailabilityError reports an ACP runtime that is missing or incorrectly installed.

func (*AvailabilityError) Error added in v0.1.3

func (e *AvailabilityError) Error() string

func (*AvailabilityError) Unwrap added in v0.1.3

func (e *AvailabilityError) Unwrap() error

type Client added in v0.1.3

type Client interface {
	// CreateSession starts a new ACP session with the given prompt.
	CreateSession(ctx context.Context, req SessionRequest) (Session, error)
	// ResumeSession attaches to an existing ACP session and sends a new prompt into it.
	ResumeSession(ctx context.Context, req ResumeSessionRequest) (Session, error)
	// SupportsLoadSession reports whether the connected ACP agent advertised session/load support.
	SupportsLoadSession() bool
	// Close terminates the agent subprocess.
	Close() error
	// Kill force-terminates the agent subprocess immediately.
	Kill() error
}

Client manages an ACP agent subprocess and creates sessions.

func NewClient added in v0.1.3

func NewClient(_ context.Context, cfg ClientConfig) (Client, error)

NewClient constructs a Compozy ACP client wrapper for the configured agent runtime.

type ClientConfig added in v0.1.3

type ClientConfig struct {
	IDE             string
	Model           string
	AddDirs         []string
	ReasoningEffort string
	AccessMode      string
	Logger          *slog.Logger
	ShutdownTimeout time.Duration
}

ClientConfig describes how to bootstrap an ACP agent process.

type DriverCatalogEntry added in v0.1.3

type DriverCatalogEntry struct {
	IDE                string
	DisplayName        string
	CanonicalCommand   []string
	CanonicalProbe     []string
	FallbackLaunchers  []DriverCatalogLauncher
	SupportsAddDirs    bool
	UsesBootstrapModel bool
	DocsURL            string
	InstallHint        string
}

DriverCatalogEntry exposes the stable command catalog for one supported ACP runtime.

func DriverCatalog added in v0.1.3

func DriverCatalog() []DriverCatalogEntry

DriverCatalog returns the stable ACP driver catalog in the supported IDE order.

func DriverCatalogEntryForIDE added in v0.1.3

func DriverCatalogEntryForIDE(ide string) (DriverCatalogEntry, error)

DriverCatalogEntryForIDE returns the stable driver catalog entry for one supported IDE.

type DriverCatalogLauncher added in v0.1.3

type DriverCatalogLauncher struct {
	Command []string
	Probe   []string
}

DriverCatalogLauncher describes one fallback launcher for a supported ACP runtime.

type Launcher added in v0.1.3

type Launcher struct {
	Command   string
	FixedArgs []string
	ProbeArgs []string
}

Launcher defines one ACP-compatible command shape for a runtime.

type ResumeSessionRequest added in v0.1.9

type ResumeSessionRequest struct {
	SessionID  string
	Prompt     []byte
	WorkingDir string
	Model      string
	ExtraEnv   map[string]string
}

ResumeSessionRequest contains the parameters for loading and continuing an existing ACP session.

type Session added in v0.1.3

type Session interface {
	// ID returns the ACP session identifier.
	ID() string
	// Identity returns the canonical session identifiers known for this session.
	Identity() SessionIdentity
	// Updates returns the streamed session updates in arrival order.
	Updates() <-chan model.SessionUpdate
	// Done closes when the session has fully completed.
	Done() <-chan struct{}
	// Err returns the terminal session error, if any.
	Err() error
}

Session represents an active ACP session streaming updates.

type SessionError added in v0.1.3

type SessionError struct {
	Code    int
	Message string
	Data    json.RawMessage
}

SessionError wraps JSON-RPC/ACP request errors without leaking SDK types.

func (*SessionError) Error added in v0.1.3

func (e *SessionError) Error() string

Error implements the error interface.

type SessionIdentity added in v0.1.9

type SessionIdentity struct {
	ACPSessionID   string
	AgentSessionID string
	Resumed        bool
}

SessionIdentity captures the stable ACP and provider-specific ids for a session.

type SessionRequest added in v0.1.3

type SessionRequest struct {
	Prompt     []byte
	WorkingDir string
	Model      string
	ExtraEnv   map[string]string
}

SessionRequest contains the parameters for creating a new ACP session.

type SessionSetupError added in v0.1.6

type SessionSetupError struct {
	Stage SessionSetupStage
	Err   error
}

SessionSetupError wraps an ACP setup failure with its stage for retry classification.

func (*SessionSetupError) Error added in v0.1.6

func (e *SessionSetupError) Error() string

Error implements the error interface.

func (*SessionSetupError) Unwrap added in v0.1.6

func (e *SessionSetupError) Unwrap() error

Unwrap returns the underlying setup failure.

type SessionSetupStage added in v0.1.6

type SessionSetupStage string

SessionSetupStage identifies which ACP bootstrap or session-configuration step failed.

const (
	// SessionSetupStageStartProcess indicates that starting the ACP subprocess failed.
	SessionSetupStageStartProcess SessionSetupStage = "start_process"
	// SessionSetupStageInitialize indicates that ACP protocol initialization failed.
	SessionSetupStageInitialize SessionSetupStage = "initialize"
	// SessionSetupStageNewSession indicates that ACP session creation failed.
	SessionSetupStageNewSession SessionSetupStage = "new_session"
	// SessionSetupStageLoadSession indicates that ACP session loading failed.
	SessionSetupStageLoadSession SessionSetupStage = "load_session"
	// SessionSetupStageSetModel indicates that ACP session model configuration failed.
	SessionSetupStageSetModel SessionSetupStage = "set_model"
	// SessionSetupStageSetMode indicates that ACP session mode configuration failed.
	SessionSetupStageSetMode SessionSetupStage = "set_mode"
)

type Spec added in v0.1.3

type Spec struct {
	ID                 string
	DisplayName        string
	DefaultModel       string
	Command            string
	FixedArgs          []string
	ProbeArgs          []string
	Fallbacks          []Launcher
	SupportsAddDirs    bool
	UsesBootstrapModel bool
	EnvVars            map[string]string
	DocsURL            string
	InstallHint        string
	FullAccessModeID   string
	BootstrapArgs      func(modelName, reasoningEffort string, addDirs []string, accessMode string) []string
}

Spec defines how to bootstrap an ACP-compatible agent process.

Jump to

Keyboard shortcuts

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