agentapi

type ACPStdioAgentCommand struct {
	// Args Command arguments passed to the ACP-compatible stdio agent executable.
	Args *[]string `json:"args,omitempty"`

	// Command Command executable to launch the ACP-compatible stdio agent.
	Command string `json:"command"`
}

type AgentAPIRequestMapper struct{}

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

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

type AgentAPIStreamEventMapper struct{}

type AgentProfileACPStdioExecutionSettings struct {
	// AgentCommand Command defaults used to launch an ACP-compatible stdio agent.
	AgentCommand ACPStdioAgentCommand `json:"agentCommand"`

	// Cwd Optional working directory used to launch the ACP stdio agent.
	Cwd *string `json:"cwd,omitempty"`

	// Mode Execution mode for ACP-compatible stdio profiles.
	Mode string `json:"mode"`
}

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

type AgentProfileListResponse struct {
	Profiles []AgentProfileResponse `json:"profiles"`
}

type AgentProfileRegularExecutionSettings struct {
	// DefaultModel Fully-qualified default model in `provider/model-name` form.
	DefaultModel string `json:"defaultModel"`

	// Mode Execution mode. Omit for regular built-in execution.
	Mode *AgentProfileRegularExecutionSettingsMode `json:"mode,omitempty"`
}

type AgentProfileRegularExecutionSettingsMode string

type AgentProfileResponse struct {
	// CreatedAt ISO 8601 creation timestamp.
	CreatedAt time.Time `json:"createdAt"`

	// DisplayName Human-friendly profile label (may be empty).
	DisplayName       string                        `json:"displayName"`
	ExecutionSettings AgentProfileExecutionSettings `json:"executionSettings"`

	// Instructions Profile-specific behavior instructions.
	Instructions string `json:"instructions"`

	// Name Unique technical profile name (primary key).
	Name string `json:"name"`

	// Role Profile role describing high-level responsibility.
	Role string `json:"role"`

	// ToolRefs Tool references available to this profile.
	ToolRefs []string `json:"toolRefs"`

	// UpdatedAt ISO 8601 last-update timestamp.
	UpdatedAt time.Time `json:"updatedAt"`
}

type AgentRunRequest struct {
	// Message User message for `POST /agent-runs` / continue run: text parts (always user role; not sent by clients).
	Message UserMessageContent `json:"message"`

	// Model Fully-qualified model name (`provider/model-name`) for built-in execution. Optional override for regular profiles; ignored for `acp-stdio`.
	Model *string `json:"model,omitempty"`

	// ProfileName Name of the saved agent profile whose execution settings will be used for this run.
	ProfileName *string `json:"profileName,omitempty"`
}

type AgentStreamContent struct {
	// Parts May be empty when only metadata is present; omitting `content` entirely is allowed when there is no body.
	Parts []AgentStreamPart `json:"parts"`

	// Role Producer of the message; may be omitted when not set on the underlying event.
	Role *AgentStreamContentRole `json:"role,omitempty"`
}

type AgentStreamContentRole string

type AgentStreamEvent struct {
	Author *string `json:"author,omitempty"`
	Branch *string `json:"branch,omitempty"`

	// Content Model output body on streamed `agent` events: text parts and optional `role` (mapped from ADK session events).
	// `parts` may be empty when only metadata is present.
	Content *AgentStreamContent `json:"content,omitempty"`

	// ErrorCode Present when the agent surfaced an error on the ADK session event / LLM response.
	ErrorCode    *string `json:"errorCode,omitempty"`
	ErrorMessage *string `json:"errorMessage,omitempty"`
	Event        string  `json:"event"`
	Id           *string `json:"id,omitempty"`
	Interrupted  *bool   `json:"interrupted,omitempty"`
	InvocationId *string `json:"invocationId,omitempty"`

	// Partial Incremental model output; when false and `turnComplete` is true, chunk is final for the turn.
	Partial              *bool                  `json:"partial,omitempty"`
	TurnComplete         *bool                  `json:"turnComplete,omitempty"`
	AdditionalProperties map[string]interface{} `json:"-"`
}

type AgentStreamPart struct {
	Text *string `json:"text,omitempty"`

	// ToolCall Tool invocation requested by the model.
	ToolCall *ToolCallData `json:"toolCall,omitempty"`

	// ToolResult Result returned by a tool invocation.
	ToolResult *ToolResultData `json:"toolResult,omitempty"`
}

type BadRequest = ProblemDetails

type Conflict = ProblemDetails

type ContinueAgentRunJSONRequestBody = AgentRunRequest

type CreateAgentProfileJSONRequestBody = CreateAgentProfileRequest

type CreateAgentProfileRequest struct {
	// DisplayName Optional human-friendly profile label.
	DisplayName       *string                       `json:"displayName,omitempty"`
	ExecutionSettings AgentProfileExecutionSettings `json:"executionSettings"`

	// Instructions Profile-specific behavior instructions.
	Instructions string `json:"instructions"`

	// Name Unique technical profile name (primary key). Immutable after creation.
	Name string `json:"name"`

	// Role Profile role describing high-level responsibility.
	Role string `json:"role"`

	// ToolRefs Tool references available to this profile.
	ToolRefs *[]string `json:"toolRefs,omitempty"`
}

type CreateProviderJSONRequestBody = CreateProviderRequest

type CreateProviderRequest struct {
	// ApiKey API key for authentication. Stored in plaintext (local/dev use).
	ApiKey string `json:"apiKey"`

	// BaseUrl Base URL of the provider API endpoint.
	BaseUrl string `json:"baseUrl"`

	// DisplayName Optional human-friendly label.
	DisplayName *string `json:"displayName,omitempty"`

	// Models Models available through this provider.
	Models *[]ModelConfig `json:"models,omitempty"`

	// Name Unique technical name (primary key). Must match `^[a-z][a-z0-9-]*$`. Immutable after creation.
	Name string `json:"name"`

	// Type Provider protocol type. Only `openai-compatible` is supported. Immutable after creation.
	Type string `json:"type"`
}

type DefaultIDGen struct{}

type DoneEvent struct {
	Event string `json:"event"`
}

type IDGen interface {
	// MustNewV7 generates a new UUIDv7 identifier or panics on failure.
	MustNewV7() UUID

	// NewV7 generates a new UUIDv7 identifier and allows error handling.
	NewV7() (UUID, error)
}

type InternalError = ProblemDetails

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type ListSessionsParams struct {
	// Limit Maximum number of sessions to return (1–100).
	Limit int `form:"limit" json:"limit"`

	// Offset Number of sessions to skip (for pagination). Defaults to 0.
	Offset *int `form:"offset,omitempty" json:"offset,omitempty"`
}

type MiddlewareFunc func(http.Handler) http.Handler

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

type ModelConfig struct {
	// DisplayName Optional human-friendly label (e.g., "GPT 4.1").
	DisplayName *string `json:"displayName,omitempty"`

	// Name Technical model identifier (e.g., "gpt-4.1").
	Name string `json:"name"`

	// Summarization Designates this model for summarization tasks (e.g. generating session titles). If multiple models have this enabled, the first one found is used.
	Summarization *bool `json:"summarization,omitempty"`
}

type ModelInfo struct {
	// DisplayName Optional human-friendly label.
	DisplayName *string `json:"displayName,omitempty"`

	// Name Technical model identifier (e.g., "gpt-4.1").
	Name string `json:"name"`

	// Provider Provider name (prefix in fully-qualified model names like `provider/model-name`).
	Provider string `json:"provider"`
}

type ModelListResponse struct {
	Models []ModelInfo `json:"models"`
}

type ModelsLister interface {
	ListModels(ctx context.Context) ([]rt.ModelInfo, error)
}

type NotFound = ProblemDetails

type ProblemDetails struct {
	Detail               *string                `json:"detail,omitempty"`
	Instance             *string                `json:"instance,omitempty"`
	Status               *int                   `json:"status,omitempty"`
	Title                *string                `json:"title,omitempty"`
	Type                 *string                `json:"type,omitempty"`
	AdditionalProperties map[string]interface{} `json:"-"`
}

type ProfileName = string

type ProviderListResponse struct {
	Providers []ProviderResponse `json:"providers"`
}

type ProviderName = string

type ProviderResponse struct {
	// ApiKeyPreview Masked API key preview (e.g. `...xYz1`). Never the full key.
	ApiKeyPreview string `json:"apiKeyPreview"`

	// BaseUrl Base URL of the provider API endpoint.
	BaseUrl string `json:"baseUrl"`

	// CreatedAt ISO 8601 creation timestamp.
	CreatedAt time.Time `json:"createdAt"`

	// DisplayName Human-friendly label (may be empty).
	DisplayName *string `json:"displayName,omitempty"`

	// Models Models available through this provider.
	Models []ModelConfig `json:"models"`

	// Name Unique technical name (primary key).
	Name string `json:"name"`

	// Type Provider protocol type.
	Type string `json:"type"`

	// UpdatedAt ISO 8601 last-update timestamp.
	UpdatedAt time.Time `json:"updatedAt"`
}

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type ServeMux interface {
	HandleFunc(pattern string, handler func(http.ResponseWriter, *http.Request))
	http.Handler
}

type ServerInterface interface {
	// List all saved agent profiles
	// (GET /agent-profiles)
	ListAgentProfiles(w http.ResponseWriter, r *http.Request)
	// Create a new saved agent profile
	// (POST /agent-profiles)
	CreateAgentProfile(w http.ResponseWriter, r *http.Request)
	// Delete a saved agent profile by name
	// (DELETE /agent-profiles/{profileName})
	DeleteAgentProfile(w http.ResponseWriter, r *http.Request, profileName ProfileName)
	// Get a saved agent profile by name
	// (GET /agent-profiles/{profileName})
	GetAgentProfile(w http.ResponseWriter, r *http.Request, profileName ProfileName)
	// Update mutable fields for a saved agent profile
	// (PUT /agent-profiles/{profileName})
	UpdateAgentProfile(w http.ResponseWriter, r *http.Request, profileName ProfileName)
	// Start a new agent run
	// (POST /agent-runs)
	StartAgentRun(w http.ResponseWriter, r *http.Request)
	// List all available models across all providers
	// (GET /models)
	ListModels(w http.ResponseWriter, r *http.Request)
	// List all provider configurations
	// (GET /providers)
	ListProviders(w http.ResponseWriter, r *http.Request)
	// Create a new provider configuration
	// (POST /providers)
	CreateProvider(w http.ResponseWriter, r *http.Request)
	// Delete a provider configuration by name
	// (DELETE /providers/{providerName})
	DeleteProvider(w http.ResponseWriter, r *http.Request, providerName ProviderName)
	// Get a provider configuration by name
	// (GET /providers/{providerName})
	GetProvider(w http.ResponseWriter, r *http.Request, providerName ProviderName)
	// Update a provider configuration by name
	// (PUT /providers/{providerName})
	UpdateProvider(w http.ResponseWriter, r *http.Request, providerName ProviderName)
	// List sessions for the authenticated user
	// (GET /sessions)
	ListSessions(w http.ResponseWriter, r *http.Request, params ListSessionsParams)
	// Read session events (replay history and optionally tail live run)
	// (GET /sessions/{sessionId})
	ReadSession(w http.ResponseWriter, r *http.Request, sessionId SessionId)
	// Continue an agent run for an existing session
	// (POST /sessions/{sessionId}/agent-runs)
	ContinueAgentRun(w http.ResponseWriter, r *http.Request, sessionId SessionId)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type ServerParams struct {
	Runner                 agent.AgentRunner
	Logger                 *slog.Logger
	IDGen                  IDGen
	RequestMapper          *AgentAPIRequestMapper
	SSEWriter              *AgentAPISSEWriter
	ProvidersConfigService lp.ProvidersConfigService
	AgentProfilesService   ap.AgentProfilesService
	// ModelsLister is optional; when nil, ListModels returns an empty list.
	ModelsLister ModelsLister
}

type SessionBoundEvent struct {
	Event string `json:"event"`

	// SessionId Use this id for `POST /sessions/{sessionId}/agent-runs`.
	SessionId string `json:"sessionId"`
}

type SessionId = string

type SessionListResponse struct {
	Sessions []SessionMetadata `json:"sessions"`

	// Total Total number of sessions matching the query (before limit/offset).
	Total int `json:"total"`
}

type SessionMetadata struct {
	CreatedAt time.Time `json:"createdAt"`
	SessionId string    `json:"sessionId"`

	// Title Session title. Always non-empty — resolved by the backend. Generated via LLM summarization (if a summarization model is designated), derived from the first user message, or a date-based fallback for sessions without a stored title.
	Title     string    `json:"title"`
	UpdatedAt time.Time `json:"updatedAt"`
}

type SessionStatusEvent struct {
	Event string `json:"event"`

	// Status Whether a run is currently in progress for this session.
	Status SessionStatusEventStatus `json:"status"`
}

type SessionStatusEventStatus string

type StartAgentRunJSONRequestBody = AgentRunRequest

type StdHTTPServerOptions struct {
	BaseURL          string
	BaseRouter       ServeMux
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type StreamErrorEvent struct {
	Code  *string `json:"code,omitempty"`
	Event string  `json:"event"`

	// Message Human-readable failure; after this, the stream may end.
	Message string `json:"message"`
}

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

type StreamEventMapper interface {
	ToStreamEvent(ev *rt.SessionEvent) (StreamEvent, error)
}

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type ToolCallData struct {
	// Args Arguments passed to the tool (JSON object).
	Args *map[string]interface{} `json:"args,omitempty"`

	// Id Unique call ID matching the tool result.
	Id string `json:"id"`

	// Name Tool function name.
	Name string `json:"name"`
}

type ToolResultData struct {
	// Id Call ID matching the original tool call.
	Id string `json:"id"`

	// Name Tool function name.
	Name string `json:"name"`

	// Response Tool output (JSON object).
	Response *map[string]interface{} `json:"response,omitempty"`
}

type UUID = uuid.UUID

type Unauthorized = ProblemDetails

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type UpdateAgentProfileJSONRequestBody = UpdateAgentProfileRequest

type UpdateAgentProfileRequest struct {
	// DisplayName Human-friendly profile label.
	DisplayName       *string                       `json:"displayName,omitempty"`
	ExecutionSettings AgentProfileExecutionSettings `json:"executionSettings"`

	// Instructions Profile-specific behavior instructions.
	Instructions string `json:"instructions"`

	// Role Profile role describing high-level responsibility.
	Role string `json:"role"`

	// ToolRefs Tool references available to this profile. Replaces the existing list.
	ToolRefs *[]string `json:"toolRefs,omitempty"`
}

type UpdateProviderJSONRequestBody = UpdateProviderRequest

type UpdateProviderRequest struct {
	// ApiKey API key for authentication. Omit to keep the current value.
	ApiKey *string `json:"apiKey,omitempty"`

	// BaseUrl Base URL of the provider API endpoint.
	BaseUrl string `json:"baseUrl"`

	// DisplayName Human-friendly label.
	DisplayName *string `json:"displayName,omitempty"`

	// Models Models available through this provider. Replaces the existing list.
	Models *[]ModelConfig `json:"models,omitempty"`
}

type UserMessageContent struct {
	// Parts Must contain at least one segment with non-empty text after server-side validation; empty lists are rejected for POST bodies.
	Parts []UserMessagePart `json:"parts"`
}

type UserMessagePart struct {
	Text string `json:"text"`
}