server

type Agent struct {
	// AgentInfo advertises pi to the peer during initialize.
	AgentInfo acp.Implementation
	// Handler processes one prompt turn. If nil, EchoPromptHandler is used.
	Handler PromptHandler
	// AvailableCommandsResolver resolves slash commands for a session cwd.
	// If nil, the agent falls back to the static Skills/Subagents slices.
	AvailableCommandsResolver func(cwd string) []acp.AvailableCommand
	// Skills are the loaded skill definitions used to populate AvailableCommands.
	Skills []extension.Skill
	// Subagents are the loaded sub-agent definitions used to populate AvailableCommands.
	Subagents []subagent.AgentConfig
	// Logger is used for diagnostic output. If nil, a discard logger is used.
	Logger *slog.Logger
	// contains filtered or unexported fields
}

type PromptHandler func(ctx context.Context, turn PromptTurn) (PromptResult, error)

type PromptResult struct {
	FinalText  string
	StopReason acp.StopReason
}

type PromptTurn struct {
	SessionID string
	CWD       string
	Prompt    string
	Updater   SessionUpdater
}

type RuntimeConfig struct {
	Model           string
	BaseURL         string
	Headers         []string
	Insecure        bool
	System          string
	LoadConfig      func() (config.Config, error)
	SandboxRootFunc func(turn PromptTurn) string
}

type ServeConfig struct {
	// Agent is the pi ACP agent. Required.
	Agent *Agent
	// In is the byte stream from the ACP client. Typically os.Stdin.
	In io.Reader
	// Out is the byte stream to the ACP client. Typically os.Stdout.
	Out io.Writer
	// Logger receives diagnostic output from the ACP connection. Optional.
	Logger *slog.Logger
}

type SessionUpdater interface {
	Update(ctx context.Context, update acp.SessionUpdate) error
}