client

type AbstainResult struct {
	// Stop is the stop reason of the turn.
	Stop acp.StopReason
	// Abstained is true when the agent declined to respond and nothing was
	// delivered downstream.
	Abstained bool
}

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

type AuthMethod struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Type        string `json:"type,omitempty"` // "agent" | "env_var" | "terminal" | ""
}

type AuthResult struct {
	// State is one of "needs_redirect", "ok", "cancelled", or "" if the
	// agent's response carried no _meta.auth state field.
	State string
	// ID is the opaque pending-login id the agent returns on call 1.
	ID string
	// URL is the auth URL the user should visit (state="needs_redirect").
	URL string
	// Instructions is optional human-readable text alongside URL.
	Instructions string
}

type Caps struct {
	// LoadSession is the standard agentCapabilities.loadSession bool.
	LoadSession bool
	// ListSessions reflects agentCapabilities.sessionCapabilities.list
	// (unstable RFD).
	ListSessions bool
	// ResumeSession reflects agentCapabilities.sessionCapabilities.resume
	// (unstable RFD).
	ResumeSession bool
	// EmbeddedContext reflects
	// agentCapabilities.promptCapabilities.embeddedContext: when true,
	// the relay may emit ContentBlock::Resource (with TextResourceContents)
	// in prompt requests instead of a bare ResourceLink, avoiding an
	// agent-side fetch.
	EmbeddedContext bool
	// SystemPrompt reflects agentCapabilities._meta["session.systemPrompt"].
	// When true the consumer may pass a system-prompt block list via
	// session/new._meta and the agent will treat it as durable across
	// compaction. When false the consumer must fall back to inlining the
	// same content on first prompt (and re-arm on resume).
	SystemPrompt bool
	// Extensions captures arbitrary entries from agentCapabilities._meta
	// other than the kit-owned "session.systemPrompt". Consumers can
	// probe for custom extension ids (e.g. "dev.acp-kit.status-line/v1")
	// to discover advertised support. Values are the raw JSON bytes of
	// the entry — typically `{}` or `{"version": N}`. nil when the
	// agent advertised no _meta.
	Extensions map[string]json.RawMessage
}

type CommandInfo struct {
	Name        string // command name, e.g. "reload" (invoked as "/reload")
	Description string
}

type Config struct {
	// Command is the argv used to spawn the agent (e.g. []string{"fir", "--mode", "acp"}).
	Command []string
	// Cwd is the working directory for the child process.
	Cwd string
	// MCPServersForSession, when set, returns the MCP servers to include
	// in session/new and session/resume for a session at the given cwd.
	// This lets a client hand the agent client-hosted MCP servers (e.g. a
	// per-session stdio tool server) without changing the NewSession
	// signature. Nil (the default) means no MCP servers — identical to the
	// previous hardcoded empty list.
	MCPServersForSession func(cwd string) []acp.McpServer
	// Env is the environment for the child. If nil, os.Environ() is used.
	Env []string
	// Policy decides permission responses. If nil, AllowAllPermissions is used.
	Policy PermissionPolicy
	// CloseGrace is how long Close waits after SIGINT before SIGKILL. Default 2s.
	CloseGrace time.Duration
	// Stderr is where the child's stderr is forwarded. If nil, os.Stderr.
	Stderr io.Writer
	// ClientMeta carries extra entries to merge into the outgoing
	// clientCapabilities._meta map at Initialize. Use this to advertise
	// support for custom ACP extensions (keyed by extension id, e.g.
	// "dev.acp-kit.status-line/v1"). Keys collide last-wins with
	// kit-owned entries (e.g. "session.systemPrompt"); pick distinct
	// extension ids to avoid clobber.
	ClientMeta map[string]any
}

type ModelInfo struct {
	ID   string // "provider/modelID"
	Name string // human-readable label
}

type PermissionFunc func(context.Context, acp.RequestPermissionRequest) acp.RequestPermissionResponse

type PermissionPolicy interface {
	Decide(ctx context.Context, req acp.RequestPermissionRequest) acp.RequestPermissionResponse
}

type Prompter interface {
	Prompt(ctx context.Context, sid acp.SessionId, prompt []acp.ContentBlock) (acp.StopReason, error)
}

type RefuseConfig struct {
	// Validator decides whether the assistant message is acceptable.
	// If nil, output is always accepted (PromptValidated becomes a plain
	// buffered prompt).
	Validator Validator
	// MaxRefusals caps how many times the agent is re-prompted to
	// regenerate. 0 validates once and never re-prompts.
	MaxRefusals int
	// BuildReprompt builds the corrective prompt fed back to the agent
	// after a refusal. If nil, a single text block holding the reason is
	// used.
	BuildReprompt func(reason string) []acp.ContentBlock
	// Fallback transforms the rejected text into a deliverable form when
	// regeneration is exhausted (e.g. mechanically escape offending
	// tokens). If nil, the last (still-rejected) output is delivered as-is.
	Fallback func(text string) string
}

type RefuseResult struct {
	Stop     acp.StopReason // stop reason of the delivered turn
	Refusals int            // number of regenerations triggered
	Accepted bool           // a generation passed validation
	FellBack bool           // Fallback was applied after exhaustion
}

type SessionInfo struct {
	SessionId string  `json:"sessionId"`
	Cwd       string  `json:"cwd,omitempty"`
	Title     *string `json:"title,omitempty"`
	UpdatedAt string  `json:"updatedAt,omitempty"`
}

type SessionUpdateSink interface {
	OnUpdate(ctx context.Context, n acp.SessionNotification) error
}

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

type Validator interface {
	// Validate returns ok=true to accept the output. To refuse it, return
	// ok=false with a short, agent-facing reason describing what is wrong.
	// The reason is fed back to the agent as the next prompt so it can
	// regenerate a compliant message.
	Validate(text string) (reason string, ok bool)
}

type ValidatorFunc func(text string) (reason string, ok bool)