Documentation
¶
Overview ¶
Package api provides primitives to interact with the openapi HTTP API.
Code generated by github.com/oapi-codegen/oapi-codegen/v2 version v2.8.0 DO NOT EDIT.
RFC 9457 problem+json helpers. Every non-2xx response the API emits goes through this file so the error contract can't drift per-handler.
Package api is the HTTP layer (L2/L3 seam): generated OpenAPI server stubs, middleware, health endpoints, and well-known documents. Route authorization declarations live in authz_routes.go.
Index ¶
- Constants
- Variables
- func AllMountAuthzDecls() map[string]MountDecl
- func AllRouteAuthzDecls() map[string]RouteDecl
- func GetSpec() (swagger *openapi3.T, err error)
- func GetSpecJSON() ([]byte, error)
- func GetSwagger() (*openapi3.T, error)deprecated
- func Handler(si ServerInterface) http.Handler
- func HandlerFromMux(si ServerInterface, m ServeMux) http.Handler
- func HandlerFromMuxWithBaseURL(si ServerInterface, m ServeMux, baseURL string) http.Handler
- func HandlerWithOptions(si ServerInterface, options StdHTTPServerOptions) http.Handler
- func Mount(mux httpmux.Mux, pattern string, handler http.Handler)
- func MountFunc(mux httpmux.Mux, pattern string, ...)
- func NewHandler(s *Server) http.Handler
- func NewHandlerWithGit(s *Server, mountGit func(httpmux.Mux)) http.Handler
- func NormalizeOpID(id string) string
- func PathToRawSpec(pathToFile string) map[string]func() ([]byte, error)
- func PendingDigestPeriod(cfg config.Config) time.Duration
- func PrincipalFrom(ctx context.Context) *auth.Principal
- type AbuseReport
- type AbuseReportState
- type AccessRequestResult
- type AccountChange
- type AccountEraser
- type AccountErasure
- type AccountErasureKind
- type AccountFacts
- type AccountInstall
- type AccountInstallQuarantineState
- type AccountInstallRequest
- type AccountOrg
- type AccountSession
- type AccountToken
- type ActivationTooSoonError
- type ActivityEvent
- type ActivityPage
- type AddSshKeyJSONRequestBody
- type AddSshKeyRequest
- type Advisory
- type Agent
- type AgentForkState
- type AgentGrant
- type AgentGrantKind
- type AgentMode
- type AgentModes
- type AgentName
- type AgentQuarantineState
- type AgentRole
- type AgentStats
- type AgentVersion
- type AgentVersionChannel
- type AgentVersionManifestSchemaVersion
- type AgentVersionScanStatus
- type AgentVisibility
- type ApproveOrgMemberJSONBody
- type ApproveOrgMemberJSONRequestBody
- type AuditEvent
- type AuditEventActorKind
- type AuditExport
- type AuditExportStatus
- type AuditPage
- type BrandInfo
- type CheckDraftJSONRequestBody
- type ConnectorInfo
- type ConnectorInfoStrategy
- type ConnectorList
- type CreateAgentJSONRequestBody
- type CreateAgentRequest
- type CreateAgentRequestVisibility
- type CreateAuditExportJSONBody
- type CreateAuditExportJSONRequestBody
- type CreateDesktopGrantJSONRequestBody
- type CreateDomainClaimJSONBody
- type CreateDomainClaimJSONRequestBody
- type CreateInvitationJSONRequestBody
- type CreateInvitationRequest
- type CreateKnowledgePackJSONRequestBody
- type CreateKnowledgePackRequest
- type CreateOrgJSONRequestBody
- type CreateOrgKnowledgePackJSONRequestBody
- type CreateOrgRequest
- type CreateRulesetReleaseJSONBody
- type CreateRulesetReleaseJSONRequestBody
- type CreateTeamJSONBody
- type CreateTeamJSONRequestBody
- type CreateTokenJSONRequestBody
- type CreateTokenRequest
- type CreateWebhookJSONRequestBody
- type CreatedInvitation
- type Cursor
- type DecideReviewItemJSONBody
- type DecideReviewItemJSONBodyDecision
- type DecideReviewItemJSONRequestBody
- type DecommissionOrgJSONBody
- type DecommissionOrgJSONRequestBody
- type DeleteAgentParams
- type DeleteCurrentUserParams
- type DeleteCurrentUserParamsPublishedContent
- type DependencyAlert
- type DependencyAlertEcosystem
- type DependencyAlertSeverity
- type DesktopExchangeRequest
- type DesktopGrant
- type DesktopGrantRequest
- type Directory
- type DirectoryAccount
- type DirectoryDevice
- type DirectoryErasure
- type DirectoryLink
- type DirectoryLookup
- type DirectorySignInFacts
- type DirectorySource
- type DomainClaim
- type DomainOrg
- type DraftCheck
- type DraftCheckFailure
- type DraftCheckFile
- type DraftCheckRequest
- type DraftCheckVerdict
- type DraftChecker
- type DraftRubricCheck
- type DraftRubricFinding
- type DraftRubricFindingId
- type DraftRubricFindingSeverity
- type DraftRubricScores
- type DraftSetCheck
- type DraftSetCheckFlagged
- type DraftSetScores
- type DraftUngrantedTool
- type DraftUngrantedToolGrant
- type EmailNotificationSettings
- type EmailVerificationSent
- type ErasedAccount
- type ErasureTx
- type Event
- type ExchangeDesktopCodeJSONRequestBody
- type ExtensionCallbacks
- type ExtensionTokenResolver
- type FieldError
- type ForkAgentJSONBody
- type ForkAgentJSONRequestBody
- type ForkOrigin
- type GetAgentReadmeParams
- type GetMcpServerScanParams
- type GetMcpServerScanParamsEcosystem
- type GetReviewFileParams
- type GetUserReportSettingsParams
- type GetVersionFileParams
- type Handle
- type InvalidParamFormatError
- type Invitation
- type InvitationOffer
- type JudgeUsage
- type KnowledgeAdmission
- type KnowledgeAdmitter
- type KnowledgeDataKey
- type KnowledgePack
- type KnowledgePackId
- type KnowledgePackSize
- type KnowledgePackState
- type KnowledgeScanReport
- type KnowledgeScanReportFindingsPart
- type KnowledgeScanReportFindingsSeverity
- type KnowledgeShipping
- type KnowledgeUsage
- type KnowledgeWrappedKey
- type LastAdminError
- type Limit100
- type Limit200
- type ListAbuseReportsParams
- type ListAbuseReportsParamsState
- type ListAdvisoriesParams
- type ListAgentActivityParams
- type ListAgentsByTagParams
- type ListAgentsParams
- type ListAgentsParamsForks
- type ListAgentsParamsSort
- type ListAgentsParamsState
- type ListKnowledgePackSizesParams
- type ListOrgAuditParams
- type ListPlatformAuditParams
- type ListRedTeamReportsParams
- type ListReviewQueueParams
- type ListReviewQueueParamsQueue
- type ListUserActivityParams
- type ListWebhookDeliveriesParams
- type LoginResult
- type McpAdvisory
- type McpAdvisoryGateSeverity
- type McpAdvisorySeverity
- type McpServerScan
- type McpServerScanEcosystem
- type McpServerScanMaxSeverity
- type McpServerScanStatus
- type Membership
- type MembershipState
- type Meta
- type MiddlewareFunc
- type ModelInputCall
- type ModelInputCallers
- type ModelInputChunk
- type ModelInputChunkFailure
- type ModelInputOp
- type ModelInputScan
- type ModelInputScanFlagged
- type ModelInputScanRequest
- type ModelInputScanner
- type ModelInputScores
- type ModelInputSource
- type ModelInputUsage
- type ModelInputUse
- type ModelInputVerdict
- type MountDecl
- type MountGate
- type Namespace
- type NotificationSettings
- type Option
- type Org
- type OrgHandle
- type OrgRole
- type OrgRoleAssignment
- type OrgState
- type Pat
- type PatCreated
- type PendingOrg
- type PendingOrgVia
- type PlatformAgentActionJSONBody
- type PlatformAgentActionJSONRequestBody
- type PlatformAgentActionParamsAction
- type PlatformReinstateAccepted
- type Problem
- type ProvisionedMember
- type PublicUser
- type PutAccountInstallJSONRequestBody
- type PutOrgLogoMultipartBody
- type PutOrgLogoMultipartRequestBody
- type PutUserReportLogoMultipartBody
- type PutUserReportLogoMultipartRequestBody
- type PutVoiceJSONRequestBody
- type PutVoiceRequest
- type PutVoiceRequestSource
- type RedTeamReport
- type ReportAbuseJSONBody
- type ReportAbuseJSONBodyCategory
- type ReportAbuseJSONRequestBody
- type ReportDesign
- type ReportDesignAgentryTheme
- type ReportDesignBasedOn
- type ReportDesignFontsBody
- type ReportDesignFontsCode
- type ReportDesignFontsHeadings
- type ReportDesignFooterPageNumbers
- type ReportDesignHeadings
- type ReportDesignPaper
- type ReportDesignQuotes
- type ReportDesignTitleBlock
- type ReportSettings
- type ReportSettingsInclude
- type ReportVerdict
- type RequiredHeaderError
- type RequiredParamError
- type RescanInFlight
- type ResolveRefParams
- type ResolveRefParamsChannel
- type ResolveResult
- type ResolveResultScanStatus
- type ReviewBundle
- type ReviewFileContent
- type ReviewFileEntry
- type ReviewFileList
- type ReviewItem
- type ReviewItemQueue
- type RouteDecl
- type RulesetRelease
- type ScanFinding
- type ScanFindingConfidence
- type ScanFindingSeverity
- type ScanFindingVerdict
- type ScanModelInputJSONRequestBody
- type ScanReport
- type Scope
- type ScopeGranted
- type SearchAgentsParams
- type SearchAgentsParamsSort
- type SearchHit
- type SearchHitQuarantineState
- type SearchModelInputJSONRequestBody
- type SearchResults
- type Seats
- type ServeMux
- type Server
- func (s *Server) AcceptInvitation(w http.ResponseWriter, r *http.Request, token string)
- func (s *Server) AccountErasers() []string
- func (s *Server) AccountFacts(ctx context.Context, actor *auth.Principal, userID uuid.UUID) (AccountFacts, error)
- func (s *Server) ActivateOrg(ctx context.Context, orgID uuid.UUID) (bool, error)
- func (s *Server) AddAccountEraser(name string, fn AccountEraser)
- func (s *Server) AddEventHook(h func(ctx context.Context, ev Event))
- func (s *Server) AddSignInHook(h func(ctx context.Context, in SignIn))
- func (s *Server) AddSshKey(w http.ResponseWriter, r *http.Request)
- func (s *Server) AddTeamMember(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug, ...)
- func (s *Server) AgentMaintainable(ctx context.Context, p *auth.Principal, ns, name string) (registry.Agent, bool, error)
- func (s *Server) AgentPublishable(ctx context.Context, p *auth.Principal, ns, name string) (registry.Agent, bool, error)
- func (s *Server) AgentReadable(ctx context.Context, p *auth.Principal, ns, name string) (registry.Agent, bool, error)
- func (s *Server) ApproveOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
- func (s *Server) BaseURL() string
- func (s *Server) Blobs() registry.BlobStore
- func (s *Server) CheckDraft(w http.ResponseWriter, r *http.Request)
- func (s *Server) ClearCurrentUserData(w http.ResponseWriter, r *http.Request)
- func (s *Server) ClearTrustedDevices(w http.ResponseWriter, r *http.Request)
- func (s *Server) Close() error
- func (s *Server) CoreEntitlements() entitlements.Resolver
- func (s *Server) CountTrustedDevices(w http.ResponseWriter, r *http.Request)
- func (s *Server) CreateAgent(w http.ResponseWriter, r *http.Request)
- func (s *Server) CreateAuditExport(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) CreateDesktopGrant(w http.ResponseWriter, r *http.Request)
- func (s *Server) CreateDomainClaim(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) CreateInvitation(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) CreateKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (s *Server) CreateOrg(w http.ResponseWriter, r *http.Request)
- func (s *Server) CreateOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) CreateRulesetRelease(w http.ResponseWriter, r *http.Request)
- func (s *Server) CreateTeam(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) CreateToken(w http.ResponseWriter, r *http.Request)
- func (s *Server) CreateWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) DecideReviewItem(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
- func (s *Server) DeclineOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
- func (s *Server) DecommissionOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) DecommissionOrgByExtension(ctx context.Context, orgID uuid.UUID, reason string) (bool, error)
- func (s *Server) DeferTagArchives()
- func (s *Server) DeleteAccountInstall(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) DeleteAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) DeleteCurrentUser(w http.ResponseWriter, r *http.Request, params DeleteCurrentUserParams)
- func (s *Server) DeleteKnowledgePack(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
- func (s *Server) DeleteOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, ...)
- func (s *Server) DeleteOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) DeleteTeam(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)
- func (s *Server) DeleteUserReportLogo(w http.ResponseWriter, r *http.Request)
- func (s *Server) DeleteVoice(w http.ResponseWriter, r *http.Request)
- func (s *Server) DeleteWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
- func (s *Server) DeliverWebhook(ctx context.Context, orgID, endpointID uuid.UUID, event string, data any) (bool, error)
- func (s *Server) DeprovisionMember(ctx context.Context, ext string, orgID, userID uuid.UUID) (kept bool, err error)
- func (s *Server) DiscardVoicePending(w http.ResponseWriter, r *http.Request)
- func (s *Server) DownloadKnowledgeTree(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
- func (s *Server) DownloadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request, org OrgHandle, ...)
- func (s *Server) DownloadVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) EraseAccount(r *http.Request, ext string, actor *auth.Principal, userID uuid.UUID, ...) (AccountErasure, error)
- func (s *Server) ExchangeDesktopCode(w http.ResponseWriter, r *http.Request)
- func (s *Server) ExportKnowledgePack(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
- func (s *Server) ExportOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, ...)
- func (s *Server) ExtensionDeps() (*pgxpool.Pool, *slog.Logger, func(context.Context, audit.Event) error, ...)
- func (s *Server) ExtensionNames() []string
- func (s *Server) ExtensionSealer(name string) (*auth.Sealer, error)
- func (s *Server) ExtensionUnthrottled() map[string]bool
- func (s *Server) ForkAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) GetAdvisory(w http.ResponseWriter, r *http.Request, advisoryID openapi_types.UUID)
- func (s *Server) GetAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) GetAgentReadme(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) GetAgentStats(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) GetAuditExport(w http.ResponseWriter, r *http.Request, org OrgHandle, id openapi_types.UUID)
- func (s *Server) GetConnectors(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetCurrentUser(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetDomainOrg(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetInvitation(w http.ResponseWriter, r *http.Request, token string)
- func (s *Server) GetKnowledgePack(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
- func (s *Server) GetKnowledgeUsage(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetLatestRulesetAttestation(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetLatestRulesetBundle(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetMcpServerScan(w http.ResponseWriter, r *http.Request, params GetMcpServerScanParams)
- func (s *Server) GetMeta(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) GetOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, ...)
- func (s *Server) GetOrgKnowledgeUsage(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) GetOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) GetOrgPolicy(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) GetPlatformPolicy(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetReviewFile(w http.ResponseWriter, r *http.Request, id openapi_types.UUID, ...)
- func (s *Server) GetReviewItem(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
- func (s *Server) GetUserNotificationSettings(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetUserProfile(w http.ResponseWriter, r *http.Request, handle Handle)
- func (s *Server) GetUserReportSettings(w http.ResponseWriter, r *http.Request, params GetUserReportSettingsParams)
- func (s *Server) GetVersionAttestation(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) GetVersionFile(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) GetVersionInfo(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) GetVersionManifest(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) GetVersionReport(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) GetVoice(w http.ResponseWriter, r *http.Request)
- func (s *Server) GetWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
- func (s *Server) HandOffScans()
- func (s *Server) HasDirectory() bool
- func (s *Server) Knowledge() *knowledge.Service
- func (s *Server) ListAbuseReports(w http.ResponseWriter, r *http.Request, params ListAbuseReportsParams)
- func (s *Server) ListAccountInstalls(w http.ResponseWriter, r *http.Request)
- func (s *Server) ListAdvisories(w http.ResponseWriter, r *http.Request, params ListAdvisoriesParams)
- func (s *Server) ListAgentActivity(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) ListAgentGrants(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) ListAgents(w http.ResponseWriter, r *http.Request, params ListAgentsParams)
- func (s *Server) ListAgentsByTag(w http.ResponseWriter, r *http.Request, tag string, ...)
- func (s *Server) ListDomainClaims(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) ListInvitations(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) ListKnowledgePackSizes(w http.ResponseWriter, r *http.Request, params ListKnowledgePackSizesParams)
- func (s *Server) ListKnowledgePacks(w http.ResponseWriter, r *http.Request)
- func (s *Server) ListOrgAudit(w http.ResponseWriter, r *http.Request, org OrgHandle, ...)
- func (s *Server) ListOrgKnowledgePacks(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) ListOrgMembers(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) ListPlatformAudit(w http.ResponseWriter, r *http.Request, params ListPlatformAuditParams)
- func (s *Server) ListRedTeamReports(w http.ResponseWriter, r *http.Request, params ListRedTeamReportsParams)
- func (s *Server) ListReviewFiles(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
- func (s *Server) ListReviewQueue(w http.ResponseWriter, r *http.Request, params ListReviewQueueParams)
- func (s *Server) ListRulesetReleases(w http.ResponseWriter, r *http.Request)
- func (s *Server) ListSshKeys(w http.ResponseWriter, r *http.Request)
- func (s *Server) ListTeamMembers(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)
- func (s *Server) ListTeams(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) ListTokens(w http.ResponseWriter, r *http.Request)
- func (s *Server) ListUserActivity(w http.ResponseWriter, r *http.Request, params ListUserActivityParams)
- func (s *Server) ListUserDependencyAlerts(w http.ResponseWriter, r *http.Request)
- func (s *Server) ListUserSessions(w http.ResponseWriter, r *http.Request)
- func (s *Server) ListVersionFiles(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) ListVersions(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) ListWebhookDeliveries(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID, ...)
- func (s *Server) ListWebhooks(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) Logout(w http.ResponseWriter, r *http.Request)
- func (s *Server) MCPSweepReady() bool
- func (s *Server) Metrics() *metrics.Metrics
- func (s *Server) ModelInputCallers() ModelInputCallers
- func (s *Server) MountAuthzDecl(pattern string) (MountDecl, bool)
- func (s *Server) MountedRoutes() []string
- func (s *Server) Notifier() notify.Notifier
- func (s *Server) OrgAdminIDs(ctx context.Context, orgID uuid.UUID) ([]uuid.UUID, error)
- func (s *Server) OrgReadable(ctx context.Context, orgID uuid.UUID) (bool, error)
- func (s *Server) OrgWritable(ctx context.Context, orgID uuid.UUID) (bool, error)
- func (s *Server) PingWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
- func (s *Server) Pipeline() *scan.Pipeline
- func (s *Server) PlatformAgentAction(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) PlatformStaff(ctx context.Context) ([]StaffMember, error)
- func (s *Server) PrincipalForSchedule(ctx context.Context, userID, scheduleID uuid.UUID) (*auth.Principal, bool, error)
- func (s *Server) PrincipalForUser(ctx context.Context, userID uuid.UUID) (*auth.Principal, bool, error)
- func (s *Server) ProvisionMember(ctx context.Context, ext string, orgID uuid.UUID, p ProvisionedMember) (uuid.UUID, error)
- func (s *Server) PutAccountInstall(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) PutOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) PutUserReportLogo(w http.ResponseWriter, r *http.Request)
- func (s *Server) PutVoice(w http.ResponseWriter, r *http.Request)
- func (s *Server) Readyz(w http.ResponseWriter, r *http.Request)
- func (s *Server) Reg() *registry.Service
- func (s *Server) RegisterExtension(name string, routes func(*http.ServeMux))
- func (s *Server) RegisterExtensionCallbacks(name string, cb ExtensionCallbacks)
- func (s *Server) RegisterQueueHandlers(q queue.Client)
- func (s *Server) ReinstateAccount(ctx context.Context, ext string, actor *auth.Principal, userID uuid.UUID, ...) (AccountChange, error)
- func (s *Server) ReinstateOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) RemoveAgentTeamGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) RemoveAgentUserGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) RemoveOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
- func (s *Server) RemoveSshKey(w http.ResponseWriter, r *http.Request, keyID openapi_types.UUID)
- func (s *Server) RemoveTeamMember(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug, ...)
- func (s *Server) ReportAbuse(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) ReportDesign(ctx context.Context, user uuid.UUID) ([]byte, error)
- func (s *Server) ReportDesignWithLogo(ctx context.Context, user uuid.UUID) ([]byte, error)
- func (s *Server) ReportTheme(ctx context.Context, user uuid.UUID) (string, error)
- func (s *Server) RequestDomainOrgAccess(w http.ResponseWriter, r *http.Request)
- func (s *Server) ResendActivation(ctx context.Context, ext string, actor *auth.Principal, userID uuid.UUID, ...) (time.Time, error)
- func (s *Server) ResolveRef(w http.ResponseWriter, r *http.Request, params ResolveRefParams)
- func (s *Server) RestoreAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) RestoreVoice(w http.ResponseWriter, r *http.Request)
- func (s *Server) RetireAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) RevokeInvitation(w http.ResponseWriter, r *http.Request, org OrgHandle, id openapi_types.UUID)
- func (s *Server) RevokeOtherUserSessions(w http.ResponseWriter, r *http.Request)
- func (s *Server) RevokeToken(w http.ResponseWriter, r *http.Request, tokenID openapi_types.UUID)
- func (s *Server) RevokeUserSession(w http.ResponseWriter, r *http.Request, sessionID openapi_types.UUID)
- func (s *Server) RunFoldInSweep(ctx context.Context, orgID uuid.UUID, domain string) (int, error)
- func (s *Server) RunOrgDecommissionSweep(ctx context.Context) (int, error)
- func (s *Server) RunPendingMembersDigest(ctx context.Context, only uuid.UUID) (int, error)
- func (s *Server) RunRedTeamNow(ctx context.Context) error
- func (s *Server) RunTrustedDeviceSweep(ctx context.Context) (int64, error)
- func (s *Server) ScanModelInput(w http.ResponseWriter, r *http.Request)
- func (s *Server) SearchAgents(w http.ResponseWriter, r *http.Request, params SearchAgentsParams)
- func (s *Server) SearchModelInput(w http.ResponseWriter, r *http.Request)
- func (s *Server) SendEmailVerification(w http.ResponseWriter, r *http.Request)
- func (s *Server) SendToUser(ctx context.Context, userID uuid.UUID, kind, subject, text string) (bool, error)
- func (s *Server) SetAgentTeamGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) SetAgentUserGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) SetDirectory(d Directory)
- func (s *Server) SetDraftChecker(c DraftChecker)
- func (s *Server) SetEntitlements(r entitlements.Resolver)
- func (s *Server) SetExtensionTokens(name, prefix string, resolve ExtensionTokenResolver)
- func (s *Server) SetExtensionUnthrottled(name string, routes []string)
- func (s *Server) SetFindingVerdict(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
- func (s *Server) SetImageProxyClient(c *http.Client)
- func (s *Server) SetKeyWrapper(w knowledge.KeyWrapper)
- func (s *Server) SetKnowledgeAdmitter(a KnowledgeAdmitter)
- func (s *Server) SetMCPScanning(client scan.OSVClient)
- func (s *Server) SetMetrics(m *metrics.Metrics)
- func (s *Server) SetModelInputCallers(c ModelInputCallers)
- func (s *Server) SetModelInputScanner(sc ModelInputScanner)
- func (s *Server) SetNotifier(n notify.Notifier)
- func (s *Server) SetOIDCHTTPClient(c *http.Client)
- func (s *Server) SetOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
- func (s *Server) SetOrgPolicy(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) SetResolver(r dnsx.Resolver)
- func (s *Server) SetVoiceAdmitter(a VoiceAdmitter)
- func (s *Server) SetVoiceJudge(j voice.Judge)
- func (s *Server) SetWebSearch(p websearch.Provider)
- func (s *Server) SetWebhookDispatcher(d *webhook.Dispatcher)
- func (s *Server) SignOutAccount(ctx context.Context, ext string, actor *auth.Principal, userID uuid.UUID, ...) (AccountChange, error)
- func (s *Server) SocialOidcCallback(w http.ResponseWriter, r *http.Request, ...)
- func (s *Server) SocialOidcStart(w http.ResponseWriter, r *http.Request, provider SocialOidcStartParamsProvider, ...)
- func (s *Server) StarAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) StreamVersionEvents(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- func (s *Server) SubmitVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) SuspendAccount(ctx context.Context, ext string, actor *auth.Principal, userID uuid.UUID, ...) (AccountChange, error)
- func (s *Server) SuspendOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) TellSecondFactorsRemoved(ctx context.Context, actor *auth.Principal, userID uuid.UUID, removed int) (bool, error)
- func (s *Server) TriageAbuseReport(w http.ResponseWriter, r *http.Request, id uuid.UUID)
- func (s *Server) UnstarAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) UnwrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
- func (s *Server) UnwrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) UpdateAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
- func (s *Server) UpdateCurrentUser(w http.ResponseWriter, r *http.Request)
- func (s *Server) UpdateOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) UpdateOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, ...)
- func (s *Server) UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)
- func (s *Server) UpdateUserReportSettings(w http.ResponseWriter, r *http.Request, params UpdateUserReportSettingsParams)
- func (s *Server) UpdateVoiceSettings(w http.ResponseWriter, r *http.Request)
- func (s *Server) UpdateWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
- func (s *Server) UploadKnowledgeTree(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
- func (s *Server) UploadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request, org OrgHandle, ...)
- func (s *Server) UseRememberedBrowser(r *http.Request, userID uuid.UUID, token string, detail map[string]any) (bool, error)
- func (s *Server) VerifyDomainClaim(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) VerifyEmail(w http.ResponseWriter, r *http.Request)
- func (s *Server) Voice() *voice.Service
- func (s *Server) WebhookEndpoints(ctx context.Context, orgID uuid.UUID) ([]WebhookEndpointRef, error)
- func (s *Server) WrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
- func (s *Server) WrapMiddleware(h http.Handler) http.Handler
- func (s *Server) WrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request, org OrgHandle)
- func (s *Server) YankVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, ...)
- type ServerInterface
- type ServerInterfaceWrapper
- func (siw *ServerInterfaceWrapper) AcceptInvitation(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) AddSshKey(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) AddTeamMember(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ApproveOrgMember(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CheckDraft(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ClearCurrentUserData(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ClearTrustedDevices(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CountTrustedDevices(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateAgent(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateAuditExport(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateDesktopGrant(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateDomainClaim(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateInvitation(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateOrg(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateRulesetRelease(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateTeam(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateToken(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) CreateWebhook(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DecideReviewItem(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeclineOrgMember(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DecommissionOrg(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteAccountInstall(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteAgent(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteCurrentUser(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteOrgLogo(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteTeam(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteUserReportLogo(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteVoice(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteWebhook(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DiscardVoicePending(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DownloadKnowledgeTree(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DownloadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DownloadVersion(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ExchangeDesktopCode(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ExportKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ExportOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ForkAgent(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetAdvisory(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetAgent(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetAgentReadme(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetAgentStats(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetAuditExport(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetConnectors(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetCurrentUser(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetDomainOrg(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetInvitation(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetKnowledgeUsage(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetLatestRulesetAttestation(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetLatestRulesetBundle(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetMcpServerScan(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetMeta(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetOrg(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetOrgKnowledgeUsage(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetOrgLogo(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetOrgPolicy(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetPlatformPolicy(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetReviewFile(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetReviewItem(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetUserNotificationSettings(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetUserProfile(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetUserReportSettings(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetVersionAttestation(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetVersionFile(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetVersionInfo(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetVersionManifest(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetVersionReport(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetVoice(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) GetWebhook(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListAbuseReports(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListAccountInstalls(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListAdvisories(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListAgentActivity(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListAgentGrants(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListAgents(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListAgentsByTag(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListDomainClaims(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListInvitations(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListKnowledgePackSizes(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListKnowledgePacks(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListOrgAudit(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListOrgKnowledgePacks(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListOrgMembers(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListPlatformAudit(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListRedTeamReports(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListReviewFiles(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListReviewQueue(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListRulesetReleases(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListSshKeys(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListTeamMembers(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListTeams(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListTokens(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListUserActivity(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListUserDependencyAlerts(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListUserSessions(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListVersionFiles(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListVersions(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListWebhookDeliveries(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ListWebhooks(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) Logout(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PingWebhook(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PlatformAgentAction(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PutAccountInstall(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PutOrgLogo(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PutUserReportLogo(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PutVoice(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ReinstateOrg(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RemoveAgentTeamGrant(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RemoveAgentUserGrant(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RemoveOrgMember(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RemoveSshKey(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RemoveTeamMember(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ReportAbuse(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RequestDomainOrgAccess(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ResolveRef(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RestoreAgent(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RestoreVoice(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RetireAgent(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RevokeInvitation(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RevokeOtherUserSessions(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RevokeToken(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) RevokeUserSession(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) ScanModelInput(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SearchAgents(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SearchModelInput(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SendEmailVerification(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SetAgentTeamGrant(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SetAgentUserGrant(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SetFindingVerdict(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SetOrgMember(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SetOrgPolicy(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SocialOidcCallback(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SocialOidcStart(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) StarAgent(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) StreamVersionEvents(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SubmitVersion(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) SuspendOrg(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) TriageAbuseReport(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UnstarAgent(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UnwrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UnwrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateAgent(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateCurrentUser(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateOrg(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateUserReportSettings(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateVoiceSettings(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateWebhook(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UploadKnowledgeTree(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UploadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) VerifyDomainClaim(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) VerifyEmail(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) WrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) WrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) YankVersion(w http.ResponseWriter, r *http.Request)
- type SessionInfo
- type SessionList
- type SetAgentTeamGrantJSONBody
- type SetAgentTeamGrantJSONRequestBody
- type SetAgentUserGrantJSONBody
- type SetAgentUserGrantJSONRequestBody
- type SetFindingVerdictJSONBody
- type SetFindingVerdictJSONBodyVerdict
- type SetFindingVerdictJSONRequestBody
- type SetOrgMemberJSONBody
- type SetOrgMemberJSONRequestBody
- type SetOrgPolicyJSONBody
- type SetOrgPolicyJSONRequestBody
- type ShippedKnowledgeRecord
- type ShippedKnowledgeScan
- type ShippedPack
- type ShippedPackOrigin
- type ShippedPackOriginKind
- type SignIn
- type SocialOidcCallbackParams
- type SocialOidcCallbackParamsProvider
- type SocialOidcStartParams
- type SocialOidcStartParamsProvider
- type SocialProvider
- type SshKey
- type StaffMember
- type StdHTTPServerOptions
- type SubmitVersionJSONBody
- type SubmitVersionJSONRequestBody
- type SubmitVersionMultipartBody
- type SubmitVersionMultipartRequestBody
- type SuspendOrgJSONBody
- type SuspendOrgJSONRequestBody
- type TagPage
- type Team
- type TeamSlug
- type TooManyValuesForParamError
- type TriageAbuseReportJSONBody
- type TriageAbuseReportJSONBodyState
- type TriageAbuseReportJSONRequestBody
- type TrustedDevicesCleared
- type TrustedDevicesCount
- type UIInfo
- type UIInfoMode
- type UnescapedCookieParamError
- type UnmarshalingParamError
- type UnwrapKnowledgeKeyJSONRequestBody
- type UnwrapOrgKnowledgeKeyJSONRequestBody
- type UpdateAgentJSONBody
- type UpdateAgentJSONBodyVisibility
- type UpdateAgentJSONRequestBody
- type UpdateCurrentUserJSONBody
- type UpdateCurrentUserJSONRequestBody
- type UpdateKnowledgePackRequest
- type UpdateOrgJSONBody
- type UpdateOrgJSONRequestBody
- type UpdateOrgKnowledgePackJSONRequestBody
- type UpdateUserNotificationSettingsJSONRequestBody
- type UpdateUserReportSettingsJSONRequestBody
- type UpdateUserReportSettingsParams
- type UpdateVoiceSettingsJSONRequestBody
- type UpdateWebhookJSONBody
- type UpdateWebhookJSONRequestBody
- type User
- type VerifyDomainClaimJSONBody
- type VerifyDomainClaimJSONRequestBody
- type VerifyEmailJSONBody
- type VerifyEmailJSONRequestBody
- type VersionStatus
- type VersionString
- type Voice
- type VoiceAdmission
- type VoiceAdmitter
- type VoiceFinding
- type VoiceReviewReport
- type VoiceReviewReportVerdict
- type VoiceSettingsRequest
- type VoiceVersion
- type VoiceVersionReview
- type VoiceVersionSlot
- type VoiceVersionSource
- type WebNotificationSettings
- type WebSearchRequest
- type WebSearchResult
- type WebSearchResultFlagged
- type WebSearchResults
- type WebhookDelivery
- type WebhookEndpoint
- type WebhookEndpointCreated
- type WebhookEndpointRef
- type WebhookID
- type WebhookInput
- type WrapKnowledgeKeyJSONRequestBody
- type WrapOrgKnowledgeKeyJSONRequestBody
- type YankVersionJSONBody
- type YankVersionJSONRequestBody
Constants ¶
const ( DirectoryErasureDeleted = dirEraseDeleted DirectoryErasureNotFound = dirEraseNotFound DirectoryErasureUnresolved = dirEraseUnresolved DirectoryErasureNotConfigured = dirEraseNotConfigured DirectoryErasureFailed = dirEraseFailed DirectoryErasurePending = dirErasePending )
The outcomes the erasure's response reports for the directory half.
const ( AccountErased = AccountErasureKind(audit.ActionUserDelete) AccountDataCleared = AccountErasureKind(audit.ActionUserDataClear) )
The two account clears.
const ( // JobFoldInSweep folds in the accounts already known at a domain an // organization has just gained; its args name the organization and // the domain. Enqueued by POST /orgs and by a DNS verification. JobFoldInSweep = "org.fold_in_sweep" // JobPendingMembersDigest mails each organization's admins the pending // members they have not been told about. The worker role enqueues it // on its period (config orgs.pendingDigestEvery, a day by default), // and the sweep enqueues it once when it folded somebody in, so a new // organization's admins hear at once. JobPendingMembersDigest = "org.pending_members_digest" )
const ( // EventAccountErased is heard once an account's erasure has committed // (POST /user/delete, or an unconfirmed account superseded by a verified // sign-in), with the identities it signed in with and the address it // held. EventAccountErased = "account.erased" // EventStaffChanged is heard a few seconds after a sync changed someone's // platform_staff flag. It names nobody: the reader reads the whole set // (PlatformStaff), which is idempotent and catches up on any it missed. EventStaffChanged = "staff.changed" )
const JobOrgDecommissionSweep = "org.decommission_sweep"
JobOrgDecommissionSweep is the queue kind of the hourly sweep that erases organizations whose decommission hold has ended.
const JobTrustedDeviceSweep = "trusted_device.sweep"
JobTrustedDeviceSweep removes remembered browsers past their expiry. The worker role enqueues it hourly and once at start (pkg/extension/agentryd.go), like the decommission sweep.
const ProblemTypeBase = "https://agentry.dev/problems/"
ProblemTypeBase prefixes stable problem type URIs. The domain is a placeholder.
const RateAnon = "anon"
RateAnon is the anonymous bucket, per client address: the class the principal middleware gives a caller with no credential, and the one an extension's callback mount may declare.
const RateNone = "none"
RateNone says a mount draws from no rate-limit bucket. It is a claim rather than an omission: Why has to say what stands in for one, and the completeness gate fails without it.
const RatePerPrincipal = "per-principal"
RatePerPrincipal says the bucket is the principal middleware's choice per request rather than a class the mount fixes: `anon` for a caller with no credential, `authed` for one with. An extension's mount point is the only route that declares it, being the only one whose handler is a sub-mux of routes the middleware classifies one by one.
Variables ¶
var ( ErrActorNotStaff = errors.New("api: only an active platform-staff account acts on another person's account") ErrActorSession = errors.New("api: a change to a person's account is made from a signed-in session, not with a token") ErrSelfAct = errors.New("api: staff do not act on their own account through this door") ErrNoAccount = errors.New("api: no such account") ErrAccountErased = errors.New("api: the account is erased") ErrReasonLength = errors.New("api: a staff act's reason is at most 500 characters") // ErrLastAdmin is an erasure refused because the account is an // organization's last admin; LastAdminError names the organization. ErrLastAdmin = errors.New("api: the account is an organization's last admin") // The refusals of ResendActivation. ErrAlreadyActivated = errors.New("api: the account's address is already confirmed") ErrNoAddress = errors.New("api: the account has no address a link can reach") ErrNotActive = errors.New("api: the account is not active") )
The refusals of the account door.
var ( ErrOrgNotProvisionable = errors.New("api: the organization is not active, so nobody is provisioned into it") ErrAddressUnproven = errors.New("api: the account at this address has not proved it, so it is not provisioned") )
The refusals of ProvisionMember. An organization that is unknown, suspended or being decommissioned has its membership frozen. An account that holds the address without having proved it may be someone else's claim on it, and a membership the organization meant for the address's owner must not land there.
var ErrNoSecondFactor = errors.New("api: a remembered browser needs a sign-in that answered a second factor just now")
ErrNoSecondFactor is the remembered browser's refusal of a sign-in whose evidence does not show a second factor answered just now.
Functions ¶
func AllMountAuthzDecls ¶
AllMountAuthzDecls returns a copy of the root-mount table (tests, docs).
func AllRouteAuthzDecls ¶
AllRouteAuthzDecls returns a copy of the declaration table (tests, docs).
func GetSpec ¶
GetSpec returns the OpenAPI specification corresponding to the generated code in this file. External references in the spec are resolved through PathToRawSpec; externally-referenced files must be embedded in their corresponding Go packages (via the import-mapping feature). URL-based external refs are not supported.
func GetSpecJSON ¶
GetSpecJSON returns the raw JSON bytes of the embedded OpenAPI specification: decompressed but not unmarshaled. External references are not resolved here; the bytes are the spec exactly as embedded by codegen. The result is cached at package init time, so repeated calls are cheap.
func GetSwagger
deprecated
func Handler ¶
func Handler(si ServerInterface) http.Handler
Handler creates http.Handler with routing matching OpenAPI spec.
func HandlerFromMux ¶
func HandlerFromMux(si ServerInterface, m ServeMux) http.Handler
HandlerFromMux creates http.Handler with routing matching OpenAPI spec based on the provided mux.
func HandlerFromMuxWithBaseURL ¶
func HandlerFromMuxWithBaseURL(si ServerInterface, m ServeMux, baseURL string) http.Handler
func HandlerWithOptions ¶
func HandlerWithOptions(si ServerInterface, options StdHTTPServerOptions) http.Handler
HandlerWithOptions creates http.Handler with additional options
func Mount ¶
Mount registers one root mount under the declaration authz_routes.go carries for its pattern. A pattern with no declaration panics at start-up: the completeness gate fails in CI first, and this catches a mount no test fixture ever builds — including on the `git` role's own mux, which no recorder sees.
func NewHandler ¶
NewHandler assembles the full HTTP handler for the api role.
func NewHandlerWithGit ¶
NewHandlerWithGit additionally registers the git smart-HTTP routes on the same mux (the `all` role / self-host single binary). mountGit may be nil.
func NormalizeOpID ¶
NormalizeOpID canonicalizes an operationId: the generator capitalizes ids in the embedded spec, while the table uses the YAML's camelCase.
func PathToRawSpec ¶
Constructs a synthetic filesystem for resolving external references when loading openapi specifications.
func PendingDigestPeriod ¶
PendingDigestPeriod is how often the worker enqueues the digest: the configured period, or a day when the configuration names none.
Types ¶
type AbuseReport ¶
type AbuseReport struct {
Agent string `json:"agent"`
Category string `json:"category"`
CreatedAt time.Time `json:"createdAt"`
Detail string `json:"detail"`
Id openapi_types.UUID `json:"id"`
Namespace string `json:"namespace"`
State AbuseReportState `json:"state"`
Version *string `json:"version,omitempty"`
}
AbuseReport defines model for AbuseReport.
type AbuseReportState ¶
type AbuseReportState string
AbuseReportState defines model for AbuseReport.State.
const ( AbuseReportStateActioned AbuseReportState = "actioned" AbuseReportStateDismissed AbuseReportState = "dismissed" AbuseReportStateOpen AbuseReportState = "open" AbuseReportStateTriaged AbuseReportState = "triaged" )
Defines values for AbuseReportState.
func (AbuseReportState) Valid ¶
func (e AbuseReportState) Valid() bool
Valid indicates whether the value is a known member of the AbuseReportState enum.
type AccessRequestResult ¶
type AccessRequestResult struct {
// MailedAdmins How many of the organization's admins were mailed. Zero when none has a verified address that accepts organization mail; the request is still audited.
MailedAdmins int `json:"mailedAdmins"`
Org string `json:"org"`
}
AccessRequestResult defines model for AccessRequestResult.
type AccountChange ¶ added in v0.6.1000
type AccountChange struct {
Changed bool
Sessions int64
Tokens int64
SSHKeys int64
RememberedBrowsers int64
DesktopGrants int64
}
AccountChange is what an act did: whether the account's state moved, and how many of each credential it revoked.
type AccountEraser ¶
type AccountEraser func(ctx context.Context, tx ErasureTx, userID uuid.UUID, kind AccountErasureKind) (int64, error)
AccountEraser deletes what an extension keeps about an account, inside the core's own transaction, and says how many rows went. An error rolls the whole erasure or clear back.
type AccountErasure ¶ added in v0.6.1000
type AccountErasure struct {
// PublishedVersions counts the account's published public versions,
// each yanked.
PublishedVersions int64
// Directory is the directory half's outcome, as the person's own
// erasure reports it (X-Agentry-Directory-Erasure); empty without a
// directory.
Directory string
// Notified is true when the person was mailed at a confirmed address.
Notified bool
}
AccountErasure is what EraseAccount did.
type AccountErasureKind ¶
type AccountErasureKind string
AccountErasureKind says which of the core's two account clears an AccountEraser is called from: the account's erasure (POST /user/delete) or the clearing of its data (POST /user/clear-data), each named by the audit action that records it.
type AccountFacts ¶ added in v0.6.1000
type AccountFacts struct {
Handle string
State string
EmailVerified bool
PlatformStaff bool
CreatedAt time.Time
Orgs []AccountOrg
Sessions []AccountSession
Tokens []AccountToken
}
AccountFacts is what the registry holds of a person's account, for staff: its state and standing, its memberships, and the ways it can act now. Never a secret: sessions by client and time, tokens by name and scope.
type AccountInstall ¶
type AccountInstall struct {
// AcceptedUnscanned The release was admitted without a scan and the caller accepted that.
AcceptedUnscanned *bool `json:"acceptedUnscanned,omitempty"`
// AcceptedUnsigned The release carried no attestation and the caller accepted that.
AcceptedUnsigned *bool `json:"acceptedUnsigned,omitempty"`
// Capabilities The declared capability block the caller accepted, as the version declared it.
Capabilities *map[string]interface{} `json:"capabilities,omitempty"`
// FindingCounts The installed version's finding counts by severity; present with a `scanned` verdict.
FindingCounts *map[string]int `json:"findingCounts,omitempty"`
InstalledAt *time.Time `json:"installedAt,omitempty"`
InstalledVersion *string `json:"installedVersion,omitempty"`
// LatestVersion The newest published version; absent when none is.
LatestVersion *string `json:"latestVersion,omitempty"`
QuarantineState *AccountInstallQuarantineState `json:"quarantineState,omitempty"`
// Readable Whether the caller can read the QuickAgent today.
Readable bool `json:"readable"`
// Ref `ns/name`.
Ref string `json:"ref"`
// Signed Whether the installed version carries an attestation.
Signed *bool `json:"signed,omitempty"`
UpdatedAt *time.Time `json:"updatedAt,omitempty"`
// Verdict What a report is: `scanned` when a scan run stands behind it (the findings say the rest), `unscanned` when the version was admitted without one — never conflated with "scanned with a known gap". Absent while a scan is still pending.
Verdict *ReportVerdict `json:"verdict,omitempty"`
}
AccountInstall One account install, composed for a list. Only `ref` and `readable` are always present: a record whose QuickAgent the caller can no longer read carries nothing else.
type AccountInstallQuarantineState ¶
type AccountInstallQuarantineState string
AccountInstallQuarantineState defines model for AccountInstall.QuarantineState.
const ( AccountInstallQuarantineStateBlocked AccountInstallQuarantineState = "blocked" AccountInstallQuarantineStateNone AccountInstallQuarantineState = "none" AccountInstallQuarantineStateQuarantined AccountInstallQuarantineState = "quarantined" )
Defines values for AccountInstallQuarantineState.
func (AccountInstallQuarantineState) Valid ¶
func (e AccountInstallQuarantineState) Valid() bool
Valid indicates whether the value is a known member of the AccountInstallQuarantineState enum.
type AccountInstallRequest ¶
type AccountInstallRequest struct {
// AcceptCapabilities The caller accepts the declared capabilities of this version. Required true on a first install and on an update whose capabilities widened; not read otherwise.
AcceptCapabilities *bool `json:"acceptCapabilities,omitempty"`
// AcceptUnscanned Required true when the release was admitted without a scan.
AcceptUnscanned *bool `json:"acceptUnscanned,omitempty"`
// AcceptUnsigned Required true when the release carries no attestation.
AcceptUnsigned *bool `json:"acceptUnsigned,omitempty"`
// Version The published version to record, exactly (no range).
Version string `json:"version"`
}
AccountInstallRequest defines model for AccountInstallRequest.
type AccountOrg ¶ added in v0.6.1000
AccountOrg is one of the account's memberships.
type AccountSession ¶ added in v0.6.1000
AccountSession is one live browser session: when it began and was last used, and the client it was last used from.
type AccountToken ¶ added in v0.6.1000
type AccountToken struct {
Name string
Scopes []string
Org string
CreatedAt time.Time
LastUsedAt *time.Time
ExpiresAt time.Time
}
AccountToken is one live personal access token, named and scoped as its owner made it, never its value.
type ActivationTooSoonError ¶ added in v0.6.1000
ActivationTooSoonError is ResendActivation's refusal inside the interval or the daily cap between two links, with when another may go.
func (ActivationTooSoonError) Error ¶ added in v0.6.1000
func (e ActivationTooSoonError) Error() string
type ActivityEvent ¶
type ActivityEvent struct {
// Action Registered action id (internal/audit/actions.go).
Action string `json:"action"`
// ActorHandle Absent on the public-safe subset and for system actors.
ActorHandle *string `json:"actorHandle,omitempty"`
// Detail Present only for callers with read access.
Detail *map[string]interface{} `json:"detail,omitempty"`
Id openapi_types.UUID `json:"id"`
// Ip The address the action was performed from; on the caller's own feed.
Ip *string `json:"ip,omitempty"`
OccurredAt time.Time `json:"occurredAt"`
// TargetKind What the entry acted on (agent, agent_version, pat, ssh_key, session, user…); on the caller's own feed.
TargetKind *string `json:"targetKind,omitempty"`
// UserAgent The client that performed it; on the caller's own feed.
UserAgent *string `json:"userAgent,omitempty"`
// Version The version this entry concerns, when it names one.
Version *string `json:"version,omitempty"`
}
ActivityEvent One agent-scoped entry from the audit log.
type ActivityPage ¶
type ActivityPage struct {
Events []ActivityEvent `json:"events"`
// NextCursor Opaque; absent on the last page.
NextCursor *string `json:"nextCursor,omitempty"`
}
ActivityPage defines model for ActivityPage.
type AddSshKeyJSONRequestBody ¶
type AddSshKeyJSONRequestBody = AddSshKeyRequest
AddSshKeyJSONRequestBody defines body for AddSshKey for application/json ContentType.
type AddSshKeyRequest ¶
type AddSshKeyRequest struct {
// PublicKey One authorized_keys line ("ssh-ed25519 AAAA… comment").
PublicKey string `json:"publicKey"`
Title string `json:"title"`
}
AddSshKeyRequest defines model for AddSshKeyRequest.
type Advisory ¶
type Advisory struct {
AffectedVersions string `json:"affectedVersions"`
// Agent The affected agent as `ns/name`. Present on feed and permalink responses.
Agent *string `json:"agent,omitempty"`
Detail *string `json:"detail,omitempty"`
Id openapi_types.UUID `json:"id"`
PublishedAt *time.Time `json:"publishedAt,omitempty"`
Severity string `json:"severity"`
Summary string `json:"summary"`
}
Advisory defines model for Advisory.
type Agent ¶
type Agent struct {
// AllowForcePush Present for callers with maintain; whether force-push to the default branch is allowed.
AllowForcePush *bool `json:"allowForcePush,omitempty"`
// AutoPublishTags Present for callers with maintain.
AutoPublishTags *bool `json:"autoPublishTags,omitempty"`
// Builtin Whether this is a built-in agent: one of the packages the Agentry CLI embeds and runs as part of the application, published here for reading. A client labels it Built-in in place of its run modes. Only platform staff set it, on an agent of a first-party namespace. Not the runner's attestation state `builtin`, which only the CLI's embedded copy of a package runs under; an install of this agent from the registry is an ordinary release.
Builtin bool `json:"builtin"`
// CanPublish Present, and true, on GET /agents/{ns}/{name} when the caller may add a version to this agent: the publish role over the namespace or a grant, and a token's `agent:publish`. Absent otherwise. A client offers Edit on it where the caller's token carries no `org:admin` and so never reads `autoPublishTags` (the desktop's sign-in grant). The upload decides again; the organization's gate for a write is not applied here.
CanPublish *bool `json:"canPublish,omitempty"`
CreatedAt time.Time `json:"createdAt"`
DefaultBranch string `json:"defaultBranch"`
// DependencyAlerts Open dependency alerts on this agent's published versions. Present on GET /agents/{ns}/{name}.
DependencyAlerts *[]DependencyAlert `json:"dependencyAlerts,omitempty"`
// ForkCount Present on a public agent: how many forks of it exist. A count only; no read names a fork to the origin's publisher.
ForkCount *int `json:"forkCount,omitempty"`
// ForkDetail Present on a fork whose copy failed, saying why in words.
ForkDetail *string `json:"forkDetail,omitempty"`
// ForkState Present on a fork: `copying` until a worker has copied the repository and submitted the first version, `ready` after, `failed` with `forkDetail`.
ForkState *AgentForkState `json:"forkState,omitempty"`
// ForkedFrom What a fork was taken from. Kept for good: there is no detach.
ForkedFrom *ForkOrigin `json:"forkedFrom,omitempty"`
// GitHttpUrl Clone URL for the hosted repository.
GitHttpUrl string `json:"gitHttpUrl"`
// GitSshUrl SSH clone URL, present when the deployment serves the SSH transport.
GitSshUrl *string `json:"gitSshUrl,omitempty"`
Id openapi_types.UUID `json:"id"`
// Installs30d Installs over the last 30 days. Present on `GET /agents?namespace=`.
Installs30d *int `json:"installs30d,omitempty"`
// LastSubmittedAt When a version of this agent was last submitted, whatever became of it. Present on `GET /agents?namespace=` for an agent with at least one version.
LastSubmittedAt *time.Time `json:"lastSubmittedAt,omitempty"`
// Modes The run modes a release supports; at least one.
Modes AgentModes `json:"modes"`
Name string `json:"name"`
Namespace string `json:"namespace"`
// PipelineSkip Present for callers with maintain; whether submissions are admitted without a scan (an organization's private agent only). A version so admitted is served with `scanStatus: skipped` and the report's verdict `unscanned`.
PipelineSkip *bool `json:"pipelineSkip,omitempty"`
QuarantineState AgentQuarantineState `json:"quarantineState"`
// RetiredAt When the agent was retired: it is private, takes no submission, and `POST …/restore` returns the visibility it had. Absent on an agent that is not retired.
RetiredAt *time.Time `json:"retiredAt,omitempty"`
Summary string `json:"summary"`
Visibility AgentVisibility `json:"visibility"`
}
Agent defines model for Agent.
type AgentForkState ¶
type AgentForkState string
AgentForkState Present on a fork: `copying` until a worker has copied the repository and submitted the first version, `ready` after, `failed` with `forkDetail`.
const ( AgentForkStateCopying AgentForkState = "copying" AgentForkStateFailed AgentForkState = "failed" AgentForkStateReady AgentForkState = "ready" )
Defines values for AgentForkState.
func (AgentForkState) Valid ¶
func (e AgentForkState) Valid() bool
Valid indicates whether the value is a known member of the AgentForkState enum.
type AgentGrant ¶
type AgentGrant struct {
// Grantee User handle or team slug.
Grantee string `json:"grantee"`
Kind AgentGrantKind `json:"kind"`
// Role Per-agent grant levels, read < write < maintain < publish.
Role AgentRole `json:"role"`
}
AgentGrant defines model for AgentGrant.
type AgentGrantKind ¶
type AgentGrantKind string
AgentGrantKind defines model for AgentGrant.Kind.
const ( AgentGrantKindTeam AgentGrantKind = "team" AgentGrantKindUser AgentGrantKind = "user" )
Defines values for AgentGrantKind.
func (AgentGrantKind) Valid ¶
func (e AgentGrantKind) Valid() bool
Valid indicates whether the value is a known member of the AgentGrantKind enum.
type AgentMode ¶
type AgentMode string
AgentMode A run mode a release supports. `autonomous` runs from its source files, writes its output and receipts, and ends; `interactive` starts from the same plan and controls but the run is a conversation with the user in the CLI or the desktop; `persistent` is a conversation the runner keeps between sessions, and is run only for the runner's own built-in agents, so a client withholds Run for a release that supports no other mode. A release declares at least one.
type AgentModes ¶
type AgentModes = []AgentMode
AgentModes The run modes a release supports; at least one.
type AgentQuarantineState ¶
type AgentQuarantineState string
AgentQuarantineState defines model for Agent.QuarantineState.
const ( AgentQuarantineStateBlocked AgentQuarantineState = "blocked" AgentQuarantineStateNone AgentQuarantineState = "none" AgentQuarantineStateQuarantined AgentQuarantineState = "quarantined" )
Defines values for AgentQuarantineState.
func (AgentQuarantineState) Valid ¶
func (e AgentQuarantineState) Valid() bool
Valid indicates whether the value is a known member of the AgentQuarantineState enum.
type AgentRole ¶
type AgentRole string
AgentRole Per-agent grant levels, read < write < maintain < publish.
type AgentStats ¶
type AgentStats struct {
Installs30d int64 `json:"installs30d"`
InstallsTotal int64 `json:"installsTotal"`
// Starred Whether the calling user has starred it (authed only).
Starred *bool `json:"starred,omitempty"`
Stars int64 `json:"stars"`
}
AgentStats defines model for AgentStats.
type AgentVersion ¶
type AgentVersion struct {
// ArchiveDigest sha256:<hex>, the release identity.
ArchiveDigest *string `json:"archiveDigest,omitempty"`
ArchiveSize *int64 `json:"archiveSize,omitempty"`
// Capabilities The capability contract: the declared capability block, and under `knowledge` the names of the knowledge packs the release ships (the manifest's `knowledge.ships`), so a release shipping one more than an installed one asks for consent again.
Capabilities *map[string]interface{} `json:"capabilities,omitempty"`
Channel AgentVersionChannel `json:"channel"`
CommitSha *string `json:"commitSha,omitempty"`
CreatedAt time.Time `json:"createdAt"`
Id openapi_types.UUID `json:"id"`
// KnowledgeShipping Who confirmed that the version's shipped packs become readable with it, and how it was published. Served only to those who manage the QuickAgent. A version that has no record serves none.
KnowledgeShipping *ShippedKnowledgeRecord `json:"knowledgeShipping,omitempty"`
// ManifestSchemaVersion Schema major of the manifest snapshot this version carries: 1 (kind-classified, read through the v1 mapping) or 2 (modes). Clients that show a version's manifest read it accordingly.
ManifestSchemaVersion *AgentVersionManifestSchemaVersion `json:"manifestSchemaVersion,omitempty"`
PublishedAt *time.Time `json:"publishedAt,omitempty"`
// ScanStatus How the version was admitted: through the pipeline, or skipped — no scan run, no findings, no attestation, the report's verdict `unscanned`. A skipped version is a private organization agent's; a client that installs or runs one asks for consent first.
ScanStatus *AgentVersionScanStatus `json:"scanStatus,omitempty"`
// Source Where the version came from: a repository tag, an uploaded package, or an uploaded package the scan proved was a hosted Drafter revision of the agent's current release (`drafter-revision`), which S9 scans with the benefit of the doubt. The set grows by addition, so it is declared extensible: a client keeps a source it does not know as the string it is rather than failing on it.
Source string `json:"source"`
// Status Publication state machine states. `approved` is reserved and never produced: a reviewer's approval publishes directly (needs_review → published), so clients will not observe it; it is kept because removing an enum value is a breaking change.
Status VersionStatus `json:"status"`
StatusReason *string `json:"statusReason,omitempty"`
Version string `json:"version"`
YankReason *string `json:"yankReason,omitempty"`
YankedAt *time.Time `json:"yankedAt,omitempty"`
}
AgentVersion defines model for AgentVersion.
type AgentVersionChannel ¶
type AgentVersionChannel string
AgentVersionChannel defines model for AgentVersion.Channel.
const ( AgentVersionChannelBeta AgentVersionChannel = "beta" AgentVersionChannelStable AgentVersionChannel = "stable" )
Defines values for AgentVersionChannel.
func (AgentVersionChannel) Valid ¶
func (e AgentVersionChannel) Valid() bool
Valid indicates whether the value is a known member of the AgentVersionChannel enum.
type AgentVersionManifestSchemaVersion ¶
type AgentVersionManifestSchemaVersion int
AgentVersionManifestSchemaVersion Schema major of the manifest snapshot this version carries: 1 (kind-classified, read through the v1 mapping) or 2 (modes). Clients that show a version's manifest read it accordingly.
const ( N1 AgentVersionManifestSchemaVersion = 1 N2 AgentVersionManifestSchemaVersion = 2 )
Defines values for AgentVersionManifestSchemaVersion.
func (AgentVersionManifestSchemaVersion) Valid ¶
func (e AgentVersionManifestSchemaVersion) Valid() bool
Valid indicates whether the value is a known member of the AgentVersionManifestSchemaVersion enum.
type AgentVersionScanStatus ¶
type AgentVersionScanStatus string
AgentVersionScanStatus How the version was admitted: through the pipeline, or skipped — no scan run, no findings, no attestation, the report's verdict `unscanned`. A skipped version is a private organization agent's; a client that installs or runs one asks for consent first.
const ( AgentVersionScanStatusPipeline AgentVersionScanStatus = "pipeline" AgentVersionScanStatusSkipped AgentVersionScanStatus = "skipped" )
Defines values for AgentVersionScanStatus.
func (AgentVersionScanStatus) Valid ¶
func (e AgentVersionScanStatus) Valid() bool
Valid indicates whether the value is a known member of the AgentVersionScanStatus enum.
type AgentVisibility ¶
type AgentVisibility string
AgentVisibility defines model for Agent.Visibility.
const ( AgentVisibilityPrivate AgentVisibility = "private" AgentVisibilityPublic AgentVisibility = "public" )
Defines values for AgentVisibility.
func (AgentVisibility) Valid ¶
func (e AgentVisibility) Valid() bool
Valid indicates whether the value is a known member of the AgentVisibility enum.
type ApproveOrgMemberJSONBody ¶
type ApproveOrgMemberJSONBody struct {
// Role The role a PUT assigns. security_reviewer is refused outside a first-party organization. `owner` is accepted by the schema but refused with a 422 that names the roles that exist.
Role *OrgRoleAssignment `json:"role,omitempty"`
}
ApproveOrgMemberJSONBody defines parameters for ApproveOrgMember.
type ApproveOrgMemberJSONRequestBody ¶
type ApproveOrgMemberJSONRequestBody ApproveOrgMemberJSONBody
ApproveOrgMemberJSONRequestBody defines body for ApproveOrgMember for application/json ContentType.
type AuditEvent ¶
type AuditEvent struct {
// Action Registered action id (internal/audit/actions.go).
Action string `json:"action"`
ActorHandle *string `json:"actorHandle,omitempty"`
ActorKind AuditEventActorKind `json:"actorKind"`
Detail *map[string]interface{} `json:"detail,omitempty"`
Id openapi_types.UUID `json:"id"`
OccurredAt time.Time `json:"occurredAt"`
TargetId *openapi_types.UUID `json:"targetId,omitempty"`
TargetKind *string `json:"targetKind,omitempty"`
}
AuditEvent defines model for AuditEvent.
type AuditEventActorKind ¶
type AuditEventActorKind string
AuditEventActorKind defines model for AuditEvent.ActorKind.
const ( AuditEventActorKindPat AuditEventActorKind = "pat" AuditEventActorKindScim AuditEventActorKind = "scim" AuditEventActorKindSystem AuditEventActorKind = "system" AuditEventActorKindUser AuditEventActorKind = "user" )
Defines values for AuditEventActorKind.
func (AuditEventActorKind) Valid ¶
func (e AuditEventActorKind) Valid() bool
Valid indicates whether the value is a known member of the AuditEventActorKind enum.
type AuditExport ¶
type AuditExport struct {
CreatedAt *time.Time `json:"createdAt,omitempty"`
// DownloadPath Blob-store reference; presign is a deployment concern.
DownloadPath *string `json:"downloadPath,omitempty"`
Error *string `json:"error,omitempty"`
EventCount *int `json:"eventCount,omitempty"`
Id openapi_types.UUID `json:"id"`
Status AuditExportStatus `json:"status"`
}
AuditExport defines model for AuditExport.
type AuditExportStatus ¶
type AuditExportStatus string
AuditExportStatus defines model for AuditExport.Status.
const ( AuditExportStatusCompleted AuditExportStatus = "completed" AuditExportStatusFailed AuditExportStatus = "failed" AuditExportStatusPending AuditExportStatus = "pending" AuditExportStatusRunning AuditExportStatus = "running" )
Defines values for AuditExportStatus.
func (AuditExportStatus) Valid ¶
func (e AuditExportStatus) Valid() bool
Valid indicates whether the value is a known member of the AuditExportStatus enum.
type AuditPage ¶
type AuditPage struct {
Events []AuditEvent `json:"events"`
// NextCursor Opaque; absent on the last page.
NextCursor *string `json:"nextCursor,omitempty"`
}
AuditPage defines model for AuditPage.
type BrandInfo ¶
type BrandInfo struct {
LogoUrl *string `json:"logoUrl,omitempty"`
// Name Example: Agentry
Name string `json:"name"`
SupportEmail *string `json:"supportEmail,omitempty"`
}
BrandInfo What this deployment calls itself (config `brand.*`): the name for prompts and titles, and optional logo and support address.
type CheckDraftJSONRequestBody ¶
type CheckDraftJSONRequestBody = DraftCheckRequest
CheckDraftJSONRequestBody defines body for CheckDraft for application/json ContentType.
type ConnectorInfo ¶
type ConnectorInfo struct {
// Id Stable id, such as `github` or `microsoft-365`.
//
// Example: microsoft-365
Id string `json:"id"`
// Name Example: Microsoft 365
Name string `json:"name"`
// PublicClientId The public client id this deployment registered for the connector (configuration `connectors.publicClients`); absent where none is configured or the strategy takes none.
PublicClientId *string `json:"publicClientId,omitempty"`
// Strategy How the connector's app signs a person in: `agentry-confidential` (Agentry's web client, whose secret stays with the deployment) or `agentry-public` (a public client id with no secret, listed here when configured).
Strategy ConnectorInfoStrategy `json:"strategy"`
// Vendor Example: Microsoft
Vendor string `json:"vendor"`
}
ConnectorInfo One connector of Agentry's catalogue. A declared server gets the connector's app only when it is one of the connector's vetted servers, matched by the client from the catalogue it is built with.
type ConnectorInfoStrategy ¶
type ConnectorInfoStrategy string
ConnectorInfoStrategy How the connector's app signs a person in: `agentry-confidential` (Agentry's web client, whose secret stays with the deployment) or `agentry-public` (a public client id with no secret, listed here when configured).
const ( AgentryConfidential ConnectorInfoStrategy = "agentry-confidential" AgentryPublic ConnectorInfoStrategy = "agentry-public" )
Defines values for ConnectorInfoStrategy.
func (ConnectorInfoStrategy) Valid ¶
func (e ConnectorInfoStrategy) Valid() bool
Valid indicates whether the value is a known member of the ConnectorInfoStrategy enum.
type ConnectorList ¶
type ConnectorList struct {
Connectors []ConnectorInfo `json:"connectors"`
}
ConnectorList defines model for ConnectorList.
type CreateAgentJSONRequestBody ¶
type CreateAgentJSONRequestBody = CreateAgentRequest
CreateAgentJSONRequestBody defines body for CreateAgent for application/json ContentType.
type CreateAgentRequest ¶
type CreateAgentRequest struct {
// Modes The run modes a release supports; at least one.
Modes AgentModes `json:"modes"`
Name string `json:"name"`
// Namespace User or org handle owning the agent.
Namespace string `json:"namespace"`
Summary *string `json:"summary,omitempty"`
Visibility *CreateAgentRequestVisibility `json:"visibility,omitempty"`
}
CreateAgentRequest defines model for CreateAgentRequest.
type CreateAgentRequestVisibility ¶
type CreateAgentRequestVisibility string
CreateAgentRequestVisibility defines model for CreateAgentRequest.Visibility.
const ( CreateAgentRequestVisibilityPrivate CreateAgentRequestVisibility = "private" CreateAgentRequestVisibilityPublic CreateAgentRequestVisibility = "public" )
Defines values for CreateAgentRequestVisibility.
func (CreateAgentRequestVisibility) Valid ¶
func (e CreateAgentRequestVisibility) Valid() bool
Valid indicates whether the value is a known member of the CreateAgentRequestVisibility enum.
type CreateAuditExportJSONBody ¶
type CreateAuditExportJSONBody struct {
// Action Optional action filter.
Action *string `json:"action,omitempty"`
}
CreateAuditExportJSONBody defines parameters for CreateAuditExport.
type CreateAuditExportJSONRequestBody ¶
type CreateAuditExportJSONRequestBody CreateAuditExportJSONBody
CreateAuditExportJSONRequestBody defines body for CreateAuditExport for application/json ContentType.
type CreateDesktopGrantJSONRequestBody ¶
type CreateDesktopGrantJSONRequestBody = DesktopGrantRequest
CreateDesktopGrantJSONRequestBody defines body for CreateDesktopGrant for application/json ContentType.
type CreateDomainClaimJSONBody ¶
type CreateDomainClaimJSONBody struct {
Domain string `json:"domain"`
}
CreateDomainClaimJSONBody defines parameters for CreateDomainClaim.
type CreateDomainClaimJSONRequestBody ¶
type CreateDomainClaimJSONRequestBody CreateDomainClaimJSONBody
CreateDomainClaimJSONRequestBody defines body for CreateDomainClaim for application/json ContentType.
type CreateInvitationJSONRequestBody ¶
type CreateInvitationJSONRequestBody = CreateInvitationRequest
CreateInvitationJSONRequestBody defines body for CreateInvitation for application/json ContentType.
type CreateInvitationRequest ¶
type CreateInvitationRequest struct {
Email string `json:"email"`
// Role The role a PUT assigns. security_reviewer is refused outside a first-party organization. `owner` is accepted by the schema but refused with a 422 that names the roles that exist.
Role *OrgRoleAssignment `json:"role,omitempty"`
}
CreateInvitationRequest defines model for CreateInvitationRequest.
type CreateKnowledgePackJSONRequestBody ¶
type CreateKnowledgePackJSONRequestBody = CreateKnowledgePackRequest
CreateKnowledgePackJSONRequestBody defines body for CreateKnowledgePack for application/json ContentType.
type CreateKnowledgePackRequest ¶
type CreateKnowledgePackRequest struct {
Name string `json:"name"`
// WrappedKey A pack's data key as a wrapper sealed it: the wrapper's `kind` (`deployment` on a core registry), the `recipient` it is wrapped to (a key's id, never a key), and the sealed bytes.
WrappedKey KnowledgeWrappedKey `json:"wrappedKey"`
}
CreateKnowledgePackRequest defines model for CreateKnowledgePackRequest.
type CreateOrgJSONRequestBody ¶
type CreateOrgJSONRequestBody = CreateOrgRequest
CreateOrgJSONRequestBody defines body for CreateOrg for application/json ContentType.
type CreateOrgKnowledgePackJSONRequestBody ¶
type CreateOrgKnowledgePackJSONRequestBody = CreateKnowledgePackRequest
CreateOrgKnowledgePackJSONRequestBody defines body for CreateOrgKnowledgePack for application/json ContentType.
type CreateOrgRequest ¶
type CreateOrgRequest struct {
DisplayName string `json:"displayName"`
// Domain The domain the organization is keyed on. Omitted, it is the domain of the creator's verified email address; `none` records no domain; the creator's own domain, spelled out, is accepted. Any other value is 422 — a further domain is claimed over DNS (`POST /orgs/{org}/domain-claims`). A domain no single organization owns (a public mail provider, a reserved name) is recorded as none whatever is sent. A domain that already belongs to an organization is `409 domain-claimed`.
Domain *string `json:"domain,omitempty"`
Handle string `json:"handle"`
}
CreateOrgRequest defines model for CreateOrgRequest.
type CreateRulesetReleaseJSONBody ¶
type CreateRulesetReleaseJSONBody struct {
// BundleDigest sha256:<hex> of the bundle.
BundleDigest *string `json:"bundleDigest,omitempty"`
Notes *string `json:"notes,omitempty"`
Semver *string `json:"semver,omitempty"`
}
CreateRulesetReleaseJSONBody defines parameters for CreateRulesetRelease.
type CreateRulesetReleaseJSONRequestBody ¶
type CreateRulesetReleaseJSONRequestBody CreateRulesetReleaseJSONBody
CreateRulesetReleaseJSONRequestBody defines body for CreateRulesetRelease for application/json ContentType.
type CreateTeamJSONBody ¶
type CreateTeamJSONBody struct {
Slug string `json:"slug"`
}
CreateTeamJSONBody defines parameters for CreateTeam.
type CreateTeamJSONRequestBody ¶
type CreateTeamJSONRequestBody CreateTeamJSONBody
CreateTeamJSONRequestBody defines body for CreateTeam for application/json ContentType.
type CreateTokenJSONRequestBody ¶
type CreateTokenJSONRequestBody = CreateTokenRequest
CreateTokenJSONRequestBody defines body for CreateToken for application/json ContentType.
type CreateTokenRequest ¶
type CreateTokenRequest struct {
// ExpiresAt Defaults to the max PAT lifetime; a later value is refused with 422, not clamped.
ExpiresAt *time.Time `json:"expiresAt,omitempty"`
Name string `json:"name"`
// OrgHandle Bind the token to this org. Requires the current session to be SSO-fresh for the org; org-bound tokens live at most 90 days (a later expiresAt is refused with 422) and are the only tokens accepted against an enforced-SSO org's resources.
OrgHandle *string `json:"orgHandle,omitempty"`
Scopes []Scope `json:"scopes"`
}
CreateTokenRequest defines model for CreateTokenRequest.
type CreateWebhookJSONRequestBody ¶
type CreateWebhookJSONRequestBody = WebhookInput
CreateWebhookJSONRequestBody defines body for CreateWebhook for application/json ContentType.
type CreatedInvitation ¶
type CreatedInvitation struct {
// AcceptUrl Where the invited person accepts it.
AcceptUrl string `json:"acceptUrl"`
CreatedAt time.Time `json:"createdAt"`
Email string `json:"email"`
// Expired An expired invitation holds no seat and cannot be accepted.
Expired *bool `json:"expired,omitempty"`
ExpiresAt time.Time `json:"expiresAt"`
Id openapi_types.UUID `json:"id"`
// InvitedBy The handle of the admin who sent it.
InvitedBy *string `json:"invitedBy,omitempty"`
// Mailed Whether the invitation was mailed. It is not when the address belongs to no account, to an account whose address the registry has not verified, or to someone who has turned organization-invitation mail off — the registry mails no address it has not confirmed.
Mailed bool `json:"mailed"`
// Role An organization role, ordered admin > security_reviewer | member. Admins manage the organization, its members, settings and sign-in policy, and hold the security reviewer's powers; security_reviewer is a platform-internal role that exists only inside a first-party organization; there is no owner role, only admins. An organization always keeps one admin: demoting or removing the last one is 409 last-admin.
Role OrgRole `json:"role"`
// Token The credential, shown once and never again: the registry keeps only its SHA-256. Give it to the person you invited if it was not mailed to them.
Token string `json:"token"`
}
CreatedInvitation defines model for CreatedInvitation.
type DecideReviewItemJSONBody ¶
type DecideReviewItemJSONBody struct {
Decision DecideReviewItemJSONBodyDecision `json:"decision"`
Rationale string `json:"rationale"`
}
DecideReviewItemJSONBody defines parameters for DecideReviewItem.
type DecideReviewItemJSONBodyDecision ¶
type DecideReviewItemJSONBodyDecision string
DecideReviewItemJSONBodyDecision defines parameters for DecideReviewItem.
const ( Approve DecideReviewItemJSONBodyDecision = "approve" Reject DecideReviewItemJSONBodyDecision = "reject" )
Defines values for DecideReviewItemJSONBodyDecision.
func (DecideReviewItemJSONBodyDecision) Valid ¶
func (e DecideReviewItemJSONBodyDecision) Valid() bool
Valid indicates whether the value is a known member of the DecideReviewItemJSONBodyDecision enum.
type DecideReviewItemJSONRequestBody ¶
type DecideReviewItemJSONRequestBody DecideReviewItemJSONBody
DecideReviewItemJSONRequestBody defines body for DecideReviewItem for application/json ContentType.
type DecommissionOrgJSONBody ¶
type DecommissionOrgJSONBody struct {
// Confirm The organization's handle, typed again.
Confirm string `json:"confirm"`
Reason *string `json:"reason,omitempty"`
}
DecommissionOrgJSONBody defines parameters for DecommissionOrg.
type DecommissionOrgJSONRequestBody ¶
type DecommissionOrgJSONRequestBody DecommissionOrgJSONBody
DecommissionOrgJSONRequestBody defines body for DecommissionOrg for application/json ContentType.
type DeleteAgentParams ¶
type DeleteAgentParams struct {
// Confirm The agent's name, required to delete an agent with version history.
Confirm *string `form:"confirm,omitempty" json:"confirm,omitempty"`
}
DeleteAgentParams defines parameters for DeleteAgent.
type DeleteCurrentUserParams ¶
type DeleteCurrentUserParams struct {
// PublishedContent What to do with published public versions. Required when the account has any; ignored (and defaulted to yank) when it has none.
PublishedContent *DeleteCurrentUserParamsPublishedContent `form:"publishedContent,omitempty" json:"publishedContent,omitempty"`
// TransferOrg Destination org handle, required with publishedContent=transfer. The caller must be an admin of that org.
TransferOrg *string `form:"transferOrg,omitempty" json:"transferOrg,omitempty"`
}
DeleteCurrentUserParams defines parameters for DeleteCurrentUser.
type DeleteCurrentUserParamsPublishedContent ¶
type DeleteCurrentUserParamsPublishedContent string
DeleteCurrentUserParamsPublishedContent defines parameters for DeleteCurrentUser.
const ( Transfer DeleteCurrentUserParamsPublishedContent = "transfer" Yank DeleteCurrentUserParamsPublishedContent = "yank" )
Defines values for DeleteCurrentUserParamsPublishedContent.
func (DeleteCurrentUserParamsPublishedContent) Valid ¶
func (e DeleteCurrentUserParamsPublishedContent) Valid() bool
Valid indicates whether the value is a known member of the DeleteCurrentUserParamsPublishedContent enum.
type DependencyAlert ¶
type DependencyAlert struct {
AdvisoryIds []string `json:"advisoryIds"`
// Agent namespace/name
Agent string `json:"agent"`
CreatedAt time.Time `json:"createdAt"`
Ecosystem DependencyAlertEcosystem `json:"ecosystem"`
// FixedIn Server versions the advisories name as fixed.
FixedIn []string `json:"fixedIn"`
Id openapi_types.UUID `json:"id"`
Package string `json:"package"`
PackageVersion string `json:"packageVersion"`
Severity DependencyAlertSeverity `json:"severity"`
// Version The affected published version.
Version string `json:"version"`
}
DependencyAlert A published version declares an MCP server version with a newly known high or critical vulnerability.
type DependencyAlertEcosystem ¶
type DependencyAlertEcosystem string
DependencyAlertEcosystem defines model for DependencyAlert.Ecosystem.
const ( DependencyAlertEcosystemNpm DependencyAlertEcosystem = "npm" DependencyAlertEcosystemPypi DependencyAlertEcosystem = "pypi" )
Defines values for DependencyAlertEcosystem.
func (DependencyAlertEcosystem) Valid ¶
func (e DependencyAlertEcosystem) Valid() bool
Valid indicates whether the value is a known member of the DependencyAlertEcosystem enum.
type DependencyAlertSeverity ¶
type DependencyAlertSeverity string
DependencyAlertSeverity defines model for DependencyAlert.Severity.
const ( DependencyAlertSeverityCritical DependencyAlertSeverity = "critical" DependencyAlertSeverityHigh DependencyAlertSeverity = "high" )
Defines values for DependencyAlertSeverity.
func (DependencyAlertSeverity) Valid ¶
func (e DependencyAlertSeverity) Valid() bool
Valid indicates whether the value is a known member of the DependencyAlertSeverity enum.
type DesktopExchangeRequest ¶
DesktopExchangeRequest defines model for DesktopExchangeRequest.
type DesktopGrant ¶
type DesktopGrant struct {
// Code Single-use exchange code. Appears only in this response.
Code string `json:"code"`
ExpiresAt time.Time `json:"expiresAt"`
}
DesktopGrant defines model for DesktopGrant.
type DesktopGrantRequest ¶
type DesktopGrantRequest struct {
// State The desktop app's nonce; the exchange must present the same value.
State string `json:"state"`
}
DesktopGrantRequest defines model for DesktopGrantRequest.
type Directory ¶
type Directory interface {
// EraseAccount deletes the account the link names, never a superuser
// or a service account, and says which rule it looked by. False with
// no error when no account qualifies.
EraseAccount(ctx context.Context, link DirectoryLink) (bool, DirectoryLookup, error)
// Devices lists the authenticators the account has enrolled; an empty
// list, not an error, for no account or no devices.
Devices(ctx context.Context, link DirectoryLink) ([]DirectoryDevice, error)
// DeleteDevice removes one of the account's own authenticators; false
// when the account has no device of that kind and id.
DeleteDevice(ctx context.Context, link DirectoryLink, kind, id string) (bool, error)
// SignInFacts says how the account signs in at the directory. A link
// with no uid is answered with nothing: an address alone never picks
// the account.
SignInFacts(ctx context.Context, link DirectoryLink) (DirectorySignInFacts, error)
// AccountGone reports that the account is no longer in the directory;
// false when it cannot tell.
AccountGone(ctx context.Context, link DirectoryLink) (bool, error)
// GroupMembers returns a group's id and members, creating the group
// when it does not exist.
GroupMembers(ctx context.Context, group string) (groupID string, members []DirectoryAccount, err error)
// AccountsByEmail returns the accounts at exactly this address
// (case-blind), service accounts left out.
AccountsByEmail(ctx context.Context, email string) ([]DirectoryAccount, error)
// SetMember adds an account to a group or removes it.
SetMember(ctx context.Context, groupID string, accountPK int, member bool) error
}
Directory is the registry's port to the directory service that holds people's sign-in accounts. The registry asks it to erase an account and whether an account is still there (EraseAccount, AccountGone); the other methods are the directory's own surface, which an extension that is the directory implements and serves. The registry keeps the rules (when an account is erased, who is platform staff); the directory carries them out on its own records.
A server has at most one, which an extension supplies with SetDirectory (pkg/extension.ManagesDirectory). With none, erasure stops at the registry ("not-configured").
Every method reads the account a DirectoryLink names and never another: a link the directory cannot tell apart from somebody else's account is answered as unresolved or as nothing, never as a guess.
type DirectoryAccount ¶
type DirectoryAccount struct {
PK int
Email string
UID string
Active bool
// HasPassword is the directory's own record of whether the account has
// a password; nil when it has none yet.
HasPassword *bool
}
DirectoryAccount is an account as the directory lists it, for its group calls.
type DirectoryDevice ¶
DirectoryDevice is one enrolled authenticator as the directory reports it.
type DirectoryErasure ¶
type DirectoryErasure interface {
EraseErased(r *http.Request, a ErasedAccount) string
}
DirectoryErasure is the optional interface for a directory that carries out the directory half of an account's erasure itself, retries included. The core then calls EraseErased once, after the registry's erasure has committed, in place of its own attempt, and reports the outcome it returns on the erasure's response (X-Agentry-Directory-Erasure), which the site reads to tell the person where their sign-in account stands. EraseErased is called in the request, so it makes at most one quick attempt and queues the rest. The directory records each attempt as a user.directory_erase audit event and raises one that never completes. An outcome outside the set below is reported as failed and raised.
type DirectoryLink ¶
DirectoryLink is how the registry names a person's directory account: the directory's own id for it where one was recorded; the uid the directory reports for it, which is the subject of the person's sign-in through the sign-in provider without its "<id>:" prefix; and the registry's copy of the address, the lookup of last resort. The id and the uid are zero for an account that never signed in through the sign-in provider.
type DirectoryLookup ¶
type DirectoryLookup string
DirectoryLookup is how a directory found the account a link names, or why it took none. The erasure's audit row records it.
const ( DirectoryLookupByID DirectoryLookup = "id" DirectoryLookupByUID DirectoryLookup = "uid" DirectoryLookupByAddress DirectoryLookup = "address" // The three that leave an account the person may hold in place: more // than one account at the address, the recorded id now holding an // account with another uid, and a superuser, which erasure never // deletes. Erasure reports these as unresolved, for the operator. DirectoryLookupIDMismatch DirectoryLookup = "id-mismatch" DirectoryLookupSuperuser DirectoryLookup = "superuser" )
type DirectorySignInFacts ¶
type DirectorySignInFacts struct {
FirstSource *DirectorySource
HasPassword *bool
}
DirectorySignInFacts is how an account signs in at the directory; a nil field is one the directory did not answer.
type DirectorySource ¶
DirectorySource is a social provider as the directory names it.
type DomainClaim ¶
type DomainClaim struct {
Domain string `json:"domain"`
// RecordName The DNS TXT record name to create.
RecordName *string `json:"recordName,omitempty"`
// RecordValue The DNS TXT record value to publish.
RecordValue *string `json:"recordValue,omitempty"`
VerificationToken string `json:"verificationToken"`
Verified bool `json:"verified"`
VerifiedAt *time.Time `json:"verifiedAt,omitempty"`
}
DomainClaim defines model for DomainClaim.
type DomainOrg ¶
type DomainOrg struct {
// Domain The caller's verified email domain; empty for an address at a shared domain.
Domain string `json:"domain"`
// Member Whether the caller already holds a membership there, pending or active.
Member *bool `json:"member,omitempty"`
// Org Absent when no organization holds the domain.
Org *struct {
DisplayName string `json:"displayName"`
Handle string `json:"handle"`
} `json:"org,omitempty"`
// RequestedToday Whether the caller already asked its administrators for access in the last day.
RequestedToday *bool `json:"requestedToday,omitempty"`
}
DomainOrg Which organization, if any, the caller's verified email domain belongs to — recorded at the organization's creation or verified over DNS by it. A domain no single organization owns (a public mail provider) belongs to nobody.
type DraftCheck ¶
type DraftCheck struct {
Draft DraftSetCheck `json:"draft"`
// Model The pinned judge model, such as `jev-1.13.0`.
Model string `json:"model"`
Rubric DraftRubricCheck `json:"rubric"`
// Ungranted Each runner tool the instruction calls for that the manifest does not grant, in the order the instruction first names them, at most 50; empty when every tool it names is granted. A word longer than 80 bytes is not read as a tool name. Any one sends the version to a person at publish (`S6/ungranted-tool`). A tool named only where the instruction turns it away ("not `browser_pdf_save`"), and one in a paragraph that speaks of another package as "a QuickAgent", is not listed. Read with no judge, so it is answered when both halves are `not_scanned`.
Ungranted []DraftUngrantedTool `json:"ungranted"`
// Usage The judge's requests and input tokens, for the record. Never a price: AI Review is charged per operation.
Usage ModelInputUsage `json:"usage"`
}
DraftCheck defines model for DraftCheck.
type DraftCheckFailure ¶
type DraftCheckFailure string
DraftCheckFailure Why a half was not scanned: the judge timed out, failed, or (the draft set only) a part of the draft is past its bound.
const ( DraftCheckFailureJudgeError DraftCheckFailure = "judge-error" DraftCheckFailureTimeout DraftCheckFailure = "timeout" DraftCheckFailureTooLarge DraftCheckFailure = "too-large" )
Defines values for DraftCheckFailure.
func (DraftCheckFailure) Valid ¶
func (e DraftCheckFailure) Valid() bool
Valid indicates whether the value is a known member of the DraftCheckFailure enum.
type DraftCheckFile ¶
type DraftCheckFile struct {
// Content The file's text, UTF-8.
Content string `json:"content"`
// Path The file's path in the package, relative and clean.
Path string `json:"path"`
}
DraftCheckFile defines model for DraftCheckFile.
type DraftCheckRequest ¶
type DraftCheckRequest struct {
// Description The person's description the draft was made from, as the Drafter read it. It is asked about as data, beside the draft.
Description string `json:"description"`
// Files Every text file of the rendered package, `agent.yaml` and the instruction file among them; at most 65,536 bytes in all.
Files []DraftCheckFile `json:"files"`
}
DraftCheckRequest defines model for DraftCheckRequest.
type DraftCheckVerdict ¶
type DraftCheckVerdict string
DraftCheckVerdict `flagged`: in the rubric half, a high finding (one the gate sends to a person); in the draft half, a question scored 2 or more. `pass`: neither, though the rubric half may list medium findings as notes. `not_scanned`: the judge could not answer for this half.
const ( DraftCheckVerdictFlagged DraftCheckVerdict = "flagged" DraftCheckVerdictNotScanned DraftCheckVerdict = "not_scanned" DraftCheckVerdictPass DraftCheckVerdict = "pass" )
Defines values for DraftCheckVerdict.
func (DraftCheckVerdict) Valid ¶
func (e DraftCheckVerdict) Valid() bool
Valid indicates whether the value is a known member of the DraftCheckVerdict enum.
type DraftChecker ¶
type DraftChecker interface {
Check(ctx context.Context, p draftcheck.Package) (draftcheck.Result, error)
}
DraftChecker reads a finished draft with the release rubric and the draft question set: *draftcheck.Checker.
type DraftRubricCheck ¶
type DraftRubricCheck struct {
// Failure Why a half was not scanned: the judge timed out, failed, or (the draft set only) a part of the draft is past its bound.
Failure *DraftCheckFailure `json:"failure,omitempty"`
// Findings What S5 would record as findings. A high one sends the version to a person and makes the verdict `flagged`; a medium one is a note and leaves the verdict `pass`.
Findings []DraftRubricFinding `json:"findings"`
// RubricHash The rubric hash S5 records under the same model.
RubricHash string `json:"rubricHash"`
// Scores Per rubric question, 0 to 3, as S5 scores it.
Scores *DraftRubricScores `json:"scores,omitempty"`
// Verdict `flagged`: in the rubric half, a high finding (one the gate sends to a person); in the draft half, a question scored 2 or more. `pass`: neither, though the rubric half may list medium findings as notes. `not_scanned`: the judge could not answer for this half.
Verdict DraftCheckVerdict `json:"verdict"`
}
DraftRubricCheck defines model for DraftRubricCheck.
type DraftRubricFinding ¶
type DraftRubricFinding struct {
Id DraftRubricFindingId `json:"id"`
// Path The file whose part scored highest (`agent.yaml` for the manifest).
Path string `json:"path"`
Score int `json:"score"`
// Severity The severity S5 would record. `high` (a score of 3, or 2 for `C1_injection` and `C3_undeclared_capability`) sends the version to a person; `medium` is shown on the report of a version that publishes (ruleset 0.3.0).
Severity DraftRubricFindingSeverity `json:"severity"`
}
DraftRubricFinding defines model for DraftRubricFinding.
type DraftRubricFindingId ¶
type DraftRubricFindingId string
DraftRubricFindingId defines model for DraftRubricFinding.Id.
const ( C1Injection DraftRubricFindingId = "C1_injection" C2Exfiltration DraftRubricFindingId = "C2_exfiltration" C3UndeclaredCapability DraftRubricFindingId = "C3_undeclared_capability" C4UserDeception DraftRubricFindingId = "C4_user_deception" C5Obfuscation DraftRubricFindingId = "C5_obfuscation" C6DestructiveActions DraftRubricFindingId = "C6_destructive_actions" )
Defines values for DraftRubricFindingId.
func (DraftRubricFindingId) Valid ¶
func (e DraftRubricFindingId) Valid() bool
Valid indicates whether the value is a known member of the DraftRubricFindingId enum.
type DraftRubricFindingSeverity ¶
type DraftRubricFindingSeverity string
DraftRubricFindingSeverity The severity S5 would record. `high` (a score of 3, or 2 for `C1_injection` and `C3_undeclared_capability`) sends the version to a person; `medium` is shown on the report of a version that publishes (ruleset 0.3.0).
const ( DraftRubricFindingSeverityHigh DraftRubricFindingSeverity = "high" DraftRubricFindingSeverityMedium DraftRubricFindingSeverity = "medium" )
Defines values for DraftRubricFindingSeverity.
func (DraftRubricFindingSeverity) Valid ¶
func (e DraftRubricFindingSeverity) Valid() bool
Valid indicates whether the value is a known member of the DraftRubricFindingSeverity enum.
type DraftRubricScores ¶
type DraftRubricScores struct {
C1Injection int `json:"C1_injection"`
C2Exfiltration int `json:"C2_exfiltration"`
C3UndeclaredCapability int `json:"C3_undeclared_capability"`
C4UserDeception int `json:"C4_user_deception"`
C5Obfuscation int `json:"C5_obfuscation"`
C6DestructiveActions int `json:"C6_destructive_actions"`
}
DraftRubricScores Per rubric question, 0 to 3, as S5 scores it.
type DraftSetCheck ¶
type DraftSetCheck struct {
// Failure Why a half was not scanned: the judge timed out, failed, or (the draft set only) a part of the draft is past its bound.
Failure *DraftCheckFailure `json:"failure,omitempty"`
Flagged []DraftSetCheckFlagged `json:"flagged"`
// QuestionSet The hash of the draft question set and everything that changes its verdict.
QuestionSet string `json:"questionSet"`
Score int `json:"score"`
// Scores Per draft question, 0 to 3. `off_task`: the instruction would not do the task the description asks for (a different task, a part left out, a different kind of result).
Scores *DraftSetScores `json:"scores,omitempty"`
// Verdict `flagged`: in the rubric half, a high finding (one the gate sends to a person); in the draft half, a question scored 2 or more. `pass`: neither, though the rubric half may list medium findings as notes. `not_scanned`: the judge could not answer for this half.
Verdict DraftCheckVerdict `json:"verdict"`
}
DraftSetCheck defines model for DraftSetCheck.
type DraftSetCheckFlagged ¶
type DraftSetCheckFlagged string
DraftSetCheckFlagged defines model for DraftSetCheck.Flagged.
const (
OffTask DraftSetCheckFlagged = "off_task"
)
Defines values for DraftSetCheckFlagged.
func (DraftSetCheckFlagged) Valid ¶
func (e DraftSetCheckFlagged) Valid() bool
Valid indicates whether the value is a known member of the DraftSetCheckFlagged enum.
type DraftSetScores ¶
type DraftSetScores struct {
OffTask int `json:"off_task"`
}
DraftSetScores Per draft question, 0 to 3. `off_task`: the instruction would not do the task the description asks for (a different task, a part left out, a different kind of result).
type DraftUngrantedTool ¶
type DraftUngrantedTool struct {
// Grant The line of the capability contract the tool needs.
Grant DraftUngrantedToolGrant `json:"grant"`
// Line The first line of the instruction that calls for the tool.
Line int `json:"line"`
// Path The manifest path that holds the grant, such as `capabilities.browser`.
Path string `json:"path"`
// Reason One sentence saying why, which quotes nothing of the instruction but the tool's name (and, for a server's tool, the server's).
Reason string `json:"reason"`
// Tool The tool as the instruction names it (`browser_click`, `run_command`, `fetch`), `browser_*` or `host_*` for a whole family, or `<server>__<tool>` for a declared server's tool.
Tool string `json:"tool"`
}
DraftUngrantedTool defines model for DraftUngrantedTool.
type DraftUngrantedToolGrant ¶
type DraftUngrantedToolGrant string
DraftUngrantedToolGrant The line of the capability contract the tool needs.
const ( Browser DraftUngrantedToolGrant = "browser" Egress DraftUngrantedToolGrant = "egress" Exec DraftUngrantedToolGrant = "exec" FilesystemRead DraftUngrantedToolGrant = "filesystem.read" FilesystemWrite DraftUngrantedToolGrant = "filesystem.write" McpServers DraftUngrantedToolGrant = "mcpServers" TargetHosts DraftUngrantedToolGrant = "targetHosts" )
Defines values for DraftUngrantedToolGrant.
func (DraftUngrantedToolGrant) Valid ¶
func (e DraftUngrantedToolGrant) Valid() bool
Valid indicates whether the value is a known member of the DraftUngrantedToolGrant enum.
type EmailNotificationSettings ¶
type EmailNotificationSettings struct {
// Advisories An advisory naming one of the person's QuickAgents was published.
Advisories bool `json:"advisories"`
// Billing The subscription that pays for the person's work: a checkout confirmed, a payment failed, an organization restricted, seats reached, "your organization covers you" (the hosted product's billing mail; a registry with no billing sends none). Not required on a write: a client that predates the switch leaves it as it was rather than turning it off by omission.
Billing *bool `json:"billing,omitempty"`
// BugReports Platform staff marked a bug report the person filed complete ("Reported bug fixed"; the hosted product's bug-report mail, and a registry without bug reports sends none). Not required on a write: a client that predates the switch leaves it as it was rather than turning it off by omission.
BugReports *bool `json:"bugReports,omitempty"`
// DependencyAlerts A published version declares an MCP server with a newly known vulnerability.
DependencyAlerts bool `json:"dependencyAlerts"`
// OrgInvites The person was added to an organization.
OrgInvites bool `json:"orgInvites"`
// Quarantine A published version was quarantined by a rescan.
Quarantine bool `json:"quarantine"`
// ReviewDecisions A reviewer decided one of the person's submissions, or the gate held one for review.
ReviewDecisions bool `json:"reviewDecisions"`
// Schedules A scheduled run in Agentry failed, or one of the person's schedules paused (the hosted product's schedule mail; never a success, and a registry without hosted schedules sends none). Not required on a write: a client that predates the switch leaves it as it was rather than turning it off by omission.
Schedules *bool `json:"schedules,omitempty"`
}
EmailNotificationSettings Which of the registry's mails the person receives.
type EmailVerificationSent ¶
type EmailVerificationSent struct {
// ResendAfter The earliest moment another link may be sent.
ResendAfter time.Time `json:"resendAfter"`
// SentTo The address the link went to.
SentTo string `json:"sentTo"`
}
EmailVerificationSent defines model for EmailVerificationSent.
type ErasedAccount ¶
ErasedAccount is an account whose registry erasure has committed: what a directory needs to find the person's sign-in account. Identities are the subjects it signed in with ("<provider>:<sub>"), oldest first; Email is the address it held before the erasure.
type ErasureTx ¶
type ErasureTx interface {
Exec(ctx context.Context, sql string, args ...any) (pgconn.CommandTag, error)
Query(ctx context.Context, sql string, args ...any) (pgx.Rows, error)
QueryRow(ctx context.Context, sql string, args ...any) pgx.Row
}
ErasureTx is the erasure's transaction as an eraser may use it: statements, and nothing that ends it. An eraser that could commit would commit the core's erasure half-done; one that could roll back would leave the core's later statements failing on a dead transaction.
type Event ¶
type Event struct {
Kind string
OrgID uuid.UUID // uuid.Nil for a personal namespace or a user event
AgentID uuid.UUID // set for agent transitions
UserID uuid.UUID // set for user.registered, user.data_cleared and account.erased
Payload map[string]any
// Identities and Email are set for account.erased: the subjects the
// account signed in with at individual providers ("<provider>:<sub>"),
// oldest first, and the address it held. The account holds neither
// address nor name by the time the event is heard, so this is the only
// place an extension can learn them from.
Identities []string
Email string
}
Event is one committed event the core fans out to extensions: the org webhook kinds (version.published, agent.quarantined, org.member_added, org.policy_updated, …) carrying the owning org, plus user.registered, user.data_cleared, account.erased, staff.changed and org.created. Payload is the same map the webhook carries.
type ExchangeDesktopCodeJSONRequestBody ¶
type ExchangeDesktopCodeJSONRequestBody = DesktopExchangeRequest
ExchangeDesktopCodeJSONRequestBody defines body for ExchangeDesktopCode for application/json ContentType.
type ExtensionCallbacks ¶
type ExtensionCallbacks struct {
// Secret is the bearer secret every caller presents. Empty switches the
// mount off: every route answers 404. Set, it is at least 32
// characters.
Secret string
// Class is the rate-limit bucket the core applies before the handler:
// "anon", the anonymous bucket per client address, or RateNone for a
// caller that speaks for everyone signing in and must never be
// throttled as one address.
Class string
// Why says what bounds the mount's use, which the route declaration
// records. Required.
Why string
// Routes registers the handlers on a mux rooted at the mount
// ("POST /trusted-device" is /internal/x/<name>/trusted-device).
Routes func(mux *http.ServeMux)
}
ExtensionCallbacks is an extension's callback mount.
type ExtensionTokenResolver ¶ added in v0.6.1000
ExtensionTokenResolver says whose an extension's own bearer token is: the user it was minted for, or false for one the extension does not know (never issued, expired or ended).
type FieldError ¶
FieldError describes one field-level validation failure.
type ForkAgentJSONBody ¶
type ForkAgentJSONBody struct {
// Name The fork's name; the origin's when absent.
Name *string `json:"name,omitempty"`
// Namespace The namespace the fork goes into.
Namespace string `json:"namespace"`
}
ForkAgentJSONBody defines parameters for ForkAgent.
type ForkAgentJSONRequestBody ¶
type ForkAgentJSONRequestBody ForkAgentJSONBody
ForkAgentJSONRequestBody defines body for ForkAgent for application/json ContentType.
type ForkOrigin ¶
type ForkOrigin struct {
// Available Whether the origin is still public, not deleted and not blocked, which is when a client may link it. A quarantined origin is available: its page says it is quarantined.
Available bool `json:"available"`
Name string `json:"name"`
Namespace string `json:"namespace"`
// Version The origin's published version the fork was taken from.
Version string `json:"version"`
}
ForkOrigin What a fork was taken from. Kept for good: there is no detach.
type GetAgentReadmeParams ¶
type GetAgentReadmeParams struct {
// Version Version to render; defaults to the latest published.
Version *string `form:"version,omitempty" json:"version,omitempty"`
}
GetAgentReadmeParams defines parameters for GetAgentReadme.
type GetMcpServerScanParams ¶
type GetMcpServerScanParams struct {
Ecosystem GetMcpServerScanParamsEcosystem `form:"ecosystem" json:"ecosystem"`
Package string `form:"package" json:"package"`
Version string `form:"version" json:"version"`
}
GetMcpServerScanParams defines parameters for GetMcpServerScan.
type GetMcpServerScanParamsEcosystem ¶
type GetMcpServerScanParamsEcosystem string
GetMcpServerScanParamsEcosystem defines parameters for GetMcpServerScan.
const ( GetMcpServerScanParamsEcosystemNpm GetMcpServerScanParamsEcosystem = "npm" GetMcpServerScanParamsEcosystemPypi GetMcpServerScanParamsEcosystem = "pypi" )
Defines values for GetMcpServerScanParamsEcosystem.
func (GetMcpServerScanParamsEcosystem) Valid ¶
func (e GetMcpServerScanParamsEcosystem) Valid() bool
Valid indicates whether the value is a known member of the GetMcpServerScanParamsEcosystem enum.
type GetReviewFileParams ¶
type GetReviewFileParams struct {
Path string `form:"path" json:"path"`
}
GetReviewFileParams defines parameters for GetReviewFile.
type GetUserReportSettingsParams ¶
type GetUserReportSettingsParams struct {
// Include `logo` answers the design with its logo, if the person has one. Without it the design comes without a `logo` key, so a client built before logos still reads it.
Include *ReportSettingsInclude `form:"include,omitempty" json:"include,omitempty"`
}
GetUserReportSettingsParams defines parameters for GetUserReportSettings.
type GetVersionFileParams ¶
type GetVersionFileParams struct {
// Path Repo-relative file path exactly as listVersionFiles reports it.
Path string `form:"path" json:"path"`
}
GetVersionFileParams defines parameters for GetVersionFile.
type InvalidParamFormatError ¶
func (*InvalidParamFormatError) Error ¶
func (e *InvalidParamFormatError) Error() string
func (*InvalidParamFormatError) Unwrap ¶
func (e *InvalidParamFormatError) Unwrap() error
type Invitation ¶
type Invitation struct {
CreatedAt time.Time `json:"createdAt"`
Email string `json:"email"`
// Expired An expired invitation holds no seat and cannot be accepted.
Expired *bool `json:"expired,omitempty"`
ExpiresAt time.Time `json:"expiresAt"`
Id openapi_types.UUID `json:"id"`
// InvitedBy The handle of the admin who sent it.
InvitedBy *string `json:"invitedBy,omitempty"`
// Role An organization role, ordered admin > security_reviewer | member. Admins manage the organization, its members, settings and sign-in policy, and hold the security reviewer's powers; security_reviewer is a platform-internal role that exists only inside a first-party organization; there is no owner role, only admins. An organization always keeps one admin: demoting or removing the last one is 409 last-admin.
Role OrgRole `json:"role"`
}
Invitation defines model for Invitation.
type InvitationOffer ¶
type InvitationOffer struct {
// Acceptable Whether the signed-in account may accept it now.
Acceptable bool `json:"acceptable"`
// Email The address the invitation is bound to.
Email string `json:"email"`
ExpiresAt time.Time `json:"expiresAt"`
Org string `json:"org"`
OrgDisplayName string `json:"orgDisplayName"`
// Reason Why it cannot be accepted, when it cannot.
Reason *string `json:"reason,omitempty"`
// Role An organization role, ordered admin > security_reviewer | member. Admins manage the organization, its members, settings and sign-in policy, and hold the security reviewer's powers; security_reviewer is a platform-internal role that exists only inside a first-party organization; there is no owner role, only admins. An organization always keeps one admin: demoting or removing the last one is 409 last-admin.
Role OrgRole `json:"role"`
}
InvitationOffer defines model for InvitationOffer.
type JudgeUsage ¶
type JudgeUsage struct {
CompletionTokens int `json:"completionTokens"`
PromptTokens int `json:"promptTokens"`
}
JudgeUsage The token use the AI Review model's provider reported for this scan run — what the review cost, as measured. Present for platform staff only, and absent when the provider reported none (the static and classifier judges, an endpoint without a usage block); absent means unknown, not zero. Not part of the signed report.
type KnowledgeAdmission ¶
type KnowledgeAdmission struct {
User uuid.UUID
OwnerKind string // "user" or "org"
OwnerID uuid.UUID
Pack uuid.UUID
Bytes int64
Files int
}
KnowledgeAdmission is an upload of a pack's tree that will queue a scan, as an extension admits it: the account uploading, the pack's owner (the account, or an organization) and the tree's size. The payer is the extension's to decide.
type KnowledgeAdmitter ¶
type KnowledgeAdmitter interface {
// AdmitKnowledge returns a ticket, or a Refusal the route answers in its
// own status and words. An error is "unknown": the route fails closed
// with 503 and stores nothing.
AdmitKnowledge(ctx context.Context, a KnowledgeAdmission) (registry.Ticket, *registry.Refusal, error)
// VoidKnowledge cancels a ticket for an upload the core then did not
// store (the account's allocation, a lost race). It must be idempotent.
// A void can fail or never be called (a crash between the admission and
// the store): the core records each ticket it stored in admitted_stores,
// in the storing transaction, so a ticket with no row there stored
// nothing.
VoidKnowledge(ctx context.Context, t registry.Ticket) error
}
KnowledgeAdmitter is the seam through which an extension admits the scan an upload of a pack's tree queues, and may charge for it (pkg/extension AdmitsKnowledge). It is asked once per upload, after the core has read the tree and before anything is stored: an upload the core refuses (it does not read, it is too large, or it is past the allocation as the allocation stands) is never asked about, and one of the tree the pack already holds queues no scan and is not asked about either. A pack the extension builds and stores itself is not admitted here. The core has none, and admits every upload.
type KnowledgeDataKey ¶
type KnowledgeDataKey struct {
// Key A pack's 32-byte data key.
Key []byte `json:"key"`
}
KnowledgeDataKey defines model for KnowledgeDataKey.
type KnowledgePack ¶
type KnowledgePack struct {
// Bytes The tree's files, in bytes, as the CLI counts them.
Bytes int64 `json:"bytes"`
CreatedAt time.Time `json:"createdAt"`
// Digest sha256:<hex> of the tree; empty before an upload.
Digest string `json:"digest"`
// Exportable On a shared pack: whether its members may export it, which an admin marks. Its admins export it either way; a person's own pack is theirs to export and carries no flag.
Exportable *bool `json:"exportable,omitempty"`
Files int `json:"files"`
Id openapi_types.UUID `json:"id"`
Name string `json:"name"`
// Org The organization's handle, on a shared pack.
Org *string `json:"org,omitempty"`
// Pages The wiki's pages, the index and the log aside.
Pages int `json:"pages"`
// Scan What a pack's scan read and found: a record, never a gate. The stages that read prose over every text file, then AI Review over `sources/` and then `wiki/` in chunks no larger than the judge declares it reads.
Scan *KnowledgeScanReport `json:"scan,omitempty"`
ScannedAt *time.Time `json:"scannedAt,omitempty"`
Shared bool `json:"shared"`
// State `empty` until a tree is uploaded; `scanning` from each upload until its scan ends, when the pack cannot be downloaded or exported (409 `knowledge-scanning`); `ready` after it, findings or not; `failed` when the stored tree could not be read to scan.
State KnowledgePackState `json:"state"`
UpdatedAt time.Time `json:"updatedAt"`
// WrappedKey A pack's data key as a wrapper sealed it: the wrapper's `kind` (`deployment` on a core registry), the `recipient` it is wrapped to (a key's id, never a key), and the sealed bytes.
WrappedKey KnowledgeWrappedKey `json:"wrappedKey"`
}
KnowledgePack A knowledge pack the caller keeps in the registry: what may be read of it without its data key, and the key as the caller's wrapper wrapped it.
type KnowledgePackId ¶
type KnowledgePackId = openapi_types.UUID
KnowledgePackId defines model for KnowledgePackId.
type KnowledgePackSize ¶
type KnowledgePackSize struct {
Bytes int64 `json:"bytes"`
CreatedAt time.Time `json:"createdAt"`
Id openapi_types.UUID `json:"id"`
Name string `json:"name"`
// State `empty` until a tree is uploaded; `scanning` from each upload until its scan ends, when the pack cannot be downloaded or exported (409 `knowledge-scanning`); `ready` after it, findings or not; `failed` when the stored tree could not be read to scan.
State KnowledgePackState `json:"state"`
UpdatedAt time.Time `json:"updatedAt"`
}
KnowledgePackSize defines model for KnowledgePackSize.
type KnowledgePackState ¶
type KnowledgePackState string
KnowledgePackState `empty` until a tree is uploaded; `scanning` from each upload until its scan ends, when the pack cannot be downloaded or exported (409 `knowledge-scanning`); `ready` after it, findings or not; `failed` when the stored tree could not be read to scan.
const ( KnowledgePackStateEmpty KnowledgePackState = "empty" KnowledgePackStateFailed KnowledgePackState = "failed" KnowledgePackStateReady KnowledgePackState = "ready" KnowledgePackStateScanning KnowledgePackState = "scanning" )
Defines values for KnowledgePackState.
func (KnowledgePackState) Valid ¶
func (e KnowledgePackState) Valid() bool
Valid indicates whether the value is a known member of the KnowledgePackState enum.
type KnowledgeScanReport ¶
type KnowledgeScanReport struct {
Findings []struct {
Chunk *int `json:"chunk,omitempty"`
Confidence string `json:"confidence"`
File *string `json:"file,omitempty"`
Line *int `json:"line,omitempty"`
Part KnowledgeScanReportFindingsPart `json:"part"`
Scanner string `json:"scanner"`
Severity KnowledgeScanReportFindingsSeverity `json:"severity"`
Title string `json:"title"`
} `json:"findings"`
Read struct {
Bytes int64 `json:"bytes"`
// NotRead Files not read as text — a source's original, whose extracted text beside it is read.
NotRead []string `json:"notRead"`
Sources int `json:"sources"`
Wiki int `json:"wiki"`
} `json:"read"`
Review struct {
ChunkBytes *int `json:"chunkBytes,omitempty"`
Configured bool `json:"configured"`
Error *string `json:"error,omitempty"`
// Failed Chunks the judge failed on; the review is incomplete when it is not 0.
Failed *int `json:"failed,omitempty"`
Model *string `json:"model,omitempty"`
// Note "AI Review not configured" on a registry whose judge provider is none.
Note *string `json:"note,omitempty"`
Provider string `json:"provider"`
RubricHash *string `json:"rubricHash,omitempty"`
SourceChunks int `json:"sourceChunks"`
// Usage The token use the AI Review model's provider reported for this scan run — what the review cost, as measured. Present for platform staff only, and absent when the provider reported none (the static and classifier judges, an endpoint without a usage block); absent means unknown, not zero. Not part of the signed report.
Usage *JudgeUsage `json:"usage,omitempty"`
WikiChunks int `json:"wikiChunks"`
} `json:"review"`
Schema string `json:"schema"`
Stages []struct {
// Failed The stage did not finish (a timeout, a panic); its findings are not all there are.
Failed *bool `json:"failed,omitempty"`
Id string `json:"id"`
Name string `json:"name"`
} `json:"stages"`
}
KnowledgeScanReport What a pack's scan read and found: a record, never a gate. The stages that read prose over every text file, then AI Review over `sources/` and then `wiki/` in chunks no larger than the judge declares it reads.
type KnowledgeScanReportFindingsPart ¶
type KnowledgeScanReportFindingsPart string
KnowledgeScanReportFindingsPart defines model for KnowledgeScanReport.Findings.Part.
const ( Sources KnowledgeScanReportFindingsPart = "sources" Wiki KnowledgeScanReportFindingsPart = "wiki" )
Defines values for KnowledgeScanReportFindingsPart.
func (KnowledgeScanReportFindingsPart) Valid ¶
func (e KnowledgeScanReportFindingsPart) Valid() bool
Valid indicates whether the value is a known member of the KnowledgeScanReportFindingsPart enum.
type KnowledgeScanReportFindingsSeverity ¶
type KnowledgeScanReportFindingsSeverity string
KnowledgeScanReportFindingsSeverity defines model for KnowledgeScanReport.Findings.Severity.
const ( KnowledgeScanReportFindingsSeverityCritical KnowledgeScanReportFindingsSeverity = "critical" KnowledgeScanReportFindingsSeverityHigh KnowledgeScanReportFindingsSeverity = "high" KnowledgeScanReportFindingsSeverityInfo KnowledgeScanReportFindingsSeverity = "info" KnowledgeScanReportFindingsSeverityLow KnowledgeScanReportFindingsSeverity = "low" KnowledgeScanReportFindingsSeverityMedium KnowledgeScanReportFindingsSeverity = "medium" )
Defines values for KnowledgeScanReportFindingsSeverity.
func (KnowledgeScanReportFindingsSeverity) Valid ¶
func (e KnowledgeScanReportFindingsSeverity) Valid() bool
Valid indicates whether the value is a known member of the KnowledgeScanReportFindingsSeverity enum.
type KnowledgeShipping ¶
type KnowledgeShipping struct {
Packs []ShippedPack `json:"packs"`
}
KnowledgeShipping A publisher's confirmation that the knowledge packs a release ships become readable by everyone who can download it: one entry for each pack the package's manifest ships (`knowledge.ships`), no more and no fewer.
type KnowledgeUsage ¶
type KnowledgeUsage struct {
// Bytes The bytes of every pack the caller keeps here.
Bytes int64 `json:"bytes"`
// Max The allocation; 0 is no cap.
Max int64 `json:"max"`
// Packs The packs the caller keeps here.
Packs int `json:"packs"`
// Pooled The allocation is shared with other owners.
Pooled bool `json:"pooled"`
// Used What counts against the allocation: `bytes`, or, when `pooled`, the pool's total — every pack of every owner who shares it (a paid organization's, and its members').
Used int64 `json:"used"`
}
KnowledgeUsage defines model for KnowledgeUsage.
type KnowledgeWrappedKey ¶
type KnowledgeWrappedKey struct {
Key []byte `json:"key"`
Kind string `json:"kind"`
Recipient string `json:"recipient"`
}
KnowledgeWrappedKey A pack's data key as a wrapper sealed it: the wrapper's `kind` (`deployment` on a core registry), the `recipient` it is wrapped to (a key's id, never a key), and the sealed bytes.
type LastAdminError ¶ added in v0.6.1000
type LastAdminError struct{ Org string }
LastAdminError is ErrLastAdmin with the organization the account must hand over first.
func (LastAdminError) Error ¶ added in v0.6.1000
func (e LastAdminError) Error() string
func (LastAdminError) Is ¶ added in v0.6.1000
func (e LastAdminError) Is(target error) bool
type ListAbuseReportsParams ¶
type ListAbuseReportsParams struct {
// State Filter by triage state; defaults to open.
State *ListAbuseReportsParamsState `form:"state,omitempty" json:"state,omitempty"`
Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
}
ListAbuseReportsParams defines parameters for ListAbuseReports.
type ListAbuseReportsParamsState ¶
type ListAbuseReportsParamsState string
ListAbuseReportsParamsState defines parameters for ListAbuseReports.
const ( ListAbuseReportsParamsStateActioned ListAbuseReportsParamsState = "actioned" ListAbuseReportsParamsStateDismissed ListAbuseReportsParamsState = "dismissed" ListAbuseReportsParamsStateOpen ListAbuseReportsParamsState = "open" ListAbuseReportsParamsStateTriaged ListAbuseReportsParamsState = "triaged" )
Defines values for ListAbuseReportsParamsState.
func (ListAbuseReportsParamsState) Valid ¶
func (e ListAbuseReportsParamsState) Valid() bool
Valid indicates whether the value is a known member of the ListAbuseReportsParamsState enum.
type ListAdvisoriesParams ¶
type ListAdvisoriesParams struct {
// Affecting ns/name. Omit for the global feed.
Affecting *string `form:"affecting,omitempty" json:"affecting,omitempty"`
// Digest With `affecting`: the `archiveDigest` of a release of that agent the caller holds. It proves the caller held the agent, so its advisories are served even when the agent is now private, retired or deleted. Ignored without `affecting` and when the caller can read the agent anyway.
Digest *string `form:"digest,omitempty" json:"digest,omitempty"`
// Cursor Opaque keyset cursor from the previous page's Link header (feed mode).
Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
// Limit Page size (feed mode; clamped).
Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
}
ListAdvisoriesParams defines parameters for ListAdvisories.
type ListAgentActivityParams ¶
type ListAgentActivityParams struct {
// Cursor Opaque cursor from the previous page's `Link` header.
Cursor *Cursor `form:"cursor,omitempty" json:"cursor,omitempty"`
// Limit Page size; values outside the range are clamped, not rejected.
Limit *Limit100 `form:"limit,omitempty" json:"limit,omitempty"`
}
ListAgentActivityParams defines parameters for ListAgentActivity.
type ListAgentsByTagParams ¶
type ListAgentsByTagParams struct {
// Cursor Opaque cursor from the previous page's `Link` header.
Cursor *Cursor `form:"cursor,omitempty" json:"cursor,omitempty"`
// Limit Page size; values outside the range are clamped, not rejected.
Limit *Limit100 `form:"limit,omitempty" json:"limit,omitempty"`
}
ListAgentsByTagParams defines parameters for ListAgentsByTag.
type ListAgentsParams ¶
type ListAgentsParams struct {
Namespace string `form:"namespace" json:"namespace"`
// Q Case-insensitive substring of the agent's name or summary.
Q *string `form:"q,omitempty" json:"q,omitempty"`
// State `active` lists agents that are not retired, `retired` only the retired ones; absent, both.
State *ListAgentsParamsState `form:"state,omitempty" json:"state,omitempty"`
// Forks `only` lists the namespace's forks, `none` the agents that are not forks; absent, both.
Forks *ListAgentsParamsForks `form:"forks,omitempty" json:"forks,omitempty"`
// Sort `name` (the default), `newest` (created), `installs` (the last 30 days) or `submitted` (the newest submission of any version).
Sort *ListAgentsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`
}
ListAgentsParams defines parameters for ListAgents.
type ListAgentsParamsForks ¶
type ListAgentsParamsForks string
ListAgentsParamsForks defines parameters for ListAgents.
const ( ListAgentsParamsForksNone ListAgentsParamsForks = "none" ListAgentsParamsForksOnly ListAgentsParamsForks = "only" )
Defines values for ListAgentsParamsForks.
func (ListAgentsParamsForks) Valid ¶
func (e ListAgentsParamsForks) Valid() bool
Valid indicates whether the value is a known member of the ListAgentsParamsForks enum.
type ListAgentsParamsSort ¶
type ListAgentsParamsSort string
ListAgentsParamsSort defines parameters for ListAgents.
const ( ListAgentsParamsSortInstalls ListAgentsParamsSort = "installs" ListAgentsParamsSortName ListAgentsParamsSort = "name" ListAgentsParamsSortNewest ListAgentsParamsSort = "newest" ListAgentsParamsSortSubmitted ListAgentsParamsSort = "submitted" )
Defines values for ListAgentsParamsSort.
func (ListAgentsParamsSort) Valid ¶
func (e ListAgentsParamsSort) Valid() bool
Valid indicates whether the value is a known member of the ListAgentsParamsSort enum.
type ListAgentsParamsState ¶
type ListAgentsParamsState string
ListAgentsParamsState defines parameters for ListAgents.
const ( ListAgentsParamsStateActive ListAgentsParamsState = "active" ListAgentsParamsStateRetired ListAgentsParamsState = "retired" )
Defines values for ListAgentsParamsState.
func (ListAgentsParamsState) Valid ¶
func (e ListAgentsParamsState) Valid() bool
Valid indicates whether the value is a known member of the ListAgentsParamsState enum.
type ListKnowledgePackSizesParams ¶
type ListKnowledgePackSizesParams struct {
// Owner The account's or the organization's handle.
Owner string `form:"owner" json:"owner"`
}
ListKnowledgePackSizesParams defines parameters for ListKnowledgePackSizes.
type ListOrgAuditParams ¶
type ListOrgAuditParams struct {
Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
Action *string `form:"action,omitempty" json:"action,omitempty"`
}
ListOrgAuditParams defines parameters for ListOrgAudit.
type ListPlatformAuditParams ¶
type ListPlatformAuditParams struct {
// Cursor Opaque cursor from the previous page's `Link` header.
Cursor *Cursor `form:"cursor,omitempty" json:"cursor,omitempty"`
// Limit Page size; values outside the range are clamped, not rejected.
Limit *Limit200 `form:"limit,omitempty" json:"limit,omitempty"`
Action *string `form:"action,omitempty" json:"action,omitempty"`
// Org Restrict to one org handle.
Org *string `form:"org,omitempty" json:"org,omitempty"`
}
ListPlatformAuditParams defines parameters for ListPlatformAudit.
type ListRedTeamReportsParams ¶
type ListRedTeamReportsParams struct {
Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
}
ListRedTeamReportsParams defines parameters for ListRedTeamReports.
type ListReviewQueueParams ¶
type ListReviewQueueParams struct {
Queue ListReviewQueueParamsQueue `form:"queue" json:"queue"`
// Org The organization of an org queue; optional for platform staff.
Org *string `form:"org,omitempty" json:"org,omitempty"`
Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
}
ListReviewQueueParams defines parameters for ListReviewQueue.
type ListReviewQueueParamsQueue ¶
type ListReviewQueueParamsQueue string
ListReviewQueueParamsQueue defines parameters for ListReviewQueue.
const ( ListReviewQueueParamsQueueOrg ListReviewQueueParamsQueue = "org" ListReviewQueueParamsQueuePlatform ListReviewQueueParamsQueue = "platform" )
Defines values for ListReviewQueueParamsQueue.
func (ListReviewQueueParamsQueue) Valid ¶
func (e ListReviewQueueParamsQueue) Valid() bool
Valid indicates whether the value is a known member of the ListReviewQueueParamsQueue enum.
type ListUserActivityParams ¶
type ListUserActivityParams struct {
Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
Cursor *string `form:"cursor,omitempty" json:"cursor,omitempty"`
}
ListUserActivityParams defines parameters for ListUserActivity.
type ListWebhookDeliveriesParams ¶
type ListWebhookDeliveriesParams struct {
// Cursor Opaque cursor from the previous page's `Link` header.
Cursor *Cursor `form:"cursor,omitempty" json:"cursor,omitempty"`
// Limit Page size; values outside the range are clamped, not rejected.
Limit *Limit100 `form:"limit,omitempty" json:"limit,omitempty"`
}
ListWebhookDeliveriesParams defines parameters for ListWebhookDeliveries.
type LoginResult ¶
type LoginResult struct {
// CsrfToken Echo in X-Agentry-CSRF on cookie-authenticated mutations.
CsrfToken string `json:"csrfToken"`
User User `json:"user"`
}
LoginResult defines model for LoginResult.
type McpAdvisory ¶
type McpAdvisory struct {
Aliases *[]string `json:"aliases,omitempty"`
// CvssScore The highest CVSS base score among the advisory's CVSS v3.x and v4.0 vectors (or plain scores). Absent when it carries none, and on a record last checked before scores were read.
CvssScore *float64 `json:"cvssScore,omitempty"`
FixedIn *[]string `json:"fixedIn,omitempty"`
// GateSeverity The severity the gate gives the finding this advisory makes: a Critical advisory is critical and rejects the version; a High one is high from a CVSS base score of 8.5 and medium below it, and high when it carries no usable score; any other is its own severity. Served so the runner can apply the same rule.
GateSeverity McpAdvisoryGateSeverity `json:"gateSeverity"`
Id string `json:"id"`
References *[]string `json:"references,omitempty"`
// Severity The advisory's own severity: the database's word, else the band of its CVSS base score. Dependency alerts are opened on it.
Severity McpAdvisorySeverity `json:"severity"`
Summary string `json:"summary"`
}
McpAdvisory defines model for McpAdvisory.
type McpAdvisoryGateSeverity ¶
type McpAdvisoryGateSeverity string
McpAdvisoryGateSeverity The severity the gate gives the finding this advisory makes: a Critical advisory is critical and rejects the version; a High one is high from a CVSS base score of 8.5 and medium below it, and high when it carries no usable score; any other is its own severity. Served so the runner can apply the same rule.
const ( McpAdvisoryGateSeverityCritical McpAdvisoryGateSeverity = "critical" McpAdvisoryGateSeverityHigh McpAdvisoryGateSeverity = "high" McpAdvisoryGateSeverityInfo McpAdvisoryGateSeverity = "info" McpAdvisoryGateSeverityLow McpAdvisoryGateSeverity = "low" McpAdvisoryGateSeverityMedium McpAdvisoryGateSeverity = "medium" )
Defines values for McpAdvisoryGateSeverity.
func (McpAdvisoryGateSeverity) Valid ¶
func (e McpAdvisoryGateSeverity) Valid() bool
Valid indicates whether the value is a known member of the McpAdvisoryGateSeverity enum.
type McpAdvisorySeverity ¶
type McpAdvisorySeverity string
McpAdvisorySeverity The advisory's own severity: the database's word, else the band of its CVSS base score. Dependency alerts are opened on it.
const ( McpAdvisorySeverityCritical McpAdvisorySeverity = "critical" McpAdvisorySeverityHigh McpAdvisorySeverity = "high" McpAdvisorySeverityInfo McpAdvisorySeverity = "info" McpAdvisorySeverityLow McpAdvisorySeverity = "low" McpAdvisorySeverityMedium McpAdvisorySeverity = "medium" )
Defines values for McpAdvisorySeverity.
func (McpAdvisorySeverity) Valid ¶
func (e McpAdvisorySeverity) Valid() bool
Valid indicates whether the value is a known member of the McpAdvisorySeverity enum.
type McpServerScan ¶
type McpServerScan struct {
Advisories []McpAdvisory `json:"advisories"`
Ecosystem McpServerScanEcosystem `json:"ecosystem"`
FirstSeenAt time.Time `json:"firstSeenAt"`
LastCheckedAt time.Time `json:"lastCheckedAt"`
LastError *string `json:"lastError,omitempty"`
MaxSeverity *McpServerScanMaxSeverity `json:"maxSeverity,omitempty"`
Package string `json:"package"`
// Status safe means no known advisories when last checked (OSV), and nothing else about the server. A version its package registry does not publish is served as error, with lastError saying so, so no client meets a value the contract lacks.
Status McpServerScanStatus `json:"status"`
Version string `json:"version"`
}
McpServerScan defines model for McpServerScan.
type McpServerScanEcosystem ¶
type McpServerScanEcosystem string
McpServerScanEcosystem defines model for McpServerScan.Ecosystem.
const ( McpServerScanEcosystemNpm McpServerScanEcosystem = "npm" McpServerScanEcosystemPypi McpServerScanEcosystem = "pypi" )
Defines values for McpServerScanEcosystem.
func (McpServerScanEcosystem) Valid ¶
func (e McpServerScanEcosystem) Valid() bool
Valid indicates whether the value is a known member of the McpServerScanEcosystem enum.
type McpServerScanMaxSeverity ¶
type McpServerScanMaxSeverity string
McpServerScanMaxSeverity defines model for McpServerScan.MaxSeverity.
const ( McpServerScanMaxSeverityCritical McpServerScanMaxSeverity = "critical" McpServerScanMaxSeverityHigh McpServerScanMaxSeverity = "high" McpServerScanMaxSeverityInfo McpServerScanMaxSeverity = "info" McpServerScanMaxSeverityLow McpServerScanMaxSeverity = "low" McpServerScanMaxSeverityMedium McpServerScanMaxSeverity = "medium" )
Defines values for McpServerScanMaxSeverity.
func (McpServerScanMaxSeverity) Valid ¶
func (e McpServerScanMaxSeverity) Valid() bool
Valid indicates whether the value is a known member of the McpServerScanMaxSeverity enum.
type McpServerScanStatus ¶
type McpServerScanStatus string
McpServerScanStatus safe means no known advisories when last checked (OSV), and nothing else about the server. A version its package registry does not publish is served as error, with lastError saying so, so no client meets a value the contract lacks.
const ( Error McpServerScanStatus = "error" Safe McpServerScanStatus = "safe" Vulnerable McpServerScanStatus = "vulnerable" )
Defines values for McpServerScanStatus.
func (McpServerScanStatus) Valid ¶
func (e McpServerScanStatus) Valid() bool
Valid indicates whether the value is a known member of the McpServerScanStatus enum.
type Membership ¶
type Membership struct {
// Role An organization role, ordered admin > security_reviewer | member. Admins manage the organization, its members, settings and sign-in policy, and hold the security reviewer's powers; security_reviewer is a platform-internal role that exists only inside a first-party organization; there is no owner role, only admins. An organization always keeps one admin: demoting or removing the last one is 409 last-admin.
Role OrgRole `json:"role"`
// State Whether the membership is in force. `pending` is someone the organization's IdP provisioned, or its domain folded in, who holds no seat and nothing of the organization until an admin approves them; `active` is a member. Declining a pending member removes them, and a decline is remembered: the domain does not fold that person in again unless an admin invites them.
State *MembershipState `json:"state,omitempty"`
User PublicUser `json:"user"`
// ViaDomain The domain folded this person in: their verified address is at a domain the organization holds, and they became pending at a sign-in or by the sweep that runs when the organization gains the domain. An admin's approval keeps the flag; the console says how each member arrived.
ViaDomain *bool `json:"viaDomain,omitempty"`
ViaScim *bool `json:"viaScim,omitempty"`
}
Membership defines model for Membership.
type MembershipState ¶
type MembershipState string
MembershipState Whether the membership is in force. `pending` is someone the organization's IdP provisioned, or its domain folded in, who holds no seat and nothing of the organization until an admin approves them; `active` is a member. Declining a pending member removes them, and a decline is remembered: the domain does not fold that person in again unless an admin invites them.
const ( MembershipStateActive MembershipState = "active" MembershipStatePending MembershipState = "pending" )
Defines values for MembershipState.
func (MembershipState) Valid ¶
func (e MembershipState) Valid() bool
Valid indicates whether the value is a known member of the MembershipState enum.
type Meta ¶
type Meta struct {
// ApiVersion API surface major.
//
// Example: v1
ApiVersion string `json:"apiVersion"`
// Brand What this deployment calls itself (config `brand.*`): the name for prompts and titles, and optional logo and support address.
Brand *BrandInfo `json:"brand,omitempty"`
// Extensions Names of the extensions this build mounts under `/api/v1/x/<name>/` (registered through pkg/extension); absent on the core build.
Extensions *[]string `json:"extensions,omitempty"`
// Features Self-host feature flags: `judge`, `signing`, `redis`, `s3`, `publicPublish2FA` (the server refuses a public publish from an account it holds no second-factor evidence for, an OpenID provider sign-in whose `amr` named a factor; on only under `auth.requireIdpMFA` and never in dev mode, so a client states that requirement only when this is true), and `knowledge` (the store of knowledge packs is on: the registry has a knowledge sealing key or an extension that wraps keys, so `/knowledge/…` answers rather than 503).
Features map[string]bool `json:"features"`
// MinCLIVersion Oldest supported agentry CLI version.
MinCLIVersion *string `json:"minCLIVersion,omitempty"`
// SignInProviders The individual sign-in providers this registry has configured (the `provider` ids of `/auth/oidc/{provider}/start`, in that enum's order), so a front end can offer them without starting a flow to find out. Empty when none is configured. A provider is listed when its client id and secret are set, and an issuer where it has no default; a listed provider's start redirects and an unlisted one's answers 404. A listed provider whose issuer cannot be reached at that moment also answers 404 there, since its discovery fails.
SignInProviders *[]string `json:"signInProviders,omitempty"`
// Ui The server's own browser surface under `/ui/`. `mode` is `full` (device authorize, plus the sign-in hand-off to the OpenID provider, sign-out and the address-confirmation page), `authorize` (only the device-authorize page — a site fronts this server) or `off`. `authorizeUrl` is the absolute page a CLI or the desktop app opens for browser sign-in, when served.
Ui *UIInfo `json:"ui,omitempty"`
// Version agentryd semantic version (build-stamped).
//
// Example: 0.1.0
Version string `json:"version"`
}
Meta defines model for Meta.
type ModelInputCall ¶
type ModelInputCall struct {
Op ModelInputOp
// Source is the scan's source; empty for a search or a check.
Source judge.Source
// Bytes is the scan's text length, or a check's over every file;
// Count the search's result count.
Bytes int
Count int
}
ModelInputCall is what a job credential is asking to do, for the extension to admit or refuse (a job past its searches, say).
type ModelInputCallers ¶
type ModelInputCallers interface {
// AdmitModelInput names the job a credential acts for, or refuses the
// call: a Refusal the route answers in its own status and words, or ""
// with no refusal for a credential that names no job, which is 401.
// An error is "unknown", and the route fails closed with 503.
AdmitModelInput(ctx context.Context, credential string, call ModelInputCall) (job string, refusal *registry.Refusal, err error)
// RecordModelInput records an admitted call's use against its job.
RecordModelInput(ctx context.Context, job string, use ModelInputUse)
}
ModelInputCallers is the seam through which an extension admits hosted jobs to the model-input routes (pkg/extension AdmitsModelInput). The core has none, so on a core registry only platform staff reach the routes.
type ModelInputChunk ¶
type ModelInputChunk struct {
Bytes int `json:"bytes"`
// Failure Why a chunk was not scanned.
Failure *ModelInputChunkFailure `json:"failure,omitempty"`
Index int `json:"index"`
// Scores Per question, 0 to 3 (0.5, 0.7 and 0.9 are 1, 2 and 3).
Scores *ModelInputScores `json:"scores,omitempty"`
// Verdict `pass`: no question scored 2 or more. `withheld`: one did; the model gets the source's address and the reason, never the text. `not_scanned`: the judge could not answer for part of the text; a caller treats it as withheld.
Verdict ModelInputVerdict `json:"verdict"`
}
ModelInputChunk defines model for ModelInputChunk.
type ModelInputChunkFailure ¶
type ModelInputChunkFailure string
ModelInputChunkFailure Why a chunk was not scanned.
const ( ModelInputChunkFailureJudgeError ModelInputChunkFailure = "judge-error" ModelInputChunkFailureTimeout ModelInputChunkFailure = "timeout" )
Defines values for ModelInputChunkFailure.
func (ModelInputChunkFailure) Valid ¶
func (e ModelInputChunkFailure) Valid() bool
Valid indicates whether the value is a known member of the ModelInputChunkFailure enum.
type ModelInputOp ¶
type ModelInputOp string
ModelInputOp is which model-input route a call is.
const ( ModelInputOpScan ModelInputOp = "scan" ModelInputOpSearch ModelInputOp = "search" // ModelInputOpCheck is AI Review of a finished draft: // the release rubric and the draft question set over its package. ModelInputOpCheck ModelInputOp = "check" )
The model-input operations.
type ModelInputScan ¶
type ModelInputScan struct {
Chunks []ModelInputChunk `json:"chunks"`
// Flagged The questions that scored 2 or more.
Flagged []ModelInputScanFlagged `json:"flagged"`
// Model The pinned judge model, such as `jev-1.13.0`.
Model string `json:"model"`
// QuestionSet The hash of the question set and everything else that changes a verdict (model, wording, chunk size, thresholds).
QuestionSet string `json:"questionSet"`
// Score The highest score over every chunk and question.
Score int `json:"score"`
// Scores Per question, 0 to 3 (0.5, 0.7 and 0.9 are 1, 2 and 3).
Scores ModelInputScores `json:"scores"`
// Usage The judge's requests and input tokens, for the record. Never a price: AI Review is charged per operation.
Usage ModelInputUsage `json:"usage"`
// Verdict `pass`: no question scored 2 or more. `withheld`: one did; the model gets the source's address and the reason, never the text. `not_scanned`: the judge could not answer for part of the text; a caller treats it as withheld.
Verdict ModelInputVerdict `json:"verdict"`
}
ModelInputScan defines model for ModelInputScan.
type ModelInputScanFlagged ¶
type ModelInputScanFlagged string
ModelInputScanFlagged defines model for ModelInputScan.Flagged.
const ( ModelInputScanFlaggedDeception ModelInputScanFlagged = "deception" ModelInputScanFlaggedExfiltration ModelInputScanFlagged = "exfiltration" ModelInputScanFlaggedInjection ModelInputScanFlagged = "injection" ModelInputScanFlaggedObfuscation ModelInputScanFlagged = "obfuscation" )
Defines values for ModelInputScanFlagged.
func (ModelInputScanFlagged) Valid ¶
func (e ModelInputScanFlagged) Valid() bool
Valid indicates whether the value is a known member of the ModelInputScanFlagged enum.
type ModelInputScanRequest ¶
type ModelInputScanRequest struct {
// Source What the text is: a person's description, one web search result, a web page's text, an answer from the registry's public API, or a hosted run's input file as decoded text. It rides beside the text in the judge's state; nothing of the text reaches a question.
Source ModelInputSource `json:"source"`
// Text The text as the model would read it, at most 65,536 bytes of UTF-8 (eight chunks); a longer text is sent in parts.
Text string `json:"text"`
}
ModelInputScanRequest defines model for ModelInputScanRequest.
type ModelInputScanner ¶
type ModelInputScanner interface {
Scan(ctx context.Context, source judge.Source, text string) judge.ScanResult
Model() string
QuestionSet() string
}
ModelInputScanner scans text as model input: *judge.ModelInputScanner.
type ModelInputScores ¶
type ModelInputScores struct {
Deception int `json:"deception"`
Exfiltration int `json:"exfiltration"`
Injection int `json:"injection"`
Obfuscation int `json:"obfuscation"`
}
ModelInputScores Per question, 0 to 3 (0.5, 0.7 and 0.9 are 1, 2 and 3).
type ModelInputSource ¶
type ModelInputSource string
ModelInputSource What the text is: a person's description, one web search result, a web page's text, an answer from the registry's public API, or a hosted run's input file as decoded text. It rides beside the text in the judge's state; nothing of the text reaches a question.
const ( Description ModelInputSource = "description" InputFile ModelInputSource = "input_file" Page ModelInputSource = "page" Registry ModelInputSource = "registry" SearchResult ModelInputSource = "search_result" )
Defines values for ModelInputSource.
func (ModelInputSource) Valid ¶
func (e ModelInputSource) Valid() bool
Valid indicates whether the value is a known member of the ModelInputSource enum.
type ModelInputUsage ¶
ModelInputUsage The judge's requests and input tokens, for the record. Never a price: AI Review is charged per operation.
type ModelInputUse ¶
type ModelInputUse struct {
Op ModelInputOp
// Requests and InputTokens are the judge's.
Requests int
InputTokens int
// Scanned counts the texts scanned (1 for a scan or a check, one per
// result for a search); Withheld those withheld, flagged or not
// scanned.
Scanned int
Withheld int
// Searches is 1 for a search the provider answered.
Searches int
}
ModelInputUse is what one admitted call spent, for the record against its job. It is a count, never a price: AI Review is 1 credit an operation, however many scans it makes.
type ModelInputVerdict ¶
type ModelInputVerdict string
ModelInputVerdict `pass`: no question scored 2 or more. `withheld`: one did; the model gets the source's address and the reason, never the text. `not_scanned`: the judge could not answer for part of the text; a caller treats it as withheld.
const ( ModelInputVerdictNotScanned ModelInputVerdict = "not_scanned" ModelInputVerdictPass ModelInputVerdict = "pass" ModelInputVerdictWithheld ModelInputVerdict = "withheld" )
Defines values for ModelInputVerdict.
func (ModelInputVerdict) Valid ¶
func (e ModelInputVerdict) Valid() bool
Valid indicates whether the value is a known member of the ModelInputVerdict enum.
type MountDecl ¶
type MountDecl struct {
Gate MountGate
// Class is the rate-limit bucket the mount's own code applies, or one of the
// two sentinels. The gate checks the name against the catalogued set, so
// a typo fails; it cannot check the wiring. That the handler really
// draws from the bucket named here is the handler's own tests' job, and
// a declaration that lies about it passes.
Class string
Why string
}
MountDecl declares one root mount: what gates it, and which rate class it draws from. Why is required when the gate is public or the class is one of the two sentinels — the declaration is where a reviewer looks for the reason, and both are choices that go stale silently.
func MountAuthzDecl ¶
MountAuthzDecl returns the declaration for a root mount's pattern, falling back to the extension prefix's for a pattern under it.
type MountGate ¶
type MountGate string
MountGate is what stands between a caller and a root mount. A route on the generated surface states its gate through RouteDecl's action and flags; a root mount has no operationId to key a RouteDecl on, so it states it here.
const ( // GatePublic takes no credential: the handler's own checks are all // there is. GatePublic MountGate = "public" // GateSignature's only gate is an HMAC over the request. GateSignature MountGate = "signature" // GateGit is gated by git's own authorization: a PAT over Basic auth, // then the effective agent role, existence privacy and the org-state // gate. GateGit MountGate = "git" // GatePrincipal is behind the principal middleware, as the generated // surface is. GatePrincipal MountGate = "principal" )
const GateExtensionSecret MountGate = "extension-secret"
GateExtensionSecret is gated by the shared secret an extension's callback mount declares, and absent (404) while that is unset or the request came through a proxy.
type NotificationSettings ¶
type NotificationSettings struct {
// Email Which of the registry's mails the person receives.
Email EmailNotificationSettings `json:"email"`
// Web In-app alerts.
Web WebNotificationSettings `json:"web"`
}
NotificationSettings defines model for NotificationSettings.
type Option ¶
type Option func(*options)
Option adjusts how New assembles a server for its role.
func WithoutSigningKey ¶
func WithoutSigningKey() Option
WithoutSigningKey builds a server that holds no signing key: the api and git roles, which never sign. New neither loads the key nor registers it; the pipeline hands an approval's publish to the worker, the ruleset attestation and the key set are read from what the key holder stored, and anything that would still need a signature fails closed with scan.ErrNoSigningKey rather than publishing unsigned.
type Org ¶
type Org struct {
CreatedAt time.Time `json:"createdAt"`
// DecommissionAt While `state` is `decommissioning`: when the hold ends and the organization's agents, repositories, blobs and invitations are erased, its handle and domain released.
DecommissionAt *time.Time `json:"decommissionAt,omitempty"`
DisplayName string `json:"displayName"`
// Domain The domain the organization was created at (its creator's verified email domain), which routes people at that domain to its administrators. Absent when none was recorded.
Domain *string `json:"domain,omitempty"`
Handle string `json:"handle"`
Id openapi_types.UUID `json:"id"`
// LogoUrl Where the organization's logo is served, when it has one: a path on this registry, versioned by the logo's content so a replaced logo has a new URL. Absent when there is none.
LogoUrl *string `json:"logoUrl,omitempty"`
// Seats Present for the organization's members only.
Seats *Seats `json:"seats,omitempty"`
// SsoRequired Present for org admins only.
SsoRequired *bool `json:"ssoRequired,omitempty"`
// State Where the organization is in its life. `active` is the ordinary state. `suspended` (platform staff) makes the organization and everything under it answer as absent — 404 to every caller, git included — until it is reinstated. `decommissioning` is the read-only hold an admin, platform staff or the hosted product's pending-payment sweep started: members still read every agent and export the audit log, nothing under the organization can be changed, pushed or submitted (409 org-decommissioning), and at `decommissionAt` the erasure runs; staff may reinstate it before then. `decommissioned` is the row after the erasure; its handle is released, so no path names it.
State *OrgState `json:"state,omitempty"`
// VerifiedDomain The first domain the organization verified over DNS. Kept for older clients; `verifiedDomains` carries them all.
VerifiedDomain *string `json:"verifiedDomain,omitempty"`
// VerifiedDomains Every domain the organization proved control of over DNS, oldest first.
VerifiedDomains *[]string `json:"verifiedDomains,omitempty"`
}
Org defines model for Org.
type OrgRole ¶
type OrgRole string
OrgRole An organization role, ordered admin > security_reviewer | member. Admins manage the organization, its members, settings and sign-in policy, and hold the security reviewer's powers; security_reviewer is a platform-internal role that exists only inside a first-party organization; there is no owner role, only admins. An organization always keeps one admin: demoting or removing the last one is 409 last-admin.
type OrgRoleAssignment ¶
type OrgRoleAssignment string
OrgRoleAssignment The role a PUT assigns. security_reviewer is refused outside a first-party organization. `owner` is accepted by the schema but refused with a 422 that names the roles that exist.
const ( OrgRoleAssignmentAdmin OrgRoleAssignment = "admin" OrgRoleAssignmentMember OrgRoleAssignment = "member" OrgRoleAssignmentOwner OrgRoleAssignment = "owner" OrgRoleAssignmentSecurityReviewer OrgRoleAssignment = "security_reviewer" )
Defines values for OrgRoleAssignment.
func (OrgRoleAssignment) Valid ¶
func (e OrgRoleAssignment) Valid() bool
Valid indicates whether the value is a known member of the OrgRoleAssignment enum.
type OrgState ¶
type OrgState string
OrgState Where the organization is in its life. `active` is the ordinary state. `suspended` (platform staff) makes the organization and everything under it answer as absent — 404 to every caller, git included — until it is reinstated. `decommissioning` is the read-only hold an admin, platform staff or the hosted product's pending-payment sweep started: members still read every agent and export the audit log, nothing under the organization can be changed, pushed or submitted (409 org-decommissioning), and at `decommissionAt` the erasure runs; staff may reinstate it before then. `decommissioned` is the row after the erasure; its handle is released, so no path names it.
type Pat ¶
type Pat struct {
CreatedAt time.Time `json:"createdAt"`
ExpiresAt time.Time `json:"expiresAt"`
Id openapi_types.UUID `json:"id"`
LastUsedAt *time.Time `json:"lastUsedAt,omitempty"`
Name string `json:"name"`
// OrgHandle Set when org-bound (enforced SSO).
OrgHandle *string `json:"orgHandle,omitempty"`
// Prefix First 12 characters, for display and lookup.
Prefix string `json:"prefix"`
Scopes []ScopeGranted `json:"scopes"`
}
Pat defines model for Pat.
type PatCreated ¶
type PatCreated struct {
CreatedAt time.Time `json:"createdAt"`
ExpiresAt time.Time `json:"expiresAt"`
Id openapi_types.UUID `json:"id"`
LastUsedAt *time.Time `json:"lastUsedAt,omitempty"`
Name string `json:"name"`
// OrgHandle Set when org-bound (enforced SSO).
OrgHandle *string `json:"orgHandle,omitempty"`
// Prefix First 12 characters, for display and lookup.
Prefix string `json:"prefix"`
Scopes []ScopeGranted `json:"scopes"`
// Token The full secret. Shown exactly once.
Token string `json:"token"`
}
PatCreated defines model for PatCreated.
type PendingOrg ¶
type PendingOrg struct {
DisplayName string `json:"displayName"`
Handle string `json:"handle"`
// Via The door — `domain` (their verified address is at the organization's domain) or `scim` (the organization's identity provider provisioned them).
Via PendingOrgVia `json:"via"`
}
PendingOrg The organization the caller is waiting to be approved by (present on GET /user only, and only while a pending membership exists): the domain folded them in at a sign-in, or the organization's IdP provisioned them. Every page and client can say it until an admin approves or declines them; until then they keep working on their own tier.
type PendingOrgVia ¶
type PendingOrgVia string
PendingOrgVia The door — `domain` (their verified address is at the organization's domain) or `scim` (the organization's identity provider provisioned them).
const ( PendingOrgViaDomain PendingOrgVia = "domain" PendingOrgViaScim PendingOrgVia = "scim" )
Defines values for PendingOrgVia.
func (PendingOrgVia) Valid ¶
func (e PendingOrgVia) Valid() bool
Valid indicates whether the value is a known member of the PendingOrgVia enum.
type PlatformAgentActionJSONBody ¶
type PlatformAgentActionJSONBody struct {
Reason string `json:"reason"`
}
PlatformAgentActionJSONBody defines parameters for PlatformAgentAction.
type PlatformAgentActionJSONRequestBody ¶
type PlatformAgentActionJSONRequestBody PlatformAgentActionJSONBody
PlatformAgentActionJSONRequestBody defines body for PlatformAgentAction for application/json ContentType.
type PlatformAgentActionParamsAction ¶
type PlatformAgentActionParamsAction string
PlatformAgentActionParamsAction defines parameters for PlatformAgentAction.
const ( Block PlatformAgentActionParamsAction = "block" Quarantine PlatformAgentActionParamsAction = "quarantine" Reinstate PlatformAgentActionParamsAction = "reinstate" )
Defines values for PlatformAgentActionParamsAction.
func (PlatformAgentActionParamsAction) Valid ¶
func (e PlatformAgentActionParamsAction) Valid() bool
Valid indicates whether the value is a known member of the PlatformAgentActionParamsAction enum.
type PlatformReinstateAccepted ¶
type PlatformReinstateAccepted struct {
// Queued How many blocked or quarantined versions have a scan queued.
Queued int `json:"queued"`
}
PlatformReinstateAccepted defines model for PlatformReinstateAccepted.
type Problem ¶
type Problem struct {
Detail *string `json:"detail,omitempty"`
// Errors Field-level validation errors when applicable.
Errors *[]struct {
Field string `json:"field"`
Message string `json:"message"`
} `json:"errors,omitempty"`
Instance *string `json:"instance,omitempty"`
Status int `json:"status"`
Title string `json:"title"`
// Type Stable problem type URI.
//
// Example: https://agentry.dev/problems/validation
Type string `json:"type"`
}
Problem RFC 9457 problem details.
type ProvisionedMember ¶
ProvisionedMember is a person an organization's identity provider provisioned, as a directory extension names them to the core: the address they are known at, the name the provider calls them by (a seed for a new account's handle) and a display name.
type PublicUser ¶
PublicUser defines model for PublicUser.
type PutAccountInstallJSONRequestBody ¶
type PutAccountInstallJSONRequestBody = AccountInstallRequest
PutAccountInstallJSONRequestBody defines body for PutAccountInstall for application/json ContentType.
type PutOrgLogoMultipartBody ¶
type PutOrgLogoMultipartBody struct {
File openapi_types.File `json:"file"`
}
PutOrgLogoMultipartBody defines parameters for PutOrgLogo.
type PutOrgLogoMultipartRequestBody ¶
type PutOrgLogoMultipartRequestBody PutOrgLogoMultipartBody
PutOrgLogoMultipartRequestBody defines body for PutOrgLogo for multipart/form-data ContentType.
type PutUserReportLogoMultipartBody ¶
type PutUserReportLogoMultipartBody struct {
File openapi_types.File `json:"file"`
}
PutUserReportLogoMultipartBody defines parameters for PutUserReportLogo.
type PutUserReportLogoMultipartRequestBody ¶
type PutUserReportLogoMultipartRequestBody PutUserReportLogoMultipartBody
PutUserReportLogoMultipartRequestBody defines body for PutUserReportLogo for multipart/form-data ContentType.
type PutVoiceJSONRequestBody ¶
type PutVoiceJSONRequestBody = PutVoiceRequest
PutVoiceJSONRequestBody defines body for PutVoice for application/json ContentType.
type PutVoiceRequest ¶
type PutVoiceRequest struct {
Source PutVoiceRequestSource `json:"source"`
// Text The VOICE.md, UTF-8, at most 32 KiB.
Text string `json:"text"`
}
PutVoiceRequest defines model for PutVoiceRequest.
type PutVoiceRequestSource ¶
type PutVoiceRequestSource string
PutVoiceRequestSource defines model for PutVoiceRequest.Source.
const ( PutVoiceRequestSourceEdit PutVoiceRequestSource = "edit" PutVoiceRequestSourceUpload PutVoiceRequestSource = "upload" )
Defines values for PutVoiceRequestSource.
func (PutVoiceRequestSource) Valid ¶
func (e PutVoiceRequestSource) Valid() bool
Valid indicates whether the value is a known member of the PutVoiceRequestSource enum.
type RedTeamReport ¶
type RedTeamReport struct {
BundleDigest string `json:"bundleDigest"`
// Cases Fixtures × applicable mutators.
Cases int `json:"cases"`
CreatedAt time.Time `json:"createdAt"`
// Evaded Cases where at least one expected rule stopped firing.
Evaded int `json:"evaded"`
// Fixtures Attack fixtures with S3/S4 expectations that fired unmutated.
Fixtures int `json:"fixtures"`
Id openapi_types.UUID `json:"id"`
// Report The full report (byMutator tallies and every evasion).
Report map[string]interface{} `json:"report"`
RulesetSemver string `json:"rulesetSemver"`
}
RedTeamReport One run of the red-team job.
type ReportAbuseJSONBody ¶
type ReportAbuseJSONBody struct {
Category ReportAbuseJSONBodyCategory `json:"category"`
Detail string `json:"detail"`
Version *string `json:"version,omitempty"`
}
ReportAbuseJSONBody defines parameters for ReportAbuse.
type ReportAbuseJSONBodyCategory ¶
type ReportAbuseJSONBodyCategory string
ReportAbuseJSONBodyCategory defines parameters for ReportAbuse.
const ( CredentialTheft ReportAbuseJSONBodyCategory = "credential_theft" HiddenInstructions ReportAbuseJSONBodyCategory = "hidden_instructions" License ReportAbuseJSONBodyCategory = "license" MaliciousContent ReportAbuseJSONBodyCategory = "malicious_content" Other ReportAbuseJSONBodyCategory = "other" Spam ReportAbuseJSONBodyCategory = "spam" Typosquat ReportAbuseJSONBodyCategory = "typosquat" )
Defines values for ReportAbuseJSONBodyCategory.
func (ReportAbuseJSONBodyCategory) Valid ¶
func (e ReportAbuseJSONBodyCategory) Valid() bool
Valid indicates whether the value is a known member of the ReportAbuseJSONBodyCategory enum.
type ReportAbuseJSONRequestBody ¶
type ReportAbuseJSONRequestBody ReportAbuseJSONBody
ReportAbuseJSONRequestBody defines body for ReportAbuse for application/json ContentType.
type ReportDesign ¶
type ReportDesign struct {
// Accent The one colour, lower-case hex.
Accent string `json:"accent"`
// AgentryTheme The document version, always 2.
AgentryTheme ReportDesignAgentryTheme `json:"agentryTheme"`
// BasedOn The built-in theme the design started from.
BasedOn ReportDesignBasedOn `json:"basedOn"`
Fonts struct {
Body ReportDesignFontsBody `json:"body"`
Code ReportDesignFontsCode `json:"code"`
Headings ReportDesignFontsHeadings `json:"headings"`
} `json:"fonts"`
PageNumbers ReportDesignFooterPageNumbers `json:"pageNumbers"`
// Text One line, set as text, never evaluated; empty for none.
Text string `json:"text"`
} `json:"footer"`
Headings ReportDesignHeadings `json:"headings"`
// Logo The person's logo, drawn only in the title block; absent for none. Answered only when asked for (`include=logo`).
Logo *struct {
// Png A PNG in standard base64, at most 512 KB and 1024 pixels each way, as the core encoded it from the person's upload.
Png string `json:"png"`
} `json:"logo,omitempty"`
// Name The design's label, a built-in's own name or the person's.
Name string `json:"name"`
// Paper A4, or US Letter.
Paper ReportDesignPaper `json:"paper"`
Quotes ReportDesignQuotes `json:"quotes"`
Tables struct {
Banded bool `json:"banded"`
Tinted bool `json:"tinted"`
} `json:"tables"`
TitleBlock ReportDesignTitleBlock `json:"titleBlock"`
// Version The design's revision.
Version int `json:"version"`
}
ReportDesign A report design, the theme document version 2. Defined by the core's pkg/reportdesign, whose JSON Schema this mirrors (a core test holds them equal). Beyond what the schema says, the accent must reach 4.5:1 contrast on white when it touches text (titleBlock `band`, headings `smallcaps` or `numbered`) and 3:1 otherwise, and `name` and `footer.text` are one line with no control, line-break, bidirectional formatting or other invisible format characters. The tint is derived: 12% of the accent over white. The five built-in themes are each a value of it. `logo` is optional and not counted in the 16 KB; `"logo": null` is read as no logo.
type ReportDesignAgentryTheme ¶
type ReportDesignAgentryTheme int
ReportDesignAgentryTheme The document version, always 2.
const (
ReportDesignVersion2 ReportDesignAgentryTheme = 2
)
Defines values for ReportDesignAgentryTheme.
func (ReportDesignAgentryTheme) Valid ¶
func (e ReportDesignAgentryTheme) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignAgentryTheme enum.
type ReportDesignBasedOn ¶
type ReportDesignBasedOn string
ReportDesignBasedOn The built-in theme the design started from.
const ( ReportDesignBasedOnClassic ReportDesignBasedOn = "classic" ReportDesignBasedOnEditorial ReportDesignBasedOn = "editorial" ReportDesignBasedOnModern ReportDesignBasedOn = "modern" ReportDesignBasedOnPlain ReportDesignBasedOn = "plain" ReportDesignBasedOnTechnical ReportDesignBasedOn = "technical" )
Defines values for ReportDesignBasedOn.
func (ReportDesignBasedOn) Valid ¶
func (e ReportDesignBasedOn) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignBasedOn enum.
type ReportDesignFontsBody ¶
type ReportDesignFontsBody string
ReportDesignFontsBody defines model for ReportDesign.Fonts.Body.
const ( ReportDesignFontsBodyEBGaramond ReportDesignFontsBody = "EB Garamond" ReportDesignFontsBodyIBMPlexSans ReportDesignFontsBody = "IBM Plex Sans" ReportDesignFontsBodyIBMPlexSerif ReportDesignFontsBody = "IBM Plex Serif" ReportDesignFontsBodyInter ReportDesignFontsBody = "Inter" ReportDesignFontsBodyLora ReportDesignFontsBody = "Lora" ReportDesignFontsBodyMerriweather ReportDesignFontsBody = "Merriweather" ReportDesignFontsBodySourceSans3 ReportDesignFontsBody = "Source Sans 3" ReportDesignFontsBodySourceSerif4 ReportDesignFontsBody = "Source Serif 4" ReportDesignFontsBodyWorkSans ReportDesignFontsBody = "Work Sans" )
Defines values for ReportDesignFontsBody.
func (ReportDesignFontsBody) Valid ¶
func (e ReportDesignFontsBody) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignFontsBody enum.
type ReportDesignFontsCode ¶
type ReportDesignFontsCode string
ReportDesignFontsCode defines model for ReportDesign.Fonts.Code.
const ( ReportDesignFontsCodeIBMPlexMono ReportDesignFontsCode = "IBM Plex Mono" ReportDesignFontsCodeJetBrainsMono ReportDesignFontsCode = "JetBrains Mono" ReportDesignFontsCodeSourceCodePro ReportDesignFontsCode = "Source Code Pro" )
Defines values for ReportDesignFontsCode.
func (ReportDesignFontsCode) Valid ¶
func (e ReportDesignFontsCode) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignFontsCode enum.
type ReportDesignFontsHeadings ¶
type ReportDesignFontsHeadings string
ReportDesignFontsHeadings defines model for ReportDesign.Fonts.Headings.
const ( ReportDesignFontsHeadingsEBGaramond ReportDesignFontsHeadings = "EB Garamond" ReportDesignFontsHeadingsIBMPlexMono ReportDesignFontsHeadings = "IBM Plex Mono" ReportDesignFontsHeadingsIBMPlexSans ReportDesignFontsHeadings = "IBM Plex Sans" ReportDesignFontsHeadingsIBMPlexSerif ReportDesignFontsHeadings = "IBM Plex Serif" ReportDesignFontsHeadingsInter ReportDesignFontsHeadings = "Inter" ReportDesignFontsHeadingsJetBrainsMono ReportDesignFontsHeadings = "JetBrains Mono" ReportDesignFontsHeadingsLora ReportDesignFontsHeadings = "Lora" ReportDesignFontsHeadingsMerriweather ReportDesignFontsHeadings = "Merriweather" ReportDesignFontsHeadingsMontserrat ReportDesignFontsHeadings = "Montserrat" ReportDesignFontsHeadingsPlayfairDisplay ReportDesignFontsHeadings = "Playfair Display" ReportDesignFontsHeadingsSourceCodePro ReportDesignFontsHeadings = "Source Code Pro" ReportDesignFontsHeadingsSourceSans3 ReportDesignFontsHeadings = "Source Sans 3" ReportDesignFontsHeadingsSourceSerif4 ReportDesignFontsHeadings = "Source Serif 4" ReportDesignFontsHeadingsWorkSans ReportDesignFontsHeadings = "Work Sans" )
Defines values for ReportDesignFontsHeadings.
func (ReportDesignFontsHeadings) Valid ¶
func (e ReportDesignFontsHeadings) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignFontsHeadings enum.
type ReportDesignFooterPageNumbers ¶
type ReportDesignFooterPageNumbers string
ReportDesignFooterPageNumbers defines model for ReportDesign.Footer.PageNumbers.
const ( )
Defines values for ReportDesignFooterPageNumbers.
func (ReportDesignFooterPageNumbers) Valid ¶
func (e ReportDesignFooterPageNumbers) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignFooterPageNumbers enum.
type ReportDesignHeadings ¶
type ReportDesignHeadings string
ReportDesignHeadings defines model for ReportDesign.Headings.
const ( ReportDesignHeadingsBar ReportDesignHeadings = "bar" ReportDesignHeadingsNumbered ReportDesignHeadings = "numbered" ReportDesignHeadingsPlain ReportDesignHeadings = "plain" ReportDesignHeadingsRule ReportDesignHeadings = "rule" ReportDesignHeadingsSmallcaps ReportDesignHeadings = "smallcaps" )
Defines values for ReportDesignHeadings.
func (ReportDesignHeadings) Valid ¶
func (e ReportDesignHeadings) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignHeadings enum.
type ReportDesignPaper ¶
type ReportDesignPaper string
ReportDesignPaper A4, or US Letter.
const ( A4 ReportDesignPaper = "a4" Letter ReportDesignPaper = "letter" )
Defines values for ReportDesignPaper.
func (ReportDesignPaper) Valid ¶
func (e ReportDesignPaper) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignPaper enum.
type ReportDesignQuotes ¶
type ReportDesignQuotes string
ReportDesignQuotes defines model for ReportDesign.Quotes.
const ( ReportDesignQuotesCallout ReportDesignQuotes = "callout" ReportDesignQuotesPlain ReportDesignQuotes = "plain" )
Defines values for ReportDesignQuotes.
func (ReportDesignQuotes) Valid ¶
func (e ReportDesignQuotes) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignQuotes enum.
type ReportDesignTitleBlock ¶
type ReportDesignTitleBlock string
ReportDesignTitleBlock defines model for ReportDesign.TitleBlock.
const ( ReportDesignTitleBlockBand ReportDesignTitleBlock = "band" ReportDesignTitleBlockBar ReportDesignTitleBlock = "bar" ReportDesignTitleBlockNone ReportDesignTitleBlock = "none" ReportDesignTitleBlockRuled ReportDesignTitleBlock = "ruled" )
Defines values for ReportDesignTitleBlock.
func (ReportDesignTitleBlock) Valid ¶
func (e ReportDesignTitleBlock) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignTitleBlock enum.
type ReportSettings ¶
type ReportSettings struct {
// Design A report design, the theme document version 2. Defined by the core's pkg/reportdesign, whose JSON Schema this mirrors (a core test holds them equal). Beyond what the schema says, the accent must reach 4.5:1 contrast on white when it touches text (titleBlock `band`, headings `smallcaps` or `numbered`) and 3:1 otherwise, and `name` and `footer.text` are one line with no control, line-break, bidirectional formatting or other invisible format characters. The tint is derived: 12% of the accent over white. The five built-in themes are each a value of it. `logo` is optional and not counted in the 16 KB; `"logo": null` is read as no logo.
Design *ReportDesign `json:"design,omitempty"`
}
ReportSettings The caller's report settings, a profile setting. No `design` means the person never chose one.
type ReportSettingsInclude ¶
type ReportSettingsInclude string
ReportSettingsInclude What a report settings answer carries beyond the design.
const (
ReportSettingsIncludeLogo ReportSettingsInclude = "logo"
)
Defines values for ReportSettingsInclude.
func (ReportSettingsInclude) Valid ¶
func (e ReportSettingsInclude) Valid() bool
Valid indicates whether the value is a known member of the ReportSettingsInclude enum.
type ReportVerdict ¶
type ReportVerdict string
ReportVerdict What a report is: `scanned` when a scan run stands behind it (the findings say the rest), `unscanned` when the version was admitted without one — never conflated with "scanned with a known gap". Absent while a scan is still pending.
const ( Scanned ReportVerdict = "scanned" Unscanned ReportVerdict = "unscanned" )
Defines values for ReportVerdict.
func (ReportVerdict) Valid ¶
func (e ReportVerdict) Valid() bool
Valid indicates whether the value is a known member of the ReportVerdict enum.
type RequiredHeaderError ¶
func (*RequiredHeaderError) Error ¶
func (e *RequiredHeaderError) Error() string
func (*RequiredHeaderError) Unwrap ¶
func (e *RequiredHeaderError) Unwrap() error
type RequiredParamError ¶
type RequiredParamError struct {
ParamName string
}
func (*RequiredParamError) Error ¶
func (e *RequiredParamError) Error() string
type RescanInFlight ¶
type RescanInFlight struct {
ScanRunId openapi_types.UUID `json:"scanRunId"`
StartedAt time.Time `json:"startedAt"`
}
RescanInFlight A later scan of this version still running (a ruleset or MCP rescan sweep, a manual rescan) while the report describes the latest run that finished. Present only when such a run exists: the verdict a release was published on stands until the rescan finishes, and the report says one is under way rather than going blank.
type ResolveRefParams ¶
type ResolveRefParams struct {
// Ref ns/name, ns/name@^1.2, ns/name@1.2.3, or ns/name@beta.
Ref string `form:"ref" json:"ref"`
Channel *ResolveRefParamsChannel `form:"channel,omitempty" json:"channel,omitempty"`
}
ResolveRefParams defines parameters for ResolveRef.
type ResolveRefParamsChannel ¶
type ResolveRefParamsChannel string
ResolveRefParamsChannel defines parameters for ResolveRef.
const ( ResolveRefParamsChannelBeta ResolveRefParamsChannel = "beta" ResolveRefParamsChannelStable ResolveRefParamsChannel = "stable" )
Defines values for ResolveRefParamsChannel.
func (ResolveRefParamsChannel) Valid ¶
func (e ResolveRefParamsChannel) Valid() bool
Valid indicates whether the value is a known member of the ResolveRefParamsChannel enum.
type ResolveResult ¶
type ResolveResult struct {
// ArchiveUrl Where to fetch the archive (CDN on SaaS; API path self-host).
ArchiveUrl string `json:"archiveUrl"`
// AttestationUrl Where to fetch the DSSE attestation over this release. Present whenever the version has been signed: every version published by a signing-enabled deployment. Absent when the deployment runs `signing.kind: none` (dev/self-host opt-out) or the version predates signing.
AttestationUrl *string `json:"attestationUrl,omitempty"`
Digest string `json:"digest"`
Manifest map[string]interface{} `json:"manifest"`
Name string `json:"name"`
Namespace string `json:"namespace"`
// ScanStatus How the resolved version was admitted: `skipped` is a version published without a scan — no attestation exists for it, which is not the same as an unsigned registry — and a client installs or runs it only with the person's consent.
ScanStatus *ResolveResultScanStatus `json:"scanStatus,omitempty"`
Version string `json:"version"`
// Yanked True only for exact pins of yanked versions.
Yanked bool `json:"yanked"`
}
ResolveResult defines model for ResolveResult.
type ResolveResultScanStatus ¶
type ResolveResultScanStatus string
ResolveResultScanStatus How the resolved version was admitted: `skipped` is a version published without a scan — no attestation exists for it, which is not the same as an unsigned registry — and a client installs or runs it only with the person's consent.
const ( ResolveResultScanStatusPipeline ResolveResultScanStatus = "pipeline" ResolveResultScanStatusSkipped ResolveResultScanStatus = "skipped" )
Defines values for ResolveResultScanStatus.
func (ResolveResultScanStatus) Valid ¶
func (e ResolveResultScanStatus) Valid() bool
Valid indicates whether the value is a known member of the ResolveResultScanStatus enum.
type ReviewBundle ¶
type ReviewBundle struct {
Findings []ScanFinding `json:"findings"`
Item ReviewItem `json:"item"`
// Manifest The submitted manifest (canonical JSON form).
Manifest *map[string]interface{} `json:"manifest,omitempty"`
Previous *AgentVersion `json:"previous,omitempty"`
Report *ScanReport `json:"report,omitempty"`
VersionDetail *AgentVersion `json:"versionDetail,omitempty"`
}
ReviewBundle defines model for ReviewBundle.
type ReviewFileContent ¶
type ReviewFileContent struct {
Binary bool `json:"binary"`
// Content UTF-8 text content; absent for binary files. Rendered by clients with invisible-character escaping.
Content *string `json:"content,omitempty"`
Path string `json:"path"`
Size int64 `json:"size"`
Truncated bool `json:"truncated"`
}
ReviewFileContent defines model for ReviewFileContent.
type ReviewFileEntry ¶
ReviewFileEntry defines model for ReviewFileEntry.
type ReviewFileList ¶
type ReviewFileList struct {
Files []ReviewFileEntry `json:"files"`
}
ReviewFileList defines model for ReviewFileList.
type ReviewItem ¶
type ReviewItem struct {
Agent string `json:"agent"`
CreatedAt *time.Time `json:"createdAt,omitempty"`
Id openapi_types.UUID `json:"id"`
Namespace string `json:"namespace"`
Queue ReviewItemQueue `json:"queue"`
// State Where the item stands. `superseded`: no person decided; the version was published by the gate when a new ruleset judged the review queue again and it passed. The set grows by addition, so it is declared extensible: a client keeps a state it does not know as the string it is rather than failing on it.
State string `json:"state"`
Version string `json:"version"`
// VersionStatus Publication state machine states. `approved` is reserved and never produced: a reviewer's approval publishes directly (needs_review → published), so clients will not observe it; it is kept because removing an enum value is a breaking change.
VersionStatus *VersionStatus `json:"versionStatus,omitempty"`
}
ReviewItem defines model for ReviewItem.
type ReviewItemQueue ¶
type ReviewItemQueue string
ReviewItemQueue defines model for ReviewItem.Queue.
const ( ReviewItemQueueOrg ReviewItemQueue = "org" ReviewItemQueuePlatform ReviewItemQueue = "platform" )
Defines values for ReviewItemQueue.
func (ReviewItemQueue) Valid ¶
func (e ReviewItemQueue) Valid() bool
Valid indicates whether the value is a known member of the ReviewItemQueue enum.
type RouteDecl ¶
type RouteDecl struct {
// Action is the chokepoint action the handler enforces via authorize().
Action auth.Action
// OrgScoped routes resolve {org} and check the caller's role there.
OrgScoped bool
// Anonymous routes are readable without credentials.
Anonymous bool
// SessionOnly routes reject PATs regardless of scope (token minting,
// logout) — enforced by the action's absence from auth scope map.
SessionOnly bool
// NoAuthz marks routes outside the chokepoint: credential-establishing
// endpoints (sign-in, address confirmation) that are rate-limited
// instead.
NoAuthz bool
// AgentScoped routes resolve {ns}/{name} and check the caller's
// effective agent role via auth.CheckAgent.
AgentScoped bool
// HiddenFromOutsiders org-scoped routes answer a signed-in caller who is
// not an active member of the organization 404 rather than 403, so they
// say nothing of what the organization keeps (an organization's shared
// knowledge). The matrix expects that 404 as the denial.
HiddenFromOutsiders bool
// SelfAuthorized routes perform their own bespoke authorization inside
// the handler (platform-staff / org-reviewer / author checks that the
// generic chokepoint cannot express). The matrix test skips outcome
// prediction for these; the handlers' own tests cover them.
SelfAuthorized bool
}
RouteDecl declares the authorization contract of one API operation: every route declares (resource, action). The declaration table drives the authz matrix test; the completeness test fails CI when an OpenAPI operation lacks an entry, so a new route cannot ship undeclared.
func RouteAuthzDecl ¶
RouteAuthzDecl returns the declaration for an operationId (any casing).
type RulesetRelease ¶
type RulesetRelease struct {
BundleDigest string `json:"bundleDigest"`
Id openapi_types.UUID `json:"id"`
Notes *string `json:"notes,omitempty"`
PublishedAt time.Time `json:"publishedAt"`
Semver string `json:"semver"`
}
RulesetRelease defines model for RulesetRelease.
type ScanFinding ¶
type ScanFinding struct {
Confidence ScanFindingConfidence `json:"confidence"`
Detail *map[string]interface{} `json:"detail,omitempty"`
Excerpt *string `json:"excerpt,omitempty"`
FilePath *string `json:"filePath,omitempty"`
Id *openapi_types.UUID `json:"id,omitempty"`
LineEnd *int `json:"lineEnd,omitempty"`
LineStart *int `json:"lineStart,omitempty"`
Scanner string `json:"scanner"`
Severity ScanFindingSeverity `json:"severity"`
Title string `json:"title"`
Verdict ScanFindingVerdict `json:"verdict"`
// VerdictReason Why a reviewer dismissed or confirmed this finding. Dismissed findings stay on the public report WITH their rationale. A finding that vanishes without explanation is exactly what the report exists to prevent.
VerdictReason *string `json:"verdictReason,omitempty"`
}
ScanFinding defines model for ScanFinding.
type ScanFindingConfidence ¶
type ScanFindingConfidence string
ScanFindingConfidence defines model for ScanFinding.Confidence.
const ( ScanFindingConfidenceHigh ScanFindingConfidence = "high" ScanFindingConfidenceLow ScanFindingConfidence = "low" ScanFindingConfidenceMedium ScanFindingConfidence = "medium" )
Defines values for ScanFindingConfidence.
func (ScanFindingConfidence) Valid ¶
func (e ScanFindingConfidence) Valid() bool
Valid indicates whether the value is a known member of the ScanFindingConfidence enum.
type ScanFindingSeverity ¶
type ScanFindingSeverity string
ScanFindingSeverity defines model for ScanFinding.Severity.
const ( ScanFindingSeverityCritical ScanFindingSeverity = "critical" ScanFindingSeverityHigh ScanFindingSeverity = "high" ScanFindingSeverityInfo ScanFindingSeverity = "info" ScanFindingSeverityLow ScanFindingSeverity = "low" ScanFindingSeverityMedium ScanFindingSeverity = "medium" )
Defines values for ScanFindingSeverity.
func (ScanFindingSeverity) Valid ¶
func (e ScanFindingSeverity) Valid() bool
Valid indicates whether the value is a known member of the ScanFindingSeverity enum.
type ScanFindingVerdict ¶
type ScanFindingVerdict string
ScanFindingVerdict defines model for ScanFinding.Verdict.
const ( ScanFindingVerdictConfirmed ScanFindingVerdict = "confirmed" ScanFindingVerdictDismissedAcceptedRisk ScanFindingVerdict = "dismissed_accepted_risk" ScanFindingVerdictDismissedFalsePositive ScanFindingVerdict = "dismissed_false_positive" ScanFindingVerdictOpen ScanFindingVerdict = "open" )
Defines values for ScanFindingVerdict.
func (ScanFindingVerdict) Valid ¶
func (e ScanFindingVerdict) Valid() bool
Valid indicates whether the value is a known member of the ScanFindingVerdict enum.
type ScanModelInputJSONRequestBody ¶
type ScanModelInputJSONRequestBody = ModelInputScanRequest
ScanModelInputJSONRequestBody defines body for ScanModelInput for application/json ContentType.
type ScanReport ¶
type ScanReport struct {
FindingCounts *map[string]int `json:"findingCounts,omitempty"`
Findings []ScanFinding `json:"findings"`
// FinishedAt When this scan run completed: the date the report describes.
FinishedAt *time.Time `json:"finishedAt,omitempty"`
// JudgeModel The judge that adjudicated this run — the AI Review model — as the attestation records it: the model id when the provider has one (typesafe, openai, anthropic, bedrock), else the provider's name (static, none, classifier). Recorded per run for reproducibility beside the rubric hash.
JudgeModel *string `json:"judgeModel,omitempty"`
// JudgeUsage The token use the AI Review model's provider reported for this scan run — what the review cost, as measured. Present for platform staff only, and absent when the provider reported none (the static and classifier judges, an endpoint without a usage block); absent means unknown, not zero. Not part of the signed report.
JudgeUsage *JudgeUsage `json:"judgeUsage,omitempty"`
// Knowledge What the scan read of each knowledge pack the release ships (the manifest's `knowledge.ships`): every rule stage over every page and source, then AI Review over the pack's `sources/` and its `wiki/` in chunks no larger than the judge reads, or "AI Review not configured". The pack's findings are also the version's, in `findings`, under scanner `SK/…` with a file path in `knowledge/<name>/`; the release's own stages, AI Review included, do not read a shipped pack's tree. Absent for a release that ships no pack.
Knowledge *[]ShippedKnowledgeScan `json:"knowledge,omitempty"`
ReportDigest *string `json:"reportDigest,omitempty"`
// RescanInFlight A later scan of this version still running (a ruleset or MCP rescan sweep, a manual rescan) while the report describes the latest run that finished. Present only when such a run exists: the verdict a release was published on stands until the rescan finishes, and the report says one is under way rather than going blank.
RescanInFlight *RescanInFlight `json:"rescanInFlight,omitempty"`
RulesetVersion *string `json:"rulesetVersion,omitempty"`
ScanRunId *openapi_types.UUID `json:"scanRunId,omitempty"`
// ScanStatus The scan run's status; `skipped` for a version admitted without a scan, which has no run.
ScanStatus *string `json:"scanStatus,omitempty"`
// Verdict What a report is: `scanned` when a scan run stands behind it (the findings say the rest), `unscanned` when the version was admitted without one — never conflated with "scanned with a known gap". Absent while a scan is still pending.
Verdict *ReportVerdict `json:"verdict,omitempty"`
// VersionStatus Publication state machine states. `approved` is reserved and never produced: a reviewer's approval publishes directly (needs_review → published), so clients will not observe it; it is kept because removing an enum value is a breaking change.
VersionStatus VersionStatus `json:"versionStatus"`
}
ScanReport defines model for ScanReport.
type Scope ¶
type Scope string
Scope PAT scopes. A token can do only what its scopes allow; a session acts with the account's full authority. `run:write` lets a token start, feed and cancel a hosted run of a QuickAgent and `run:read` lets it read a run, its log and its artefacts — both are consumed only by a registry that mounts the runs extension, and unlock nothing on one that does not. `agent:manage` takes the owner actions on a QuickAgent the caller administers (make it public or private, retire, restore, delete), which `org:admin` also covers, and reaches none of its other settings. `knowledge:read` and `knowledge:write` read and write the account's knowledge packs. `secret:write` sets and deletes the account's hosted-run secrets and never lists or reads one; it is consumed only by a registry that mounts the vault extension. `voice:read` reads the account's Writing Voice and `voice:write` puts, restores, sets and deletes it.
const ( AgentManage Scope = "agent:manage" AgentPublish Scope = "agent:publish" AgentRead Scope = "agent:read" AuditRead Scope = "audit:read" KnowledgeRead Scope = "knowledge:read" KnowledgeWrite Scope = "knowledge:write" OrgAdmin Scope = "org:admin" RepoRead Scope = "repo:read" RepoWrite Scope = "repo:write" ReviewAct Scope = "review:act" RunRead Scope = "run:read" RunWrite Scope = "run:write" SecretWrite Scope = "secret:write" UserProfile Scope = "user:profile" VoiceRead Scope = "voice:read" VoiceWrite Scope = "voice:write" )
Defines values for Scope.
type ScopeGranted ¶
type ScopeGranted = string
ScopeGranted A scope as it appears on a token the registry reports back (the token list, a newly minted token, the desktop exchange). The set is the one `Scope` accepts and grows by addition, so it is declared extensible: a client keeps a value it does not know as the string it is rather than failing on it.
type SearchAgentsParams ¶
type SearchAgentsParams struct {
// Q Free-text query; empty lists by popularity.
Q *string `form:"q,omitempty" json:"q,omitempty"`
// Mode Only agents that support this run mode.
Mode *AgentMode `form:"mode,omitempty" json:"mode,omitempty"`
// Capability Capability the latest published version actually asks for, e.g. `network`, `filesystem`, `exec`, `secrets`, `dataAccess`, or `targetHosts` (a machine the person names when the run starts), or `browser` (a headless browser for the sites the person names). A capability declared as `none`, null, or empty does not match: `network: {egress: none}` is not a network agent.
Capability *string `form:"capability,omitempty" json:"capability,omitempty"`
// License SPDX identifier from the latest published manifest.
License *string `form:"license,omitempty" json:"license,omitempty"`
// Verified Only agents in an org namespace with a verified domain.
Verified *bool `form:"verified,omitempty" json:"verified,omitempty"`
Sort *SearchAgentsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`
Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
Offset *int `form:"offset,omitempty" json:"offset,omitempty"`
}
SearchAgentsParams defines parameters for SearchAgents.
type SearchAgentsParamsSort ¶
type SearchAgentsParamsSort string
SearchAgentsParamsSort defines parameters for SearchAgents.
const ( SearchAgentsParamsSortInstalls SearchAgentsParamsSort = "installs" SearchAgentsParamsSortNewest SearchAgentsParamsSort = "newest" SearchAgentsParamsSortRelevance SearchAgentsParamsSort = "relevance" )
Defines values for SearchAgentsParamsSort.
func (SearchAgentsParamsSort) Valid ¶
func (e SearchAgentsParamsSort) Valid() bool
Valid indicates whether the value is a known member of the SearchAgentsParamsSort enum.
type SearchHit ¶
type SearchHit struct {
// Builtin Whether this is a built-in agent (see `Agent.builtin`): a client labels it Built-in in place of its run modes.
Builtin bool `json:"builtin"`
Installs30d *int `json:"installs30d,omitempty"`
// LogoUrl The publishing organization's logo, when the namespace is an organization with one — beside the publisher's name, never in place of the verdict. Absent for a person's namespace and for an organization without one.
LogoUrl *string `json:"logoUrl,omitempty"`
// Modes The run modes a release supports; at least one.
Modes AgentModes `json:"modes"`
Name string `json:"name"`
Namespace string `json:"namespace"`
QuarantineState *SearchHitQuarantineState `json:"quarantineState,omitempty"`
Summary string `json:"summary"`
}
SearchHit defines model for SearchHit.
type SearchHitQuarantineState ¶
type SearchHitQuarantineState string
SearchHitQuarantineState defines model for SearchHit.QuarantineState.
const ( SearchHitQuarantineStateBlocked SearchHitQuarantineState = "blocked" SearchHitQuarantineStateNone SearchHitQuarantineState = "none" SearchHitQuarantineStateQuarantined SearchHitQuarantineState = "quarantined" )
Defines values for SearchHitQuarantineState.
func (SearchHitQuarantineState) Valid ¶
func (e SearchHitQuarantineState) Valid() bool
Valid indicates whether the value is a known member of the SearchHitQuarantineState enum.
type SearchModelInputJSONRequestBody ¶
type SearchModelInputJSONRequestBody = WebSearchRequest
SearchModelInputJSONRequestBody defines body for SearchModelInput for application/json ContentType.
type SearchResults ¶
type SearchResults struct {
// Facets Facet counts keyed by facet name then value.
Facets *map[string]map[string]int `json:"facets,omitempty"`
Results []SearchHit `json:"results"`
// Total The number of hits for this request's predicate (query, mode, capability, license, verified) before limit and offset — what "2 of 8 results" counts. Blocked and never-published agents are outside it, as they are outside the results.
Total *int `json:"total,omitempty"`
}
SearchResults defines model for SearchResults.
type Seats ¶
type Seats struct {
Invited int64 `json:"invited"`
Max int64 `json:"max"`
Pending int64 `json:"pending"`
Used int64 `json:"used"`
}
Seats What the organization holds against its seat allowance. A seat is every active membership plus every open invitation; pending people hold none. `max` is the allowance, 0 meaning unbounded — what a registry with no billing extension answers.
type ServeMux ¶
type ServeMux interface {
HandleFunc(pattern string, handler func(http.ResponseWriter, *http.Request))
http.Handler
}
ServeMux is an abstraction of http.ServeMux.
type Server ¶
type Server struct {
// contains filtered or unexported fields
}
Server implements the generated ServerInterface plus non-spec endpoints (health, well-known). It is assembled once per process by NewHandler.
func New ¶
New creates the API server. st may be nil in database-less dev mode; any handler that needs the store fails closed with 503 in that case.
func (*Server) AcceptInvitation ¶
AcceptInvitation implements POST /invitations/{token} (session only).
func (*Server) AccountErasers ¶
AccountErasers names the extensions whose erasers are registered, in the order they run.
func (*Server) AccountFacts ¶ added in v0.6.1000
func (s *Server) AccountFacts(ctx context.Context, actor *auth.Principal, userID uuid.UUID) (AccountFacts, error)
AccountFacts reads userID's account for the staff member actor, their own included. A token may read it, as staff's other reads allow.
func (*Server) ActivateOrg ¶
ActivateOrg marks an organization activated (pkg/extension.Deps.Orgs): the extension that owns its standing calls it when the subscription starts, and from then on the account that created the org may create another. Idempotent: an organization already activated, or unknown, is left alone and reported as false.
func (*Server) AddAccountEraser ¶
func (s *Server) AddAccountEraser(name string, fn AccountEraser)
AddAccountEraser registers an extension's eraser (pkg/extension. ErasesAccounts), called in registration order inside the transaction of every account erasure and data clear. A name registered twice panics: the counts are keyed by it.
func (*Server) AddEventHook ¶
AddEventHook registers a listener for every Event the core commits. Hooks run synchronously after the commit and after the webhook fan-out; a slow hook slows the request, so hooks should hand real work to a job.
func (*Server) AddSignInHook ¶
AddSignInHook registers a listener for every sign-in through an individual provider that the callback gives a session, called once the account is resolved and active and before the session is issued, so a cookie it sets rides the same response. The hook runs synchronously in the callback and cannot refuse the sign-in; a slow hook slows it. Each hook gets its own copy of the claims, so none changes what the core or another hook reads. A panic is recovered and logged.
func (*Server) AddSshKey ¶
func (s *Server) AddSshKey(w http.ResponseWriter, r *http.Request)
AddSshKey implements POST /user/ssh-keys (session-only).
func (*Server) AddTeamMember ¶
func (s *Server) AddTeamMember(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug, handle Handle)
AddTeamMember implements PUT /orgs/{org}/teams/{team}/members/{handle}.
func (*Server) AgentMaintainable ¶
func (s *Server) AgentMaintainable(ctx context.Context, p *auth.Principal, ns, name string) (registry.Agent, bool, error)
AgentMaintainable is the core's own maintain decision for an extension: agentForAction with the maintain action, the organization gate for a write included. Not found, not readable, readable but not maintainable and held by the gate are all false with no error, as a read's are in AgentReadable; anything else is a fault.
func (*Server) AgentPublishable ¶
func (s *Server) AgentPublishable(ctx context.Context, p *auth.Principal, ns, name string) (registry.Agent, bool, error)
AgentPublishable is the core's own publish decision for an extension, shaped as AgentMaintainable: agentForAction with the publish action (the publish role over the namespace or a grant, a PAT's agent:publish), the organization gate for a write included. Not found, not readable, readable but not publishable and held by the gate are all false with no error; anything else is a fault.
func (*Server) AgentReadable ¶
func (s *Server) AgentReadable(ctx context.Context, p *auth.Principal, ns, name string) (registry.Agent, bool, error)
AgentReadable is the core's read of an agent for pkg/extension.Deps.Agents: whether p may read the agent at ns/name exactly as the core's own routes decide it — the effective role over the namespace and the grants (auth.CheckAgent), a PAT's agent:read, the owning organization's state (suspended: absent; in its hold: readable) — with the agent when they may. An agent that does not exist and one p may not read are the same false, never an error: an extension gets no way to tell a private agent's existence the core's routes would not give.
func (*Server) ApproveOrgMember ¶
func (s *Server) ApproveOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
ApproveOrgMember implements POST /orgs/{org}/members/{handle}/approve (admin). This is where the seat check bites for the provisioning and fold-in doors: a person the IdP provisioned holds no seat until an admin says so.
func (*Server) BaseURL ¶
BaseURL is the deployment's public origin without a trailing slash, as the core's own links use it, for pkg/extension.Deps.
func (*Server) Blobs ¶
Blobs is the deployment's object store for pkg/extension.Deps: nil when the server was built without a database, the way ExtensionDeps' pool is.
func (*Server) CheckDraft ¶
func (s *Server) CheckDraft(w http.ResponseWriter, r *http.Request)
CheckDraft implements POST /model-input/check: AI Review of a finished draft's package, with the release rubric S5 asks and the draft question set, before the person submits it.
func (*Server) ClearCurrentUserData ¶
func (s *Server) ClearCurrentUserData(w http.ResponseWriter, r *http.Request)
ClearCurrentUserData implements POST /user/clear-data: the account's credentials, installs and settings go, the account stays. The scope is credentials and history only: QuickAgents, memberships, stars, the handle, the email, the sign-in account at the directory, the subscription and credits are untouched. The caller's own session survives, so the person sees the result.
func (*Server) ClearTrustedDevices ¶
func (s *Server) ClearTrustedDevices(w http.ResponseWriter, r *http.Request)
ClearTrustedDevices implements DELETE /user/trusted-devices: every live remembered browser of the caller's account is revoked, this one included, so each is asked for the second factor at its next sign-in (its cookie is the directory's, and finds no record behind it). Sessions and authenticators are untouched. Revoked rather than deleted: the rows keep what an investigator may need until the sweep removes them. One audit row carries the count; a clear that found nothing writes none, since nothing was revoked.
func (*Server) Close ¶
Close releases the resources the server owns outside the request path: the rate-limit bucket store's collector goroutine, and the metric exporters. Without it every server built in a process (tests especially) leaks a goroutine holding every bucket it ever created.
func (*Server) CoreEntitlements ¶
func (s *Server) CoreEntitlements() entitlements.Resolver
CoreEntitlements is the resolver built from configuration, whatever an extension later replaced it with: what an extension's resolver wraps.
func (*Server) CountTrustedDevices ¶
func (s *Server) CountTrustedDevices(w http.ResponseWriter, r *http.Request)
CountTrustedDevices implements GET /user/trusted-devices.
func (*Server) CreateAgent ¶
func (s *Server) CreateAgent(w http.ResponseWriter, r *http.Request)
CreateAgent implements POST /agents.
func (*Server) CreateAuditExport ¶
CreateAuditExport implements POST /orgs/{org}/audit/exports (admin+): it records an export job and enqueues it, returning 202 with the job id.
func (*Server) CreateDesktopGrant ¶
func (s *Server) CreateDesktopGrant(w http.ResponseWriter, r *http.Request)
CreateDesktopGrant implements POST /user/tokens/desktop-grant (session-only).
func (*Server) CreateDomainClaim ¶
CreateDomainClaim implements POST /orgs/{org}/domain-claims (admin+).
func (*Server) CreateInvitation ¶
CreateInvitation implements POST /orgs/{org}/invitations (admin). The seat is reserved here, not at accept: the wall is met by the admin who invites, so an invitee is never turned away at the door.
func (*Server) CreateKnowledgePack ¶
func (s *Server) CreateKnowledgePack(w http.ResponseWriter, r *http.Request)
CreateKnowledgePack implements POST /knowledge/packs.
func (*Server) CreateOrg ¶
func (s *Server) CreateOrg(w http.ResponseWriter, r *http.Request)
CreateOrg implements POST /orgs; the caller becomes its first admin. Four gates precede the handle rules. The account's email must be verified, because an organization is keyed on its creator's domain: the domain of that address is recorded as the organization's unless the body says `none` or the domain is one nobody owns (a public mail provider), and a domain already registered to an organization — at its creation, or verified over DNS — is 409 domain-claimed naming it. The account may be an active member of no other organization (one organization per person): the creator becomes the org's first admin, and that is a membership like any other. And the account may have at most one organization awaiting activation: on the hosted product an org is a paid thing that starts out awaiting payment, and the core refuses a second until the first is activated or gone, so nobody squats handles behind organizations that never pay. Where nothing will activate an org later — no admission extension, so no payment — it is activated as it is created, and the rule never bites (the core with no extension is unchanged).
func (*Server) CreateOrgKnowledgePack ¶
CreateOrgKnowledgePack implements POST /orgs/{org}/knowledge/packs.
func (*Server) CreateRulesetRelease ¶
func (s *Server) CreateRulesetRelease(w http.ResponseWriter, r *http.Request)
CreateRulesetRelease implements POST /platform/ruleset-releases.
func (*Server) CreateTeam ¶
CreateTeam implements POST /orgs/{org}/teams (admin+).
func (*Server) CreateToken ¶
func (s *Server) CreateToken(w http.ResponseWriter, r *http.Request)
CreateToken implements POST /user/tokens (session-only).
func (*Server) CreateWebhook ¶
CreateWebhook implements POST /orgs/{org}/webhooks (admin+).
func (*Server) DecideReviewItem ¶
func (s *Server) DecideReviewItem(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
DecideReviewItem implements POST /review-items/{id}/decision. An author cannot decide their own version (enforced here), unless they are platform staff: staff may decide any item, and a staff decision on their own version is marked in its audit event.
func (*Server) DeclineOrgMember ¶
func (s *Server) DeclineOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
DeclineOrgMember implements POST /orgs/{org}/members/{handle}/decline (admin): the pending membership is removed and no seat was ever taken. An active member is removed with DELETE, which the last-admin guard covers; a pending member can never be the last admin, since a pending admin holds nothing.
func (*Server) DecommissionOrg ¶
DecommissionOrg implements POST /orgs/{org}/decommission (admin, session only). The body repeats the handle: an organization goes on a decision, never on a slip.
func (*Server) DecommissionOrgByExtension ¶
func (s *Server) DecommissionOrgByExtension(ctx context.Context, orgID uuid.UUID, reason string) (bool, error)
DecommissionOrgByExtension is pkg/extension.Deps.Orgs.Decommission: the hosted product's pending-payment sweep ending an organization nobody paid for, through the same path an admin's request takes.
func (*Server) DeferTagArchives ¶
func (s *Server) DeferTagArchives()
DeferTagArchives makes a git-tag submission's archive write a worker's: the registry records the version and enqueues registry.store_tag_archive on the sandbox queue, and the worker, which holds the git volume and the object-store credential, rebuilds, checks and stores the archive. The git role calls it, because the chart gives the git pods no store credential; `all` holds the store and writes it itself.
func (*Server) DeleteAccountInstall ¶
func (s *Server) DeleteAccountInstall(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
DeleteAccountInstall implements DELETE /user/installs/{ns}/{name}: idempotent, like a star's removal, and audited as agent.uninstall only when a record went. The row is the caller's own, so no QuickAgent is resolved for read and the answer is 204 whether the name resolves, is readable, or neither — nothing about a QuickAgent is learned here, and a record whose QuickAgent the caller can no longer read (the bare ref on the list) is removable by that ref. The name is tried as a QuickAgent first, so a record on the QuickAgent that lives at the name today goes before one stored under it by a QuickAgent that has moved.
func (*Server) DeleteAgent ¶
func (s *Server) DeleteAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params DeleteAgentParams)
DeleteAgent implements DELETE /agents/{ns}/{name}, for the namespace's administrators (ActAgentManage: a token's agent:manage or org:admin).
The database forbids deleting agent_version rows outright — yanked hides, blocked disables, but the row and its digest survive so installed copies keep verifying. An agent with no version row at all is deleted outright, with its repository. One with version history is deleted as a tombstone (registry.Tombstone): its versions yanked, the row kept and hidden from every read by name, the name held. A submitted row still holds a foreign key to the agent, and a version in the pipeline or in review would be decided onto a deleted agent, so both wait for the verdict. Advisories, abuse reports and a quarantine or block are trust & safety records: they outlive the publisher's wish to remove the agent.
func (*Server) DeleteCurrentUser ¶
func (s *Server) DeleteCurrentUser(w http.ResponseWriter, r *http.Request, params DeleteCurrentUserParams)
DeleteCurrentUser implements DELETE /user.
func (*Server) DeleteKnowledgePack ¶
func (s *Server) DeleteKnowledgePack(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
DeleteKnowledgePack implements DELETE /knowledge/packs/{packId}.
func (*Server) DeleteOrgKnowledgePack ¶
func (s *Server) DeleteOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packID openapi_types.UUID)
DeleteOrgKnowledgePack implements DELETE /orgs/{org}/knowledge/packs/{packId}.
func (*Server) DeleteOrgLogo ¶
DeleteOrgLogo implements DELETE /orgs/{org}/logo.
func (*Server) DeleteTeam ¶
DeleteTeam implements DELETE /orgs/{org}/teams/{team} (admin+).
func (*Server) DeleteUserReportLogo ¶
func (s *Server) DeleteUserReportLogo(w http.ResponseWriter, r *http.Request)
DeleteUserReportLogo implements DELETE /user/report-settings/logo: the design stays; removing no logo is done.
func (*Server) DeleteVoice ¶
func (s *Server) DeleteVoice(w http.ResponseWriter, r *http.Request)
DeleteVoice implements DELETE /voice.
func (*Server) DeleteWebhook ¶
DeleteWebhook implements DELETE /orgs/{org}/webhooks/{id} (admin+).
func (*Server) DeliverWebhook ¶
func (s *Server) DeliverWebhook(ctx context.Context, orgID, endpointID uuid.UUID, event string, data any) (bool, error)
DeliverWebhook is pkg/extension.Deps.Webhooks.Deliver: one delivery of event to the endpoint an extension named, through the core's transport — the ledger row, the queued job with its signature, its retries and its SSRF guard — so a destination an organization chose for an extension's purpose is written to exactly the way its subscriptions are. It reports whether a delivery was recorded: an endpoint that is not this organization's, or is switched off, is false with no error — a destination that has gone stale, which the extension may report but cannot repair — and an event outside the catalog is refused, because a consumer's documentation is the core's promise.
func (*Server) DeprovisionMember ¶
func (s *Server) DeprovisionMember(ctx context.Context, ext string, orgID, userID uuid.UUID) (kept bool, err error)
DeprovisionMember takes userID's membership of orgID away on a directory extension's word and revokes their org-bound tokens for orgID, every session and every remembered browser (pkg/extension.Deps.Members). The organization's last admin keeps the membership, so the organization keeps someone who can act, and those credentials are revoked all the same; kept reports it. Calling it again does nothing more. It runs in any state of the organization: taking access away is never frozen.
func (*Server) DiscardVoicePending ¶
func (s *Server) DiscardVoicePending(w http.ResponseWriter, r *http.Request)
DiscardVoicePending implements DELETE /voice/pending.
func (*Server) DownloadKnowledgeTree ¶
func (s *Server) DownloadKnowledgeTree(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
DownloadKnowledgeTree implements GET /knowledge/packs/{packId}/tree: the sealed tree as stored.
func (*Server) DownloadOrgKnowledgeTree ¶
func (s *Server) DownloadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request, org OrgHandle, packID openapi_types.UUID)
DownloadOrgKnowledgeTree implements GET /orgs/{org}/knowledge/packs/{packId}/tree.
func (*Server) DownloadVersion ¶
func (s *Server) DownloadVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
DownloadVersion implements GET .../versions/{version}/download. Self-host streams the archive directly.
func (*Server) EraseAccount ¶ added in v0.6.1000
func (s *Server) EraseAccount(r *http.Request, ext string, actor *auth.Principal, userID uuid.UUID, reason string) (AccountErasure, error)
EraseAccount erases userID's account for the staff member actor: the person's own erasure (eraseAccountNow), with the account's published public versions yanked, because staff do not choose an organization to hand them to. The actor is checked as for every change, again inside the erasure's transaction under both row locks, and the reason is in the user.delete row. An organization's last admin is refused, as the person's own erasure refuses it. The person is mailed at a confirmed address, captured before the erasure scrubs it. r is the request the extension acts in, which the audit rows and the directory half read.
func (*Server) ExchangeDesktopCode ¶
func (s *Server) ExchangeDesktopCode(w http.ResponseWriter, r *http.Request)
ExchangeDesktopCode implements POST /auth/desktop/exchange (anonymous; the code is the credential). Consumes the grant and mints the PAT in one transaction; a second exchange, a wrong state, or an expired grant all get the same 403 so nothing about a code's status leaks.
func (*Server) ExportKnowledgePack ¶
func (s *Server) ExportKnowledgePack(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
ExportKnowledgePack implements GET /knowledge/packs/{packId}/export: the tree decrypted, to its owner alone.
func (*Server) ExportOrgKnowledgePack ¶
func (s *Server) ExportOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packID openapi_types.UUID)
ExportOrgKnowledgePack implements GET /orgs/{org}/knowledge/packs/{packId}/export: an admin's always, a member's once the pack is marked exportable.
func (*Server) ExtensionDeps ¶
func (s *Server) ExtensionDeps() (*pgxpool.Pool, *slog.Logger, func(context.Context, audit.Event) error, func(context.Context, pgx.Tx, audit.Event) error)
ExtensionDeps is what an extension gets to work with (pkg/extension.Deps): the pool the core uses, the logger, and an audit writer that lands an event in its own transaction. nil pool when the server runs without a database (limited dev mode).
func (*Server) ExtensionNames ¶
ExtensionNames lists the mounted extensions in registration order.
func (*Server) ExtensionSealer ¶
ExtensionSealer is a sealer for one extension's small values at rest, under a key derived from auth.sealingKey for that extension alone: it opens none of the server's own sealed values (webhook secrets, sign-in state) and none of another extension's.
func (*Server) ExtensionUnthrottled ¶
ExtensionUnthrottled lists the unthrottled routes of every extension, as "METHOD /api/v1/x/<name>/…" keys, so an extension's own route-table test can assert exactly which of its routes escape the anonymous class.
func (*Server) ForkAgent ¶
ForkAgent implements POST /agents/{ns}/{name}/fork: a private copy of a public agent in a namespace the caller may create in. The handler records it; a worker copies the repository and submits the first version (registry.Fork, registry.CopyFork).
func (*Server) GetAdvisory ¶
func (s *Server) GetAdvisory(w http.ResponseWriter, r *http.Request, advisoryID openapi_types.UUID)
GetAdvisory implements GET /advisories/{advisoryId}: the permalink. Only advisories against public agents resolve; anything else is a 404 so the existence of a private agent's advisory is not discoverable by id.
func (*Server) GetAgentReadme ¶
func (s *Server) GetAgentReadme(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params GetAgentReadmeParams)
GetAgentReadme implements GET /agents/{ns}/{name}/readme: the README of a published version, rendered server-side through the strict sanitizer. The web app never parses user markdown client-side.
func (*Server) GetAgentStats ¶
func (s *Server) GetAgentStats(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
GetAgentStats implements GET /agents/{ns}/{name}/stats: star count plus lifetime and trailing-30-day installs from the download_stats rollup. Public for public agents; private ones need read like every other agent-scoped route.
func (*Server) GetAuditExport ¶
func (s *Server) GetAuditExport(w http.ResponseWriter, r *http.Request, org OrgHandle, id openapi_types.UUID)
GetAuditExport implements GET /orgs/{org}/audit/exports/{id} (admin+).
func (*Server) GetConnectors ¶
func (s *Server) GetConnectors(w http.ResponseWriter, r *http.Request)
GetConnectors implements GET /api/v1/connectors: every connector of the catalogue this build carries, each with the public client id this deployment configured for it, where its app is a public client. It serves configuration and the catalogue alone, so it needs no store and no credential. Its answer has a field for a public client id and none for any other client value.
func (*Server) GetCurrentUser ¶
func (s *Server) GetCurrentUser(w http.ResponseWriter, r *http.Request)
GetCurrentUser implements GET /user.
func (*Server) GetDomainOrg ¶
func (s *Server) GetDomainOrg(w http.ResponseWriter, r *http.Request)
GetDomainOrg implements GET /user/domain-org.
func (*Server) GetInvitation ¶
GetInvitation implements GET /invitations/{token} (session only).
func (*Server) GetKnowledgePack ¶
func (s *Server) GetKnowledgePack(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
GetKnowledgePack implements GET /knowledge/packs/{packId}.
func (*Server) GetKnowledgeUsage ¶
func (s *Server) GetKnowledgeUsage(w http.ResponseWriter, r *http.Request)
GetKnowledgeUsage implements GET /knowledge/usage.
func (*Server) GetLatestRulesetAttestation ¶
func (s *Server) GetLatestRulesetAttestation(w http.ResponseWriter, r *http.Request)
GetLatestRulesetAttestation implements GET /ruleset-releases/latest/attestation. It serves the envelope the key holder stored for this binary's bundle, signed by the active key, so the api role answers without the private key. 404 when no key holder has started with this bundle.
func (*Server) GetLatestRulesetBundle ¶
func (s *Server) GetLatestRulesetBundle(w http.ResponseWriter, r *http.Request)
GetLatestRulesetBundle implements GET /ruleset-releases/latest/bundle.
func (*Server) GetMcpServerScan ¶
func (s *Server) GetMcpServerScan(w http.ResponseWriter, r *http.Request, params GetMcpServerScanParams)
GetMcpServerScan implements GET /mcp-servers/scan: the registry's last check of one package version. Public: a consumer deciding whether to install, and the runner before it installs, both need it.
func (*Server) GetMeta ¶
func (s *Server) GetMeta(w http.ResponseWriter, r *http.Request)
GetMeta implements GET /api/v1/meta: server version + feature flags.
func (*Server) GetOrgKnowledgePack ¶
func (s *Server) GetOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packID openapi_types.UUID)
GetOrgKnowledgePack implements GET /orgs/{org}/knowledge/packs/{packId}.
func (*Server) GetOrgKnowledgeUsage ¶
GetOrgKnowledgeUsage implements GET /orgs/{org}/knowledge/usage.
func (*Server) GetOrgLogo ¶
GetOrgLogo implements GET /orgs/{org}/logo.
func (*Server) GetOrgPolicy ¶
GetOrgPolicy implements GET /orgs/{org}/policy (admin+).
func (*Server) GetPlatformPolicy ¶
func (s *Server) GetPlatformPolicy(w http.ResponseWriter, r *http.Request)
GetPlatformPolicy implements GET /platform/policy (public, read-only).
func (*Server) GetReviewFile ¶
func (s *Server) GetReviewFile(w http.ResponseWriter, r *http.Request, id openapi_types.UUID, params GetReviewFileParams)
GetReviewFile implements GET /review-items/{id}/file?path=.
func (*Server) GetReviewItem ¶
func (s *Server) GetReviewItem(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
GetReviewItem implements GET /review-items/{id}. The bundle carries everything the reviewer detail renders in one call: the findings, the submitted manifest and capabilities, and the previous published version as the capability-diff baseline.
func (*Server) GetUserNotificationSettings ¶
func (s *Server) GetUserNotificationSettings(w http.ResponseWriter, r *http.Request)
GetUserNotificationSettings implements GET /user/notifications.
func (*Server) GetUserProfile ¶
GetUserProfile implements GET /users/{handle} (public).
func (*Server) GetUserReportSettings ¶
func (s *Server) GetUserReportSettings(w http.ResponseWriter, r *http.Request, params GetUserReportSettingsParams)
GetUserReportSettings implements GET /user/report-settings: the report design the caller's PDF reports take, a profile setting. No row reads back with no design, which a client tells apart from Plain. The logo comes only with include=logo: a client built before logos refuses a design with a key it does not know, and would then run without the design at all.
func (*Server) GetVersionAttestation ¶
func (s *Server) GetVersionAttestation(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
GetVersionAttestation implements GET .../versions/{version}/attestation.
func (*Server) GetVersionFile ¶
func (s *Server) GetVersionFile(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString, params GetVersionFileParams)
GetVersionFile implements GET .../versions/{version}/file?path=.
func (*Server) GetVersionInfo ¶
func (s *Server) GetVersionInfo(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
GetVersionInfo implements GET .../versions/{version}.
func (*Server) GetVersionManifest ¶
func (s *Server) GetVersionManifest(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
GetVersionManifest implements GET .../versions/{version}/manifest.
func (*Server) GetVersionReport ¶
func (s *Server) GetVersionReport(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
GetVersionReport implements GET .../versions/{version}/report (public).
func (*Server) GetVoice ¶
func (s *Server) GetVoice(w http.ResponseWriter, r *http.Request)
GetVoice implements GET /voice.
func (*Server) GetWebhook ¶
GetWebhook implements GET /orgs/{org}/webhooks/{id} (admin+).
func (*Server) HandOffScans ¶
func (s *Server) HandOffScans()
HandOffScans makes a submitted version the worker's to scan: the registry enqueues scan.version on the sandbox queue instead of running the pipeline in the process that received the submission. The api, git and all roles call it; untrusted content is then scanned, gated and signed only where a worker drains the sandbox queue. A server with no pipeline or no queue keeps what it has.
func (*Server) HasDirectory ¶
HasDirectory reports whether the server has a directory.
func (*Server) ListAbuseReports ¶
func (s *Server) ListAbuseReports(w http.ResponseWriter, r *http.Request, params ListAbuseReportsParams)
ListAbuseReports implements GET /platform/abuse-reports (staff only).
func (*Server) ListAccountInstalls ¶
func (s *Server) ListAccountInstalls(w http.ResponseWriter, r *http.Request)
ListAccountInstalls implements GET /user/installs: the caller's records composed for a list, newest change first.
func (*Server) ListAdvisories ¶
func (s *Server) ListAdvisories(w http.ResponseWriter, r *http.Request, params ListAdvisoriesParams)
ListAdvisories implements GET /advisories?affecting=ns/name[&digest=] (public; a holder's door to a private agent's).
func (*Server) ListAgentActivity ¶
func (s *Server) ListAgentActivity(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params ListAgentActivityParams)
ListAgentActivity implements GET /agents/{ns}/{name}/activity.
func (*Server) ListAgentGrants ¶
func (s *Server) ListAgentGrants(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
ListAgentGrants implements GET /agents/{ns}/{name}/grants (maintain).
func (*Server) ListAgents ¶
func (s *Server) ListAgents(w http.ResponseWriter, r *http.Request, params ListAgentsParams)
ListAgents implements GET /agents?namespace= (public listing).
func (*Server) ListAgentsByTag ¶
func (s *Server) ListAgentsByTag(w http.ResponseWriter, r *http.Request, tag string, params ListAgentsByTagParams)
ListAgentsByTag implements GET /tags/{tag}: public agents whose latest published manifest carries the tag.
func (*Server) ListDomainClaims ¶
ListDomainClaims implements GET /orgs/{org}/domain-claims (admin+).
func (*Server) ListInvitations ¶
ListInvitations implements GET /orgs/{org}/invitations (admin).
func (*Server) ListKnowledgePackSizes ¶
func (s *Server) ListKnowledgePackSizes(w http.ResponseWriter, r *http.Request, params ListKnowledgePackSizesParams)
ListKnowledgePackSizes implements GET /platform/knowledge (staff): an account's or an organization's packs by name and size, for support, and nothing of their content. A staff token needs knowledge:read for it.
func (*Server) ListKnowledgePacks ¶
func (s *Server) ListKnowledgePacks(w http.ResponseWriter, r *http.Request)
ListKnowledgePacks implements GET /knowledge/packs.
func (*Server) ListOrgAudit ¶
func (s *Server) ListOrgAudit(w http.ResponseWriter, r *http.Request, org OrgHandle, params ListOrgAuditParams)
ListOrgAudit implements GET /orgs/{org}/audit (admin+).
func (*Server) ListOrgKnowledgePacks ¶
ListOrgKnowledgePacks implements GET /orgs/{org}/knowledge/packs.
func (*Server) ListOrgMembers ¶
ListOrgMembers implements GET /orgs/{org}/members (member+).
func (*Server) ListPlatformAudit ¶
func (s *Server) ListPlatformAudit(w http.ResponseWriter, r *http.Request, params ListPlatformAuditParams)
ListPlatformAudit implements GET /platform/audit: platform staff see every org's slice. Platform access is itself audited, so each call writes one audit.platform_read event naming the filters used — reading everyone's log is exactly the action an auditor wants a record of.
func (*Server) ListRedTeamReports ¶
func (s *Server) ListRedTeamReports(w http.ResponseWriter, r *http.Request, params ListRedTeamReportsParams)
ListRedTeamReports implements GET /platform/redteam/reports (staff).
func (*Server) ListReviewFiles ¶
func (s *Server) ListReviewFiles(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
ListReviewFiles implements GET /review-items/{id}/files.
func (*Server) ListReviewQueue ¶
func (s *Server) ListReviewQueue(w http.ResponseWriter, r *http.Request, params ListReviewQueueParams)
ListReviewQueue implements GET /review-queue.
func (*Server) ListRulesetReleases ¶
func (s *Server) ListRulesetReleases(w http.ResponseWriter, r *http.Request)
ListRulesetReleases implements GET /platform/ruleset-releases: the staff console's history, newest first — the head is the bundle new scans are judged under.
func (*Server) ListSshKeys ¶
func (s *Server) ListSshKeys(w http.ResponseWriter, r *http.Request)
ListSshKeys implements GET /user/ssh-keys.
func (*Server) ListTeamMembers ¶
func (s *Server) ListTeamMembers(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)
ListTeamMembers implements GET /orgs/{org}/teams/{team}/members (member+).
func (*Server) ListTokens ¶
func (s *Server) ListTokens(w http.ResponseWriter, r *http.Request)
ListTokens implements GET /user/tokens.
func (*Server) ListUserActivity ¶
func (s *Server) ListUserActivity(w http.ResponseWriter, r *http.Request, params ListUserActivityParams)
ListUserActivity implements GET /user/activity: the audit events the caller performed, newest first, with the address and client each came from — the "was that me?" view of an account.
func (*Server) ListUserDependencyAlerts ¶
func (s *Server) ListUserDependencyAlerts(w http.ResponseWriter, r *http.Request)
ListUserDependencyAlerts implements GET /user/dependency-alerts: the open alerts on published versions the caller submitted, newest first. This is what the site's sign-in banner and dashboard read.
func (*Server) ListUserSessions ¶
func (s *Server) ListUserSessions(w http.ResponseWriter, r *http.Request)
ListUserSessions implements GET /user/sessions.
func (*Server) ListVersionFiles ¶
func (s *Server) ListVersionFiles(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
ListVersionFiles implements GET .../versions/{version}/files.
func (*Server) ListVersions ¶
ListVersions implements GET /agents/{ns}/{name}/versions.
func (*Server) ListWebhookDeliveries ¶
func (s *Server) ListWebhookDeliveries(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID, params ListWebhookDeliveriesParams)
ListWebhookDeliveries implements GET /orgs/{org}/webhooks/{id}/deliveries.
func (*Server) ListWebhooks ¶
ListWebhooks implements GET /orgs/{org}/webhooks (admin+).
func (*Server) Logout ¶
func (s *Server) Logout(w http.ResponseWriter, r *http.Request)
Logout implements POST /auth/logout (session-only).
func (*Server) MCPSweepReady ¶
MCPSweepReady reports whether the daily MCP sweep would consult a vulnerability database (the wiring check for the sweep).
func (*Server) ModelInputCallers ¶
func (s *Server) ModelInputCallers() ModelInputCallers
ModelInputCallers is the extension that admits hosted jobs, or nil.
func (*Server) MountAuthzDecl ¶
MountAuthzDecl is the declaration of a pattern this server's mux was given: the core's own table (the package-level MountAuthzDecl), then the callback mounts its extensions registered, each declared as the extension declared it.
func (*Server) MountedRoutes ¶
MountedRoutes returns what the public mux was actually given — the root mounts and the generated surface — which is what the completeness gate enumerates.
func (*Server) Notifier ¶
Notifier exposes the configured notifier so other roles share one instance.
func (*Server) OrgAdminIDs ¶
OrgAdminIDs is pkg/extension.Deps.Notifier.OrgAdmins: the active administrators of an organization. Pending administrators are left out — they hold nothing of the organization until approved — and an organization that does not exist is an empty list, not an error, so the seam cannot be used to tell one from the other.
func (*Server) OrgReadable ¶
OrgReadable is the core's organization gate for pkg/extension.Deps.OrgGate: whether the organization is there to be read, as the core's own routes decide it through registry.OrgGate. An active organization and one in its decommission hold are readable; a suspended one, an erased one and one that does not exist are the same false with no error, so an extension answers each as absent, as the core does. An unreadable state is a fault, never permission.
func (*Server) OrgWritable ¶
OrgWritable is OrgReadable for an act that changes the organization or spends what it holds: only an active organization permits it, so one in its decommission hold is readable and not writable, and a suspended, erased or unknown one is neither.
func (*Server) PingWebhook ¶
PingWebhook implements POST /orgs/{org}/webhooks/{id}/ping. It enqueues a real delivery through the ordinary machinery — same HMAC signature, same SSRF guard, same retry ladder — so "does my endpoint work" is answered by the code that will actually call it, not by a special path that might diverge from it.
func (*Server) Pipeline ¶
Pipeline exposes the assembled security pipeline so the worker role runs exactly the object the api role wires — including its registry event sink, without which rescan-driven agent.quarantined webhooks went nowhere. nil when this server has no archive store (see New).
func (*Server) PlatformAgentAction ¶
func (s *Server) PlatformAgentAction(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, actionParam PlatformAgentActionParamsAction)
PlatformAgentAction implements POST /platform/agents/{ns}/{name}/{action} (T&S actions: quarantine, block, reinstate). Platform staff only. Reinstate clears the agent's flag and asks for a fresh scan of each blocked or quarantined version; a version is published again only when the gate's verdict on that scan is publish.
func (*Server) PlatformStaff ¶
func (s *Server) PlatformStaff(ctx context.Context) ([]StaffMember, error)
PlatformStaff lists every active account that is platform staff with a verified address, ordered by handle (pkg/extension.Deps.Staff). Platform staff is the staff organization's rule, recomputed by the registry alone; this is its read side, never a way to change it.
func (*Server) PrincipalForSchedule ¶
func (s *Server) PrincipalForSchedule(ctx context.Context, userID, scheduleID uuid.UUID) (*auth.Principal, bool, error)
PrincipalForSchedule is pkg/extension.Deps.ScheduleCredentials: the credential of one fire of a schedule its owner made in the closed build. It is PrincipalForUser's account, standing and roles, loaded now, with Via "schedule", the schedule's id, and auth.ScheduleScopes — every scope gate reads it as a token minted with exactly those (auth.Principal.ScopeBound). The account's platform-staff standing is dropped: a schedule starts its owner's run and nothing that standing would add. An account that does not exist or is not active is false with no error, so a suspended owner's schedule does not fire; a nil schedule id is an error, because a credential that names nothing could not be told from another in audit.
func (*Server) PrincipalForUser ¶
func (s *Server) PrincipalForUser(ctx context.Context, userID uuid.UUID) (*auth.Principal, bool, error)
PrincipalForUser is the principal the core would hold for userID with no credential presented, for pkg/extension.Deps.Principals: the account's current standing and memberships as a session would carry them — loaded now, so a role taken away since an earlier request is gone — with Via "user", no scopes and no session. An account that does not exist or is not active is false with no error, as a session of it would not resolve. It is a question to put to the Agents seam about a user an extension holds by id (a hosted run's owner at the release prefix), never a credential: auth.Check refuses Via "user", so it authorizes no route, and it satisfies no organization's enforced SSO.
func (*Server) ProvisionMember ¶
func (s *Server) ProvisionMember(ctx context.Context, ext string, orgID uuid.UUID, p ProvisionedMember) (uuid.UUID, error)
ProvisionMember makes the person a pending member of orgID on a directory extension's word (pkg/extension.Deps.Members): the account at their address when it has proved the address, or a new one with the address taken as verified on the extension's word. A pending membership holds no seat and confers nothing until an admin approves it, and an existing membership, pending or active, is left as it is. The staff organization admits only its own domain. The extension decides whom to provision; the core decides what provisioning is.
func (*Server) PutAccountInstall ¶
func (s *Server) PutAccountInstall(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
PutAccountInstall implements PUT /user/installs/{ns}/{name}: record a published release the caller can read as installed to the account, or move an existing record to it. Refused with install-consent-required when the request lacks an acceptance the release needs: the declared capabilities on a first install and on an update that widened them against the accepted snapshot (the rule the CLI's and the desktop's updates apply); unsigned whenever the release carries no attestation; unscanned whenever it was admitted without a scan.
func (*Server) PutOrgLogo ¶
PutOrgLogo implements PUT /orgs/{org}/logo.
func (*Server) PutUserReportLogo ¶
func (s *Server) PutUserReportLogo(w http.ResponseWriter, r *http.Request)
PutUserReportLogo implements PUT /user/report-settings/logo: one multipart part named file, PNG or JPEG, at most 512 KB, decoded, scaled down and encoded again as PNG by pkg/reportdesign, so only its pixels are kept. A logo travels with a design, so with no design saved it is 409. Read the same way as the organization's logo (readUploadPart), at this setting's own bound.
func (*Server) PutVoice ¶
func (s *Server) PutVoice(w http.ResponseWriter, r *http.Request)
PutVoice implements PUT /voice: a new version, pending until reviewed.
func (*Server) Readyz ¶
func (s *Server) Readyz(w http.ResponseWriter, r *http.Request)
Readyz is the readiness handler for a role that assembles its own mux — the git role (pkg/extension), whose Deployment probes /readyz like the api's.
func (*Server) Reg ¶
Reg exposes the registry service so role wiring can share one instance (git role injects its archiver; auto-publish uses the same hand-off).
func (*Server) RegisterExtension ¶
RegisterExtension mounts routes under /api/v1/x/<name>/ when the handler is built (NewHandler); the mux the callback receives is rooted there, so its patterns are relative ("GET /status"). Every request through it has passed principalMiddleware: PAT or session resolved, CSRF enforced on mutations, the per-class rate limits applied.
func (*Server) RegisterExtensionCallbacks ¶
func (s *Server) RegisterExtensionCallbacks(name string, cb ExtensionCallbacks)
RegisterExtensionCallbacks mounts an extension's callbacks under /internal/x/<name>/ when the handler is built. A malformed name or class, a missing reason, a short secret or a second registration under one name panics at start-up, where it is found.
func (*Server) RegisterQueueHandlers ¶
RegisterQueueHandlers wires this server's async job handlers onto a queue worker (the worker role, and tests): webhook delivery and audit export.
func (*Server) ReinstateAccount ¶ added in v0.6.1000
func (s *Server) ReinstateAccount(ctx context.Context, ext string, actor *auth.Principal, userID uuid.UUID, reason string) (AccountChange, error)
ReinstateAccount makes a suspended account active again. Nothing from before the suspension comes back: it revokes every credential again in the same transaction, because one being created at the instant of the suspension (a token whose insert waited on the person's row lock) can commit just after the suspension's revocation. The person signs in afresh and makes new tokens and keys. It is platform staff again only if the staff rule says so now. Reinstating an active account changes nothing.
func (*Server) ReinstateOrg ¶
ReinstateOrg implements POST /orgs/{org}/reinstate (platform staff): a suspended organization comes back, and a decommission hold that has not run is cancelled. An erasure that ran cannot be undone.
func (*Server) RemoveAgentTeamGrant ¶
func (s *Server) RemoveAgentTeamGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, team TeamSlug)
RemoveAgentTeamGrant implements DELETE /agents/{ns}/{name}/grants/team/{team}.
func (*Server) RemoveAgentUserGrant ¶
func (s *Server) RemoveAgentUserGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, handle Handle)
RemoveAgentUserGrant implements DELETE /agents/{ns}/{name}/grants/user/{handle}.
func (*Server) RemoveOrgMember ¶
func (s *Server) RemoveOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
RemoveOrgMember implements DELETE /orgs/{org}/members/{handle}: an admin removes a member, or a member leaves. Leaving is any active member's own act: a person belongs to one organization at a time, so they must be able to end the membership they hold, and it deletes nothing of theirs. The last admin can do neither (409 last-admin) — only a decommission removes them.
func (*Server) RemoveSshKey ¶
func (s *Server) RemoveSshKey(w http.ResponseWriter, r *http.Request, keyID openapi_types.UUID)
RemoveSshKey implements DELETE /user/ssh-keys/{keyId} (session-only).
func (*Server) RemoveTeamMember ¶
func (s *Server) RemoveTeamMember(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug, handle Handle)
RemoveTeamMember implements DELETE /orgs/{org}/teams/{team}/members/{handle}.
func (*Server) ReportAbuse ¶
ReportAbuse implements POST /agents/{ns}/{name}/abuse-reports.
func (*Server) ReportDesign ¶
ReportDesign is a person's report design as its canonical document, without its logo, or nil when they never chose one, which is not Plain: the reader decides what nothing means. It is the read behind GET /user/report-settings and the extension seam (pkg/extension ReportSettings). A stored design that no longer validates (a rule tightened since it was saved) reads as never chosen, and is logged.
func (*Server) ReportDesignWithLogo ¶
ReportDesignWithLogo is ReportDesign with the person's logo in it, when they have one, for a reader that draws it.
func (*Server) ReportTheme ¶
ReportTheme is the built-in theme a person's design started from (its basedOn), or "" when they never chose one. The hosted job carries a theme's name to a sandbox host whose CLI knows theme names, and drops a name it does not have.
func (*Server) RequestDomainOrgAccess ¶
func (s *Server) RequestDomainOrgAccess(w http.ResponseWriter, r *http.Request)
RequestDomainOrgAccess implements POST /user/domain-org/request-access (session only). The audit row is the record and the rate limit: one request per person per day, whatever the mail did.
func (*Server) ResendActivation ¶ added in v0.6.1000
func (s *Server) ResendActivation(ctx context.Context, ext string, actor *auth.Principal, userID uuid.UUID, reason string) (time.Time, error)
ResendActivation sends an unactivated account a new activation link for the staff member actor, under the limits the person's own resend has (one link in five minutes, ten a day). An account already activated, one with no address a link can reach and one not active are refused. It is audited as user.activation_resend with the actor and the reason, and returns when another link may go.
func (*Server) ResolveRef ¶
func (s *Server) ResolveRef(w http.ResponseWriter, r *http.Request, params ResolveRefParams)
ResolveRef implements GET /resolve.
func (*Server) RestoreAgent ¶
RestoreAgent implements POST /agents/{ns}/{name}/restore.
func (*Server) RestoreVoice ¶
func (s *Server) RestoreVoice(w http.ResponseWriter, r *http.Request)
RestoreVoice implements POST /voice/restore.
func (*Server) RetireAgent ¶
RetireAgent implements POST /agents/{ns}/{name}/retire. The namespace's administrators: it changes who can see the agent.
func (*Server) RevokeInvitation ¶
func (s *Server) RevokeInvitation(w http.ResponseWriter, r *http.Request, org OrgHandle, id openapi_types.UUID)
RevokeInvitation implements DELETE /orgs/{org}/invitations/{id} (admin).
func (*Server) RevokeOtherUserSessions ¶
func (s *Server) RevokeOtherUserSessions(w http.ResponseWriter, r *http.Request)
RevokeOtherUserSessions implements DELETE /user/sessions — "sign out everywhere else". The calling session is deliberately spared: a control that logs you out of the browser you are using is one nobody presses twice.
func (*Server) RevokeToken ¶
func (s *Server) RevokeToken(w http.ResponseWriter, r *http.Request, tokenID openapi_types.UUID)
RevokeToken implements DELETE /user/tokens/{tokenId} (session-only).
func (*Server) RevokeUserSession ¶
func (s *Server) RevokeUserSession(w http.ResponseWriter, r *http.Request, sessionID openapi_types.UUID)
RevokeUserSession implements DELETE /user/sessions/{sessionId}.
func (*Server) RunFoldInSweep ¶
RunFoldInSweep folds in every account already known at the domain and reports how many. Exported for the tests and for an operator's hand-run.
func (*Server) RunOrgDecommissionSweep ¶
RunOrgDecommissionSweep erases every organization whose hold has ended and reports how many it erased, then resumes the second phase of any erasure an earlier sweep left unfinished. Exported for the tests and for an operator's hand-run. A failure is logged and retried by the next sweep; the first is returned so the job is retried too.
func (*Server) RunPendingMembersDigest ¶
RunPendingMembersDigest mails each organization's active admins — or the one organization's, when only is not Nil — the pending members nobody has told them about: one mail per admin per organization naming them all, whichever door they came through. Each organization is done in a transaction under its row lock, so two runs at once (several worker replicas each tick) cannot both name the same people. The mail goes through the notifier under the verified-address rule and the admin's orgInvites preference, the way the access request does: the digest is the invitation flow seen from the admin's side. The members are marked told when at least one admin was written to, or when no admin can be — the members are on the console regardless, and an unreachable admin is not a reason to try daily forever; a delivery that failed leaves them unmarked for the next run. Reports how many organizations were mailed. Exported for the tests and for an operator's hand-run.
func (*Server) RunRedTeamNow ¶
RunRedTeamNow executes one red-team run immediately (the job body without the queue): the entry point for tests and for an operator who does not want to wait for the interval.
func (*Server) RunTrustedDeviceSweep ¶
RunTrustedDeviceSweep deletes every remembered-browser record past its own expiry and reports how many it deleted. Expired records are already inert, since every lookup filters on expiry; the sweep is what removes the address and the user agent they still hold, so a table of browsers does not grow for ever. Exported for the tests and for an operator's hand-run. A run with nothing to delete is the common case and does nothing.
func (*Server) ScanModelInput ¶
func (s *Server) ScanModelInput(w http.ResponseWriter, r *http.Request)
ScanModelInput implements POST /model-input/scan.
func (*Server) SearchAgents ¶
func (s *Server) SearchAgents(w http.ResponseWriter, r *http.Request, params SearchAgentsParams)
SearchAgents implements GET /search: Postgres FTS over public agents with the facets — kind, capability, license, verified — and a sort selector. capability/license read the LATEST PUBLISHED version, so a filter always describes what someone would install today. Blocked agents never appear.
func (*Server) SearchModelInput ¶
func (s *Server) SearchModelInput(w http.ResponseWriter, r *http.Request)
SearchModelInput implements POST /model-input/search.
func (*Server) SendEmailVerification ¶
func (s *Server) SendEmailVerification(w http.ResponseWriter, r *http.Request)
SendEmailVerification implements POST /user/email-verification.
func (*Server) SendToUser ¶
func (s *Server) SendToUser(ctx context.Context, userID uuid.UUID, kind, subject, text string) (bool, error)
SendToUser is the core's side of pkg/extension.Deps.Notifier.Send: a message an extension composed goes to the person only under the core's rule — notify.AllowsEmail, which is the verified-address rule and the person's switch for the kind — and only as a kind the core knows. It reports whether the message went; a suppression is false with no error, and the extension is not told why, because the address is the person's business and the switch is their choice. An unknown kind is refused outright: an extension sends as the classes it was given, so a billing notice cannot dress itself as a quarantine.
func (*Server) SetAgentTeamGrant ¶
func (s *Server) SetAgentTeamGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, team TeamSlug)
SetAgentTeamGrant implements PUT /agents/{ns}/{name}/grants/team/{team}. Team grants only make sense for org-namespace agents; the team must belong to the agent's org.
func (*Server) SetAgentUserGrant ¶
func (s *Server) SetAgentUserGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, handle Handle)
SetAgentUserGrant implements PUT /agents/{ns}/{name}/grants/user/{handle}.
func (*Server) SetDirectory ¶
SetDirectory makes d the server's directory, for every caller: erasure (by d's own DirectoryErasure where it has one, else by one attempt through d) and the superseded-account check. The directory's own sign-in work (its claims, remembered browsers, its callbacks, a staff mirror) is d's, through the sign-in hook, its callback mount and staff.changed. A nil d leaves the server with no directory.
func (*Server) SetDraftChecker ¶
func (s *Server) SetDraftChecker(c DraftChecker)
SetDraftChecker sets the checker the check route asks; nil turns it off (503). New sets it from the judge configuration when the judge is Jev.
func (*Server) SetEntitlements ¶
func (s *Server) SetEntitlements(r entitlements.Resolver)
SetEntitlements swaps the quota resolver (the SaaS overlay, and tests).
func (*Server) SetExtensionTokens ¶ added in v0.6.1000
func (s *Server) SetExtensionTokens(name, prefix string, resolve ExtensionTokenResolver)
SetExtensionTokens lets the extension registered as name accept bearer tokens it mints itself, of the given prefix, under its own mount and nowhere else. Resolve is asked for each one; a token it knows becomes a principal with Via "extension", the user's id, no scopes and no roles. A prefix of the wrong shape, one of the core's, one another extension claimed, a nil resolver or an unknown extension panics at start-up, where it is found.
func (*Server) SetExtensionUnthrottled ¶
SetExtensionUnthrottled names the routes of a mounted extension the anonymous rate class does not apply to: "METHOD /path", relative to the mount, exact (no wildcards — the seam is narrow on purpose). Only an extension's own receiver of signed callbacks belongs here; the route still passes the principal middleware and declares its own authorization. Panics on a malformed pattern or an unknown extension, at start-up, where it is found.
func (*Server) SetFindingVerdict ¶
func (s *Server) SetFindingVerdict(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
SetFindingVerdict implements POST /findings/{id}/verdict. Only org security_reviewers may accept-risk, and only up to medium.
func (*Server) SetImageProxyClient ¶
SetImageProxyClient overrides the guarded client the README image proxy fetches with (tests point it at an in-process server).
func (*Server) SetKeyWrapper ¶
func (s *Server) SetKeyWrapper(w knowledge.KeyWrapper)
SetKeyWrapper replaces the knowledge store's key wrapper: an extension's (pkg/extension WrapsKeys) in place of the deployment key.
func (*Server) SetKnowledgeAdmitter ¶
func (s *Server) SetKnowledgeAdmitter(a KnowledgeAdmitter)
SetKnowledgeAdmitter sets the extension that admits an upload's scan.
func (*Server) SetMCPScanning ¶
SetMCPScanning swaps S7's vulnerability database client (tests use a fake); the scanned-server registry stays the store's.
func (*Server) SetMetrics ¶
SetMetrics wires the instrument set. nil leaves every record a no-op.
func (*Server) SetModelInputCallers ¶
func (s *Server) SetModelInputCallers(c ModelInputCallers)
SetModelInputCallers sets the extension that admits hosted jobs.
func (*Server) SetModelInputScanner ¶
func (s *Server) SetModelInputScanner(sc ModelInputScanner)
SetModelInputScanner sets the scanner the routes ask; nil turns them off (503). New sets it from the judge configuration when the judge is Jev.
func (*Server) SetNotifier ¶
SetNotifier overrides the notifier (tests).
func (*Server) SetOIDCHTTPClient ¶
SetOIDCHTTPClient overrides the HTTP client used for OIDC discovery/JWKS/ token calls (tests point it at an in-process IdP).
func (*Server) SetOrgMember ¶
SetOrgMember implements PUT /orgs/{org}/members/{handle}.
func (*Server) SetOrgPolicy ¶
SetOrgPolicy implements PUT /orgs/{org}/policy (admin; tighten-only).
func (*Server) SetResolver ¶
SetResolver overrides the DNS resolver (domain verification; tests inject a fake resolver,).
func (*Server) SetVoiceAdmitter ¶
func (s *Server) SetVoiceAdmitter(a VoiceAdmitter)
SetVoiceAdmitter sets the extension that admits a voice's review.
func (*Server) SetVoiceJudge ¶
SetVoiceJudge replaces the judge the voice review asks (a test's stub).
func (*Server) SetWebSearch ¶
SetWebSearch sets the provider the search route brokers; nil turns it off (503).
func (*Server) SetWebhookDispatcher ¶
func (s *Server) SetWebhookDispatcher(d *webhook.Dispatcher)
SetWebhookDispatcher overrides the webhook dispatcher (tests inject a loopback-allowing delivery client). The registry event sink already points at s.emitAgentEvent, which reads s.webhooks at call time.
func (*Server) SignOutAccount ¶ added in v0.6.1000
func (s *Server) SignOutAccount(ctx context.Context, ext string, actor *auth.Principal, userID uuid.UUID, reason string) (AccountChange, error)
SignOutAccount ends every session of userID's account and forgets every browser it remembered, so the next sign-in asks for everything again. Its tokens and SSH keys keep working: they are revoked by suspending.
func (*Server) SocialOidcCallback ¶
func (s *Server) SocialOidcCallback(w http.ResponseWriter, r *http.Request, provider SocialOidcCallbackParamsProvider, params SocialOidcCallbackParams)
SocialOidcCallback implements GET /auth/oidc/{provider}/callback.
func (*Server) SocialOidcStart ¶
func (s *Server) SocialOidcStart(w http.ResponseWriter, r *http.Request, provider SocialOidcStartParamsProvider, params SocialOidcStartParams)
SocialOidcStart implements GET /auth/oidc/{provider}/start.
func (*Server) StarAgent ¶
StarAgent implements PUT /user/stars/{ns}/{name}.
Idempotent in both directions: PUT on an already-starred agent is 204, and so is DELETE on an unstarred one. A star is a bookmark, not a transaction — a client retrying after a dropped connection should not see an error. Read permission is required so starring cannot be used to probe for the existence of private agents.
func (*Server) StreamVersionEvents ¶
func (s *Server) StreamVersionEvents(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
StreamVersionEvents implements GET /agents/{ns}/{name}/versions/{version}/events.
func (*Server) SubmitVersion ¶
func (s *Server) SubmitVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
SubmitVersion implements POST /agents/{ns}/{name}/versions.
func (*Server) SuspendAccount ¶ added in v0.6.1000
func (s *Server) SuspendAccount(ctx context.Context, ext string, actor *auth.Principal, userID uuid.UUID, reason string) (AccountChange, error)
SuspendAccount suspends userID's account: nobody can sign in to it or act as it, every session, personal access token, SSH key, remembered browser and unused desktop sign-in code is revoked, and it stops being platform staff, in one transaction. A suspended account is refused at every door by its state alone; the revocation is what keeps a reinstatement from bringing any of it back. Suspending a suspended account changes nothing.
func (*Server) SuspendOrg ¶
SuspendOrg implements POST /orgs/{org}/suspend (platform staff).
func (*Server) TellSecondFactorsRemoved ¶ added in v0.6.1000
func (s *Server) TellSecondFactorsRemoved(ctx context.Context, actor *auth.Principal, userID uuid.UUID, removed int) (bool, error)
TellSecondFactorsRemoved tells the person that platform staff removed removed of their second factors, an act an extension made at the person's directory and audits itself. The core holds no second factor, so it changes nothing here; it keeps the notice, which is a security notice like the other acts' and so goes out whatever the person's mail switches say, and only to a confirmed address. The actor is checked as for every change. It reports whether the notice was handed to the notifier: false with no error is an address that may not be written to.
func (*Server) TriageAbuseReport ¶
TriageAbuseReport implements POST /platform/abuse-reports/{id} (staff only). Recording a triage outcome is bookkeeping — enforcement actions go through the platform agent actions so their audit trail names the agent.
func (*Server) UnstarAgent ¶
UnstarAgent implements DELETE /user/stars/{ns}/{name}.
func (*Server) UnwrapKnowledgeKey ¶
func (s *Server) UnwrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
UnwrapKnowledgeKey implements POST /knowledge/keys/unwrap: the data key, to the owner it was wrapped for and no one else.
func (*Server) UnwrapOrgKnowledgeKey ¶
UnwrapOrgKnowledgeKey implements POST /orgs/{org}/knowledge/keys/unwrap: the data key, to an active member of the organization it was wrapped for.
func (*Server) UpdateAgent ¶
UpdateAgent implements PATCH /agents/{ns}/{name} (maintain).
func (*Server) UpdateCurrentUser ¶
func (s *Server) UpdateCurrentUser(w http.ResponseWriter, r *http.Request)
UpdateCurrentUser implements PATCH /user.
func (*Server) UpdateOrgKnowledgePack ¶
func (s *Server) UpdateOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packID openapi_types.UUID)
UpdateOrgKnowledgePack implements PATCH /orgs/{org}/knowledge/packs/{packId}: whether the organization's members may export the pack.
func (*Server) UpdateUserNotificationSettings ¶
func (s *Server) UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)
UpdateUserNotificationSettings implements PUT /user/notifications: a full replace of the switches every client knows, sent back as read and changed — with three exceptions. billing, schedules and bugReports may be omitted, and an omitted one keeps the row's value: clients predate them, and reading an absence as false would switch that mail off for anyone who saved any other setting. The keep is the statement's own (COALESCE in the upsert), so two clients writing at once cannot resurrect a value neither sent.
func (*Server) UpdateUserReportSettings ¶
func (s *Server) UpdateUserReportSettings(w http.ResponseWriter, r *http.Request, params UpdateUserReportSettingsParams)
UpdateUserReportSettings implements PUT /user/report-settings: a full replace, so a body with no design (or a null one) clears the choice. The design is parsed by pkg/reportdesign, which refuses an unknown key, a missing field, a name off a closed list, a colour that fails the contrast rule and an over-size document; the field it names comes back as design.<path>. The canonical document is what is stored and answered. The logo is stored beside the design: a design that carries one replaces the stored logo with NormalizeLogo's encoding of it, and a design that carries none leaves a stored logo as it is, so a client that does not know logos cannot drop one by saving.
func (*Server) UpdateVoiceSettings ¶
func (s *Server) UpdateVoiceSettings(w http.ResponseWriter, r *http.Request)
UpdateVoiceSettings implements PUT /voice/settings; a field not sent keeps its value.
func (*Server) UpdateWebhook ¶
UpdateWebhook implements PATCH /orgs/{org}/webhooks/{id} (admin+).
func (*Server) UploadKnowledgeTree ¶
func (s *Server) UploadKnowledgeTree(w http.ResponseWriter, r *http.Request, packID openapi_types.UUID)
UploadKnowledgeTree implements PUT /knowledge/packs/{packId}/tree.
func (*Server) UploadOrgKnowledgeTree ¶
func (s *Server) UploadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request, org OrgHandle, packID openapi_types.UUID)
UploadOrgKnowledgeTree implements PUT /orgs/{org}/knowledge/packs/{packId}/tree.
func (*Server) UseRememberedBrowser ¶
func (s *Server) UseRememberedBrowser(r *http.Request, userID uuid.UUID, token string, detail map[string]any) (bool, error)
UseRememberedBrowser reports whether token is a live remembered browser of userID's active account (pkg/extension.Deps.RememberedBrowsers), and records the use before it answers yes: a skip nobody could audit is not granted. Every "not this account's live record" is false with no error; only a store that could not answer is an error, which the caller must treat as no.
func (*Server) VerifyDomainClaim ¶
VerifyDomainClaim implements POST /orgs/{org}/domain-claims/verify: it looks up the DNS TXT record via the injected resolver and, on success, marks the claim verified (the basis for auto-linking). A domain belongs to one organization: one that another organization was created at, or has verified, is 409 domain-claimed here too.
func (*Server) VerifyEmail ¶
func (s *Server) VerifyEmail(w http.ResponseWriter, r *http.Request)
VerifyEmail implements POST /auth/verify-email: the activation link's target. Following it confirms the address the link was mailed to and activates the account; extensions hear user.email_verified once the confirmation commits.
func (*Server) WebhookEndpoints ¶
func (s *Server) WebhookEndpoints(ctx context.Context, orgID uuid.UUID) ([]WebhookEndpointRef, error)
WebhookEndpoints is pkg/extension.Deps.Webhooks.Endpoints: the organization's endpoints, active or not, newest first. An organization that does not exist has none, not an error, the shape OrgAdminIDs has.
func (*Server) WrapKnowledgeKey ¶
func (s *Server) WrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
WrapKnowledgeKey implements POST /knowledge/keys/wrap.
func (*Server) WrapMiddleware ¶
WrapMiddleware puts h behind the always-on middleware stack — request id, panic recovery, security headers, the access line, RED metrics — with this server's logger, metrics and trusted-proxy depth. The `git` role mounts its bare mux through it so a git deployment logs like an api one.
func (*Server) WrapOrgKnowledgeKey ¶
WrapOrgKnowledgeKey implements POST /orgs/{org}/knowledge/keys/wrap.
func (*Server) YankVersion ¶
func (s *Server) YankVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
YankVersion implements POST .../versions/{version}/yank.
type ServerInterface ¶
type ServerInterface interface {
// ListAdvisories Published advisories — for one agent, or the global feed.
// (GET /advisories)
ListAdvisories(w http.ResponseWriter, r *http.Request, params ListAdvisoriesParams)
// GetAdvisory One published advisory (permalink); public agents only.
// (GET /advisories/{advisoryId})
GetAdvisory(w http.ResponseWriter, r *http.Request, advisoryId openapi_types.UUID)
// ListAgents List agents in a namespace (public ones for everyone).
// (GET /agents)
ListAgents(w http.ResponseWriter, r *http.Request, params ListAgentsParams)
// CreateAgent Create an agent and its hosted git repository.
// (POST /agents)
CreateAgent(w http.ResponseWriter, r *http.Request)
// DeleteAgent Delete an agent (the namespace's administrators).
// (DELETE /agents/{ns}/{name})
DeleteAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params DeleteAgentParams)
// GetAgent Agent metadata (public agents readable by anyone).
// (GET /agents/{ns}/{name})
GetAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// UpdateAgent Update agent settings (maintain).
// (PATCH /agents/{ns}/{name})
UpdateAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// ReportAbuse Report malicious or abusive content (authed, rate-limited).
// (POST /agents/{ns}/{name}/abuse-reports)
ReportAbuse(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// ListAgentActivity Recent activity for an agent.
// (GET /agents/{ns}/{name}/activity)
ListAgentActivity(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params ListAgentActivityParams)
// ForkAgent Fork a public agent into a namespace the caller may create in.
// (POST /agents/{ns}/{name}/fork)
ForkAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// ListAgentGrants List explicit grants (maintain).
// (GET /agents/{ns}/{name}/grants)
ListAgentGrants(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// RemoveAgentTeamGrant Remove a team grant (maintain).
// (DELETE /agents/{ns}/{name}/grants/team/{team})
RemoveAgentTeamGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, team TeamSlug)
// SetAgentTeamGrant Grant an org team a per-agent role (maintain; org agents only).
// (PUT /agents/{ns}/{name}/grants/team/{team})
SetAgentTeamGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, team TeamSlug)
// RemoveAgentUserGrant Remove a user grant (maintain).
// (DELETE /agents/{ns}/{name}/grants/user/{handle})
RemoveAgentUserGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, handle Handle)
// SetAgentUserGrant Grant a user a per-agent role (maintain).
// (PUT /agents/{ns}/{name}/grants/user/{handle})
SetAgentUserGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, handle Handle)
// GetAgentReadme The agent README rendered to sanitized HTML.
// (GET /agents/{ns}/{name}/readme)
GetAgentReadme(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params GetAgentReadmeParams)
// RestoreAgent Restore a retired agent (the namespace's administrators).
// (POST /agents/{ns}/{name}/restore)
RestoreAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// RetireAgent Retire an agent (the namespace's administrators).
// (POST /agents/{ns}/{name}/retire)
RetireAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// GetAgentStats Star count and install counts for an agent.
// (GET /agents/{ns}/{name}/stats)
GetAgentStats(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// ListVersions Version history, newest first.
// (GET /agents/{ns}/{name}/versions)
ListVersions(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// SubmitVersion Submit a version for publication.
// (POST /agents/{ns}/{name}/versions)
SubmitVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// GetVersionInfo One version with its state and archive identity.
// (GET /agents/{ns}/{name}/versions/{version})
GetVersionInfo(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
// GetVersionAttestation The signed DSSE attestation, verbatim.
// (GET /agents/{ns}/{name}/versions/{version}/attestation)
GetVersionAttestation(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
// DownloadVersion Download the release archive (counts an install).
// (GET /agents/{ns}/{name}/versions/{version}/download)
DownloadVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
// StreamVersionEvents Server-sent events for a version's pipeline progress.
// (GET /agents/{ns}/{name}/versions/{version}/events)
StreamVersionEvents(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
// GetVersionFile Read one file from the version's release archive.
// (GET /agents/{ns}/{name}/versions/{version}/file)
GetVersionFile(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString, params GetVersionFileParams)
// ListVersionFiles List the files inside the version's release archive.
// (GET /agents/{ns}/{name}/versions/{version}/files)
ListVersionFiles(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
// GetVersionManifest The validated manifest (canonical JSON).
// (GET /agents/{ns}/{name}/versions/{version}/manifest)
GetVersionManifest(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
// GetVersionReport The scan report for a version (findings, ruleset, verdict).
// (GET /agents/{ns}/{name}/versions/{version}/report)
GetVersionReport(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
// YankVersion Yank a published version (publish permission).
// (POST /agents/{ns}/{name}/versions/{version}/yank)
YankVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
// ExchangeDesktopCode Exchange a desktop sign-in code for the PAT it granted.
// (POST /auth/desktop/exchange)
ExchangeDesktopCode(w http.ResponseWriter, r *http.Request)
// Logout Revoke the current session.
// (POST /auth/logout)
Logout(w http.ResponseWriter, r *http.Request)
// SocialOidcCallback Sign-in redirect URI: establish a session.
// (GET /auth/oidc/{provider}/callback)
SocialOidcCallback(w http.ResponseWriter, r *http.Request, provider SocialOidcCallbackParamsProvider, params SocialOidcCallbackParams)
// SocialOidcStart Begin sign-in with the deployment's OpenID provider.
// (GET /auth/oidc/{provider}/start)
SocialOidcStart(w http.ResponseWriter, r *http.Request, provider SocialOidcStartParamsProvider, params SocialOidcStartParams)
// VerifyEmail Confirm an email address with the mailed token.
// (POST /auth/verify-email)
VerifyEmail(w http.ResponseWriter, r *http.Request)
// GetConnectors Agentry's connectors and this deployment's public client ids.
// (GET /connectors)
GetConnectors(w http.ResponseWriter, r *http.Request)
// SetFindingVerdict Confirm or dismiss a finding (not on the caller's own version, unless platform staff).
// (POST /findings/{id}/verdict)
SetFindingVerdict(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
// GetInvitation Read an invitation by its token (session only). Says which organization and role it offers and whether the signed-in account may accept it.
// (GET /invitations/{token})
GetInvitation(w http.ResponseWriter, r *http.Request, token string)
// AcceptInvitation Accept an invitation (session only). Refused unless the session's verified email is the invited address; single use.
// (POST /invitations/{token})
AcceptInvitation(w http.ResponseWriter, r *http.Request, token string)
// UnwrapKnowledgeKey Unwrap a data key wrapped for the caller; refused for anyone else's.
// (POST /knowledge/keys/unwrap)
UnwrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
// WrapKnowledgeKey Wrap a pack's data key for the caller.
// (POST /knowledge/keys/wrap)
WrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
// ListKnowledgePacks The caller's knowledge packs, by name.
// (GET /knowledge/packs)
ListKnowledgePacks(w http.ResponseWriter, r *http.Request)
// CreateKnowledgePack Create a knowledge pack, empty, with its data key as the caller's wrapper wrapped it.
// (POST /knowledge/packs)
CreateKnowledgePack(w http.ResponseWriter, r *http.Request)
// DeleteKnowledgePack Delete one of the caller's packs, its stored trees and its wrapped key.
// (DELETE /knowledge/packs/{packId})
DeleteKnowledgePack(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
// GetKnowledgePack One of the caller's packs with its scan report; 404 to anyone else.
// (GET /knowledge/packs/{packId})
GetKnowledgePack(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
// ExportKnowledgePack The pack's tree, decrypted as it streams, to its owner alone.
// (GET /knowledge/packs/{packId}/export)
ExportKnowledgePack(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
// DownloadKnowledgeTree The pack's sealed tree, as stored; the client opens it with the unwrapped data key (409 `knowledge-scanning` while it is scanned).
// (GET /knowledge/packs/{packId}/tree)
DownloadKnowledgeTree(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
// UploadKnowledgeTree Upload a pack's sealed tree, which replaces the one before and is scanned.
// (PUT /knowledge/packs/{packId}/tree)
UploadKnowledgeTree(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
// GetKnowledgeUsage What the caller keeps in the registry against their allocation.
// (GET /knowledge/usage)
GetKnowledgeUsage(w http.ResponseWriter, r *http.Request)
// GetMcpServerScan The registry's last vulnerability check of one MCP server package version.
// (GET /mcp-servers/scan)
GetMcpServerScan(w http.ResponseWriter, r *http.Request, params GetMcpServerScanParams)
// GetMeta Server version and self-host feature flags.
// (GET /meta)
GetMeta(w http.ResponseWriter, r *http.Request)
// CheckDraft AI Review of a finished draft before it is submitted.
// (POST /model-input/check)
CheckDraft(w http.ResponseWriter, r *http.Request)
// ScanModelInput AI Review of text a model is about to read.
// (POST /model-input/scan)
ScanModelInput(w http.ResponseWriter, r *http.Request)
// SearchModelInput Web search through the deployment's provider, every result scanned.
// (POST /model-input/search)
SearchModelInput(w http.ResponseWriter, r *http.Request)
// CreateOrg Create an organization; the caller becomes its first admin.
// (POST /orgs)
CreateOrg(w http.ResponseWriter, r *http.Request)
// GetOrg Organization profile (public fields; settings for admins).
// (GET /orgs/{org})
GetOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
// UpdateOrg Update org settings (admin+).
// (PATCH /orgs/{org})
UpdateOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
// ListOrgAudit Org audit events, newest first (admin+; cursor paged).
// (GET /orgs/{org}/audit)
ListOrgAudit(w http.ResponseWriter, r *http.Request, org OrgHandle, params ListOrgAuditParams)
// CreateAuditExport Start an async NDJSON audit export (admin+).
// (POST /orgs/{org}/audit/exports)
CreateAuditExport(w http.ResponseWriter, r *http.Request, org OrgHandle)
// GetAuditExport Poll an audit export's status and download reference (admin+).
// (GET /orgs/{org}/audit/exports/{id})
GetAuditExport(w http.ResponseWriter, r *http.Request, org OrgHandle, id openapi_types.UUID)
// DecommissionOrg Decommission the organization (admin; session only). It enters a read-only hold — members keep read and export — and at the end of the hold its agents, repositories, blobs and invitations are erased, its handle and domain released. The body must repeat the organization's handle. The last admin goes with it: this is the one way an organization loses its last admin (409 last-admin everywhere else).
// (POST /orgs/{org}/decommission)
DecommissionOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
// ListDomainClaims List domain claims (admin+).
// (GET /orgs/{org}/domain-claims)
ListDomainClaims(w http.ResponseWriter, r *http.Request, org OrgHandle)
// CreateDomainClaim Start a domain claim; returns the DNS TXT challenge (admin+).
// (POST /orgs/{org}/domain-claims)
CreateDomainClaim(w http.ResponseWriter, r *http.Request, org OrgHandle)
// VerifyDomainClaim Check the DNS TXT record and mark verified (admin+).
// (POST /orgs/{org}/domain-claims/verify)
VerifyDomainClaim(w http.ResponseWriter, r *http.Request, org OrgHandle)
// ListInvitations List the organization's open invitations (admin).
// (GET /orgs/{org}/invitations)
ListInvitations(w http.ResponseWriter, r *http.Request, org OrgHandle)
// CreateInvitation Invite someone by email (admin). The invitation reserves a seat when it is sent and expires in seven days. Its token is a credential shown once in this response and stored only as a hash. It is also mailed to the address when the registry may write there: an address at the organization's own verified domain always, and any other address only when it belongs to an account whose address the registry has confirmed. Accepting an invitation sent to the organization's verified domain also confirms the accepting account's address, because the organization proved it controls that domain.
// (POST /orgs/{org}/invitations)
CreateInvitation(w http.ResponseWriter, r *http.Request, org OrgHandle)
// RevokeInvitation Revoke an open invitation (admin); its seat is released.
// (DELETE /orgs/{org}/invitations/{id})
RevokeInvitation(w http.ResponseWriter, r *http.Request, org OrgHandle, id openapi_types.UUID)
// UnwrapOrgKnowledgeKey Unwrap a data key wrapped for the organization, for any active member; refused once they are not one.
// (POST /orgs/{org}/knowledge/keys/unwrap)
UnwrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request, org OrgHandle)
// WrapOrgKnowledgeKey Wrap a data key for the organization (admins).
// (POST /orgs/{org}/knowledge/keys/wrap)
WrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request, org OrgHandle)
// ListOrgKnowledgePacks The organization's shared packs, by name, for any active member.
// (GET /orgs/{org}/knowledge/packs)
ListOrgKnowledgePacks(w http.ResponseWriter, r *http.Request, org OrgHandle)
// CreateOrgKnowledgePack Create a shared pack, empty, with its data key wrapped for the organization (admins).
// (POST /orgs/{org}/knowledge/packs)
CreateOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle)
// DeleteOrgKnowledgePack Delete a shared pack, its stored trees and its wrapped key (admins).
// (DELETE /orgs/{org}/knowledge/packs/{packId})
DeleteOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
// GetOrgKnowledgePack One of the organization's shared packs with its scan report.
// (GET /orgs/{org}/knowledge/packs/{packId})
GetOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
// UpdateOrgKnowledgePack Mark a shared pack exportable by the organization's members, or not (admins).
// (PATCH /orgs/{org}/knowledge/packs/{packId})
UpdateOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
// ExportOrgKnowledgePack A shared pack's tree, decrypted as it streams, to an admin, or to a member once the pack is marked exportable.
// (GET /orgs/{org}/knowledge/packs/{packId}/export)
ExportOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
// DownloadOrgKnowledgeTree A shared pack's sealed tree, as stored, for any active member (409 `knowledge-scanning` while it is scanned).
// (GET /orgs/{org}/knowledge/packs/{packId}/tree)
DownloadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
// UploadOrgKnowledgeTree Upload a shared pack's sealed tree, which replaces the one before and is scanned (admins).
// (PUT /orgs/{org}/knowledge/packs/{packId}/tree)
UploadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
// GetOrgKnowledgeUsage What the organization keeps in the registry against the allocation its packs draw on.
// (GET /orgs/{org}/knowledge/usage)
GetOrgKnowledgeUsage(w http.ResponseWriter, r *http.Request, org OrgHandle)
// DeleteOrgLogo Remove the organization's logo (admin).
// (DELETE /orgs/{org}/logo)
DeleteOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)
// GetOrgLogo The organization's logo, as this registry re-encoded it.
// (GET /orgs/{org}/logo)
GetOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)
// PutOrgLogo Set the organization's logo (admin; the subscription must include branding).
// (PUT /orgs/{org}/logo)
PutOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)
// ListOrgMembers List members with roles (members can view).
// (GET /orgs/{org}/members)
ListOrgMembers(w http.ResponseWriter, r *http.Request, org OrgHandle)
// RemoveOrgMember Remove a member (admin), or leave: any active member may remove themselves, since a person belongs to one organization at a time and must be able to leave it. Removing a pending member is how an admin declines them; the last admin cannot be removed or leave (409 last-admin) — only a decommission removes them.
// (DELETE /orgs/{org}/members/{handle})
RemoveOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
// SetOrgMember Change a member's role (admin). This route does not add members: an organization is joined by accepting an invitation, or by an admin approving someone the IdP provisioned, and a PUT for a handle that holds no membership answers 422 naming those doors.
// (PUT /orgs/{org}/members/{handle})
SetOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
// ApproveOrgMember Approve a pending member (admin). The seat check fires here: a person provisioned by the organization's identity provider, or folded in from the organization's domain, holds no seat until an admin approves them.
// (POST /orgs/{org}/members/{handle}/approve)
ApproveOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
// DeclineOrgMember Decline a pending member (admin): the pending membership is removed and no seat is consumed. An active member is removed with DELETE instead.
// (POST /orgs/{org}/members/{handle}/decline)
DeclineOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
// GetOrgPolicy The org policy overlay (admin+).
// (GET /orgs/{org}/policy)
GetOrgPolicy(w http.ResponseWriter, r *http.Request, org OrgHandle)
// SetOrgPolicy Set the org policy overlay (admin; tighten-only).
// (PUT /orgs/{org}/policy)
SetOrgPolicy(w http.ResponseWriter, r *http.Request, org OrgHandle)
// ReinstateOrg Reinstate a suspended organization, or cancel a decommission hold before its erasure runs (platform staff). An organization already erased cannot come back (409).
// (POST /orgs/{org}/reinstate)
ReinstateOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
// SuspendOrg Suspend the organization (platform staff). It and everything under it answer 404 to everyone, over the API and over git, until it is reinstated. Nothing is deleted.
// (POST /orgs/{org}/suspend)
SuspendOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
// ListTeams List teams (members can view).
// (GET /orgs/{org}/teams)
ListTeams(w http.ResponseWriter, r *http.Request, org OrgHandle)
// CreateTeam Create a team (admin+).
// (POST /orgs/{org}/teams)
CreateTeam(w http.ResponseWriter, r *http.Request, org OrgHandle)
// DeleteTeam Delete a team (admin+).
// (DELETE /orgs/{org}/teams/{team})
DeleteTeam(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)
// ListTeamMembers List team members (org members can view).
// (GET /orgs/{org}/teams/{team}/members)
ListTeamMembers(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)
// RemoveTeamMember Remove a member from a team (admin+).
// (DELETE /orgs/{org}/teams/{team}/members/{handle})
RemoveTeamMember(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug, handle Handle)
// AddTeamMember Add an org member to a team (admin+).
// (PUT /orgs/{org}/teams/{team}/members/{handle})
AddTeamMember(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug, handle Handle)
// ListWebhooks List webhook endpoints (admin+).
// (GET /orgs/{org}/webhooks)
ListWebhooks(w http.ResponseWriter, r *http.Request, org OrgHandle)
// CreateWebhook Create a webhook endpoint (admin+).
// (POST /orgs/{org}/webhooks)
CreateWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle)
// DeleteWebhook Delete a webhook endpoint (admin+).
// (DELETE /orgs/{org}/webhooks/{id})
DeleteWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
// GetWebhook Get a webhook endpoint (admin+).
// (GET /orgs/{org}/webhooks/{id})
GetWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
// UpdateWebhook Update a webhook endpoint (admin+).
// (PATCH /orgs/{org}/webhooks/{id})
UpdateWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
// ListWebhookDeliveries Recent delivery attempts for an endpoint (admin+).
// (GET /orgs/{org}/webhooks/{id}/deliveries)
ListWebhookDeliveries(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID, params ListWebhookDeliveriesParams)
// PingWebhook Send a test delivery to an endpoint (admin+).
// (POST /orgs/{org}/webhooks/{id}/ping)
PingWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
// ListAbuseReports Abuse reports for triage (platform staff).
// (GET /platform/abuse-reports)
ListAbuseReports(w http.ResponseWriter, r *http.Request, params ListAbuseReportsParams)
// TriageAbuseReport Record a triage outcome for an abuse report (platform staff).
// (POST /platform/abuse-reports/{id})
TriageAbuseReport(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
// PlatformAgentAction Quarantine, block, or reinstate an agent (platform staff).
// (POST /platform/agents/{ns}/{name}/{action})
PlatformAgentAction(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, action PlatformAgentActionParamsAction)
// ListPlatformAudit Audit events across every org (platform staff).
// (GET /platform/audit)
ListPlatformAudit(w http.ResponseWriter, r *http.Request, params ListPlatformAuditParams)
// ListKnowledgePackSizes An account's or an organization's packs by name and size, for support (platform staff).
// (GET /platform/knowledge)
ListKnowledgePackSizes(w http.ResponseWriter, r *http.Request, params ListKnowledgePackSizesParams)
// GetPlatformPolicy The read-only platform baseline policy.
// (GET /platform/policy)
GetPlatformPolicy(w http.ResponseWriter, r *http.Request)
// ListRedTeamReports Reports of the scheduled red-team job against the S3/S4 gate (platform staff).
// (GET /platform/redteam/reports)
ListRedTeamReports(w http.ResponseWriter, r *http.Request, params ListRedTeamReportsParams)
// ListRulesetReleases Ruleset releases, newest first (platform staff).
// (GET /platform/ruleset-releases)
ListRulesetReleases(w http.ResponseWriter, r *http.Request)
// CreateRulesetRelease Register a ruleset release (platform staff).
// (POST /platform/ruleset-releases)
CreateRulesetRelease(w http.ResponseWriter, r *http.Request)
// ResolveRef Resolve ns/name@range to a concrete version.
// (GET /resolve)
ResolveRef(w http.ResponseWriter, r *http.Request, params ResolveRefParams)
// GetReviewItem One review item with its findings bundle.
// (GET /review-items/{id})
GetReviewItem(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
// DecideReviewItem Approve or reject a version under review (not its author, unless platform staff).
// (POST /review-items/{id}/decision)
DecideReviewItem(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
// GetReviewFile One file's content from the archive under review (reviewer/staff).
// (GET /review-items/{id}/file)
GetReviewFile(w http.ResponseWriter, r *http.Request, id openapi_types.UUID, params GetReviewFileParams)
// ListReviewFiles File inventory of the archive under review (reviewer/staff).
// (GET /review-items/{id}/files)
ListReviewFiles(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
// ListReviewQueue Pending review items (platform staff, or an org's security_reviewer for its queue).
// (GET /review-queue)
ListReviewQueue(w http.ResponseWriter, r *http.Request, params ListReviewQueueParams)
// GetLatestRulesetAttestation DSSE attestation over the bundle `…/latest/bundle` serves.
// (GET /ruleset-releases/latest/attestation)
GetLatestRulesetAttestation(w http.ResponseWriter, r *http.Request)
// GetLatestRulesetBundle The newest published S3/S4 rule bundle, for `agentry validate --rules-update`.
// (GET /ruleset-releases/latest/bundle)
GetLatestRulesetBundle(w http.ResponseWriter, r *http.Request)
// SearchAgents Full-text search over public agents with facets.
// (GET /search)
SearchAgents(w http.ResponseWriter, r *http.Request, params SearchAgentsParams)
// ListAgentsByTag Public agents tagged with {tag}.
// (GET /tags/{tag})
ListAgentsByTag(w http.ResponseWriter, r *http.Request, tag string, params ListAgentsByTagParams)
// GetCurrentUser The authenticated user.
// (GET /user)
GetCurrentUser(w http.ResponseWriter, r *http.Request)
// UpdateCurrentUser Update profile fields.
// (PATCH /user)
UpdateCurrentUser(w http.ResponseWriter, r *http.Request)
// ListUserActivity The caller's own activity — the audit events they performed.
// (GET /user/activity)
ListUserActivity(w http.ResponseWriter, r *http.Request, params ListUserActivityParams)
// ClearCurrentUserData Clear the caller's credentials, installs and settings, and keep the account (session only).
// (POST /user/clear-data)
ClearCurrentUserData(w http.ResponseWriter, r *http.Request)
// DeleteCurrentUser Erase the caller's account (GDPR flow).
// (POST /user/delete)
DeleteCurrentUser(w http.ResponseWriter, r *http.Request, params DeleteCurrentUserParams)
// ListUserDependencyAlerts Open dependency alerts on published versions the caller submitted.
// (GET /user/dependency-alerts)
ListUserDependencyAlerts(w http.ResponseWriter, r *http.Request)
// GetDomainOrg Which organization the caller's verified email domain belongs to. 403 email-unverified until the address is verified.
// (GET /user/domain-org)
GetDomainOrg(w http.ResponseWriter, r *http.Request)
// RequestDomainOrgAccess Ask the administrators of the organization that holds the caller's email domain to add them (session only). Mails the admins, once a day per person (429 rate-limited afterwards), audited as `org.access_request`. 404 when no organization holds the domain; 409 when the caller is already a member there.
// (POST /user/domain-org/request-access)
RequestDomainOrgAccess(w http.ResponseWriter, r *http.Request)
// SendEmailVerification Send the caller a new activation link.
// (POST /user/email-verification)
SendEmailVerification(w http.ResponseWriter, r *http.Request)
// ListAccountInstalls The caller's account installs, composed for a list.
// (GET /user/installs)
ListAccountInstalls(w http.ResponseWriter, r *http.Request)
// DeleteAccountInstall Remove the caller's record for a QuickAgent (idempotent).
// (DELETE /user/installs/{ns}/{name})
DeleteAccountInstall(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// PutAccountInstall Record a QuickAgent release as installed to the account, or move the record to another version.
// (PUT /user/installs/{ns}/{name})
PutAccountInstall(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// GetUserNotificationSettings How the registry's alerts reach the caller.
// (GET /user/notifications)
GetUserNotificationSettings(w http.ResponseWriter, r *http.Request)
// UpdateUserNotificationSettings Replace the caller's notification settings.
// (PUT /user/notifications)
UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)
// GetUserReportSettings The report design the caller's PDF reports take.
// (GET /user/report-settings)
GetUserReportSettings(w http.ResponseWriter, r *http.Request, params GetUserReportSettingsParams)
// UpdateUserReportSettings Replace the caller's report settings.
// (PUT /user/report-settings)
UpdateUserReportSettings(w http.ResponseWriter, r *http.Request, params UpdateUserReportSettingsParams)
// DeleteUserReportLogo Remove the logo from the caller's report design.
// (DELETE /user/report-settings/logo)
DeleteUserReportLogo(w http.ResponseWriter, r *http.Request)
// PutUserReportLogo Set the logo of the caller's report design.
// (PUT /user/report-settings/logo)
PutUserReportLogo(w http.ResponseWriter, r *http.Request)
// RevokeOtherUserSessions Revoke every session except the calling one ("sign out everywhere else").
// (DELETE /user/sessions)
RevokeOtherUserSessions(w http.ResponseWriter, r *http.Request)
// ListUserSessions List the caller's active browser sessions.
// (GET /user/sessions)
ListUserSessions(w http.ResponseWriter, r *http.Request)
// RevokeUserSession Revoke one of the caller's own sessions.
// (DELETE /user/sessions/{sessionId})
RevokeUserSession(w http.ResponseWriter, r *http.Request, sessionId openapi_types.UUID)
// ListSshKeys List the caller's SSH public keys for the git transport.
// (GET /user/ssh-keys)
ListSshKeys(w http.ResponseWriter, r *http.Request)
// AddSshKey Register an SSH public key for ssh://git@…/{ns}/{name}.git (session-only).
// (POST /user/ssh-keys)
AddSshKey(w http.ResponseWriter, r *http.Request)
// RemoveSshKey Remove an SSH public key (session-only).
// (DELETE /user/ssh-keys/{keyId})
RemoveSshKey(w http.ResponseWriter, r *http.Request, keyId openapi_types.UUID)
// UnstarAgent Remove a star (idempotent).
// (DELETE /user/stars/{ns}/{name})
UnstarAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// StarAgent Star an agent (idempotent).
// (PUT /user/stars/{ns}/{name})
StarAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
// ListTokens List the caller's personal access tokens (metadata only).
// (GET /user/tokens)
ListTokens(w http.ResponseWriter, r *http.Request)
// CreateToken Mint a PAT. The secret is returned exactly once.
// (POST /user/tokens)
CreateToken(w http.ResponseWriter, r *http.Request)
// CreateDesktopGrant Record a one-time grant for the desktop app's browser sign-in.
// (POST /user/tokens/desktop-grant)
CreateDesktopGrant(w http.ResponseWriter, r *http.Request)
// RevokeToken Revoke a PAT immediately.
// (DELETE /user/tokens/{tokenId})
RevokeToken(w http.ResponseWriter, r *http.Request, tokenId openapi_types.UUID)
// ClearTrustedDevices Clear every remembered browser of the caller's account.
// (DELETE /user/trusted-devices)
ClearTrustedDevices(w http.ResponseWriter, r *http.Request)
// CountTrustedDevices How many browsers skip the caller's second factor.
// (GET /user/trusted-devices)
CountTrustedDevices(w http.ResponseWriter, r *http.Request)
// GetUserProfile Public profile for a user handle.
// (GET /users/{handle})
GetUserProfile(w http.ResponseWriter, r *http.Request, handle Handle)
// DeleteVoice Delete the caller's voice, every version of it and its data key.
// (DELETE /voice)
DeleteVoice(w http.ResponseWriter, r *http.Request)
// GetVoice The caller's Writing Voice, every version's text with its review.
// (GET /voice)
GetVoice(w http.ResponseWriter, r *http.Request)
// PutVoice Put a new version of the caller's voice, to be reviewed before it is live.
// (PUT /voice)
PutVoice(w http.ResponseWriter, r *http.Request)
// DiscardVoicePending Drop the caller's pending version, in review or flagged.
// (DELETE /voice/pending)
DiscardVoicePending(w http.ResponseWriter, r *http.Request)
// RestoreVoice Put the previous version back.
// (POST /voice/restore)
RestoreVoice(w http.ResponseWriter, r *http.Request)
// UpdateVoiceSettings Set whether runs In Agentry attach the caller's live voice by default.
// (PUT /voice/settings)
UpdateVoiceSettings(w http.ResponseWriter, r *http.Request)
}
ServerInterface represents all server handlers.
type ServerInterfaceWrapper ¶
type ServerInterfaceWrapper struct {
Handler ServerInterface
HandlerMiddlewares []MiddlewareFunc
ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}
ServerInterfaceWrapper converts contexts to parameters.
func (*ServerInterfaceWrapper) AcceptInvitation ¶
func (siw *ServerInterfaceWrapper) AcceptInvitation(w http.ResponseWriter, r *http.Request)
AcceptInvitation operation middleware
func (*ServerInterfaceWrapper) AddSshKey ¶
func (siw *ServerInterfaceWrapper) AddSshKey(w http.ResponseWriter, r *http.Request)
AddSshKey operation middleware
func (*ServerInterfaceWrapper) AddTeamMember ¶
func (siw *ServerInterfaceWrapper) AddTeamMember(w http.ResponseWriter, r *http.Request)
AddTeamMember operation middleware
func (*ServerInterfaceWrapper) ApproveOrgMember ¶
func (siw *ServerInterfaceWrapper) ApproveOrgMember(w http.ResponseWriter, r *http.Request)
ApproveOrgMember operation middleware
func (*ServerInterfaceWrapper) CheckDraft ¶
func (siw *ServerInterfaceWrapper) CheckDraft(w http.ResponseWriter, r *http.Request)
CheckDraft operation middleware
func (*ServerInterfaceWrapper) ClearCurrentUserData ¶
func (siw *ServerInterfaceWrapper) ClearCurrentUserData(w http.ResponseWriter, r *http.Request)
ClearCurrentUserData operation middleware
func (*ServerInterfaceWrapper) ClearTrustedDevices ¶
func (siw *ServerInterfaceWrapper) ClearTrustedDevices(w http.ResponseWriter, r *http.Request)
ClearTrustedDevices operation middleware
func (*ServerInterfaceWrapper) CountTrustedDevices ¶
func (siw *ServerInterfaceWrapper) CountTrustedDevices(w http.ResponseWriter, r *http.Request)
CountTrustedDevices operation middleware
func (*ServerInterfaceWrapper) CreateAgent ¶
func (siw *ServerInterfaceWrapper) CreateAgent(w http.ResponseWriter, r *http.Request)
CreateAgent operation middleware
func (*ServerInterfaceWrapper) CreateAuditExport ¶
func (siw *ServerInterfaceWrapper) CreateAuditExport(w http.ResponseWriter, r *http.Request)
CreateAuditExport operation middleware
func (*ServerInterfaceWrapper) CreateDesktopGrant ¶
func (siw *ServerInterfaceWrapper) CreateDesktopGrant(w http.ResponseWriter, r *http.Request)
CreateDesktopGrant operation middleware
func (*ServerInterfaceWrapper) CreateDomainClaim ¶
func (siw *ServerInterfaceWrapper) CreateDomainClaim(w http.ResponseWriter, r *http.Request)
CreateDomainClaim operation middleware
func (*ServerInterfaceWrapper) CreateInvitation ¶
func (siw *ServerInterfaceWrapper) CreateInvitation(w http.ResponseWriter, r *http.Request)
CreateInvitation operation middleware
func (*ServerInterfaceWrapper) CreateKnowledgePack ¶
func (siw *ServerInterfaceWrapper) CreateKnowledgePack(w http.ResponseWriter, r *http.Request)
CreateKnowledgePack operation middleware
func (*ServerInterfaceWrapper) CreateOrg ¶
func (siw *ServerInterfaceWrapper) CreateOrg(w http.ResponseWriter, r *http.Request)
CreateOrg operation middleware
func (*ServerInterfaceWrapper) CreateOrgKnowledgePack ¶
func (siw *ServerInterfaceWrapper) CreateOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
CreateOrgKnowledgePack operation middleware
func (*ServerInterfaceWrapper) CreateRulesetRelease ¶
func (siw *ServerInterfaceWrapper) CreateRulesetRelease(w http.ResponseWriter, r *http.Request)
CreateRulesetRelease operation middleware
func (*ServerInterfaceWrapper) CreateTeam ¶
func (siw *ServerInterfaceWrapper) CreateTeam(w http.ResponseWriter, r *http.Request)
CreateTeam operation middleware
func (*ServerInterfaceWrapper) CreateToken ¶
func (siw *ServerInterfaceWrapper) CreateToken(w http.ResponseWriter, r *http.Request)
CreateToken operation middleware
func (*ServerInterfaceWrapper) CreateWebhook ¶
func (siw *ServerInterfaceWrapper) CreateWebhook(w http.ResponseWriter, r *http.Request)
CreateWebhook operation middleware
func (*ServerInterfaceWrapper) DecideReviewItem ¶
func (siw *ServerInterfaceWrapper) DecideReviewItem(w http.ResponseWriter, r *http.Request)
DecideReviewItem operation middleware
func (*ServerInterfaceWrapper) DeclineOrgMember ¶
func (siw *ServerInterfaceWrapper) DeclineOrgMember(w http.ResponseWriter, r *http.Request)
DeclineOrgMember operation middleware
func (*ServerInterfaceWrapper) DecommissionOrg ¶
func (siw *ServerInterfaceWrapper) DecommissionOrg(w http.ResponseWriter, r *http.Request)
DecommissionOrg operation middleware
func (*ServerInterfaceWrapper) DeleteAccountInstall ¶
func (siw *ServerInterfaceWrapper) DeleteAccountInstall(w http.ResponseWriter, r *http.Request)
DeleteAccountInstall operation middleware
func (*ServerInterfaceWrapper) DeleteAgent ¶
func (siw *ServerInterfaceWrapper) DeleteAgent(w http.ResponseWriter, r *http.Request)
DeleteAgent operation middleware
func (*ServerInterfaceWrapper) DeleteCurrentUser ¶
func (siw *ServerInterfaceWrapper) DeleteCurrentUser(w http.ResponseWriter, r *http.Request)
DeleteCurrentUser operation middleware
func (*ServerInterfaceWrapper) DeleteKnowledgePack ¶
func (siw *ServerInterfaceWrapper) DeleteKnowledgePack(w http.ResponseWriter, r *http.Request)
DeleteKnowledgePack operation middleware
func (*ServerInterfaceWrapper) DeleteOrgKnowledgePack ¶
func (siw *ServerInterfaceWrapper) DeleteOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
DeleteOrgKnowledgePack operation middleware
func (*ServerInterfaceWrapper) DeleteOrgLogo ¶
func (siw *ServerInterfaceWrapper) DeleteOrgLogo(w http.ResponseWriter, r *http.Request)
DeleteOrgLogo operation middleware
func (*ServerInterfaceWrapper) DeleteTeam ¶
func (siw *ServerInterfaceWrapper) DeleteTeam(w http.ResponseWriter, r *http.Request)
DeleteTeam operation middleware
func (*ServerInterfaceWrapper) DeleteUserReportLogo ¶
func (siw *ServerInterfaceWrapper) DeleteUserReportLogo(w http.ResponseWriter, r *http.Request)
DeleteUserReportLogo operation middleware
func (*ServerInterfaceWrapper) DeleteVoice ¶
func (siw *ServerInterfaceWrapper) DeleteVoice(w http.ResponseWriter, r *http.Request)
DeleteVoice operation middleware
func (*ServerInterfaceWrapper) DeleteWebhook ¶
func (siw *ServerInterfaceWrapper) DeleteWebhook(w http.ResponseWriter, r *http.Request)
DeleteWebhook operation middleware
func (*ServerInterfaceWrapper) DiscardVoicePending ¶
func (siw *ServerInterfaceWrapper) DiscardVoicePending(w http.ResponseWriter, r *http.Request)
DiscardVoicePending operation middleware
func (*ServerInterfaceWrapper) DownloadKnowledgeTree ¶
func (siw *ServerInterfaceWrapper) DownloadKnowledgeTree(w http.ResponseWriter, r *http.Request)
DownloadKnowledgeTree operation middleware
func (*ServerInterfaceWrapper) DownloadOrgKnowledgeTree ¶
func (siw *ServerInterfaceWrapper) DownloadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request)
DownloadOrgKnowledgeTree operation middleware
func (*ServerInterfaceWrapper) DownloadVersion ¶
func (siw *ServerInterfaceWrapper) DownloadVersion(w http.ResponseWriter, r *http.Request)
DownloadVersion operation middleware
func (*ServerInterfaceWrapper) ExchangeDesktopCode ¶
func (siw *ServerInterfaceWrapper) ExchangeDesktopCode(w http.ResponseWriter, r *http.Request)
ExchangeDesktopCode operation middleware
func (*ServerInterfaceWrapper) ExportKnowledgePack ¶
func (siw *ServerInterfaceWrapper) ExportKnowledgePack(w http.ResponseWriter, r *http.Request)
ExportKnowledgePack operation middleware
func (*ServerInterfaceWrapper) ExportOrgKnowledgePack ¶
func (siw *ServerInterfaceWrapper) ExportOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
ExportOrgKnowledgePack operation middleware
func (*ServerInterfaceWrapper) ForkAgent ¶
func (siw *ServerInterfaceWrapper) ForkAgent(w http.ResponseWriter, r *http.Request)
ForkAgent operation middleware
func (*ServerInterfaceWrapper) GetAdvisory ¶
func (siw *ServerInterfaceWrapper) GetAdvisory(w http.ResponseWriter, r *http.Request)
GetAdvisory operation middleware
func (*ServerInterfaceWrapper) GetAgent ¶
func (siw *ServerInterfaceWrapper) GetAgent(w http.ResponseWriter, r *http.Request)
GetAgent operation middleware
func (*ServerInterfaceWrapper) GetAgentReadme ¶
func (siw *ServerInterfaceWrapper) GetAgentReadme(w http.ResponseWriter, r *http.Request)
GetAgentReadme operation middleware
func (*ServerInterfaceWrapper) GetAgentStats ¶
func (siw *ServerInterfaceWrapper) GetAgentStats(w http.ResponseWriter, r *http.Request)
GetAgentStats operation middleware
func (*ServerInterfaceWrapper) GetAuditExport ¶
func (siw *ServerInterfaceWrapper) GetAuditExport(w http.ResponseWriter, r *http.Request)
GetAuditExport operation middleware
func (*ServerInterfaceWrapper) GetConnectors ¶
func (siw *ServerInterfaceWrapper) GetConnectors(w http.ResponseWriter, r *http.Request)
GetConnectors operation middleware
func (*ServerInterfaceWrapper) GetCurrentUser ¶
func (siw *ServerInterfaceWrapper) GetCurrentUser(w http.ResponseWriter, r *http.Request)
GetCurrentUser operation middleware
func (*ServerInterfaceWrapper) GetDomainOrg ¶
func (siw *ServerInterfaceWrapper) GetDomainOrg(w http.ResponseWriter, r *http.Request)
GetDomainOrg operation middleware
func (*ServerInterfaceWrapper) GetInvitation ¶
func (siw *ServerInterfaceWrapper) GetInvitation(w http.ResponseWriter, r *http.Request)
GetInvitation operation middleware
func (*ServerInterfaceWrapper) GetKnowledgePack ¶
func (siw *ServerInterfaceWrapper) GetKnowledgePack(w http.ResponseWriter, r *http.Request)
GetKnowledgePack operation middleware
func (*ServerInterfaceWrapper) GetKnowledgeUsage ¶
func (siw *ServerInterfaceWrapper) GetKnowledgeUsage(w http.ResponseWriter, r *http.Request)
GetKnowledgeUsage operation middleware
func (*ServerInterfaceWrapper) GetLatestRulesetAttestation ¶
func (siw *ServerInterfaceWrapper) GetLatestRulesetAttestation(w http.ResponseWriter, r *http.Request)
GetLatestRulesetAttestation operation middleware
func (*ServerInterfaceWrapper) GetLatestRulesetBundle ¶
func (siw *ServerInterfaceWrapper) GetLatestRulesetBundle(w http.ResponseWriter, r *http.Request)
GetLatestRulesetBundle operation middleware
func (*ServerInterfaceWrapper) GetMcpServerScan ¶
func (siw *ServerInterfaceWrapper) GetMcpServerScan(w http.ResponseWriter, r *http.Request)
GetMcpServerScan operation middleware
func (*ServerInterfaceWrapper) GetMeta ¶
func (siw *ServerInterfaceWrapper) GetMeta(w http.ResponseWriter, r *http.Request)
GetMeta operation middleware
func (*ServerInterfaceWrapper) GetOrg ¶
func (siw *ServerInterfaceWrapper) GetOrg(w http.ResponseWriter, r *http.Request)
GetOrg operation middleware
func (*ServerInterfaceWrapper) GetOrgKnowledgePack ¶
func (siw *ServerInterfaceWrapper) GetOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
GetOrgKnowledgePack operation middleware
func (*ServerInterfaceWrapper) GetOrgKnowledgeUsage ¶
func (siw *ServerInterfaceWrapper) GetOrgKnowledgeUsage(w http.ResponseWriter, r *http.Request)
GetOrgKnowledgeUsage operation middleware
func (*ServerInterfaceWrapper) GetOrgLogo ¶
func (siw *ServerInterfaceWrapper) GetOrgLogo(w http.ResponseWriter, r *http.Request)
GetOrgLogo operation middleware
func (*ServerInterfaceWrapper) GetOrgPolicy ¶
func (siw *ServerInterfaceWrapper) GetOrgPolicy(w http.ResponseWriter, r *http.Request)
GetOrgPolicy operation middleware
func (*ServerInterfaceWrapper) GetPlatformPolicy ¶
func (siw *ServerInterfaceWrapper) GetPlatformPolicy(w http.ResponseWriter, r *http.Request)
GetPlatformPolicy operation middleware
func (*ServerInterfaceWrapper) GetReviewFile ¶
func (siw *ServerInterfaceWrapper) GetReviewFile(w http.ResponseWriter, r *http.Request)
GetReviewFile operation middleware
func (*ServerInterfaceWrapper) GetReviewItem ¶
func (siw *ServerInterfaceWrapper) GetReviewItem(w http.ResponseWriter, r *http.Request)
GetReviewItem operation middleware
func (*ServerInterfaceWrapper) GetUserNotificationSettings ¶
func (siw *ServerInterfaceWrapper) GetUserNotificationSettings(w http.ResponseWriter, r *http.Request)
GetUserNotificationSettings operation middleware
func (*ServerInterfaceWrapper) GetUserProfile ¶
func (siw *ServerInterfaceWrapper) GetUserProfile(w http.ResponseWriter, r *http.Request)
GetUserProfile operation middleware
func (*ServerInterfaceWrapper) GetUserReportSettings ¶
func (siw *ServerInterfaceWrapper) GetUserReportSettings(w http.ResponseWriter, r *http.Request)
GetUserReportSettings operation middleware
func (*ServerInterfaceWrapper) GetVersionAttestation ¶
func (siw *ServerInterfaceWrapper) GetVersionAttestation(w http.ResponseWriter, r *http.Request)
GetVersionAttestation operation middleware
func (*ServerInterfaceWrapper) GetVersionFile ¶
func (siw *ServerInterfaceWrapper) GetVersionFile(w http.ResponseWriter, r *http.Request)
GetVersionFile operation middleware
func (*ServerInterfaceWrapper) GetVersionInfo ¶
func (siw *ServerInterfaceWrapper) GetVersionInfo(w http.ResponseWriter, r *http.Request)
GetVersionInfo operation middleware
func (*ServerInterfaceWrapper) GetVersionManifest ¶
func (siw *ServerInterfaceWrapper) GetVersionManifest(w http.ResponseWriter, r *http.Request)
GetVersionManifest operation middleware
func (*ServerInterfaceWrapper) GetVersionReport ¶
func (siw *ServerInterfaceWrapper) GetVersionReport(w http.ResponseWriter, r *http.Request)
GetVersionReport operation middleware
func (*ServerInterfaceWrapper) GetVoice ¶
func (siw *ServerInterfaceWrapper) GetVoice(w http.ResponseWriter, r *http.Request)
GetVoice operation middleware
func (*ServerInterfaceWrapper) GetWebhook ¶
func (siw *ServerInterfaceWrapper) GetWebhook(w http.ResponseWriter, r *http.Request)
GetWebhook operation middleware
func (*ServerInterfaceWrapper) ListAbuseReports ¶
func (siw *ServerInterfaceWrapper) ListAbuseReports(w http.ResponseWriter, r *http.Request)
ListAbuseReports operation middleware
func (*ServerInterfaceWrapper) ListAccountInstalls ¶
func (siw *ServerInterfaceWrapper) ListAccountInstalls(w http.ResponseWriter, r *http.Request)
ListAccountInstalls operation middleware
func (*ServerInterfaceWrapper) ListAdvisories ¶
func (siw *ServerInterfaceWrapper) ListAdvisories(w http.ResponseWriter, r *http.Request)
ListAdvisories operation middleware
func (*ServerInterfaceWrapper) ListAgentActivity ¶
func (siw *ServerInterfaceWrapper) ListAgentActivity(w http.ResponseWriter, r *http.Request)
ListAgentActivity operation middleware
func (*ServerInterfaceWrapper) ListAgentGrants ¶
func (siw *ServerInterfaceWrapper) ListAgentGrants(w http.ResponseWriter, r *http.Request)
ListAgentGrants operation middleware
func (*ServerInterfaceWrapper) ListAgents ¶
func (siw *ServerInterfaceWrapper) ListAgents(w http.ResponseWriter, r *http.Request)
ListAgents operation middleware
func (*ServerInterfaceWrapper) ListAgentsByTag ¶
func (siw *ServerInterfaceWrapper) ListAgentsByTag(w http.ResponseWriter, r *http.Request)
ListAgentsByTag operation middleware
func (*ServerInterfaceWrapper) ListDomainClaims ¶
func (siw *ServerInterfaceWrapper) ListDomainClaims(w http.ResponseWriter, r *http.Request)
ListDomainClaims operation middleware
func (*ServerInterfaceWrapper) ListInvitations ¶
func (siw *ServerInterfaceWrapper) ListInvitations(w http.ResponseWriter, r *http.Request)
ListInvitations operation middleware
func (*ServerInterfaceWrapper) ListKnowledgePackSizes ¶
func (siw *ServerInterfaceWrapper) ListKnowledgePackSizes(w http.ResponseWriter, r *http.Request)
ListKnowledgePackSizes operation middleware
func (*ServerInterfaceWrapper) ListKnowledgePacks ¶
func (siw *ServerInterfaceWrapper) ListKnowledgePacks(w http.ResponseWriter, r *http.Request)
ListKnowledgePacks operation middleware
func (*ServerInterfaceWrapper) ListOrgAudit ¶
func (siw *ServerInterfaceWrapper) ListOrgAudit(w http.ResponseWriter, r *http.Request)
ListOrgAudit operation middleware
func (*ServerInterfaceWrapper) ListOrgKnowledgePacks ¶
func (siw *ServerInterfaceWrapper) ListOrgKnowledgePacks(w http.ResponseWriter, r *http.Request)
ListOrgKnowledgePacks operation middleware
func (*ServerInterfaceWrapper) ListOrgMembers ¶
func (siw *ServerInterfaceWrapper) ListOrgMembers(w http.ResponseWriter, r *http.Request)
ListOrgMembers operation middleware
func (*ServerInterfaceWrapper) ListPlatformAudit ¶
func (siw *ServerInterfaceWrapper) ListPlatformAudit(w http.ResponseWriter, r *http.Request)
ListPlatformAudit operation middleware
func (*ServerInterfaceWrapper) ListRedTeamReports ¶
func (siw *ServerInterfaceWrapper) ListRedTeamReports(w http.ResponseWriter, r *http.Request)
ListRedTeamReports operation middleware
func (*ServerInterfaceWrapper) ListReviewFiles ¶
func (siw *ServerInterfaceWrapper) ListReviewFiles(w http.ResponseWriter, r *http.Request)
ListReviewFiles operation middleware
func (*ServerInterfaceWrapper) ListReviewQueue ¶
func (siw *ServerInterfaceWrapper) ListReviewQueue(w http.ResponseWriter, r *http.Request)
ListReviewQueue operation middleware
func (*ServerInterfaceWrapper) ListRulesetReleases ¶
func (siw *ServerInterfaceWrapper) ListRulesetReleases(w http.ResponseWriter, r *http.Request)
ListRulesetReleases operation middleware
func (*ServerInterfaceWrapper) ListSshKeys ¶
func (siw *ServerInterfaceWrapper) ListSshKeys(w http.ResponseWriter, r *http.Request)
ListSshKeys operation middleware
func (*ServerInterfaceWrapper) ListTeamMembers ¶
func (siw *ServerInterfaceWrapper) ListTeamMembers(w http.ResponseWriter, r *http.Request)
ListTeamMembers operation middleware
func (*ServerInterfaceWrapper) ListTeams ¶
func (siw *ServerInterfaceWrapper) ListTeams(w http.ResponseWriter, r *http.Request)
ListTeams operation middleware
func (*ServerInterfaceWrapper) ListTokens ¶
func (siw *ServerInterfaceWrapper) ListTokens(w http.ResponseWriter, r *http.Request)
ListTokens operation middleware
func (*ServerInterfaceWrapper) ListUserActivity ¶
func (siw *ServerInterfaceWrapper) ListUserActivity(w http.ResponseWriter, r *http.Request)
ListUserActivity operation middleware
func (*ServerInterfaceWrapper) ListUserDependencyAlerts ¶
func (siw *ServerInterfaceWrapper) ListUserDependencyAlerts(w http.ResponseWriter, r *http.Request)
ListUserDependencyAlerts operation middleware
func (*ServerInterfaceWrapper) ListUserSessions ¶
func (siw *ServerInterfaceWrapper) ListUserSessions(w http.ResponseWriter, r *http.Request)
ListUserSessions operation middleware
func (*ServerInterfaceWrapper) ListVersionFiles ¶
func (siw *ServerInterfaceWrapper) ListVersionFiles(w http.ResponseWriter, r *http.Request)
ListVersionFiles operation middleware
func (*ServerInterfaceWrapper) ListVersions ¶
func (siw *ServerInterfaceWrapper) ListVersions(w http.ResponseWriter, r *http.Request)
ListVersions operation middleware
func (*ServerInterfaceWrapper) ListWebhookDeliveries ¶
func (siw *ServerInterfaceWrapper) ListWebhookDeliveries(w http.ResponseWriter, r *http.Request)
ListWebhookDeliveries operation middleware
func (*ServerInterfaceWrapper) ListWebhooks ¶
func (siw *ServerInterfaceWrapper) ListWebhooks(w http.ResponseWriter, r *http.Request)
ListWebhooks operation middleware
func (*ServerInterfaceWrapper) Logout ¶
func (siw *ServerInterfaceWrapper) Logout(w http.ResponseWriter, r *http.Request)
Logout operation middleware
func (*ServerInterfaceWrapper) PingWebhook ¶
func (siw *ServerInterfaceWrapper) PingWebhook(w http.ResponseWriter, r *http.Request)
PingWebhook operation middleware
func (*ServerInterfaceWrapper) PlatformAgentAction ¶
func (siw *ServerInterfaceWrapper) PlatformAgentAction(w http.ResponseWriter, r *http.Request)
PlatformAgentAction operation middleware
func (*ServerInterfaceWrapper) PutAccountInstall ¶
func (siw *ServerInterfaceWrapper) PutAccountInstall(w http.ResponseWriter, r *http.Request)
PutAccountInstall operation middleware
func (*ServerInterfaceWrapper) PutOrgLogo ¶
func (siw *ServerInterfaceWrapper) PutOrgLogo(w http.ResponseWriter, r *http.Request)
PutOrgLogo operation middleware
func (*ServerInterfaceWrapper) PutUserReportLogo ¶
func (siw *ServerInterfaceWrapper) PutUserReportLogo(w http.ResponseWriter, r *http.Request)
PutUserReportLogo operation middleware
func (*ServerInterfaceWrapper) PutVoice ¶
func (siw *ServerInterfaceWrapper) PutVoice(w http.ResponseWriter, r *http.Request)
PutVoice operation middleware
func (*ServerInterfaceWrapper) ReinstateOrg ¶
func (siw *ServerInterfaceWrapper) ReinstateOrg(w http.ResponseWriter, r *http.Request)
ReinstateOrg operation middleware
func (*ServerInterfaceWrapper) RemoveAgentTeamGrant ¶
func (siw *ServerInterfaceWrapper) RemoveAgentTeamGrant(w http.ResponseWriter, r *http.Request)
RemoveAgentTeamGrant operation middleware
func (*ServerInterfaceWrapper) RemoveAgentUserGrant ¶
func (siw *ServerInterfaceWrapper) RemoveAgentUserGrant(w http.ResponseWriter, r *http.Request)
RemoveAgentUserGrant operation middleware
func (*ServerInterfaceWrapper) RemoveOrgMember ¶
func (siw *ServerInterfaceWrapper) RemoveOrgMember(w http.ResponseWriter, r *http.Request)
RemoveOrgMember operation middleware
func (*ServerInterfaceWrapper) RemoveSshKey ¶
func (siw *ServerInterfaceWrapper) RemoveSshKey(w http.ResponseWriter, r *http.Request)
RemoveSshKey operation middleware
func (*ServerInterfaceWrapper) RemoveTeamMember ¶
func (siw *ServerInterfaceWrapper) RemoveTeamMember(w http.ResponseWriter, r *http.Request)
RemoveTeamMember operation middleware
func (*ServerInterfaceWrapper) ReportAbuse ¶
func (siw *ServerInterfaceWrapper) ReportAbuse(w http.ResponseWriter, r *http.Request)
ReportAbuse operation middleware
func (*ServerInterfaceWrapper) RequestDomainOrgAccess ¶
func (siw *ServerInterfaceWrapper) RequestDomainOrgAccess(w http.ResponseWriter, r *http.Request)
RequestDomainOrgAccess operation middleware
func (*ServerInterfaceWrapper) ResolveRef ¶
func (siw *ServerInterfaceWrapper) ResolveRef(w http.ResponseWriter, r *http.Request)
ResolveRef operation middleware
func (*ServerInterfaceWrapper) RestoreAgent ¶
func (siw *ServerInterfaceWrapper) RestoreAgent(w http.ResponseWriter, r *http.Request)
RestoreAgent operation middleware
func (*ServerInterfaceWrapper) RestoreVoice ¶
func (siw *ServerInterfaceWrapper) RestoreVoice(w http.ResponseWriter, r *http.Request)
RestoreVoice operation middleware
func (*ServerInterfaceWrapper) RetireAgent ¶
func (siw *ServerInterfaceWrapper) RetireAgent(w http.ResponseWriter, r *http.Request)
RetireAgent operation middleware
func (*ServerInterfaceWrapper) RevokeInvitation ¶
func (siw *ServerInterfaceWrapper) RevokeInvitation(w http.ResponseWriter, r *http.Request)
RevokeInvitation operation middleware
func (*ServerInterfaceWrapper) RevokeOtherUserSessions ¶
func (siw *ServerInterfaceWrapper) RevokeOtherUserSessions(w http.ResponseWriter, r *http.Request)
RevokeOtherUserSessions operation middleware
func (*ServerInterfaceWrapper) RevokeToken ¶
func (siw *ServerInterfaceWrapper) RevokeToken(w http.ResponseWriter, r *http.Request)
RevokeToken operation middleware
func (*ServerInterfaceWrapper) RevokeUserSession ¶
func (siw *ServerInterfaceWrapper) RevokeUserSession(w http.ResponseWriter, r *http.Request)
RevokeUserSession operation middleware
func (*ServerInterfaceWrapper) ScanModelInput ¶
func (siw *ServerInterfaceWrapper) ScanModelInput(w http.ResponseWriter, r *http.Request)
ScanModelInput operation middleware
func (*ServerInterfaceWrapper) SearchAgents ¶
func (siw *ServerInterfaceWrapper) SearchAgents(w http.ResponseWriter, r *http.Request)
SearchAgents operation middleware
func (*ServerInterfaceWrapper) SearchModelInput ¶
func (siw *ServerInterfaceWrapper) SearchModelInput(w http.ResponseWriter, r *http.Request)
SearchModelInput operation middleware
func (*ServerInterfaceWrapper) SendEmailVerification ¶
func (siw *ServerInterfaceWrapper) SendEmailVerification(w http.ResponseWriter, r *http.Request)
SendEmailVerification operation middleware
func (*ServerInterfaceWrapper) SetAgentTeamGrant ¶
func (siw *ServerInterfaceWrapper) SetAgentTeamGrant(w http.ResponseWriter, r *http.Request)
SetAgentTeamGrant operation middleware
func (*ServerInterfaceWrapper) SetAgentUserGrant ¶
func (siw *ServerInterfaceWrapper) SetAgentUserGrant(w http.ResponseWriter, r *http.Request)
SetAgentUserGrant operation middleware
func (*ServerInterfaceWrapper) SetFindingVerdict ¶
func (siw *ServerInterfaceWrapper) SetFindingVerdict(w http.ResponseWriter, r *http.Request)
SetFindingVerdict operation middleware
func (*ServerInterfaceWrapper) SetOrgMember ¶
func (siw *ServerInterfaceWrapper) SetOrgMember(w http.ResponseWriter, r *http.Request)
SetOrgMember operation middleware
func (*ServerInterfaceWrapper) SetOrgPolicy ¶
func (siw *ServerInterfaceWrapper) SetOrgPolicy(w http.ResponseWriter, r *http.Request)
SetOrgPolicy operation middleware
func (*ServerInterfaceWrapper) SocialOidcCallback ¶
func (siw *ServerInterfaceWrapper) SocialOidcCallback(w http.ResponseWriter, r *http.Request)
SocialOidcCallback operation middleware
func (*ServerInterfaceWrapper) SocialOidcStart ¶
func (siw *ServerInterfaceWrapper) SocialOidcStart(w http.ResponseWriter, r *http.Request)
SocialOidcStart operation middleware
func (*ServerInterfaceWrapper) StarAgent ¶
func (siw *ServerInterfaceWrapper) StarAgent(w http.ResponseWriter, r *http.Request)
StarAgent operation middleware
func (*ServerInterfaceWrapper) StreamVersionEvents ¶
func (siw *ServerInterfaceWrapper) StreamVersionEvents(w http.ResponseWriter, r *http.Request)
StreamVersionEvents operation middleware
func (*ServerInterfaceWrapper) SubmitVersion ¶
func (siw *ServerInterfaceWrapper) SubmitVersion(w http.ResponseWriter, r *http.Request)
SubmitVersion operation middleware
func (*ServerInterfaceWrapper) SuspendOrg ¶
func (siw *ServerInterfaceWrapper) SuspendOrg(w http.ResponseWriter, r *http.Request)
SuspendOrg operation middleware
func (*ServerInterfaceWrapper) TriageAbuseReport ¶
func (siw *ServerInterfaceWrapper) TriageAbuseReport(w http.ResponseWriter, r *http.Request)
TriageAbuseReport operation middleware
func (*ServerInterfaceWrapper) UnstarAgent ¶
func (siw *ServerInterfaceWrapper) UnstarAgent(w http.ResponseWriter, r *http.Request)
UnstarAgent operation middleware
func (*ServerInterfaceWrapper) UnwrapKnowledgeKey ¶
func (siw *ServerInterfaceWrapper) UnwrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
UnwrapKnowledgeKey operation middleware
func (*ServerInterfaceWrapper) UnwrapOrgKnowledgeKey ¶
func (siw *ServerInterfaceWrapper) UnwrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request)
UnwrapOrgKnowledgeKey operation middleware
func (*ServerInterfaceWrapper) UpdateAgent ¶
func (siw *ServerInterfaceWrapper) UpdateAgent(w http.ResponseWriter, r *http.Request)
UpdateAgent operation middleware
func (*ServerInterfaceWrapper) UpdateCurrentUser ¶
func (siw *ServerInterfaceWrapper) UpdateCurrentUser(w http.ResponseWriter, r *http.Request)
UpdateCurrentUser operation middleware
func (*ServerInterfaceWrapper) UpdateOrg ¶
func (siw *ServerInterfaceWrapper) UpdateOrg(w http.ResponseWriter, r *http.Request)
UpdateOrg operation middleware
func (*ServerInterfaceWrapper) UpdateOrgKnowledgePack ¶
func (siw *ServerInterfaceWrapper) UpdateOrgKnowledgePack(w http.ResponseWriter, r *http.Request)
UpdateOrgKnowledgePack operation middleware
func (*ServerInterfaceWrapper) UpdateUserNotificationSettings ¶
func (siw *ServerInterfaceWrapper) UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)
UpdateUserNotificationSettings operation middleware
func (*ServerInterfaceWrapper) UpdateUserReportSettings ¶
func (siw *ServerInterfaceWrapper) UpdateUserReportSettings(w http.ResponseWriter, r *http.Request)
UpdateUserReportSettings operation middleware
func (*ServerInterfaceWrapper) UpdateVoiceSettings ¶
func (siw *ServerInterfaceWrapper) UpdateVoiceSettings(w http.ResponseWriter, r *http.Request)
UpdateVoiceSettings operation middleware
func (*ServerInterfaceWrapper) UpdateWebhook ¶
func (siw *ServerInterfaceWrapper) UpdateWebhook(w http.ResponseWriter, r *http.Request)
UpdateWebhook operation middleware
func (*ServerInterfaceWrapper) UploadKnowledgeTree ¶
func (siw *ServerInterfaceWrapper) UploadKnowledgeTree(w http.ResponseWriter, r *http.Request)
UploadKnowledgeTree operation middleware
func (*ServerInterfaceWrapper) UploadOrgKnowledgeTree ¶
func (siw *ServerInterfaceWrapper) UploadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request)
UploadOrgKnowledgeTree operation middleware
func (*ServerInterfaceWrapper) VerifyDomainClaim ¶
func (siw *ServerInterfaceWrapper) VerifyDomainClaim(w http.ResponseWriter, r *http.Request)
VerifyDomainClaim operation middleware
func (*ServerInterfaceWrapper) VerifyEmail ¶
func (siw *ServerInterfaceWrapper) VerifyEmail(w http.ResponseWriter, r *http.Request)
VerifyEmail operation middleware
func (*ServerInterfaceWrapper) WrapKnowledgeKey ¶
func (siw *ServerInterfaceWrapper) WrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
WrapKnowledgeKey operation middleware
func (*ServerInterfaceWrapper) WrapOrgKnowledgeKey ¶
func (siw *ServerInterfaceWrapper) WrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request)
WrapOrgKnowledgeKey operation middleware
func (*ServerInterfaceWrapper) YankVersion ¶
func (siw *ServerInterfaceWrapper) YankVersion(w http.ResponseWriter, r *http.Request)
YankVersion operation middleware
type SessionInfo ¶
type SessionInfo struct {
CreatedAt time.Time `json:"createdAt"`
// Current True for the session making this request.
Current bool `json:"current"`
Id openapi_types.UUID `json:"id"`
// Ip Client address recorded at session creation.
Ip *string `json:"ip,omitempty"`
LastSeenAt time.Time `json:"lastSeenAt"`
// UserAgent User-Agent recorded at session creation.
UserAgent *string `json:"userAgent,omitempty"`
}
SessionInfo defines model for SessionInfo.
type SessionList ¶
type SessionList struct {
Sessions []SessionInfo `json:"sessions"`
}
SessionList defines model for SessionList.
type SetAgentTeamGrantJSONBody ¶
type SetAgentTeamGrantJSONBody struct {
// Role Per-agent grant levels, read < write < maintain < publish.
Role AgentRole `json:"role"`
}
SetAgentTeamGrantJSONBody defines parameters for SetAgentTeamGrant.
type SetAgentTeamGrantJSONRequestBody ¶
type SetAgentTeamGrantJSONRequestBody SetAgentTeamGrantJSONBody
SetAgentTeamGrantJSONRequestBody defines body for SetAgentTeamGrant for application/json ContentType.
type SetAgentUserGrantJSONBody ¶
type SetAgentUserGrantJSONBody struct {
// Role Per-agent grant levels, read < write < maintain < publish.
Role AgentRole `json:"role"`
}
SetAgentUserGrantJSONBody defines parameters for SetAgentUserGrant.
type SetAgentUserGrantJSONRequestBody ¶
type SetAgentUserGrantJSONRequestBody SetAgentUserGrantJSONBody
SetAgentUserGrantJSONRequestBody defines body for SetAgentUserGrant for application/json ContentType.
type SetFindingVerdictJSONBody ¶
type SetFindingVerdictJSONBody struct {
Reason string `json:"reason"`
Verdict SetFindingVerdictJSONBodyVerdict `json:"verdict"`
}
SetFindingVerdictJSONBody defines parameters for SetFindingVerdict.
type SetFindingVerdictJSONBodyVerdict ¶
type SetFindingVerdictJSONBodyVerdict string
SetFindingVerdictJSONBodyVerdict defines parameters for SetFindingVerdict.
const ( SetFindingVerdictJSONBodyVerdictConfirmed SetFindingVerdictJSONBodyVerdict = "confirmed" SetFindingVerdictJSONBodyVerdictDismissedAcceptedRisk SetFindingVerdictJSONBodyVerdict = "dismissed_accepted_risk" SetFindingVerdictJSONBodyVerdictDismissedFalsePositive SetFindingVerdictJSONBodyVerdict = "dismissed_false_positive" )
Defines values for SetFindingVerdictJSONBodyVerdict.
func (SetFindingVerdictJSONBodyVerdict) Valid ¶
func (e SetFindingVerdictJSONBodyVerdict) Valid() bool
Valid indicates whether the value is a known member of the SetFindingVerdictJSONBodyVerdict enum.
type SetFindingVerdictJSONRequestBody ¶
type SetFindingVerdictJSONRequestBody SetFindingVerdictJSONBody
SetFindingVerdictJSONRequestBody defines body for SetFindingVerdict for application/json ContentType.
type SetOrgMemberJSONBody ¶
type SetOrgMemberJSONBody struct {
// Role The role a PUT assigns. security_reviewer is refused outside a first-party organization. `owner` is accepted by the schema but refused with a 422 that names the roles that exist.
Role OrgRoleAssignment `json:"role"`
}
SetOrgMemberJSONBody defines parameters for SetOrgMember.
type SetOrgMemberJSONRequestBody ¶
type SetOrgMemberJSONRequestBody SetOrgMemberJSONBody
SetOrgMemberJSONRequestBody defines body for SetOrgMember for application/json ContentType.
type SetOrgPolicyJSONBody ¶
type SetOrgPolicyJSONBody map[string]interface{}
SetOrgPolicyJSONBody defines parameters for SetOrgPolicy.
type SetOrgPolicyJSONRequestBody ¶
type SetOrgPolicyJSONRequestBody SetOrgPolicyJSONBody
SetOrgPolicyJSONRequestBody defines body for SetOrgPolicy for application/json ContentType.
type ShippedKnowledgeRecord ¶
type ShippedKnowledgeRecord struct {
At time.Time `json:"at"`
// By The handle of the account that confirmed it. Absent for a release published by a tag push, which carries no confirmation.
By *string `json:"by,omitempty"`
Packs []ShippedPack `json:"packs"`
// Via `client`: the upload carried the publisher's confirmation. `tag-push`: the release was built from a tag and carried none. `fork`: the first version of a fork, copied from the release it forks.
Via string `json:"via"`
}
ShippedKnowledgeRecord Who confirmed that the version's shipped packs become readable with it, and how it was published. Served only to those who manage the QuickAgent. A version that has no record serves none.
type ShippedKnowledgeScan ¶
type ShippedKnowledgeScan struct {
// Name The pack's name and its directory under `knowledge/` in the archive.
Name string `json:"name"`
// Report What a pack's scan read and found: a record, never a gate. The stages that read prose over every text file, then AI Review over `sources/` and then `wiki/` in chunks no larger than the judge declares it reads.
Report KnowledgeScanReport `json:"report"`
}
ShippedKnowledgeScan defines model for ShippedKnowledgeScan.
type ShippedPack ¶
type ShippedPack struct {
// Name The pack's name, as the manifest ships it.
Name string `json:"name"`
// Origin The stored pack a shipped pack was laid down from. The registry holds the claim to the facts: the pack exists and is `ready`, it is the submitter's own (`own`) or the organization's (`org`), and its digest is the digest in the shipped pack's `manifest.json`. An organization's pack ships only from an administrator of the organization, and only into a QuickAgent in the organization's own namespace. A pack with no origin is the publisher's own files.
Origin *ShippedPackOrigin `json:"origin,omitempty"`
}
ShippedPack defines model for ShippedPack.
type ShippedPackOrigin ¶
type ShippedPackOrigin struct {
Kind ShippedPackOriginKind `json:"kind"`
// Org The organization's handle; present when `kind` is `org`.
Org *string `json:"org,omitempty"`
PackId openapi_types.UUID `json:"packId"`
}
ShippedPackOrigin The stored pack a shipped pack was laid down from. The registry holds the claim to the facts: the pack exists and is `ready`, it is the submitter's own (`own`) or the organization's (`org`), and its digest is the digest in the shipped pack's `manifest.json`. An organization's pack ships only from an administrator of the organization, and only into a QuickAgent in the organization's own namespace. A pack with no origin is the publisher's own files.
type ShippedPackOriginKind ¶
type ShippedPackOriginKind string
ShippedPackOriginKind defines model for ShippedPackOrigin.Kind.
const ( ShippedPackOriginKindOrg ShippedPackOriginKind = "org" ShippedPackOriginKindOwn ShippedPackOriginKind = "own" )
Defines values for ShippedPackOriginKind.
func (ShippedPackOriginKind) Valid ¶
func (e ShippedPackOriginKind) Valid() bool
Valid indicates whether the value is a known member of the ShippedPackOriginKind enum.
type SignIn ¶
type SignIn struct {
// UserID is the account the sign-in resolved to.
UserID uuid.UUID
// NewAccount is true when this sign-in created the account: what an
// extension reads to treat a sign-up's own claims (a promo code typed
// on the sign-up form) as a sign-up's and never a returning person's.
NewAccount bool
// Provider is the provider's id, and Subject the identity it signed in
// ("<provider>:<sub>").
Provider string
Subject string
// Claims is every claim of the verified ID token, as JSON decoded it;
// nil for a provider with no ID token. An extension that knows its IdP
// reads that IdP's own claims here, and believes them only from that
// provider.
Claims map[string]any
// AMR and AuthTime are the token's `amr` and `auth_time`.
AMR []string
AuthTime time.Time
// Request is the callback's request, for the extension's own audit; its
// body is spent.
Request *http.Request
// SetCookie sets a cookie on the response that gives the session.
SetCookie func(*http.Cookie)
// RememberBrowser records a remembered browser for this sign-in's
// account from this sign-in's own token, and returns the token to set
// as its cookie and its lifetime. The evidence is the verified ID
// token's, never the caller's: it is ErrNoSecondFactor unless `amr`
// names a second factor and `auth_time` is minutes old. detail rides
// the user.trusted_device_add audit row.
RememberBrowser func(detail map[string]any) (token string, ttl time.Duration, err error)
// AssertSSO records that this sign-in came through orgID's own single
// sign-on, so the session it gets satisfies that organization's
// enforced SSO (auth.Principal.SSOSatisfied). The assertion is as fresh
// as the token's auth_time, never the moment the registry heard it, so
// a provider session silently re-used long after its sign-in renews
// nothing; a token with no auth_time, or one from the future, tags
// nothing. The extension that calls it answers for the claim it read,
// from a provider it trusts for it; the organization's resources still
// need the person's membership, which this grants nothing of. It counts
// only when called before the hook returns; a nil id is ignored. The
// organization's audit log records it as sso.login.
AssertSSO func(orgID uuid.UUID)
}
SignIn is a sign-in through an individual provider that is about to be given a session, as an extension's hook hears it.
type SocialOidcCallbackParams ¶
type SocialOidcCallbackParams struct {
Code *string `form:"code,omitempty" json:"code,omitempty"`
State *string `form:"state,omitempty" json:"state,omitempty"`
}
SocialOidcCallbackParams defines parameters for SocialOidcCallback.
type SocialOidcCallbackParamsProvider ¶
type SocialOidcCallbackParamsProvider string
SocialOidcCallbackParamsProvider defines parameters for SocialOidcCallback.
const ( SocialOidcCallbackParamsProviderAuthentik SocialOidcCallbackParamsProvider = "authentik" SocialOidcCallbackParamsProviderOidc SocialOidcCallbackParamsProvider = "oidc" )
Defines values for SocialOidcCallbackParamsProvider.
func (SocialOidcCallbackParamsProvider) Valid ¶
func (e SocialOidcCallbackParamsProvider) Valid() bool
Valid indicates whether the value is a known member of the SocialOidcCallbackParamsProvider enum.
type SocialOidcStartParams ¶
type SocialOidcStartParams struct {
// Next Browser mode. An in-app, path-absolute return target (e.g. `/dashboard` on the site, `/ui/authorize?…` on the server's own pages). When present and valid, the callback answers the browser with a 303 to it instead of the JSON result, and a failed login 303s to the sign-in page with `?error=…` (the site's `/login`, or `/ui/login`). Anything that is not a single-slash path on this origin is ignored (open-redirect guard), which leaves the API behaviour unchanged.
Next *string `form:"next,omitempty" json:"next,omitempty"`
}
SocialOidcStartParams defines parameters for SocialOidcStart.
type SocialOidcStartParamsProvider ¶
type SocialOidcStartParamsProvider string
SocialOidcStartParamsProvider defines parameters for SocialOidcStart.
const ( SocialOidcStartParamsProviderAuthentik SocialOidcStartParamsProvider = "authentik" SocialOidcStartParamsProviderOidc SocialOidcStartParamsProvider = "oidc" )
Defines values for SocialOidcStartParamsProvider.
func (SocialOidcStartParamsProvider) Valid ¶
func (e SocialOidcStartParamsProvider) Valid() bool
Valid indicates whether the value is a known member of the SocialOidcStartParamsProvider enum.
type SocialProvider ¶
type SocialProvider string
SocialProvider defines model for SocialProvider.
const ( SocialProviderAuthentik SocialProvider = "authentik" SocialProviderOidc SocialProvider = "oidc" )
Defines values for SocialProvider.
func (SocialProvider) Valid ¶
func (e SocialProvider) Valid() bool
Valid indicates whether the value is a known member of the SocialProvider enum.
type SshKey ¶
type SshKey struct {
CreatedAt time.Time `json:"createdAt"`
// Fingerprint SHA256 fingerprint as OpenSSH prints it.
Fingerprint string `json:"fingerprint"`
Id openapi_types.UUID `json:"id"`
// KeyType ssh-ed25519, ecdsa-sha2-nistp256, ssh-rsa, …
KeyType string `json:"keyType"`
LastUsedAt *time.Time `json:"lastUsedAt,omitempty"`
Title string `json:"title"`
}
SshKey defines model for SshKey.
type StaffMember ¶
StaffMember is one person who is platform staff, as an extension reads the set: the account, its handle, and its verified address, lower-cased.
type StdHTTPServerOptions ¶
type StdHTTPServerOptions struct {
BaseURL string
BaseRouter ServeMux
Middlewares []MiddlewareFunc
ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}
type SubmitVersionJSONBody ¶
type SubmitVersionJSONBody struct {
// Tag Existing repo tag vX.Y.Z.
Tag string `json:"tag"`
}
SubmitVersionJSONBody defines parameters for SubmitVersion.
type SubmitVersionJSONRequestBody ¶
type SubmitVersionJSONRequestBody SubmitVersionJSONBody
SubmitVersionJSONRequestBody defines body for SubmitVersion for application/json ContentType.
type SubmitVersionMultipartBody ¶
type SubmitVersionMultipartBody struct {
Archive openapi_types.File `json:"archive"`
// Digest Client-computed sha256 digest to cross-check.
Digest *string `json:"digest,omitempty"`
// DraftRun The hosted draft this package was published from (Edit with AI's Publish this version). A claim only: the scan asks the deployment's DraftProvenance whether the submitter ran that draft against the agent's current release and whether its recorded proof matches these files. When it does, the version's source becomes `drafter-revision` and S9 scans its manifest and instruction file as a first release's. Otherwise nothing changes. A core registry has no DraftProvenance and never grants it.
DraftRun *openapi_types.UUID `json:"draftRun,omitempty"`
// KnowledgeShipping A publisher's confirmation that the knowledge packs a release ships become readable by everyone who can download it: one entry for each pack the package's manifest ships (`knowledge.ships`), no more and no fewer.
KnowledgeShipping *KnowledgeShipping `json:"knowledgeShipping,omitempty"`
}
SubmitVersionMultipartBody defines parameters for SubmitVersion.
type SubmitVersionMultipartRequestBody ¶
type SubmitVersionMultipartRequestBody SubmitVersionMultipartBody
SubmitVersionMultipartRequestBody defines body for SubmitVersion for multipart/form-data ContentType.
type SuspendOrgJSONBody ¶
type SuspendOrgJSONBody struct {
Reason string `json:"reason"`
}
SuspendOrgJSONBody defines parameters for SuspendOrg.
type SuspendOrgJSONRequestBody ¶
type SuspendOrgJSONRequestBody SuspendOrgJSONBody
SuspendOrgJSONRequestBody defines body for SuspendOrg for application/json ContentType.
type TagPage ¶
type TagPage struct {
// NextCursor Opaque; absent on the last page.
NextCursor *string `json:"nextCursor,omitempty"`
Results []SearchHit `json:"results"`
Tag string `json:"tag"`
}
TagPage defines model for TagPage.
type Team ¶
type Team struct {
Id openapi_types.UUID `json:"id"`
Slug string `json:"slug"`
}
Team defines model for Team.
type TooManyValuesForParamError ¶
func (*TooManyValuesForParamError) Error ¶
func (e *TooManyValuesForParamError) Error() string
type TriageAbuseReportJSONBody ¶
type TriageAbuseReportJSONBody struct {
Resolution string `json:"resolution"`
State TriageAbuseReportJSONBodyState `json:"state"`
}
TriageAbuseReportJSONBody defines parameters for TriageAbuseReport.
type TriageAbuseReportJSONBodyState ¶
type TriageAbuseReportJSONBodyState string
TriageAbuseReportJSONBodyState defines parameters for TriageAbuseReport.
const ( TriageAbuseReportJSONBodyStateActioned TriageAbuseReportJSONBodyState = "actioned" TriageAbuseReportJSONBodyStateDismissed TriageAbuseReportJSONBodyState = "dismissed" TriageAbuseReportJSONBodyStateTriaged TriageAbuseReportJSONBodyState = "triaged" )
Defines values for TriageAbuseReportJSONBodyState.
func (TriageAbuseReportJSONBodyState) Valid ¶
func (e TriageAbuseReportJSONBodyState) Valid() bool
Valid indicates whether the value is a known member of the TriageAbuseReportJSONBodyState enum.
type TriageAbuseReportJSONRequestBody ¶
type TriageAbuseReportJSONRequestBody TriageAbuseReportJSONBody
TriageAbuseReportJSONRequestBody defines body for TriageAbuseReport for application/json ContentType.
type TrustedDevicesCleared ¶
type TrustedDevicesCleared struct {
// Cleared Remembered browsers revoked by this request.
Cleared int `json:"cleared"`
}
TrustedDevicesCleared defines model for TrustedDevicesCleared.
type TrustedDevicesCount ¶
type TrustedDevicesCount struct {
// Count Live remembered browsers of the caller's account.
Count int `json:"count"`
}
TrustedDevicesCount defines model for TrustedDevicesCount.
type UIInfo ¶
type UIInfo struct {
AuthorizeUrl *string `json:"authorizeUrl,omitempty"`
Mode UIInfoMode `json:"mode"`
}
UIInfo The server's own browser surface under `/ui/`. `mode` is `full` (device authorize, plus the sign-in hand-off to the OpenID provider, sign-out and the address-confirmation page), `authorize` (only the device-authorize page — a site fronts this server) or `off`. `authorizeUrl` is the absolute page a CLI or the desktop app opens for browser sign-in, when served.
type UIInfoMode ¶
type UIInfoMode string
UIInfoMode defines model for UIInfo.Mode.
const ( Authorize UIInfoMode = "authorize" Full UIInfoMode = "full" Off UIInfoMode = "off" )
Defines values for UIInfoMode.
func (UIInfoMode) Valid ¶
func (e UIInfoMode) Valid() bool
Valid indicates whether the value is a known member of the UIInfoMode enum.
type UnescapedCookieParamError ¶
func (*UnescapedCookieParamError) Error ¶
func (e *UnescapedCookieParamError) Error() string
func (*UnescapedCookieParamError) Unwrap ¶
func (e *UnescapedCookieParamError) Unwrap() error
type UnmarshalingParamError ¶
func (*UnmarshalingParamError) Error ¶
func (e *UnmarshalingParamError) Error() string
func (*UnmarshalingParamError) Unwrap ¶
func (e *UnmarshalingParamError) Unwrap() error
type UnwrapKnowledgeKeyJSONRequestBody ¶
type UnwrapKnowledgeKeyJSONRequestBody = KnowledgeWrappedKey
UnwrapKnowledgeKeyJSONRequestBody defines body for UnwrapKnowledgeKey for application/json ContentType.
type UnwrapOrgKnowledgeKeyJSONRequestBody ¶
type UnwrapOrgKnowledgeKeyJSONRequestBody = KnowledgeWrappedKey
UnwrapOrgKnowledgeKeyJSONRequestBody defines body for UnwrapOrgKnowledgeKey for application/json ContentType.
type UpdateAgentJSONBody ¶
type UpdateAgentJSONBody struct {
// AcknowledgeShippedKnowledge The publisher's confirmation that the knowledge packs the QuickAgent's versions ship become readable by everyone who can download them once it is public, and hold no private data. Read only when `visibility` is `public`; it is not a setting and changes nothing else.
AcknowledgeShippedKnowledge *bool `json:"acknowledgeShippedKnowledge,omitempty"`
// AllowForcePush Allow non-fast-forward pushes to the default branch. Off by default; maintain only.
AllowForcePush *bool `json:"allowForcePush,omitempty"`
AutoPublishTags *bool `json:"autoPublishTags,omitempty"`
// Builtin Mark or unmark the agent as built-in: a package the Agentry CLI embeds, published for reading, which clients label Built-in in place of its run modes. Platform staff only (403 for anyone else, the namespace's administrators included), and setting it only on an agent of a first-party namespace (`builtin-first-party`). Nothing but the label reads it.
Builtin *bool `json:"builtin,omitempty"`
// Modes The run modes a release supports; at least one.
Modes *AgentModes `json:"modes,omitempty"`
// PipelineSkip Admit submissions to this agent without a scan. Settable by the namespace's administrators on a private agent of an organization's whose subscription includes unscanned agents; refused on a public agent (`pipeline-skip-public`) and in a personal namespace (`pipeline-skip-personal`), and with `feature-not-included` where the tier lacks it. While it is set, and while a version published unscanned stands, the agent cannot be made public (`agent-unscanned`). Clearing it changes nothing already published; the next submission goes through the whole pipeline.
PipelineSkip *bool `json:"pipelineSkip,omitempty"`
Summary *string `json:"summary,omitempty"`
// Visibility The namespace's administrators only. A token needs `org:admin`, or `agent:manage` when the body sets visibility and nothing else. `public` is refused on a retired agent (`409 agent-retired`): Restore is how a retired agent comes back. It is refused on a fork for good (`409 fork-stays-private`). Making a QuickAgent public while one of its versions, other than a yanked or rejected one, ships a knowledge pack needs `acknowledgeShippedKnowledge: true`, or the answer is `409 shipped-knowledge-unacknowledged`, which names the packs and the versions that ship them.
Visibility *UpdateAgentJSONBodyVisibility `json:"visibility,omitempty"`
}
UpdateAgentJSONBody defines parameters for UpdateAgent.
type UpdateAgentJSONBodyVisibility ¶
type UpdateAgentJSONBodyVisibility string
UpdateAgentJSONBodyVisibility defines parameters for UpdateAgent.
const ( UpdateAgentJSONBodyVisibilityPrivate UpdateAgentJSONBodyVisibility = "private" UpdateAgentJSONBodyVisibilityPublic UpdateAgentJSONBodyVisibility = "public" )
Defines values for UpdateAgentJSONBodyVisibility.
func (UpdateAgentJSONBodyVisibility) Valid ¶
func (e UpdateAgentJSONBodyVisibility) Valid() bool
Valid indicates whether the value is a known member of the UpdateAgentJSONBodyVisibility enum.
type UpdateAgentJSONRequestBody ¶
type UpdateAgentJSONRequestBody UpdateAgentJSONBody
UpdateAgentJSONRequestBody defines body for UpdateAgent for application/json ContentType.
type UpdateCurrentUserJSONBody ¶
type UpdateCurrentUserJSONBody struct {
// CookieAck True records acceptance of the cookie notice on the account (write-once timestamp; false is ignored).
CookieAck *bool `json:"cookieAck,omitempty"`
DisplayName *string `json:"displayName,omitempty"`
}
UpdateCurrentUserJSONBody defines parameters for UpdateCurrentUser.
type UpdateCurrentUserJSONRequestBody ¶
type UpdateCurrentUserJSONRequestBody UpdateCurrentUserJSONBody
UpdateCurrentUserJSONRequestBody defines body for UpdateCurrentUser for application/json ContentType.
type UpdateKnowledgePackRequest ¶
type UpdateKnowledgePackRequest struct {
Exportable bool `json:"exportable"`
}
UpdateKnowledgePackRequest defines model for UpdateKnowledgePackRequest.
type UpdateOrgJSONBody ¶
type UpdateOrgJSONBody struct {
DisplayName *string `json:"displayName,omitempty"`
// SsoRequired Enforce SSO for org resources. Admin only.
SsoRequired *bool `json:"ssoRequired,omitempty"`
}
UpdateOrgJSONBody defines parameters for UpdateOrg.
type UpdateOrgJSONRequestBody ¶
type UpdateOrgJSONRequestBody UpdateOrgJSONBody
UpdateOrgJSONRequestBody defines body for UpdateOrg for application/json ContentType.
type UpdateOrgKnowledgePackJSONRequestBody ¶
type UpdateOrgKnowledgePackJSONRequestBody = UpdateKnowledgePackRequest
UpdateOrgKnowledgePackJSONRequestBody defines body for UpdateOrgKnowledgePack for application/json ContentType.
type UpdateUserNotificationSettingsJSONRequestBody ¶
type UpdateUserNotificationSettingsJSONRequestBody = NotificationSettings
UpdateUserNotificationSettingsJSONRequestBody defines body for UpdateUserNotificationSettings for application/json ContentType.
type UpdateUserReportSettingsJSONRequestBody ¶
type UpdateUserReportSettingsJSONRequestBody = ReportSettings
UpdateUserReportSettingsJSONRequestBody defines body for UpdateUserReportSettings for application/json ContentType.
type UpdateUserReportSettingsParams ¶
type UpdateUserReportSettingsParams struct {
// Include `logo` answers the design with its logo, if the person has one. Without it the design comes without a `logo` key, so a client built before logos still reads it.
Include *ReportSettingsInclude `form:"include,omitempty" json:"include,omitempty"`
}
UpdateUserReportSettingsParams defines parameters for UpdateUserReportSettings.
type UpdateVoiceSettingsJSONRequestBody ¶
type UpdateVoiceSettingsJSONRequestBody = VoiceSettingsRequest
UpdateVoiceSettingsJSONRequestBody defines body for UpdateVoiceSettings for application/json ContentType.
type UpdateWebhookJSONBody ¶
type UpdateWebhookJSONBody struct {
Active *bool `json:"active,omitempty"`
Events *[]string `json:"events,omitempty"`
// Url An absolute https:// URL with a host, and a port from 1 to 65535 if it names one.
Url *string `json:"url,omitempty"`
}
UpdateWebhookJSONBody defines parameters for UpdateWebhook.
type UpdateWebhookJSONRequestBody ¶
type UpdateWebhookJSONRequestBody UpdateWebhookJSONBody
UpdateWebhookJSONRequestBody defines body for UpdateWebhook for application/json ContentType.
type User ¶
type User struct {
// CookieAckAt When this account acknowledged the cookie notice.
CookieAckAt *time.Time `json:"cookieAckAt,omitempty"`
CreatedAt time.Time `json:"createdAt"`
DisplayName string `json:"displayName"`
Email string `json:"email"`
// EmailVerificationResendAfter GET /user only, while the address is unconfirmed: the earliest moment `POST /user/email-verification` will send another activation link. Absent when one may be sent now.
EmailVerificationResendAfter *time.Time `json:"emailVerificationResendAfter,omitempty"`
EmailVerified bool `json:"emailVerified"`
Handle string `json:"handle"`
Id openapi_types.UUID `json:"id"`
// Orgs The caller's org memberships (present on GET /user only).
Orgs *[]struct {
Handle string `json:"handle"`
Role string `json:"role"`
// State Whether the membership is in force. `pending` is someone the organization's IdP provisioned, or its domain folded in, who holds no seat and nothing of the organization until an admin approves them; `active` is a member. Declining a pending member removes them, and a decline is remembered: the domain does not fold that person in again unless an admin invites them.
State *MembershipState `json:"state,omitempty"`
} `json:"orgs,omitempty"`
// PendingOrg The organization the caller is waiting to be approved by (present on GET /user only, and only while a pending membership exists): the domain folded them in at a sign-in, or the organization's IdP provisioned them. Every page and client can say it until an admin approves or declines them; until then they keep working on their own tier.
PendingOrg *PendingOrg `json:"pendingOrg,omitempty"`
PlatformStaff *bool `json:"platformStaff,omitempty"`
}
User defines model for User.
type VerifyDomainClaimJSONBody ¶
type VerifyDomainClaimJSONBody struct {
Domain string `json:"domain"`
}
VerifyDomainClaimJSONBody defines parameters for VerifyDomainClaim.
type VerifyDomainClaimJSONRequestBody ¶
type VerifyDomainClaimJSONRequestBody VerifyDomainClaimJSONBody
VerifyDomainClaimJSONRequestBody defines body for VerifyDomainClaim for application/json ContentType.
type VerifyEmailJSONBody ¶
type VerifyEmailJSONBody struct {
Token string `json:"token"`
}
VerifyEmailJSONBody defines parameters for VerifyEmail.
type VerifyEmailJSONRequestBody ¶
type VerifyEmailJSONRequestBody VerifyEmailJSONBody
VerifyEmailJSONRequestBody defines body for VerifyEmail for application/json ContentType.
type VersionStatus ¶
type VersionStatus string
VersionStatus Publication state machine states. `approved` is reserved and never produced: a reviewer's approval publishes directly (needs_review → published), so clients will not observe it; it is kept because removing an enum value is a breaking change.
const ( VersionStatusApproved VersionStatus = "approved" VersionStatusBlocked VersionStatus = "blocked" VersionStatusNeedsReview VersionStatus = "needs_review" VersionStatusPublished VersionStatus = "published" VersionStatusQuarantined VersionStatus = "quarantined" VersionStatusRejected VersionStatus = "rejected" VersionStatusScanning VersionStatus = "scanning" VersionStatusSubmitted VersionStatus = "submitted" VersionStatusYanked VersionStatus = "yanked" )
Defines values for VersionStatus.
func (VersionStatus) Valid ¶
func (e VersionStatus) Valid() bool
Valid indicates whether the value is a known member of the VersionStatus enum.
type Voice ¶
type Voice struct {
// AlwaysAttach Runs In Agentry attach the live voice by default; on when a voice first goes live.
AlwaysAttach bool `json:"alwaysAttach"`
Live *VoiceVersion `json:"live,omitempty"`
Pending *VoiceVersion `json:"pending,omitempty"`
Previous *VoiceVersion `json:"previous,omitempty"`
// QuestionSet The hash of the voice question set a review asks now; a Restore of a version reviewed under another is reviewed again.
QuestionSet string `json:"questionSet"`
UpdatedAt time.Time `json:"updatedAt"`
}
Voice The caller's Writing Voice: at most a live version (the one runs attach), a pending one (in review, or flagged with its findings) and the previous one, for Restore.
type VoiceAdmission ¶
VoiceAdmission is a version a route is about to store for review: whose, from where, and its size.
type VoiceAdmitter ¶
type VoiceAdmitter interface {
// AdmitVoice returns a ticket, or a Refusal the route answers in its
// own status and words. An error is "unknown": the route fails closed
// with 503 and stores nothing.
AdmitVoice(ctx context.Context, a VoiceAdmission) (registry.Ticket, *registry.Refusal, error)
// VoidVoice cancels a ticket the core could not honour: nothing was
// stored. It must be idempotent. A void can fail or never be called (a
// crash between the admission and the store): the core records each
// ticket it stored in admitted_stores, in the storing transaction, so a
// ticket with no row there stored nothing.
VoidVoice(ctx context.Context, t registry.Ticket) error
}
VoiceAdmitter is the seam through which an extension admits a review a route asks for, and may charge for it (pkg/extension AdmitsVoice; one credit an operation): an edit saved, a client's upload, a Restore of a version reviewed under another question set. A build's own output reaches the store through the extension's door (Voice.Propose) and is never admitted here. The core has none, and admits every call.
type VoiceFinding ¶
type VoiceFinding struct {
// Flags This finding keeps the version from going live.
Flags bool `json:"flags"`
Line *int `json:"line,omitempty"`
// Question The voice question that scored, for an AI Review finding.
Question *string `json:"question,omitempty"`
Scanner string `json:"scanner"`
Score *int `json:"score,omitempty"`
Severity string `json:"severity"`
Title string `json:"title"`
}
VoiceFinding defines model for VoiceFinding.
type VoiceReviewReport ¶
type VoiceReviewReport struct {
AiReview struct {
// Failure Why AI Review did not answer (`timeout`, `judge-error`).
Failure *string `json:"failure,omitempty"`
InputTokens int `json:"inputTokens"`
Model *string `json:"model,omitempty"`
QuestionSet *string `json:"questionSet,omitempty"`
Requests int `json:"requests"`
// Scores Each question's score, 0 to 3; 2 or more flags the version.
Scores *map[string]int `json:"scores,omitempty"`
} `json:"aiReview"`
Findings []VoiceFinding `json:"findings"`
Schema string `json:"schema"`
Stages []struct {
Failed *bool `json:"failed,omitempty"`
Id string `json:"id"`
Name string `json:"name"`
} `json:"stages"`
Verdict VoiceReviewReportVerdict `json:"verdict"`
}
VoiceReviewReport What a version's review read and found: the pack scan's rule stages (S2, S3, S4, S8) over the text and Jev's voice question set. `incomplete` is a review that did not finish; the version stays in review and is tried again. The report keeps no excerpt.
type VoiceReviewReportVerdict ¶
type VoiceReviewReportVerdict string
VoiceReviewReportVerdict defines model for VoiceReviewReport.Verdict.
const ( VoiceReviewReportVerdictFlagged VoiceReviewReportVerdict = "flagged" VoiceReviewReportVerdictIncomplete VoiceReviewReportVerdict = "incomplete" VoiceReviewReportVerdictPass VoiceReviewReportVerdict = "pass" )
Defines values for VoiceReviewReportVerdict.
func (VoiceReviewReportVerdict) Valid ¶
func (e VoiceReviewReportVerdict) Valid() bool
Valid indicates whether the value is a known member of the VoiceReviewReportVerdict enum.
type VoiceSettingsRequest ¶
type VoiceSettingsRequest struct {
AlwaysAttach *bool `json:"alwaysAttach,omitempty"`
}
VoiceSettingsRequest defines model for VoiceSettingsRequest.
type VoiceVersion ¶
type VoiceVersion struct {
Bytes int `json:"bytes"`
CreatedAt time.Time `json:"createdAt"`
// Digest The SHA-256 of the text, `sha256:<hex>`.
Digest string `json:"digest"`
Id openapi_types.UUID `json:"id"`
// QuestionSet The hash of the question set the version was reviewed under; empty until its review is decided.
QuestionSet string `json:"questionSet"`
// Report What a version's review read and found: the pack scan's rule stages (S2, S3, S4, S8) over the text and Jev's voice question set. `incomplete` is a review that did not finish; the version stays in review and is tried again. The report keeps no excerpt.
Report *VoiceReviewReport `json:"report,omitempty"`
// Review A pending version is `reviewing` or `flagged`; a live or previous one `passed`.
Review VoiceVersionReview `json:"review"`
ReviewedAt *time.Time `json:"reviewedAt,omitempty"`
Slot VoiceVersionSlot `json:"slot"`
Source VoiceVersionSource `json:"source"`
// Text The VOICE.md, at most 32 KiB.
Text string `json:"text"`
}
VoiceVersion defines model for VoiceVersion.
type VoiceVersionReview ¶
type VoiceVersionReview string
VoiceVersionReview A pending version is `reviewing` or `flagged`; a live or previous one `passed`.
const ( VoiceVersionReviewFlagged VoiceVersionReview = "flagged" VoiceVersionReviewPassed VoiceVersionReview = "passed" VoiceVersionReviewReviewing VoiceVersionReview = "reviewing" )
Defines values for VoiceVersionReview.
func (VoiceVersionReview) Valid ¶
func (e VoiceVersionReview) Valid() bool
Valid indicates whether the value is a known member of the VoiceVersionReview enum.
type VoiceVersionSlot ¶
type VoiceVersionSlot string
VoiceVersionSlot defines model for VoiceVersion.Slot.
const ( VoiceVersionSlotLive VoiceVersionSlot = "live" VoiceVersionSlotPending VoiceVersionSlot = "pending" VoiceVersionSlotPrevious VoiceVersionSlot = "previous" )
Defines values for VoiceVersionSlot.
func (VoiceVersionSlot) Valid ¶
func (e VoiceVersionSlot) Valid() bool
Valid indicates whether the value is a known member of the VoiceVersionSlot enum.
type VoiceVersionSource ¶
type VoiceVersionSource string
VoiceVersionSource defines model for VoiceVersion.Source.
const ( VoiceVersionSourceAiEdit VoiceVersionSource = "ai-edit" VoiceVersionSourceBuild VoiceVersionSource = "build" VoiceVersionSourceEdit VoiceVersionSource = "edit" VoiceVersionSourceRestore VoiceVersionSource = "restore" VoiceVersionSourceUpload VoiceVersionSource = "upload" )
Defines values for VoiceVersionSource.
func (VoiceVersionSource) Valid ¶
func (e VoiceVersionSource) Valid() bool
Valid indicates whether the value is a known member of the VoiceVersionSource enum.
type WebNotificationSettings ¶
type WebNotificationSettings struct {
// DependencyAlerts Show the dependency-alert banner on every page while an alert is open (the dashboard lists alerts regardless).
DependencyAlerts bool `json:"dependencyAlerts"`
}
WebNotificationSettings In-app alerts.
type WebSearchRequest ¶
type WebSearchRequest struct {
// Count How many results to ask the provider for; clamped to 1–10.
Count *int `json:"count,omitempty"`
Query string `json:"query"`
}
WebSearchRequest defines model for WebSearchRequest.
type WebSearchResult ¶
type WebSearchResult struct {
Flagged *[]WebSearchResultFlagged `json:"flagged,omitempty"`
Score int `json:"score"`
// Scores Per question, 0 to 3 (0.5, 0.7 and 0.9 are 1, 2 and 3).
Scores *ModelInputScores `json:"scores,omitempty"`
// Snippet Present only when the result passed.
Snippet *string `json:"snippet,omitempty"`
// Title Present only when the result passed.
Title *string `json:"title,omitempty"`
// Url The result's address when it passed; only its origin (scheme and host) when it was withheld or not scanned, since a path or a query can carry an instruction too.
Url string `json:"url"`
// Verdict `pass`: no question scored 2 or more. `withheld`: one did; the model gets the source's address and the reason, never the text. `not_scanned`: the judge could not answer for part of the text; a caller treats it as withheld.
Verdict ModelInputVerdict `json:"verdict"`
}
WebSearchResult defines model for WebSearchResult.
type WebSearchResultFlagged ¶
type WebSearchResultFlagged string
WebSearchResultFlagged defines model for WebSearchResult.Flagged.
const ( WebSearchResultFlaggedDeception WebSearchResultFlagged = "deception" WebSearchResultFlaggedExfiltration WebSearchResultFlagged = "exfiltration" WebSearchResultFlaggedInjection WebSearchResultFlagged = "injection" WebSearchResultFlaggedObfuscation WebSearchResultFlagged = "obfuscation" )
Defines values for WebSearchResultFlagged.
func (WebSearchResultFlagged) Valid ¶
func (e WebSearchResultFlagged) Valid() bool
Valid indicates whether the value is a known member of the WebSearchResultFlagged enum.
type WebSearchResults ¶
type WebSearchResults struct {
Model string `json:"model"`
// Provider The search provider the deployment brokers.
Provider string `json:"provider"`
QuestionSet string `json:"questionSet"`
Results []WebSearchResult `json:"results"`
// Usage The judge's requests and input tokens, for the record. Never a price: AI Review is charged per operation.
Usage ModelInputUsage `json:"usage"`
// Withheld How many results were withheld or not scanned.
Withheld int `json:"withheld"`
}
WebSearchResults defines model for WebSearchResults.
type WebhookDelivery ¶
type WebhookDelivery struct {
Attempt int `json:"attempt"`
CreatedAt time.Time `json:"createdAt"`
DeliveredAt *time.Time `json:"deliveredAt,omitempty"`
Error *string `json:"error,omitempty"`
EventType string `json:"eventType"`
Id openapi_types.UUID `json:"id"`
StatusCode *int `json:"statusCode,omitempty"`
}
WebhookDelivery defines model for WebhookDelivery.
type WebhookEndpoint ¶
type WebhookEndpoint struct {
Active bool `json:"active"`
CreatedAt time.Time `json:"createdAt"`
Events []string `json:"events"`
Id openapi_types.UUID `json:"id"`
Url string `json:"url"`
}
WebhookEndpoint defines model for WebhookEndpoint.
type WebhookEndpointCreated ¶
type WebhookEndpointCreated struct {
Active bool `json:"active"`
CreatedAt time.Time `json:"createdAt"`
Events []string `json:"events"`
Id openapi_types.UUID `json:"id"`
// Secret The HMAC signing secret; shown once.
Secret string `json:"secret"`
Url string `json:"url"`
}
WebhookEndpointCreated defines model for WebhookEndpointCreated.
type WebhookEndpointRef ¶
WebhookEndpointRef is an organization's webhook endpoint as an extension may name one (pkg/extension.Webhooks): what identifies it and what it subscribes to, and nothing that could deliver to it outside the core's transport — the secret stays in the row.
type WebhookInput ¶
type WebhookInput struct {
Events []string `json:"events"`
// Url An absolute https:// URL with a host, and a port from 1 to 65535 if it names one.
Url string `json:"url"`
}
WebhookInput defines model for WebhookInput.
type WrapKnowledgeKeyJSONRequestBody ¶
type WrapKnowledgeKeyJSONRequestBody = KnowledgeDataKey
WrapKnowledgeKeyJSONRequestBody defines body for WrapKnowledgeKey for application/json ContentType.
type WrapOrgKnowledgeKeyJSONRequestBody ¶
type WrapOrgKnowledgeKeyJSONRequestBody = KnowledgeDataKey
WrapOrgKnowledgeKeyJSONRequestBody defines body for WrapOrgKnowledgeKey for application/json ContentType.
type YankVersionJSONBody ¶
type YankVersionJSONBody struct {
Reason string `json:"reason"`
}
YankVersionJSONBody defines parameters for YankVersion.
type YankVersionJSONRequestBody ¶
type YankVersionJSONRequestBody YankVersionJSONBody
YankVersionJSONRequestBody defines body for YankVersion for application/json ContentType.
Source Files
¶
- accounts_seam.go
- activation.go
- audit_retention.go
- authz_routes.go
- authz_scope_routes.go
- directory.go
- directory_erasure.go
- directory_port.go
- extension_callbacks.go
- extensions.go
- handlers_abuse.go
- handlers_account_installs.go
- handlers_agent_fork.go
- handlers_agent_lifecycle.go
- handlers_agents.go
- handlers_audit.go
- handlers_audit_export.go
- handlers_auth.go
- handlers_clear_data.go
- handlers_desktop_grant.go
- handlers_domains.go
- handlers_fold_in.go
- handlers_gdpr.go
- handlers_image_proxy.go
- handlers_invitations.go
- handlers_knowledge.go
- handlers_knowledge_org.go
- handlers_mcp_scans.go
- handlers_model_input.go
- handlers_org.go
- handlers_org_lifecycle.go
- handlers_org_logo.go
- handlers_policy.go
- handlers_redteam.go
- handlers_review_files.go
- handlers_reviews.go
- handlers_rules_bundle.go
- handlers_ruleset.go
- handlers_search.go
- handlers_sessions.go
- handlers_social_login.go
- handlers_ssh_keys.go
- handlers_stars.go
- handlers_user.go
- handlers_user_activity.go
- handlers_user_domain.go
- handlers_user_notifications.go
- handlers_user_report_settings.go
- handlers_version_events.go
- handlers_version_files.go
- handlers_versions.go
- handlers_voice.go
- handlers_webhooks.go
- handles.go
- idempotency.go
- identity_events.go
- members_seam.go
- middleware.go
- middleware_auth.go
- openapi_gen.go
- params.go
- problem.go
- publish_gate.go
- ratelimit.go
- readme.go
- recurring_jobs.go
- routes.go
- server.go
- sign_in_seam.go
- staff_org.go
- trusted_device.go
- trusted_device_sweep.go
- unactivated.go
- webpaths.go