spec

type AllMCPBundles struct {
	Bundles map[bundleitemutils.BundleID]MCPBundle `json:"bundles"`
}

type CancelPendingMCPOAuthAuthorizationRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`
}

type CancelPendingMCPOAuthAuthorizationResponse struct{}

type ConnectMCPServerRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`
}

type ConnectMCPServerResponse struct {
	Body *MCPServerRuntimeSnapshot
}

type DeleteMCPBundleRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
}

type DeleteMCPBundleResponse struct{}

type DeleteMCPServerRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`
}

type DeleteMCPServerResponse struct{}

type DeleteMCPServerSecretRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Kind MCPSecretKind `required:"true" query:"kind"`
	Slot string        `required:"true" query:"slot"`
}

type DeleteMCPServerSecretResponse struct{}

type DisconnectMCPServerRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`
}

type DisconnectMCPServerResponse struct{}

type EvaluateMCPToolCallRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *InvokeMCPToolRequestBody
}

type EvaluateMCPToolCallResponse struct {
	Body *MCPApprovalEvaluation
}

type GetMCPServerAuthHealthRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`
}

type GetMCPServerAuthHealthResponse struct {
	Body *MCPAuthHealth
}

type GetMCPServerAuthStatusRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`
}

type GetMCPServerAuthStatusResponse struct {
	Body *MCPAuthStatus
}

type GetMCPServerRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`
}

type GetMCPServerResponse struct {
	Body *MCPServerConfig
}

type GetMCPServerStatusRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`
}

type GetMCPServerStatusResponse struct {
	Body *MCPServerRuntimeSnapshot
}

type GetMCPSettingsRequest struct{}

type GetMCPSettingsResponse struct {
	Body *MCPSettingsView
}

type GrantType string

type InvokeMCPToolRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *InvokeMCPToolRequestBody
}

type InvokeMCPToolRequestBody struct {
	Source           MCPInvocationSource `json:"source"                     required:"true"`
	ToolName         string              `json:"toolName"                   required:"true"`
	ProviderToolName string              `json:"providerToolName,omitempty"`
	ToolDigest       string              `json:"toolDigest,omitempty"`

	Arguments map[string]any `json:"arguments,omitempty"`

	ApprovalID    string `json:"approvalID,omitempty"`
	ApprovalToken string `json:"approvalToken,omitempty"`

	ConversationID string `json:"conversationID,omitempty"`
	MessageID      string `json:"messageID,omitempty"`
	ToolUseID      string `json:"toolUseID,omitempty"`

	AppInstanceID string `json:"appInstanceID,omitempty"`
}

type InvokeMCPToolResponse struct {
	Body *InvokeMCPToolResponseBody
}

type InvokeMCPToolResponseBody struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`

	ToolName         string `json:"toolName"`
	ProviderToolName string `json:"providerToolName,omitempty"`

	Content           []MCPContent `json:"content,omitempty"`
	StructuredContent any          `json:"structuredContent,omitempty"`
	IsError           bool         `json:"isError,omitempty"`

	Provenance MCPToolCallProvenance `json:"provenance"`
	App        *MCPToolAppRenderInfo `json:"app,omitempty"`
}

type JSONRawString = string

type ListMCPBundlesRequest struct {
	BundleIDs       []bundleitemutils.BundleID `query:"bundleIDs"`
	IncludeDisabled bool                       `query:"includeDisabled"`
	PageSize        int                        `query:"pageSize"`
	PageToken       string                     `query:"pageToken"`
}

type ListMCPBundlesResponse struct {
	Body *ListMCPBundlesResponseBody
}

type ListMCPBundlesResponseBody struct {
	Bundles       []MCPBundle `json:"bundles"`
	NextPageToken *string     `json:"nextPageToken,omitempty"`
}

type ListMCPServerPromptsRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	PageSize  int    `query:"pageSize"`
	PageToken string `query:"pageToken"`
}

type ListMCPServerPromptsResponse struct {
	Body *ListMCPServerPromptsResponseBody
}

type ListMCPServerPromptsResponseBody struct {
	Prompts       []MCPPromptRef `json:"prompts"`
	NextPageToken *string        `json:"nextPageToken,omitempty"`
}

type ListMCPServerResourceTemplatesRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	PageSize  int    `query:"pageSize"`
	PageToken string `query:"pageToken"`
}

type ListMCPServerResourceTemplatesResponse struct {
	Body *ListMCPServerResourceTemplatesResponseBody
}

type ListMCPServerResourceTemplatesResponseBody struct {
	ResourceTemplates []MCPResourceTemplateRef `json:"resourceTemplates"`
	NextPageToken     *string                  `json:"nextPageToken,omitempty"`
}

type ListMCPServerResourcesRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	PageSize  int    `query:"pageSize"`
	PageToken string `query:"pageToken"`
}

type ListMCPServerResourcesResponse struct {
	Body *ListMCPServerResourcesResponseBody
}

type ListMCPServerResourcesResponseBody struct {
	Resources     []MCPResourceRef `json:"resources"`
	NextPageToken *string          `json:"nextPageToken,omitempty"`
}

type ListMCPServerToolsRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	PageSize  int    `query:"pageSize"`
	PageToken string `query:"pageToken"`
}

type ListMCPServerToolsResponse struct {
	Body *ListMCPServerToolsResponseBody
}

type ListMCPServerToolsResponseBody struct {
	Tools         []MCPToolCapability `json:"tools"`
	NextPageToken *string             `json:"nextPageToken,omitempty"`
}

type ListMCPServersRequest struct {
	BundleID        bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerIDs       []MCPServerID            `                                query:"serverIDs"`
	Enabled         *bool                    `                                query:"enabled"`
	IncludeDisabled bool                     `                                query:"includeDisabled"`
	PageSize        int                      `                                query:"pageSize"`
	PageToken       string                   `                                query:"pageToken"`
}

type ListMCPServersResponse struct {
	Body *ListMCPServersResponseBody
}

type ListMCPServersResponseBody struct {
	Servers       []MCPServerConfig `json:"servers"`
	NextPageToken *string           `json:"nextPageToken,omitempty"`
}

type ListPendingMCPOAuthAuthorizationsRequest struct{}

type ListPendingMCPOAuthAuthorizationsResponse struct {
	Body *ListPendingMCPOAuthAuthorizationsResponseBody
}

type ListPendingMCPOAuthAuthorizationsResponseBody struct {
	Authorizations []MCPOAuthAuthorization `json:"authorizations"`
}

type MCPAppModelContextUpdate struct {
	InstanceID string                   `json:"instanceID,omitempty"`
	BundleID   bundleitemutils.BundleID `json:"bundleID,omitempty"`
	ServerID   MCPServerID              `json:"serverID,omitempty"`

	ResourceURI string `json:"resourceUri,omitempty"`

	Content           []MCPContent `json:"content,omitempty"`
	StructuredContent any          `json:"structuredContent,omitempty"`

	UpdatedAt string `json:"updatedAt,omitempty"`
}

type MCPApprovalDecision string

type MCPApprovalEvaluation struct {
	Decision   MCPApprovalDecision `json:"decision"`
	Reason     string              `json:"reason,omitempty"`
	ApprovalID string              `json:"approvalID,omitempty"`
	Summary    *MCPApprovalSummary `json:"summary,omitempty"`
}

type MCPApprovalResolution string

type MCPApprovalRule string

type MCPApprovalSummary struct {
	BundleID          bundleitemutils.BundleID `json:"bundleID"`
	ServerID          MCPServerID              `json:"serverID"`
	ServerDisplayName string                   `json:"serverDisplayName,omitempty"`
	ToolName          string                   `json:"toolName"`
	ToolDigest        string                   `json:"toolDigest,omitempty"`
	Risk              MCPToolRisk              `json:"risk"`
	Arguments         JSONRawString            `json:"arguments,omitempty"`
}

type MCPApprovalToken struct {
	ApprovalID string `json:"approvalID"`
	Token      string `json:"token"`
	ExpiresAt  string `json:"expiresAt"`
}

type MCPAppsPolicy struct {
	Enabled                          bool `json:"enabled"`
	AllowAppInitiatedToolCalls       bool `json:"allowAppInitiatedToolCalls"`
	RequireApprovalForOpenLink       bool `json:"requireApprovalForOpenLink"`
	RequireApprovalForContextUpdates bool `json:"requireApprovalForContextUpdates"`
}

type MCPArgumentDefinition struct {
	Name        string `json:"name"`
	Title       string `json:"title,omitempty"`
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required,omitempty"`
}

type MCPAuthHealth struct {
	BundleID bundleitemutils.BundleID `json:"bundleID,omitempty"`

	ServerID MCPServerID        `json:"serverID"`
	AuthMode MCPHTTPAuthMode    `json:"authMode"`
	State    MCPAuthHealthState `json:"state"`

	Configured bool `json:"configured"`

	Resource  string     `json:"resource,omitempty"`
	Scopes    []string   `json:"scopes,omitempty"`
	ExpiresAt *time.Time `json:"expiresAt,omitempty"`

	AuthorizationPending   bool   `json:"authorizationPending,omitempty"`
	AuthorizationURL       string `json:"authorizationURL,omitempty"`
	AuthorizationExpiresAt string `json:"authorizationExpiresAt,omitempty"`

	OAuthRedirectURL        string `json:"oauthRedirectURL,omitempty"`
	OAuthLoopbackListenAddr string `json:"oauthLoopbackListenAddr,omitempty"`

	LastError string `json:"lastError,omitempty"`
}

type MCPAuthHealthState string

type MCPAuthState string

type MCPAuthStatus struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`
	AuthMode MCPHTTPAuthMode          `json:"authMode"`
	State    MCPAuthState             `json:"state"`

	Scopes              []string   `json:"scopes,omitempty"`
	ExpiresAt           *time.Time `json:"expiresAt,omitempty"`
	LastError           string     `json:"lastError,omitempty"`
	AuthorizationServer string     `json:"authorizationServer,omitempty"`
	Resource            string     `json:"resource,omitempty"`
}

type MCPBuiltInServerOverlay struct {
	Stdio          *MCPStdioConfigOverlay          `json:"stdio,omitempty"`
	StreamableHTTP *MCPStreamableHTTPConfigOverlay `json:"streamableHttp,omitempty"`
}

type MCPBundle struct {
	SchemaVersion string                     `json:"schemaVersion"`
	ID            bundleitemutils.BundleID   `json:"id"`
	Slug          bundleitemutils.BundleSlug `json:"slug"`

	DisplayName string `json:"displayName,omitempty"`
	Description string `json:"description,omitempty"`

	IsEnabled     bool       `json:"isEnabled"`
	CreatedAt     time.Time  `json:"createdAt"`
	ModifiedAt    time.Time  `json:"modifiedAt"`
	IsBuiltIn     bool       `json:"isBuiltIn"`
	SoftDeletedAt *time.Time `json:"softDeletedAt,omitempty"`
}

type MCPBundlePageToken struct {
	BundleIDs       []bundleitemutils.BundleID `json:"ids,omitempty"`
	IncludeDisabled bool                       `json:"d,omitempty"`
	PageSize        int                        `json:"s"`
	CursorMod       string                     `json:"t,omitempty"`
	CursorID        bundleitemutils.BundleID   `json:"id,omitempty"`
}

type MCPCompleteArgumentRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *MCPCompleteArgumentRequestBody
}

type MCPCompleteArgumentRequestBody struct {
	RefType       string            `json:"refType"                 required:"true"` // resource | prompt
	Name          string            `json:"name"                    required:"true"`
	ArgumentName  string            `json:"argumentName"            required:"true"`
	ArgumentValue string            `json:"argumentValue,omitempty"`
	Context       map[string]string `json:"context,omitempty"`
}

type MCPCompletionResult struct {
	Values  []string `json:"values,omitempty"`
	Total   int      `json:"total,omitempty"`
	HasMore bool     `json:"hasMore,omitempty"`
}

type MCPContent struct {
	Type MCPContentType `json:"type"`

	Text     string `json:"text,omitempty"`
	Data     []byte `json:"data,omitempty"`
	MIMEType string `json:"mimeType,omitempty"`

	URI         string `json:"uri,omitempty"`
	Name        string `json:"name,omitempty"`
	Title       string `json:"title,omitempty"`
	Description string `json:"description,omitempty"`
	Size        *int64 `json:"size,omitempty"`

	Resource *MCPResourceContents `json:"resource,omitempty"`

	Annotations map[string]any `json:"annotations,omitempty"`
	Meta        map[string]any `json:"_meta,omitempty"`
	Icons       []MCPIcon      `json:"icons,omitempty"`
}

type MCPContentType string

type MCPConversationContext struct {
	Servers           []MCPServerSelection           `json:"servers"`
	Resources         []MCPResourceRef               `json:"resources,omitempty"`
	ResourceTemplates []MCPResourceTemplateSelection `json:"resourceTemplates,omitempty"`
	Prompts           []MCPPromptSelection           `json:"prompts,omitempty"`
}

type MCPDiscoveryPageToken struct {
	BundleID       bundleitemutils.BundleID `json:"bid"`
	ServerID       MCPServerID              `json:"sid"`
	SnapshotDigest string                   `json:"dig"`
	Kind           string                   `json:"k"`
	PageSize       int                      `json:"ps"`
	Index          int                      `json:"i"`
}

type MCPDiscoverySnapshot struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`

	NegotiatedProtocolVersion string                        `json:"negotiatedProtocolVersion,omitempty"`
	ServerInfo                *MCPImplementationInfo        `json:"serverInfo,omitempty"`
	ServerCapabilities        *MCPServerCapabilitiesSummary `json:"serverCapabilities,omitempty"`
	Instructions              string                        `json:"instructions,omitempty"`

	Tools             []MCPToolCapability      `json:"tools,omitempty"`
	Resources         []MCPResourceRef         `json:"resources,omitempty"`
	ResourceTemplates []MCPResourceTemplateRef `json:"resourceTemplates,omitempty"`
	Prompts           []MCPPromptRef           `json:"prompts,omitempty"`

	Digest   string `json:"digest,omitempty"`
	SyncedAt string `json:"syncedAt,omitempty"`
}

type MCPExecutionMode string

type MCPGetPromptRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *MCPGetPromptRequestBody
}

type MCPGetPromptRequestBody struct {
	PromptName string            `json:"promptName"          required:"true"`
	Arguments  map[string]string `json:"arguments,omitempty"`
}

type MCPGetPromptResponse struct {
	Body *MCPGetPromptResponseBody
}

type MCPGetPromptResponseBody struct {
	BundleID    bundleitemutils.BundleID `json:"bundleID"`
	ServerID    MCPServerID              `json:"serverID"`
	PromptName  string                   `json:"promptName"`
	Description string                   `json:"description,omitempty"`
	Messages    []MCPPromptMessage       `json:"messages,omitempty"`
}

type MCPHTTPAuthMode string

type MCPIcon struct {
	Source   string   `json:"src"`
	MIMEType string   `json:"mimeType,omitempty"`
	Sizes    []string `json:"sizes,omitempty"`
	Theme    string   `json:"theme,omitempty"`
}

type MCPImplementationInfo struct {
	Name    string `json:"name,omitempty"`
	Version string `json:"version,omitempty"`
}

type MCPInvocationSource string

type MCPOAuthAuthorization struct {
	BundleID         bundleitemutils.BundleID `json:"bundleID"`
	ServerID         MCPServerID              `json:"serverID"`
	AuthorizationURL string                   `json:"authorizationURL"`
	ExpiresAt        string                   `json:"expiresAt,omitempty"`
}

type MCPPageToken struct {
	PageSize        int                        `json:"s"`
	BundleID        bundleitemutils.BundleID   `json:"bid"`
	CursorID        MCPServerID                `json:"id,omitempty"`
	CursorAt        string                     `json:"t,omitempty"`
	Enabled         *bool                      `json:"e,omitempty"`
	IncludeDisabled bool                       `json:"d,omitempty"`
	IDs             []MCPServerID              `json:"ids,omitempty"`
	BundleIDs       []bundleitemutils.BundleID `json:"bids,omitempty"`
}

type MCPPromptMessage struct {
	Role    string     `json:"role"`
	Content MCPContent `json:"content"`
}

type MCPPromptRef struct {
	BundleID    bundleitemutils.BundleID         `json:"bundleID"`
	ServerID    MCPServerID                      `json:"serverID"`
	PromptName  string                           `json:"promptName"`
	Title       string                           `json:"title,omitempty"`
	DisplayName string                           `json:"displayName"`
	Description string                           `json:"description,omitempty"`
	Arguments   map[string]MCPArgumentDefinition `json:"arguments,omitempty"`
	Digest      string                           `json:"digest,omitempty"`
}

type MCPPromptSelection struct {
	MCPPromptRef

	ArgumentValues map[string]string `json:"argumentValues,omitempty"`
}

type MCPProviderToolMapping struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`

	ProviderToolName string `json:"providerToolName"`
	ChoiceID         string `json:"choiceID"`

	ToolName   string `json:"toolName"`
	ToolDigest string `json:"toolDigest"`

	ApprovalRule   MCPApprovalRule  `json:"approvalRule,omitempty"`
	ExecutionMode  MCPExecutionMode `json:"executionMode,omitempty"`
	AppResourceURI string           `json:"appResourceUri,omitempty"`
	Visibility     []string         `json:"visibility,omitempty"`
}

type MCPReadResourceRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *MCPReadResourceRequestBody
}

type MCPReadResourceRequestBody struct {
	URI string `json:"uri" required:"true"`
}

type MCPReadResourceResponse struct {
	Body *MCPReadResourceResponseBody
}

type MCPReadResourceResponseBody struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`
	URI      string                   `json:"uri"`
	Contents []MCPContent             `json:"contents,omitempty"`
}

type MCPResourceContents struct {
	URI      string         `json:"uri"`
	MIMEType string         `json:"mimeType,omitempty"`
	Text     string         `json:"text,omitempty"`
	Blob     []byte         `json:"blob,omitempty"`
	Meta     map[string]any `json:"_meta,omitempty"`
}

type MCPResourceRef struct {
	BundleID    bundleitemutils.BundleID `json:"bundleID"`
	ServerID    MCPServerID              `json:"serverID"`
	URI         string                   `json:"uri"`
	Name        string                   `json:"name,omitempty"`
	Title       string                   `json:"title,omitempty"`
	DisplayName string                   `json:"displayName"`
	Description string                   `json:"description,omitempty"`
	MimeType    string                   `json:"mimeType,omitempty"`
	Size        int64                    `json:"size,omitempty"`
	Annotations map[string]any           `json:"annotations,omitempty"`
	Digest      string                   `json:"digest,omitempty"`
}

type MCPResourceTemplateRef struct {
	BundleID    bundleitemutils.BundleID         `json:"bundleID"`
	ServerID    MCPServerID                      `json:"serverID"`
	URITemplate string                           `json:"uriTemplate"`
	Name        string                           `json:"name,omitempty"`
	Title       string                           `json:"title,omitempty"`
	DisplayName string                           `json:"displayName"`
	Description string                           `json:"description,omitempty"`
	MimeType    string                           `json:"mimeType,omitempty"`
	Arguments   map[string]MCPArgumentDefinition `json:"arguments,omitempty"`
	Annotations map[string]any                   `json:"annotations,omitempty"`
	Digest      string                           `json:"digest,omitempty"`
}

type MCPResourceTemplateSelection struct {
	MCPResourceTemplateRef

	ArgumentValues map[string]string `json:"argumentValues,omitempty"`
}

type MCPSecretKind string

type MCPSecretRef struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`
	Kind     MCPSecretKind            `json:"kind"`
	Slot     string                   `json:"slot,omitempty"`
}

type MCPServerCapabilitiesSummary struct {
	Tools                bool           `json:"tools,omitempty"`
	ToolsListChanged     bool           `json:"toolsListChanged,omitempty"`
	Resources            bool           `json:"resources,omitempty"`
	ResourcesSubscribe   bool           `json:"resourcesSubscribe,omitempty"`
	ResourcesListChanged bool           `json:"resourcesListChanged,omitempty"`
	Prompts              bool           `json:"prompts,omitempty"`
	PromptsListChanged   bool           `json:"promptsListChanged,omitempty"`
	Completions          bool           `json:"completions,omitempty"`
	Experimental         map[string]any `json:"experimental,omitempty"`
	Extensions           map[string]any `json:"extensions,omitempty"`
}

type MCPServerConfig struct {
	SchemaVersion string `json:"schemaVersion"`

	BundleID    bundleitemutils.BundleID `json:"bundleID"`
	ID          MCPServerID              `json:"id"`
	DisplayName string                   `json:"displayName"`
	Enabled     bool                     `json:"enabled"`
	Transport   MCPTransportType         `json:"transport"`

	TrustLevel MCPTrustLevel `json:"trustLevel"`

	Stdio          *MCPStdioConfig          `json:"stdio,omitempty"`
	StreamableHTTP *MCPStreamableHTTPConfig `json:"streamableHttp,omitempty"`

	DefaultPolicy MCPServerPolicy                  `json:"defaultPolicy"`
	ToolPolicies  map[string]MCPToolPolicyOverride `json:"toolPolicies,omitempty"`
	AppsPolicy    *MCPAppsPolicy                   `json:"appsPolicy,omitempty"`
	Setup         *MCPServerSetup                  `json:"setup,omitempty"`

	IsBuiltIn  bool      `json:"isBuiltIn"`
	CreatedAt  time.Time `json:"createdAt"`
	ModifiedAt time.Time `json:"modifiedAt"`
}

type MCPServerID string

type MCPServerPolicy struct {
	DefaultApprovalRule  MCPApprovalRule  `json:"defaultApprovalRule"`
	DefaultExecutionMode MCPExecutionMode `json:"defaultExecutionMode"`

	RequireApprovalForUnknownRisk bool `json:"requireApprovalForUnknownRisk"`
	RequireApprovalForWrite       bool `json:"requireApprovalForWrite"`
	RequireApprovalForDestructive bool `json:"requireApprovalForDestructive"`
}

type MCPServerRuntimeSnapshot struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`
	Status   MCPServerStatus          `json:"status"`

	NegotiatedProtocolVersion string                        `json:"negotiatedProtocolVersion,omitempty"`
	ServerInfo                *MCPImplementationInfo        `json:"serverInfo,omitempty"`
	ServerCapabilities        *MCPServerCapabilitiesSummary `json:"serverCapabilities,omitempty"`
	Instructions              string                        `json:"instructions,omitempty"`

	LastError       string `json:"lastError,omitempty"`
	LastConnectedAt string `json:"lastConnectedAt,omitempty"`
	LastSyncedAt    string `json:"lastSyncedAt,omitempty"`

	ToolCount             int `json:"toolCount"`
	ResourceCount         int `json:"resourceCount"`
	ResourceTemplateCount int `json:"resourceTemplateCount"`
	PromptCount           int `json:"promptCount"`

	SnapshotDigest string `json:"snapshotDigest,omitempty"`
}

type MCPServerSelection struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`

	SnapshotDigest string `json:"snapshotDigest,omitempty"`

	ToolExposure  MCPToolExposure    `json:"toolExposure"` // none | all | selected
	SelectedTools []MCPToolSelection `json:"selectedTools,omitempty"`

	IncludeServerInstructions bool `json:"includeServerInstructions,omitempty"`
}

type MCPServerSetup struct {
	Note   string                `json:"note,omitempty"`
	Inputs []MCPServerSetupInput `json:"inputs,omitempty"`
}

type MCPServerSetupInput struct {
	ID          string                  `json:"id"`
	Kind        MCPServerSetupInputKind `json:"kind"`
	Label       string                  `json:"label,omitempty"`
	Description string                  `json:"description,omitempty"`
	Note        string                  `json:"note,omitempty"`
	Placeholder string                  `json:"placeholder,omitempty"`
	Required    bool                    `json:"required,omitempty"`

	OAuthClientCredentials      *MCPSetupOAuthClientCredentialsInput      `json:"oauthClientCredentials,omitempty"`
	HTTPHeader                  *MCPSetupHTTPHeaderInput                  `json:"httpHeader,omitempty"`
	StdioEnv                    *MCPSetupStdioEnvInput                    `json:"stdioEnv,omitempty"`
	StreamableHTTPURL           *MCPSetupStreamableHTTPURLInput           `json:"streamableHttpUrl,omitempty"`
	ClientIDMetadataDocumentURL *MCPSetupClientIDMetadataDocumentURLInput `json:"clientIDMetadataDocumentURL,omitempty"`
}

type MCPServerSetupInputKind string

type MCPServerSetupInputValue struct {
	Value        string `json:"value,omitempty"`
	ClientID     string `json:"clientID,omitempty"`
	ClientSecret string `json:"clientSecret,omitempty"`
}

type MCPServerStatus string

type MCPSettings struct {
	// Empty means a random loopback port is used for this process.
	// Example fixed value: "127.0.0.1:37645".
	OAuthLoopbackListenAddr string `json:"oauthLoopbackListenAddr,omitempty"`
}

type MCPSettingsView struct {
	Settings                MCPSettings `json:"settings"`
	OAuthRedirectURL        string      `json:"oauthRedirectURL,omitempty"`
	OAuthLoopbackListenAddr string      `json:"oauthLoopbackListenAddr,omitempty"`
	OAuthRestartRequired    bool        `json:"oauthRestartRequired,omitempty"`
}

type MCPSetupClientIDMetadataDocumentURLInput struct{}

type MCPSetupHTTPHeaderInput struct {
	HeaderName string `json:"headerName"`
	// Secret stores the value in the secret store and references it via
	// secretHeaderRefs. Non-secret headers are stored inline.
	Secret      bool   `json:"secret,omitempty"`
	ValuePrefix string `json:"valuePrefix,omitempty"`
	ValueSuffix string `json:"valueSuffix,omitempty"`
}

type MCPSetupOAuthClientCredentialsInput struct {
	ClientSecretRequired bool `json:"clientSecretRequired,omitempty"`
}

type MCPSetupStdioEnvInput struct {
	EnvName     string `json:"envName"`
	Secret      bool   `json:"secret,omitempty"`
	ValuePrefix string `json:"valuePrefix,omitempty"`
	ValueSuffix string `json:"valueSuffix,omitempty"`
}

type MCPSetupStreamableHTTPURLInput struct{}

type MCPStdioConfig struct {
	Command          string            `json:"command"`
	Args             []string          `json:"args,omitempty"`
	WorkingDir       string            `json:"workingDir,omitempty"`
	Env              map[string]string `json:"env,omitempty"`
	SecretEnvRefs    map[string]string `json:"secretEnvRefs,omitempty"`
	StartupTimeoutMS int               `json:"startupTimeoutMS,omitempty"`
}

type MCPStdioConfigOverlay struct {
	Env           map[string]string `json:"env,omitempty"`
	SecretEnvRefs map[string]string `json:"secretEnvRefs,omitempty"`
}

type MCPStreamableHTTPConfig struct {
	URL       string          `json:"url"`
	TimeoutMS int             `json:"timeoutMS,omitempty"`
	AuthMode  MCPHTTPAuthMode `json:"authMode"`

	// Headers are non-secret HTTP headers sent to the MCP endpoint.
	Headers map[string]string `json:"headers,omitempty"`

	// SecretHeaderRefs maps HTTP header names to MCP secret refs. Use this for
	// API keys, PATs, or Authorization Bearer tokens.
	SecretHeaderRefs map[string]string `json:"secretHeaderRefs,omitempty"`

	// ClientCredentialRef references an MCP OAuth client credential secret.
	// For authMode "oauth", the secret may contain only clientID for a public
	// PKCE client, or clientID plus clientSecret for a confidential client.
	// For authMode "clientCredentials", clientSecret is required.
	ClientCredentialRef string `json:"clientCredentialRef,omitempty"`

	// ClientIDMetadataDocumentURL enables the standard OAuth Client ID Metadata
	// Document registration path supported by the official MCP Go SDK.
	ClientIDMetadataDocumentURL string `json:"clientIDMetadataDocumentURL,omitempty"`
}

type MCPStreamableHTTPConfigOverlay struct {
	URL       *string `json:"url,omitempty"`
	TimeoutMS *int    `json:"timeoutMS,omitempty"`

	Headers          map[string]string `json:"headers,omitempty"`
	SecretHeaderRefs map[string]string `json:"secretHeaderRefs,omitempty"`

	ClientCredentialRef         *string `json:"clientCredentialRef,omitempty"`
	ClientIDMetadataDocumentURL *string `json:"clientIDMetadataDocumentURL,omitempty"`
}

type MCPTaskSupport string

type MCPToolAnnotations struct {
	DestructiveHint *bool  `json:"destructiveHint,omitempty"`
	IdempotentHint  bool   `json:"idempotentHint"`
	OpenWorldHint   *bool  `json:"openWorldHint,omitempty"`
	ReadOnlyHint    bool   `json:"readOnlyHint"`
	Title           string `json:"title,omitempty"`
}

type MCPToolAppInfo struct {
	ResourceURI string   `json:"resourceUri,omitempty"`
	Visibility  []string `json:"visibility,omitempty"`
}

type MCPToolAppRenderInfo struct {
	ResourceURI       string       `json:"resourceUri,omitempty"`
	MimeType          string       `json:"mimeType,omitempty"`
	Content           []MCPContent `json:"content,omitempty"`
	StructuredContent any          `json:"structuredContent,omitempty"`
	IsError           bool         `json:"isError,omitempty"`
}

type MCPToolCallProvenance struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`

	ServerDisplayName string `json:"serverDisplayName,omitempty"`

	ToolName         string `json:"toolName"`
	ProviderToolName string `json:"providerToolName"`
	ToolDigest       string `json:"toolDigest,omitempty"`

	ToolUseID  string `json:"toolUseID,omitempty"`
	ApprovalID string `json:"approvalID,omitempty"`

	AppResourceURI string `json:"appResourceUri,omitempty"`
	AppInstanceID  string `json:"appInstanceID,omitempty"`
}

type MCPToolCapability struct {
	BundleID         bundleitemutils.BundleID `json:"bundleID"`
	ServerID         MCPServerID              `json:"serverID"`
	ToolName         string                   `json:"toolName"`
	ProviderToolName string                   `json:"providerToolName"`
	ChoiceID         string                   `json:"choiceID"`

	Title       string `json:"title,omitempty"`
	DisplayName string `json:"displayName"`
	Description string `json:"description,omitempty"`

	InputSchema  map[string]any `json:"inputSchema,omitempty"`
	OutputSchema map[string]any `json:"outputSchema,omitempty"`

	Annotations  *MCPToolAnnotations `json:"annotations,omitempty"`
	InferredRisk MCPToolRisk         `json:"inferredRisk"`

	ApprovalRule  MCPApprovalRule  `json:"approvalRule"`
	ExecutionMode MCPExecutionMode `json:"executionMode"`

	TaskSupport MCPTaskSupport `json:"taskSupport"`

	App *MCPToolAppInfo `json:"app,omitempty"`

	Digest  string `json:"digest"`
	Enabled bool   `json:"enabled"`
	Stale   bool   `json:"stale,omitempty"`
}

type MCPToolExposure string

type MCPToolPolicyOverride struct {
	ToolName string `json:"toolName"`

	ApprovalRule  *MCPApprovalRule  `json:"approvalRule,omitempty"`
	ExecutionMode *MCPExecutionMode `json:"executionMode,omitempty"`

	AllowStaleDigest bool   `json:"allowStaleDigest,omitempty"`
	ExpectedDigest   string `json:"expectedDigest,omitempty"`
}

type MCPToolRisk string

type MCPToolSelection struct {
	BundleID         bundleitemutils.BundleID `json:"bundleID"`
	ServerID         MCPServerID              `json:"serverID"`
	ToolName         string                   `json:"toolName"`
	ProviderToolName string                   `json:"providerToolName,omitempty"`
	ChoiceID         string                   `json:"choiceID,omitempty"`
	Digest           string                   `json:"digest,omitempty"`

	ApprovalRule  *MCPApprovalRule  `json:"approvalRule,omitempty"`
	ExecutionMode *MCPExecutionMode `json:"executionMode,omitempty"`

	AppResourceURI string   `json:"appResourceUri,omitempty"`
	Visibility     []string `json:"visibility,omitempty"`
}

type MCPTransportType string

type MCPTrustLevel string

type MCPUIResourceCSP struct {
	ConnectDomains  []string `json:"connectDomains,omitempty"`
	ResourceDomains []string `json:"resourceDomains,omitempty"`
	FrameDomains    []string `json:"frameDomains,omitempty"`
	BaseURIDomains  []string `json:"baseUriDomains,omitempty"`
}

type MCPUIResourceContent struct {
	BundleID bundleitemutils.BundleID `json:"bundleID"`
	ServerID MCPServerID              `json:"serverID"`
	URI      string                   `json:"uri"`
	MIMEType string                   `json:"mimeType"`
	HTML     string                   `json:"html"`
	Meta     *MCPUIResourceMeta       `json:"meta,omitempty"`
	Digest   string                   `json:"digest,omitempty"`
}

type MCPUIResourceMeta struct {
	CSP           *MCPUIResourceCSP         `json:"csp,omitempty"`
	Permissions   *MCPUIResourcePermissions `json:"permissions,omitempty"`
	Domain        string                    `json:"domain,omitempty"`
	PrefersBorder *bool                     `json:"prefersBorder,omitempty"`
}

type MCPUIResourcePermissions struct {
	Camera         map[string]any `json:"camera,omitempty"`
	Microphone     map[string]any `json:"microphone,omitempty"`
	Geolocation    map[string]any `json:"geolocation,omitempty"`
	ClipboardWrite map[string]any `json:"clipboardWrite,omitempty"`
}

type PatchMCPBundleRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	Body     *PatchMCPBundleRequestBody
}

type PatchMCPBundleRequestBody struct {
	IsEnabled bool `json:"isEnabled" required:"true"`
}

type PatchMCPBundleResponse struct{}

type PatchMCPServerEnabledRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *PatchMCPServerEnabledRequestBody
}

type PatchMCPServerEnabledRequestBody struct {
	Enabled bool `json:"enabled" required:"true"`
}

type PatchMCPServerEnabledResponse struct{}

type PatchMCPServerPolicyPayload struct {
	DefaultPolicy *MCPServerPolicy                 `json:"defaultPolicy,omitempty"`
	ToolPolicies  map[string]MCPToolPolicyOverride `json:"toolPolicies,omitempty"`
	AppsPolicy    *MCPAppsPolicy                   `json:"appsPolicy,omitempty"`
}

type PatchMCPServerPolicyRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *PatchMCPServerPolicyPayload
}

type PatchMCPServerPolicyResponse struct{}

type PatchMCPServerSetupRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *PatchMCPServerSetupRequestBody
}

type PatchMCPServerSetupRequestBody struct {
	// Reset clears existing user setup before applying. Only supported for
	// built-in servers.
	Reset bool `json:"reset,omitempty"`

	// InputValues are keyed by MCPServerSetupInput.ID declared on the server.
	InputValues map[string]MCPServerSetupInputValue `json:"inputValues,omitempty"`
}

type PatchMCPServerSetupResponse struct {
	Body *MCPServerConfig
}

type PatchMCPSettingsRequest struct {
	Body *PatchMCPSettingsRequestBody
}

type PatchMCPSettingsRequestBody struct {
	OAuthLoopbackListenAddr *string `json:"oauthLoopbackListenAddr,omitempty"`
}

type PatchMCPSettingsResponse struct {
	Body *MCPSettingsView
}

type PutMCPBundleRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	Body     *PutMCPBundleRequestBody
}

type PutMCPBundleRequestBody struct {
	Slug        bundleitemutils.BundleSlug `json:"slug"                  required:"true"`
	DisplayName string                     `json:"displayName"           required:"true"`
	IsEnabled   bool                       `json:"isEnabled"             required:"true"`
	Description string                     `json:"description,omitempty"`
}

type PutMCPBundleResponse struct{}

type PutMCPServerPayload struct {
	DisplayName string           `json:"displayName" required:"true"`
	Enabled     bool             `json:"enabled"     required:"true"`
	Transport   MCPTransportType `json:"transport"   required:"true"`

	TrustLevel MCPTrustLevel `json:"trustLevel,omitempty"`

	Stdio          *MCPStdioConfig                  `json:"stdio,omitempty"`
	StreamableHTTP *MCPStreamableHTTPConfig         `json:"streamableHttp,omitempty"`
	DefaultPolicy  *MCPServerPolicy                 `json:"defaultPolicy,omitempty"`
	ToolPolicies   map[string]MCPToolPolicyOverride `json:"toolPolicies,omitempty"`
	AppsPolicy     *MCPAppsPolicy                   `json:"appsPolicy,omitempty"`
	Setup          *MCPServerSetup                  `json:"setup,omitempty"`
}

type PutMCPServerRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *PutMCPServerPayload
}

type PutMCPServerResponse struct{}

type PutMCPServerSecretRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`

	Body *PutMCPServerSecretRequestBody
}

type PutMCPServerSecretRequestBody struct {
	Kind   MCPSecretKind `json:"kind"   required:"true"`
	Slot   string        `json:"slot"   required:"true"`
	Secret string        `json:"secret" required:"true"`
}

type PutMCPServerSecretResponse struct {
	Body *PutMCPServerSecretResponseBody
}

type PutMCPServerSecretResponseBody struct {
	SecretRef string `json:"secretRef"`
	SHA256    string `json:"sha256,omitempty"`
	NonEmpty  bool   `json:"nonEmpty"`
}

type RefreshMCPServerRequest struct {
	BundleID bundleitemutils.BundleID `path:"bundleID" required:"true"`
	ServerID MCPServerID              `path:"serverID" required:"true"`
}

type RefreshMCPServerResponse struct {
	Body *MCPServerRuntimeSnapshot
}

type ResolveMCPApprovalRequest struct {
	Body *ResolveMCPApprovalRequestBody
}

type ResolveMCPApprovalRequestBody struct {
	ApprovalID string                `json:"approvalID" required:"true"`
	Resolution MCPApprovalResolution `json:"resolution" required:"true"`
}

type ResolveMCPApprovalResponse struct {
	Body *MCPApprovalToken
}

type TimeRange struct {
	From *time.Time `json:"from,omitempty"`
	To   *time.Time `json:"to,omitempty"`
}