api

package
v0.7.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 3, 2026 License: MIT Imports: 87 Imported by: 0

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

View Source
const (
	DirectoryErasureDeleted       = dirEraseDeleted
	DirectoryErasureNotFound      = dirEraseNotFound
	DirectoryErasureUnresolved    = dirEraseUnresolved
	DirectoryErasureNotConfigured = dirEraseNotConfigured
	DirectoryErasureFailed        = dirEraseFailed
	DirectoryErasurePending       = dirErasePending
)

The outcomes the erasure's response reports for the directory half.

The two account clears.

View Source
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"
)
View Source
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"
)
View Source
const JobOrgDecommissionSweep = "org.decommission_sweep"

JobOrgDecommissionSweep is the queue kind of the hourly sweep that erases organizations whose decommission hold has ended.

View Source
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.

View Source
const ProblemTypeBase = "https://agentry.dev/problems/"

ProblemTypeBase prefixes stable problem type URIs. The domain is a placeholder.

View Source
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.

View Source
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.

View Source
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

View Source
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.

View Source
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.

View Source
var ErrNoSecondFactor = errors.New("api: a remembered browser needs a sign-in that answered a second factor just now")

ErrNoSecondFactor is the remembered browser's refusal of a sign-in whose evidence does not show a second factor answered just now.

Functions

func AllMountAuthzDecls

func AllMountAuthzDecls() map[string]MountDecl

AllMountAuthzDecls returns a copy of the root-mount table (tests, docs).

func AllRouteAuthzDecls

func AllRouteAuthzDecls() map[string]RouteDecl

AllRouteAuthzDecls returns a copy of the declaration table (tests, docs).

func GetSpec

func GetSpec() (swagger *openapi3.T, err error)

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

func GetSpecJSON() ([]byte, error)

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 GetSwagger() (*openapi3.T, error)

GetSwagger returns the OpenAPI specification corresponding to the generated code in this file.

Deprecated: GetSwagger predates kin-openapi renaming openapi3.Swagger to openapi3.T. Use GetSpec instead. This wrapper is retained for backwards compatibility.

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

func Mount(mux httpmux.Mux, pattern string, handler http.Handler)

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 MountFunc

func MountFunc(mux httpmux.Mux, pattern string, handler func(http.ResponseWriter, *http.Request))

MountFunc is Mount for a bare handler function.

func NewHandler

func NewHandler(s *Server) http.Handler

NewHandler assembles the full HTTP handler for the api role.

func NewHandlerWithGit

func NewHandlerWithGit(s *Server, mountGit func(httpmux.Mux)) http.Handler

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

func NormalizeOpID(id string) string

NormalizeOpID canonicalizes an operationId: the generator capitalizes ids in the embedded spec, while the table uses the YAML's camelCase.

func PathToRawSpec

func PathToRawSpec(pathToFile string) map[string]func() ([]byte, error)

Constructs a synthetic filesystem for resolving external references when loading openapi specifications.

func PendingDigestPeriod

func PendingDigestPeriod(cfg config.Config) time.Duration

PendingDigestPeriod is how often the worker enqueues the digest: the configured period, or a day when the configuration names none.

func PrincipalFrom

func PrincipalFrom(ctx context.Context) *auth.Principal

PrincipalFrom is principalFrom for extension routes.

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

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

type AccountOrg struct {
	Handle string
	Role   string
	State  string
}

AccountOrg is one of the account's memberships.

type AccountSession added in v0.6.1000

type AccountSession struct {
	CreatedAt  time.Time
	LastSeenAt time.Time
	Client     string
}

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

type ActivationTooSoonError struct{ After time.Time }

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.

const (
	Autonomous  AgentMode = "autonomous"
	Interactive AgentMode = "interactive"
	Persistent  AgentMode = "persistent"
)

Defines values for AgentMode.

func (AgentMode) Valid

func (e AgentMode) Valid() bool

Valid indicates whether the value is a known member of the AgentMode enum.

type AgentModes

type AgentModes = []AgentMode

AgentModes The run modes a release supports; at least one.

type AgentName

type AgentName = string

AgentName defines model for AgentName.

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.

const (
	Maintain AgentRole = "maintain"
	Publish  AgentRole = "publish"
	Read     AgentRole = "read"
	Write    AgentRole = "write"
)

Defines values for AgentRole.

func (AgentRole) Valid

func (e AgentRole) Valid() bool

Valid indicates whether the value is a known member of the AgentRole enum.

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.

Defines values for AgentVersionManifestSchemaVersion.

func (AgentVersionManifestSchemaVersion) Valid

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

Valid indicates whether the value is a known member of the CreateAgentRequestVisibility enum.

type CreateAuditExportJSONBody

type CreateAuditExportJSONBody struct {
	// Action Optional action filter.
	Action *string `json:"action,omitempty"`
}

CreateAuditExportJSONBody defines parameters for CreateAuditExport.

type CreateAuditExportJSONRequestBody

type CreateAuditExportJSONRequestBody CreateAuditExportJSONBody

CreateAuditExportJSONRequestBody defines body for CreateAuditExport for application/json ContentType.

type CreateDesktopGrantJSONRequestBody

type CreateDesktopGrantJSONRequestBody = DesktopGrantRequest

CreateDesktopGrantJSONRequestBody defines body for CreateDesktopGrant for application/json ContentType.

type CreateDomainClaimJSONBody

type CreateDomainClaimJSONBody struct {
	Domain string `json:"domain"`
}

CreateDomainClaimJSONBody defines parameters for CreateDomainClaim.

type CreateDomainClaimJSONRequestBody

type CreateDomainClaimJSONRequestBody CreateDomainClaimJSONBody

CreateDomainClaimJSONRequestBody defines body for CreateDomainClaim for application/json ContentType.

type CreateInvitationJSONRequestBody

type CreateInvitationJSONRequestBody = CreateInvitationRequest

CreateInvitationJSONRequestBody defines body for CreateInvitation for application/json ContentType.

type CreateInvitationRequest

type CreateInvitationRequest struct {
	Email string `json:"email"`

	// Role The role a PUT assigns. security_reviewer is refused outside a first-party organization. `owner` is accepted by the schema but refused with a 422 that names the roles that exist.
	Role *OrgRoleAssignment `json:"role,omitempty"`
}

CreateInvitationRequest defines model for CreateInvitationRequest.

type CreateKnowledgePackJSONRequestBody

type CreateKnowledgePackJSONRequestBody = CreateKnowledgePackRequest

CreateKnowledgePackJSONRequestBody defines body for CreateKnowledgePack for application/json ContentType.

type CreateKnowledgePackRequest

type CreateKnowledgePackRequest struct {
	Name string `json:"name"`

	// WrappedKey A pack's data key as a wrapper sealed it: the wrapper's `kind` (`deployment` on a core registry), the `recipient` it is wrapped to (a key's id, never a key), and the sealed bytes.
	WrappedKey KnowledgeWrappedKey `json:"wrappedKey"`
}

CreateKnowledgePackRequest defines model for CreateKnowledgePackRequest.

type CreateOrgJSONRequestBody

type CreateOrgJSONRequestBody = CreateOrgRequest

CreateOrgJSONRequestBody defines body for CreateOrg for application/json ContentType.

type CreateOrgKnowledgePackJSONRequestBody

type CreateOrgKnowledgePackJSONRequestBody = CreateKnowledgePackRequest

CreateOrgKnowledgePackJSONRequestBody defines body for CreateOrgKnowledgePack for application/json ContentType.

type CreateOrgRequest

type CreateOrgRequest struct {
	DisplayName string `json:"displayName"`

	// Domain The domain the organization is keyed on. Omitted, it is the domain of the creator's verified email address; `none` records no domain; the creator's own domain, spelled out, is accepted. Any other value is 422 — a further domain is claimed over DNS (`POST /orgs/{org}/domain-claims`). A domain no single organization owns (a public mail provider, a reserved name) is recorded as none whatever is sent. A domain that already belongs to an organization is `409 domain-claimed`.
	Domain *string `json:"domain,omitempty"`
	Handle string  `json:"handle"`
}

CreateOrgRequest defines model for CreateOrgRequest.

type CreateRulesetReleaseJSONBody

type CreateRulesetReleaseJSONBody struct {
	// BundleDigest sha256:<hex> of the bundle.
	BundleDigest *string `json:"bundleDigest,omitempty"`
	Notes        *string `json:"notes,omitempty"`
	Semver       *string `json:"semver,omitempty"`
}

CreateRulesetReleaseJSONBody defines parameters for CreateRulesetRelease.

type CreateRulesetReleaseJSONRequestBody

type CreateRulesetReleaseJSONRequestBody CreateRulesetReleaseJSONBody

CreateRulesetReleaseJSONRequestBody defines body for CreateRulesetRelease for application/json ContentType.

type CreateTeamJSONBody

type CreateTeamJSONBody struct {
	Slug string `json:"slug"`
}

CreateTeamJSONBody defines parameters for CreateTeam.

type CreateTeamJSONRequestBody

type CreateTeamJSONRequestBody CreateTeamJSONBody

CreateTeamJSONRequestBody defines body for CreateTeam for application/json ContentType.

type CreateTokenJSONRequestBody

type CreateTokenJSONRequestBody = CreateTokenRequest

CreateTokenJSONRequestBody defines body for CreateToken for application/json ContentType.

type CreateTokenRequest

type CreateTokenRequest struct {
	// ExpiresAt Defaults to the max PAT lifetime; a later value is refused with 422, not clamped.
	ExpiresAt *time.Time `json:"expiresAt,omitempty"`
	Name      string     `json:"name"`

	// OrgHandle Bind the token to this org. Requires the current session to be SSO-fresh for the org; org-bound tokens live at most 90 days (a later expiresAt is refused with 422) and are the only tokens accepted against an enforced-SSO org's resources.
	OrgHandle *string `json:"orgHandle,omitempty"`
	Scopes    []Scope `json:"scopes"`
}

CreateTokenRequest defines model for CreateTokenRequest.

type CreateWebhookJSONRequestBody

type CreateWebhookJSONRequestBody = WebhookInput

CreateWebhookJSONRequestBody defines body for CreateWebhook for application/json ContentType.

type CreatedInvitation

type CreatedInvitation struct {
	// AcceptUrl Where the invited person accepts it.
	AcceptUrl string    `json:"acceptUrl"`
	CreatedAt time.Time `json:"createdAt"`
	Email     string    `json:"email"`

	// Expired An expired invitation holds no seat and cannot be accepted.
	Expired   *bool              `json:"expired,omitempty"`
	ExpiresAt time.Time          `json:"expiresAt"`
	Id        openapi_types.UUID `json:"id"`

	// InvitedBy The handle of the admin who sent it.
	InvitedBy *string `json:"invitedBy,omitempty"`

	// Mailed Whether the invitation was mailed. It is not when the address belongs to no account, to an account whose address the registry has not verified, or to someone who has turned organization-invitation mail off — the registry mails no address it has not confirmed.
	Mailed bool `json:"mailed"`

	// Role An organization role, ordered admin > security_reviewer | member. Admins manage the organization, its members, settings and sign-in policy, and hold the security reviewer's powers; security_reviewer is a platform-internal role that exists only inside a first-party organization; there is no owner role, only admins. An organization always keeps one admin: demoting or removing the last one is 409 last-admin.
	Role OrgRole `json:"role"`

	// Token The credential, shown once and never again: the registry keeps only its SHA-256. Give it to the person you invited if it was not mailed to them.
	Token string `json:"token"`
}

CreatedInvitation defines model for CreatedInvitation.

type Cursor

type Cursor = string

Cursor defines model for Cursor.

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

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.

Defines values for DeleteCurrentUserParamsPublishedContent.

func (DeleteCurrentUserParamsPublishedContent) Valid

Valid indicates whether the value is a known member of the DeleteCurrentUserParamsPublishedContent enum.

type DependencyAlert

type DependencyAlert struct {
	AdvisoryIds []string `json:"advisoryIds"`

	// Agent namespace/name
	Agent     string                   `json:"agent"`
	CreatedAt time.Time                `json:"createdAt"`
	Ecosystem DependencyAlertEcosystem `json:"ecosystem"`

	// FixedIn Server versions the advisories name as fixed.
	FixedIn        []string                `json:"fixedIn"`
	Id             openapi_types.UUID      `json:"id"`
	Package        string                  `json:"package"`
	PackageVersion string                  `json:"packageVersion"`
	Severity       DependencyAlertSeverity `json:"severity"`

	// Version The affected published version.
	Version string `json:"version"`
}

DependencyAlert A published version declares an MCP server version with a newly known high or critical vulnerability.

type DependencyAlertEcosystem

type DependencyAlertEcosystem string

DependencyAlertEcosystem defines model for DependencyAlert.Ecosystem.

const (
	DependencyAlertEcosystemNpm  DependencyAlertEcosystem = "npm"
	DependencyAlertEcosystemPypi DependencyAlertEcosystem = "pypi"
)

Defines values for DependencyAlertEcosystem.

func (DependencyAlertEcosystem) Valid

func (e DependencyAlertEcosystem) Valid() bool

Valid indicates whether the value is a known member of the DependencyAlertEcosystem enum.

type DependencyAlertSeverity

type DependencyAlertSeverity string

DependencyAlertSeverity defines model for DependencyAlert.Severity.

const (
	DependencyAlertSeverityCritical DependencyAlertSeverity = "critical"
	DependencyAlertSeverityHigh     DependencyAlertSeverity = "high"
)

Defines values for DependencyAlertSeverity.

func (DependencyAlertSeverity) Valid

func (e DependencyAlertSeverity) Valid() bool

Valid indicates whether the value is a known member of the DependencyAlertSeverity enum.

type DesktopExchangeRequest

type DesktopExchangeRequest struct {
	Code  string `json:"code"`
	State string `json:"state"`
}

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

type DirectoryDevice struct {
	ID        string
	Kind      string
	Name      string
	CreatedAt *time.Time
}

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 struct {
	AccountID int64
	UID       string
	Email     string
}

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.
	DirectoryLookupAddressShared DirectoryLookup = "address-shared"
	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

type DirectorySource struct {
	Slug string
	Name string
}

DirectorySource is a social provider as the directory names it.

type DomainClaim

type DomainClaim struct {
	Domain string `json:"domain"`

	// RecordName The DNS TXT record name to create.
	RecordName *string `json:"recordName,omitempty"`

	// RecordValue The DNS TXT record value to publish.
	RecordValue       *string    `json:"recordValue,omitempty"`
	VerificationToken string     `json:"verificationToken"`
	Verified          bool       `json:"verified"`
	VerifiedAt        *time.Time `json:"verifiedAt,omitempty"`
}

DomainClaim defines model for DomainClaim.

type DomainOrg

type DomainOrg struct {
	// Domain The caller's verified email domain; empty for an address at a shared domain.
	Domain string `json:"domain"`

	// Member Whether the caller already holds a membership there, pending or active.
	Member *bool `json:"member,omitempty"`

	// Org Absent when no organization holds the domain.
	Org *struct {
		DisplayName string `json:"displayName"`
		Handle      string `json:"handle"`
	} `json:"org,omitempty"`

	// RequestedToday Whether the caller already asked its administrators for access in the last day.
	RequestedToday *bool `json:"requestedToday,omitempty"`
}

DomainOrg Which organization, if any, the caller's verified email domain belongs to — recorded at the organization's creation or verified over DNS by it. A domain no single organization owns (a public mail provider) belongs to nobody.

type DraftCheck

type DraftCheck struct {
	Draft DraftSetCheck `json:"draft"`

	// Model The pinned judge model, such as `jev-1.13.0`.
	Model  string           `json:"model"`
	Rubric DraftRubricCheck `json:"rubric"`

	// Ungranted Each runner tool the instruction calls for that the manifest does not grant, in the order the instruction first names them, at most 50; empty when every tool it names is granted. A word longer than 80 bytes is not read as a tool name. Any one sends the version to a person at publish (`S6/ungranted-tool`). A tool named only where the instruction turns it away ("not `browser_pdf_save`"), and one in a paragraph that speaks of another package as "a QuickAgent", is not listed. Read with no judge, so it is answered when both halves are `not_scanned`.
	Ungranted []DraftUngrantedTool `json:"ungranted"`

	// Usage The judge's requests and input tokens, for the record. Never a price: AI Review is charged per operation.
	Usage ModelInputUsage `json:"usage"`
}

DraftCheck defines model for DraftCheck.

type DraftCheckFailure

type DraftCheckFailure string

DraftCheckFailure Why a half was not scanned: the judge timed out, failed, or (the draft set only) a part of the draft is past its bound.

const (
	DraftCheckFailureJudgeError DraftCheckFailure = "judge-error"
	DraftCheckFailureTimeout    DraftCheckFailure = "timeout"
	DraftCheckFailureTooLarge   DraftCheckFailure = "too-large"
)

Defines values for DraftCheckFailure.

func (DraftCheckFailure) Valid

func (e DraftCheckFailure) Valid() bool

Valid indicates whether the value is a known member of the DraftCheckFailure enum.

type DraftCheckFile

type DraftCheckFile struct {
	// Content The file's text, UTF-8.
	Content string `json:"content"`

	// Path The file's path in the package, relative and clean.
	Path string `json:"path"`
}

DraftCheckFile defines model for DraftCheckFile.

type DraftCheckRequest

type DraftCheckRequest struct {
	// Description The person's description the draft was made from, as the Drafter read it. It is asked about as data, beside the draft.
	Description string `json:"description"`

	// Files Every text file of the rendered package, `agent.yaml` and the instruction file among them; at most 65,536 bytes in all.
	Files []DraftCheckFile `json:"files"`
}

DraftCheckRequest defines model for DraftCheckRequest.

type DraftCheckVerdict

type DraftCheckVerdict string

DraftCheckVerdict `flagged`: in the rubric half, a high finding (one the gate sends to a person); in the draft half, a question scored 2 or more. `pass`: neither, though the rubric half may list medium findings as notes. `not_scanned`: the judge could not answer for this half.

const (
	DraftCheckVerdictFlagged    DraftCheckVerdict = "flagged"
	DraftCheckVerdictNotScanned DraftCheckVerdict = "not_scanned"
	DraftCheckVerdictPass       DraftCheckVerdict = "pass"
)

Defines values for DraftCheckVerdict.

func (DraftCheckVerdict) Valid

func (e DraftCheckVerdict) Valid() bool

Valid indicates whether the value is a known member of the DraftCheckVerdict enum.

type DraftChecker

type DraftChecker interface {
	Check(ctx context.Context, p draftcheck.Package) (draftcheck.Result, error)
}

DraftChecker reads a finished draft with the release rubric and the draft question set: *draftcheck.Checker.

type DraftRubricCheck

type DraftRubricCheck struct {
	// Failure Why a half was not scanned: the judge timed out, failed, or (the draft set only) a part of the draft is past its bound.
	Failure *DraftCheckFailure `json:"failure,omitempty"`

	// Findings What S5 would record as findings. A high one sends the version to a person and makes the verdict `flagged`; a medium one is a note and leaves the verdict `pass`.
	Findings []DraftRubricFinding `json:"findings"`

	// RubricHash The rubric hash S5 records under the same model.
	RubricHash string `json:"rubricHash"`

	// Scores Per rubric question, 0 to 3, as S5 scores it.
	Scores *DraftRubricScores `json:"scores,omitempty"`

	// Verdict `flagged`: in the rubric half, a high finding (one the gate sends to a person); in the draft half, a question scored 2 or more. `pass`: neither, though the rubric half may list medium findings as notes. `not_scanned`: the judge could not answer for this half.
	Verdict DraftCheckVerdict `json:"verdict"`
}

DraftRubricCheck defines model for DraftRubricCheck.

type DraftRubricFinding

type DraftRubricFinding struct {
	Id DraftRubricFindingId `json:"id"`

	// Path The file whose part scored highest (`agent.yaml` for the manifest).
	Path  string `json:"path"`
	Score int    `json:"score"`

	// Severity The severity S5 would record. `high` (a score of 3, or 2 for `C1_injection` and `C3_undeclared_capability`) sends the version to a person; `medium` is shown on the report of a version that publishes (ruleset 0.3.0).
	Severity DraftRubricFindingSeverity `json:"severity"`
}

DraftRubricFinding defines model for DraftRubricFinding.

type DraftRubricFindingId

type DraftRubricFindingId string

DraftRubricFindingId defines model for DraftRubricFinding.Id.

const (
	C1Injection            DraftRubricFindingId = "C1_injection"
	C2Exfiltration         DraftRubricFindingId = "C2_exfiltration"
	C3UndeclaredCapability DraftRubricFindingId = "C3_undeclared_capability"
	C4UserDeception        DraftRubricFindingId = "C4_user_deception"
	C5Obfuscation          DraftRubricFindingId = "C5_obfuscation"
	C6DestructiveActions   DraftRubricFindingId = "C6_destructive_actions"
)

Defines values for DraftRubricFindingId.

func (DraftRubricFindingId) Valid

func (e DraftRubricFindingId) Valid() bool

Valid indicates whether the value is a known member of the DraftRubricFindingId enum.

type DraftRubricFindingSeverity

type DraftRubricFindingSeverity string

DraftRubricFindingSeverity The severity S5 would record. `high` (a score of 3, or 2 for `C1_injection` and `C3_undeclared_capability`) sends the version to a person; `medium` is shown on the report of a version that publishes (ruleset 0.3.0).

const (
	DraftRubricFindingSeverityHigh   DraftRubricFindingSeverity = "high"
	DraftRubricFindingSeverityMedium DraftRubricFindingSeverity = "medium"
)

Defines values for DraftRubricFindingSeverity.

func (DraftRubricFindingSeverity) Valid

func (e DraftRubricFindingSeverity) Valid() bool

Valid indicates whether the value is a known member of the DraftRubricFindingSeverity enum.

type DraftRubricScores

type DraftRubricScores struct {
	C1Injection            int `json:"C1_injection"`
	C2Exfiltration         int `json:"C2_exfiltration"`
	C3UndeclaredCapability int `json:"C3_undeclared_capability"`
	C4UserDeception        int `json:"C4_user_deception"`
	C5Obfuscation          int `json:"C5_obfuscation"`
	C6DestructiveActions   int `json:"C6_destructive_actions"`
}

DraftRubricScores Per rubric question, 0 to 3, as S5 scores it.

type DraftSetCheck

type DraftSetCheck struct {
	// Failure Why a half was not scanned: the judge timed out, failed, or (the draft set only) a part of the draft is past its bound.
	Failure *DraftCheckFailure     `json:"failure,omitempty"`
	Flagged []DraftSetCheckFlagged `json:"flagged"`

	// QuestionSet The hash of the draft question set and everything that changes its verdict.
	QuestionSet string `json:"questionSet"`
	Score       int    `json:"score"`

	// Scores Per draft question, 0 to 3. `off_task`: the instruction would not do the task the description asks for (a different task, a part left out, a different kind of result).
	Scores *DraftSetScores `json:"scores,omitempty"`

	// Verdict `flagged`: in the rubric half, a high finding (one the gate sends to a person); in the draft half, a question scored 2 or more. `pass`: neither, though the rubric half may list medium findings as notes. `not_scanned`: the judge could not answer for this half.
	Verdict DraftCheckVerdict `json:"verdict"`
}

DraftSetCheck defines model for DraftSetCheck.

type DraftSetCheckFlagged

type DraftSetCheckFlagged string

DraftSetCheckFlagged defines model for DraftSetCheck.Flagged.

const (
	OffTask DraftSetCheckFlagged = "off_task"
)

Defines values for DraftSetCheckFlagged.

func (DraftSetCheckFlagged) Valid

func (e DraftSetCheckFlagged) Valid() bool

Valid indicates whether the value is a known member of the DraftSetCheckFlagged enum.

type DraftSetScores

type DraftSetScores struct {
	OffTask int `json:"off_task"`
}

DraftSetScores Per draft question, 0 to 3. `off_task`: the instruction would not do the task the description asks for (a different task, a part left out, a different kind of result).

type DraftUngrantedTool

type DraftUngrantedTool struct {
	// Grant The line of the capability contract the tool needs.
	Grant DraftUngrantedToolGrant `json:"grant"`

	// Line The first line of the instruction that calls for the tool.
	Line int `json:"line"`

	// Path The manifest path that holds the grant, such as `capabilities.browser`.
	Path string `json:"path"`

	// Reason One sentence saying why, which quotes nothing of the instruction but the tool's name (and, for a server's tool, the server's).
	Reason string `json:"reason"`

	// Tool The tool as the instruction names it (`browser_click`, `run_command`, `fetch`), `browser_*` or `host_*` for a whole family, or `<server>__<tool>` for a declared server's tool.
	Tool string `json:"tool"`
}

DraftUngrantedTool defines model for DraftUngrantedTool.

type DraftUngrantedToolGrant

type DraftUngrantedToolGrant string

DraftUngrantedToolGrant The line of the capability contract the tool needs.

const (
	Browser                 DraftUngrantedToolGrant = "browser"
	Egress                  DraftUngrantedToolGrant = "egress"
	Exec                    DraftUngrantedToolGrant = "exec"
	FilesystemRead          DraftUngrantedToolGrant = "filesystem.read"
	FilesystemWrite         DraftUngrantedToolGrant = "filesystem.write"
	McpServers              DraftUngrantedToolGrant = "mcpServers"
	PersistentClock         DraftUngrantedToolGrant = "persistent.clock"
	PersistentHelper        DraftUngrantedToolGrant = "persistent.helper"
	PersistentMeetings      DraftUngrantedToolGrant = "persistent.meetings"
	PersistentMemory        DraftUngrantedToolGrant = "persistent.memory"
	PersistentReview        DraftUngrantedToolGrant = "persistent.review"
	PersistentSelfConfigure DraftUngrantedToolGrant = "persistent.selfConfigure"
	PersistentWeb           DraftUngrantedToolGrant = "persistent.web"
	Subagents               DraftUngrantedToolGrant = "subagents"
	TargetHosts             DraftUngrantedToolGrant = "targetHosts"
)

Defines values for DraftUngrantedToolGrant.

func (DraftUngrantedToolGrant) Valid

func (e DraftUngrantedToolGrant) Valid() bool

Valid indicates whether the value is a known member of the DraftUngrantedToolGrant enum.

type EmailNotificationSettings

type EmailNotificationSettings struct {
	// Advisories An advisory naming one of the person's QuickAgents was published.
	Advisories bool `json:"advisories"`

	// Billing The subscription that pays for the person's work: a checkout confirmed, a payment failed, an organization restricted, seats reached, "your organization covers you" (the hosted product's billing mail; a registry with no billing sends none). Not required on a write: a client that predates the switch leaves it as it was rather than turning it off by omission.
	Billing *bool `json:"billing,omitempty"`

	// BugReports Platform staff marked a bug report the person filed complete ("Reported bug fixed"; the hosted product's bug-report mail, and a registry without bug reports sends none). Not required on a write: a client that predates the switch leaves it as it was rather than turning it off by omission.
	BugReports *bool `json:"bugReports,omitempty"`

	// DependencyAlerts A published version declares an MCP server with a newly known vulnerability.
	DependencyAlerts bool `json:"dependencyAlerts"`

	// OrgInvites The person was added to an organization.
	OrgInvites bool `json:"orgInvites"`

	// Quarantine A published version was quarantined by a rescan.
	Quarantine bool `json:"quarantine"`

	// ReviewDecisions A reviewer decided one of the person's submissions, or the gate held one for review.
	ReviewDecisions bool `json:"reviewDecisions"`

	// 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

type ErasedAccount struct {
	UserID     uuid.UUID
	Identities []string
	Email      string
}

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

type ExtensionTokenResolver func(ctx context.Context, token string) (uuid.UUID, bool, error)

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

type FieldError struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

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

Valid indicates whether the value is a known member of the GetMcpServerScanParamsEcosystem enum.

type GetReviewFileParams

type GetReviewFileParams struct {
	Path string `form:"path" json:"path"`
}

GetReviewFileParams defines parameters for GetReviewFile.

type GetUserReportSettingsParams

type GetUserReportSettingsParams struct {
	// Include `logo` answers the design with its logo, if the person has one. Without it the design comes without a `logo` key, so a client built before logos still reads it.
	Include *ReportSettingsInclude `form:"include,omitempty" json:"include,omitempty"`
}

GetUserReportSettingsParams defines parameters for GetUserReportSettings.

type GetVersionFileParams

type GetVersionFileParams struct {
	// Path Repo-relative file path exactly as listVersionFiles reports it.
	Path string `form:"path" json:"path"`
}

GetVersionFileParams defines parameters for GetVersionFile.

type Handle

type Handle = string

Handle defines model for Handle.

type InvalidParamFormatError

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

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 An organization's shared pack, read through `/orgs/{org}/knowledge/`; false for the caller's own.
	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

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

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 Limit100

type Limit100 = int

Limit100 defines model for Limit100.

type Limit200

type Limit200 = int

Limit200 defines model for Limit200.

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

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 MiddlewareFunc

type MiddlewareFunc func(http.Handler) http.Handler

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

type ModelInputUsage struct {
	InputTokens int `json:"inputTokens"`
	Requests    int `json:"requests"`
}

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

func MountAuthzDecl(pattern string) (MountDecl, bool)

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 Namespace

type Namespace = string

Namespace defines model for Namespace.

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 OrgHandle

type OrgHandle = string

OrgHandle defines model for OrgHandle.

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.

const (
	OrgRoleAdmin            OrgRole = "admin"
	OrgRoleMember           OrgRole = "member"
	OrgRoleSecurityReviewer OrgRole = "security_reviewer"
)

Defines values for OrgRole.

func (OrgRole) Valid

func (e OrgRole) Valid() bool

Valid indicates whether the value is a known member of the OrgRole enum.

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.

const (
	OrgStateActive          OrgState = "active"
	OrgStateDecommissioned  OrgState = "decommissioned"
	OrgStateDecommissioning OrgState = "decommissioning"
	OrgStateSuspended       OrgState = "suspended"
)

Defines values for OrgState.

func (OrgState) Valid

func (e OrgState) Valid() bool

Valid indicates whether the value is a known member of the OrgState enum.

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

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

type ProvisionedMember struct {
	Email       string
	UserName    string
	DisplayName string
}

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

type PublicUser struct {
	DisplayName string `json:"displayName"`
	Handle      string `json:"handle"`
}

PublicUser defines model for PublicUser.

type PutAccountInstallJSONRequestBody

type PutAccountInstallJSONRequestBody = AccountInstallRequest

PutAccountInstallJSONRequestBody defines body for PutAccountInstall for application/json ContentType.

type PutOrgLogoMultipartBody

type PutOrgLogoMultipartBody struct {
	File openapi_types.File `json:"file"`
}

PutOrgLogoMultipartBody defines parameters for PutOrgLogo.

type PutOrgLogoMultipartRequestBody

type PutOrgLogoMultipartRequestBody PutOrgLogoMultipartBody

PutOrgLogoMultipartRequestBody defines body for PutOrgLogo for multipart/form-data ContentType.

type PutUserReportLogoMultipartBody

type PutUserReportLogoMultipartBody struct {
	File openapi_types.File `json:"file"`
}

PutUserReportLogoMultipartBody defines parameters for PutUserReportLogo.

type PutUserReportLogoMultipartRequestBody

type PutUserReportLogoMultipartRequestBody PutUserReportLogoMultipartBody

PutUserReportLogoMultipartRequestBody defines body for PutUserReportLogo for multipart/form-data ContentType.

type PutVoiceJSONRequestBody

type PutVoiceJSONRequestBody = PutVoiceRequest

PutVoiceJSONRequestBody defines body for PutVoice for application/json ContentType.

type PutVoiceRequest

type PutVoiceRequest struct {
	Source PutVoiceRequestSource `json:"source"`

	// Text The VOICE.md, UTF-8, at most 32 KiB.
	Text string `json:"text"`
}

PutVoiceRequest defines model for PutVoiceRequest.

type PutVoiceRequestSource

type PutVoiceRequestSource string

PutVoiceRequestSource defines model for PutVoiceRequest.Source.

const (
	PutVoiceRequestSourceEdit   PutVoiceRequestSource = "edit"
	PutVoiceRequestSourceUpload PutVoiceRequestSource = "upload"
)

Defines values for PutVoiceRequestSource.

func (PutVoiceRequestSource) Valid

func (e PutVoiceRequestSource) Valid() bool

Valid indicates whether the value is a known member of the PutVoiceRequestSource enum.

type RedTeamReport

type RedTeamReport struct {
	BundleDigest string `json:"bundleDigest"`

	// Cases Fixtures × applicable mutators.
	Cases     int       `json:"cases"`
	CreatedAt time.Time `json:"createdAt"`

	// Evaded Cases where at least one expected rule stopped firing.
	Evaded int `json:"evaded"`

	// Fixtures Attack fixtures with S3/S4 expectations that fired unmutated.
	Fixtures int                `json:"fixtures"`
	Id       openapi_types.UUID `json:"id"`

	// Report The full report (byMutator tallies and every evasion).
	Report        map[string]interface{} `json:"report"`
	RulesetSemver string                 `json:"rulesetSemver"`
}

RedTeamReport One run of the red-team job.

type ReportAbuseJSONBody

type ReportAbuseJSONBody struct {
	Category ReportAbuseJSONBodyCategory `json:"category"`
	Detail   string                      `json:"detail"`
	Version  *string                     `json:"version,omitempty"`
}

ReportAbuseJSONBody defines parameters for ReportAbuse.

type ReportAbuseJSONBodyCategory

type ReportAbuseJSONBodyCategory string

ReportAbuseJSONBodyCategory defines parameters for ReportAbuse.

const (
	CredentialTheft    ReportAbuseJSONBodyCategory = "credential_theft"
	HiddenInstructions ReportAbuseJSONBodyCategory = "hidden_instructions"
	License            ReportAbuseJSONBodyCategory = "license"
	MaliciousContent   ReportAbuseJSONBodyCategory = "malicious_content"
	Other              ReportAbuseJSONBodyCategory = "other"
	Spam               ReportAbuseJSONBodyCategory = "spam"
	Typosquat          ReportAbuseJSONBodyCategory = "typosquat"
)

Defines values for ReportAbuseJSONBodyCategory.

func (ReportAbuseJSONBodyCategory) Valid

Valid indicates whether the value is a known member of the ReportAbuseJSONBodyCategory enum.

type ReportAbuseJSONRequestBody

type ReportAbuseJSONRequestBody ReportAbuseJSONBody

ReportAbuseJSONRequestBody defines body for ReportAbuse for application/json ContentType.

type ReportDesign

type ReportDesign struct {
	// Accent The one colour, lower-case hex.
	Accent string `json:"accent"`

	// AgentryTheme The document version, always 2.
	AgentryTheme ReportDesignAgentryTheme `json:"agentryTheme"`

	// BasedOn The built-in theme the design started from.
	BasedOn ReportDesignBasedOn `json:"basedOn"`
	Fonts   struct {
		Body     ReportDesignFontsBody     `json:"body"`
		Code     ReportDesignFontsCode     `json:"code"`
		Headings ReportDesignFontsHeadings `json:"headings"`
	} `json:"fonts"`
	Footer struct {
		PageNumbers ReportDesignFooterPageNumbers `json:"pageNumbers"`

		// Text One line, set as text, never evaluated; empty for none.
		Text string `json:"text"`
	} `json:"footer"`
	Headings ReportDesignHeadings `json:"headings"`

	Logo *struct {
		// Png A PNG in standard base64, at most 512 KB and 1024 pixels each way, as the core encoded it from the person's upload.
		Png string `json:"png"`
	} `json:"logo,omitempty"`

	// Name The design's label, a built-in's own name or the person's.
	Name string `json:"name"`

	// Paper A4, or US Letter.
	Paper  ReportDesignPaper  `json:"paper"`
	Quotes ReportDesignQuotes `json:"quotes"`
	Tables struct {
		Banded bool `json:"banded"`
		Tinted bool `json:"tinted"`
	} `json:"tables"`
	TitleBlock ReportDesignTitleBlock `json:"titleBlock"`

	// Version The design's revision.
	Version int `json:"version"`
}

ReportDesign A report design, the theme document version 2. Defined by the core's pkg/reportdesign, whose JSON Schema this mirrors (a core test holds them equal). Beyond what the schema says, the accent must reach 4.5:1 contrast on white when it touches text (titleBlock `band`, headings `smallcaps` or `numbered`) and 3:1 otherwise, and `name` and `footer.text` are one line with no control, line-break, bidirectional formatting or other invisible format characters. The tint is derived: 12% of the accent over white. The five built-in themes are each a value of it. `logo` is optional and not counted in the 16 KB; `"logo": null` is read as no logo.

type ReportDesignAgentryTheme

type ReportDesignAgentryTheme int

ReportDesignAgentryTheme The document version, always 2.

const (
	ReportDesignVersion2 ReportDesignAgentryTheme = 2
)

Defines values for ReportDesignAgentryTheme.

func (ReportDesignAgentryTheme) Valid

func (e ReportDesignAgentryTheme) Valid() bool

Valid indicates whether the value is a known member of the ReportDesignAgentryTheme enum.

type ReportDesignBasedOn

type ReportDesignBasedOn string

ReportDesignBasedOn The built-in theme the design started from.

const (
	ReportDesignBasedOnClassic   ReportDesignBasedOn = "classic"
	ReportDesignBasedOnEditorial ReportDesignBasedOn = "editorial"
	ReportDesignBasedOnModern    ReportDesignBasedOn = "modern"
	ReportDesignBasedOnPlain     ReportDesignBasedOn = "plain"
	ReportDesignBasedOnTechnical ReportDesignBasedOn = "technical"
)

Defines values for ReportDesignBasedOn.

func (ReportDesignBasedOn) Valid

func (e ReportDesignBasedOn) Valid() bool

Valid indicates whether the value is a known member of the ReportDesignBasedOn enum.

type ReportDesignFontsBody

type ReportDesignFontsBody string

ReportDesignFontsBody defines model for ReportDesign.Fonts.Body.

const (
	ReportDesignFontsBodyEBGaramond   ReportDesignFontsBody = "EB Garamond"
	ReportDesignFontsBodyIBMPlexSans  ReportDesignFontsBody = "IBM Plex Sans"
	ReportDesignFontsBodyIBMPlexSerif ReportDesignFontsBody = "IBM Plex Serif"
	ReportDesignFontsBodyInter        ReportDesignFontsBody = "Inter"
	ReportDesignFontsBodyLora         ReportDesignFontsBody = "Lora"
	ReportDesignFontsBodyMerriweather ReportDesignFontsBody = "Merriweather"
	ReportDesignFontsBodySourceSans3  ReportDesignFontsBody = "Source Sans 3"
	ReportDesignFontsBodySourceSerif4 ReportDesignFontsBody = "Source Serif 4"
	ReportDesignFontsBodyWorkSans     ReportDesignFontsBody = "Work Sans"
)

Defines values for ReportDesignFontsBody.

func (ReportDesignFontsBody) Valid

func (e ReportDesignFontsBody) Valid() bool

Valid indicates whether the value is a known member of the ReportDesignFontsBody enum.

type ReportDesignFontsCode

type ReportDesignFontsCode string

ReportDesignFontsCode defines model for ReportDesign.Fonts.Code.

const (
	ReportDesignFontsCodeIBMPlexMono   ReportDesignFontsCode = "IBM Plex Mono"
	ReportDesignFontsCodeJetBrainsMono ReportDesignFontsCode = "JetBrains Mono"
	ReportDesignFontsCodeSourceCodePro ReportDesignFontsCode = "Source Code Pro"
)

Defines values for ReportDesignFontsCode.

func (ReportDesignFontsCode) Valid

func (e ReportDesignFontsCode) Valid() bool

Valid indicates whether the value is a known member of the ReportDesignFontsCode enum.

type ReportDesignFontsHeadings

type ReportDesignFontsHeadings string

ReportDesignFontsHeadings defines model for ReportDesign.Fonts.Headings.

const (
	ReportDesignFontsHeadingsEBGaramond      ReportDesignFontsHeadings = "EB Garamond"
	ReportDesignFontsHeadingsIBMPlexMono     ReportDesignFontsHeadings = "IBM Plex Mono"
	ReportDesignFontsHeadingsIBMPlexSans     ReportDesignFontsHeadings = "IBM Plex Sans"
	ReportDesignFontsHeadingsIBMPlexSerif    ReportDesignFontsHeadings = "IBM Plex Serif"
	ReportDesignFontsHeadingsInter           ReportDesignFontsHeadings = "Inter"
	ReportDesignFontsHeadingsJetBrainsMono   ReportDesignFontsHeadings = "JetBrains Mono"
	ReportDesignFontsHeadingsLora            ReportDesignFontsHeadings = "Lora"
	ReportDesignFontsHeadingsMerriweather    ReportDesignFontsHeadings = "Merriweather"
	ReportDesignFontsHeadingsMontserrat      ReportDesignFontsHeadings = "Montserrat"
	ReportDesignFontsHeadingsPlayfairDisplay ReportDesignFontsHeadings = "Playfair Display"
	ReportDesignFontsHeadingsSourceCodePro   ReportDesignFontsHeadings = "Source Code Pro"
	ReportDesignFontsHeadingsSourceSans3     ReportDesignFontsHeadings = "Source Sans 3"
	ReportDesignFontsHeadingsSourceSerif4    ReportDesignFontsHeadings = "Source Serif 4"
	ReportDesignFontsHeadingsWorkSans        ReportDesignFontsHeadings = "Work Sans"
)

Defines values for ReportDesignFontsHeadings.

func (ReportDesignFontsHeadings) Valid

func (e ReportDesignFontsHeadings) Valid() bool

Valid indicates whether the value is a known member of the ReportDesignFontsHeadings enum.

type ReportDesignFooterPageNumbers

type ReportDesignFooterPageNumbers string

ReportDesignFooterPageNumbers defines model for ReportDesign.Footer.PageNumbers.

const (
	ReportDesignFooterPageNumbersN    ReportDesignFooterPageNumbers = "n"
	ReportDesignFooterPageNumbersNOfN ReportDesignFooterPageNumbers = "nOfN"
	ReportDesignFooterPageNumbersNone ReportDesignFooterPageNumbers = "none"
)

Defines values for ReportDesignFooterPageNumbers.

func (ReportDesignFooterPageNumbers) Valid

Valid indicates whether the value is a known member of the ReportDesignFooterPageNumbers enum.

type ReportDesignHeadings

type ReportDesignHeadings string

ReportDesignHeadings defines model for ReportDesign.Headings.

const (
	ReportDesignHeadingsBar       ReportDesignHeadings = "bar"
	ReportDesignHeadingsNumbered  ReportDesignHeadings = "numbered"
	ReportDesignHeadingsPlain     ReportDesignHeadings = "plain"
	ReportDesignHeadingsRule      ReportDesignHeadings = "rule"
	ReportDesignHeadingsSmallcaps ReportDesignHeadings = "smallcaps"
)

Defines values for ReportDesignHeadings.

func (ReportDesignHeadings) Valid

func (e ReportDesignHeadings) Valid() bool

Valid indicates whether the value is a known member of the ReportDesignHeadings enum.

type ReportDesignPaper

type ReportDesignPaper string

ReportDesignPaper A4, or US Letter.

const (
	A4     ReportDesignPaper = "a4"
	Letter ReportDesignPaper = "letter"
)

Defines values for ReportDesignPaper.

func (ReportDesignPaper) Valid

func (e ReportDesignPaper) Valid() bool

Valid indicates whether the value is a known member of the ReportDesignPaper enum.

type ReportDesignQuotes

type ReportDesignQuotes string

ReportDesignQuotes defines model for ReportDesign.Quotes.

const (
	ReportDesignQuotesCallout ReportDesignQuotes = "callout"
	ReportDesignQuotesPlain   ReportDesignQuotes = "plain"
)

Defines values for ReportDesignQuotes.

func (ReportDesignQuotes) Valid

func (e ReportDesignQuotes) Valid() bool

Valid indicates whether the value is a known member of the ReportDesignQuotes enum.

type ReportDesignTitleBlock

type ReportDesignTitleBlock string

ReportDesignTitleBlock defines model for ReportDesign.TitleBlock.

const (
	ReportDesignTitleBlockBand  ReportDesignTitleBlock = "band"
	ReportDesignTitleBlockBar   ReportDesignTitleBlock = "bar"
	ReportDesignTitleBlockNone  ReportDesignTitleBlock = "none"
	ReportDesignTitleBlockRuled ReportDesignTitleBlock = "ruled"
)

Defines values for ReportDesignTitleBlock.

func (ReportDesignTitleBlock) Valid

func (e ReportDesignTitleBlock) Valid() bool

Valid indicates whether the value is a known member of the ReportDesignTitleBlock enum.

type ReportSettings

type ReportSettings struct {
	// Design A report design, the theme document version 2. Defined by the core's pkg/reportdesign, whose JSON Schema this mirrors (a core test holds them equal). Beyond what the schema says, the accent must reach 4.5:1 contrast on white when it touches text (titleBlock `band`, headings `smallcaps` or `numbered`) and 3:1 otherwise, and `name` and `footer.text` are one line with no control, line-break, bidirectional formatting or other invisible format characters. The tint is derived: 12% of the accent over white. The five built-in themes are each a value of it. `logo` is optional and not counted in the 16 KB; `"logo": null` is read as no logo.
	Design *ReportDesign `json:"design,omitempty"`
}

ReportSettings The caller's report settings, a profile setting. No `design` means the person never chose one.

type ReportSettingsInclude

type ReportSettingsInclude string

ReportSettingsInclude What a report settings answer carries beyond the design.

const (
)

Defines values for ReportSettingsInclude.

func (ReportSettingsInclude) Valid

func (e ReportSettingsInclude) Valid() bool

Valid indicates whether the value is a known member of the ReportSettingsInclude enum.

type ReportVerdict

type ReportVerdict string

ReportVerdict What a report is: `scanned` when a scan run stands behind it (the findings say the rest), `unscanned` when the version was admitted without one — never conflated with "scanned with a known gap". Absent while a scan is still pending.

const (
	Scanned   ReportVerdict = "scanned"
	Unscanned ReportVerdict = "unscanned"
)

Defines values for ReportVerdict.

func (ReportVerdict) Valid

func (e ReportVerdict) Valid() bool

Valid indicates whether the value is a known member of the ReportVerdict enum.

type RequiredHeaderError

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

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

type ReviewFileEntry struct {
	Path string `json:"path"`
	Size int64  `json:"size"`
}

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

func RouteAuthzDecl(operationID string) (RouteDecl, bool)

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.

func (Scope) Valid

func (e Scope) Valid() bool

Valid indicates whether the value is a known member of the Scope enum.

type ScopeGranted

type ScopeGranted = string

ScopeGranted A scope as it appears on a token the registry reports back (the token list, a newly minted token, the desktop exchange). The set is the one `Scope` accepts and grows by addition, so it is declared extensible: a client keeps a value it does not know as the string it is rather than failing on it.

type SearchAgentsParams

type SearchAgentsParams struct {
	// Q Free-text query; empty lists by popularity.
	Q *string `form:"q,omitempty" json:"q,omitempty"`

	// Mode Only agents that support this run mode.
	Mode *AgentMode `form:"mode,omitempty" json:"mode,omitempty"`

	// Capability Capability the latest published version actually asks for, e.g. `network`, `filesystem`, `exec`, `secrets`, `dataAccess`, or `targetHosts` (a machine the person names when the run starts), or `browser` (a headless browser for the sites the person names). A capability declared as `none`, null, or empty does not match: `network: {egress: none}` is not a network agent.
	Capability *string `form:"capability,omitempty" json:"capability,omitempty"`

	// License SPDX identifier from the latest published manifest.
	License *string `form:"license,omitempty" json:"license,omitempty"`

	// Verified Only agents in an org namespace with a verified domain.
	Verified *bool                   `form:"verified,omitempty" json:"verified,omitempty"`
	Sort     *SearchAgentsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`
	Limit    *int                    `form:"limit,omitempty" json:"limit,omitempty"`
	Offset   *int                    `form:"offset,omitempty" json:"offset,omitempty"`
}

SearchAgentsParams defines parameters for SearchAgents.

type SearchAgentsParamsSort

type SearchAgentsParamsSort string

SearchAgentsParamsSort defines parameters for SearchAgents.

const (
	SearchAgentsParamsSortInstalls  SearchAgentsParamsSort = "installs"
	SearchAgentsParamsSortNewest    SearchAgentsParamsSort = "newest"
	SearchAgentsParamsSortRelevance SearchAgentsParamsSort = "relevance"
)

Defines values for SearchAgentsParamsSort.

func (SearchAgentsParamsSort) Valid

func (e SearchAgentsParamsSort) Valid() bool

Valid indicates whether the value is a known member of the SearchAgentsParamsSort enum.

type SearchHit

type SearchHit struct {
	// Builtin Whether this is a built-in agent (see `Agent.builtin`): a client labels it Built-in in place of its run modes.
	Builtin     bool `json:"builtin"`
	Installs30d *int `json:"installs30d,omitempty"`

	// LogoUrl The publishing organization's logo, when the namespace is an organization with one — beside the publisher's name, never in place of the verdict. Absent for a person's namespace and for an organization without one.
	LogoUrl *string `json:"logoUrl,omitempty"`

	// Modes The run modes a release supports; at least one.
	Modes           AgentModes                `json:"modes"`
	Name            string                    `json:"name"`
	Namespace       string                    `json:"namespace"`
	QuarantineState *SearchHitQuarantineState `json:"quarantineState,omitempty"`
	Summary         string                    `json:"summary"`
}

SearchHit defines model for SearchHit.

type SearchHitQuarantineState

type SearchHitQuarantineState string

SearchHitQuarantineState defines model for SearchHit.QuarantineState.

const (
	SearchHitQuarantineStateBlocked     SearchHitQuarantineState = "blocked"
	SearchHitQuarantineStateNone        SearchHitQuarantineState = "none"
	SearchHitQuarantineStateQuarantined SearchHitQuarantineState = "quarantined"
)

Defines values for SearchHitQuarantineState.

func (SearchHitQuarantineState) Valid

func (e SearchHitQuarantineState) Valid() bool

Valid indicates whether the value is a known member of the SearchHitQuarantineState enum.

type SearchModelInputJSONRequestBody

type SearchModelInputJSONRequestBody = WebSearchRequest

SearchModelInputJSONRequestBody defines body for SearchModelInput for application/json ContentType.

type SearchResults

type SearchResults struct {
	// Facets Facet counts keyed by facet name then value.
	Facets  *map[string]map[string]int `json:"facets,omitempty"`
	Results []SearchHit                `json:"results"`

	// Total The number of hits for this request's predicate (query, mode, capability, license, verified) before limit and offset — what "2 of 8 results" counts. Blocked and never-published agents are outside it, as they are outside the results.
	Total *int `json:"total,omitempty"`
}

SearchResults defines model for SearchResults.

type Seats

type Seats struct {
	Invited int64 `json:"invited"`
	Max     int64 `json:"max"`
	Pending int64 `json:"pending"`
	Used    int64 `json:"used"`
}

Seats What the organization holds against its seat allowance. A seat is every active membership plus every open invitation; pending people hold none. `max` is the allowance, 0 meaning unbounded — what a registry with no billing extension answers.

type ServeMux

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

ServeMux is an abstraction of http.ServeMux.

type Server

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

Server implements the generated ServerInterface plus non-spec endpoints (health, well-known). It is assembled once per process by NewHandler.

func New

func New(cfg config.Config, st *store.Store, log *slog.Logger, opts ...Option) *Server

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

func (s *Server) AcceptInvitation(w http.ResponseWriter, r *http.Request, token string)

AcceptInvitation implements POST /invitations/{token} (session only).

func (*Server) AccountErasers

func (s *Server) AccountErasers() []string

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

func (s *Server) ActivateOrg(ctx context.Context, orgID uuid.UUID) (bool, error)

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

func (s *Server) AddEventHook(h func(ctx context.Context, ev Event))

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

func (s *Server) AddSignInHook(h func(ctx context.Context, in SignIn))

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

func (s *Server) BaseURL() string

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

func (s *Server) Blobs() registry.BlobStore

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

func (s *Server) Close() error

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

func (s *Server) CreateAuditExport(w http.ResponseWriter, r *http.Request, org OrgHandle)

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

func (s *Server) CreateDomainClaim(w http.ResponseWriter, r *http.Request, org OrgHandle)

CreateDomainClaim implements POST /orgs/{org}/domain-claims (admin+).

func (*Server) CreateInvitation

func (s *Server) CreateInvitation(w http.ResponseWriter, r *http.Request, org OrgHandle)

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

func (s *Server) CreateOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle)

CreateOrgKnowledgePack implements POST /orgs/{org}/knowledge/packs.

func (*Server) CreateRulesetRelease

func (s *Server) CreateRulesetRelease(w http.ResponseWriter, r *http.Request)

CreateRulesetRelease implements POST /platform/ruleset-releases.

func (*Server) CreateTeam

func (s *Server) CreateTeam(w http.ResponseWriter, r *http.Request, org OrgHandle)

CreateTeam implements POST /orgs/{org}/teams (admin+).

func (*Server) CreateToken

func (s *Server) CreateToken(w http.ResponseWriter, r *http.Request)

CreateToken implements POST /user/tokens (session-only).

func (*Server) CreateWebhook

func (s *Server) CreateWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle)

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

func (s *Server) DecommissionOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)

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 (s *Server) DeleteOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)

DeleteOrgLogo implements DELETE /orgs/{org}/logo.

func (*Server) DeleteTeam

func (s *Server) DeleteTeam(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)

DeleteTeam implements DELETE /orgs/{org}/teams/{team} (admin+).

func (s *Server) DeleteUserReportLogo(w http.ResponseWriter, r *http.Request)

DeleteUserReportLogo implements DELETE /user/report-settings/logo: the design stays; removing no logo is done.

func (*Server) DeleteVoice

func (s *Server) DeleteVoice(w http.ResponseWriter, r *http.Request)

DeleteVoice implements DELETE /voice.

func (*Server) DeleteWebhook

func (s *Server) DeleteWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)

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

func (s *Server) ErasedAddressKey(email string) string

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

func (s *Server) ExtensionNames() []string

ExtensionNames lists the mounted extensions in registration order.

func (*Server) ExtensionSealer

func (s *Server) ExtensionSealer(name string) (*auth.Sealer, error)

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

func (s *Server) ExtensionUnthrottled() map[string]bool

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

func (s *Server) ForkAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

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) GetAgent

func (s *Server) GetAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

GetAgent implements GET /agents/{ns}/{name}.

func (*Server) GetAgentReadme

func (s *Server) GetAgentReadme(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params GetAgentReadmeParams)

GetAgentReadme implements GET /agents/{ns}/{name}/readme: the README of a published version, rendered server-side through the strict sanitizer. The web app never parses user markdown client-side.

func (*Server) GetAgentStats

func (s *Server) GetAgentStats(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

GetAgentStats implements GET /agents/{ns}/{name}/stats: star count plus lifetime and trailing-30-day installs from the download_stats rollup. Public for public agents; private ones need read like every other agent-scoped route.

func (*Server) GetAuditExport

func (s *Server) GetAuditExport(w http.ResponseWriter, r *http.Request, org OrgHandle, id openapi_types.UUID)

GetAuditExport implements GET /orgs/{org}/audit/exports/{id} (admin+).

func (*Server) GetConnectors

func (s *Server) GetConnectors(w http.ResponseWriter, r *http.Request)

GetConnectors implements GET /api/v1/connectors: every connector of the catalogue this build carries, each with the public client id this deployment configured for it, where its app is a public client. It serves configuration and the catalogue alone, so it needs no store and no credential. Its answer has a field for a public client id and none for any other client value.

func (*Server) GetCurrentUser

func (s *Server) GetCurrentUser(w http.ResponseWriter, r *http.Request)

GetCurrentUser implements GET /user.

func (*Server) GetDomainOrg

func (s *Server) GetDomainOrg(w http.ResponseWriter, r *http.Request)

GetDomainOrg implements GET /user/domain-org.

func (*Server) GetInvitation

func (s *Server) GetInvitation(w http.ResponseWriter, r *http.Request, token string)

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) GetOrg

func (s *Server) GetOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)

GetOrg implements GET /orgs/{org} (public profile; settings for admins).

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

func (s *Server) GetOrgKnowledgeUsage(w http.ResponseWriter, r *http.Request, org OrgHandle)

GetOrgKnowledgeUsage implements GET /orgs/{org}/knowledge/usage.

func (s *Server) GetOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)

GetOrgLogo implements GET /orgs/{org}/logo.

func (*Server) GetOrgPolicy

func (s *Server) GetOrgPolicy(w http.ResponseWriter, r *http.Request, org OrgHandle)

GetOrgPolicy implements GET /orgs/{org}/policy (admin+).

func (*Server) GetPlatformPolicy

func (s *Server) GetPlatformPolicy(w http.ResponseWriter, r *http.Request)

GetPlatformPolicy implements GET /platform/policy (public, read-only).

func (*Server) GetReviewFile

func (s *Server) GetReviewFile(w http.ResponseWriter, r *http.Request, id openapi_types.UUID, params GetReviewFileParams)

GetReviewFile implements GET /review-items/{id}/file?path=.

func (*Server) GetReviewItem

func (s *Server) GetReviewItem(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)

GetReviewItem implements GET /review-items/{id}. The bundle carries everything the reviewer detail renders in one call: the findings, the submitted manifest and capabilities, and the previous published version as the capability-diff baseline.

func (*Server) GetUserNotificationSettings

func (s *Server) GetUserNotificationSettings(w http.ResponseWriter, r *http.Request)

GetUserNotificationSettings implements GET /user/notifications.

func (*Server) GetUserProfile

func (s *Server) GetUserProfile(w http.ResponseWriter, r *http.Request, handle Handle)

GetUserProfile implements GET /users/{handle} (public).

func (*Server) GetUserReportSettings

func (s *Server) GetUserReportSettings(w http.ResponseWriter, r *http.Request, params GetUserReportSettingsParams)

GetUserReportSettings implements GET /user/report-settings: the report design the caller's PDF reports take, a profile setting. No row reads back with no design, which a client tells apart from Plain. The logo comes only with include=logo: a client built before logos refuses a design with a key it does not know, and would then run without the design at all.

func (*Server) GetVersionAttestation

func (s *Server) GetVersionAttestation(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)

GetVersionAttestation implements GET .../versions/{version}/attestation.

func (*Server) GetVersionFile

func (s *Server) GetVersionFile(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString, params GetVersionFileParams)

GetVersionFile implements GET .../versions/{version}/file?path=.

func (*Server) GetVersionInfo

func (s *Server) GetVersionInfo(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)

GetVersionInfo implements GET .../versions/{version}.

func (*Server) GetVersionManifest

func (s *Server) GetVersionManifest(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)

GetVersionManifest implements GET .../versions/{version}/manifest.

func (*Server) GetVersionReport

func (s *Server) GetVersionReport(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)

GetVersionReport implements GET .../versions/{version}/report (public).

func (*Server) GetVoice

func (s *Server) GetVoice(w http.ResponseWriter, r *http.Request)

GetVoice implements GET /voice.

func (*Server) GetWebhook

func (s *Server) GetWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)

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

func (s *Server) HasDirectory() bool

HasDirectory reports whether the server has a directory.

func (*Server) Knowledge

func (s *Server) Knowledge() *knowledge.Service

Knowledge is the knowledge store, for an extension that builds on it.

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

func (s *Server) ListDomainClaims(w http.ResponseWriter, r *http.Request, org OrgHandle)

ListDomainClaims implements GET /orgs/{org}/domain-claims (admin+).

func (*Server) ListInvitations

func (s *Server) ListInvitations(w http.ResponseWriter, r *http.Request, org OrgHandle)

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

func (s *Server) ListOrgKnowledgePacks(w http.ResponseWriter, r *http.Request, org OrgHandle)

ListOrgKnowledgePacks implements GET /orgs/{org}/knowledge/packs.

func (*Server) ListOrgMembers

func (s *Server) ListOrgMembers(w http.ResponseWriter, r *http.Request, org OrgHandle)

ListOrgMembers implements GET /orgs/{org}/members (member+).

func (*Server) ListPlatformAudit

func (s *Server) ListPlatformAudit(w http.ResponseWriter, r *http.Request, params ListPlatformAuditParams)

ListPlatformAudit implements GET /platform/audit: platform staff see every org's slice. Platform access is itself audited, so each call writes one audit.platform_read event naming the filters used — reading everyone's log is exactly the action an auditor wants a record of.

func (*Server) ListRedTeamReports

func (s *Server) ListRedTeamReports(w http.ResponseWriter, r *http.Request, params ListRedTeamReportsParams)

ListRedTeamReports implements GET /platform/redteam/reports (staff).

func (*Server) ListReviewFiles

func (s *Server) ListReviewFiles(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)

ListReviewFiles implements GET /review-items/{id}/files.

func (*Server) ListReviewQueue

func (s *Server) ListReviewQueue(w http.ResponseWriter, r *http.Request, params ListReviewQueueParams)

ListReviewQueue implements GET /review-queue.

func (*Server) ListRulesetReleases

func (s *Server) ListRulesetReleases(w http.ResponseWriter, r *http.Request)

ListRulesetReleases implements GET /platform/ruleset-releases: the staff console's history, newest first — the head is the bundle new scans are judged under.

func (*Server) ListSshKeys

func (s *Server) ListSshKeys(w http.ResponseWriter, r *http.Request)

ListSshKeys implements GET /user/ssh-keys.

func (*Server) ListTeamMembers

func (s *Server) ListTeamMembers(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)

ListTeamMembers implements GET /orgs/{org}/teams/{team}/members (member+).

func (*Server) ListTeams

func (s *Server) ListTeams(w http.ResponseWriter, r *http.Request, org OrgHandle)

ListTeams implements GET /orgs/{org}/teams (member+).

func (*Server) ListTokens

func (s *Server) ListTokens(w http.ResponseWriter, r *http.Request)

ListTokens implements GET /user/tokens.

func (*Server) ListUserActivity

func (s *Server) ListUserActivity(w http.ResponseWriter, r *http.Request, params ListUserActivityParams)

ListUserActivity implements GET /user/activity: the audit events the caller performed, newest first, with the address and client each came from — the "was that me?" view of an account.

func (*Server) ListUserDependencyAlerts

func (s *Server) ListUserDependencyAlerts(w http.ResponseWriter, r *http.Request)

ListUserDependencyAlerts implements GET /user/dependency-alerts: the open alerts on published versions the caller submitted, newest first. This is what the site's sign-in banner and dashboard read.

func (*Server) ListUserSessions

func (s *Server) ListUserSessions(w http.ResponseWriter, r *http.Request)

ListUserSessions implements GET /user/sessions.

func (*Server) ListVersionFiles

func (s *Server) ListVersionFiles(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)

ListVersionFiles implements GET .../versions/{version}/files.

func (*Server) ListVersions

func (s *Server) ListVersions(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

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

func (s *Server) ListWebhooks(w http.ResponseWriter, r *http.Request, org OrgHandle)

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

func (s *Server) MCPSweepReady() bool

MCPSweepReady reports whether the daily MCP sweep would consult a vulnerability database (the wiring check for the sweep).

func (*Server) Metrics

func (s *Server) Metrics() *metrics.Metrics

Metrics returns the wired instrument set (nil-safe for callers).

func (*Server) ModelInputCallers

func (s *Server) ModelInputCallers() ModelInputCallers

ModelInputCallers is the extension that admits hosted jobs, or nil.

func (*Server) MountAuthzDecl

func (s *Server) MountAuthzDecl(pattern string) (MountDecl, bool)

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

func (s *Server) MountedRoutes() []string

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

func (s *Server) Notifier() notify.Notifier

Notifier exposes the configured notifier so other roles share one instance.

func (*Server) OrgAdminIDs

func (s *Server) OrgAdminIDs(ctx context.Context, orgID uuid.UUID) ([]uuid.UUID, error)

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

func (s *Server) OrgReadable(ctx context.Context, orgID uuid.UUID) (bool, error)

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

func (s *Server) OrgWritable(ctx context.Context, orgID uuid.UUID) (bool, error)

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

func (s *Server) PingWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)

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

func (s *Server) Pipeline() *scan.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 (s *Server) PutOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)

PutOrgLogo implements PUT /orgs/{org}/logo.

func (s *Server) PutUserReportLogo(w http.ResponseWriter, r *http.Request)

PutUserReportLogo implements PUT /user/report-settings/logo: one multipart part named file, PNG or JPEG, at most 512 KB, decoded, scaled down and encoded again as PNG by pkg/reportdesign, so only its pixels are kept. A logo travels with a design, so with no design saved it is 409. Read the same way as the organization's logo (readUploadPart), at this setting's own bound.

func (*Server) PutVoice

func (s *Server) PutVoice(w http.ResponseWriter, r *http.Request)

PutVoice implements PUT /voice: a new version, pending until reviewed.

func (*Server) Readyz

func (s *Server) Readyz(w http.ResponseWriter, r *http.Request)

Readyz is the readiness handler for a role that assembles its own mux — the git role (pkg/extension), whose Deployment probes /readyz like the api's.

func (*Server) Reg

func (s *Server) Reg() *registry.Service

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

func (s *Server) RegisterExtension(name string, routes func(*http.ServeMux))

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

func (s *Server) RegisterQueueHandlers(q queue.Client)

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

func (s *Server) ReinstateOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)

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

func (s *Server) ReportAbuse(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

ReportAbuse implements POST /agents/{ns}/{name}/abuse-reports.

func (*Server) ReportDesign

func (s *Server) ReportDesign(ctx context.Context, user uuid.UUID) ([]byte, error)

ReportDesign is a person's report design as its canonical document, without its logo, or nil when they never chose one, which is not Plain: the reader decides what nothing means. It is the read behind GET /user/report-settings and the extension seam (pkg/extension ReportSettings). A stored design that no longer validates (a rule tightened since it was saved) reads as never chosen, and is logged.

func (s *Server) ReportDesignWithLogo(ctx context.Context, user uuid.UUID) ([]byte, error)

ReportDesignWithLogo is ReportDesign with the person's logo in it, when they have one, for a reader that draws it.

func (*Server) ReportTheme

func (s *Server) ReportTheme(ctx context.Context, user uuid.UUID) (string, error)

ReportTheme is the built-in theme a person's design started from (its basedOn), or "" when they never chose one. The hosted job carries a theme's name to a sandbox host whose CLI knows theme names, and drops a name it does not have.

func (*Server) RequestDomainOrgAccess

func (s *Server) RequestDomainOrgAccess(w http.ResponseWriter, r *http.Request)

RequestDomainOrgAccess implements POST /user/domain-org/request-access (session only). The audit row is the record and the rate limit: one request per person per day, whatever the mail did.

func (*Server) ResendActivation added in v0.6.1000

func (s *Server) ResendActivation(ctx context.Context, ext string, actor *auth.Principal, userID uuid.UUID, reason string) (time.Time, error)

ResendActivation sends an unactivated account a new activation link for the staff member actor, under the limits the person's own resend has (one link in five minutes, ten a day). An account already activated, one with no address a link can reach and one not active are refused. It is audited as user.activation_resend with the actor and the reason, and returns when another link may go.

func (*Server) ResolveRef

func (s *Server) ResolveRef(w http.ResponseWriter, r *http.Request, params ResolveRefParams)

ResolveRef implements GET /resolve.

func (*Server) RestoreAgent

func (s *Server) RestoreAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

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

func (s *Server) RetireAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

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

func (s *Server) RunFoldInSweep(ctx context.Context, orgID uuid.UUID, domain string) (int, error)

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

func (s *Server) RunOrgDecommissionSweep(ctx context.Context) (int, error)

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

func (s *Server) RunPendingMembersDigest(ctx context.Context, only uuid.UUID) (int, error)

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

func (s *Server) RunRedTeamNow(ctx context.Context) error

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

func (s *Server) RunTrustedDeviceSweep(ctx context.Context) (int64, error)

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

func (s *Server) SetDirectory(d Directory)

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

func (s *Server) SetExtensionCreditsSessions(name string, routes []string)

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

func (s *Server) SetExtensionUnthrottled(name string, routes []string)

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

func (s *Server) SetImageProxyClient(c *http.Client)

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

func (s *Server) SetMCPScanning(client scan.OSVClient)

SetMCPScanning swaps S7's vulnerability database client (tests use a fake); the scanned-server registry stays the store's.

func (*Server) SetMetrics

func (s *Server) SetMetrics(m *metrics.Metrics)

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

func (s *Server) SetNotifier(n notify.Notifier)

SetNotifier overrides the notifier (tests).

func (*Server) SetOIDCHTTPClient

func (s *Server) SetOIDCHTTPClient(c *http.Client)

SetOIDCHTTPClient overrides the HTTP client used for OIDC discovery/JWKS/ token calls (tests point it at an in-process IdP).

func (*Server) SetOrgMember

func (s *Server) SetOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)

SetOrgMember implements PUT /orgs/{org}/members/{handle}.

func (*Server) SetOrgPolicy

func (s *Server) SetOrgPolicy(w http.ResponseWriter, r *http.Request, org OrgHandle)

SetOrgPolicy implements PUT /orgs/{org}/policy (admin; tighten-only).

func (*Server) SetResolver

func (s *Server) SetResolver(r dnsx.Resolver)

SetResolver overrides the DNS resolver (domain verification; tests inject a fake resolver,).

func (*Server) SetVoiceAdmitter

func (s *Server) SetVoiceAdmitter(a VoiceAdmitter)

SetVoiceAdmitter sets the extension that admits a voice's review.

func (*Server) SetVoiceJudge

func (s *Server) SetVoiceJudge(j voice.Judge)

SetVoiceJudge replaces the judge the voice review asks (a test's stub).

func (*Server) SetWebSearch

func (s *Server) SetWebSearch(p websearch.Provider)

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

func (s *Server) StarAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

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

func (s *Server) SuspendOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)

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

func (s *Server) TriageAbuseReport(w http.ResponseWriter, r *http.Request, id uuid.UUID)

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

func (s *Server) UnstarAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

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

func (s *Server) UnwrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request, org OrgHandle)

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

func (s *Server) UpdateAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)

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) UpdateOrg

func (s *Server) UpdateOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)

UpdateOrg implements PATCH /orgs/{org} (admin+).

func (*Server) UpdateOrgKnowledgePack

func (s *Server) UpdateOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packID openapi_types.UUID)

UpdateOrgKnowledgePack implements PATCH /orgs/{org}/knowledge/packs/{packId}: whether the organization's members may export the pack.

func (*Server) UpdateUserNotificationSettings

func (s *Server) UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)

UpdateUserNotificationSettings implements PUT /user/notifications: a full replace of the switches every client knows, sent back as read and changed — with 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) UpdateUserReportSettings

func (s *Server) UpdateUserReportSettings(w http.ResponseWriter, r *http.Request, params UpdateUserReportSettingsParams)

UpdateUserReportSettings implements PUT /user/report-settings: a full replace, so a body with no design (or a null one) clears the choice. The design is parsed by pkg/reportdesign, which refuses an unknown key, a missing field, a name off a closed list, a colour that fails the contrast rule and an over-size document; the field it names comes back as design.<path>. The canonical document is what is stored and answered. The logo is stored beside the design: a design that carries one replaces the stored logo with NormalizeLogo's encoding of it, and a design that carries none leaves a stored logo as it is, so a client that does not know logos cannot drop one by saving.

func (*Server) UpdateVoiceSettings

func (s *Server) UpdateVoiceSettings(w http.ResponseWriter, r *http.Request)

UpdateVoiceSettings implements PUT /voice/settings; a field not sent keeps its value.

func (*Server) UpdateWebhook

func (s *Server) UpdateWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)

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

func (s *Server) VerifyDomainClaim(w http.ResponseWriter, r *http.Request, org OrgHandle)

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) Voice

func (s *Server) Voice() *voice.Service

Voice is the voice store, for an extension that builds on it.

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

func (s *Server) WrapMiddleware(h http.Handler) http.Handler

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

func (s *Server) WrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request, org OrgHandle)

WrapOrgKnowledgeKey implements POST /orgs/{org}/knowledge/keys/wrap.

func (*Server) YankVersion

func (s *Server) YankVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)

YankVersion implements POST .../versions/{version}/yank.

type ServerInterface

type ServerInterface interface {
	// ListAdvisories Published advisories — for one agent, or the global feed.
	// (GET /advisories)
	ListAdvisories(w http.ResponseWriter, r *http.Request, params ListAdvisoriesParams)
	// GetAdvisory One published advisory (permalink); public agents only.
	// (GET /advisories/{advisoryId})
	GetAdvisory(w http.ResponseWriter, r *http.Request, advisoryId openapi_types.UUID)
	// ListAgents List agents in a namespace (public ones for everyone).
	// (GET /agents)
	ListAgents(w http.ResponseWriter, r *http.Request, params ListAgentsParams)
	// CreateAgent Create an agent and its hosted git repository.
	// (POST /agents)
	CreateAgent(w http.ResponseWriter, r *http.Request)
	// DeleteAgent Delete an agent (the namespace's administrators).
	// (DELETE /agents/{ns}/{name})
	DeleteAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params DeleteAgentParams)
	// GetAgent Agent metadata (public agents readable by anyone).
	// (GET /agents/{ns}/{name})
	GetAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// UpdateAgent Update agent settings (maintain).
	// (PATCH /agents/{ns}/{name})
	UpdateAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// ReportAbuse Report malicious or abusive content (authed, rate-limited).
	// (POST /agents/{ns}/{name}/abuse-reports)
	ReportAbuse(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// ListAgentActivity Recent activity for an agent.
	// (GET /agents/{ns}/{name}/activity)
	ListAgentActivity(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params ListAgentActivityParams)
	// ForkAgent Fork a public agent into a namespace the caller may create in.
	// (POST /agents/{ns}/{name}/fork)
	ForkAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// ListAgentGrants List explicit grants (maintain).
	// (GET /agents/{ns}/{name}/grants)
	ListAgentGrants(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// RemoveAgentTeamGrant Remove a team grant (maintain).
	// (DELETE /agents/{ns}/{name}/grants/team/{team})
	RemoveAgentTeamGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, team TeamSlug)
	// SetAgentTeamGrant Grant an org team a per-agent role (maintain; org agents only).
	// (PUT /agents/{ns}/{name}/grants/team/{team})
	SetAgentTeamGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, team TeamSlug)
	// RemoveAgentUserGrant Remove a user grant (maintain).
	// (DELETE /agents/{ns}/{name}/grants/user/{handle})
	RemoveAgentUserGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, handle Handle)
	// SetAgentUserGrant Grant a user a per-agent role (maintain).
	// (PUT /agents/{ns}/{name}/grants/user/{handle})
	SetAgentUserGrant(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, handle Handle)
	// GetAgentReadme The agent README rendered to sanitized HTML.
	// (GET /agents/{ns}/{name}/readme)
	GetAgentReadme(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, params GetAgentReadmeParams)
	// RestoreAgent Restore a retired agent (the namespace's administrators).
	// (POST /agents/{ns}/{name}/restore)
	RestoreAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// RetireAgent Retire an agent (the namespace's administrators).
	// (POST /agents/{ns}/{name}/retire)
	RetireAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// GetAgentStats Star count and install counts for an agent.
	// (GET /agents/{ns}/{name}/stats)
	GetAgentStats(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// ListVersions Version history, newest first.
	// (GET /agents/{ns}/{name}/versions)
	ListVersions(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// SubmitVersion Submit a version for publication.
	// (POST /agents/{ns}/{name}/versions)
	SubmitVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// GetVersionInfo One version with its state and archive identity.
	// (GET /agents/{ns}/{name}/versions/{version})
	GetVersionInfo(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
	// GetVersionAttestation The signed DSSE attestation, verbatim.
	// (GET /agents/{ns}/{name}/versions/{version}/attestation)
	GetVersionAttestation(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
	// DownloadVersion Download the release archive (counts an install).
	// (GET /agents/{ns}/{name}/versions/{version}/download)
	DownloadVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
	// StreamVersionEvents Server-sent events for a version's pipeline progress.
	// (GET /agents/{ns}/{name}/versions/{version}/events)
	StreamVersionEvents(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
	// GetVersionFile Read one file from the version's release archive.
	// (GET /agents/{ns}/{name}/versions/{version}/file)
	GetVersionFile(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString, params GetVersionFileParams)
	// ListVersionFiles List the files inside the version's release archive.
	// (GET /agents/{ns}/{name}/versions/{version}/files)
	ListVersionFiles(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
	// GetVersionManifest The validated manifest (canonical JSON).
	// (GET /agents/{ns}/{name}/versions/{version}/manifest)
	GetVersionManifest(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
	// GetVersionReport The scan report for a version (findings, ruleset, verdict).
	// (GET /agents/{ns}/{name}/versions/{version}/report)
	GetVersionReport(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
	// YankVersion Yank a published version (publish permission).
	// (POST /agents/{ns}/{name}/versions/{version}/yank)
	YankVersion(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, version VersionString)
	// ExchangeDesktopCode Exchange a desktop sign-in code for the PAT it granted.
	// (POST /auth/desktop/exchange)
	ExchangeDesktopCode(w http.ResponseWriter, r *http.Request)
	// Logout Revoke the current session.
	// (POST /auth/logout)
	Logout(w http.ResponseWriter, r *http.Request)
	// SocialOidcCallback Sign-in redirect URI: establish a session.
	// (GET /auth/oidc/{provider}/callback)
	SocialOidcCallback(w http.ResponseWriter, r *http.Request, provider SocialOidcCallbackParamsProvider, params SocialOidcCallbackParams)
	// SocialOidcStart Begin sign-in with the deployment's OpenID provider.
	// (GET /auth/oidc/{provider}/start)
	SocialOidcStart(w http.ResponseWriter, r *http.Request, provider SocialOidcStartParamsProvider, params SocialOidcStartParams)
	// VerifyEmail Confirm an email address with the mailed token.
	// (POST /auth/verify-email)
	VerifyEmail(w http.ResponseWriter, r *http.Request)
	// GetConnectors Agentry's connectors and this deployment's public client ids.
	// (GET /connectors)
	GetConnectors(w http.ResponseWriter, r *http.Request)
	// SetFindingVerdict Confirm or dismiss a finding (not on the caller's own version, unless platform staff).
	// (POST /findings/{id}/verdict)
	SetFindingVerdict(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
	// GetInvitation Read an invitation by its token (session only). Says which organization and role it offers and whether the signed-in account may accept it.
	// (GET /invitations/{token})
	GetInvitation(w http.ResponseWriter, r *http.Request, token string)
	// AcceptInvitation Accept an invitation (session only). Refused unless the session's verified email is the invited address; single use.
	// (POST /invitations/{token})
	AcceptInvitation(w http.ResponseWriter, r *http.Request, token string)
	// UnwrapKnowledgeKey Unwrap a data key wrapped for the caller; refused for anyone else's.
	// (POST /knowledge/keys/unwrap)
	UnwrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
	// WrapKnowledgeKey Wrap a pack's data key for the caller.
	// (POST /knowledge/keys/wrap)
	WrapKnowledgeKey(w http.ResponseWriter, r *http.Request)
	// ListKnowledgePacks The caller's knowledge packs, by name.
	// (GET /knowledge/packs)
	ListKnowledgePacks(w http.ResponseWriter, r *http.Request)
	// CreateKnowledgePack Create a knowledge pack, empty, with its data key as the caller's wrapper wrapped it.
	// (POST /knowledge/packs)
	CreateKnowledgePack(w http.ResponseWriter, r *http.Request)
	// DeleteKnowledgePack Delete one of the caller's packs, its stored trees and its wrapped key.
	// (DELETE /knowledge/packs/{packId})
	DeleteKnowledgePack(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
	// GetKnowledgePack One of the caller's packs with its scan report; 404 to anyone else.
	// (GET /knowledge/packs/{packId})
	GetKnowledgePack(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
	// ExportKnowledgePack The pack's tree, decrypted as it streams, to its owner alone.
	// (GET /knowledge/packs/{packId}/export)
	ExportKnowledgePack(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
	// DownloadKnowledgeTree The pack's sealed tree, as stored; the client opens it with the unwrapped data key (409 `knowledge-scanning` while it is scanned).
	// (GET /knowledge/packs/{packId}/tree)
	DownloadKnowledgeTree(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
	// UploadKnowledgeTree Upload a pack's sealed tree, which replaces the one before and is scanned.
	// (PUT /knowledge/packs/{packId}/tree)
	UploadKnowledgeTree(w http.ResponseWriter, r *http.Request, packId KnowledgePackId)
	// GetKnowledgeUsage What the caller keeps in the registry against their allocation.
	// (GET /knowledge/usage)
	GetKnowledgeUsage(w http.ResponseWriter, r *http.Request)
	// GetMcpServerScan The registry's last vulnerability check of one MCP server package version.
	// (GET /mcp-servers/scan)
	GetMcpServerScan(w http.ResponseWriter, r *http.Request, params GetMcpServerScanParams)
	// GetMeta Server version and self-host feature flags.
	// (GET /meta)
	GetMeta(w http.ResponseWriter, r *http.Request)
	// CheckDraft AI Review of a finished draft before it is submitted.
	// (POST /model-input/check)
	CheckDraft(w http.ResponseWriter, r *http.Request)
	// ScanModelInput AI Review of text a model is about to read.
	// (POST /model-input/scan)
	ScanModelInput(w http.ResponseWriter, r *http.Request)
	// SearchModelInput Web search through the deployment's provider, every result scanned.
	// (POST /model-input/search)
	SearchModelInput(w http.ResponseWriter, r *http.Request)
	// CreateOrg Create an organization; the caller becomes its first admin.
	// (POST /orgs)
	CreateOrg(w http.ResponseWriter, r *http.Request)
	// GetOrg Organization profile (public fields; settings for admins).
	// (GET /orgs/{org})
	GetOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// UpdateOrg Update org settings (admin+).
	// (PATCH /orgs/{org})
	UpdateOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// ListOrgAudit Org audit events, newest first (admin+; cursor paged).
	// (GET /orgs/{org}/audit)
	ListOrgAudit(w http.ResponseWriter, r *http.Request, org OrgHandle, params ListOrgAuditParams)
	// CreateAuditExport Start an async NDJSON audit export (admin+).
	// (POST /orgs/{org}/audit/exports)
	CreateAuditExport(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// GetAuditExport Poll an audit export's status and download reference (admin+).
	// (GET /orgs/{org}/audit/exports/{id})
	GetAuditExport(w http.ResponseWriter, r *http.Request, org OrgHandle, id openapi_types.UUID)
	// DecommissionOrg Decommission the organization (admin; session only). It enters a read-only hold — members keep read and export — and at the end of the hold its agents, repositories, blobs and invitations are erased, its handle and domain released. The body must repeat the organization's handle. The last admin goes with it: this is the one way an organization loses its last admin (409 last-admin everywhere else).
	// (POST /orgs/{org}/decommission)
	DecommissionOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// ListDomainClaims List domain claims (admin+).
	// (GET /orgs/{org}/domain-claims)
	ListDomainClaims(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// CreateDomainClaim Start a domain claim; returns the DNS TXT challenge (admin+).
	// (POST /orgs/{org}/domain-claims)
	CreateDomainClaim(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// VerifyDomainClaim Check the DNS TXT record and mark verified (admin+).
	// (POST /orgs/{org}/domain-claims/verify)
	VerifyDomainClaim(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// ListInvitations List the organization's open invitations (admin).
	// (GET /orgs/{org}/invitations)
	ListInvitations(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// CreateInvitation Invite someone by email (admin). The invitation reserves a seat when it is sent and expires in seven days. Its token is a credential shown once in this response and stored only as a hash. It is also mailed to the address when the registry may write there: an address at the organization's own verified domain always, and any other address only when it belongs to an account whose address the registry has confirmed. Accepting an invitation sent to the organization's verified domain also confirms the accepting account's address, because the organization proved it controls that domain.
	// (POST /orgs/{org}/invitations)
	CreateInvitation(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// RevokeInvitation Revoke an open invitation (admin); its seat is released.
	// (DELETE /orgs/{org}/invitations/{id})
	RevokeInvitation(w http.ResponseWriter, r *http.Request, org OrgHandle, id openapi_types.UUID)
	// UnwrapOrgKnowledgeKey Unwrap a data key wrapped for the organization, for any active member; refused once they are not one.
	// (POST /orgs/{org}/knowledge/keys/unwrap)
	UnwrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// WrapOrgKnowledgeKey Wrap a data key for the organization (admins).
	// (POST /orgs/{org}/knowledge/keys/wrap)
	WrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// ListOrgKnowledgePacks The organization's shared packs, by name, for any active member.
	// (GET /orgs/{org}/knowledge/packs)
	ListOrgKnowledgePacks(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// CreateOrgKnowledgePack Create a shared pack, empty, with its data key wrapped for the organization (admins).
	// (POST /orgs/{org}/knowledge/packs)
	CreateOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// DeleteOrgKnowledgePack Delete a shared pack, its stored trees and its wrapped key (admins).
	// (DELETE /orgs/{org}/knowledge/packs/{packId})
	DeleteOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
	// GetOrgKnowledgePack One of the organization's shared packs with its scan report.
	// (GET /orgs/{org}/knowledge/packs/{packId})
	GetOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
	// UpdateOrgKnowledgePack Mark a shared pack exportable by the organization's members, or not (admins).
	// (PATCH /orgs/{org}/knowledge/packs/{packId})
	UpdateOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
	// ExportOrgKnowledgePack A shared pack's tree, decrypted as it streams, to an admin, or to a member once the pack is marked exportable.
	// (GET /orgs/{org}/knowledge/packs/{packId}/export)
	ExportOrgKnowledgePack(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
	// DownloadOrgKnowledgeTree A shared pack's sealed tree, as stored, for any active member (409 `knowledge-scanning` while it is scanned).
	// (GET /orgs/{org}/knowledge/packs/{packId}/tree)
	DownloadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
	// UploadOrgKnowledgeTree Upload a shared pack's sealed tree, which replaces the one before and is scanned (admins).
	// (PUT /orgs/{org}/knowledge/packs/{packId}/tree)
	UploadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request, org OrgHandle, packId KnowledgePackId)
	// GetOrgKnowledgeUsage What the organization keeps in the registry against the allocation its packs draw on.
	// (GET /orgs/{org}/knowledge/usage)
	GetOrgKnowledgeUsage(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// (DELETE /orgs/{org}/logo)
	DeleteOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// (GET /orgs/{org}/logo)
	GetOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// (PUT /orgs/{org}/logo)
	PutOrgLogo(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// ListOrgMembers List members with roles (members can view).
	// (GET /orgs/{org}/members)
	ListOrgMembers(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// RemoveOrgMember Remove a member (admin), or leave: any active member may remove themselves, since a person belongs to one organization at a time and must be able to leave it. Removing a pending member is how an admin declines them; the last admin cannot be removed or leave (409 last-admin) — only a decommission removes them.
	// (DELETE /orgs/{org}/members/{handle})
	RemoveOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
	// SetOrgMember Change a member's role (admin). This route does not add members: an organization is joined by accepting an invitation, or by an admin approving someone the IdP provisioned, and a PUT for a handle that holds no membership answers 422 naming those doors.
	// (PUT /orgs/{org}/members/{handle})
	SetOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
	// ApproveOrgMember Approve a pending member (admin). The seat check fires here: a person provisioned by the organization's identity provider, or folded in from the organization's domain, holds no seat until an admin approves them.
	// (POST /orgs/{org}/members/{handle}/approve)
	ApproveOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
	// DeclineOrgMember Decline a pending member (admin): the pending membership is removed and no seat is consumed. An active member is removed with DELETE instead.
	// (POST /orgs/{org}/members/{handle}/decline)
	DeclineOrgMember(w http.ResponseWriter, r *http.Request, org OrgHandle, handle Handle)
	// GetOrgPolicy The org policy overlay (admin+).
	// (GET /orgs/{org}/policy)
	GetOrgPolicy(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// SetOrgPolicy Set the org policy overlay (admin; tighten-only).
	// (PUT /orgs/{org}/policy)
	SetOrgPolicy(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// ReinstateOrg Reinstate a suspended organization, or cancel a decommission hold before its erasure runs (platform staff). An organization already erased cannot come back (409).
	// (POST /orgs/{org}/reinstate)
	ReinstateOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// SuspendOrg Suspend the organization (platform staff). It and everything under it answer 404 to everyone, over the API and over git, until it is reinstated. Nothing is deleted.
	// (POST /orgs/{org}/suspend)
	SuspendOrg(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// ListTeams List teams (members can view).
	// (GET /orgs/{org}/teams)
	ListTeams(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// CreateTeam Create a team (admin+).
	// (POST /orgs/{org}/teams)
	CreateTeam(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// DeleteTeam Delete a team (admin+).
	// (DELETE /orgs/{org}/teams/{team})
	DeleteTeam(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)
	// ListTeamMembers List team members (org members can view).
	// (GET /orgs/{org}/teams/{team}/members)
	ListTeamMembers(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug)
	// RemoveTeamMember Remove a member from a team (admin+).
	// (DELETE /orgs/{org}/teams/{team}/members/{handle})
	RemoveTeamMember(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug, handle Handle)
	// AddTeamMember Add an org member to a team (admin+).
	// (PUT /orgs/{org}/teams/{team}/members/{handle})
	AddTeamMember(w http.ResponseWriter, r *http.Request, org OrgHandle, team TeamSlug, handle Handle)
	// ListWebhooks List webhook endpoints (admin+).
	// (GET /orgs/{org}/webhooks)
	ListWebhooks(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// CreateWebhook Create a webhook endpoint (admin+).
	// (POST /orgs/{org}/webhooks)
	CreateWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle)
	// DeleteWebhook Delete a webhook endpoint (admin+).
	// (DELETE /orgs/{org}/webhooks/{id})
	DeleteWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
	// GetWebhook Get a webhook endpoint (admin+).
	// (GET /orgs/{org}/webhooks/{id})
	GetWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
	// UpdateWebhook Update a webhook endpoint (admin+).
	// (PATCH /orgs/{org}/webhooks/{id})
	UpdateWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
	// ListWebhookDeliveries Recent delivery attempts for an endpoint (admin+).
	// (GET /orgs/{org}/webhooks/{id}/deliveries)
	ListWebhookDeliveries(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID, params ListWebhookDeliveriesParams)
	// PingWebhook Send a test delivery to an endpoint (admin+).
	// (POST /orgs/{org}/webhooks/{id}/ping)
	PingWebhook(w http.ResponseWriter, r *http.Request, org OrgHandle, id WebhookID)
	// ListAbuseReports Abuse reports for triage (platform staff).
	// (GET /platform/abuse-reports)
	ListAbuseReports(w http.ResponseWriter, r *http.Request, params ListAbuseReportsParams)
	// TriageAbuseReport Record a triage outcome for an abuse report (platform staff).
	// (POST /platform/abuse-reports/{id})
	TriageAbuseReport(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
	// PlatformAgentAction Quarantine, block, or reinstate an agent (platform staff).
	// (POST /platform/agents/{ns}/{name}/{action})
	PlatformAgentAction(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName, action PlatformAgentActionParamsAction)
	// ListPlatformAudit Audit events across every org (platform staff).
	// (GET /platform/audit)
	ListPlatformAudit(w http.ResponseWriter, r *http.Request, params ListPlatformAuditParams)
	// ListKnowledgePackSizes An account's or an organization's packs by name and size, for support (platform staff).
	// (GET /platform/knowledge)
	ListKnowledgePackSizes(w http.ResponseWriter, r *http.Request, params ListKnowledgePackSizesParams)
	// GetPlatformPolicy The read-only platform baseline policy.
	// (GET /platform/policy)
	GetPlatformPolicy(w http.ResponseWriter, r *http.Request)
	// ListRedTeamReports Reports of the scheduled red-team job against the S3/S4 gate (platform staff).
	// (GET /platform/redteam/reports)
	ListRedTeamReports(w http.ResponseWriter, r *http.Request, params ListRedTeamReportsParams)
	// ListRulesetReleases Ruleset releases, newest first (platform staff).
	// (GET /platform/ruleset-releases)
	ListRulesetReleases(w http.ResponseWriter, r *http.Request)
	// CreateRulesetRelease Register a ruleset release (platform staff).
	// (POST /platform/ruleset-releases)
	CreateRulesetRelease(w http.ResponseWriter, r *http.Request)
	// ResolveRef Resolve ns/name@range to a concrete version.
	// (GET /resolve)
	ResolveRef(w http.ResponseWriter, r *http.Request, params ResolveRefParams)
	// GetReviewItem One review item with its findings bundle.
	// (GET /review-items/{id})
	GetReviewItem(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
	// DecideReviewItem Approve or reject a version under review (not its author, unless platform staff).
	// (POST /review-items/{id}/decision)
	DecideReviewItem(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
	// GetReviewFile One file's content from the archive under review (reviewer/staff).
	// (GET /review-items/{id}/file)
	GetReviewFile(w http.ResponseWriter, r *http.Request, id openapi_types.UUID, params GetReviewFileParams)
	// ListReviewFiles File inventory of the archive under review (reviewer/staff).
	// (GET /review-items/{id}/files)
	ListReviewFiles(w http.ResponseWriter, r *http.Request, id openapi_types.UUID)
	// ListReviewQueue Pending review items (platform staff, or an org's security_reviewer for its queue).
	// (GET /review-queue)
	ListReviewQueue(w http.ResponseWriter, r *http.Request, params ListReviewQueueParams)
	// GetLatestRulesetAttestation DSSE attestation over the bundle `…/latest/bundle` serves.
	// (GET /ruleset-releases/latest/attestation)
	GetLatestRulesetAttestation(w http.ResponseWriter, r *http.Request)
	// GetLatestRulesetBundle The newest published S3/S4 rule bundle, for `agentry validate --rules-update`.
	// (GET /ruleset-releases/latest/bundle)
	GetLatestRulesetBundle(w http.ResponseWriter, r *http.Request)
	// SearchAgents Full-text search over public agents with facets.
	// (GET /search)
	SearchAgents(w http.ResponseWriter, r *http.Request, params SearchAgentsParams)
	// ListAgentsByTag Public agents tagged with {tag}.
	// (GET /tags/{tag})
	ListAgentsByTag(w http.ResponseWriter, r *http.Request, tag string, params ListAgentsByTagParams)
	// GetCurrentUser The authenticated user.
	// (GET /user)
	GetCurrentUser(w http.ResponseWriter, r *http.Request)
	// UpdateCurrentUser Update profile fields.
	// (PATCH /user)
	UpdateCurrentUser(w http.ResponseWriter, r *http.Request)
	// ListUserActivity The caller's own activity — the audit events they performed.
	// (GET /user/activity)
	ListUserActivity(w http.ResponseWriter, r *http.Request, params ListUserActivityParams)
	// ClearCurrentUserData Clear the caller's credentials, installs and settings, and keep the account (session only).
	// (POST /user/clear-data)
	ClearCurrentUserData(w http.ResponseWriter, r *http.Request)
	// DeleteCurrentUser Erase the caller's account (GDPR flow).
	// (POST /user/delete)
	DeleteCurrentUser(w http.ResponseWriter, r *http.Request, params DeleteCurrentUserParams)
	// ListUserDependencyAlerts Open dependency alerts on published versions the caller submitted.
	// (GET /user/dependency-alerts)
	ListUserDependencyAlerts(w http.ResponseWriter, r *http.Request)
	// GetDomainOrg Which organization the caller's verified email domain belongs to. 403 email-unverified until the address is verified.
	// (GET /user/domain-org)
	GetDomainOrg(w http.ResponseWriter, r *http.Request)
	// RequestDomainOrgAccess Ask the administrators of the organization that holds the caller's email domain to add them (session only). Mails the admins, once a day per person (429 rate-limited afterwards), audited as `org.access_request`. 404 when no organization holds the domain; 409 when the caller is already a member there.
	// (POST /user/domain-org/request-access)
	RequestDomainOrgAccess(w http.ResponseWriter, r *http.Request)
	// SendEmailVerification Send the caller a new activation link.
	// (POST /user/email-verification)
	SendEmailVerification(w http.ResponseWriter, r *http.Request)
	// ListAccountInstalls The caller's account installs, composed for a list.
	// (GET /user/installs)
	ListAccountInstalls(w http.ResponseWriter, r *http.Request)
	// DeleteAccountInstall Remove the caller's record for a QuickAgent (idempotent).
	// (DELETE /user/installs/{ns}/{name})
	DeleteAccountInstall(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// PutAccountInstall Record a QuickAgent release as installed to the account, or move the record to another version.
	// (PUT /user/installs/{ns}/{name})
	PutAccountInstall(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// GetUserNotificationSettings How the registry's alerts reach the caller.
	// (GET /user/notifications)
	GetUserNotificationSettings(w http.ResponseWriter, r *http.Request)
	// UpdateUserNotificationSettings Replace the caller's notification settings.
	// (PUT /user/notifications)
	UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)
	// GetUserReportSettings The report design the caller's PDF reports take.
	// (GET /user/report-settings)
	GetUserReportSettings(w http.ResponseWriter, r *http.Request, params GetUserReportSettingsParams)
	// UpdateUserReportSettings Replace the caller's report settings.
	// (PUT /user/report-settings)
	UpdateUserReportSettings(w http.ResponseWriter, r *http.Request, params UpdateUserReportSettingsParams)
	// (DELETE /user/report-settings/logo)
	DeleteUserReportLogo(w http.ResponseWriter, r *http.Request)
	// (PUT /user/report-settings/logo)
	PutUserReportLogo(w http.ResponseWriter, r *http.Request)
	// RevokeOtherUserSessions Revoke every session except the calling one ("sign out everywhere else").
	// (DELETE /user/sessions)
	RevokeOtherUserSessions(w http.ResponseWriter, r *http.Request)
	// ListUserSessions List the caller's active browser sessions.
	// (GET /user/sessions)
	ListUserSessions(w http.ResponseWriter, r *http.Request)
	// RevokeUserSession Revoke one of the caller's own sessions.
	// (DELETE /user/sessions/{sessionId})
	RevokeUserSession(w http.ResponseWriter, r *http.Request, sessionId openapi_types.UUID)
	// ListSshKeys List the caller's SSH public keys for the git transport.
	// (GET /user/ssh-keys)
	ListSshKeys(w http.ResponseWriter, r *http.Request)
	// AddSshKey Register an SSH public key for ssh://git@…/{ns}/{name}.git (session-only).
	// (POST /user/ssh-keys)
	AddSshKey(w http.ResponseWriter, r *http.Request)
	// RemoveSshKey Remove an SSH public key (session-only).
	// (DELETE /user/ssh-keys/{keyId})
	RemoveSshKey(w http.ResponseWriter, r *http.Request, keyId openapi_types.UUID)
	// UnstarAgent Remove a star (idempotent).
	// (DELETE /user/stars/{ns}/{name})
	UnstarAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// StarAgent Star an agent (idempotent).
	// (PUT /user/stars/{ns}/{name})
	StarAgent(w http.ResponseWriter, r *http.Request, ns Namespace, name AgentName)
	// ListTokens List the caller's personal access tokens (metadata only).
	// (GET /user/tokens)
	ListTokens(w http.ResponseWriter, r *http.Request)
	// CreateToken Mint a PAT. The secret is returned exactly once.
	// (POST /user/tokens)
	CreateToken(w http.ResponseWriter, r *http.Request)
	// CreateDesktopGrant Record a one-time grant for the desktop app's browser sign-in.
	// (POST /user/tokens/desktop-grant)
	CreateDesktopGrant(w http.ResponseWriter, r *http.Request)
	// RevokeToken Revoke a PAT immediately.
	// (DELETE /user/tokens/{tokenId})
	RevokeToken(w http.ResponseWriter, r *http.Request, tokenId openapi_types.UUID)
	// ClearTrustedDevices Clear every remembered browser of the caller's account.
	// (DELETE /user/trusted-devices)
	ClearTrustedDevices(w http.ResponseWriter, r *http.Request)
	// CountTrustedDevices How many browsers skip the caller's second factor.
	// (GET /user/trusted-devices)
	CountTrustedDevices(w http.ResponseWriter, r *http.Request)
	// GetUserProfile Public profile for a user handle.
	// (GET /users/{handle})
	GetUserProfile(w http.ResponseWriter, r *http.Request, handle Handle)
	// DeleteVoice Delete the caller's voice, every version of it and its data key.
	// (DELETE /voice)
	DeleteVoice(w http.ResponseWriter, r *http.Request)
	// GetVoice The caller's Writing Voice, every version's text with its review.
	// (GET /voice)
	GetVoice(w http.ResponseWriter, r *http.Request)
	// PutVoice Put a new version of the caller's voice, to be reviewed before it is live.
	// (PUT /voice)
	PutVoice(w http.ResponseWriter, r *http.Request)
	// DiscardVoicePending Drop the caller's pending version, in review or flagged.
	// (DELETE /voice/pending)
	DiscardVoicePending(w http.ResponseWriter, r *http.Request)
	// RestoreVoice Put the previous version back.
	// (POST /voice/restore)
	RestoreVoice(w http.ResponseWriter, r *http.Request)
	// UpdateVoiceSettings Set whether runs In Agentry attach the caller's live voice by default.
	// (PUT /voice/settings)
	UpdateVoiceSettings(w http.ResponseWriter, r *http.Request)
}

ServerInterface represents all server handlers.

type ServerInterfaceWrapper

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

ServerInterfaceWrapper converts contexts to parameters.

func (*ServerInterfaceWrapper) AcceptInvitation

func (siw *ServerInterfaceWrapper) AcceptInvitation(w http.ResponseWriter, r *http.Request)

AcceptInvitation operation middleware

func (*ServerInterfaceWrapper) AddSshKey

func (siw *ServerInterfaceWrapper) AddSshKey(w http.ResponseWriter, r *http.Request)

AddSshKey operation middleware

func (*ServerInterfaceWrapper) AddTeamMember

func (siw *ServerInterfaceWrapper) AddTeamMember(w http.ResponseWriter, r *http.Request)

AddTeamMember operation middleware

func (*ServerInterfaceWrapper) ApproveOrgMember

func (siw *ServerInterfaceWrapper) ApproveOrgMember(w http.ResponseWriter, r *http.Request)

ApproveOrgMember operation middleware

func (*ServerInterfaceWrapper) CheckDraft

func (siw *ServerInterfaceWrapper) CheckDraft(w http.ResponseWriter, r *http.Request)

CheckDraft operation middleware

func (*ServerInterfaceWrapper) ClearCurrentUserData

func (siw *ServerInterfaceWrapper) ClearCurrentUserData(w http.ResponseWriter, r *http.Request)

ClearCurrentUserData operation middleware

func (*ServerInterfaceWrapper) ClearTrustedDevices

func (siw *ServerInterfaceWrapper) ClearTrustedDevices(w http.ResponseWriter, r *http.Request)

ClearTrustedDevices operation middleware

func (*ServerInterfaceWrapper) CountTrustedDevices

func (siw *ServerInterfaceWrapper) CountTrustedDevices(w http.ResponseWriter, r *http.Request)

CountTrustedDevices operation middleware

func (*ServerInterfaceWrapper) CreateAgent

func (siw *ServerInterfaceWrapper) CreateAgent(w http.ResponseWriter, r *http.Request)

CreateAgent operation middleware

func (*ServerInterfaceWrapper) CreateAuditExport

func (siw *ServerInterfaceWrapper) CreateAuditExport(w http.ResponseWriter, r *http.Request)

CreateAuditExport operation middleware

func (*ServerInterfaceWrapper) CreateDesktopGrant

func (siw *ServerInterfaceWrapper) CreateDesktopGrant(w http.ResponseWriter, r *http.Request)

CreateDesktopGrant operation middleware

func (*ServerInterfaceWrapper) CreateDomainClaim

func (siw *ServerInterfaceWrapper) CreateDomainClaim(w http.ResponseWriter, r *http.Request)

CreateDomainClaim operation middleware

func (*ServerInterfaceWrapper) CreateInvitation

func (siw *ServerInterfaceWrapper) CreateInvitation(w http.ResponseWriter, r *http.Request)

CreateInvitation operation middleware

func (*ServerInterfaceWrapper) CreateKnowledgePack

func (siw *ServerInterfaceWrapper) CreateKnowledgePack(w http.ResponseWriter, r *http.Request)

CreateKnowledgePack operation middleware

func (*ServerInterfaceWrapper) CreateOrg

func (siw *ServerInterfaceWrapper) CreateOrg(w http.ResponseWriter, r *http.Request)

CreateOrg operation middleware

func (*ServerInterfaceWrapper) CreateOrgKnowledgePack

func (siw *ServerInterfaceWrapper) CreateOrgKnowledgePack(w http.ResponseWriter, r *http.Request)

CreateOrgKnowledgePack operation middleware

func (*ServerInterfaceWrapper) CreateRulesetRelease

func (siw *ServerInterfaceWrapper) CreateRulesetRelease(w http.ResponseWriter, r *http.Request)

CreateRulesetRelease operation middleware

func (*ServerInterfaceWrapper) CreateTeam

func (siw *ServerInterfaceWrapper) CreateTeam(w http.ResponseWriter, r *http.Request)

CreateTeam operation middleware

func (*ServerInterfaceWrapper) CreateToken

func (siw *ServerInterfaceWrapper) CreateToken(w http.ResponseWriter, r *http.Request)

CreateToken operation middleware

func (*ServerInterfaceWrapper) CreateWebhook

func (siw *ServerInterfaceWrapper) CreateWebhook(w http.ResponseWriter, r *http.Request)

CreateWebhook operation middleware

func (*ServerInterfaceWrapper) DecideReviewItem

func (siw *ServerInterfaceWrapper) DecideReviewItem(w http.ResponseWriter, r *http.Request)

DecideReviewItem operation middleware

func (*ServerInterfaceWrapper) DeclineOrgMember

func (siw *ServerInterfaceWrapper) DeclineOrgMember(w http.ResponseWriter, r *http.Request)

DeclineOrgMember operation middleware

func (*ServerInterfaceWrapper) DecommissionOrg

func (siw *ServerInterfaceWrapper) DecommissionOrg(w http.ResponseWriter, r *http.Request)

DecommissionOrg operation middleware

func (*ServerInterfaceWrapper) DeleteAccountInstall

func (siw *ServerInterfaceWrapper) DeleteAccountInstall(w http.ResponseWriter, r *http.Request)

DeleteAccountInstall operation middleware

func (*ServerInterfaceWrapper) DeleteAgent

func (siw *ServerInterfaceWrapper) DeleteAgent(w http.ResponseWriter, r *http.Request)

DeleteAgent operation middleware

func (*ServerInterfaceWrapper) DeleteCurrentUser

func (siw *ServerInterfaceWrapper) DeleteCurrentUser(w http.ResponseWriter, r *http.Request)

DeleteCurrentUser operation middleware

func (*ServerInterfaceWrapper) DeleteKnowledgePack

func (siw *ServerInterfaceWrapper) DeleteKnowledgePack(w http.ResponseWriter, r *http.Request)

DeleteKnowledgePack operation middleware

func (*ServerInterfaceWrapper) DeleteOrgKnowledgePack

func (siw *ServerInterfaceWrapper) DeleteOrgKnowledgePack(w http.ResponseWriter, r *http.Request)

DeleteOrgKnowledgePack operation middleware

func (siw *ServerInterfaceWrapper) DeleteOrgLogo(w http.ResponseWriter, r *http.Request)

DeleteOrgLogo operation middleware

func (*ServerInterfaceWrapper) DeleteTeam

func (siw *ServerInterfaceWrapper) DeleteTeam(w http.ResponseWriter, r *http.Request)

DeleteTeam operation middleware

func (siw *ServerInterfaceWrapper) DeleteUserReportLogo(w http.ResponseWriter, r *http.Request)

DeleteUserReportLogo operation middleware

func (*ServerInterfaceWrapper) DeleteVoice

func (siw *ServerInterfaceWrapper) DeleteVoice(w http.ResponseWriter, r *http.Request)

DeleteVoice operation middleware

func (*ServerInterfaceWrapper) DeleteWebhook

func (siw *ServerInterfaceWrapper) DeleteWebhook(w http.ResponseWriter, r *http.Request)

DeleteWebhook operation middleware

func (*ServerInterfaceWrapper) DiscardVoicePending

func (siw *ServerInterfaceWrapper) DiscardVoicePending(w http.ResponseWriter, r *http.Request)

DiscardVoicePending operation middleware

func (*ServerInterfaceWrapper) DownloadKnowledgeTree

func (siw *ServerInterfaceWrapper) DownloadKnowledgeTree(w http.ResponseWriter, r *http.Request)

DownloadKnowledgeTree operation middleware

func (*ServerInterfaceWrapper) DownloadOrgKnowledgeTree

func (siw *ServerInterfaceWrapper) DownloadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request)

DownloadOrgKnowledgeTree operation middleware

func (*ServerInterfaceWrapper) DownloadVersion

func (siw *ServerInterfaceWrapper) DownloadVersion(w http.ResponseWriter, r *http.Request)

DownloadVersion operation middleware

func (*ServerInterfaceWrapper) ExchangeDesktopCode

func (siw *ServerInterfaceWrapper) ExchangeDesktopCode(w http.ResponseWriter, r *http.Request)

ExchangeDesktopCode operation middleware

func (*ServerInterfaceWrapper) ExportKnowledgePack

func (siw *ServerInterfaceWrapper) ExportKnowledgePack(w http.ResponseWriter, r *http.Request)

ExportKnowledgePack operation middleware

func (*ServerInterfaceWrapper) ExportOrgKnowledgePack

func (siw *ServerInterfaceWrapper) ExportOrgKnowledgePack(w http.ResponseWriter, r *http.Request)

ExportOrgKnowledgePack operation middleware

func (*ServerInterfaceWrapper) ForkAgent

func (siw *ServerInterfaceWrapper) ForkAgent(w http.ResponseWriter, r *http.Request)

ForkAgent operation middleware

func (*ServerInterfaceWrapper) GetAdvisory

func (siw *ServerInterfaceWrapper) GetAdvisory(w http.ResponseWriter, r *http.Request)

GetAdvisory operation middleware

func (*ServerInterfaceWrapper) GetAgent

func (siw *ServerInterfaceWrapper) GetAgent(w http.ResponseWriter, r *http.Request)

GetAgent operation middleware

func (*ServerInterfaceWrapper) GetAgentReadme

func (siw *ServerInterfaceWrapper) GetAgentReadme(w http.ResponseWriter, r *http.Request)

GetAgentReadme operation middleware

func (*ServerInterfaceWrapper) GetAgentStats

func (siw *ServerInterfaceWrapper) GetAgentStats(w http.ResponseWriter, r *http.Request)

GetAgentStats operation middleware

func (*ServerInterfaceWrapper) GetAuditExport

func (siw *ServerInterfaceWrapper) GetAuditExport(w http.ResponseWriter, r *http.Request)

GetAuditExport operation middleware

func (*ServerInterfaceWrapper) GetConnectors

func (siw *ServerInterfaceWrapper) GetConnectors(w http.ResponseWriter, r *http.Request)

GetConnectors operation middleware

func (*ServerInterfaceWrapper) GetCurrentUser

func (siw *ServerInterfaceWrapper) GetCurrentUser(w http.ResponseWriter, r *http.Request)

GetCurrentUser operation middleware

func (*ServerInterfaceWrapper) GetDomainOrg

func (siw *ServerInterfaceWrapper) GetDomainOrg(w http.ResponseWriter, r *http.Request)

GetDomainOrg operation middleware

func (*ServerInterfaceWrapper) GetInvitation

func (siw *ServerInterfaceWrapper) GetInvitation(w http.ResponseWriter, r *http.Request)

GetInvitation operation middleware

func (*ServerInterfaceWrapper) GetKnowledgePack

func (siw *ServerInterfaceWrapper) GetKnowledgePack(w http.ResponseWriter, r *http.Request)

GetKnowledgePack operation middleware

func (*ServerInterfaceWrapper) GetKnowledgeUsage

func (siw *ServerInterfaceWrapper) GetKnowledgeUsage(w http.ResponseWriter, r *http.Request)

GetKnowledgeUsage operation middleware

func (*ServerInterfaceWrapper) GetLatestRulesetAttestation

func (siw *ServerInterfaceWrapper) GetLatestRulesetAttestation(w http.ResponseWriter, r *http.Request)

GetLatestRulesetAttestation operation middleware

func (*ServerInterfaceWrapper) GetLatestRulesetBundle

func (siw *ServerInterfaceWrapper) GetLatestRulesetBundle(w http.ResponseWriter, r *http.Request)

GetLatestRulesetBundle operation middleware

func (*ServerInterfaceWrapper) GetMcpServerScan

func (siw *ServerInterfaceWrapper) GetMcpServerScan(w http.ResponseWriter, r *http.Request)

GetMcpServerScan operation middleware

func (*ServerInterfaceWrapper) GetMeta

GetMeta operation middleware

func (*ServerInterfaceWrapper) GetOrg

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 (siw *ServerInterfaceWrapper) GetOrgLogo(w http.ResponseWriter, r *http.Request)

GetOrgLogo operation middleware

func (*ServerInterfaceWrapper) GetOrgPolicy

func (siw *ServerInterfaceWrapper) GetOrgPolicy(w http.ResponseWriter, r *http.Request)

GetOrgPolicy operation middleware

func (*ServerInterfaceWrapper) GetPlatformPolicy

func (siw *ServerInterfaceWrapper) GetPlatformPolicy(w http.ResponseWriter, r *http.Request)

GetPlatformPolicy operation middleware

func (*ServerInterfaceWrapper) GetReviewFile

func (siw *ServerInterfaceWrapper) GetReviewFile(w http.ResponseWriter, r *http.Request)

GetReviewFile operation middleware

func (*ServerInterfaceWrapper) GetReviewItem

func (siw *ServerInterfaceWrapper) GetReviewItem(w http.ResponseWriter, r *http.Request)

GetReviewItem operation middleware

func (*ServerInterfaceWrapper) GetUserNotificationSettings

func (siw *ServerInterfaceWrapper) GetUserNotificationSettings(w http.ResponseWriter, r *http.Request)

GetUserNotificationSettings operation middleware

func (*ServerInterfaceWrapper) GetUserProfile

func (siw *ServerInterfaceWrapper) GetUserProfile(w http.ResponseWriter, r *http.Request)

GetUserProfile operation middleware

func (*ServerInterfaceWrapper) GetUserReportSettings

func (siw *ServerInterfaceWrapper) GetUserReportSettings(w http.ResponseWriter, r *http.Request)

GetUserReportSettings operation middleware

func (*ServerInterfaceWrapper) GetVersionAttestation

func (siw *ServerInterfaceWrapper) GetVersionAttestation(w http.ResponseWriter, r *http.Request)

GetVersionAttestation operation middleware

func (*ServerInterfaceWrapper) GetVersionFile

func (siw *ServerInterfaceWrapper) GetVersionFile(w http.ResponseWriter, r *http.Request)

GetVersionFile operation middleware

func (*ServerInterfaceWrapper) GetVersionInfo

func (siw *ServerInterfaceWrapper) GetVersionInfo(w http.ResponseWriter, r *http.Request)

GetVersionInfo operation middleware

func (*ServerInterfaceWrapper) GetVersionManifest

func (siw *ServerInterfaceWrapper) GetVersionManifest(w http.ResponseWriter, r *http.Request)

GetVersionManifest operation middleware

func (*ServerInterfaceWrapper) GetVersionReport

func (siw *ServerInterfaceWrapper) GetVersionReport(w http.ResponseWriter, r *http.Request)

GetVersionReport operation middleware

func (*ServerInterfaceWrapper) GetVoice

func (siw *ServerInterfaceWrapper) GetVoice(w http.ResponseWriter, r *http.Request)

GetVoice operation middleware

func (*ServerInterfaceWrapper) GetWebhook

func (siw *ServerInterfaceWrapper) GetWebhook(w http.ResponseWriter, r *http.Request)

GetWebhook operation middleware

func (*ServerInterfaceWrapper) ListAbuseReports

func (siw *ServerInterfaceWrapper) ListAbuseReports(w http.ResponseWriter, r *http.Request)

ListAbuseReports operation middleware

func (*ServerInterfaceWrapper) ListAccountInstalls

func (siw *ServerInterfaceWrapper) ListAccountInstalls(w http.ResponseWriter, r *http.Request)

ListAccountInstalls operation middleware

func (*ServerInterfaceWrapper) ListAdvisories

func (siw *ServerInterfaceWrapper) ListAdvisories(w http.ResponseWriter, r *http.Request)

ListAdvisories operation middleware

func (*ServerInterfaceWrapper) ListAgentActivity

func (siw *ServerInterfaceWrapper) ListAgentActivity(w http.ResponseWriter, r *http.Request)

ListAgentActivity operation middleware

func (*ServerInterfaceWrapper) ListAgentGrants

func (siw *ServerInterfaceWrapper) ListAgentGrants(w http.ResponseWriter, r *http.Request)

ListAgentGrants operation middleware

func (*ServerInterfaceWrapper) ListAgents

func (siw *ServerInterfaceWrapper) ListAgents(w http.ResponseWriter, r *http.Request)

ListAgents operation middleware

func (*ServerInterfaceWrapper) ListAgentsByTag

func (siw *ServerInterfaceWrapper) ListAgentsByTag(w http.ResponseWriter, r *http.Request)

ListAgentsByTag operation middleware

func (*ServerInterfaceWrapper) ListDomainClaims

func (siw *ServerInterfaceWrapper) ListDomainClaims(w http.ResponseWriter, r *http.Request)

ListDomainClaims operation middleware

func (*ServerInterfaceWrapper) ListInvitations

func (siw *ServerInterfaceWrapper) ListInvitations(w http.ResponseWriter, r *http.Request)

ListInvitations operation middleware

func (*ServerInterfaceWrapper) ListKnowledgePackSizes

func (siw *ServerInterfaceWrapper) ListKnowledgePackSizes(w http.ResponseWriter, r *http.Request)

ListKnowledgePackSizes operation middleware

func (*ServerInterfaceWrapper) ListKnowledgePacks

func (siw *ServerInterfaceWrapper) ListKnowledgePacks(w http.ResponseWriter, r *http.Request)

ListKnowledgePacks operation middleware

func (*ServerInterfaceWrapper) ListOrgAudit

func (siw *ServerInterfaceWrapper) ListOrgAudit(w http.ResponseWriter, r *http.Request)

ListOrgAudit operation middleware

func (*ServerInterfaceWrapper) ListOrgKnowledgePacks

func (siw *ServerInterfaceWrapper) ListOrgKnowledgePacks(w http.ResponseWriter, r *http.Request)

ListOrgKnowledgePacks operation middleware

func (*ServerInterfaceWrapper) ListOrgMembers

func (siw *ServerInterfaceWrapper) ListOrgMembers(w http.ResponseWriter, r *http.Request)

ListOrgMembers operation middleware

func (*ServerInterfaceWrapper) ListPlatformAudit

func (siw *ServerInterfaceWrapper) ListPlatformAudit(w http.ResponseWriter, r *http.Request)

ListPlatformAudit operation middleware

func (*ServerInterfaceWrapper) ListRedTeamReports

func (siw *ServerInterfaceWrapper) ListRedTeamReports(w http.ResponseWriter, r *http.Request)

ListRedTeamReports operation middleware

func (*ServerInterfaceWrapper) ListReviewFiles

func (siw *ServerInterfaceWrapper) ListReviewFiles(w http.ResponseWriter, r *http.Request)

ListReviewFiles operation middleware

func (*ServerInterfaceWrapper) ListReviewQueue

func (siw *ServerInterfaceWrapper) ListReviewQueue(w http.ResponseWriter, r *http.Request)

ListReviewQueue operation middleware

func (*ServerInterfaceWrapper) ListRulesetReleases

func (siw *ServerInterfaceWrapper) ListRulesetReleases(w http.ResponseWriter, r *http.Request)

ListRulesetReleases operation middleware

func (*ServerInterfaceWrapper) ListSshKeys

func (siw *ServerInterfaceWrapper) ListSshKeys(w http.ResponseWriter, r *http.Request)

ListSshKeys operation middleware

func (*ServerInterfaceWrapper) ListTeamMembers

func (siw *ServerInterfaceWrapper) ListTeamMembers(w http.ResponseWriter, r *http.Request)

ListTeamMembers operation middleware

func (*ServerInterfaceWrapper) ListTeams

func (siw *ServerInterfaceWrapper) ListTeams(w http.ResponseWriter, r *http.Request)

ListTeams operation middleware

func (*ServerInterfaceWrapper) ListTokens

func (siw *ServerInterfaceWrapper) ListTokens(w http.ResponseWriter, r *http.Request)

ListTokens operation middleware

func (*ServerInterfaceWrapper) ListUserActivity

func (siw *ServerInterfaceWrapper) ListUserActivity(w http.ResponseWriter, r *http.Request)

ListUserActivity operation middleware

func (*ServerInterfaceWrapper) ListUserDependencyAlerts

func (siw *ServerInterfaceWrapper) ListUserDependencyAlerts(w http.ResponseWriter, r *http.Request)

ListUserDependencyAlerts operation middleware

func (*ServerInterfaceWrapper) ListUserSessions

func (siw *ServerInterfaceWrapper) ListUserSessions(w http.ResponseWriter, r *http.Request)

ListUserSessions operation middleware

func (*ServerInterfaceWrapper) ListVersionFiles

func (siw *ServerInterfaceWrapper) ListVersionFiles(w http.ResponseWriter, r *http.Request)

ListVersionFiles operation middleware

func (*ServerInterfaceWrapper) ListVersions

func (siw *ServerInterfaceWrapper) ListVersions(w http.ResponseWriter, r *http.Request)

ListVersions operation middleware

func (*ServerInterfaceWrapper) ListWebhookDeliveries

func (siw *ServerInterfaceWrapper) ListWebhookDeliveries(w http.ResponseWriter, r *http.Request)

ListWebhookDeliveries operation middleware

func (*ServerInterfaceWrapper) ListWebhooks

func (siw *ServerInterfaceWrapper) ListWebhooks(w http.ResponseWriter, r *http.Request)

ListWebhooks operation middleware

func (*ServerInterfaceWrapper) Logout

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 (siw *ServerInterfaceWrapper) PutOrgLogo(w http.ResponseWriter, r *http.Request)

PutOrgLogo operation middleware

func (siw *ServerInterfaceWrapper) PutUserReportLogo(w http.ResponseWriter, r *http.Request)

PutUserReportLogo operation middleware

func (*ServerInterfaceWrapper) PutVoice

func (siw *ServerInterfaceWrapper) PutVoice(w http.ResponseWriter, r *http.Request)

PutVoice operation middleware

func (*ServerInterfaceWrapper) ReinstateOrg

func (siw *ServerInterfaceWrapper) ReinstateOrg(w http.ResponseWriter, r *http.Request)

ReinstateOrg operation middleware

func (*ServerInterfaceWrapper) RemoveAgentTeamGrant

func (siw *ServerInterfaceWrapper) RemoveAgentTeamGrant(w http.ResponseWriter, r *http.Request)

RemoveAgentTeamGrant operation middleware

func (*ServerInterfaceWrapper) RemoveAgentUserGrant

func (siw *ServerInterfaceWrapper) RemoveAgentUserGrant(w http.ResponseWriter, r *http.Request)

RemoveAgentUserGrant operation middleware

func (*ServerInterfaceWrapper) RemoveOrgMember

func (siw *ServerInterfaceWrapper) RemoveOrgMember(w http.ResponseWriter, r *http.Request)

RemoveOrgMember operation middleware

func (*ServerInterfaceWrapper) RemoveSshKey

func (siw *ServerInterfaceWrapper) RemoveSshKey(w http.ResponseWriter, r *http.Request)

RemoveSshKey operation middleware

func (*ServerInterfaceWrapper) RemoveTeamMember

func (siw *ServerInterfaceWrapper) RemoveTeamMember(w http.ResponseWriter, r *http.Request)

RemoveTeamMember operation middleware

func (*ServerInterfaceWrapper) ReportAbuse

func (siw *ServerInterfaceWrapper) ReportAbuse(w http.ResponseWriter, r *http.Request)

ReportAbuse operation middleware

func (*ServerInterfaceWrapper) RequestDomainOrgAccess

func (siw *ServerInterfaceWrapper) RequestDomainOrgAccess(w http.ResponseWriter, r *http.Request)

RequestDomainOrgAccess operation middleware

func (*ServerInterfaceWrapper) ResolveRef

func (siw *ServerInterfaceWrapper) ResolveRef(w http.ResponseWriter, r *http.Request)

ResolveRef operation middleware

func (*ServerInterfaceWrapper) RestoreAgent

func (siw *ServerInterfaceWrapper) RestoreAgent(w http.ResponseWriter, r *http.Request)

RestoreAgent operation middleware

func (*ServerInterfaceWrapper) RestoreVoice

func (siw *ServerInterfaceWrapper) RestoreVoice(w http.ResponseWriter, r *http.Request)

RestoreVoice operation middleware

func (*ServerInterfaceWrapper) RetireAgent

func (siw *ServerInterfaceWrapper) RetireAgent(w http.ResponseWriter, r *http.Request)

RetireAgent operation middleware

func (*ServerInterfaceWrapper) RevokeInvitation

func (siw *ServerInterfaceWrapper) RevokeInvitation(w http.ResponseWriter, r *http.Request)

RevokeInvitation operation middleware

func (*ServerInterfaceWrapper) RevokeOtherUserSessions

func (siw *ServerInterfaceWrapper) RevokeOtherUserSessions(w http.ResponseWriter, r *http.Request)

RevokeOtherUserSessions operation middleware

func (*ServerInterfaceWrapper) RevokeToken

func (siw *ServerInterfaceWrapper) RevokeToken(w http.ResponseWriter, r *http.Request)

RevokeToken operation middleware

func (*ServerInterfaceWrapper) RevokeUserSession

func (siw *ServerInterfaceWrapper) RevokeUserSession(w http.ResponseWriter, r *http.Request)

RevokeUserSession operation middleware

func (*ServerInterfaceWrapper) ScanModelInput

func (siw *ServerInterfaceWrapper) ScanModelInput(w http.ResponseWriter, r *http.Request)

ScanModelInput operation middleware

func (*ServerInterfaceWrapper) SearchAgents

func (siw *ServerInterfaceWrapper) SearchAgents(w http.ResponseWriter, r *http.Request)

SearchAgents operation middleware

func (*ServerInterfaceWrapper) SearchModelInput

func (siw *ServerInterfaceWrapper) SearchModelInput(w http.ResponseWriter, r *http.Request)

SearchModelInput operation middleware

func (*ServerInterfaceWrapper) SendEmailVerification

func (siw *ServerInterfaceWrapper) SendEmailVerification(w http.ResponseWriter, r *http.Request)

SendEmailVerification operation middleware

func (*ServerInterfaceWrapper) SetAgentTeamGrant

func (siw *ServerInterfaceWrapper) SetAgentTeamGrant(w http.ResponseWriter, r *http.Request)

SetAgentTeamGrant operation middleware

func (*ServerInterfaceWrapper) SetAgentUserGrant

func (siw *ServerInterfaceWrapper) SetAgentUserGrant(w http.ResponseWriter, r *http.Request)

SetAgentUserGrant operation middleware

func (*ServerInterfaceWrapper) SetFindingVerdict

func (siw *ServerInterfaceWrapper) SetFindingVerdict(w http.ResponseWriter, r *http.Request)

SetFindingVerdict operation middleware

func (*ServerInterfaceWrapper) SetOrgMember

func (siw *ServerInterfaceWrapper) SetOrgMember(w http.ResponseWriter, r *http.Request)

SetOrgMember operation middleware

func (*ServerInterfaceWrapper) SetOrgPolicy

func (siw *ServerInterfaceWrapper) SetOrgPolicy(w http.ResponseWriter, r *http.Request)

SetOrgPolicy operation middleware

func (*ServerInterfaceWrapper) SocialOidcCallback

func (siw *ServerInterfaceWrapper) SocialOidcCallback(w http.ResponseWriter, r *http.Request)

SocialOidcCallback operation middleware

func (*ServerInterfaceWrapper) SocialOidcStart

func (siw *ServerInterfaceWrapper) SocialOidcStart(w http.ResponseWriter, r *http.Request)

SocialOidcStart operation middleware

func (*ServerInterfaceWrapper) StarAgent

func (siw *ServerInterfaceWrapper) StarAgent(w http.ResponseWriter, r *http.Request)

StarAgent operation middleware

func (*ServerInterfaceWrapper) StreamVersionEvents

func (siw *ServerInterfaceWrapper) StreamVersionEvents(w http.ResponseWriter, r *http.Request)

StreamVersionEvents operation middleware

func (*ServerInterfaceWrapper) SubmitVersion

func (siw *ServerInterfaceWrapper) SubmitVersion(w http.ResponseWriter, r *http.Request)

SubmitVersion operation middleware

func (*ServerInterfaceWrapper) SuspendOrg

func (siw *ServerInterfaceWrapper) SuspendOrg(w http.ResponseWriter, r *http.Request)

SuspendOrg operation middleware

func (*ServerInterfaceWrapper) TriageAbuseReport

func (siw *ServerInterfaceWrapper) TriageAbuseReport(w http.ResponseWriter, r *http.Request)

TriageAbuseReport operation middleware

func (*ServerInterfaceWrapper) UnstarAgent

func (siw *ServerInterfaceWrapper) UnstarAgent(w http.ResponseWriter, r *http.Request)

UnstarAgent operation middleware

func (*ServerInterfaceWrapper) UnwrapKnowledgeKey

func (siw *ServerInterfaceWrapper) UnwrapKnowledgeKey(w http.ResponseWriter, r *http.Request)

UnwrapKnowledgeKey operation middleware

func (*ServerInterfaceWrapper) UnwrapOrgKnowledgeKey

func (siw *ServerInterfaceWrapper) UnwrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request)

UnwrapOrgKnowledgeKey operation middleware

func (*ServerInterfaceWrapper) UpdateAgent

func (siw *ServerInterfaceWrapper) UpdateAgent(w http.ResponseWriter, r *http.Request)

UpdateAgent operation middleware

func (*ServerInterfaceWrapper) UpdateCurrentUser

func (siw *ServerInterfaceWrapper) UpdateCurrentUser(w http.ResponseWriter, r *http.Request)

UpdateCurrentUser operation middleware

func (*ServerInterfaceWrapper) UpdateOrg

func (siw *ServerInterfaceWrapper) UpdateOrg(w http.ResponseWriter, r *http.Request)

UpdateOrg operation middleware

func (*ServerInterfaceWrapper) UpdateOrgKnowledgePack

func (siw *ServerInterfaceWrapper) UpdateOrgKnowledgePack(w http.ResponseWriter, r *http.Request)

UpdateOrgKnowledgePack operation middleware

func (*ServerInterfaceWrapper) UpdateUserNotificationSettings

func (siw *ServerInterfaceWrapper) UpdateUserNotificationSettings(w http.ResponseWriter, r *http.Request)

UpdateUserNotificationSettings operation middleware

func (*ServerInterfaceWrapper) UpdateUserReportSettings

func (siw *ServerInterfaceWrapper) UpdateUserReportSettings(w http.ResponseWriter, r *http.Request)

UpdateUserReportSettings operation middleware

func (*ServerInterfaceWrapper) UpdateVoiceSettings

func (siw *ServerInterfaceWrapper) UpdateVoiceSettings(w http.ResponseWriter, r *http.Request)

UpdateVoiceSettings operation middleware

func (*ServerInterfaceWrapper) UpdateWebhook

func (siw *ServerInterfaceWrapper) UpdateWebhook(w http.ResponseWriter, r *http.Request)

UpdateWebhook operation middleware

func (*ServerInterfaceWrapper) UploadKnowledgeTree

func (siw *ServerInterfaceWrapper) UploadKnowledgeTree(w http.ResponseWriter, r *http.Request)

UploadKnowledgeTree operation middleware

func (*ServerInterfaceWrapper) UploadOrgKnowledgeTree

func (siw *ServerInterfaceWrapper) UploadOrgKnowledgeTree(w http.ResponseWriter, r *http.Request)

UploadOrgKnowledgeTree operation middleware

func (*ServerInterfaceWrapper) VerifyDomainClaim

func (siw *ServerInterfaceWrapper) VerifyDomainClaim(w http.ResponseWriter, r *http.Request)

VerifyDomainClaim operation middleware

func (*ServerInterfaceWrapper) VerifyEmail

func (siw *ServerInterfaceWrapper) VerifyEmail(w http.ResponseWriter, r *http.Request)

VerifyEmail operation middleware

func (*ServerInterfaceWrapper) WrapKnowledgeKey

func (siw *ServerInterfaceWrapper) WrapKnowledgeKey(w http.ResponseWriter, r *http.Request)

WrapKnowledgeKey operation middleware

func (*ServerInterfaceWrapper) WrapOrgKnowledgeKey

func (siw *ServerInterfaceWrapper) WrapOrgKnowledgeKey(w http.ResponseWriter, r *http.Request)

WrapOrgKnowledgeKey operation middleware

func (*ServerInterfaceWrapper) YankVersion

func (siw *ServerInterfaceWrapper) YankVersion(w http.ResponseWriter, r *http.Request)

YankVersion operation middleware

type SessionInfo

type SessionInfo struct {
	CreatedAt time.Time `json:"createdAt"`

	// Current True for the session making this request.
	Current bool               `json:"current"`
	Id      openapi_types.UUID `json:"id"`

	// Ip Client address recorded at session creation.
	Ip         *string   `json:"ip,omitempty"`
	LastSeenAt time.Time `json:"lastSeenAt"`

	// UserAgent User-Agent recorded at session creation.
	UserAgent *string `json:"userAgent,omitempty"`
}

SessionInfo defines model for SessionInfo.

type SessionList

type SessionList struct {
	Sessions []SessionInfo `json:"sessions"`
}

SessionList defines model for SessionList.

type SetAgentTeamGrantJSONBody

type SetAgentTeamGrantJSONBody struct {
	// Role Per-agent grant levels, read < write < maintain < publish.
	Role AgentRole `json:"role"`
}

SetAgentTeamGrantJSONBody defines parameters for SetAgentTeamGrant.

type SetAgentTeamGrantJSONRequestBody

type SetAgentTeamGrantJSONRequestBody SetAgentTeamGrantJSONBody

SetAgentTeamGrantJSONRequestBody defines body for SetAgentTeamGrant for application/json ContentType.

type SetAgentUserGrantJSONBody

type SetAgentUserGrantJSONBody struct {
	// Role Per-agent grant levels, read < write < maintain < publish.
	Role AgentRole `json:"role"`
}

SetAgentUserGrantJSONBody defines parameters for SetAgentUserGrant.

type SetAgentUserGrantJSONRequestBody

type SetAgentUserGrantJSONRequestBody SetAgentUserGrantJSONBody

SetAgentUserGrantJSONRequestBody defines body for SetAgentUserGrant for application/json ContentType.

type SetFindingVerdictJSONBody

type SetFindingVerdictJSONBody struct {
	Reason  string                           `json:"reason"`
	Verdict SetFindingVerdictJSONBodyVerdict `json:"verdict"`
}

SetFindingVerdictJSONBody defines parameters for SetFindingVerdict.

type SetFindingVerdictJSONBodyVerdict

type SetFindingVerdictJSONBodyVerdict string

SetFindingVerdictJSONBodyVerdict defines parameters for SetFindingVerdict.

const (
	SetFindingVerdictJSONBodyVerdictConfirmed              SetFindingVerdictJSONBodyVerdict = "confirmed"
	SetFindingVerdictJSONBodyVerdictDismissedAcceptedRisk  SetFindingVerdictJSONBodyVerdict = "dismissed_accepted_risk"
	SetFindingVerdictJSONBodyVerdictDismissedFalsePositive SetFindingVerdictJSONBodyVerdict = "dismissed_false_positive"
)

Defines values for SetFindingVerdictJSONBodyVerdict.

func (SetFindingVerdictJSONBodyVerdict) Valid

Valid indicates whether the value is a known member of the SetFindingVerdictJSONBodyVerdict enum.

type SetFindingVerdictJSONRequestBody

type SetFindingVerdictJSONRequestBody SetFindingVerdictJSONBody

SetFindingVerdictJSONRequestBody defines body for SetFindingVerdict for application/json ContentType.

type SetOrgMemberJSONBody

type SetOrgMemberJSONBody struct {
	// Role The role a PUT assigns. security_reviewer is refused outside a first-party organization. `owner` is accepted by the schema but refused with a 422 that names the roles that exist.
	Role OrgRoleAssignment `json:"role"`
}

SetOrgMemberJSONBody defines parameters for SetOrgMember.

type SetOrgMemberJSONRequestBody

type SetOrgMemberJSONRequestBody SetOrgMemberJSONBody

SetOrgMemberJSONRequestBody defines body for SetOrgMember for application/json ContentType.

type SetOrgPolicyJSONBody

type SetOrgPolicyJSONBody map[string]interface{}

SetOrgPolicyJSONBody defines parameters for SetOrgPolicy.

type SetOrgPolicyJSONRequestBody

type SetOrgPolicyJSONRequestBody SetOrgPolicyJSONBody

SetOrgPolicyJSONRequestBody defines body for SetOrgPolicy for application/json ContentType.

type ShippedKnowledgeRecord

type ShippedKnowledgeRecord struct {
	At time.Time `json:"at"`

	// By The handle of the account that confirmed it. Absent for a release published by a tag push, which carries no confirmation.
	By    *string       `json:"by,omitempty"`
	Packs []ShippedPack `json:"packs"`

	// Via `client`: the upload carried the publisher's confirmation. `tag-push`: the release was built from a tag and carried none. `fork`: the first version of a fork, copied from the release it forks.
	Via string `json:"via"`
}

ShippedKnowledgeRecord Who confirmed that the version's shipped packs become readable with it, and how it was published. Served only to those who manage the QuickAgent. A version that has no record serves none.

type ShippedKnowledgeScan

type ShippedKnowledgeScan struct {
	// Name The pack's name and its directory under `knowledge/` in the archive.
	Name string `json:"name"`

	// Report What a pack's scan read and found: a record, never a gate. The stages that read prose over every text file, then AI Review over `sources/` and then `wiki/` in chunks no larger than the judge declares it reads.
	Report KnowledgeScanReport `json:"report"`
}

ShippedKnowledgeScan defines model for ShippedKnowledgeScan.

type ShippedPack

type ShippedPack struct {
	// Name The pack's name, as the manifest ships it.
	Name string `json:"name"`

	// Origin The stored pack a shipped pack was laid down from. The registry holds the claim to the facts: the pack exists and is `ready`, it is the submitter's own (`own`) or the organization's (`org`), and its digest is the digest in the shipped pack's `manifest.json`. An organization's pack ships only from an administrator of the organization, and only into a QuickAgent in the organization's own namespace. A pack with no origin is the publisher's own files.
	Origin *ShippedPackOrigin `json:"origin,omitempty"`
}

ShippedPack defines model for ShippedPack.

type ShippedPackOrigin

type ShippedPackOrigin struct {
	Kind ShippedPackOriginKind `json:"kind"`

	// Org The organization's handle; present when `kind` is `org`.
	Org    *string            `json:"org,omitempty"`
	PackId openapi_types.UUID `json:"packId"`
}

ShippedPackOrigin The stored pack a shipped pack was laid down from. The registry holds the claim to the facts: the pack exists and is `ready`, it is the submitter's own (`own`) or the organization's (`org`), and its digest is the digest in the shipped pack's `manifest.json`. An organization's pack ships only from an administrator of the organization, and only into a QuickAgent in the organization's own namespace. A pack with no origin is the publisher's own files.

type ShippedPackOriginKind

type ShippedPackOriginKind string

ShippedPackOriginKind defines model for ShippedPackOrigin.Kind.

const (
	ShippedPackOriginKindOrg ShippedPackOriginKind = "org"
	ShippedPackOriginKindOwn ShippedPackOriginKind = "own"
)

Defines values for ShippedPackOriginKind.

func (ShippedPackOriginKind) Valid

func (e ShippedPackOriginKind) Valid() bool

Valid indicates whether the value is a known member of the ShippedPackOriginKind enum.

type SignIn

type SignIn struct {
	// UserID is the account the sign-in resolved to.
	UserID uuid.UUID
	// NewAccount is true when this sign-in created the account: what an
	// extension reads to treat a sign-up's own claims (a promo code typed
	// on the sign-up form) as a sign-up's and never a returning person's.
	NewAccount bool
	// Provider is the provider's id, and Subject the identity it signed in
	// ("<provider>:<sub>").
	Provider string
	Subject  string
	// Claims is every claim of the verified ID token, as JSON decoded it;
	// nil for a provider with no ID token. An extension that knows its IdP
	// reads that IdP's own claims here, and believes them only from that
	// provider.
	Claims map[string]any
	// AMR and AuthTime are the token's `amr` and `auth_time`.
	AMR      []string
	AuthTime time.Time
	// Request is the callback's request, for the extension's own audit; its
	// body is spent.
	Request *http.Request
	// SetCookie sets a cookie on the response that gives the session.
	SetCookie func(*http.Cookie)
	// RememberBrowser records a remembered browser for this sign-in's
	// account from this sign-in's own token, and returns the token to set
	// as its cookie and its lifetime. The evidence is the verified ID
	// token's, never the caller's: it is ErrNoSecondFactor unless `amr`
	// names a second factor and `auth_time` is minutes old. detail rides
	// the user.trusted_device_add audit row.
	RememberBrowser func(detail map[string]any) (token string, ttl time.Duration, err error)
	// AssertSSO records that this sign-in came through orgID's own single
	// sign-on, so the session it gets satisfies that organization's
	// enforced SSO (auth.Principal.SSOSatisfied). The assertion is as fresh
	// as the token's auth_time, never the moment the registry heard it, so
	// a provider session silently re-used long after its sign-in renews
	// nothing; a token with no auth_time, or one from the future, tags
	// nothing. The extension that calls it answers for the claim it read,
	// from a provider it trusts for it; the organization's resources still
	// need the person's membership, which this grants nothing of. It counts
	// only when called before the hook returns; a nil id is ignored. The
	// organization's audit log records it as sso.login.
	AssertSSO func(orgID uuid.UUID)
}

SignIn is a sign-in through an individual provider that is about to be given a session, as an extension's hook hears it.

type SocialOidcCallbackParams

type SocialOidcCallbackParams struct {
	Code  *string `form:"code,omitempty" json:"code,omitempty"`
	State *string `form:"state,omitempty" json:"state,omitempty"`
}

SocialOidcCallbackParams defines parameters for SocialOidcCallback.

type SocialOidcCallbackParamsProvider

type SocialOidcCallbackParamsProvider string

SocialOidcCallbackParamsProvider defines parameters for SocialOidcCallback.

const (
	SocialOidcCallbackParamsProviderAuthentik SocialOidcCallbackParamsProvider = "authentik"
	SocialOidcCallbackParamsProviderOidc      SocialOidcCallbackParamsProvider = "oidc"
)

Defines values for SocialOidcCallbackParamsProvider.

func (SocialOidcCallbackParamsProvider) Valid

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

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

type StaffMember struct {
	UserID uuid.UUID
	Handle string
	Email  string
}

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 TeamSlug

type TeamSlug = string

TeamSlug defines model for TeamSlug.

type TooManyValuesForParamError

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

func (*TooManyValuesForParamError) Error

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

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

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

func (*UnescapedCookieParamError) Error

func (e *UnescapedCookieParamError) Error() string

func (*UnescapedCookieParamError) Unwrap

func (e *UnescapedCookieParamError) Unwrap() error

type UnmarshalingParamError

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

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

Valid indicates whether the value is a known member of the UpdateAgentJSONBodyVisibility enum.

type UpdateAgentJSONRequestBody

type UpdateAgentJSONRequestBody UpdateAgentJSONBody

UpdateAgentJSONRequestBody defines body for UpdateAgent for application/json ContentType.

type UpdateCurrentUserJSONBody

type UpdateCurrentUserJSONBody struct {
	// CookieAck True records acceptance of the cookie notice on the account (write-once timestamp; false is ignored).
	CookieAck   *bool   `json:"cookieAck,omitempty"`
	DisplayName *string `json:"displayName,omitempty"`
}

UpdateCurrentUserJSONBody defines parameters for UpdateCurrentUser.

type UpdateCurrentUserJSONRequestBody

type UpdateCurrentUserJSONRequestBody UpdateCurrentUserJSONBody

UpdateCurrentUserJSONRequestBody defines body for UpdateCurrentUser for application/json ContentType.

type UpdateKnowledgePackRequest

type UpdateKnowledgePackRequest struct {
	Exportable bool `json:"exportable"`
}

UpdateKnowledgePackRequest defines model for UpdateKnowledgePackRequest.

type UpdateOrgJSONBody

type UpdateOrgJSONBody struct {
	DisplayName *string `json:"displayName,omitempty"`

	// SsoRequired Enforce SSO for org resources. Admin only.
	SsoRequired *bool `json:"ssoRequired,omitempty"`
}

UpdateOrgJSONBody defines parameters for UpdateOrg.

type UpdateOrgJSONRequestBody

type UpdateOrgJSONRequestBody UpdateOrgJSONBody

UpdateOrgJSONRequestBody defines body for UpdateOrg for application/json ContentType.

type UpdateOrgKnowledgePackJSONRequestBody

type UpdateOrgKnowledgePackJSONRequestBody = UpdateKnowledgePackRequest

UpdateOrgKnowledgePackJSONRequestBody defines body for UpdateOrgKnowledgePack for application/json ContentType.

type UpdateUserNotificationSettingsJSONRequestBody

type UpdateUserNotificationSettingsJSONRequestBody = NotificationSettings

UpdateUserNotificationSettingsJSONRequestBody defines body for UpdateUserNotificationSettings for application/json ContentType.

type UpdateUserReportSettingsJSONRequestBody

type UpdateUserReportSettingsJSONRequestBody = ReportSettings

UpdateUserReportSettingsJSONRequestBody defines body for UpdateUserReportSettings for application/json ContentType.

type UpdateUserReportSettingsParams

type UpdateUserReportSettingsParams struct {
	// Include `logo` answers the design with its logo, if the person has one. Without it the design comes without a `logo` key, so a client built before logos still reads it.
	Include *ReportSettingsInclude `form:"include,omitempty" json:"include,omitempty"`
}

UpdateUserReportSettingsParams defines parameters for UpdateUserReportSettings.

type UpdateVoiceSettingsJSONRequestBody

type UpdateVoiceSettingsJSONRequestBody = VoiceSettingsRequest

UpdateVoiceSettingsJSONRequestBody defines body for UpdateVoiceSettings for application/json ContentType.

type UpdateWebhookJSONBody

type UpdateWebhookJSONBody struct {
	Active *bool     `json:"active,omitempty"`
	Events *[]string `json:"events,omitempty"`

	// Url An absolute https:// URL with a host, and a port from 1 to 65535 if it names one.
	Url *string `json:"url,omitempty"`
}

UpdateWebhookJSONBody defines parameters for UpdateWebhook.

type UpdateWebhookJSONRequestBody

type UpdateWebhookJSONRequestBody UpdateWebhookJSONBody

UpdateWebhookJSONRequestBody defines body for UpdateWebhook for application/json ContentType.

type User

type User struct {
	// CookieAckAt When this account acknowledged the cookie notice.
	CookieAckAt *time.Time `json:"cookieAckAt,omitempty"`
	CreatedAt   time.Time  `json:"createdAt"`
	DisplayName string     `json:"displayName"`
	Email       string     `json:"email"`

	// EmailVerificationResendAfter GET /user only, while the address is unconfirmed: the earliest moment `POST /user/email-verification` will send another activation link. Absent when one may be sent now.
	EmailVerificationResendAfter *time.Time         `json:"emailVerificationResendAfter,omitempty"`
	EmailVerified                bool               `json:"emailVerified"`
	Handle                       string             `json:"handle"`
	Id                           openapi_types.UUID `json:"id"`

	// Orgs The caller's org memberships (present on GET /user only).
	Orgs *[]struct {
		Handle string `json:"handle"`
		Role   string `json:"role"`

		// State Whether the membership is in force. `pending` is someone the organization's IdP provisioned, or its domain folded in, who holds no seat and nothing of the organization until an admin approves them; `active` is a member. Declining a pending member removes them, and a decline is remembered: the domain does not fold that person in again unless an admin invites them.
		State *MembershipState `json:"state,omitempty"`
	} `json:"orgs,omitempty"`

	// PendingOrg The organization the caller is waiting to be approved by (present on GET /user only, and only while a pending membership exists): the domain folded them in at a sign-in, or the organization's IdP provisioned them. Every page and client can say it until an admin approves or declines them; until then they keep working on their own tier.
	PendingOrg    *PendingOrg `json:"pendingOrg,omitempty"`
	PlatformStaff *bool       `json:"platformStaff,omitempty"`
}

User defines model for User.

type VerifyDomainClaimJSONBody

type VerifyDomainClaimJSONBody struct {
	Domain string `json:"domain"`
}

VerifyDomainClaimJSONBody defines parameters for VerifyDomainClaim.

type VerifyDomainClaimJSONRequestBody

type VerifyDomainClaimJSONRequestBody VerifyDomainClaimJSONBody

VerifyDomainClaimJSONRequestBody defines body for VerifyDomainClaim for application/json ContentType.

type VerifyEmailJSONBody

type VerifyEmailJSONBody struct {
	Token string `json:"token"`
}

VerifyEmailJSONBody defines parameters for VerifyEmail.

type VerifyEmailJSONRequestBody

type VerifyEmailJSONRequestBody VerifyEmailJSONBody

VerifyEmailJSONRequestBody defines body for VerifyEmail for application/json ContentType.

type 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 VersionString

type VersionString = string

VersionString defines model for VersionString.

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

type VoiceAdmission struct {
	User   uuid.UUID
	Source voice.Source
	Bytes  int
}

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

type WebhookEndpointRef struct {
	ID     uuid.UUID
	URL    string
	Events []string
	Active bool
}

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 WebhookID

type WebhookID = openapi_types.UUID

WebhookID defines model for WebhookID.

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.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL