agents

type AgentSessionContext struct {
	SessionID         string
	ProviderSessionID string
	OrganizationID    string
	UserID            string
	CanvasID          string
}

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

type CreateSessionResult struct {
	ProviderSessionID string
}

type CustomToolExecutor interface {
	ExecuteCustomTool(ctx context.Context, session AgentSessionContext, toolUse CustomToolUse) CustomToolResult
}

type CustomToolInputSchema struct {
	Type        string                           `json:"type"`
	Description string                           `json:"description,omitempty"`
	Enum        []string                         `json:"enum,omitempty"`
	Properties  map[string]CustomToolInputSchema `json:"properties,omitempty"`
	Items       *CustomToolInputSchema           `json:"items,omitempty"`
	Required    []string                         `json:"required,omitempty"`
}

type CustomToolResult struct {
	CustomToolUseID string
	Content         string
	IsError         bool
}

type CustomToolResultSender interface {
	SendCustomToolResults(ctx context.Context, providerSessionID string, results []CustomToolResult) error
}

type CustomToolUse struct {
	ID    string
	Name  string
	Input 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 MessageImage struct {
	MediaType string
	Data      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
	Model           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
	CustomToolUse      *CustomToolUse
	CustomToolEventIDs []string

	// Multi-agent thread fields
	AgentName string
	ThreadID  string

	Usage *TokenUsage
}

type ProviderEventType string

type ProviderSessionArchiver interface {
	Name() string
	ArchiveSession(ctx context.Context, providerSessionID string) error
}

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

type ProviderSessionUsageRetriever interface {
	RetrieveSessionUsage(ctx context.Context, providerSessionID string) (*TokenUsage, error)
}

type ProviderToolSchemaRevisioner interface {
	Name() string
	ToolSchemaRevision() string
}

type SendMessageOptions struct {
	ContextPreamble string
	Images          []MessageImage
}

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

type TokenUsage struct {
	InputTokens      int64
	OutputTokens     int64
	TotalTokens      int64
	CacheReadTokens  int64
	CacheWriteTokens int64
}