runtime

type AgentResult struct {
	SessionID   string   `json:"session_id"`
	StopReason  string   `json:"stop_reason"`
	ExitCode    int      `json:"exit_code"`
	OutputFiles []string `json:"output_files,omitempty"`
}

type Capabilities struct {
	Backend             string
	Permissions         bool
	Resume              bool
	ExternalServerURL   bool
	SubprocessDiscovery bool
	ModelSelection      bool
}

type ChildQuestionPayload struct {
	RuntimeID string `json:"runtime_id"`
	SessionID string `json:"session_id"`
	ChildID   string `json:"child_id"`
	Message   string `json:"message"`
	RequestID string `json:"request_id"`
}

type PermissionResponse struct {
	Allow    bool
	OptionID string
	Message  string
}

type Provider interface {
	Start(ctx context.Context, opts StartOptions) (Session, error)
	Resume(ctx context.Context, sessionID string) (Session, error)
	Prompt(ctx context.Context, sessionID string, prompt string) error
	Cancel(ctx context.Context, sessionID string) error
	Events(ctx context.Context, sessionID string) (<-chan events.Event, error)
	AnswerPermission(ctx context.Context, sessionID string, requestID string, response PermissionResponse) error
	Capabilities(ctx context.Context) (Capabilities, error)
}

type Session struct {
	SessionID string
	Backend   string
	Dir       string
	PID       int // Consumed by longe halt (SIGTERM); set by opencode-acp backend. 0 otherwise.
}

type StartOptions struct {
	Agent        string
	Label        string
	Dir          string
	ServerURL    string
	Model        string
	AgentProfile string
	Thinking     string
	RuntimeID    string         // supervisor-assigned runtime ID (rt_N), for parent-child routing
	Broker       *broker.Broker // optional shared broker instance; backends may create their own if nil

	// SkipPermissions passes --dangerously-skip-permissions to the agy CLI in
	// headless (non-RPC) transport, where there is no interactive/AnswerPermission
	// path available to approve a tool call. Defaults to false (agy's own
	// default); callers running agy fully non-interactively must opt in.
	// Only consumed by the agy backend today.
	SkipPermissions bool
}