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.1 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 CreateOrgReportDesignJSONRequestBody
- type CreateOrgReportDesignParams
- type CreateOrgRequest
- type CreateRulesetReleaseJSONBody
- type CreateRulesetReleaseJSONRequestBody
- type CreateTeamJSONBody
- type CreateTeamJSONRequestBody
- type CreateTokenJSONRequestBody
- type CreateTokenRequest
- type CreateUserReportDesignJSONRequestBody
- type CreateUserReportDesignParams
- 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 DesktopApp
- type DesktopAppAttachment
- type DesktopAppCatalogue
- type DesktopAppPlatforms
- type DesktopAppServerEcosystem
- type DesktopAppToolsClass
- 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 ErasedAddressRememberer
- 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 GetOrgReportDesignParams
- type GetReviewFileParams
- type GetUserReportDesignParams
- 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 OrgReportDesignCreate
- type OrgReportDesignList
- type OrgReportDesignRecord
- type OrgReportDesignSummary
- 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 PutOrgReportDesignCoverImageMultipartBody
- type PutOrgReportDesignCoverImageMultipartRequestBody
- type PutOrgReportDesignCustomCoverJSONRequestBody
- type PutOrgReportDesignLogoMultipartBody
- type PutOrgReportDesignLogoMultipartRequestBody
- type PutUserReportDesignCoverImageMultipartBody
- type PutUserReportDesignCoverImageMultipartRequestBody
- type PutUserReportDesignCustomCoverJSONRequestBody
- type PutUserReportDesignLogoMultipartBody
- type PutUserReportDesignLogoMultipartRequestBody
- type PutVoiceJSONRequestBody
- type PutVoiceRequest
- type PutVoiceRequestSource
- type RedTeamReport
- type ReportAbuseJSONBody
- type ReportAbuseJSONBodyCategory
- type ReportAbuseJSONRequestBody
- type ReportDesign
- type ReportDesignAgentryTheme
- type ReportDesignBasedOn
- type ReportDesignCoverShows
- type ReportDesignCoverStyle
- type ReportDesignCoverWhen
- type ReportDesignCreate
- type ReportDesignCustomCover
- type ReportDesignDefault
- type ReportDesignEntry
- type ReportDesignFontsBody
- type ReportDesignFontsCode
- type ReportDesignFontsHeadings
- type ReportDesignFooterPageNumbers
- type ReportDesignHeaderStyle
- type ReportDesignHeadingScale
- type ReportDesignHeadings
- type ReportDesignId
- type ReportDesignImage
- type ReportDesignInclude
- type ReportDesignList
- type ReportDesignMargins
- type ReportDesignPaper
- type ReportDesignQuotes
- type ReportDesignRecord
- type ReportDesignSummary
- type ReportDesignTitleBlock
- type ReportDesignUpdate
- 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) AddErasedAddressRememberer(name string, fn ErasedAddressRememberer)
- 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) AgentVersion(ctx context.Context, p *auth.Principal, ns, name, version string) (VersionState, 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) CreateOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, ...)
- func (s *Server) CreateReportDesign(ctx context.Context, user uuid.UUID, document []byte) (*ReportDesignEntry, error)
- 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) CreateUserReportDesign(w http.ResponseWriter, r *http.Request, params CreateUserReportDesignParams)
- 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) DeleteOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
- func (s *Server) DeleteOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
- func (s *Server) DeleteOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
- func (s *Server) DeleteOrgReportDesignLogo(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
- func (s *Server) DeleteTeam(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)
- func (s *Server) DeleteUserReportDesign(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
- func (s *Server) DeleteUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
- func (s *Server) DeleteUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
- func (s *Server) DeleteUserReportDesignLogo(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
- 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) ErasedAddressKey(email string) string
- 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) GetDesktopApps(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) GetOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId, ...)
- 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) GetUserReportDesign(w http.ResponseWriter, r *http.Request, designId ReportDesignId, ...)
- 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) ListOrgReportDesigns(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) ListUserReportDesigns(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) PutOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
- func (s *Server) PutOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
- func (s *Server) PutOrgReportDesignLogo(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
- func (s *Server) PutUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
- func (s *Server) PutUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
- func (s *Server) PutUserReportDesignLogo(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
- 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) ReportDesignByID(ctx context.Context, user, id uuid.UUID) (*ReportDesignEntry, error)
- func (s *Server) ReportDesignDefault(ctx context.Context, user uuid.UUID) (*ReportDesignEntry, error)
- func (s *Server) ReportDesignForMember(ctx context.Context, user uuid.UUID, org, name string) (*ReportDesignEntry, 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) SetExtensionCreditsSessions(name string, routes []string)
- 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) SetUserReportDesignDefault(w http.ResponseWriter, r *http.Request)
- 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) UpdateOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId, ...)
- func (s *Server) UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)
- func (s *Server) UpdateUserReportDesign(w http.ResponseWriter, r *http.Request, designId ReportDesignId, ...)
- 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) CreateOrgReportDesign(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) CreateUserReportDesign(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) DeleteOrgReportDesign(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteOrgReportDesignLogo(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteTeam(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteUserReportDesign(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) DeleteUserReportDesignLogo(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) GetDesktopApps(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) GetOrgReportDesign(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) GetUserReportDesign(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) ListOrgReportDesigns(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) ListUserReportDesigns(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) PutOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PutOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PutOrgReportDesignLogo(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PutUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PutUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) PutUserReportDesignLogo(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) SetUserReportDesignDefault(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) UpdateOrgReportDesign(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)
- func (siw *ServerInterfaceWrapper) UpdateUserReportDesign(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 SetUserReportDesignDefaultJSONRequestBody
- 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 SubagentReach
- type SubagentReachBrowser
- type SubagentScan
- 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 UpdateOrgReportDesignJSONRequestBody
- type UpdateOrgReportDesignParams
- type UpdateUserNotificationSettingsJSONRequestBody
- type UpdateUserReportDesignJSONRequestBody
- type UpdateUserReportDesignParams
- type UpdateVoiceSettingsJSONRequestBody
- type UpdateWebhookJSONBody
- type UpdateWebhookJSONRequestBody
- type User
- type VerifyDomainClaimJSONBody
- type VerifyDomainClaimJSONRequestBody
- type VerifyEmailJSONBody
- type VerifyEmailJSONRequestBody
- type VersionAdvisory
- type VersionState
- 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") ErrAccountSuspended = errors.New("api: the account at this address is suspended, 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. A suspended account is kept out of every organization's business, so it is not given a membership an admin would be asked to approve with no sign of the suspension.
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.
var ErrOrgReportDesignNameHeld = errors.New("report designs: the organization has a design of that name")
ErrOrgReportDesignNameHeld is a create or a replace whose name another of the organization's designs holds.
var ErrReportDesignsFull = errors.New("report designs: the library holds ten designs")
ErrReportDesignsFull is a create past the library's bound.
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 CreateOrgReportDesignJSONRequestBody ¶ added in v0.7.5
type CreateOrgReportDesignJSONRequestBody = OrgReportDesignCreate
CreateOrgReportDesignJSONRequestBody defines body for CreateOrgReportDesign for application/json ContentType.
type CreateOrgReportDesignParams ¶ added in v0.7.5
type CreateOrgReportDesignParams struct {
// Include `assets` answers the design with its images (`logo`, `coverImage`, `customCover`), if it has them. Without it the document comes without those keys, so a client that does not draw them reads it whole and small.
Include *ReportDesignInclude `form:"include,omitempty" json:"include,omitempty"`
}
CreateOrgReportDesignParams defines parameters for CreateOrgReportDesign.
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 CreateUserReportDesignJSONRequestBody ¶ added in v0.7.4
type CreateUserReportDesignJSONRequestBody = ReportDesignCreate
CreateUserReportDesignJSONRequestBody defines body for CreateUserReportDesign for application/json ContentType.
type CreateUserReportDesignParams ¶ added in v0.7.4
type CreateUserReportDesignParams struct {
// Include `assets` answers the design with its images (`logo`, `coverImage`, `customCover`), if it has them. Without it the document comes without those keys, so a client that does not draw them reads it whole and small.
Include *ReportDesignInclude `form:"include,omitempty" json:"include,omitempty"`
}
CreateUserReportDesignParams defines parameters for CreateUserReportDesign.
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 DesktopApp ¶ added in v0.7.7
type DesktopApp struct {
// Application Example: Blender
Application string `json:"application"`
// Attachment `stdio`: Agentry Desktop launches the server and speaks MCP over its standard input and output. `loopback-http`: the application serves MCP itself at `endpoint`, which Agentry Desktop connects to.
Attachment DesktopAppAttachment `json:"attachment"`
// Egress Hosts the server or the application's add-on is known to reach from the person's computer.
Egress *[]string `json:"egress,omitempty"`
// Endpoint A loopback-http server's http://127.0.0.1 address.
Endpoint *string `json:"endpoint,omitempty"`
// Id The id `capabilities.desktop.servers` names.
//
// Example: blender
Id string `json:"id"`
// Launch A stdio server's command line, which holds the pinned version, and its environment.
Launch *struct {
Command []string `json:"command"`
Env *map[string]string `json:"env,omitempty"`
} `json:"launch,omitempty"`
// Listener The loopback port the application listens on for its server, checked before a run starts.
Listener struct {
Port int `json:"port"`
} `json:"listener"`
Platforms []DesktopAppPlatforms `json:"platforms"`
Server struct {
// Ecosystem The package registry the server is published in, or `application` for a server the application ships itself as a plugin, which only a `loopback-http` entry names: then `name` is the plugin's, `version` the application's release that brought it, and `source` where it is documented.
Ecosystem DesktopAppServerEcosystem `json:"ecosystem"`
// Name Example: mcp-for-blender
Name string `json:"name"`
Source string `json:"source"`
// Version The one release vetted; a newer one is not until it is listed.
//
// Example: 2.2.7
Version string `json:"version"`
} `json:"server"`
// Steps What the person does once before the first run.
Steps []string `json:"steps"`
// Tools Every tool a run may call.
Tools []struct {
// Class `read` reads the application's state; `act` changes it or works inside it; `exec` runs code or commands the application interprets, and each call asks the person first.
Class DesktopAppToolsClass `json:"class"`
// Egress The tool reaches the entry's egress hosts from the person's computer.
Egress *bool `json:"egress,omitempty"`
Name string `json:"name"`
} `json:"tools"`
// Withheld Tools the server offers that no run is given.
Withheld *[]string `json:"withheld,omitempty"`
}
DesktopApp One application server: an application a QuickAgent may use on the person's own computer and the installed server Agentry has vetted for it. Agentry Desktop runs the server as the person from this entry alone; a release never names a command, a path or a port.
type DesktopAppAttachment ¶ added in v0.7.7
type DesktopAppAttachment string
DesktopAppAttachment `stdio`: Agentry Desktop launches the server and speaks MCP over its standard input and output. `loopback-http`: the application serves MCP itself at `endpoint`, which Agentry Desktop connects to.
const ( LoopbackHttp DesktopAppAttachment = "loopback-http" Stdio DesktopAppAttachment = "stdio" )
Defines values for DesktopAppAttachment.
func (DesktopAppAttachment) Valid ¶ added in v0.7.7
func (e DesktopAppAttachment) Valid() bool
Valid indicates whether the value is a known member of the DesktopAppAttachment enum.
type DesktopAppCatalogue ¶ added in v0.7.7
type DesktopAppCatalogue struct {
Servers []DesktopApp `json:"servers"`
// Version The catalogue's version, raised on every change to it.
Version int `json:"version"`
}
DesktopAppCatalogue defines model for DesktopAppCatalogue.
type DesktopAppPlatforms ¶ added in v0.7.7
type DesktopAppPlatforms string
DesktopAppPlatforms defines model for DesktopApp.Platforms.
const ( Darwin DesktopAppPlatforms = "darwin" Linux DesktopAppPlatforms = "linux" Windows DesktopAppPlatforms = "windows" )
Defines values for DesktopAppPlatforms.
func (DesktopAppPlatforms) Valid ¶ added in v0.7.7
func (e DesktopAppPlatforms) Valid() bool
Valid indicates whether the value is a known member of the DesktopAppPlatforms enum.
type DesktopAppServerEcosystem ¶ added in v0.7.7
type DesktopAppServerEcosystem string
DesktopAppServerEcosystem The package registry the server is published in, or `application` for a server the application ships itself as a plugin, which only a `loopback-http` entry names: then `name` is the plugin's, `version` the application's release that brought it, and `source` where it is documented.
const ( DesktopAppServerEcosystemApplication DesktopAppServerEcosystem = "application" DesktopAppServerEcosystemNpm DesktopAppServerEcosystem = "npm" DesktopAppServerEcosystemPypi DesktopAppServerEcosystem = "pypi" )
Defines values for DesktopAppServerEcosystem.
func (DesktopAppServerEcosystem) Valid ¶ added in v0.7.7
func (e DesktopAppServerEcosystem) Valid() bool
Valid indicates whether the value is a known member of the DesktopAppServerEcosystem enum.
type DesktopAppToolsClass ¶ added in v0.7.7
type DesktopAppToolsClass string
DesktopAppToolsClass `read` reads the application's state; `act` changes it or works inside it; `exec` runs code or commands the application interprets, and each call asks the person first.
const ( DesktopAppToolsClassAct DesktopAppToolsClass = "act" DesktopAppToolsClassExec DesktopAppToolsClass = "exec" DesktopAppToolsClassRead DesktopAppToolsClass = "read" )
Defines values for DesktopAppToolsClass.
func (DesktopAppToolsClass) Valid ¶ added in v0.7.7
func (e DesktopAppToolsClass) Valid() bool
Valid indicates whether the value is a known member of the DesktopAppToolsClass 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 {
// Runhost A remote runhost's name. The grant then mints a token that can only open a credits session, for that runhost to pay for its runs' models, in place of the sign-in set.
Runhost *string `json:"runhost,omitempty"`
// 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 or an application server's on the person's computer.
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 ( DraftUngrantedToolGrantBrowser DraftUngrantedToolGrant = "browser" DraftUngrantedToolGrantComputerUse DraftUngrantedToolGrant = "computerUse" DraftUngrantedToolGrantDesktop DraftUngrantedToolGrant = "desktop" DraftUngrantedToolGrantEgress DraftUngrantedToolGrant = "egress" DraftUngrantedToolGrantExec DraftUngrantedToolGrant = "exec" DraftUngrantedToolGrantFilesystemRead DraftUngrantedToolGrant = "filesystem.read" DraftUngrantedToolGrantFilesystemWrite DraftUngrantedToolGrant = "filesystem.write" DraftUngrantedToolGrantMcpServers DraftUngrantedToolGrant = "mcpServers" DraftUngrantedToolGrantPersistentClock DraftUngrantedToolGrant = "persistent.clock" DraftUngrantedToolGrantPersistentHelper DraftUngrantedToolGrant = "persistent.helper" DraftUngrantedToolGrantPersistentMeetings DraftUngrantedToolGrant = "persistent.meetings" DraftUngrantedToolGrantPersistentMemory DraftUngrantedToolGrant = "persistent.memory" DraftUngrantedToolGrantPersistentReview DraftUngrantedToolGrant = "persistent.review" DraftUngrantedToolGrantPersistentSelfConfigure DraftUngrantedToolGrant = "persistent.selfConfigure" DraftUngrantedToolGrantPersistentWeb DraftUngrantedToolGrant = "persistent.web" DraftUngrantedToolGrantSubagents DraftUngrantedToolGrant = "subagents" DraftUngrantedToolGrantTargetHosts 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"`
// RunFailures A run of a QuickAgent In Agentry failed after it started or was refused by the queue: a run, a draft, a knowledge build or a scheduled fire (the hosted product's mail; a registry that runs no QuickAgents sends none). Off until the person turns it on. Not required on a write: a client that predates the switch leaves it as it was rather than changing it by omission.
RunFailures *bool `json:"runFailures,omitempty"`
// RunFinished A run of a QuickAgent In Agentry completed (the hosted product's mail; a registry that runs no QuickAgents sends none). Off until the person turns it on. Not required on a write: a client that predates the switch leaves it as it was rather than changing it by omission.
RunFinished *bool `json:"runFinished,omitempty"`
// 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 ErasedAddressRememberer ¶ added in v0.6.1000
type ErasedAddressRememberer func(ctx context.Context, tx ErasureTx, userID uuid.UUID, addressKey string) error
ErasedAddressRememberer keeps what an extension must remember about an erased account's address, by its key, inside the erasure's transaction. An error rolls the erasure back.
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 GetOrgReportDesignParams ¶ added in v0.7.5
type GetOrgReportDesignParams struct {
// Include `assets` answers the design with its images (`logo`, `coverImage`, `customCover`), if it has them. Without it the document comes without those keys, so a client that does not draw them reads it whole and small.
Include *ReportDesignInclude `form:"include,omitempty" json:"include,omitempty"`
}
GetOrgReportDesignParams defines parameters for GetOrgReportDesign.
type GetReviewFileParams ¶
type GetReviewFileParams struct {
Path string `form:"path" json:"path"`
}
GetReviewFileParams defines parameters for GetReviewFile.
type GetUserReportDesignParams ¶ added in v0.7.4
type GetUserReportDesignParams struct {
// Include `assets` answers the design with its images (`logo`, `coverImage`, `customCover`), if it has them. Without it the document comes without those keys, so a client that does not draw them reads it whole and small.
Include *ReportDesignInclude `form:"include,omitempty" json:"include,omitempty"`
}
GetUserReportDesignParams defines parameters for GetUserReportDesign.
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 OrgReportDesignCreate ¶ added in v0.7.5
type OrgReportDesignCreate struct {
// Design A report design, the theme document version 3: a whole brand. 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 where it carries text (titleBlock `band`, headings `smallcaps` or `numbered`, or a cover that is drawn in the `band`, `largeType` or `plate` style, or `split` with no secondary) and 3:1 otherwise; the secondary 4.5:1 where a drawn `split` cover puts the brand on it and 3:1 otherwise; every text (`name`, the brand's lines, each header and footer slot) is one line with no control, line-break, bidirectional formatting or other invisible format characters; `brand.website` is a host name or an https address, drawn as text; a cover fact is named once; the custom cover's source is at most 32 KiB of text, its images at most six and 2 MB in all as stored, its thumbnail a PNG of at most 300 KB; each image's base64 holds a PNG or a JPEG within its bounds. Each colour's tint is derived: 12% of it over white. The ten built-in themes are each a value of it. `logo`, `coverImage` and `customCover` are optional, not counted in the 24 KB, answered only on `include=assets`, and null reads as none.
Design ReportDesign `json:"design"`
}
OrgReportDesignCreate defines model for OrgReportDesignCreate.
type OrgReportDesignList ¶ added in v0.7.5
type OrgReportDesignList struct {
Designs []OrgReportDesignSummary `json:"designs"`
// Org The organization's handle, which a run names a house design under.
Org string `json:"org"`
}
OrgReportDesignList An organization's house designs, oldest first. There is no default: a member picks one per run, and a run that picks none takes the person's own default.
type OrgReportDesignRecord ¶ added in v0.7.5
type OrgReportDesignRecord struct {
CreatedAt time.Time `json:"createdAt"`
// Design A report design, the theme document version 3: a whole brand. 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 where it carries text (titleBlock `band`, headings `smallcaps` or `numbered`, or a cover that is drawn in the `band`, `largeType` or `plate` style, or `split` with no secondary) and 3:1 otherwise; the secondary 4.5:1 where a drawn `split` cover puts the brand on it and 3:1 otherwise; every text (`name`, the brand's lines, each header and footer slot) is one line with no control, line-break, bidirectional formatting or other invisible format characters; `brand.website` is a host name or an https address, drawn as text; a cover fact is named once; the custom cover's source is at most 32 KiB of text, its images at most six and 2 MB in all as stored, its thumbnail a PNG of at most 300 KB; each image's base64 holds a PNG or a JPEG within its bounds. Each colour's tint is derived: 12% of it over white. The ten built-in themes are each a value of it. `logo`, `coverImage` and `customCover` are optional, not counted in the 24 KB, answered only on `include=assets`, and null reads as none.
Design ReportDesign `json:"design"`
HasCoverImage bool `json:"hasCoverImage"`
HasCustomCover bool `json:"hasCustomCover"`
HasLogo bool `json:"hasLogo"`
Id openapi_types.UUID `json:"id"`
// Org The organization's handle.
Org string `json:"org"`
UpdatedAt time.Time `json:"updatedAt"`
}
OrgReportDesignRecord One house design with its document in canonical form. The images are in the document only on `include=assets`; the three flags say which it has.
type OrgReportDesignSummary ¶ added in v0.7.5
type OrgReportDesignSummary struct {
// BasedOn The built-in theme it started from.
BasedOn string `json:"basedOn"`
CreatedAt time.Time `json:"createdAt"`
HasCoverImage bool `json:"hasCoverImage"`
HasCustomCover bool `json:"hasCustomCover"`
HasLogo bool `json:"hasLogo"`
Id openapi_types.UUID `json:"id"`
// Name The design's name, unique within the organization; what a run names it by.
Name string `json:"name"`
UpdatedAt time.Time `json:"updatedAt"`
Version int `json:"version"`
}
OrgReportDesignSummary One house design of an organization's library, without its document's body or images.
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 PutOrgReportDesignCoverImageMultipartBody ¶ added in v0.7.5
type PutOrgReportDesignCoverImageMultipartBody struct {
File openapi_types.File `json:"file"`
}
PutOrgReportDesignCoverImageMultipartBody defines parameters for PutOrgReportDesignCoverImage.
type PutOrgReportDesignCoverImageMultipartRequestBody ¶ added in v0.7.5
type PutOrgReportDesignCoverImageMultipartRequestBody PutOrgReportDesignCoverImageMultipartBody
PutOrgReportDesignCoverImageMultipartRequestBody defines body for PutOrgReportDesignCoverImage for multipart/form-data ContentType.
type PutOrgReportDesignCustomCoverJSONRequestBody ¶ added in v0.7.5
type PutOrgReportDesignCustomCoverJSONRequestBody = ReportDesignCustomCover
PutOrgReportDesignCustomCoverJSONRequestBody defines body for PutOrgReportDesignCustomCover for application/json ContentType.
type PutOrgReportDesignLogoMultipartBody ¶ added in v0.7.5
type PutOrgReportDesignLogoMultipartBody struct {
File openapi_types.File `json:"file"`
}
PutOrgReportDesignLogoMultipartBody defines parameters for PutOrgReportDesignLogo.
type PutOrgReportDesignLogoMultipartRequestBody ¶ added in v0.7.5
type PutOrgReportDesignLogoMultipartRequestBody PutOrgReportDesignLogoMultipartBody
PutOrgReportDesignLogoMultipartRequestBody defines body for PutOrgReportDesignLogo for multipart/form-data ContentType.
type PutUserReportDesignCoverImageMultipartBody ¶ added in v0.7.4
type PutUserReportDesignCoverImageMultipartBody struct {
File openapi_types.File `json:"file"`
}
PutUserReportDesignCoverImageMultipartBody defines parameters for PutUserReportDesignCoverImage.
type PutUserReportDesignCoverImageMultipartRequestBody ¶ added in v0.7.4
type PutUserReportDesignCoverImageMultipartRequestBody PutUserReportDesignCoverImageMultipartBody
PutUserReportDesignCoverImageMultipartRequestBody defines body for PutUserReportDesignCoverImage for multipart/form-data ContentType.
type PutUserReportDesignCustomCoverJSONRequestBody ¶ added in v0.7.4
type PutUserReportDesignCustomCoverJSONRequestBody = ReportDesignCustomCover
PutUserReportDesignCustomCoverJSONRequestBody defines body for PutUserReportDesignCustomCover for application/json ContentType.
type PutUserReportDesignLogoMultipartBody ¶ added in v0.7.4
type PutUserReportDesignLogoMultipartBody struct {
File openapi_types.File `json:"file"`
}
PutUserReportDesignLogoMultipartBody defines parameters for PutUserReportDesignLogo.
type PutUserReportDesignLogoMultipartRequestBody ¶ added in v0.7.4
type PutUserReportDesignLogoMultipartRequestBody PutUserReportDesignLogoMultipartBody
PutUserReportDesignLogoMultipartRequestBody defines body for PutUserReportDesignLogo 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 first colour, lower-case hex.
Accent string `json:"accent"`
// AgentryTheme The document version, always 3.
AgentryTheme ReportDesignAgentryTheme `json:"agentryTheme"`
// BasedOn The built-in theme the design started from.
BasedOn ReportDesignBasedOn `json:"basedOn"`
// Brand Who the report is from; every line optional and drawn as text where a header, a footer or a cover asks for it.
Brand struct {
// Confidentiality The {confidentiality} token.
Confidentiality string `json:"confidentiality"`
Contact []string `json:"contact"`
// Name The {brand} token.
Name string `json:"name"`
Strapline string `json:"strapline"`
// Website A host name or an https address, drawn as text, never a link.
Website string `json:"website"`
} `json:"brand"`
// Cover The cover page.
Cover struct {
// Shows The facts the cover carries, each once.
Shows []ReportDesignCoverShows `json:"shows"`
// Style A built-in layout, or custom for the design's custom cover, which falls back to band when it cannot be drawn.
Style ReportDesignCoverStyle `json:"style"`
// When long draws the cover for a titled report past the template's length threshold, always for every titled report, never for none.
When ReportDesignCoverWhen `json:"when"`
} `json:"cover"`
// CoverImage The design's cover image, drawn by the plate style and offered to a custom cover: a PNG or a JPEG the core encoded from the upload, at most 2 MB and 2048 pixels each way, under the key that names its format.
CoverImage *struct {
Jpeg *string `json:"jpeg,omitempty"`
Png *string `json:"png,omitempty"`
} `json:"coverImage,omitempty"`
// CustomCover The design's custom cover, drawn when the cover style is custom: its Typst source, the images it may draw (each a PNG or a JPEG the core encoded, named by the renderer in this order) and a PNG thumbnail of its last render.
CustomCover *struct {
Images []struct {
Jpeg *string `json:"jpeg,omitempty"`
Png *string `json:"png,omitempty"`
} `json:"images"`
Source string `json:"source"`
Thumbnail *struct {
Png string `json:"png"`
} `json:"thumbnail,omitempty"`
} `json:"customCover,omitempty"`
Fonts struct {
Body ReportDesignFontsBody `json:"body"`
Code ReportDesignFontsCode `json:"code"`
Headings ReportDesignFontsHeadings `json:"headings"`
} `json:"fonts"`
PageNumbers ReportDesignFooterPageNumbers `json:"pageNumbers"`
// Slots As the header's.
Slots []string `json:"slots"`
} `json:"footer"`
// Header The running header: from page 2 on a report, every page of a memo, never on a letter.
Header struct {
// Slots Left, centre and right: literal text and tokens from the closed set {title}, {author}, {date}, {page}, {pages}, {brand}, {section}, {confidentiality}, which the template substitutes before it sets the text; anything else between braces is literal.
Slots []string `json:"slots"`
Style ReportDesignHeaderStyle `json:"style"`
} `json:"header"`
// HeadingScale How much larger than the body each heading level is set.
HeadingScale ReportDesignHeadingScale `json:"headingScale"`
Headings ReportDesignHeadings `json:"headings"`
// Logo The person's logo, a PNG the core encoded from their upload, at most 512 KB and 1024 pixels each way; absent for none.
Logo *struct {
Png string `json:"png"`
} `json:"logo,omitempty"`
// Margins The page's margins.
Margins ReportDesignMargins `json:"margins"`
// 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"`
// Secondary The second colour, lower-case hex, or empty for none.
Secondary string `json:"secondary"`
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 3: a whole brand. 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 where it carries text (titleBlock `band`, headings `smallcaps` or `numbered`, or a cover that is drawn in the `band`, `largeType` or `plate` style, or `split` with no secondary) and 3:1 otherwise; the secondary 4.5:1 where a drawn `split` cover puts the brand on it and 3:1 otherwise; every text (`name`, the brand's lines, each header and footer slot) is one line with no control, line-break, bidirectional formatting or other invisible format characters; `brand.website` is a host name or an https address, drawn as text; a cover fact is named once; the custom cover's source is at most 32 KiB of text, its images at most six and 2 MB in all as stored, its thumbnail a PNG of at most 300 KB; each image's base64 holds a PNG or a JPEG within its bounds. Each colour's tint is derived: 12% of it over white. The ten built-in themes are each a value of it. `logo`, `coverImage` and `customCover` are optional, not counted in the 24 KB, answered only on `include=assets`, and null reads as none.
type ReportDesignAgentryTheme ¶
type ReportDesignAgentryTheme int
ReportDesignAgentryTheme The document version, always 3.
const (
ReportDesignVersion3 ReportDesignAgentryTheme = 3
)
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 ( ReportDesignBasedOnBoardroom ReportDesignBasedOn = "boardroom" ReportDesignBasedOnCivic ReportDesignBasedOn = "civic" ReportDesignBasedOnClassic ReportDesignBasedOn = "classic" ReportDesignBasedOnEditorial ReportDesignBasedOn = "editorial" ReportDesignBasedOnField ReportDesignBasedOn = "field" ReportDesignBasedOnLumen ReportDesignBasedOn = "lumen" ReportDesignBasedOnModern ReportDesignBasedOn = "modern" ReportDesignBasedOnPlain ReportDesignBasedOn = "plain" ReportDesignBasedOnStudio ReportDesignBasedOn = "studio" 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 ReportDesignCoverShows ¶ added in v0.7.4
type ReportDesignCoverShows string
ReportDesignCoverShows defines model for ReportDesign.Cover.Shows.
const ( Author ReportDesignCoverShows = "author" Brand ReportDesignCoverShows = "brand" Confidentiality ReportDesignCoverShows = "confidentiality" Date ReportDesignCoverShows = "date" Logo ReportDesignCoverShows = "logo" Subtitle ReportDesignCoverShows = "subtitle" Title ReportDesignCoverShows = "title" )
Defines values for ReportDesignCoverShows.
func (ReportDesignCoverShows) Valid ¶ added in v0.7.4
func (e ReportDesignCoverShows) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignCoverShows enum.
type ReportDesignCoverStyle ¶ added in v0.7.4
type ReportDesignCoverStyle string
ReportDesignCoverStyle A built-in layout, or custom for the design's custom cover, which falls back to band when it cannot be drawn.
const ( ReportDesignCoverStyleBand ReportDesignCoverStyle = "band" ReportDesignCoverStyleCustom ReportDesignCoverStyle = "custom" ReportDesignCoverStyleFramed ReportDesignCoverStyle = "framed" ReportDesignCoverStyleGeometric ReportDesignCoverStyle = "geometric" ReportDesignCoverStyleLargeType ReportDesignCoverStyle = "largeType" ReportDesignCoverStylePlate ReportDesignCoverStyle = "plate" ReportDesignCoverStyleSplit ReportDesignCoverStyle = "split" )
Defines values for ReportDesignCoverStyle.
func (ReportDesignCoverStyle) Valid ¶ added in v0.7.4
func (e ReportDesignCoverStyle) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignCoverStyle enum.
type ReportDesignCoverWhen ¶ added in v0.7.4
type ReportDesignCoverWhen string
ReportDesignCoverWhen long draws the cover for a titled report past the template's length threshold, always for every titled report, never for none.
const ( Always ReportDesignCoverWhen = "always" Long ReportDesignCoverWhen = "long" Never ReportDesignCoverWhen = "never" )
Defines values for ReportDesignCoverWhen.
func (ReportDesignCoverWhen) Valid ¶ added in v0.7.4
func (e ReportDesignCoverWhen) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignCoverWhen enum.
type ReportDesignCreate ¶ added in v0.7.4
type ReportDesignCreate struct {
// Default Make the new design the default. Off, the default is unchanged, so an account whose first design is added without it still has no default.
Default *bool `json:"default,omitempty"`
// Design A report design, the theme document version 3: a whole brand. 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 where it carries text (titleBlock `band`, headings `smallcaps` or `numbered`, or a cover that is drawn in the `band`, `largeType` or `plate` style, or `split` with no secondary) and 3:1 otherwise; the secondary 4.5:1 where a drawn `split` cover puts the brand on it and 3:1 otherwise; every text (`name`, the brand's lines, each header and footer slot) is one line with no control, line-break, bidirectional formatting or other invisible format characters; `brand.website` is a host name or an https address, drawn as text; a cover fact is named once; the custom cover's source is at most 32 KiB of text, its images at most six and 2 MB in all as stored, its thumbnail a PNG of at most 300 KB; each image's base64 holds a PNG or a JPEG within its bounds. Each colour's tint is derived: 12% of it over white. The ten built-in themes are each a value of it. `logo`, `coverImage` and `customCover` are optional, not counted in the 24 KB, answered only on `include=assets`, and null reads as none.
Design ReportDesign `json:"design"`
}
ReportDesignCreate defines model for ReportDesignCreate.
type ReportDesignCustomCover ¶ added in v0.7.4
type ReportDesignCustomCover struct {
Images []struct {
Jpeg *string `json:"jpeg,omitempty"`
Png *string `json:"png,omitempty"`
} `json:"images"`
Source string `json:"source"`
Thumbnail *struct {
Png string `json:"png"`
} `json:"thumbnail,omitempty"`
}
ReportDesignCustomCover A design's custom cover: its Typst source (at most 32 KiB of text), up to six images (each a PNG or a JPEG, 2 MB in all as stored; the core encodes each again) and a PNG thumbnail of its last render (at most 300 KB).
type ReportDesignDefault ¶ added in v0.7.4
type ReportDesignDefault struct {
// Id The design to make the default; absent or null for none.
Id *openapi_types.UUID `json:"id,omitempty"`
}
ReportDesignDefault Which design is the default: an id of the caller's, or none.
type ReportDesignEntry ¶ added in v0.7.4
type ReportDesignEntry struct {
ID uuid.UUID
Default bool
// Org is the handle of the organization whose house design this is,
// and empty for a person's own.
Org string
// Design is the design with every image it has.
Design reportdesign.Design
CreatedAt, UpdatedAt time.Time
}
ReportDesignEntry is one design as the server reads it, with its images, for the extension seam.
type ReportDesignFontsBody ¶
type ReportDesignFontsBody string
ReportDesignFontsBody defines model for ReportDesign.Fonts.Body.
const ( ReportDesignFontsBodyCrimsonPro ReportDesignFontsBody = "Crimson Pro" ReportDesignFontsBodyDMSans ReportDesignFontsBody = "DM Sans" ReportDesignFontsBodyEBGaramond ReportDesignFontsBody = "EB Garamond" ReportDesignFontsBodyIBMPlexSans ReportDesignFontsBody = "IBM Plex Sans" ReportDesignFontsBodyIBMPlexSerif ReportDesignFontsBody = "IBM Plex Serif" ReportDesignFontsBodyInter ReportDesignFontsBody = "Inter" ReportDesignFontsBodyLibreBaskerville ReportDesignFontsBody = "Libre Baskerville" ReportDesignFontsBodyLora ReportDesignFontsBody = "Lora" ReportDesignFontsBodyMerriweather ReportDesignFontsBody = "Merriweather" ReportDesignFontsBodyNunitoSans ReportDesignFontsBody = "Nunito Sans" ReportDesignFontsBodyRaleway ReportDesignFontsBody = "Raleway" ReportDesignFontsBodySourceSans3 ReportDesignFontsBody = "Source Sans 3" ReportDesignFontsBodySourceSerif4 ReportDesignFontsBody = "Source Serif 4" ReportDesignFontsBodySpaceGrotesk ReportDesignFontsBody = "Space Grotesk" 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 ( ReportDesignFontsCodeFiraCode ReportDesignFontsCode = "Fira Code" 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 ( ReportDesignFontsHeadingsCrimsonPro ReportDesignFontsHeadings = "Crimson Pro" ReportDesignFontsHeadingsDMSans ReportDesignFontsHeadings = "DM Sans" ReportDesignFontsHeadingsEBGaramond ReportDesignFontsHeadings = "EB Garamond" ReportDesignFontsHeadingsFiraCode ReportDesignFontsHeadings = "Fira Code" ReportDesignFontsHeadingsFraunces ReportDesignFontsHeadings = "Fraunces" ReportDesignFontsHeadingsIBMPlexMono ReportDesignFontsHeadings = "IBM Plex Mono" ReportDesignFontsHeadingsIBMPlexSans ReportDesignFontsHeadings = "IBM Plex Sans" ReportDesignFontsHeadingsIBMPlexSerif ReportDesignFontsHeadings = "IBM Plex Serif" ReportDesignFontsHeadingsInter ReportDesignFontsHeadings = "Inter" ReportDesignFontsHeadingsJetBrainsMono ReportDesignFontsHeadings = "JetBrains Mono" ReportDesignFontsHeadingsLibreBaskerville ReportDesignFontsHeadings = "Libre Baskerville" ReportDesignFontsHeadingsLora ReportDesignFontsHeadings = "Lora" ReportDesignFontsHeadingsMerriweather ReportDesignFontsHeadings = "Merriweather" ReportDesignFontsHeadingsMontserrat ReportDesignFontsHeadings = "Montserrat" ReportDesignFontsHeadingsNunitoSans ReportDesignFontsHeadings = "Nunito Sans" ReportDesignFontsHeadingsPlayfairDisplay ReportDesignFontsHeadings = "Playfair Display" ReportDesignFontsHeadingsRaleway ReportDesignFontsHeadings = "Raleway" ReportDesignFontsHeadingsSourceCodePro ReportDesignFontsHeadings = "Source Code Pro" ReportDesignFontsHeadingsSourceSans3 ReportDesignFontsHeadings = "Source Sans 3" ReportDesignFontsHeadingsSourceSerif4 ReportDesignFontsHeadings = "Source Serif 4" ReportDesignFontsHeadingsSpaceGrotesk ReportDesignFontsHeadings = "Space Grotesk" 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 ReportDesignHeaderStyle ¶ added in v0.7.4
type ReportDesignHeaderStyle string
ReportDesignHeaderStyle defines model for ReportDesign.Header.Style.
const ( ReportDesignHeaderStyleBrandLine ReportDesignHeaderStyle = "brandLine" ReportDesignHeaderStyleLogoLeft ReportDesignHeaderStyle = "logoLeft" ReportDesignHeaderStyleNone ReportDesignHeaderStyle = "none" ReportDesignHeaderStyleRule ReportDesignHeaderStyle = "rule" ReportDesignHeaderStyleTitleAndPage ReportDesignHeaderStyle = "titleAndPage" )
Defines values for ReportDesignHeaderStyle.
func (ReportDesignHeaderStyle) Valid ¶ added in v0.7.4
func (e ReportDesignHeaderStyle) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignHeaderStyle enum.
type ReportDesignHeadingScale ¶ added in v0.7.4
type ReportDesignHeadingScale string
ReportDesignHeadingScale How much larger than the body each heading level is set.
const ( ReportDesignHeadingScaleCompact ReportDesignHeadingScale = "compact" ReportDesignHeadingScaleGenerous ReportDesignHeadingScale = "generous" ReportDesignHeadingScaleRegular ReportDesignHeadingScale = "regular" )
Defines values for ReportDesignHeadingScale.
func (ReportDesignHeadingScale) Valid ¶ added in v0.7.4
func (e ReportDesignHeadingScale) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignHeadingScale 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 ReportDesignId ¶ added in v0.7.4
type ReportDesignId = openapi_types.UUID
ReportDesignId defines model for ReportDesignId.
type ReportDesignImage ¶ added in v0.7.4
type ReportDesignImage struct {
Jpeg *string `json:"jpeg,omitempty"`
Png *string `json:"png,omitempty"`
}
ReportDesignImage An image in one of the two formats, standard base64 under the key that names it: exactly one of png and jpeg.
type ReportDesignInclude ¶ added in v0.7.4
type ReportDesignInclude string
ReportDesignInclude What a report design answer carries beyond the document.
const (
ReportDesignIncludeAssets ReportDesignInclude = "assets"
)
Defines values for ReportDesignInclude.
func (ReportDesignInclude) Valid ¶ added in v0.7.4
func (e ReportDesignInclude) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignInclude enum.
type ReportDesignList ¶ added in v0.7.4
type ReportDesignList struct {
// Default The default design's id; absent when none is.
Default *openapi_types.UUID `json:"default,omitempty"`
Designs []ReportDesignSummary `json:"designs"`
}
ReportDesignList The caller's library: the designs, oldest first, and which is the default. No `default` means no design is: a run then falls to the client's own choice, never Plain at the API.
type ReportDesignMargins ¶ added in v0.7.4
type ReportDesignMargins string
ReportDesignMargins The page's margins.
const ( ReportDesignMarginsNarrow ReportDesignMargins = "narrow" ReportDesignMarginsRegular ReportDesignMargins = "regular" ReportDesignMarginsWide ReportDesignMargins = "wide" )
Defines values for ReportDesignMargins.
func (ReportDesignMargins) Valid ¶ added in v0.7.4
func (e ReportDesignMargins) Valid() bool
Valid indicates whether the value is a known member of the ReportDesignMargins 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 ReportDesignRecord ¶ added in v0.7.4
type ReportDesignRecord struct {
CreatedAt time.Time `json:"createdAt"`
Default bool `json:"default"`
// Design A report design, the theme document version 3: a whole brand. 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 where it carries text (titleBlock `band`, headings `smallcaps` or `numbered`, or a cover that is drawn in the `band`, `largeType` or `plate` style, or `split` with no secondary) and 3:1 otherwise; the secondary 4.5:1 where a drawn `split` cover puts the brand on it and 3:1 otherwise; every text (`name`, the brand's lines, each header and footer slot) is one line with no control, line-break, bidirectional formatting or other invisible format characters; `brand.website` is a host name or an https address, drawn as text; a cover fact is named once; the custom cover's source is at most 32 KiB of text, its images at most six and 2 MB in all as stored, its thumbnail a PNG of at most 300 KB; each image's base64 holds a PNG or a JPEG within its bounds. Each colour's tint is derived: 12% of it over white. The ten built-in themes are each a value of it. `logo`, `coverImage` and `customCover` are optional, not counted in the 24 KB, answered only on `include=assets`, and null reads as none.
Design ReportDesign `json:"design"`
HasCoverImage bool `json:"hasCoverImage"`
HasCustomCover bool `json:"hasCustomCover"`
HasLogo bool `json:"hasLogo"`
Id openapi_types.UUID `json:"id"`
UpdatedAt time.Time `json:"updatedAt"`
}
ReportDesignRecord One design with its document in canonical form. The images are in the document only on `include=assets`; the three flags say which it has.
type ReportDesignSummary ¶ added in v0.7.4
type ReportDesignSummary struct {
// BasedOn The built-in theme it started from.
BasedOn string `json:"basedOn"`
CreatedAt time.Time `json:"createdAt"`
// Default Whether a run takes this design when the person picks none.
Default bool `json:"default"`
HasCoverImage bool `json:"hasCoverImage"`
HasCustomCover bool `json:"hasCustomCover"`
HasLogo bool `json:"hasLogo"`
Id openapi_types.UUID `json:"id"`
Name string `json:"name"`
UpdatedAt time.Time `json:"updatedAt"`
Version int `json:"version"`
}
ReportDesignSummary One design of the library, without its document's body or images.
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 ReportDesignUpdate ¶ added in v0.7.4
type ReportDesignUpdate struct {
// Design A report design, the theme document version 3: a whole brand. 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 where it carries text (titleBlock `band`, headings `smallcaps` or `numbered`, or a cover that is drawn in the `band`, `largeType` or `plate` style, or `split` with no secondary) and 3:1 otherwise; the secondary 4.5:1 where a drawn `split` cover puts the brand on it and 3:1 otherwise; every text (`name`, the brand's lines, each header and footer slot) is one line with no control, line-break, bidirectional formatting or other invisible format characters; `brand.website` is a host name or an https address, drawn as text; a cover fact is named once; the custom cover's source is at most 32 KiB of text, its images at most six and 2 MB in all as stored, its thumbnail a PNG of at most 300 KB; each image's base64 holds a PNG or a JPEG within its bounds. Each colour's tint is derived: 12% of it over white. The ten built-in themes are each a value of it. `logo`, `coverImage` and `customCover` are optional, not counted in the 24 KB, answered only on `include=assets`, and null reads as none.
Design ReportDesign `json:"design"`
}
ReportDesignUpdate defines model for ReportDesignUpdate.
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"`
// Subagents A persistent release's subagents (the manifest's `dependencies.agents`) as the scan resolved them against the registry, in the order the release declares them: the newest stable, published version each constraint admits that runs on its own and is not itself persistent, with what that version declares, or the reason none does. A subagent must be public, or, for a private release, private in the release's own organization; a private release the release may not use reads as one that is not in the registry. One that does not resolve is also a finding, `S7/subagent-unresolved`, which holds the version for a person. Absent for a release that declares none.
Subagents *[]SubagentScan `json:"subagents,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. `credits:session` opens, renews and ends a credits session, which pays for a run's model with the account's credits, and does nothing else: it is minted with no other scope, and every other route refuses a token carrying it, but for revoking itself. It is consumed only by a registry that mounts the credits extension.
const ( AgentManage Scope = "agent:manage" AgentPublish Scope = "agent:publish" AgentRead Scope = "agent:read" AuditRead Scope = "audit:read" CreditsSession Scope = "credits:session" 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), or `desktop` (applications on the person's own computer, through Agentry Desktop). 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) AddErasedAddressRememberer ¶ added in v0.6.1000
func (s *Server) AddErasedAddressRememberer(name string, fn ErasedAddressRememberer)
AddErasedAddressRememberer registers an extension's rememberer (pkg/extension.RemembersErasedAddresses), called in registration order inside the transaction of every account erasure, before the erasers. A name registered twice panics.
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) AgentVersion ¶ added in v0.6.1003
func (s *Server) AgentVersion(ctx context.Context, p *auth.Principal, ns, name, version string) (VersionState, bool, error)
AgentVersion is the core's read of one version for pkg/extension.Deps.Versions: whether p may read the agent at ns/name exactly as AgentReadable decides it, and then the version as the core's own version route shows it to a reader, whatever its status, with the published advisories whose range names it. An agent p may not read, an agent that does not exist and a version that does not exist are the same false with no error, as AgentReadable's are.
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) CreateOrgReportDesign ¶ added in v0.7.5
func (s *Server) CreateOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, params CreateOrgReportDesignParams)
CreateOrgReportDesign implements POST /orgs/{org}/report-designs.
func (*Server) CreateReportDesign ¶ added in v0.7.4
func (s *Server) CreateReportDesign(ctx context.Context, user uuid.UUID, document []byte) (*ReportDesignEntry, error)
CreateReportDesign adds a design to a person's library on their behalf, never as the default: the write behind the extension seam, for a design the hosted Report Designer made. The document is validated as a create is, its images encoded again; a refusal is a *reportdesign.FieldError, and ErrReportDesignsFull past the library's bound.
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) CreateUserReportDesign ¶ added in v0.7.4
func (s *Server) CreateUserReportDesign(w http.ResponseWriter, r *http.Request, params CreateUserReportDesignParams)
CreateUserReportDesign implements POST /user/report-designs.
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) DeleteOrgReportDesign ¶ added in v0.7.5
func (s *Server) DeleteOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
DeleteOrgReportDesign implements DELETE /orgs/{org}/report-designs/{designId}.
func (*Server) DeleteOrgReportDesignCoverImage ¶ added in v0.7.5
func (s *Server) DeleteOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
DeleteOrgReportDesignCoverImage implements DELETE /orgs/{org}/report-designs/{designId}/cover-image.
func (*Server) DeleteOrgReportDesignCustomCover ¶ added in v0.7.5
func (s *Server) DeleteOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
DeleteOrgReportDesignCustomCover implements DELETE /orgs/{org}/report-designs/{designId}/custom-cover.
func (*Server) DeleteOrgReportDesignLogo ¶ added in v0.7.5
func (s *Server) DeleteOrgReportDesignLogo(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
DeleteOrgReportDesignLogo implements DELETE /orgs/{org}/report-designs/{designId}/logo.
func (*Server) DeleteTeam ¶
DeleteTeam implements DELETE /orgs/{org}/teams/{team} (admin+).
func (*Server) DeleteUserReportDesign ¶ added in v0.7.4
func (s *Server) DeleteUserReportDesign(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
DeleteUserReportDesign implements DELETE /user/report-designs/{designId}.
func (*Server) DeleteUserReportDesignCoverImage ¶ added in v0.7.4
func (s *Server) DeleteUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
DeleteUserReportDesignCoverImage implements DELETE /user/report-designs/{designId}/cover-image.
func (*Server) DeleteUserReportDesignCustomCover ¶ added in v0.7.4
func (s *Server) DeleteUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
DeleteUserReportDesignCustomCover implements DELETE /user/report-designs/{designId}/custom-cover.
func (*Server) DeleteUserReportDesignLogo ¶ added in v0.7.4
func (s *Server) DeleteUserReportDesignLogo(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
DeleteUserReportDesignLogo implements DELETE /user/report-designs/{designId}/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) ErasedAddressKey ¶ added in v0.6.1000
ErasedAddressKey is an address's key for an extension that remembers erased accounts (pkg/extension.RemembersErasedAddresses): the normalized address under a key derived from the server's sealing key for this purpose alone, hex. Every form of one mailbox has the same key, and the key cannot be turned back into the address without the sealing key. It is not the tombstone's hash, which is of the address as stored.
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) GetDesktopApps ¶ added in v0.7.7
func (s *Server) GetDesktopApps(w http.ResponseWriter, r *http.Request)
GetDesktopApps implements GET /api/v1/desktop-apps: the catalogue of application servers this build carries, every entry whole. It serves the embedded catalogue alone, so it needs no store and no credential.
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) GetOrgReportDesign ¶ added in v0.7.5
func (s *Server) GetOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId, params GetOrgReportDesignParams)
GetOrgReportDesign implements GET /orgs/{org}/report-designs/{designId}.
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) GetUserReportDesign ¶ added in v0.7.4
func (s *Server) GetUserReportDesign(w http.ResponseWriter, r *http.Request, designId ReportDesignId, params GetUserReportDesignParams)
GetUserReportDesign implements GET /user/report-designs/{designId}.
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) ListOrgReportDesigns ¶ added in v0.7.5
ListOrgReportDesigns implements GET /orgs/{org}/report-designs.
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) ListUserReportDesigns ¶ added in v0.7.4
func (s *Server) ListUserReportDesigns(w http.ResponseWriter, r *http.Request)
ListUserReportDesigns implements GET /user/report-designs.
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. An account that is not active (suspended) is refused, and nothing is written. 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) PutOrgReportDesignCoverImage ¶ added in v0.7.5
func (s *Server) PutOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
PutOrgReportDesignCoverImage implements PUT /orgs/{org}/report-designs/{designId}/cover-image.
func (*Server) PutOrgReportDesignCustomCover ¶ added in v0.7.5
func (s *Server) PutOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
PutOrgReportDesignCustomCover implements PUT /orgs/{org}/report-designs/{designId}/custom-cover.
func (*Server) PutOrgReportDesignLogo ¶ added in v0.7.5
func (s *Server) PutOrgReportDesignLogo(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
PutOrgReportDesignLogo implements PUT /orgs/{org}/report-designs/{designId}/logo, as a person's own logo route reads and keeps the image.
func (*Server) PutUserReportDesignCoverImage ¶ added in v0.7.4
func (s *Server) PutUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
PutUserReportDesignCoverImage implements PUT /user/report-designs/{designId}/cover-image: one multipart part named file, PNG or JPEG, at most 2 MB, decoded, scaled down and encoded again in its own format by pkg/reportdesign, so only its pixels are kept.
func (*Server) PutUserReportDesignCustomCover ¶ added in v0.7.4
func (s *Server) PutUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
PutUserReportDesignCustomCover implements PUT /user/report-designs/{designId}/custom-cover: the custom cover whole as JSON, its source held to its bounds and never read, each image and the thumbnail decoded and encoded again by pkg/reportdesign.
func (*Server) PutUserReportDesignLogo ¶ added in v0.7.4
func (s *Server) PutUserReportDesignLogo(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
PutUserReportDesignLogo implements PUT /user/report-designs/{designId}/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. Read the same way as the organization's logo (readUploadPart), at this image'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) ReportDesignByID ¶ added in v0.7.4
func (s *Server) ReportDesignByID(ctx context.Context, user, id uuid.UUID) (*ReportDesignEntry, error)
ReportDesignByID is one of a person's designs with its images, or nil when the id is not one of theirs.
func (*Server) ReportDesignDefault ¶ added in v0.7.4
func (s *Server) ReportDesignDefault(ctx context.Context, user uuid.UUID) (*ReportDesignEntry, error)
ReportDesignDefault is a person's default design with its images, or nil when they have none, which is not Plain: the reader decides what nothing means. It is the read behind the extension seam. A stored design that no longer validates reads as none, and is logged.
func (*Server) ReportDesignForMember ¶ added in v0.7.5
func (s *Server) ReportDesignForMember(ctx context.Context, user uuid.UUID, org, name string) (*ReportDesignEntry, error)
ReportDesignForMember is one of an organization's house designs, by the organization's handle and the design's name, with its images, as a member's run reads it: nil when the organization is not one a run can read (unknown, or erased), when the person is not an active member of it, or when it has no design of that name. Membership is read here, at the call, so a former member's run is refused the design whatever it was handed earlier. It is the read behind the extension seam.
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 — only while the account is active, 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) SetExtensionCreditsSessions ¶ added in v0.7.0
SetExtensionCreditsSessions names the routes of the extension registered as name that open, renew and end a credits session: the only paths on which a token carrying auth.ScopeCreditsSession is let through to a handler. Routes are "METHOD /path" relative to the mount, with "{name}" wildcards allowed as whole segments. The handler still requires the scope itself. A malformed route, an empty list, a second call or an unknown extension panics at start-up, where it is found.
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) SetUserReportDesignDefault ¶ added in v0.7.4
func (s *Server) SetUserReportDesignDefault(w http.ResponseWriter, r *http.Request)
SetUserReportDesignDefault implements PUT /user/report-designs/default.
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) UpdateOrgReportDesign ¶ added in v0.7.5
func (s *Server) UpdateOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId, params UpdateOrgReportDesignParams)
UpdateOrgReportDesign implements PUT /orgs/{org}/report-designs/{designId}.
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 five exceptions. billing, schedules, bugReports, runFailures and runFinished may be omitted, and an omitted one keeps the row's value: clients predate them, and reading an absence as a value would move a switch the client never showed, off for the first three and never on for the run kinds. The keep is the statement's own (COALESCE in the upsert), so two clients writing at once cannot resurrect a value neither sent. A write that leaves out a required switch is refused with 422 and changes nothing.
func (*Server) UpdateUserReportDesign ¶ added in v0.7.4
func (s *Server) UpdateUserReportDesign(w http.ResponseWriter, r *http.Request, designId ReportDesignId, params UpdateUserReportDesignParams)
UpdateUserReportDesign implements PUT /user/report-designs/{designId}.
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)
// GetDesktopApps Agentry's catalogue of application servers.
// (GET /desktop-apps)
GetDesktopApps(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)
// ListOrgReportDesigns The organization's house report designs, for any active member.
// (GET /orgs/{org}/report-designs)
ListOrgReportDesigns(w http.ResponseWriter, r *http.Request, org OrgHandle)
// CreateOrgReportDesign Add a house report design to the organization's library (admins).
// (POST /orgs/{org}/report-designs)
CreateOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, params CreateOrgReportDesignParams)
// DeleteOrgReportDesign Remove one of the organization's house report designs, images included (admins).
// (DELETE /orgs/{org}/report-designs/{designId})
DeleteOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
// GetOrgReportDesign One of the organization's house report designs, for any active member.
// (GET /orgs/{org}/report-designs/{designId})
GetOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId, params GetOrgReportDesignParams)
// UpdateOrgReportDesign Replace one of the organization's house report designs (admins).
// (PUT /orgs/{org}/report-designs/{designId})
UpdateOrgReportDesign(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId, params UpdateOrgReportDesignParams)
// DeleteOrgReportDesignCoverImage Remove the cover image from one of the organization's house report designs (admins).
// (DELETE /orgs/{org}/report-designs/{designId}/cover-image)
DeleteOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
// PutOrgReportDesignCoverImage Set the cover image of one of the organization's house report designs (admins).
// (PUT /orgs/{org}/report-designs/{designId}/cover-image)
PutOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
// DeleteOrgReportDesignCustomCover Remove the custom cover from one of the organization's house report designs (admins).
// (DELETE /orgs/{org}/report-designs/{designId}/custom-cover)
DeleteOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
// PutOrgReportDesignCustomCover Set the custom cover of one of the organization's house report designs (admins).
// (PUT /orgs/{org}/report-designs/{designId}/custom-cover)
PutOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
// DeleteOrgReportDesignLogo Remove the logo from one of the organization's house report designs (admins).
// (DELETE /orgs/{org}/report-designs/{designId}/logo)
DeleteOrgReportDesignLogo(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
// PutOrgReportDesignLogo Set the logo of one of the organization's house report designs (admins).
// (PUT /orgs/{org}/report-designs/{designId}/logo)
PutOrgReportDesignLogo(w http.ResponseWriter, r *http.Request, org OrgHandle, designId ReportDesignId)
// 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)
// ListUserReportDesigns The caller's report design library.
// (GET /user/report-designs)
ListUserReportDesigns(w http.ResponseWriter, r *http.Request)
// CreateUserReportDesign Add a report design to the caller's library.
// (POST /user/report-designs)
CreateUserReportDesign(w http.ResponseWriter, r *http.Request, params CreateUserReportDesignParams)
// SetUserReportDesignDefault Set which of the caller's designs their runs take by default.
// (PUT /user/report-designs/default)
SetUserReportDesignDefault(w http.ResponseWriter, r *http.Request)
// DeleteUserReportDesign Remove one of the caller's report designs, images included.
// (DELETE /user/report-designs/{designId})
DeleteUserReportDesign(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
// GetUserReportDesign One of the caller's report designs.
// (GET /user/report-designs/{designId})
GetUserReportDesign(w http.ResponseWriter, r *http.Request, designId ReportDesignId, params GetUserReportDesignParams)
// UpdateUserReportDesign Replace one of the caller's report designs.
// (PUT /user/report-designs/{designId})
UpdateUserReportDesign(w http.ResponseWriter, r *http.Request, designId ReportDesignId, params UpdateUserReportDesignParams)
// DeleteUserReportDesignCoverImage Remove the cover image from one of the caller's report designs.
// (DELETE /user/report-designs/{designId}/cover-image)
DeleteUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
// PutUserReportDesignCoverImage Set the cover image of one of the caller's report designs.
// (PUT /user/report-designs/{designId}/cover-image)
PutUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
// DeleteUserReportDesignCustomCover Remove the custom cover from one of the caller's report designs.
// (DELETE /user/report-designs/{designId}/custom-cover)
DeleteUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
// PutUserReportDesignCustomCover Set the custom cover of one of the caller's report designs.
// (PUT /user/report-designs/{designId}/custom-cover)
PutUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
// DeleteUserReportDesignLogo Remove the logo from one of the caller's report designs.
// (DELETE /user/report-designs/{designId}/logo)
DeleteUserReportDesignLogo(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
// PutUserReportDesignLogo Set the logo of one of the caller's report designs.
// (PUT /user/report-designs/{designId}/logo)
PutUserReportDesignLogo(w http.ResponseWriter, r *http.Request, designId ReportDesignId)
// 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) CreateOrgReportDesign ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) CreateOrgReportDesign(w http.ResponseWriter, r *http.Request)
CreateOrgReportDesign 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) CreateUserReportDesign ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) CreateUserReportDesign(w http.ResponseWriter, r *http.Request)
CreateUserReportDesign 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) DeleteOrgReportDesign ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) DeleteOrgReportDesign(w http.ResponseWriter, r *http.Request)
DeleteOrgReportDesign operation middleware
func (*ServerInterfaceWrapper) DeleteOrgReportDesignCoverImage ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) DeleteOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request)
DeleteOrgReportDesignCoverImage operation middleware
func (*ServerInterfaceWrapper) DeleteOrgReportDesignCustomCover ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) DeleteOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request)
DeleteOrgReportDesignCustomCover operation middleware
func (*ServerInterfaceWrapper) DeleteOrgReportDesignLogo ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) DeleteOrgReportDesignLogo(w http.ResponseWriter, r *http.Request)
DeleteOrgReportDesignLogo operation middleware
func (*ServerInterfaceWrapper) DeleteTeam ¶
func (siw *ServerInterfaceWrapper) DeleteTeam(w http.ResponseWriter, r *http.Request)
DeleteTeam operation middleware
func (*ServerInterfaceWrapper) DeleteUserReportDesign ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) DeleteUserReportDesign(w http.ResponseWriter, r *http.Request)
DeleteUserReportDesign operation middleware
func (*ServerInterfaceWrapper) DeleteUserReportDesignCoverImage ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) DeleteUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request)
DeleteUserReportDesignCoverImage operation middleware
func (*ServerInterfaceWrapper) DeleteUserReportDesignCustomCover ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) DeleteUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request)
DeleteUserReportDesignCustomCover operation middleware
func (*ServerInterfaceWrapper) DeleteUserReportDesignLogo ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) DeleteUserReportDesignLogo(w http.ResponseWriter, r *http.Request)
DeleteUserReportDesignLogo 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) GetDesktopApps ¶ added in v0.7.7
func (siw *ServerInterfaceWrapper) GetDesktopApps(w http.ResponseWriter, r *http.Request)
GetDesktopApps 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) GetOrgReportDesign ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) GetOrgReportDesign(w http.ResponseWriter, r *http.Request)
GetOrgReportDesign 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) GetUserReportDesign ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) GetUserReportDesign(w http.ResponseWriter, r *http.Request)
GetUserReportDesign 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) ListOrgReportDesigns ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) ListOrgReportDesigns(w http.ResponseWriter, r *http.Request)
ListOrgReportDesigns 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) ListUserReportDesigns ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) ListUserReportDesigns(w http.ResponseWriter, r *http.Request)
ListUserReportDesigns 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) PutOrgReportDesignCoverImage ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) PutOrgReportDesignCoverImage(w http.ResponseWriter, r *http.Request)
PutOrgReportDesignCoverImage operation middleware
func (*ServerInterfaceWrapper) PutOrgReportDesignCustomCover ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) PutOrgReportDesignCustomCover(w http.ResponseWriter, r *http.Request)
PutOrgReportDesignCustomCover operation middleware
func (*ServerInterfaceWrapper) PutOrgReportDesignLogo ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) PutOrgReportDesignLogo(w http.ResponseWriter, r *http.Request)
PutOrgReportDesignLogo operation middleware
func (*ServerInterfaceWrapper) PutUserReportDesignCoverImage ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) PutUserReportDesignCoverImage(w http.ResponseWriter, r *http.Request)
PutUserReportDesignCoverImage operation middleware
func (*ServerInterfaceWrapper) PutUserReportDesignCustomCover ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) PutUserReportDesignCustomCover(w http.ResponseWriter, r *http.Request)
PutUserReportDesignCustomCover operation middleware
func (*ServerInterfaceWrapper) PutUserReportDesignLogo ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) PutUserReportDesignLogo(w http.ResponseWriter, r *http.Request)
PutUserReportDesignLogo 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) SetUserReportDesignDefault ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) SetUserReportDesignDefault(w http.ResponseWriter, r *http.Request)
SetUserReportDesignDefault 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) UpdateOrgReportDesign ¶ added in v0.7.5
func (siw *ServerInterfaceWrapper) UpdateOrgReportDesign(w http.ResponseWriter, r *http.Request)
UpdateOrgReportDesign operation middleware
func (*ServerInterfaceWrapper) UpdateUserNotificationSettings ¶
func (siw *ServerInterfaceWrapper) UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)
UpdateUserNotificationSettings operation middleware
func (*ServerInterfaceWrapper) UpdateUserReportDesign ¶ added in v0.7.4
func (siw *ServerInterfaceWrapper) UpdateUserReportDesign(w http.ResponseWriter, r *http.Request)
UpdateUserReportDesign 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 SetUserReportDesignDefaultJSONRequestBody ¶ added in v0.7.4
type SetUserReportDesignDefaultJSONRequestBody = ReportDesignDefault
SetUserReportDesignDefaultJSONRequestBody defines body for SetUserReportDesignDefault 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 SubagentReach ¶ added in v0.6.1002
type SubagentReach struct {
// Browser Its browser's scope; absent for none.
Browser *SubagentReachBrowser `json:"browser,omitempty"`
// Egress The hosts it may reach, its own and its servers' (`*` for any).
Egress *[]string `json:"egress,omitempty"`
// Exec The commands it may run.
Exec *[]string `json:"exec,omitempty"`
// Secrets The secrets it asks for, its own and its servers'.
Secrets *[]string `json:"secrets,omitempty"`
// Servers Its declared MCP servers, by source id.
Servers *[]string `json:"servers,omitempty"`
// TargetHosts How many target hosts it asks for.
TargetHosts *int `json:"targetHosts,omitempty"`
}
SubagentReach What a subagent's resolved version declares.
type SubagentReachBrowser ¶ added in v0.6.1002
type SubagentReachBrowser string
SubagentReachBrowser Its browser's scope; absent for none.
const ( SubagentReachBrowserPublic SubagentReachBrowser = "public" SubagentReachBrowserSite SubagentReachBrowser = "site" )
Defines values for SubagentReachBrowser.
func (SubagentReachBrowser) Valid ¶ added in v0.6.1002
func (e SubagentReachBrowser) Valid() bool
Valid indicates whether the value is a known member of the SubagentReachBrowser enum.
type SubagentScan ¶ added in v0.6.1002
type SubagentScan struct {
// Constraint The semver constraint the release declares.
Constraint string `json:"constraint"`
// Problem Why it does not resolve; absent when it does.
Problem *string `json:"problem,omitempty"`
// Reach What a subagent's resolved version declares.
Reach *SubagentReach `json:"reach,omitempty"`
// Ref The subagent's `namespace/name`.
Ref string `json:"ref"`
// Version The version it resolved to; absent when none did.
Version *string `json:"version,omitempty"`
// Why The release's reason for it, shown when a person agrees.
Why *string `json:"why,omitempty"`
}
SubagentScan defines model for SubagentScan.
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 UpdateOrgReportDesignJSONRequestBody ¶ added in v0.7.5
type UpdateOrgReportDesignJSONRequestBody = ReportDesignUpdate
UpdateOrgReportDesignJSONRequestBody defines body for UpdateOrgReportDesign for application/json ContentType.
type UpdateOrgReportDesignParams ¶ added in v0.7.5
type UpdateOrgReportDesignParams struct {
// Include `assets` answers the design with its images (`logo`, `coverImage`, `customCover`), if it has them. Without it the document comes without those keys, so a client that does not draw them reads it whole and small.
Include *ReportDesignInclude `form:"include,omitempty" json:"include,omitempty"`
}
UpdateOrgReportDesignParams defines parameters for UpdateOrgReportDesign.
type UpdateUserNotificationSettingsJSONRequestBody ¶
type UpdateUserNotificationSettingsJSONRequestBody = NotificationSettings
UpdateUserNotificationSettingsJSONRequestBody defines body for UpdateUserNotificationSettings for application/json ContentType.
type UpdateUserReportDesignJSONRequestBody ¶ added in v0.7.4
type UpdateUserReportDesignJSONRequestBody = ReportDesignUpdate
UpdateUserReportDesignJSONRequestBody defines body for UpdateUserReportDesign for application/json ContentType.
type UpdateUserReportDesignParams ¶ added in v0.7.4
type UpdateUserReportDesignParams struct {
// Include `assets` answers the design with its images (`logo`, `coverImage`, `customCover`), if it has them. Without it the document comes without those keys, so a client that does not draw them reads it whole and small.
Include *ReportDesignInclude `form:"include,omitempty" json:"include,omitempty"`
}
UpdateUserReportDesignParams defines parameters for UpdateUserReportDesign.
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 VersionAdvisory ¶ added in v0.6.1003
type VersionAdvisory struct {
ID uuid.UUID
Severity string
Summary string
AffectedVersions string
PublishedAt time.Time
FixedIn string
RangeUnreadable bool
}
VersionAdvisory is one advisory that names a version. FixedIn is the lowest published version above it that the advisory's range leaves out, on the version's own channel, or empty when none is published yet. RangeUnreadable is true when the range does not parse as a semver constraint: such an advisory is counted as naming every version, since the core cannot say it does not, and it names no fix.
type VersionState ¶ added in v0.6.1003
type VersionState struct {
Agent registry.Agent
Version string
Status registry.Status
Advisories []VersionAdvisory
}
VersionState is what AgentVersion answers of one version of an agent: the agent as AgentReadable answers it, the version's lifecycle status, and the advisories whose range names it.
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 The events the endpoint subscribes to, by name, from the closed catalogue: agent.created, version.submitted, version.published, version.rejected, version.needs_review, version.yanked, agent.quarantined, agent.reinstated, advisory.published, agent.dependency_alert, scan.completed, member.added, member.removed, policy.updated and run.ended (a run of one of the organization's QuickAgents In Agentry ended; delivered only where the registry runs QuickAgents). A name outside the catalogue is refused with 422.
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
- erased_address.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_org_report_designs.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_designs.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