aigovernance

type ApiError struct {
	Errors []ApiErrorItem `json:"errors"`
	// HTTP status of the response.
	HttpStatus int `json:"httpStatus"`
	// Trace ID for request correlation.
	TraceID string `json:"traceId"`
}

type ApiErrorItem struct {
	// Error code (e.g. TOOL_ID_UNKNOWN, SCHEMA_VALIDATION_FAILED, POLICY_NOT_FOUND).
	Code        string `json:"code"`
	Description string `json:"description"`
	// Dot-path to the offending field (for validation errors).
	Field string `json:"field"`
}

type BlueprintDeployment struct {
	// ID of the blueprint referencing this policy.
	BlueprintID string `json:"blueprintId"`
	// Present when state is DEPLOYED or OUT_OF_DATE; null when NOT_DEPLOYED.
	LastDeployment *DeploymentRun `json:"lastDeployment,omitempty"`
	// Deployment state of the blueprint.
	// Allowed values: see the BlueprintDeploymentState constants.
	State string `json:"state"`
}

type BlueprintDeploymentState = string

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

type CreatePolicyRequest struct {
	Description *string `json:"description,omitempty"`
	Name        string  `json:"name"`
	// Vendor schema version the settings were authored against. Must be a known version for the tool.
	// Returns 422 if not found.
	SchemaVersion string `json:"schemaVersion"`
	// Vendor tool settings payload. Shape is tool-specific and defined by the vendor's JSON Schema, which
	// is served by GET /v1/tools/{toolId}/schemas/{schemaVersion} (see the ToolSchemaResponse schema).
	// Only keys the admin explicitly set are present. Validated at write time against the vendor schema
	// for the request's schemaVersion.
	Settings VendorSettings `json:"settings"`
	// Must match a known tool. Returns 422 if not found.
	ToolID string `json:"toolId"`
}

type CreatedResponse struct {
	// URL of the created policy.
	Href string `json:"href"`
	// Policy ID.
	ID string `json:"id"`
}

type DeploymentRun struct {
	// Approximate deployment start time.
	Started time.Time `json:"started"`
	// Deployment execution state.
	// Allowed values: see the DeploymentRunState constants.
	State string `json:"state"`
}

type DeploymentRunState = string

type PolicyDeploymentResponse struct {
	// One entry per blueprint whose AI governance component references this policy. Empty array if no
	// blueprint references the policy.
	Blueprints []BlueprintDeployment `json:"blueprints"`
}

type PolicyDetail struct {
	CreatedAt time.Time `json:"createdAt"`
	// Actor ID.
	CreatedBy string `json:"createdBy"`
	// Latest published version number. Null if never published.
	CurrentVersionNumber *int    `json:"currentVersionNumber,omitempty"`
	Description          *string `json:"description,omitempty"`
	// True if unpublished changes exist.
	HasDraft bool   `json:"hasDraft"`
	ID       string `json:"id"`
	Name     string `json:"name"`
	// True if the draft schemaVersion differs from the current tool schema version.
	SchemaDrift bool `json:"schemaDrift"`
	// Vendor schema version the current draft settings are authored against.
	SchemaVersion string `json:"schemaVersion"`
	// Vendor tool settings payload. Shape is tool-specific and defined by the vendor's JSON Schema, which
	// is served by GET /v1/tools/{toolId}/schemas/{schemaVersion} (see the ToolSchemaResponse schema).
	// Only keys the admin explicitly set are present. Validated at write time against the vendor schema
	// for the request's schemaVersion.
	Settings VendorSettings `json:"settings"`
	// Allowed values: see the PolicyDetailStatus constants.
	Status    string    `json:"status"`
	ToolID    string    `json:"toolId"`
	UpdatedAt time.Time `json:"updatedAt"`
	// Actor ID.
	UpdatedBy string `json:"updatedBy"`
	// Optimistic-lock counter, incremented on each PATCH. Surfaced as the strong ETag response header and
	// used as the If-Match precondition. Null for legacy documents that predate versioning.
	Version *int64 `json:"version,omitempty"`
}

type PolicyDetailStatus = string

type PolicyListResponse struct {
	Results    []PolicySummary `json:"results"`
	TotalCount int             `json:"totalCount"`
}

type PolicySummary struct {
	CreatedAt time.Time `json:"createdAt"`
	// Actor ID.
	CreatedBy string `json:"createdBy"`
	// Latest published version number. Null if never published.
	CurrentVersionNumber *int `json:"currentVersionNumber,omitempty"`
	// True if unpublished changes exist.
	HasDraft bool   `json:"hasDraft"`
	ID       string `json:"id"`
	Name     string `json:"name"`
	// True if the draft schemaVersion differs from the current tool schema version.
	SchemaDrift bool `json:"schemaDrift"`
	// Allowed values: see the PolicySummaryStatus constants.
	Status    string    `json:"status"`
	ToolID    string    `json:"toolId"`
	UpdatedAt time.Time `json:"updatedAt"`
	// Actor ID.
	UpdatedBy string `json:"updatedBy"`
}

type PolicySummaryStatus = string

type PolicyVersion struct {
	CreatedAt time.Time `json:"createdAt"`
	// Actor ID.
	CreatedBy     string `json:"createdBy"`
	ID            string `json:"id"`
	PolicyID      string `json:"policyId"`
	SchemaVersion string `json:"schemaVersion"`
	// Vendor tool settings payload. Shape is tool-specific and defined by the vendor's JSON Schema, which
	// is served by GET /v1/tools/{toolId}/schemas/{schemaVersion} (see the ToolSchemaResponse schema).
	// Only keys the admin explicitly set are present. Validated at write time against the vendor schema
	// for the request's schemaVersion.
	Settings      VendorSettings `json:"settings"`
	ToolID        string         `json:"toolId"`
	VersionNumber int            `json:"versionNumber"`
}

type PolicyVersionListResponse struct {
	Results    []PolicyVersion `json:"results"`
	TotalCount int             `json:"totalCount"`
}

type PublishResponse struct {
	// URL of the created policy version.
	Href string `json:"href"`
	// PolicyVersion ID.
	ID string `json:"id"`
	// The version number assigned to this published version.
	VersionNumber int `json:"versionNumber"`
}

type ToolListResponse struct {
	Results    []ToolSummary `json:"results"`
	TotalCount int           `json:"totalCount"`
}

type ToolSchemaResponse struct {
	// The raw vendor JSON Schema document describing the shape of a tool's settings. Free-form by design
	// — its structure is defined by the vendor and follows the JSON Schema specification rather than a
	// fixed set of properties. Use it to validate and render settings forms for the corresponding
	// schemaVersion.
	Schema VendorJsonSchema `json:"schema"`
	// Vendor schema version this schema document describes.
	SchemaVersion string `json:"schemaVersion"`
	// Tool identifier (matches toolId in policy records).
	ToolID string `json:"toolId"`
}

type ToolSummary struct {
	DisplayName string `json:"displayName"`
	// Tool identifier (matches toolId in policy records).
	ID string `json:"id"`
	// Current (latest) vendor schema version.
	SchemaVersion string `json:"schemaVersion"`
	// All available schema versions for this tool, newest first.
	SchemaVersions []string `json:"schemaVersions"`
}

type UpdatePolicyRequest struct {
	// New description for the policy. Omit to leave unchanged.
	Description *string `json:"description,omitempty"`
	// New display name for the policy. Omit to leave unchanged.
	Name          *string `json:"name,omitempty"`
	SchemaVersion string  `json:"schemaVersion"`
	// Vendor tool settings payload. Shape is tool-specific and defined by the vendor's JSON Schema, which
	// is served by GET /v1/tools/{toolId}/schemas/{schemaVersion} (see the ToolSchemaResponse schema).
	// Only keys the admin explicitly set are present. Validated at write time against the vendor schema
	// for the request's schemaVersion.
	Settings VendorSettings `json:"settings"`
}

type VendorJsonSchema = json.RawMessage

type VendorSettings = json.RawMessage