agents

type CreateSessionOptions struct {
	InitialContext string
	Title          string
	VaultIDs       []string
	Resources      []FileResource
}

type CreateSessionResult struct {
	ProviderSessionID string
}

type DefineOutcomeOptions struct {
	// Description is the user-visible goal the provider should work toward.
	Description string
	// Rubric is the grader-facing checklist evaluated after each iteration.
	Rubric string
	// MaxIterations caps the provider's autonomous build/evaluate loop.
	MaxIterations int
	// ContextPreamble is prepended to the description so provider-managed
	// autonomous loops get the same refreshed session context as normal turns.
	ContextPreamble string
}

type FileResource struct {
	FileID    string
	MountPath string
}

type Mode string

type OutcomeEvaluation struct {
	Iteration   int
	Result      string // "satisfied", "needs_revision", "max_iterations_reached", "failed", "interrupted"
	Explanation string // grader's prose verdict
}

type Provider interface {
	Name() string
	CreateSession(ctx context.Context, opts CreateSessionOptions) (*CreateSessionResult, error)
	SendMessage(ctx context.Context, providerSessionID, message string, opts SendMessageOptions) error
	InterruptSession(ctx context.Context, providerSessionID string) error
	// DefineOutcome starts a rubric-driven execution loop on the provider side.
	DefineOutcome(ctx context.Context, providerSessionID string, opts DefineOutcomeOptions) error
	// StreamEvents blocks until the provider closes the stream, ctx is
	// cancelled, or onEvent errors. Implementations must not call onEvent
	// after returning.
	StreamEvents(ctx context.Context, providerSessionID string, onEvent func(ProviderEvent) error) error
}

type ProviderEvent struct {
	ProviderEventID string
	Type            ProviderEventType
	Text            string
	ToolName        string
	ToolCallID      string
	// ToolInput is a human-readable rendering of the tool's invocation
	// (e.g. the shell command for bash, or compact JSON for other tools).
	ToolInput     string
	ErrorMessage  string
	OutcomeResult *OutcomeEvaluation

	// Multi-agent thread fields
	AgentName string
	ThreadID  string
}

type ProviderEventType string

type ProviderSessionCleaner interface {
	Name() string
	DeleteSession(ctx context.Context, providerSessionID string) error
}

type SendMessageOptions struct {
	ContextPreamble string
}

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