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

	// AgyStreamIdleTimeout bounds how long the agy PTY-RPC trajectory
	// subscription may stay silent before the client closes that subscription
	// and recovers through the ordinary snapshot/reopen path. It cancels only
	// the subscription, never the remote cascade. Zero (the default) keeps the
	// previous behaviour, where a silent stream is bounded only by the outer
	// turn deadline. Only consumed by the agy backend today.
	AgyStreamIdleTimeout time.Duration

	// AgyRecoverySnapshotTimeout is the per-call deadline for the agy
	// trajectory snapshot RPC used during recovery, so a blocked server ends
	// that call at its own operation deadline instead of consuming the whole
	// outer turn deadline. Zero (the default) keeps the previous behaviour.
	// Only consumed by the agy backend today.
	AgyRecoverySnapshotTimeout time.Duration
}